src/resolve/resolved-dns-server.h

   1 /* SPDX-License-Identifier: LGPL-2.1+ */
   2 #pragma once
   3
   4 /***
   5   This file is part of systemd.
   6
   7   Copyright 2014 Lennart Poettering
   8 ***/
   9
  10 #include "in-addr-util.h"
  11
  12 typedef struct DnsServer DnsServer;
  13
  14 typedef enum DnsServerType {
  15         DNS_SERVER_SYSTEM,
  16         DNS_SERVER_FALLBACK,
  17         DNS_SERVER_LINK,
  18 } DnsServerType;
  19 #define _DNS_SERVER_TYPE_MAX (DNS_SERVER_LINK + 1)
  20
  21 const char* dns_server_type_to_string(DnsServerType i) _const_;
  22 DnsServerType dns_server_type_from_string(const char *s) _pure_;
  23
  24 typedef enum DnsServerFeatureLevel {
  25         DNS_SERVER_FEATURE_LEVEL_TCP,
  26         DNS_SERVER_FEATURE_LEVEL_UDP,
  27         DNS_SERVER_FEATURE_LEVEL_EDNS0,
  28         DNS_SERVER_FEATURE_LEVEL_DO,
  29         DNS_SERVER_FEATURE_LEVEL_LARGE,
  30         _DNS_SERVER_FEATURE_LEVEL_MAX,
  31         _DNS_SERVER_FEATURE_LEVEL_INVALID = -1
  32 } DnsServerFeatureLevel;
  33
  34 #define DNS_SERVER_FEATURE_LEVEL_WORST 0
  35 #define DNS_SERVER_FEATURE_LEVEL_BEST (_DNS_SERVER_FEATURE_LEVEL_MAX - 1)
  36
  37 const char* dns_server_feature_level_to_string(int i) _const_;
  38 int dns_server_feature_level_from_string(const char *s) _pure_;
  39
  40 #include "resolved-link.h"
  41 #include "resolved-manager.h"
  42
  43 struct DnsServer {
  44         Manager *manager;
  45
  46         unsigned n_ref;
  47
  48         DnsServerType type;
  49         Link *link;
  50
  51         int family;
  52         union in_addr_union address;
  53         int ifindex; /* for IPv6 link-local DNS servers */
  54
  55         char *server_string;
  56
  57         usec_t resend_timeout;
  58         usec_t max_rtt;
  59
  60         DnsServerFeatureLevel verified_feature_level;
  61         DnsServerFeatureLevel possible_feature_level;
  62
  63         size_t received_udp_packet_max;
  64
  65         unsigned n_failed_udp;
  66         unsigned n_failed_tcp;
  67
  68         bool packet_truncated:1;
  69         bool packet_bad_opt:1;
  70         bool packet_rrsig_missing:1;
  71
  72         usec_t verified_usec;
  73         usec_t features_grace_period_usec;
  74
  75         /* Whether we already warned about downgrading to non-DNSSEC mode for this server */
  76         bool warned_downgrade:1;
  77
  78         /* Used when GC'ing old DNS servers when configuration changes. */
  79         bool marked:1;
  80
  81         /* If linked is set, then this server appears in the servers linked list */
  82         bool linked:1;
  83         LIST_FIELDS(DnsServer, servers);
  84 };
  85
  86 int dns_server_new(
  87                 Manager *m,
  88                 DnsServer **ret,
  89                 DnsServerType type,
  90                 Link *link,
  91                 int family,
  92                 const union in_addr_union *address,
  93                 int ifindex);
  94
  95 DnsServer* dns_server_ref(DnsServer *s);
  96 DnsServer* dns_server_unref(DnsServer *s);
  97
  98 void dns_server_unlink(DnsServer *s);
  99 void dns_server_move_back_and_unmark(DnsServer *s);
 100
 101 void dns_server_packet_received(DnsServer *s, int protocol, DnsServerFeatureLevel level, usec_t rtt, size_t size);
 102 void dns_server_packet_lost(DnsServer *s, int protocol, DnsServerFeatureLevel level, usec_t usec);
 103 void dns_server_packet_truncated(DnsServer *s, DnsServerFeatureLevel level);
 104 void dns_server_packet_rrsig_missing(DnsServer *s, DnsServerFeatureLevel level);
 105 void dns_server_packet_bad_opt(DnsServer *s, DnsServerFeatureLevel level);
 106 void dns_server_packet_rcode_downgrade(DnsServer *s, DnsServerFeatureLevel level);
 107
 108 DnsServerFeatureLevel dns_server_possible_feature_level(DnsServer *s);
 109
 110 int dns_server_adjust_opt(DnsServer *server, DnsPacket *packet, DnsServerFeatureLevel level);
 111
 112 const char *dns_server_string(DnsServer *server);
 113 int dns_server_ifindex(const DnsServer *s);
 114
 115 bool dns_server_dnssec_supported(DnsServer *server);
 116
 117 void dns_server_warn_downgrade(DnsServer *server);
 118
 119 bool dns_server_limited_domains(DnsServer *server);
 120
 121 DnsServer *dns_server_find(DnsServer *first, int family, const union in_addr_union *in_addr, int ifindex);
 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 bool dns_server_address_valid(int family, const union in_addr_union *sa);
 134
 135 DnssecMode dns_server_get_dnssec_mode(DnsServer *s);
 136
 137 DEFINE_TRIVIAL_CLEANUP_FUNC(DnsServer*, dns_server_unref);
 138
 139 extern const struct hash_ops dns_server_hash_ops;
 140
 141 void dns_server_flush_cache(DnsServer *s);
 142
 143 void dns_server_reset_features(DnsServer *s);
 144 void dns_server_reset_features_all(DnsServer *s);
 145
 146 void dns_server_dump(DnsServer *s, FILE *f);