Annotation of src/include/netdb.h, Revision 1.1.1.1
1.1 deraadt 1: /* $NetBSD: netdb.h,v 1.5 1995/07/03 22:59:12 jtc Exp $ */
2:
3: /*-
4: * Copyright (c) 1980, 1983, 1988 Regents of the University of California.
5: * All rights reserved.
6: *
7: * Redistribution and use in source and binary forms, with or without
8: * modification, are permitted provided that the following conditions
9: * are met:
10: * 1. Redistributions of source code must retain the above copyright
11: * notice, this list of conditions and the following disclaimer.
12: * 2. Redistributions in binary form must reproduce the above copyright
13: * notice, this list of conditions and the following disclaimer in the
14: * documentation and/or other materials provided with the distribution.
15: * 3. All advertising materials mentioning features or use of this software
16: * must display the following acknowledgement:
17: * This product includes software developed by the University of
18: * California, Berkeley and its contributors.
19: * 4. Neither the name of the University nor the names of its contributors
20: * may be used to endorse or promote products derived from this software
21: * without specific prior written permission.
22: *
23: * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26: * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33: * SUCH DAMAGE.
34: *
35: * @(#)netdb.h 5.15 (Berkeley) 4/3/91
36: */
37:
38: #ifndef _NETDB_H_
39: #define _NETDB_H_
40:
41: #define _PATH_HEQUIV "/etc/hosts.equiv"
42: #define _PATH_HOSTS "/etc/hosts"
43: #define _PATH_NETWORKS "/etc/networks"
44: #define _PATH_PROTOCOLS "/etc/protocols"
45: #define _PATH_SERVICES "/etc/services"
46:
47: /*
48: * Structures returned by network data base library. All addresses are
49: * supplied in host order, and returned in network order (suitable for
50: * use in system calls).
51: */
52: struct hostent {
53: char *h_name; /* official name of host */
54: char **h_aliases; /* alias list */
55: int h_addrtype; /* host address type */
56: int h_length; /* length of address */
57: char **h_addr_list; /* list of addresses from name server */
58: #define h_addr h_addr_list[0] /* address, for backward compatiblity */
59: };
60:
61: /*
62: * Assumption here is that a network number
63: * fits in 32 bits -- probably a poor one.
64: */
65: struct netent {
66: char *n_name; /* official name of net */
67: char **n_aliases; /* alias list */
68: int n_addrtype; /* net address type */
69: unsigned long n_net; /* network # */
70: };
71:
72: struct servent {
73: char *s_name; /* official service name */
74: char **s_aliases; /* alias list */
75: int s_port; /* port # */
76: char *s_proto; /* protocol to use */
77: };
78:
79: struct protoent {
80: char *p_name; /* official protocol name */
81: char **p_aliases; /* alias list */
82: int p_proto; /* protocol # */
83: };
84:
85: /*
86: * Error return codes from gethostbyname() and gethostbyaddr()
87: * (left in extern int h_errno).
88: */
89:
90: extern int h_errno;
91:
92: #define HOST_NOT_FOUND 1 /* Authoritative Answer Host not found */
93: #define TRY_AGAIN 2 /* Non-Authoritive Host not found, or SERVERFAIL */
94: #define NO_RECOVERY 3 /* Non recoverable errors, FORMERR, REFUSED, NOTIMP */
95: #define NO_DATA 4 /* Valid name, no data record of requested type */
96: #define NO_ADDRESS NO_DATA /* no address, look for MX record */
97:
98: #include <sys/cdefs.h>
99:
100: __BEGIN_DECLS
101: void endhostent __P((void));
102: void endnetent __P((void));
103: void endprotoent __P((void));
104: void endservent __P((void));
105: struct hostent *gethostbyaddr __P((const char *, int, int));
106: struct hostent *gethostbyname __P((const char *));
107: struct hostent *gethostent __P((void));
108: struct netent *getnetbyaddr __P((long, int)); /* u_long? */
109: struct netent *getnetbyname __P((const char *));
110: struct netent *getnetent __P((void));
111: struct protoent *getprotobyname __P((const char *));
112: struct protoent *getprotobynumber __P((int));
113: struct protoent *getprotoent __P((void));
114: struct servent *getservbyname __P((const char *, const char *));
115: struct servent *getservbyport __P((int, const char *));
116: struct servent *getservent __P((void));
117: void herror __P((const char *));
118: char *hstrerror __P((int));
119: void sethostent __P((int));
120: /* void sethostfile __P((const char *)); */
121: void setnetent __P((int));
122: void setprotoent __P((int));
123: void setservent __P((int));
124: __END_DECLS
125:
126: #endif /* !_NETDB_H_ */