1 /* SPDX-License-Identifier: LGPL-2.1+ */
4 #include "in-addr-util.h"
6 #include "resolve-util.h"
9 typedef struct DnsScope DnsScope
;
10 typedef struct DnsServer DnsServer
;
11 typedef struct DnsStream DnsStream
;
12 typedef struct DnsPacket DnsPacket
;
13 typedef struct Link Link
;
14 typedef struct Manager Manager
;
16 #include "resolved-dnstls.h"
18 typedef enum DnsServerType
{
23 _DNS_SERVER_TYPE_INVALID
= -1
26 const char* dns_server_type_to_string(DnsServerType i
) _const_
;
27 DnsServerType
dns_server_type_from_string(const char *s
) _pure_
;
29 typedef enum DnsServerFeatureLevel
{
30 DNS_SERVER_FEATURE_LEVEL_TCP
,
31 DNS_SERVER_FEATURE_LEVEL_UDP
,
32 DNS_SERVER_FEATURE_LEVEL_EDNS0
,
33 DNS_SERVER_FEATURE_LEVEL_TLS_PLAIN
,
34 DNS_SERVER_FEATURE_LEVEL_DO
,
35 DNS_SERVER_FEATURE_LEVEL_LARGE
,
36 DNS_SERVER_FEATURE_LEVEL_TLS_DO
,
37 _DNS_SERVER_FEATURE_LEVEL_MAX
,
38 _DNS_SERVER_FEATURE_LEVEL_INVALID
= -1
39 } DnsServerFeatureLevel
;
41 #define DNS_SERVER_FEATURE_LEVEL_WORST 0
42 #define DNS_SERVER_FEATURE_LEVEL_BEST (_DNS_SERVER_FEATURE_LEVEL_MAX - 1)
43 #define DNS_SERVER_FEATURE_LEVEL_IS_TLS(x) IN_SET(x, DNS_SERVER_FEATURE_LEVEL_TLS_PLAIN, DNS_SERVER_FEATURE_LEVEL_TLS_DO)
45 const char* dns_server_feature_level_to_string(int i
) _const_
;
46 int dns_server_feature_level_from_string(const char *s
) _pure_
;
57 union in_addr_union address
;
58 int ifindex
; /* for IPv6 link-local DNS servers */
63 char *server_string_full
;
65 /* The long-lived stream towards this server. */
68 #if ENABLE_DNS_OVER_TLS
69 DnsTlsServerData dnstls_data
;
72 DnsServerFeatureLevel verified_feature_level
;
73 DnsServerFeatureLevel possible_feature_level
;
75 size_t received_udp_packet_max
;
77 unsigned n_failed_udp
;
78 unsigned n_failed_tcp
;
79 unsigned n_failed_tls
;
81 bool packet_truncated
:1;
82 bool packet_bad_opt
:1;
83 bool packet_rrsig_missing
:1;
86 usec_t features_grace_period_usec
;
88 /* Whether we already warned about downgrading to non-DNSSEC mode for this server */
89 bool warned_downgrade
:1;
91 /* Used when GC'ing old DNS servers when configuration changes. */
94 /* If linked is set, then this server appears in the servers linked list */
96 LIST_FIELDS(DnsServer
, servers
);
105 const union in_addr_union
*address
,
108 const char *server_string
);
110 DnsServer
* dns_server_ref(DnsServer
*s
);
111 DnsServer
* dns_server_unref(DnsServer
*s
);
113 void dns_server_unlink(DnsServer
*s
);
114 void dns_server_move_back_and_unmark(DnsServer
*s
);
116 void dns_server_packet_received(DnsServer
*s
, int protocol
, DnsServerFeatureLevel level
, size_t size
);
117 void dns_server_packet_lost(DnsServer
*s
, int protocol
, DnsServerFeatureLevel level
);
118 void dns_server_packet_truncated(DnsServer
*s
, DnsServerFeatureLevel level
);
119 void dns_server_packet_rrsig_missing(DnsServer
*s
, DnsServerFeatureLevel level
);
120 void dns_server_packet_bad_opt(DnsServer
*s
, DnsServerFeatureLevel level
);
121 void dns_server_packet_rcode_downgrade(DnsServer
*s
, DnsServerFeatureLevel level
);
123 DnsServerFeatureLevel
dns_server_possible_feature_level(DnsServer
*s
);
125 int dns_server_adjust_opt(DnsServer
*server
, DnsPacket
*packet
, DnsServerFeatureLevel level
);
127 const char *dns_server_string(DnsServer
*server
);
128 const char *dns_server_string_full(DnsServer
*server
);
129 int dns_server_ifindex(const DnsServer
*s
);
130 uint16_t dns_server_port(const DnsServer
*s
);
132 bool dns_server_dnssec_supported(DnsServer
*server
);
134 void dns_server_warn_downgrade(DnsServer
*server
);
136 DnsServer
*dns_server_find(DnsServer
*first
, int family
, const union in_addr_union
*in_addr
, uint16_t port
, int ifindex
, const char *name
);
138 void dns_server_unlink_all(DnsServer
*first
);
139 void dns_server_unlink_marked(DnsServer
*first
);
140 void dns_server_mark_all(DnsServer
*first
);
142 DnsServer
*manager_get_first_dns_server(Manager
*m
, DnsServerType t
);
144 DnsServer
*manager_set_dns_server(Manager
*m
, DnsServer
*s
);
145 DnsServer
*manager_get_dns_server(Manager
*m
);
146 void manager_next_dns_server(Manager
*m
);
148 DnssecMode
dns_server_get_dnssec_mode(DnsServer
*s
);
149 DnsOverTlsMode
dns_server_get_dns_over_tls_mode(DnsServer
*s
);
151 DEFINE_TRIVIAL_CLEANUP_FUNC(DnsServer
*, dns_server_unref
);
153 extern const struct hash_ops dns_server_hash_ops
;
155 void dns_server_flush_cache(DnsServer
*s
);
157 void dns_server_reset_features(DnsServer
*s
);
158 void dns_server_reset_features_all(DnsServer
*s
);
160 void dns_server_dump(DnsServer
*s
, FILE *f
);
162 void dns_server_unref_stream(DnsServer
*s
);
164 DnsScope
*dns_server_scope(DnsServer
*s
);