netdir.3n (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

netdir(3N) netdir(3N)

NAME

netdir: netdir_getbyname(), netdir_getbyaddr(), netdir_free(), netdir_options(), taddr2uaddr(),

uaddr2taddr(), netdir_perror(), netdir_sperror() - generic transport name-to-address translation

SYNOPSIS

#include <netdir.h>

int netdir_getbyname(const struct netconfig *

conﬁg,

const struct nd_hostserv *service ,

struct nd_addrlist **addrs);

int netdir_getbyaddr(const struct netconfig *

conﬁg,

struct nd_hostservlist **

service ,

const struct netbuf *netaddr );

void netdir_free(void *

ptr , const int struct_type );

int netdir_options(const struct netconfig *

conﬁg,

const int option ,

const int ﬁldes,

char *point_to_args

);

char *taddr2uaddr(const struct netconfig *

conﬁg,

const struct netbuf *addr);

struct netbuf *uaddr2taddr(const struct netconfig *

conﬁg,

const char *uaddr);

void netdir_perror(char *

s);

char *netdir_sperror(void);

DESCRIPTION

These routines provide a generic interface for name-to-address mapping that will work with all transport

protocols. This interface provides a generic way for programs to convert transport speciﬁc addresses into

common structures and back again. The netconfig structure, described on the netconﬁg(4) manual

page, identiﬁes the transport.

The

netdir_getbyname()

routine maps the machine name and service name in the nd_hostserv

structure to a collection of addresses of the type understood by the transport identiﬁed in the

netcon-

fig structure. This routine returns all addresses that are valid for that transport in the nd_addrlist

structure. The nd_hostserv structure contains the following members:

char *h_host; /* host name */

char *h_serv; /* service name */

The nd_addrlist structure contains the following members:

int n_cnt; /* number of addresses */

struct netbuf *n_addrs;

netdir_getbyname()

accepts some special-case host names. The host names are deﬁned in

<netdir.h>. The currently deﬁned host names are:

HOST_SELF Represents the address to which local programs will bind their endpoints.

HOST_SELF differs from the host name provided by gethostname() (see

gethostname (2)), which represents the address to which remote programs will

bind their endpoints.

HOST_ANY Represents any host accessible by this transport provider. HOST_ANY allows

applications to specify a required service without specifying a particular host

name.

HOST_SELF_CONNECT Represents the host address that can be used to connect to the local host.

HOST_BROADCAST Represents the address for all hosts accessible by this transport provider.

Network requests to this address will be received by all machines.

All ﬁelds of the

nd_hostserv structure must be initialized.

To ﬁnd the address of a given host and service on all available transports, call the

netdir_getbyname() routine with each struct netconfig structure returned by

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
netdir(3N) netdir(3N) NAME netdir: netdir_getbyname(), netdir_getbyaddr(), netdir_free(), netdir_options(), taddr2uaddr(), uaddr2taddr(), netdir_perror(), netdir_sperror() - generic transport name-to-address translation SYNOPSIS #include
PAGE 2
netdir(3N) netdir(3N) getnetconfig(). (See getnetconfig(3N)). The netdir_getbyaddr() routine maps addresses to service names. This routine returns service , a list of host and service pairs that would yield this address.
PAGE 3
netdir(3N) netdir(3N) char s_uaddr; /* server’s universal addr */ char c_uaddr; /* client’s universal addr */ char m_uaddr; /* the result */ If s_uaddr is an address such as 0.0.0.0.1.12, and the call is m_uaddr is set to an address such as successful, 192.11.109.89.1.12. For most transports, m_uaddr is identical to s_uaddr. MULTITHREAD USAGE Thread Safe: Cancel Safe: Fork Safe: Async-cancel Safe: Async-signal Safe: Yes Yes No No No These functions can be called safely in a multithreaded environment.
PAGE 4
(Notes) A (Notes) nA 4 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010