socket_from_name(3ncs)socket_from_name(3ncs)Namesocket_from_name - convert a name and port number to a socket address
Syntax
#include <idl/c/socket.h>
void socket_$from_name(family, name, nlength, port, sockaddr, slength,
status)
unsigned long family;
socket_$string_t name;
unsigned long nlength;
unsigned long port;
socket_$addr_t *sockaddr;
unsigned long *slength;
status_$t *status;
Arguments
family The integer representation of an address family. Value can be
socket_$internet or socket_$unspec If the family parameter is
socket_$unspec, then the name parameter is scanned for a prefix
of family: (for example, ip:).
name A string in the format family:host[port], where family:, host,
and [port] are all optional. The family is an address family.
The only valid family is ip. If you specify a family as part of
the name parameter, you must specify socket_$unspec in the fam‐
ily parameter. The host is a host name. A leading number sign
(#) can be used to indicate that the host name is in the stan‐
dard numeric form (for example, #192.9.8.7). If host is omit‐
ted, the local host name is used. The port is a port number.
If you specify a port as part of the name parameter, the port
parameter is ignored.
nlength
The length, in bytes, of name.
port A port number. If you specify a port number in the name parame‐
ter, this parameter is ignored.
sockaddr
A socket address.
slength
The length, in bytes, of sockaddr.
status The completion status. If the completion status returned in is
equal to status_$ok , then the routine that supplied it was suc‐
cessful.
Description
The routine converts a textual address family, host name, and port num‐
ber to a socket address. The address family and the port number can be
either specified as separate parameters or included in the name parame‐
ter.
FilesSee Alsointro(3ncs), socket_family_from_name(3ncs), socket_to_name(3ncs)socket_from_name(3ncs)
