src/resolve/resolved-dns-server.h

   1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
   2
   3 #pragma once
   4
   5 /***
   6   This file is part of systemd.
   7
   8   Copyright 2014 Lennart Poettering
   9
  10   systemd is free software; you can redistribute it and/or modify it
  11   under the terms of the GNU Lesser General Public License as published by
  12   the Free Software Foundation; either version 2.1 of the License, or
  13   (at your option) any later version.
  14
  15   systemd is distributed in the hope that it will be useful, but
  16   WITHOUT ANY WARRANTY; without even the implied warranty of
  17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  18   Lesser General Public License for more details.
  19
  20   You should have received a copy of the GNU Lesser General Public License
  21   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  22 ***/
  23
  24 #include "in-addr-util.h"
  25
  26 typedef struct DnsServer DnsServer;
  27
  28 typedef enum DnsServerType {
  29         DNS_SERVER_SYSTEM,
  30         DNS_SERVER_FALLBACK,
  31         DNS_SERVER_LINK,
  32 } DnsServerType;
  33
  34 typedef enum DnsServerFeatureLevel {
  35         DNS_SERVER_FEATURE_LEVEL_TCP,
  36         DNS_SERVER_FEATURE_LEVEL_UDP,
  37         DNS_SERVER_FEATURE_LEVEL_EDNS0,
  38         DNS_SERVER_FEATURE_LEVEL_DO,
  39         DNS_SERVER_FEATURE_LEVEL_LARGE,
  40         _DNS_SERVER_FEATURE_LEVEL_MAX,
  41         _DNS_SERVER_FEATURE_LEVEL_INVALID = -1
  42 } DnsServerFeatureLevel;
  43
  44 #define DNS_SERVER_FEATURE_LEVEL_WORST 0
  45 #define DNS_SERVER_FEATURE_LEVEL_BEST (_DNS_SERVER_FEATURE_LEVEL_MAX - 1)
  46
  47 const char* dns_server_feature_level_to_string(int i) _const_;
  48 int dns_server_feature_level_from_string(const char *s) _pure_;
  49
  50 #include "resolved-link.h"
  51 #include "resolved-manager.h"
  52
  53 struct DnsServer {
  54         Manager *manager;
  55
  56         unsigned n_ref;
  57
  58         DnsServerType type;
  59         Link *link;
  60
  61         int family;
  62         union in_addr_union address;
  63
  64         char *server_string;
  65
  66         usec_t resend_timeout;
  67         usec_t max_rtt;
  68
  69         DnsServerFeatureLevel verified_feature_level;
  70         DnsServerFeatureLevel possible_feature_level;
  71         size_t received_udp_packet_max;
  72         unsigned n_failed_udp;
  73         unsigned n_failed_tcp;
  74         bool packet_failed:1;
  75         bool packet_truncated:1;
  76         usec_t verified_usec;
  77         usec_t features_grace_period_usec;
  78
  79         /* Indicates whether responses are augmented with RRSIG by
  80          * server or not. Note that this is orthogonal to the feature
  81          * level stuff, as it's only information describing responses,
  82          * and has no effect on how the questions are asked. */
  83         bool rrsig_missing:1;
  84
  85         /* Used when GC'ing old DNS servers when configuration changes. */
  86         bool marked:1;
  87
  88         /* If linked is set, then this server appears in the servers linked list */
  89         bool linked:1;
  90         LIST_FIELDS(DnsServer, servers);
  91 };
  92
  93 int dns_server_new(
  94                 Manager *m,
  95                 DnsServer **ret,
  96                 DnsServerType type,
  97                 Link *link,
  98                 int family,
  99                 const union in_addr_union *address);
 100
 101 DnsServer* dns_server_ref(DnsServer *s);
 102 DnsServer* dns_server_unref(DnsServer *s);
 103
 104 void dns_server_unlink(DnsServer *s);
 105 void dns_server_move_back_and_unmark(DnsServer *s);
 106
 107 void dns_server_packet_received(DnsServer *s, int protocol, DnsServerFeatureLevel level, usec_t rtt, size_t size);
 108 void dns_server_packet_lost(DnsServer *s, int protocol, DnsServerFeatureLevel level, usec_t usec);
 109 void dns_server_packet_failed(DnsServer *s, DnsServerFeatureLevel level);
 110 void dns_server_packet_truncated(DnsServer *s, DnsServerFeatureLevel level);
 111 void dns_server_packet_rrsig_missing(DnsServer *s);
 112
 113 DnsServerFeatureLevel dns_server_possible_feature_level(DnsServer *s);
 114
 115 int dns_server_adjust_opt(DnsServer *server, DnsPacket *packet, DnsServerFeatureLevel level);
 116
 117 const char *dns_server_string(DnsServer *server);
 118
 119 bool dns_server_dnssec_supported(DnsServer *server);
 120
 121 DnsServer *dns_server_find(DnsServer *first, int family, const union in_addr_union *in_addr);
 122
 123 void dns_server_unlink_all(DnsServer *first);
 124 void dns_server_unlink_marked(DnsServer *first);
 125 void dns_server_mark_all(DnsServer *first);
 126
 127 DnsServer *manager_get_first_dns_server(Manager *m, DnsServerType t);
 128
 129 DnsServer *manager_set_dns_server(Manager *m, DnsServer *s);
 130 DnsServer *manager_get_dns_server(Manager *m);
 131 void manager_next_dns_server(Manager *m);
 132
 133 DEFINE_TRIVIAL_CLEANUP_FUNC(DnsServer*, dns_server_unref);
 134
 135 extern const struct hash_ops dns_server_hash_ops;