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;
 116         Condition *match_arch;
 117
 118         char *description;
 119
 120         NetDev *bridge;
 121         NetDev *bond;
 122         NetDev *vrf;
 123         Hashmap *stacked_netdevs;
 124
 125         /* DHCP Client Support */
 126         AddressFamilyBoolean dhcp;
 127         DHCPClientIdentifier dhcp_client_identifier;
 128         char *dhcp_vendor_class_identifier;
 129         char *dhcp_hostname;
 130         unsigned dhcp_route_metric;
 131         uint32_t dhcp_route_table;
 132         uint16_t dhcp_client_port;
 133         bool dhcp_anonymize;
 134         bool dhcp_send_hostname;
 135         bool dhcp_broadcast;
 136         bool dhcp_critical;
 137         bool dhcp_use_dns;
 138         bool dhcp_use_ntp;
 139         bool dhcp_use_mtu;
 140         bool dhcp_use_routes;
 141         bool dhcp_use_timezone;
 142         bool dhcp_use_hostname;
 143         bool dhcp_route_table_set;
 144         DHCPUseDomains dhcp_use_domains;
 145
 146         /* DHCP Server Support */
 147         bool dhcp_server;
 148         bool dhcp_server_emit_dns;
 149         struct in_addr *dhcp_server_dns;
 150         unsigned n_dhcp_server_dns;
 151         bool dhcp_server_emit_ntp;
 152         struct in_addr *dhcp_server_ntp;
 153         unsigned n_dhcp_server_ntp;
 154         bool dhcp_server_emit_router;
 155         bool dhcp_server_emit_timezone;
 156         char *dhcp_server_timezone;
 157         usec_t dhcp_server_default_lease_time_usec, dhcp_server_max_lease_time_usec;
 158         uint32_t dhcp_server_pool_offset;
 159         uint32_t dhcp_server_pool_size;
 160
 161         /* IPV4LL Support */
 162         AddressFamilyBoolean link_local;
 163         bool ipv4ll_route;
 164
 165         /* IPv6 prefix delegation support */
 166         bool router_prefix_delegation;
 167         usec_t router_lifetime_usec;
 168         uint8_t router_preference;
 169         bool router_managed;
 170         bool router_other_information;
 171         bool router_emit_dns;
 172         bool router_emit_domains;
 173         usec_t router_dns_lifetime_usec;
 174         struct in6_addr *router_dns;
 175         unsigned n_router_dns;
 176         char **router_search_domains;
 177
 178         /* Bridge Support */
 179         bool use_bpdu;
 180         bool hairpin;
 181         bool fast_leave;
 182         bool allow_port_to_be_root;
 183         bool unicast_flood;
 184         uint32_t cost;
 185         uint16_t priority;
 186
 187         bool use_br_vlan;
 188         uint16_t pvid;
 189         uint32_t br_vid_bitmap[BRIDGE_VLAN_BITMAP_LEN];
 190         uint32_t br_untagged_bitmap[BRIDGE_VLAN_BITMAP_LEN];
 191
 192         AddressFamilyBoolean ip_forward;
 193         bool ip_masquerade;
 194
 195         int ipv6_accept_ra;
 196         int ipv6_dad_transmits;
 197         int ipv6_hop_limit;
 198         int ipv6_proxy_ndp;
 199         int proxy_arp;
 200
 201         bool ipv6_accept_ra_use_dns;
 202         bool active_slave;
 203         bool primary_slave;
 204         DHCPUseDomains ipv6_accept_ra_use_domains;
 205         uint32_t ipv6_accept_ra_route_table;
 206
 207         union in_addr_union ipv6_token;
 208         IPv6PrivacyExtensions ipv6_privacy_extensions;
 209
 210         struct ether_addr *mac;
 211         size_t mtu;
 212         int arp;
 213         bool unmanaged;
 214         bool configure_without_carrier;
 215         uint32_t iaid;
 216         DUID duid;
 217
 218         LLDPMode lldp_mode; /* LLDP reception */
 219         LLDPEmit lldp_emit; /* LLDP transmission */
 220
 221         LIST_HEAD(Address, static_addresses);
 222         LIST_HEAD(Route, static_routes);
 223         LIST_HEAD(FdbEntry, static_fdb_entries);
 224         LIST_HEAD(IPv6ProxyNDPAddress, ipv6_proxy_ndp_addresses);
 225         LIST_HEAD(AddressLabel, address_labels);
 226         LIST_HEAD(Prefix, static_prefixes);
 227         LIST_HEAD(RoutingPolicyRule, rules);
 228
 229         unsigned n_static_addresses;
 230         unsigned n_static_routes;
 231         unsigned n_static_fdb_entries;
 232         unsigned n_ipv6_proxy_ndp_addresses;
 233         unsigned n_address_labels;
 234         unsigned n_static_prefixes;
 235         unsigned n_rules;
 236
 237         Hashmap *addresses_by_section;
 238         Hashmap *routes_by_section;
 239         Hashmap *fdb_entries_by_section;
 240         Hashmap *address_labels_by_section;
 241         Hashmap *prefixes_by_section;
 242         Hashmap *rules_by_section;
 243
 244         struct in_addr_data *dns;
 245         unsigned n_dns;
 246
 247         char **search_domains, **route_domains, **ntp, **bind_carrier;
 248
 249         ResolveSupport llmnr;
 250         ResolveSupport mdns;
 251         DnssecMode dnssec_mode;
 252         Set *dnssec_negative_trust_anchors;
 253
 254         LIST_FIELDS(Network, networks);
 255 };
 256
 257 void network_free(Network *network);
 258
 259 DEFINE_TRIVIAL_CLEANUP_FUNC(Network*, network_free);
 260 #define _cleanup_network_free_ _cleanup_(network_freep)
 261
 262 int network_load(Manager *manager);
 263
 264 int network_get_by_name(Manager *manager, const char *name, Network **ret);
 265 int network_get(Manager *manager, struct udev_device *device, const char *ifname, const struct ether_addr *mac, Network **ret);
 266 int network_apply(Network *network, Link *link);
 267 void network_apply_anonymize_if_set(Network *network);
 268
 269 bool network_has_static_ipv6_addresses(Network *network);
 270
 271 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);
 272 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);
 273 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);
 274 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);
 275 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);
 276 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);
 277 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);
 278 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);
 279 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);
 280 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);
 281 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);
 282 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);
 283 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);
 284 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);
 285 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);
 286 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);
 287 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);
 288 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);
 289 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);
 290
 291 /* Legacy IPv4LL support */
 292 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);
 293
 294 const struct ConfigPerfItem* network_network_gperf_lookup(const char *key, GPERF_LEN_TYPE length);
 295
 296 extern const sd_bus_vtable network_vtable[];
 297
 298 int network_node_enumerator(sd_bus *bus, const char *path, void *userdata, char ***nodes, sd_bus_error *error);
 299 int network_object_find(sd_bus *bus, const char *path, const char *interface, void *userdata, void **found, sd_bus_error *error);
 300
 301 const char* ipv6_privacy_extensions_to_string(IPv6PrivacyExtensions i) _const_;
 302 IPv6PrivacyExtensions ipv6_privacy_extensions_from_string(const char *s) _pure_;
 303
 304 const char* dhcp_use_domains_to_string(DHCPUseDomains p) _const_;
 305 DHCPUseDomains dhcp_use_domains_from_string(const char *s) _pure_;
 306
 307 const char* lldp_mode_to_string(LLDPMode m) _const_;
 308 LLDPMode lldp_mode_from_string(const char *s) _pure_;