src/resolve/resolved-dns-scope.h

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