SunOS man pages : netdb (3)
Headers netdb(3HEAD)
NAME
netdb - definitions for network database operations
SYNOPSIS
#include <netdb.h>
DESCRIPTION
The <<netdb.h>> header defines the type in_port_t and the
type in_addr_t as described in in(3HEAD).
The <<netdb.h>> header defines the hostent structure that
includes the following members:
char *h_name Official name of the host.
char **h_aliases A pointer to an array of pointers
to alternative host names, ter-
minated by a null pointer.
int h_addrtype Address type.
int h_length The length, in bytes, of the
address.
char **h_addr_list A pointer to an array of pointers
to network addresses (in network
byte order) for the host, ter-
minated by a null pointer.
The <<netdb.h>> header defines the netent structure that
includes the following members:
char *n_name Official, fully-qualified
(including the domain) name of
the network.
char **n_aliases A pointer to an array of pointers
to alternative network names,
terminated by a null pointer.
int n_addrtype The address type of the network.
in_addr_t n_net The network number, in host byte
order.
The <<netdb.h>> header defines the protoent structure that
includes the following members:
char *p_name Official name of the protocol.
char **p_aliases A pointer to an array of pointers
to alternative protocol names,
terminated by a null pointer.
int p_proto The protocol number.
The <<netdb.h>> header defines the servent structure that
includes the following members:
SunOS 5.8 Last change: 13 Aug 1998 1
Headers netdb(3HEAD)
char *s_name Official name of the service.
char **s_aliases A pointer to an array of pointers
to alternative service names,
terminated by a null pointer.
int s_port The port number at which the ser-
vice resides, in network byte
order.
char *s_proto The name of the protocol to use
when contacting the service.
The <<netdb.h>> header defines the macro IPPORT_RESERVED
with the value of the highest reserved Internet port number.
The <<netdb.h>> header provides a declaration for h_errno:
extern int h_errno;
The <<netdb.h>> header defines the following macros for use
as error values for gethostbyaddr() and gethostbyname():
HOST_NOT_FOUND NO_DATA
NO_RECOVERY TRY_AGAIN
Inclusion of the <netdb.h> header may also make visible all
symbols from in(3HEAD).
Default
For applications that do not require standard-conforming
behavior (those that use the socket interfaces described in
section 3N of the reference manual; see Intro(3) and standards(5)
), the following are declared as functions, and may
also be defined as macros:
int endhostent(void);
int endnetent(void);
int endprotoent(void);
int endservent(void);
struct hostent *gethostbyaddr(const void *addr, int
len, int type);
struct hostent *gethostbyname(const char *name);
struct hostent *gethostent(void);
struct netent *getnetbyaddr(long net, int type);
struct netent *getnetbyname(const char *name);
struct netent *getnetent(void);
struct protoent *getprotobyname(const char *name);
struct protoent *getprotobynumber(int proto);
struct protoent *getprotoent(void);
SunOS 5.8 Last change: 13 Aug 1998 2
Headers netdb(3HEAD)
struct servent *getservbyname(const char *name, const
char *proto);
struct servent *getservbyport(int port, const char
*proto);
struct servent *getservent(void);
int sethostent(int stayopen);
int setnetent(int stayopen);
int setprotoent(int stayopen);
int setservent(int stayopen);
Standard-conforming
For applications that require standard-conforming behavior
(those that use the socket interfaces described in section
3XN of the reference manual; see Intro(3) and standards(5)),
the following are declared as functions, and may also be
defined as macros:
void endhostent(void);
void endnetent(void);
void endprotoent(void);
void endservent(void);
struct hostent *gethostbyaddr(const void *addr,
size_t len, int type);
struct hostent *gethostbyname(const char *name);
struct hostent *gethostent(void);
struct netent *getnetbyaddr(in_addr_t net, int
type);
struct netent *getnetbyname(const char *name);
struct netent *getnetent(void);
struct protoent *getprotobyname(const char *name);
struct protoent *getprotobynumber(int proto);
struct protoent *getprotoent(void);
struct servent *getservbyname(const char *name, const
char *proto);
struct servent *getservbyport(int port, const char
*proto);
struct servent *getservent(void);
void sethostent(int stayopen);
void setnetent(int stayopen);
void setprotoent(int stayopen);
void setservent(int stayopen);
SEE ALSO
Intro(3), endhostent(3NSL), endhostent(3XNET),
endnetent(3SOCKET), endnetent(3XNET), endprotoent(3SOCKET),
endprotoent(3XNET), endservent(3SOCKET), endservent(3XNET),
in(3HEAD), standards(5)
SunOS 5.8 Last change: 13 Aug 1998 3
|
 |
|
|
