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 */
64 /* The long-lived stream towards this server. */
67 #if ENABLE_DNS_OVER_TLS
68 DnsTlsServerData dnstls_data
;
71 DnsServerFeatureLevel verified_feature_level
;
72 DnsServerFeatureLevel possible_feature_level
;
74 size_t received_udp_packet_max
;
76 unsigned n_failed_udp
;
77 unsigned n_failed_tcp
;
78 unsigned n_failed_tls
;
80 bool packet_truncated
:1;
81 bool packet_bad_opt
:1;
82 bool packet_rrsig_missing
:1;
85 usec_t features_grace_period_usec
;
87 /* Whether we already warned about downgrading to non-DNSSEC mode for this server */
88 bool warned_downgrade
:1;
90 /* Used when GC'ing old DNS servers when configuration changes. */
93 /* If linked is set, then this server appears in the servers linked list */
95 LIST_FIELDS(DnsServer
, servers
);
104 const union in_addr_union
*address
,
106 const char *server_string
);
108 DnsServer
* dns_server_ref(DnsServer
*s
);
109 DnsServer
* dns_server_unref(DnsServer
*s
);
111 void dns_server_unlink(DnsServer
*s
);
112 void dns_server_move_back_and_unmark(DnsServer
*s
);
114 void dns_server_packet_received(DnsServer
*s
, int protocol
, DnsServerFeatureLevel level
, size_t size
);
115 void dns_server_packet_lost(DnsServer
*s
, int protocol
, DnsServerFeatureLevel level
);
116 void dns_server_packet_truncated(DnsServer
*s
, DnsServerFeatureLevel level
);
117 void dns_server_packet_rrsig_missing(DnsServer
*s
, DnsServerFeatureLevel level
);
118 void dns_server_packet_bad_opt(DnsServer
*s
, DnsServerFeatureLevel level
);
119 void dns_server_packet_rcode_downgrade(DnsServer
*s
, DnsServerFeatureLevel level
);
121 DnsServerFeatureLevel
dns_server_possible_feature_level(DnsServer
*s
);
123 int dns_server_adjust_opt(DnsServer
*server
, DnsPacket
*packet
, DnsServerFeatureLevel level
);
125 const char *dns_server_string(DnsServer
*server
);
126 int dns_server_ifindex(const DnsServer
*s
);
128 bool dns_server_dnssec_supported(DnsServer
*server
);
130 void dns_server_warn_downgrade(DnsServer
*server
);
132 DnsServer
*dns_server_find(DnsServer
*first
, int family
, const union in_addr_union
*in_addr
, int ifindex
);
134 void dns_server_unlink_all(DnsServer
*first
);
135 void dns_server_unlink_marked(DnsServer
*first
);
136 void dns_server_mark_all(DnsServer
*first
);
138 DnsServer
*manager_get_first_dns_server(Manager
*m
, DnsServerType t
);
140 DnsServer
*manager_set_dns_server(Manager
*m
, DnsServer
*s
);
141 DnsServer
*manager_get_dns_server(Manager
*m
);
142 void manager_next_dns_server(Manager
*m
);
144 DnssecMode
dns_server_get_dnssec_mode(DnsServer
*s
);
145 DnsOverTlsMode
dns_server_get_dns_over_tls_mode(DnsServer
*s
);
147 DEFINE_TRIVIAL_CLEANUP_FUNC(DnsServer
*, dns_server_unref
);
149 extern const struct hash_ops dns_server_hash_ops
;
151 void dns_server_flush_cache(DnsServer
*s
);
153 void dns_server_reset_features(DnsServer
*s
);
154 void dns_server_reset_features_all(DnsServer
*s
);
156 void dns_server_dump(DnsServer
*s
, FILE *f
);
158 void dns_server_unref_stream(DnsServer
*s
);
160 DnsScope
*dns_server_scope(DnsServer
*s
);