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
  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         bool announced:1;
  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
  68 int dns_scope_new(Manager *m, DnsScope **ret, Link *l, DnsProtocol p, int family);
  69 DnsScope* dns_scope_free(DnsScope *s);
  70
  71 void dns_scope_packet_received(DnsScope *s, usec_t rtt);
  72 void dns_scope_packet_lost(DnsScope *s, usec_t usec);
  73
  74 int dns_scope_emit_udp(DnsScope *s, int fd, DnsPacket *p);
  75 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);
  76 int dns_scope_socket_udp(DnsScope *s, DnsServer *server);
  77
  78 DnsScopeMatch dns_scope_good_domain(DnsScope *s, int ifindex, uint64_t flags, const char *domain);
  79 bool dns_scope_good_key(DnsScope *s, const DnsResourceKey *key);
  80
  81 DnsServer *dns_scope_get_dns_server(DnsScope *s);
  82 unsigned dns_scope_get_n_dns_servers(DnsScope *s);
  83 void dns_scope_next_dns_server(DnsScope *s, DnsServer *if_current);
  84
  85 int dns_scope_llmnr_membership(DnsScope *s, bool b);
  86 int dns_scope_mdns_membership(DnsScope *s, bool b);
  87
  88 int dns_scope_make_reply_packet(DnsScope *s, uint16_t id, int rcode, DnsQuestion *q, DnsAnswer *answer, DnsAnswer *soa, bool tentative, DnsPacket **ret);
  89 void dns_scope_process_query(DnsScope *s, DnsStream *stream, DnsPacket *p);
  90
  91 DnsTransaction *dns_scope_find_transaction(DnsScope *scope, DnsResourceKey *key, uint64_t query_flags);
  92
  93 int dns_scope_notify_conflict(DnsScope *scope, DnsResourceRecord *rr);
  94 void dns_scope_check_conflicts(DnsScope *scope, DnsPacket *p);
  95
  96 void dns_scope_dump(DnsScope *s, FILE *f);
  97
  98 DnsSearchDomain *dns_scope_get_search_domains(DnsScope *s);
  99
 100 bool dns_scope_name_wants_search_domain(DnsScope *s, const char *name);
 101
 102 bool dns_scope_network_good(DnsScope *s);
 103
 104 int dns_scope_ifindex(DnsScope *s);
 105
 106 int dns_scope_announce(DnsScope *scope, bool goodbye);
 107
 108 int dns_scope_add_dnssd_services(DnsScope *scope);
 109 int dns_scope_remove_dnssd_services(DnsScope *scope);
 110
 111 bool dns_scope_is_default_route(DnsScope *scope);