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     ! 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 */