dirmngr: New option --nameserver.
[gnupg.git] / dirmngr / dns-stuff.h
1 /* dns-stuff.c - DNS related code including CERT RR (rfc-4398)
2  * Copyright (C) 2006 Free Software Foundation, Inc.
3  * Copyright (C) 2006, 2015 Werner Koch
4  *
5  * This file is part of GnuPG.
6  *
7  * This file is free software; you can redistribute it and/or modify
8  * it under the terms of either
9  *
10  *   - the GNU Lesser General Public License as published by the Free
11  *     Software Foundation; either version 3 of the License, or (at
12  *     your option) any later version.
13  *
14  * or
15  *
16  *   - the GNU General Public License as published by the Free
17  *     Software Foundation; either version 2 of the License, or (at
18  *     your option) any later version.
19  *
20  * or both in parallel, as here.
21  *
22  * This file is distributed in the hope that it will be useful,
23  * but WITHOUT ANY WARRANTY; without even the implied warranty of
24  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
25  * GNU General Public License for more details.
26  *
27  * You should have received a copy of the GNU General Public License
28  * along with this program; if not, see <http://www.gnu.org/licenses/>.
29  */
30 #ifndef GNUPG_DIRMNGR_DNS_STUFF_H
31 #define GNUPG_DIRMNGR_DNS_STUFF_H
32
33 #ifdef HAVE_W32_SYSTEM
34 # ifdef HAVE_WINSOCK2_H
35 #  include <winsock2.h>
36 # endif
37 # include <windows.h>
38 #else
39 # include <sys/types.h>
40 # include <sys/socket.h>
41 #endif
42
43 /*
44  * Flags used with resolve_dns_addr.
45  */
46 #define DNS_NUMERICHOST        1  /* Force numeric output format.  */
47 #define DNS_WITHBRACKET        2  /* Put brackets around numeric v6
48                                      addresses.  */
49
50 /*
51  * Constants for use with get_dns_cert.
52  */
53 #define DNS_CERTTYPE_ANY       0 /* Internal catch all type. */
54 /* Certificate types according to RFC-4398:  */
55 #define DNS_CERTTYPE_PKIX      1 /* X.509 as per PKIX. */
56 #define DNS_CERTTYPE_SPKI      2 /* SPKI certificate.  */
57 #define DNS_CERTTYPE_PGP       3 /* OpenPGP packet.  */
58 #define DNS_CERTTYPE_IPKIX     4 /* The URL of an X.509 data object. */
59 #define DNS_CERTTYPE_ISPKI     5 /* The URL of an SPKI certificate.  */
60 #define DNS_CERTTYPE_IPGP      6 /* The fingerprint
61                                     and URL of an OpenPGP packet.  */
62 #define DNS_CERTTYPE_ACPKIX    7 /* Attribute Certificate.  */
63 #define DNS_CERTTYPE_IACPKIX   8 /* The URL of an Attribute Certificate.  */
64 #define DNS_CERTTYPE_URI     253 /* URI private.  */
65 #define DNS_CERTTYPE_OID     254 /* OID private.  */
66 /* Hacks for our implementation.  */
67 #define DNS_CERTTYPE_RRBASE 1024 /* Base of special constants.  */
68 #define DNS_CERTTYPE_RR61   (DNS_CERTTYPE_RRBASE + 61)
69
70
71
72 struct dns_addrinfo_s;
73 typedef struct dns_addrinfo_s *dns_addrinfo_t;
74 struct dns_addrinfo_s
75 {
76   dns_addrinfo_t next;
77   int family;
78   int socktype;
79   int protocol;
80   int addrlen;
81   struct sockaddr addr[1];
82 };
83
84
85 struct srventry
86 {
87   unsigned short priority;
88   unsigned short weight;
89   unsigned short port;
90   int run_count;
91   char target[1025];
92 };
93
94
95 /* Calling this function switches the DNS code into Tor mode if
96    possibe.  Return 0 on success.  */
97 gpg_error_t enable_dns_tormode (int new_circuit);
98
99 /* Change the default IP address of the nameserver to IPADDR.  The
100    address needs to be a numerical IP address and will be used for the
101    next DNS query.  Note that this is only used in Tor mode.  */
102 void set_dns_nameserver (const char *ipaddr);
103
104
105 void free_dns_addrinfo (dns_addrinfo_t ai);
106
107 /* Function similar to getaddrinfo.  */
108 gpg_error_t resolve_dns_name (const char *name, unsigned short port,
109                               int want_family, int want_socktype,
110                               dns_addrinfo_t *r_dai, char **r_canonname);
111
112 /* Function similar to getnameinfo.  */
113 gpg_error_t resolve_dns_addr (const struct sockaddr *addr, int addrlen,
114                               unsigned int flags, char **r_name);
115
116 /* Return true if NAME is a numerical IP address.  */
117 int is_ip_address (const char *name);
118
119 /* Return true if NAME is an onion address.  */
120 int is_onion_address (const char *name);
121
122 /* Get the canonical name for NAME.  */
123 gpg_error_t get_dns_cname (const char *name, char **r_cname);
124
125 /* Return a CERT record or an arbitray RR.  */
126 gpg_error_t get_dns_cert (const char *name, int want_certtype,
127                           void **r_key, size_t *r_keylen,
128                           unsigned char **r_fpr, size_t *r_fprlen,
129                           char **r_url);
130
131
132 int getsrv (const char *name,struct srventry **list);
133
134
135 #endif /*GNUPG_DIRMNGR_DNS_STUFF_H*/