Name

rpc_sockaddr_to_name − convert a socket address to a host name and port number (client or server)

Syntax

#include <idl/c/rpc.h>
 
void rpc_$sockaddr_to_name(sockaddr, slength, name, nlength,                                 port, status)

socket_$addr_t *sockaddr;
unsigned long slength;
unsigned char name;
unsigned long *nlength;
unsigned long *port;
status_$t *status;

Arguments

sockaddr A socket address. 

slength The length, in bytes, of sockaddr. 

name A string that contains the host name and the address family.  The format is family:host [port] where family is ip. 

nlength On input, nlength is the length of the name buffer.  On output, nlength is the number of characters returned in the name parameter. 

port The socket 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 rpc_$sockaddr_to_name routine provides the address family, the host name, and the port number identified by the specified socket address.

Diagnostics

This section lists status codes for errors returned by this rpc_$ routine in status.all.

rpc_$not_in_call An internal error. 

rpc_$proto_error An internal protocol error. 

Note

This routine has been superseded by the socket_$to_name routine.

Files

/usr/include/idl/c/rpc.h
/usr/include/idl/rpc.idl

See Also

intro(3ncs), rpc_name_to_sockaddr(3ncs), socket_to_name(3ncs)