[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Technical Reference: Communications, Volume 1
rpc_$name_to_sockaddr Library Routine
Purpose
Converts a host name and port number to a socket address.
Syntax
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;
Description
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.
Parameters
Input
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. |
Output
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. |
Examples
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);
Related Information
Remote Procedure Call (RPC)
Runtime Library (NCS) in AIX 5L Version 5.2 Communications Programming Concepts.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]