rpc_name_to_sockaddr(3ncs)rpc_name_to_sockaddr(3ncs)Namerpc_name_to_sockaddr - convert a host name and port number to a socket
address (client or server)
Syntax
#include <idl/c/rpc.h>
void rpc_$name_to_sockaddr(name, nlength, port, family, sockaddr,
slength, status)
unsigned char name;
unsigned long nlength;
unsigned long port;
unsigned long family;
socket_$addr_t *sockaddr;
unsigned long *slength;
status_$t *status;
Arguments
name A string that contains a host name and, optionally,
a port and an address family. The format is fam‐
ily:host[port], where family: and [port] are
optional. If you specify a family as part of the
name parameter, you must specify socket_$unspec in
the family parameter. The family part of the name
parameter is ip; host is the host name; port is an
integer port number.
nlength The number of characters in name.
port The socket port number. This parameter should have
the value rpc_$unbound_port if you are not specify‐
ing a well-known port; in this case, the returned
socket address will specify the Local Location Bro‐
ker (LLB) forwarding port at host. If you specify
the port number in the name parameter, this parame‐
ter is ignored.
family The address family to use for the socket address.
This value corresponds to the communications proto‐
col used to access the socket and determines how
the sockaddr is expressed. If you specify the
address family in the name parameter, this parame‐
ter must have the value socket_$unspec.
sockaddr The socket address corresponding to name, port, and
family.
slength The length, in bytes, of sockaddr.
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 provides the socket address for a socket, given the host
name, the port number, and the address family.
You can specify the socket address information either as one text
string in the name parameter or by passing each of the three elements
as separate parameters( name, port, and family ); in the latter case,
the name parameter should contain only the hostname.
Diagnostics
This section lists status codes for errors returned by this routine in
rpc_$not_in_call An internal error.
rpc_$proto_error An internal protocol error. This routine has been
superseded by the routine.
FilesSee Alsointro(3ncs), rpc_sockaddr_to_name(3ncs), socket_from_name(3ncs)rpc_name_to_sockaddr(3ncs)