1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
2 #pragma once
3 
4 #include "list.h"
5 #include "ratelimit.h"
6 
7 typedef struct DnsQueryCandidate DnsQueryCandidate;
8 typedef struct DnsScope DnsScope;
9 
10 #include "resolved-dns-cache.h"
11 #include "resolved-dns-dnssec.h"
12 #include "resolved-dns-packet.h"
13 #include "resolved-dns-query.h"
14 #include "resolved-dns-search-domain.h"
15 #include "resolved-dns-server.h"
16 #include "resolved-dns-stream.h"
17 #include "resolved-dns-zone.h"
18 
19 typedef enum DnsScopeMatch {
20         DNS_SCOPE_NO,
21         DNS_SCOPE_MAYBE,
22         DNS_SCOPE_YES_BASE, /* Add the number of matching labels to this */
23         DNS_SCOPE_YES_END = DNS_SCOPE_YES_BASE + DNS_N_LABELS_MAX,
24         _DNS_SCOPE_MATCH_MAX,
25         _DNS_SCOPE_MATCH_INVALID = -EINVAL,
26 } DnsScopeMatch;
27 
28 struct DnsScope {
29         Manager *manager;
30 
31         DnsProtocol protocol;
32         int family;
33 
34         /* Copied at scope creation time from the link/manager */
35         DnssecMode dnssec_mode;
36         DnsOverTlsMode dns_over_tls_mode;
37 
38         Link *link;
39 
40         DnsCache cache;
41         DnsZone zone;
42 
43         OrderedHashmap *conflict_queue;
44         sd_event_source *conflict_event_source;
45 
46         sd_event_source *announce_event_source;
47 
48         RateLimit ratelimit;
49 
50         usec_t resend_timeout;
51         usec_t max_rtt;
52 
53         LIST_HEAD(DnsQueryCandidate, query_candidates);
54 
55         /* Note that we keep track of ongoing transactions in two ways: once in a hashmap, indexed by the rr
56          * key, and once in a linked list. We use the hashmap to quickly find transactions we can reuse for a
57          * key. But note that there might be multiple transactions for the same key (because the associated
58          * query flags might differ in incompatible ways: e.g. we may not reuse a non-validating transaction
59          * as validating. Hence we maintain a per-key list of transactions, which we iterate through to find
60          * one we can reuse with matching flags. */
61         Hashmap *transactions_by_key;
62         LIST_HEAD(DnsTransaction, transactions);
63 
64         LIST_FIELDS(DnsScope, scopes);
65 
66         bool announced;
67 };
68 
69 int dns_scope_new(Manager *m, DnsScope **ret, Link *l, DnsProtocol p, int family);
70 DnsScope* dns_scope_free(DnsScope *s);
71 
72 void dns_scope_packet_received(DnsScope *s, usec_t rtt);
73 void dns_scope_packet_lost(DnsScope *s, usec_t usec);
74 
75 int dns_scope_emit_udp(DnsScope *s, int fd, int af, DnsPacket *p);
76 int dns_scope_socket_tcp(DnsScope *s, int family, const union in_addr_union *address, DnsServer *server, uint16_t port, union sockaddr_union *ret_socket_address);
77 int dns_scope_socket_udp(DnsScope *s, DnsServer *server);
78 
79 DnsScopeMatch dns_scope_good_domain(DnsScope *s, DnsQuery *q);
80 bool dns_scope_good_key(DnsScope *s, const DnsResourceKey *key);
81 
82 DnsServer *dns_scope_get_dns_server(DnsScope *s);
83 unsigned dns_scope_get_n_dns_servers(DnsScope *s);
84 void dns_scope_next_dns_server(DnsScope *s, DnsServer *if_current);
85 
86 int dns_scope_llmnr_membership(DnsScope *s, bool b);
87 int dns_scope_mdns_membership(DnsScope *s, bool b);
88 
89 int dns_scope_make_reply_packet(DnsScope *s, uint16_t id, int rcode, DnsQuestion *q, DnsAnswer *answer, DnsAnswer *soa, bool tentative, DnsPacket **ret);
90 void dns_scope_process_query(DnsScope *s, DnsStream *stream, DnsPacket *p);
91 
92 DnsTransaction *dns_scope_find_transaction(DnsScope *scope, DnsResourceKey *key, uint64_t query_flags);
93 
94 int dns_scope_notify_conflict(DnsScope *scope, DnsResourceRecord *rr);
95 void dns_scope_check_conflicts(DnsScope *scope, DnsPacket *p);
96 
97 void dns_scope_dump(DnsScope *s, FILE *f);
98 
99 DnsSearchDomain *dns_scope_get_search_domains(DnsScope *s);
100 
101 bool dns_scope_name_wants_search_domain(DnsScope *s, const char *name);
102 
103 bool dns_scope_network_good(DnsScope *s);
104 
105 int dns_scope_ifindex(DnsScope *s);
106 
107 int dns_scope_announce(DnsScope *scope, bool goodbye);
108 
109 int dns_scope_add_dnssd_services(DnsScope *scope);
110 int dns_scope_remove_dnssd_services(DnsScope *scope);
111 
112 bool dns_scope_is_default_route(DnsScope *scope);
113