[ Previous | Next | Table of Contents | Index | Library Home |
Legal |
Search ]
Technical Reference: Communications, Volume 1
Converts a host name and port
number to a socket address.
void rpc_$name_to_sockaddr ( name, nlength, port, family, sockaddr, slength, status)
char *name;
unsigned long nlength;
unsigned long port;
unsigned long family;
socket_$addr_t *sockaddr;
unsigned long *slength;
status_$t *status;
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.
[ Previous | Next | Table of Contents | Index |
Library Home |
Legal |
Search ]