1 | #ifndef HEADER_CURL_DOH_H |
2 | #define |
3 | /*************************************************************************** |
4 | * _ _ ____ _ |
5 | * Project ___| | | | _ \| | |
6 | * / __| | | | |_) | | |
7 | * | (__| |_| | _ <| |___ |
8 | * \___|\___/|_| \_\_____| |
9 | * |
10 | * Copyright (C) 2018 - 2019, Daniel Stenberg, <daniel@haxx.se>, et al. |
11 | * |
12 | * This software is licensed as described in the file COPYING, which |
13 | * you should have received as part of this distribution. The terms |
14 | * are also available at https://curl.haxx.se/docs/copyright.html. |
15 | * |
16 | * You may opt to use, copy, modify, merge, publish, distribute and/or sell |
17 | * copies of the Software, and permit persons to whom the Software is |
18 | * furnished to do so, under the terms of the COPYING file. |
19 | * |
20 | * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY |
21 | * KIND, either express or implied. |
22 | * |
23 | ***************************************************************************/ |
24 | |
25 | #include "urldata.h" |
26 | #include "curl_addrinfo.h" |
27 | |
28 | #ifndef CURL_DISABLE_DOH |
29 | |
30 | /* |
31 | * Curl_doh() resolve a name using DoH (DNS-over-HTTPS). It resolves a name |
32 | * and returns a 'Curl_addrinfo *' with the address information. |
33 | */ |
34 | |
35 | Curl_addrinfo *Curl_doh(struct connectdata *conn, |
36 | const char *hostname, |
37 | int port, |
38 | int *waitp); |
39 | |
40 | CURLcode Curl_doh_is_resolved(struct connectdata *conn, |
41 | struct Curl_dns_entry **dns); |
42 | |
43 | int Curl_doh_getsock(struct connectdata *conn, curl_socket_t *socks); |
44 | |
45 | typedef enum { |
46 | DOH_OK, |
47 | DOH_DNS_BAD_LABEL, /* 1 */ |
48 | DOH_DNS_OUT_OF_RANGE, /* 2 */ |
49 | DOH_DNS_LABEL_LOOP, /* 3 */ |
50 | DOH_TOO_SMALL_BUFFER, /* 4 */ |
51 | DOH_OUT_OF_MEM, /* 5 */ |
52 | DOH_DNS_RDATA_LEN, /* 6 */ |
53 | DOH_DNS_MALFORMAT, /* 7 */ |
54 | DOH_DNS_BAD_RCODE, /* 8 - no such name */ |
55 | DOH_DNS_UNEXPECTED_TYPE, /* 9 */ |
56 | DOH_DNS_UNEXPECTED_CLASS, /* 10 */ |
57 | DOH_NO_CONTENT, /* 11 */ |
58 | DOH_DNS_BAD_ID, /* 12 */ |
59 | DOH_DNS_NAME_TOO_LONG /* 13 */ |
60 | } DOHcode; |
61 | |
62 | typedef enum { |
63 | DNS_TYPE_A = 1, |
64 | DNS_TYPE_NS = 2, |
65 | DNS_TYPE_CNAME = 5, |
66 | DNS_TYPE_AAAA = 28, |
67 | DNS_TYPE_DNAME = 39 /* RFC6672 */ |
68 | } DNStype; |
69 | |
70 | #define DOH_MAX_ADDR 24 |
71 | #define DOH_MAX_CNAME 4 |
72 | |
73 | struct cnamestore { |
74 | size_t len; /* length of cname */ |
75 | char *alloc; /* allocated pointer */ |
76 | size_t allocsize; /* allocated size */ |
77 | }; |
78 | |
79 | struct dohaddr { |
80 | int type; |
81 | union { |
82 | unsigned char v4[4]; /* network byte order */ |
83 | unsigned char v6[16]; |
84 | } ip; |
85 | }; |
86 | |
87 | struct dohentry { |
88 | unsigned int ttl; |
89 | int numaddr; |
90 | struct dohaddr addr[DOH_MAX_ADDR]; |
91 | int numcname; |
92 | struct cnamestore cname[DOH_MAX_CNAME]; |
93 | }; |
94 | |
95 | |
96 | #ifdef DEBUGBUILD |
97 | DOHcode doh_encode(const char *host, |
98 | DNStype dnstype, |
99 | unsigned char *dnsp, /* buffer */ |
100 | size_t len, /* buffer size */ |
101 | size_t *olen); /* output length */ |
102 | DOHcode doh_decode(unsigned char *doh, |
103 | size_t dohlen, |
104 | DNStype dnstype, |
105 | struct dohentry *d); |
106 | void de_cleanup(struct dohentry *d); |
107 | #endif |
108 | |
109 | #else /* if DOH is disabled */ |
110 | #define Curl_doh(a,b,c,d) NULL |
111 | #define Curl_doh_is_resolved(x,y) CURLE_COULDNT_RESOLVE_HOST |
112 | #endif |
113 | |
114 | #endif /* HEADER_CURL_DOH_H */ |
115 | |