socket_to_name(3ncs)socket_to_name(3ncs)Namesocket_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 struc‐
ture 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 rou‐
tine that supplied it was successful.
Description
The routine converts a socket address to a textual address family, host
name, and port number.
FilesSee Alsointro(3ncs), socket_family_to_name(3ncs), socket_from_name(3ncs),
socket_to_numeric_name(3ncs)socket_to_name(3ncs)