tcp-peer-name

function

Library: TCP/IP client and server support (OMTCP legacy, OmniMark versions 6.0.2 - 7.0)
Include: omtcp.xin

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