source: trunk/libs/newlib/src/newlib/libc/sys/linux/include/resolv.h

Last change on this file was 444, checked in by satin@…, 6 years ago

add newlib,libalmos-mkh, restructure shared_syscalls.h and mini-libc
File size: 15.4 KB
Line 
1/*-
2 * Copyright (c) 1983, 1987, 1989, 1993
3 *      The Regents of the University of California.  All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 *    notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 *    notice, this list of conditions and the following disclaimer in the
12 *    documentation and/or other materials provided with the distribution.
13 * 3. All advertising materials mentioning features or use of this software
14 *    must display the following acknowledgement:
15 *      This product includes software developed by the University of
16 *      California, Berkeley and its contributors.
17 * 4. Neither the name of the University nor the names of its contributors
18 *    may be used to endorse or promote products derived from this software
19 *    without specific prior written permission.
20 *
21 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31 * SUCH DAMAGE.
32 */
33
34/*
35 * Portions Copyright (c) 1996 by Internet Software Consortium.
36 *
37 * Permission to use, copy, modify, and distribute this software for any
38 * purpose with or without fee is hereby granted, provided that the above
39 * copyright notice and this permission notice appear in all copies.
40 *
41 * THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS
42 * ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
43 * OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE
44 * CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
45 * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
46 * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
47 * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
48 * SOFTWARE.
49 */
50
51/*
52 *      @(#)resolv.h    8.1 (Berkeley) 6/2/93
53 *      From Id: resolv.h,v 8.12 1998/04/28 19:36:46 halley Exp $
54 * $FreeBSD: src/include/resolv.h,v 1.21 2002/03/23 17:24:53 imp Exp $
55 */
56
57#ifndef _RESOLV_H_
58#define _RESOLV_H_
59
60#include <sys/param.h>
61#include <sys/types.h>
62#include <sys/cdefs.h>
63#include <sys/socket.h>
64#include <stdio.h>
65
66/*
67 * Revision information.  This is the release date in YYYYMMDD format.
68 * It can change every day so the right thing to do with it is use it
69 * in preprocessor commands such as "#if (__RES > 19931104)".  Do not
70 * compare for equality; rather, use it to determine whether your resolver
71 * is new enough to contain a certain feature.
72 */
73
74#define __RES   19960801
75
76/*
77 * Resolver configuration file.
78 * Normally not present, but may contain the address of the
79 * inital name server(s) to query and the domain search list.
80 */
81
82#ifndef _PATH_RESCONF
83#define _PATH_RESCONF        "/etc/resolv.conf"
84#endif
85
86/*
87 * Global defines and variables for resolver stub.
88 */
89#define MAXNS                   3       /* max # name servers we'll track */
90#define MAXDFLSRCH              3       /* # default domain levels to try */
91#define MAXDNSRCH               6       /* max # domains in search path */
92#define LOCALDOMAINPARTS        2       /* min levels in name that is "local" */
93
94#define RES_TIMEOUT             5       /* min. seconds between retries */
95#define MAXRESOLVSORT           10      /* number of net to sort on */
96#define RES_MAXNDOTS            15      /* should reflect bit field size */
97#define RES_MAXRETRANS          30      /* only for resolv.conf/RES_OPTIONS */
98#define RES_MAXRETRY            5       /* only for resolv.conf/RES_OPTIONS */
99#define RES_DFLRETRY            2       /* Default #/tries. */
100#define RES_MAXTIME             65535   /* Infinity, in milliseconds. */
101
102
103typedef enum { res_goahead, res_nextns, res_modified, res_done, res_error }
104        res_sendhookact;
105typedef res_sendhookact (*res_send_qhook) (struct sockaddr_in * const *ns, const u_char **query,
106                                           int *querylen,
107                                           u_char *ans,
108                                           int anssiz,
109                                           int *resplen);
110
111typedef res_sendhookact (*res_send_rhook) (const struct sockaddr_in *ns,
112                                           const u_char *query,
113                                           int querylen,
114                                           u_char *ans,
115                                           int anssiz,
116                                           int *resplen);
117
118
119struct __res_state {
120        int     retrans;                /* retransmition time interval */
121        int     retry;                  /* number of times to retransmit */
122        u_long  options;                /* option flags - see below. */
123        int     nscount;                /* number of name servers */
124        struct sockaddr_in
125                nsaddr_list[MAXNS];     /* address of name server */
126#define nsaddr  nsaddr_list[0]          /* for backward compatibility */
127        u_short id;                     /* current message id */
128        char    *dnsrch[MAXDNSRCH+1];   /* components of domain to search */
129        char    defdname[256];          /* default domain (deprecated) */
130        u_long  pfcode;                 /* RES_PRF_ flags - see below. */
131        unsigned ndots:4;               /* threshold for initial abs. query */
132        unsigned nsort:4;               /* number of elements in sort_list[] */
133        char    unused[3];
134        struct {
135                struct in_addr  addr;
136                u_int32_t       mask;
137        } sort_list[MAXRESOLVSORT];
138        res_send_qhook qhook;           /* query hook */
139        res_send_rhook rhook;           /* response hook */
140        int     res_h_errno;            /* last one set for this context */
141        int     _vcsock;                /* PRIVATE: for res_send VC i/o */
142        u_int   _flags;                 /* PRIVATE: see below */
143        union {
144                char    pad[52];        /* On an i386 this means 512b total. */
145                struct {
146                        u_int16_t               nscount;
147                        u_int16_t               nsmap[MAXNS];
148                        int                     nssocks[MAXNS];
149                        u_int16_t               nscount6;
150                        u_int16_t               nsinit;
151                        struct sockaddr_in6     *nsaddrs[MAXNS];
152                        unsigned long long int  initstamp
153                          __attribute__((__packed__));
154#if 0
155                        unsigned int            _initstamp[2];
156#endif
157                } _ext;
158        } _u;
159};
160
161typedef struct __res_state *res_state;
162
163/* for INET6 */
164/*
165 * replacement of __res_state, separated to keep binary compatibility.
166 */
167struct __res_state_ext {
168        struct sockaddr_storage nsaddr_list[MAXNS];
169        struct {
170                int     af;             /* address family for addr, mask */
171                union {
172                        struct  in_addr ina;
173                        struct  in6_addr in6a;
174                } addr, mask;
175        } sort_list[MAXRESOLVSORT];
176};
177
178/*
179 *  * Resolver flags (used to be discrete per-module statics ints).
180 *   */
181#define RES_F_VC        0x00000001      /* socket is TCP */
182#define RES_F_CONN      0x00000002      /* socket is connected */
183
184/* res_findzonecut() options */
185#define RES_EXHAUSTIVE  0x00000001      /* always do all queries */
186
187/*
188 * Resolver options (keep these in synch with res_debug.c, please)
189 */
190#define RES_INIT        0x00000001      /* address initialized */
191#define RES_DEBUG       0x00000002      /* print debug messages */
192#define RES_AAONLY      0x00000004      /* authoritative answers only (!IMPL)*/
193#define RES_USEVC       0x00000008      /* use virtual circuit */
194#define RES_PRIMARY     0x00000010      /* query primary server only (!IMPL) */
195#define RES_IGNTC       0x00000020      /* ignore truncation errors */
196#define RES_RECURSE     0x00000040      /* recursion desired */
197#define RES_DEFNAMES    0x00000080      /* use default domain name */
198#define RES_STAYOPEN    0x00000100      /* Keep TCP socket open */
199#define RES_DNSRCH      0x00000200      /* search up local domain tree */
200#define RES_INSECURE1   0x00000400      /* type 1 security disabled */
201#define RES_INSECURE2   0x00000800      /* type 2 security disabled */
202#define RES_NOALIASES   0x00001000      /* shuts off HOSTALIASES feature */
203#define RES_USE_INET6   0x00002000      /* use/map IPv6 in gethostbyname() */
204#define RES_ROTATE      0x00004000      /* rotate ns list after each query */
205#define RES_NOCHECKNAME 0x00008000      /* do not check names for sanity. */
206#define RES_KEEPTSIG    0x00010000      /* do not strip TSIG records */
207#define RES_BLAST       0x00020000      /* blast all recursive servers */
208#define RES_USEBSTRING  0x00040000      /* IPv6 reverse lookup with byte
209                                           strings */
210#define RES_NOIP6DOTINT 0x00080000      /* Do not use .ip6.int in IPv6
211                                           reverse lookup */
212
213#define RES_DEFAULT     (RES_RECURSE|RES_DEFNAMES|RES_DNSRCH|RES_NOIP6DOTINT)
214
215/*
216 * Resolver "pfcode" values.  Used by dig.
217 */
218#define RES_PRF_STATS   0x00000001
219#define RES_PRF_UPDATE  0x00000002
220#define RES_PRF_CLASS   0x00000004
221#define RES_PRF_CMD     0x00000008
222#define RES_PRF_QUES    0x00000010
223#define RES_PRF_ANS     0x00000020
224#define RES_PRF_AUTH    0x00000040
225#define RES_PRF_ADD     0x00000080
226#define RES_PRF_HEAD1   0x00000100
227#define RES_PRF_HEAD2   0x00000200
228#define RES_PRF_TTLID   0x00000400
229#define RES_PRF_HEADX   0x00000800
230#define RES_PRF_QUERY   0x00001000
231#define RES_PRF_REPLY   0x00002000
232#define RES_PRF_INIT    0x00004000
233/*                      0x00008000      */
234
235#define RES_SET_H_ERRNO(r,x)                    \
236  do                                            \
237    {                                           \
238      (r)->res_h_errno = x;                     \
239      h_errno = (x);                            \
240    }                                           \
241  while (0)
242
243struct res_sym {
244        int     number;         /* Identifying number, like T_MX */
245        char *  name;           /* Its symbolic name, like "MX" */
246        char *  humanname;      /* Its fun name, like "mail exchanger" */
247};
248
249extern struct __res_state _res;
250/* for INET6 */
251extern struct __res_state_ext _res_ext;
252
253extern const struct res_sym __p_class_syms[];
254extern const struct res_sym __p_type_syms[];
255
256/* Private routines shared between libc/net, named, nslookup and others. */
257#define res_hnok        __res_hnok
258#define res_hostalias   __res_hostalias
259#define res_ownok       __res_ownok
260#define res_mailok      __res_mailok
261#define res_dnok        __res_dnok
262#define sym_ston        __sym_ston
263#define sym_ntos        __sym_ntos
264#define sym_ntop        __sym_ntop
265#define b64_ntop        __b64_ntop
266#define b64_pton        __b64_pton
267#define loc_ntoa        __loc_ntoa
268#define loc_aton        __loc_aton
269#define fp_resstat      __fp_resstat
270#define p_query         __p_query
271#define dn_skipname     __dn_skipname
272#define fp_resstat      __fp_resstat
273#define fp_query        __fp_query
274#define fp_nquery       __fp_nquery
275#define hostalias       __hostalias
276#define putlong         __putlong
277#define putshort        __putshort
278#define p_class         __p_class
279#define p_rcode         __p_rcode
280#define p_time          __p_time
281#define p_type          __p_type
282#define p_query         __p_query
283#define p_cdnname       __p_cdnname
284#define p_section       __p_section
285#define p_cdname        __p_cdname
286#define p_fqnname       __p_fqnname
287#define p_fqname        __p_fqname
288#define p_option        __p_option
289#define p_secstodate    __p_secstodate
290#define dn_count_labels __dn_count_labels
291#define dn_comp         __dn_comp
292#define dn_expand       __dn_expand
293#define res_init        __res_init
294#define res_randomid    __res_randomid
295#define res_query       __res_query
296#define res_search      __res_search
297#define res_querydomain __res_querydomain
298#define res_mkquery     __res_mkquery
299#define res_send        __res_send
300#define res_isourserver __res_isourserver
301#define res_nameinquery __res_nameinquery
302#define res_nclose              __res_nclose
303#define res_ninit               __res_ninit
304#define res_nmkquery            __res_nmkquery
305#define res_npquery             __res_npquery
306#define res_nquery              __res_nquery
307#define res_nquerydomain        __res_nquerydomain
308#define res_nsearch             __res_nsearch
309#define res_nsend               __res_nsend
310#define res_nisourserver        __res_nisourserver
311#define res_queriesmatch __res_queriesmatch
312#define res_close       __res_close
313#define res_opt         __res_opt
314#define res_mkupdate    __res_mkupdate
315#define res_mkupdrec    __res_mkupdrec
316#define res_freeupdrec  __res_freeupdrec
317
318__BEGIN_DECLS
319int             res_hnok(const char *);
320int             res_ownok(const char *);
321int             res_mailok(const char *);
322int             res_dnok(const char *);
323int             sym_ston(const struct res_sym *, const char *, int *);
324const char *    sym_ntos(const struct res_sym *, int, int *);
325const char *    sym_ntop(const struct res_sym *, int, int *);
326int             b64_ntop(u_char const *, size_t, char *, size_t);
327int             b64_pton(char const *, u_char *, size_t);
328int             loc_aton(const char *, u_char *);
329const char *    loc_ntoa(const u_char *, char *);
330int             dn_skipname(const u_char *, const u_char *);
331void            fp_resstat(struct __res_state *, FILE *);
332void            fp_query(const u_char *, FILE *);
333void            fp_nquery(const u_char *, int, FILE *);
334const char *    hostalias(const char *);
335void            putlong(u_int32_t, u_char *);
336void            putshort(u_int16_t, u_char *);
337const char *    p_class(int);
338const char *    p_rcode (int);
339const char *    p_time(u_int32_t);
340const char *    p_type(int);
341void            p_query(const u_char *);
342const u_char *  p_cdnname(const u_char *, const u_char *, int, FILE *);
343const u_char *  p_cdname(const u_char *, const u_char *, FILE *);
344const u_char *  p_fqnname(const u_char *, const u_char *,
345                          int, char *, int);
346const u_char *  p_fqname(const u_char *, const u_char *, FILE *);
347const char *    p_option(u_long);
348char *          p_secstodate(u_long);
349int             dn_count_labels(const char *);
350int             dn_comp(const char *, u_char *, int, u_char **, u_char **);
351int             dn_expand(const u_char *, const u_char *, const u_char *,
352                          char *, int);
353int             res_init(void);
354u_int           res_randomid(void);
355int             res_query(const char *, int, int, u_char *, int);
356int             res_search(const char *, int, int, u_char *, int);
357int             res_querydomain(const char *, const char *, int, int,
358                                u_char *, int);
359int             res_mkquery(int, const char *, int, int, const u_char *,
360                            int, const u_char *, u_char *, int);
361int             res_send(const u_char *, int, u_char *, int);
362int             res_isourserver(const struct sockaddr_in *);
363int             res_nameinquery(const char *, int, int,
364                                const u_char *, const u_char *);
365void            res_npquery (const res_state, const u_char *, int, FILE *);
366const char *    res_hostalias (const res_state, const char *, char *, size_t);
367int             res_nquery (res_state, const char *, int, int, u_char *, int);
368int             res_nsearch (res_state, const char *, int, int, u_char *, int);
369int             res_nquerydomain (res_state, const char *, const char *, int,
370                                  int, u_char *, int);
371int             res_nmkquery (res_state, int, const char *, int, int,
372                              const u_char *, int, const u_char *, u_char *,
373                              int);
374int             res_nsend (res_state, const u_char *, int, u_char *, int);
375void            res_nclose (res_state);
376
377int             res_queriesmatch(const u_char *, const u_char *,
378                                 const u_char *, const u_char *);
379void            res_close(void);
380int             res_opt(int, u_char *, int, int);
381const char *    p_section(int, int);
382/* XXX The following depend on the ns_updrec typedef in arpa/nameser.h */
383#ifdef _ARPA_NAMESER_H_
384int             res_update(ns_updrec *);
385int             res_mkupdate(ns_updrec *, u_char *, int);
386ns_updrec *     res_mkupdrec(int, const char *, u_int, u_int, u_long);
387void            res_freeupdrec(ns_updrec *);
388#endif
389
390__END_DECLS
391
392#endif /* !_RESOLV_H_ */
Note: See TracBrowser for help on using the repository browser.