Return to doh.h CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / curl / lib

Annotation of embedaddon/curl/lib/doh.h, revision 1.1.1.1

1.1       misho       1: #ifndef HEADER_CURL_DOH_H
                      2: #define HEADER_CURL_DOH_H
                      3: /***************************************************************************
                      4:  *                                  _   _ ____  _
                      5:  *  Project                     ___| | | |  _ \| |
                      6:  *                             / __| | | | |_) | |
                      7:  *                            | (__| |_| |  _ <| |___
                      8:  *                             \___|\___/|_| \_\_____|
                      9:  *
                     10:  * Copyright (C) 2018 - 2020, 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(const 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 */