Library: TCP/IP client and server support (OMTCP) Import: omtcp.xmd

Return type: String Returns:

Declaration

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

Argument definitions

Connection

is an existing tcp.connection object.

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

Requirements

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

  import "omtcp.xmd" prefixed by tcp.
  
  process
     local tcp.service Demo
     local tcp.connection Client
  
     set Demo to tcp.service at 5600
  
     repeat
        set Client to tcp.accept-connection from Demo
        output "Request from " ||  tcp.peer-name of Client || "%n"
        ;process request
     again

Related Syntax    tcp.connection    tcp.disconnect    tcp.writer    tcp.get-string    tcp.peer-ip    tcp.reader    tcp.wait-for-input    tcp.is-connected    tcp.put-string    tcp.connect    tcp.set-buffering    tcp.terminate-reader

Other Library Functions    tcp.accept-connection    tcp.connect    tcp.connection    tcp.create-service    tcp.destroy-service    tcp.disconnect    tcp.end-delimited    tcp.get-string    tcp.is-connected    tcp.multi-packet    tcp.omtcp-version    tcp.peer-ip    tcp.peer-name    tcp.port    tcp.put-string    tcp.reader    tcp.service    tcp.set-buffering    tcp.single-packet    tcp.terminate-reader    tcp.wait-for-input    tcp.writer

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