swirl
Guide to OmniMark 8   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesLegacy LibrariesErrors
 
      Other Library Functions  
function  

tcp-peer-name

 
 

Library: TCP/IP client and server support (OMTCP) legacy
Include: omtcp.xin
Return type: String

Returns:


Declaration

define external stream function tcp-peer-name
       value tcp-connection Connection

Argument definitions

Connection
is an existing tcp-connection object.


Purpose

Use tcp-peer-name to get the fully-qualified domain name of the peer host on the other side of a connection.

Requirements

You must include the following line at the beginning of your OmniMark program:

  include "omtcp.xin"

Connection must exist (else external Exception TCP05).

Usage Notes

If tcp-peer-name fails to get the fully-qualified domain name of the host machine, external exception TCP01 is thrown.

Example


  local tcp-service Demo
  local tcp-connection Client
  
  set Demo to tcp-service at 5600
  
  repeat
     set Client to tcp-accept-connection Demo
     output "Request from " ||  tcp-peer-name Client || "%n"
     ;process request
  again

        Other Library Functions
   tcp-accept-connection
   tcp-connect
   tcp-connection
   tcp-create-service
   tcp-destroy-service
   tcp-disconnect
   tcp-get
   tcp-has-characters
   tcp-is-connected
   tcp-is-version-compatible
   tcp-library-version
   tcp-peer-ip
   tcp-peer-name
   tcp-port
   tcp-put
   tcp-service
   tcp-set-buffering
   tcp-signal-source-end
   tcp-sink
   tcp-source
 
 

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]

OmniMark 8.2.0 Documentation Generated: March 13, 2008 at 3:27:39 pm
If you have any comments about this section of the documentation, please use this form.

Copyright © Stilo International plc, 1988-2008.