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

tcp.peer-name

 
 

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.


Purpose

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
 
 

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.