entered into RCS
[kopensolaris-gnu/glibc.git] / resolv / resolv.h
1 /*
2  *      @(#)resolv.h    5.15 (Berkeley) 4/3/91
3  *      $Id$
4  */
5
6 /*
7  * ++Copyright++ 1983, 1987, 1989
8  * -
9  * Copyright (c) 1983, 1987, 1989 Regents of the University of California.
10  * All rights reserved.
11  * 
12  * Redistribution and use in source and binary forms, with or without
13  * modification, are permitted provided that the following conditions
14  * are met:
15  * 1. Redistributions of source code must retain the above copyright
16  *    notice, this list of conditions and the following disclaimer.
17  * 2. Redistributions in binary form must reproduce the above copyright
18  *    notice, this list of conditions and the following disclaimer in the
19  *    documentation and/or other materials provided with the distribution.
20  * 3. All advertising materials mentioning features or use of this software
21  *    must display the following acknowledgement:
22  *      This product includes software developed by the University of
23  *      California, Berkeley and its contributors.
24  * 4. Neither the name of the University nor the names of its contributors
25  *    may be used to endorse or promote products derived from this software
26  *    without specific prior written permission.
27  * 
28  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
29  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
30  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
31  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
32  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
33  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
34  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
35  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
36  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
37  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38  * SUCH DAMAGE.
39  * -
40  * Portions Copyright (c) 1993 by Digital Equipment Corporation.
41  * 
42  * Permission to use, copy, modify, and distribute this software for any
43  * purpose with or without fee is hereby granted, provided that the above
44  * copyright notice and this permission notice appear in all copies, and that
45  * the name of Digital Equipment Corporation not be used in advertising or
46  * publicity pertaining to distribution of the document or software without
47  * specific, written prior permission.
48  * 
49  * THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL
50  * WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES
51  * OF MERCHANTABILITY AND FITNESS.   IN NO EVENT SHALL DIGITAL EQUIPMENT
52  * CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
53  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
54  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
55  * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
56  * SOFTWARE.
57  * -
58  * --Copyright--
59  */
60
61 #ifndef _RESOLV_H_
62 #define _RESOLV_H_
63
64 #include <sys/param.h>
65 #if (!defined(BSD)) || (BSD < 199306)
66 # include <sys/bitypes.h>
67 #else
68 # include <sys/types.h>
69 #endif
70 #include <sys/cdefs.h>
71 #include <stdio.h>
72
73 /*
74  * Resolver configuration file.
75  * Normally not present, but may contain the address of the
76  * inital name server(s) to query and the domain search list.
77  */
78
79 #ifndef _PATH_RESCONF
80 #define _PATH_RESCONF        "/etc/resolv.conf"
81 #endif
82
83 /*
84  * Global defines and variables for resolver stub.
85  */
86 #define MAXNS                   3       /* max # name servers we'll track */
87 #define MAXDFLSRCH              3       /* # default domain levels to try */
88 #define MAXDNSRCH               6       /* max # domains in search path */
89 #define LOCALDOMAINPARTS        2       /* min levels in name that is "local" */
90
91 #define RES_TIMEOUT             5       /* min. seconds between retries */
92
93 /* this was "struct state" until 4.9 */
94 struct __res_state {
95         int     retrans;                /* retransmition time interval */
96         int     retry;                  /* number of times to retransmit */
97         u_int32_t       options;                /* option flags - see below. */
98         int     nscount;                /* number of name servers */
99         struct  sockaddr_in nsaddr_list[MAXNS]; /* address of name server */
100 #define nsaddr  nsaddr_list[0]          /* for backward compatibility */
101         u_short id;                     /* current packet id */
102         char    *dnsrch[MAXDNSRCH+1];   /* components of domain to search */
103         char    defdname[MAXDNAME];     /* default domain */
104         u_int32_t       pfcode;                 /* RES_PRF_ flags - see below. */
105 };
106
107 /*
108  * Resolver options (keep these in synch with res_debug.c, please)
109  */
110 #define RES_INIT        0x0001          /* address initialized */
111 #define RES_DEBUG       0x0002          /* print debug messages */
112 #define RES_AAONLY      0x0004          /* authoritative answers only */
113 #define RES_USEVC       0x0008          /* use virtual circuit */
114 #define RES_PRIMARY     0x0010          /* query primary server only */
115 #define RES_IGNTC       0x0020          /* ignore trucation errors */
116 #define RES_RECURSE     0x0040          /* recursion desired */
117 #define RES_DEFNAMES    0x0080          /* use default domain name */
118 #define RES_STAYOPEN    0x0100          /* Keep TCP socket open */
119 #define RES_DNSRCH      0x0200          /* search up local domain tree */
120
121 #define RES_DEFAULT     (RES_RECURSE | RES_DEFNAMES | RES_DNSRCH)
122
123 /*
124  * Resolver "pfcode" values.  Used by dig.
125  */
126 #define RES_PRF_STATS   0x0001
127 /*                      0x0002  */
128 #define RES_PRF_CLASS   0x0004
129 #define RES_PRF_CMD     0x0008
130 #define RES_PRF_QUES    0x0010
131 #define RES_PRF_ANS     0x0020
132 #define RES_PRF_AUTH    0x0040
133 #define RES_PRF_ADD     0x0080
134 #define RES_PRF_HEAD1   0x0100
135 #define RES_PRF_HEAD2   0x0200
136 #define RES_PRF_TTLID   0x0400
137 #define RES_PRF_HEADX   0x0800
138 #define RES_PRF_QUERY   0x1000
139 #define RES_PRF_REPLY   0x2000
140 #define RES_PRF_INIT    0x4000
141 /*                      0x8000  */
142
143 extern struct __res_state _res;
144
145 /* Private routines shared between libc/net, named, nslookup and others. */
146 #define dn_skipname     __dn_skipname
147 #define fp_query        __fp_query
148 #define hostalias       __hostalias
149 #define putlong         __putlong
150 #define putshort        __putshort
151 #define p_class         __p_class
152 #define p_time          __p_time
153 #define p_type          __p_type
154 __BEGIN_DECLS
155 int      __dn_skipname __P((const u_char *, const u_char *));
156 void     __fp_resstat __P((struct __res_state *, FILE *));
157 void     __fp_query __P((char *, FILE *));
158 char    *__hostalias __P((const char *));
159 void     __putlong __P((u_int32_t, u_char *));
160 void     __putshort __P((u_short, u_char *));
161 char    *__p_class __P((int));
162 char    *__p_time __P((u_int32_t));
163 char    *__p_type __P((int));
164
165 int      dn_comp __P((const u_char *, u_char *, int, u_char **, u_char **));
166 int      dn_expand __P((const u_char *, const u_char *, const u_char *,
167                         u_char *, int));
168 int      res_init __P((void));
169 int      res_mkquery __P((int, const char *, int, int, const char *, int,
170                           const char *, char *, int));
171 int      res_send __P((const char *, int, char *, int));
172 __END_DECLS
173
174 #endif /* !_RESOLV_H_ */