src/network/networkd.h

   1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
   2
   3 /***
   4   This file is part of systemd.
   5
   6   Copyright 2013 Tom Gundersen <teg@jklm.no>
   7
   8   systemd is free software; you can redistribute it and/or modify it
   9   under the terms of the GNU Lesser General Public License as published by
  10   the Free Software Foundation; either version 2.1 of the License, or
  11   (at your option) any later version.
  12
  13   systemd is distributed in the hope that it will be useful, but
  14   WITHOUT ANY WARRANTY; without even the implied warranty of
  15   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  16   Lesser General Public License for more details.
  17
  18   You should have received a copy of the GNU Lesser General Public License
  19   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  20 ***/
  21
  22 #pragma once
  23
  24 #include <arpa/inet.h>
  25
  26 #include "sd-event.h"
  27 #include "sd-rtnl.h"
  28 #include "sd-bus.h"
  29 #include "sd-dhcp-client.h"
  30 #include "sd-dhcp-server.h"
  31 #include "sd-ipv4ll.h"
  32 #include "sd-icmp6-nd.h"
  33 #include "sd-dhcp6-client.h"
  34 #include "udev.h"
  35 #include "sd-lldp.h"
  36
  37 #include "rtnl-util.h"
  38 #include "hashmap.h"
  39 #include "list.h"
  40 #include "set.h"
  41 #include "condition.h"
  42 #include "in-addr-util.h"
  43
  44 #define CACHE_INFO_INFINITY_LIFE_TIME 0xFFFFFFFFU
  45 #define DHCP_ROUTE_METRIC 1024
  46 #define IPV4LL_ROUTE_METRIC 2048
  47
  48 typedef struct NetDev NetDev;
  49 typedef struct Network Network;
  50 typedef struct Link Link;
  51 typedef struct Address Address;
  52 typedef struct Route Route;
  53 typedef struct Manager Manager;
  54 typedef struct AddressPool AddressPool;
  55 typedef struct FdbEntry FdbEntry;
  56
  57 typedef enum AddressFamilyBoolean {
  58         /* This is a bitmask, though it usually doesn't feel that way! */
  59         ADDRESS_FAMILY_NO = 0,
  60         ADDRESS_FAMILY_IPV4 = 1,
  61         ADDRESS_FAMILY_IPV6 = 2,
  62         ADDRESS_FAMILY_YES = 3,
  63         _ADDRESS_FAMILY_BOOLEAN_MAX,
  64         _ADDRESS_FAMILY_BOOLEAN_INVALID = -1,
  65 } AddressFamilyBoolean;
  66
  67 typedef enum LLMNRSupport {
  68         LLMNR_SUPPORT_NO,
  69         LLMNR_SUPPORT_YES,
  70         LLMNR_SUPPORT_RESOLVE,
  71         _LLMNR_SUPPORT_MAX,
  72         _LLMNR_SUPPORT_INVALID = -1,
  73 } LLMNRSupport;
  74
  75 typedef enum LinkOperationalState {
  76         LINK_OPERSTATE_OFF,
  77         LINK_OPERSTATE_NO_CARRIER,
  78         LINK_OPERSTATE_DORMANT,
  79         LINK_OPERSTATE_CARRIER,
  80         LINK_OPERSTATE_DEGRADED,
  81         LINK_OPERSTATE_ROUTABLE,
  82         _LINK_OPERSTATE_MAX,
  83         _LINK_OPERSTATE_INVALID = -1
  84 } LinkOperationalState;
  85
  86 struct FdbEntry {
  87         Network *network;
  88         unsigned section;
  89
  90         struct ether_addr *mac_addr;
  91         uint16_t vlan_id;
  92
  93         LIST_FIELDS(FdbEntry, static_fdb_entries);
  94 };
  95
  96 struct Network {
  97         Manager *manager;
  98
  99         char *filename;
 100         char *name;
 101
 102         struct ether_addr *match_mac;
 103         char **match_path;
 104         char **match_driver;
 105         char **match_type;
 106         char **match_name;
 107
 108         Condition *match_host;
 109         Condition *match_virt;
 110         Condition *match_kernel;
 111         Condition *match_arch;
 112
 113         char *description;
 114         NetDev *bridge;
 115         NetDev *bond;
 116         Hashmap *stacked_netdevs;
 117         AddressFamilyBoolean dhcp;
 118         char *dhcp_vendor_class_identifier;
 119         bool dhcp_dns;
 120         bool dhcp_ntp;
 121         bool dhcp_mtu;
 122         bool dhcp_hostname;
 123         bool dhcp_domains;
 124         bool dhcp_sendhost;
 125         bool dhcp_broadcast;
 126         bool dhcp_critical;
 127         bool dhcp_routes;
 128         unsigned dhcp_route_metric;
 129         AddressFamilyBoolean link_local;
 130         bool ipv4ll_route;
 131         union in_addr_union ipv6_token;
 132
 133         bool dhcp_server;
 134
 135         unsigned cost;
 136
 137         AddressFamilyBoolean ip_forward;
 138         bool ip_masquerade;
 139
 140         struct ether_addr *mac;
 141         unsigned mtu;
 142
 143         bool lldp;
 144
 145         LIST_HEAD(Address, static_addresses);
 146         LIST_HEAD(Route, static_routes);
 147         LIST_HEAD(FdbEntry, static_fdb_entries);
 148
 149         Hashmap *addresses_by_section;
 150         Hashmap *routes_by_section;
 151         Hashmap *fdb_entries_by_section;
 152
 153         bool wildcard_domain;
 154         char **domains, **dns, **ntp;
 155
 156         LLMNRSupport llmnr;
 157
 158         LIST_FIELDS(Network, networks);
 159 };
 160
 161 struct Address {
 162         Network *network;
 163         unsigned section;
 164
 165         int family;
 166         unsigned char prefixlen;
 167         unsigned char scope;
 168         unsigned char flags;
 169         char *label;
 170
 171         struct in_addr broadcast;
 172         struct ifa_cacheinfo cinfo;
 173
 174         union in_addr_union in_addr;
 175         union in_addr_union in_addr_peer;
 176
 177         bool ip_masquerade_done;
 178
 179         LIST_FIELDS(Address, addresses);
 180 };
 181
 182 struct Route {
 183         Network *network;
 184         unsigned section;
 185
 186         int family;
 187         unsigned char dst_prefixlen;
 188         unsigned char src_prefixlen;
 189         unsigned char scope;
 190         uint32_t metrics;
 191         unsigned char protocol;  /* RTPROT_* */
 192
 193         union in_addr_union in_addr;
 194         union in_addr_union dst_addr;
 195         union in_addr_union src_addr;
 196         union in_addr_union prefsrc_addr;
 197
 198         LIST_FIELDS(Route, routes);
 199 };
 200
 201 struct AddressPool {
 202         Manager *manager;
 203
 204         int family;
 205         unsigned prefixlen;
 206
 207         union in_addr_union in_addr;
 208
 209         LIST_FIELDS(AddressPool, address_pools);
 210 };
 211
 212 struct Manager {
 213         sd_rtnl *rtnl;
 214         sd_event *event;
 215         sd_event_source *bus_retry_event_source;
 216         sd_bus *bus;
 217         sd_bus_slot *prepare_for_sleep_slot;
 218         struct udev *udev;
 219         struct udev_monitor *udev_monitor;
 220         sd_event_source *udev_event_source;
 221
 222         bool enumerating;
 223
 224         char *state_file;
 225         LinkOperationalState operational_state;
 226
 227         Hashmap *links;
 228         Hashmap *netdevs;
 229         Hashmap *networks_by_name;
 230         LIST_HEAD(Network, networks);
 231         LIST_HEAD(AddressPool, address_pools);
 232
 233         usec_t network_dirs_ts_usec;
 234 };
 235
 236 extern const char* const network_dirs[];
 237
 238 /* Manager */
 239
 240 extern const sd_bus_vtable manager_vtable[];
 241
 242 int manager_new(Manager **ret);
 243 void manager_free(Manager *m);
 244
 245 int manager_connect_bus(Manager *m);
 246 int manager_run(Manager *m);
 247
 248 int manager_load_config(Manager *m);
 249 bool manager_should_reload(Manager *m);
 250
 251 int manager_rtnl_enumerate_links(Manager *m);
 252 int manager_rtnl_enumerate_addresses(Manager *m);
 253
 254 int manager_send_changed(Manager *m, const char *property, ...) _sentinel_;
 255 int manager_save(Manager *m);
 256
 257 int manager_address_pool_acquire(Manager *m, int family, unsigned prefixlen, union in_addr_union *found);
 258
 259 DEFINE_TRIVIAL_CLEANUP_FUNC(Manager*, manager_free);
 260 #define _cleanup_manager_free_ _cleanup_(manager_freep)
 261
 262 /* Network */
 263
 264 int network_load(Manager *manager);
 265
 266 void network_free(Network *network);
 267
 268 DEFINE_TRIVIAL_CLEANUP_FUNC(Network*, network_free);
 269 #define _cleanup_network_free_ _cleanup_(network_freep)
 270
 271 int network_get_by_name(Manager *manager, const char *name, Network **ret);
 272 int network_get(Manager *manager, struct udev_device *device,
 273                 const char *ifname, const struct ether_addr *mac,
 274                 Network **ret);
 275 int network_apply(Manager *manager, Network *network, Link *link);
 276
 277 int config_parse_netdev(const char *unit, const char *filename, unsigned line,
 278                         const char *section, unsigned section_line, const char *lvalue,
 279                         int ltype, const char *rvalue, void *data, void *userdata);
 280
 281 int config_parse_domains(const char *unit,
 282                          const char *filename,
 283                          unsigned line,
 284                          const char *section,
 285                          unsigned section_line,
 286                          const char *lvalue,
 287                          int ltype,
 288                          const char *rvalue,
 289                          void *data,
 290                          void *userdata);
 291
 292 int config_parse_tunnel(const char *unit,
 293                         const char *filename,
 294                         unsigned line,
 295                         const char *section,
 296                         unsigned section_line,
 297                         const char *lvalue,
 298                         int ltype,
 299                         const char *rvalue,
 300                         void *data,
 301                         void *userdata);
 302
 303 int config_parse_tunnel_address(const char *unit,
 304                                 const char *filename,
 305                                 unsigned line,
 306                                 const char *section,
 307                                 unsigned section_line,
 308                                 const char *lvalue,
 309                                 int ltype,
 310                                 const char *rvalue,
 311                                 void *data,
 312                                 void *userdata);
 313
 314 int config_parse_vxlan_group_address(const char *unit,
 315                                      const char *filename,
 316                                      unsigned line,
 317                                      const char *section,
 318                                      unsigned section_line,
 319                                      const char *lvalue,
 320                                      int ltype,
 321                                      const char *rvalue,
 322                                      void *data,
 323                                      void *userdata);
 324
 325 extern const sd_bus_vtable network_vtable[];
 326
 327 int network_node_enumerator(sd_bus *bus, const char *path, void *userdata, char ***nodes, sd_bus_error *error);
 328 int network_object_find(sd_bus *bus, const char *path, const char *interface, void *userdata, void **found, sd_bus_error *error);
 329
 330 /* gperf */
 331 const struct ConfigPerfItem* network_network_gperf_lookup(const char *key, unsigned length);
 332
 333 /* Route */
 334 int route_new_static(Network *network, unsigned section, Route **ret);
 335 int route_new_dynamic(Route **ret, unsigned char rtm_protocol);
 336 void route_free(Route *route);
 337 int route_configure(Route *route, Link *link, sd_rtnl_message_handler_t callback);
 338 int route_drop(Route *route, Link *link, sd_rtnl_message_handler_t callback);
 339
 340
 341 DEFINE_TRIVIAL_CLEANUP_FUNC(Route*, route_free);
 342 #define _cleanup_route_free_ _cleanup_(route_freep)
 343
 344 int config_parse_gateway(const char *unit, const char *filename, unsigned line,
 345                          const char *section, unsigned section_line, const char *lvalue,
 346                          int ltype, const char *rvalue, void *data, void *userdata);
 347
 348 int config_parse_destination(const char *unit, const char *filename, unsigned line,
 349                              const char *section, unsigned section_line, const char *lvalue,
 350                              int ltype, const char *rvalue, void *data, void *userdata);
 351
 352 int config_parse_route_priority(const char *unit, const char *filename, unsigned line,
 353                                 const char *section, unsigned section_line, const char *lvalue,
 354                                 int ltype, const char *rvalue, void *data, void *userdata);
 355
 356 int config_parse_route_scope(const char *unit, const char *filename, unsigned line,
 357                              const char *section, unsigned section_line, const char *lvalue,
 358                              int ltype, const char *rvalue, void *data, void *userdata);
 359 /* Address */
 360 int address_new_static(Network *network, unsigned section, Address **ret);
 361 int address_new_dynamic(Address **ret);
 362 void address_free(Address *address);
 363 int address_configure(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 364 int address_update(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 365 int address_drop(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 366 int address_establish(Address *address, Link *link);
 367 int address_release(Address *address, Link *link);
 368 bool address_equal(Address *a1, Address *a2);
 369
 370 DEFINE_TRIVIAL_CLEANUP_FUNC(Address*, address_free);
 371 #define _cleanup_address_free_ _cleanup_(address_freep)
 372
 373 int config_parse_address(const char *unit, const char *filename, unsigned line,
 374                          const char *section, unsigned section_line, const char *lvalue,
 375                          int ltype, const char *rvalue, void *data, void *userdata);
 376
 377 int config_parse_broadcast(const char *unit, const char *filename, unsigned line,
 378                            const char *section, unsigned section_line, const char *lvalue,
 379                            int ltype, const char *rvalue, void *data, void *userdata);
 380
 381 int config_parse_label(const char *unit, const char *filename, unsigned line,
 382                        const char *section, unsigned section_line, const char *lvalue,
 383                        int ltype, const char *rvalue, void *data, void *userdata);
 384
 385 /* Forwarding database table. */
 386 int fdb_entry_configure(Link *link, FdbEntry *const fdb_entry);
 387 void fdb_entry_free(FdbEntry *fdb_entry);
 388 int fdb_entry_new_static(Network *const network, const unsigned section, FdbEntry **ret);
 389
 390 DEFINE_TRIVIAL_CLEANUP_FUNC(FdbEntry*, fdb_entry_free);
 391 #define _cleanup_fdbentry_free_ _cleanup_(fdb_entry_freep)
 392
 393 int config_parse_fdb_hwaddr(const char *unit, const char *filename, unsigned line,
 394                             const char *section, unsigned section_line, const char *lvalue,
 395                             int ltype, const char *rvalue, void *data, void *userdata);
 396
 397 int config_parse_fdb_vlan_id(const char *unit, const char *filename, unsigned line,
 398                              const char *section, unsigned section_line, const char *lvalue,
 399                              int ltype, const char *rvalue, void *data, void *userdata);
 400
 401 /* DHCP support */
 402
 403 int config_parse_dhcp(const char *unit, const char *filename, unsigned line,
 404                       const char *section, unsigned section_line, const char *lvalue,
 405                       int ltype, const char *rvalue, void *data, void *userdata);
 406
 407 /* IPv4LL support (legacy) */
 408
 409 int config_parse_ipv4ll(const char *unit, const char *filename, unsigned line,
 410                         const char *section, unsigned section_line, const char *lvalue,
 411                         int ltype, const char *rvalue, void *data, void *userdata);
 412
 413 /* IPv6 support */
 414 int config_parse_token(const char *unit, const char *filename, unsigned line,
 415                        const char *section, unsigned section_line, const char *lvalue,
 416                        int ltype, const char *rvalue, void *data, void *userdata);
 417
 418 /* LLMNR support */
 419
 420 const char* llmnr_support_to_string(LLMNRSupport i) _const_;
 421 LLMNRSupport llmnr_support_from_string(const char *s) _pure_;
 422
 423 int config_parse_llmnr(const char *unit, const char *filename, unsigned line,
 424                       const char *section, unsigned section_line, const char *lvalue,
 425                       int ltype, const char *rvalue, void *data, void *userdata);
 426
 427 /* Address Pool */
 428
 429 int address_pool_new(Manager *m, AddressPool **ret, int family, const union in_addr_union *u, unsigned prefixlen);
 430 int address_pool_new_from_string(Manager *m, AddressPool **ret, int family, const char *p, unsigned prefixlen);
 431 void address_pool_free(AddressPool *p);
 432
 433 int address_pool_acquire(AddressPool *p, unsigned prefixlen, union in_addr_union *found);
 434
 435 const char *address_family_boolean_to_string(AddressFamilyBoolean b) _const_;
 436 AddressFamilyBoolean address_family_boolean_from_string(const char *s) _const_;
 437
 438 int config_parse_address_family_boolean(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);
 439
 440 /* Opeartional State */
 441
 442 const char* link_operstate_to_string(LinkOperationalState s) _const_;
 443 LinkOperationalState link_operstate_from_string(const char *s) _pure_;