Debian Codegraph @

src/resolve/resolved-dns-server.h

raw
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
2 #pragma once
3
4 #include "in-addr-util.h"
5 #include "list.h"
6 #include "resolved-conf.h"
7 #include "resolved-dnstls.h"
8 #include "resolved-forward.h"
9
10 typedef enum DnsServerType {
11 DNS_SERVER_SYSTEM,
12 DNS_SERVER_FALLBACK,
13 DNS_SERVER_LINK,
14 DNS_SERVER_DELEGATE,
15 _DNS_SERVER_TYPE_MAX,
16 _DNS_SERVER_TYPE_INVALID = -EINVAL,
17 } DnsServerType;
18
19 DECLARE_STRING_TABLE_LOOKUP(dns_server_type, DnsServerType);
20
21 typedef enum DnsServerFeatureLevel {
22 DNS_SERVER_FEATURE_LEVEL_TCP,
23 DNS_SERVER_FEATURE_LEVEL_UDP,
24 DNS_SERVER_FEATURE_LEVEL_EDNS0,
25 DNS_SERVER_FEATURE_LEVEL_TLS_PLAIN,
26 DNS_SERVER_FEATURE_LEVEL_DO,
27 DNS_SERVER_FEATURE_LEVEL_TLS_DO,
28 _DNS_SERVER_FEATURE_LEVEL_MAX,
29 _DNS_SERVER_FEATURE_LEVEL_INVALID = -EINVAL,
30 } DnsServerFeatureLevel;
31
32 #define DNS_SERVER_FEATURE_LEVEL_WORST 0
33 #define DNS_SERVER_FEATURE_LEVEL_BEST (_DNS_SERVER_FEATURE_LEVEL_MAX - 1)
34 #define DNS_SERVER_FEATURE_LEVEL_IS_EDNS0(x) ((x) >= DNS_SERVER_FEATURE_LEVEL_EDNS0)
35 #define DNS_SERVER_FEATURE_LEVEL_IS_TLS(x) IN_SET(x, DNS_SERVER_FEATURE_LEVEL_TLS_PLAIN, DNS_SERVER_FEATURE_LEVEL_TLS_DO)
36 #define DNS_SERVER_FEATURE_LEVEL_IS_DNSSEC(x) ((x) >= DNS_SERVER_FEATURE_LEVEL_DO)
37 #define DNS_SERVER_FEATURE_LEVEL_IS_UDP(x) IN_SET(x, DNS_SERVER_FEATURE_LEVEL_UDP, DNS_SERVER_FEATURE_LEVEL_EDNS0, DNS_SERVER_FEATURE_LEVEL_DO)
38
39 DECLARE_STRING_TABLE_LOOKUP(dns_server_feature_level, DnsServerFeatureLevel);
40
41 typedef struct DnsServer {
42 Manager *manager;
43
44 unsigned n_ref;
45
46 DnsServerType type;
47 Link *link;
48 DnsDelegate *delegate;
49
50 int family;
51 union in_addr_union address;
52 int ifindex; /* for IPv6 link-local DNS servers */
53 uint16_t port;
54 char *server_name;
55
56 char *server_string;
57 char *server_string_full;
58
59 /* The long-lived stream towards this server. */
60 DnsStream *stream;
61
62 #if ENABLE_DNS_OVER_TLS
63 DnsTlsServerData dnstls_data;
64 #endif
65
66 DnsServerFeatureLevel verified_feature_level;
67 DnsServerFeatureLevel possible_feature_level;
68
69 size_t received_udp_fragment_max; /* largest packet or fragment (without IP/UDP header) we saw so far */
70
71 unsigned n_failed_udp;
72 unsigned n_failed_tcp;
73 unsigned n_failed_tls;
74
75 bool packet_truncated:1; /* Set when TC bit was set on reply */
76 bool packet_bad_opt:1; /* Set when OPT was missing or otherwise bad on reply */
77 bool packet_rrsig_missing:1; /* Set when RRSIG was missing */
78 bool packet_invalid:1; /* Set when we failed to parse a reply */
79 bool packet_do_off:1; /* Set when the server didn't copy DNSSEC DO flag from request to response */
80 bool packet_fragmented:1; /* Set when we ever saw a fragmented packet */
81
82 usec_t verified_usec;
83 usec_t features_grace_period_usec;
84
85 /* Whether we already warned about downgrading to non-DNSSEC mode for this server */
86 bool warned_downgrade:1;
87
88 /* Used when GC'ing old DNS servers when configuration changes. */
89 bool marked:1;
90
91 /* If linked is set, then this server appears in the servers linked list */
92 bool linked:1;
93 LIST_FIELDS(DnsServer, servers);
94
95 /* Servers registered via D-Bus are not removed on reload */
96 ResolveConfigSource config_source;
97
98 /* Tri-state to indicate if the DNS server is accessible. */
99 int accessible;
100 } DnsServer;
101
102 int dns_server_new(
103 Manager *m,
104 DnsServer **ret,
105 DnsServerType type,
106 Link *link,
107 DnsDelegate *delegate,
108 int family,
109 const union in_addr_union *in_addr,
110 uint16_t port,
111 int ifindex,
112 const char *server_name,
113 ResolveConfigSource config_source);
114
115 DECLARE_TRIVIAL_REF_UNREF_FUNC(DnsServer, dns_server);
116
117 void dns_server_unlink(DnsServer *s);
118 void dns_server_move_back_and_unmark(DnsServer *s);
119
120 void dns_server_packet_received(DnsServer *s, int protocol, DnsServerFeatureLevel level, size_t fragsize);
121 void dns_server_packet_lost(DnsServer *s, int protocol, DnsServerFeatureLevel level);
122 void dns_server_packet_truncated(DnsServer *s, DnsServerFeatureLevel level);
123 void dns_server_packet_rrsig_missing(DnsServer *s, DnsServerFeatureLevel level);
124 void dns_server_packet_bad_opt(DnsServer *s, DnsServerFeatureLevel level);
125 void dns_server_packet_rcode_downgrade(DnsServer *s, DnsServerFeatureLevel level);
126 void dns_server_packet_invalid(DnsServer *s, DnsServerFeatureLevel level);
127 void dns_server_packet_do_off(DnsServer *s, DnsServerFeatureLevel level);
128 void dns_server_packet_udp_fragmented(DnsServer *s, size_t fragsize);
129
130 DnsServerFeatureLevel dns_server_possible_feature_level(DnsServer *s);
131
132 int dns_server_adjust_opt(DnsServer *server, DnsPacket *packet, DnsServerFeatureLevel level);
133
134 const char* dns_server_string(DnsServer *server);
135 const char* dns_server_string_full(DnsServer *server);
136 int dns_server_ifindex(const DnsServer *s);
137 uint16_t dns_server_port(const DnsServer *s);
138
139 bool dns_server_dnssec_supported(DnsServer *server);
140
141 void dns_server_warn_downgrade(DnsServer *server);
142
143 DnsServer *dns_server_find(DnsServer *first, int family, const union in_addr_union *in_addr, uint16_t port, int ifindex, const char *name);
144
145 void dns_server_unlink_all(DnsServer *first);
146 void dns_server_unlink_on_reload(DnsServer *server);
147 bool dns_server_unlink_marked(DnsServer *first);
148 void dns_server_mark_all(DnsServer *server);
149
150 int manager_parse_search_domains_and_warn(Manager *m, const char *string);
151 int manager_parse_dns_server_string_and_warn(Manager *m, DnsServerType type, const char *string);
152
153 DnsServer *manager_get_first_dns_server(Manager *m, DnsServerType t);
154
155 DnsServer *manager_set_dns_server(Manager *m, DnsServer *s);
156 DnsServer *manager_get_dns_server(Manager *m);
157 void manager_next_dns_server(Manager *m, DnsServer *if_current);
158
159 DnssecMode dns_server_get_dnssec_mode(DnsServer *s);
160 DnsOverTlsMode dns_server_get_dns_over_tls_mode(DnsServer *s);
161
162 size_t dns_server_get_mtu(DnsServer *s);
163
164 DEFINE_TRIVIAL_CLEANUP_FUNC(DnsServer*, dns_server_unref);
165
166 extern const struct hash_ops dns_server_hash_ops;
167
168 void dns_server_flush_cache(DnsServer *s);
169
170 void dns_server_reset_features(DnsServer *s);
171 void dns_server_reset_features_all(DnsServer *s);
172
173 void dns_server_dump(DnsServer *s, FILE *f);
174
175 void dns_server_unref_stream(DnsServer *s);
176
177 DnsScope *dns_server_scope(DnsServer *s);
178
179 static inline bool dns_server_is_fallback(DnsServer *s) {
180 return s && s->type == DNS_SERVER_FALLBACK;
181 }
182
183 int dns_server_dump_state_to_json(DnsServer *server, sd_json_variant **ret);
184 int dns_server_dump_configuration_to_json(DnsServer *server, sd_json_variant **ret);
185
186 int dns_server_is_accessible(DnsServer *s);
187 static inline void dns_server_reset_accessible(DnsServer *s) {
188 s->accessible = -1;
189 }
190 void dns_server_reset_accessible_all(DnsServer *first);