socket_from_name(3ncs)													    socket_from_name(3ncs)

Name
       socket_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 family
	      parameter.  The host is a host name.  A leading number sign (#) can be used to indicate that  the  host  name  is  in  the  standard
	      numeric  form (for example, #192.9.8.7).	If host is omitted, the local host name is used.  The port is a port number.  If you spec-
	      ify 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 parameter, 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  success-
	      ful.

Description
       The  routine converts a textual address family, host name, and port number to a socket address.	The address family and the port number can
       be either specified as separate parameters or included in the name parameter.

Files
See Also
       intro(3ncs), socket_family_from_name(3ncs), socket_to_name(3ncs)

															    socket_from_name(3ncs)