socket_to_name(3ncs) socket_to_name(3ncs)
Name
socket_to_name - convert a socket address to a name and port number
Syntax
#include <idl/c/socket.h>
void socket_$to_name(sockaddr, slength, name, nlength, port, status)
socket_$addr_t *sockaddr;
unsigned long slength;
socket_$string_t name;
unsigned long *nlength;
unsigned long *port;
status_$t *status;
Arguments
sockaddr A socket address. The socket address is the structure returned by either or
slength The length, in bytes, of sockaddr.
name A string in the format family:host[port], where family is the address family and host is the host name; host may be in
the standard numeric form (for example, #192.1.2.3) if a textual host name cannot be obtained. Currently, only ip is
supported for family.
nlength On input, the maximum length, in bytes, of the name to be returned. On output, the actual length of the name returned.
port The port number.
status The completion status. If the completion status returned in is equal to status_$ok , then the routine that supplied it
was successful.
Description
The routine converts a socket address to a textual address family, host name, and port number.
Files
See Also
intro(3ncs), socket_family_to_name(3ncs), socket_from_name(3ncs), socket_to_numeric_name(3ncs)
socket_to_name(3ncs)
