src/network/networkd-network.h

   1 /* SPDX-License-Identifier: LGPL-2.1+ */
   2 #pragma once
   3
   4 /***
   5   This file is part of systemd.
   6
   7   Copyright 2013 Tom Gundersen <teg@jklm.no>
   8
   9   systemd is free software; you can redistribute it and/or modify it
  10   under the terms of the GNU Lesser General Public License as published by
  11   the Free Software Foundation; either version 2.1 of the License, or
  12   (at your option) any later version.
  13
  14   systemd is distributed in the hope that it will be useful, but
  15   WITHOUT ANY WARRANTY; without even the implied warranty of
  16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17   Lesser General Public License for more details.
  18
  19   You should have received a copy of the GNU Lesser General Public License
  20   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  21 ***/
  22
  23 #include "sd-bus.h"
  24 #include "udev.h"
  25
  26 #include "condition.h"
  27 #include "dhcp-identifier.h"
  28 #include "hashmap.h"
  29 #include "resolve-util.h"
  30
  31 #include "networkd-address.h"
  32 #include "networkd-address-label.h"
  33 #include "networkd-brvlan.h"
  34 #include "networkd-fdb.h"
  35 #include "networkd-lldp-tx.h"
  36 #include "networkd-ipv6-proxy-ndp.h"
  37 #include "networkd-route.h"
  38 #include "networkd-routing-policy-rule.h"
  39 #include "networkd-util.h"
  40 #include "netdev/netdev.h"
  41
  42 #define DHCP_ROUTE_METRIC 1024
  43 #define IPV4LL_ROUTE_METRIC 2048
  44
  45 #define BRIDGE_VLAN_BITMAP_MAX 4096
  46 #define BRIDGE_VLAN_BITMAP_LEN (BRIDGE_VLAN_BITMAP_MAX / 32)
  47
  48 typedef enum DHCPClientIdentifier {
  49         DHCP_CLIENT_ID_MAC,
  50         DHCP_CLIENT_ID_DUID,
  51         _DHCP_CLIENT_ID_MAX,
  52         _DHCP_CLIENT_ID_INVALID = -1,
  53 } DHCPClientIdentifier;
  54
  55 typedef enum IPv6PrivacyExtensions {
  56         /* The values map to the kernel's /proc/sys/net/ipv6/conf/xxx/use_tempaddr values */
  57         IPV6_PRIVACY_EXTENSIONS_NO,
  58         IPV6_PRIVACY_EXTENSIONS_PREFER_PUBLIC,
  59         IPV6_PRIVACY_EXTENSIONS_YES, /* aka prefer-temporary */
  60         _IPV6_PRIVACY_EXTENSIONS_MAX,
  61         _IPV6_PRIVACY_EXTENSIONS_INVALID = -1,
  62 } IPv6PrivacyExtensions;
  63
  64 typedef enum DHCPUseDomains {
  65         DHCP_USE_DOMAINS_NO,
  66         DHCP_USE_DOMAINS_YES,
  67         DHCP_USE_DOMAINS_ROUTE,
  68         _DHCP_USE_DOMAINS_MAX,
  69         _DHCP_USE_DOMAINS_INVALID = -1,
  70 } DHCPUseDomains;
  71
  72 typedef enum LLDPMode {
  73         LLDP_MODE_NO = 0,
  74         LLDP_MODE_YES = 1,
  75         LLDP_MODE_ROUTERS_ONLY = 2,
  76         _LLDP_MODE_MAX,
  77         _LLDP_MODE_INVALID = -1,
  78 } LLDPMode;
  79
  80 typedef struct DUID {
  81         /* Value of Type in [DHCP] section */
  82         DUIDType type;
  83
  84         uint8_t raw_data_len;
  85         uint8_t raw_data[MAX_DUID_LEN];
  86 } DUID;
  87
  88 typedef struct NetworkConfigSection {
  89         unsigned line;
  90         char filename[];
  91 } NetworkConfigSection;
  92
  93 int network_config_section_new(const char *filename, unsigned line, NetworkConfigSection **s);
  94 void network_config_section_free(NetworkConfigSection *network);
  95
  96 DEFINE_TRIVIAL_CLEANUP_FUNC(NetworkConfigSection*, network_config_section_free);
  97 #define _cleanup_network_config_section_free_ _cleanup_(network_config_section_freep)
  98
  99 typedef struct Manager Manager;
 100
 101 struct Network {
 102         Manager *manager;
 103
 104         char *filename;
 105         char *name;
 106
 107         struct ether_addr *match_mac;
 108         char **match_path;
 109         char **match_driver;
 110         char **match_type;
 111         char **match_name;
 112
 113         Condition *match_host;
 114         Condition *match_virt;
 115         Condition *match_kernel_cmdline;
 116         Condition *match_kernel_version;
 117         Condition *match_arch;
 118
 119         char *description;
 120
 121         NetDev *bridge;
 122         NetDev *bond;
 123         NetDev *vrf;
 124         Hashmap *stacked_netdevs;
 125
 126         /* DHCP Client Support */
 127         AddressFamilyBoolean dhcp;
 128         DHCPClientIdentifier dhcp_client_identifier;
 129         char *dhcp_vendor_class_identifier;
 130         char *dhcp_hostname;
 131         unsigned dhcp_route_metric;
 132         uint32_t dhcp_route_table;
 133         uint16_t dhcp_client_port;
 134         bool dhcp_anonymize;
 135         bool dhcp_send_hostname;
 136         bool dhcp_broadcast;
 137         bool dhcp_critical;
 138         bool dhcp_use_dns;
 139         bool dhcp_use_ntp;
 140         bool dhcp_use_mtu;
 141         bool dhcp_use_routes;
 142         bool dhcp_use_timezone;
 143         bool dhcp_use_hostname;
 144         bool dhcp_route_table_set;
 145         DHCPUseDomains dhcp_use_domains;
 146
 147         /* DHCP Server Support */
 148         bool dhcp_server;
 149         bool dhcp_server_emit_dns;
 150         struct in_addr *dhcp_server_dns;
 151         unsigned n_dhcp_server_dns;
 152         bool dhcp_server_emit_ntp;
 153         struct in_addr *dhcp_server_ntp;
 154         unsigned n_dhcp_server_ntp;
 155         bool dhcp_server_emit_router;
 156         bool dhcp_server_emit_timezone;
 157         char *dhcp_server_timezone;
 158         usec_t dhcp_server_default_lease_time_usec, dhcp_server_max_lease_time_usec;
 159         uint32_t dhcp_server_pool_offset;
 160         uint32_t dhcp_server_pool_size;
 161
 162         /* IPV4LL Support */
 163         AddressFamilyBoolean link_local;
 164         bool ipv4ll_route;
 165
 166         /* IPv6 prefix delegation support */
 167         bool router_prefix_delegation;
 168         usec_t router_lifetime_usec;
 169         uint8_t router_preference;
 170         bool router_managed;
 171         bool router_other_information;
 172         bool router_emit_dns;
 173         bool router_emit_domains;
 174         usec_t router_dns_lifetime_usec;
 175         struct in6_addr *router_dns;
 176         unsigned n_router_dns;
 177         char **router_search_domains;
 178
 179         /* Bridge Support */
 180         bool use_bpdu;
 181         bool hairpin;
 182         bool fast_leave;
 183         bool allow_port_to_be_root;
 184         bool unicast_flood;
 185         uint32_t cost;
 186         uint16_t priority;
 187
 188         bool use_br_vlan;
 189         uint16_t pvid;
 190         uint32_t br_vid_bitmap[BRIDGE_VLAN_BITMAP_LEN];
 191         uint32_t br_untagged_bitmap[BRIDGE_VLAN_BITMAP_LEN];
 192
 193         AddressFamilyBoolean ip_forward;
 194         bool ip_masquerade;
 195
 196         int ipv6_accept_ra;
 197         int ipv6_dad_transmits;
 198         int ipv6_hop_limit;
 199         int ipv6_proxy_ndp;
 200         int proxy_arp;
 201
 202         bool ipv6_accept_ra_use_dns;
 203         bool active_slave;
 204         bool primary_slave;
 205         DHCPUseDomains ipv6_accept_ra_use_domains;
 206         uint32_t ipv6_accept_ra_route_table;
 207
 208         union in_addr_union ipv6_token;
 209         IPv6PrivacyExtensions ipv6_privacy_extensions;
 210
 211         struct ether_addr *mac;
 212         size_t mtu;
 213         int arp;
 214         bool unmanaged;
 215         bool configure_without_carrier;
 216         uint32_t iaid;
 217         DUID duid;
 218
 219         bool required_for_online; /* Is this network required to be considered online? */
 220
 221         LLDPMode lldp_mode; /* LLDP reception */
 222         LLDPEmit lldp_emit; /* LLDP transmission */
 223
 224         LIST_HEAD(Address, static_addresses);
 225         LIST_HEAD(Route, static_routes);
 226         LIST_HEAD(FdbEntry, static_fdb_entries);
 227         LIST_HEAD(IPv6ProxyNDPAddress, ipv6_proxy_ndp_addresses);
 228         LIST_HEAD(AddressLabel, address_labels);
 229         LIST_HEAD(Prefix, static_prefixes);
 230         LIST_HEAD(RoutingPolicyRule, rules);
 231
 232         unsigned n_static_addresses;
 233         unsigned n_static_routes;
 234         unsigned n_static_fdb_entries;
 235         unsigned n_ipv6_proxy_ndp_addresses;
 236         unsigned n_address_labels;
 237         unsigned n_static_prefixes;
 238         unsigned n_rules;
 239
 240         Hashmap *addresses_by_section;
 241         Hashmap *routes_by_section;
 242         Hashmap *fdb_entries_by_section;
 243         Hashmap *address_labels_by_section;
 244         Hashmap *prefixes_by_section;
 245         Hashmap *rules_by_section;
 246
 247         struct in_addr_data *dns;
 248         unsigned n_dns;
 249
 250         char **search_domains, **route_domains, **ntp, **bind_carrier;
 251
 252         ResolveSupport llmnr;
 253         ResolveSupport mdns;
 254         DnssecMode dnssec_mode;
 255         Set *dnssec_negative_trust_anchors;
 256
 257         LIST_FIELDS(Network, networks);
 258 };
 259
 260 void network_free(Network *network);
 261
 262 DEFINE_TRIVIAL_CLEANUP_FUNC(Network*, network_free);
 263 #define _cleanup_network_free_ _cleanup_(network_freep)
 264
 265 int network_load(Manager *manager);
 266
 267 int network_get_by_name(Manager *manager, const char *name, Network **ret);
 268 int network_get(Manager *manager, struct udev_device *device, const char *ifname, const struct ether_addr *mac, Network **ret);
 269 int network_apply(Network *network, Link *link);
 270 void network_apply_anonymize_if_set(Network *network);
 271
 272 bool network_has_static_ipv6_addresses(Network *network);
 273
 274 int config_parse_netdev(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 275 int config_parse_domains(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 276 int config_parse_tunnel(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 277 int config_parse_dhcp(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 278 int config_parse_dns(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 279 int config_parse_dhcp_client_identifier(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 280 int config_parse_ipv6token(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 281 int config_parse_ipv6_privacy_extensions(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 282 int config_parse_hostname(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 283 int config_parse_timezone(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 284 int config_parse_dhcp_server_dns(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 285 int config_parse_radv_dns(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 286 int config_parse_radv_search_domains(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 287 int config_parse_dhcp_server_ntp(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 288 int config_parse_dnssec_negative_trust_anchors(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 289 int config_parse_dhcp_use_domains(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 290 int config_parse_lldp_mode(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 291 int config_parse_dhcp_route_table(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 292 int config_parse_ntp(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 293
 294 /* Legacy IPv4LL support */
 295 int config_parse_ipv4ll(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 296
 297 const struct ConfigPerfItem* network_network_gperf_lookup(const char *key, GPERF_LEN_TYPE length);
 298
 299 extern const sd_bus_vtable network_vtable[];
 300
 301 int network_node_enumerator(sd_bus *bus, const char *path, void *userdata, char ***nodes, sd_bus_error *error);
 302 int network_object_find(sd_bus *bus, const char *path, const char *interface, void *userdata, void **found, sd_bus_error *error);
 303
 304 const char* ipv6_privacy_extensions_to_string(IPv6PrivacyExtensions i) _const_;
 305 IPv6PrivacyExtensions ipv6_privacy_extensions_from_string(const char *s) _pure_;
 306
 307 const char* dhcp_use_domains_to_string(DHCPUseDomains p) _const_;
 308 DHCPUseDomains dhcp_use_domains_from_string(const char *s) _pure_;
 309
 310 const char* lldp_mode_to_string(LLDPMode m) _const_;
 311 LLDPMode lldp_mode_from_string(const char *s) _pure_;