Converts a host name and port number to a socket address.
void rpc_$name_to_sockaddr ( name, nlength, port, family, sockaddr, slength, status)
unsigned long nlength;
unsigned long port;
unsigned long family;
unsigned long *slength;
The rpc_$name_to_sockaddr 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 a separate parameter. When three separate elements are passed, the name parameter should contain only the host name.
|name||Points to a host name, and optionally, a port and an address family, in the form: family:host[port]. The family: and [port] parameters are optional. If you specify a family variable as part of the name parameter, you must specify socket_$unspec in the family parameter. The only supported value for the family variable is ip. The host parameter specifies the host name, and port specifies a port number in integer form.|
|nlength||Specifies the number of characters in the name parameter.|
|port||Specifies the socket port number. If you are not specifying a well-known port, this parameter should have the value socket_$unspec_port. The returned socket address will specify the Local Location Broker (LLB) forwarding port at the host. If you specify the port number in the name parameter, this parameter is ignored.|
|family||Specifies the address family to use for the socket address. This value corresponds to the communications protocol used to access the socket and determines how the socket address (sockaddr) parameter is expressed. If you specify the address family in the name parameter, this parameter must have the value socket_$unspec.|
|sockaddr||Points to the socket address corresponding to the name, port, and family parameters.|
|slength||Points to the length, in bytes, of the socket address (specified by the sockaddr parameter).|
|status||Points to the completion status.|
To place in the sockaddr structure a socket address that specifies the LLB forwarding port at the host identified by host_name, enter:
rpc_$name_to_sockaddr(host_name, strlen(host_name), socket_$unspec_port,socket_$dds, &sockaddr, &slen, &st);
This Library Routine is part of Network Computing System in Network Support Facilities in Base Operating System (BOS) Runtime.
Remote Procedure Call (RPC) Runtime Library (NCS) in AIX 5L Version 5.1 Communications Programming Concepts.