socket_to_numeric_name(3ncs)

Name

socket_to_numeric_name − convert a socket address to a numeric name and port number

Syntax

#include <idl/c/socket.h>

void socket_$to_numeric_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 rpc_$use_family or rpc_$use_family_wk.

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 in the standard numeric form (for example, #192.7.8.9 for an IP address). Currently only ip is supported for family.

nlength On input, the maximum length, in bytes, of the name to be returned. (error if less than size of "nnnnn.nnnn"). On output, the actual length of the name returned.

port The port number.

status The completion status. If the completion status returned in status.all is equal to status_$ok , then the routine that supplied it was successful.

Description

The socket_$to_numeric_name routine converts a socket address to a textual address family, a numeric host name, and a port number.

Files

/usr/include/idl/socket.idl
/usr/include/idl/c/socket.h

Museum