Sockets - Maple Programming Help

Home : Support : Online Help : Connectivity : Web Features : Network Communication : Sockets Package : Sockets/GetLocalHost

Sockets

 GetLocalHost
 return the host name of the local endpoint of a socket connection
 GetLocalPort
 return the port number of the local endpoint of a socket connection
 GetPeerHost
 return the host name of the remote endpoint of a socket connection
 GetPeerPort
 return the port number of the remote endpoint of a socket connection

 Calling Sequence GetLocalHost(sid) GetLocalPort(sid) GetPeerHost(sid) GetPeerPort(sid)

Parameters

 sid - valid socket ID for an open connection

Description

 • These four procedures return information about the endpoints of a socket connection.
 • Each routine requires a single argument, which is a valid socket ID for an open connection. Either a string or a positive integer is returned, depending upon the type of information requested.
 • The procedure GetLocalHost returns the hostname of the local endpoint in a socket connection, while GetPeerHost returns the hostname of the peer side of the connection. In each case, the hostname is returned in the form of a string.
 Port numbers for the local and remote endpoints are obtained as positive Maple integers by using the routines GetLocalPort and GetPeerPort, respectively.

Examples

 > $\mathrm{with}\left(\mathrm{Sockets}\right):$
 > $\mathrm{sid}≔\mathrm{Open}\left("mantis","echo"\right)$
 ${0}$ (1)
 > $\mathrm{GetLocalHost}\left(\mathrm{sid}\right)$
 ${"rdgetroll1.maplesoft.com"}$ (2)
 > $\mathrm{GetLocalPort}\left(\mathrm{sid}\right)$
 ${49164}$ (3)
 > $\mathrm{GetPeerHost}\left(\mathrm{sid}\right)$
 ${"rdgeodin.maplesoft.com"}$ (4)
 > $\mathrm{GetPeerPort}\left(\mathrm{sid}\right)$
 ${7}$ (5)
 > $\mathrm{LookupService}\left("echo"\right)$
 ${7}$ (6)
 > $\mathrm{Close}\left(\mathrm{sid}\right)$
 ${\mathrm{true}}$ (7)