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
  36 #include "rtnl-util.h"
  37 #include "hashmap.h"
  38 #include "list.h"
  39 #include "set.h"
  40 #include "condition-util.h"
  41 #include "in-addr-util.h"
  42
  43 #define CACHE_INFO_INFINITY_LIFE_TIME 0xFFFFFFFFU
  44 #define VXLAN_VID_MAX (1u << 24) - 1
  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
  56 typedef struct netdev_enslave_callback netdev_enslave_callback;
  57
  58 struct netdev_enslave_callback {
  59         sd_rtnl_message_handler_t callback;
  60         Link *link;
  61
  62         LIST_FIELDS(netdev_enslave_callback, callbacks);
  63 };
  64
  65 typedef enum MacVlanMode {
  66         NETDEV_MACVLAN_MODE_PRIVATE = MACVLAN_MODE_PRIVATE,
  67         NETDEV_MACVLAN_MODE_VEPA = MACVLAN_MODE_VEPA,
  68         NETDEV_MACVLAN_MODE_BRIDGE = MACVLAN_MODE_BRIDGE,
  69         NETDEV_MACVLAN_MODE_PASSTHRU = MACVLAN_MODE_PASSTHRU,
  70         _NETDEV_MACVLAN_MODE_MAX,
  71         _NETDEV_MACVLAN_MODE_INVALID = -1
  72 } MacVlanMode;
  73
  74 typedef enum BondMode {
  75         NETDEV_BOND_MODE_BALANCE_RR,
  76         NETDEV_BOND_MODE_ACTIVE_BACKUP,
  77         NETDEV_BOND_MODE_BALANCE_XOR,
  78         NETDEV_BOND_MODE_BROADCAST,
  79         NETDEV_BOND_MODE_802_3AD,
  80         NETDEV_BOND_MODE_BALANCE_TLB,
  81         NETDEV_BOND_MODE_BALANCE_ALB,
  82         _NETDEV_BOND_MODE_MAX,
  83         _NETDEV_BOND_MODE_INVALID = -1
  84 } BondMode;
  85
  86 typedef enum NetDevKind {
  87         NETDEV_KIND_BRIDGE,
  88         NETDEV_KIND_BOND,
  89         NETDEV_KIND_VLAN,
  90         NETDEV_KIND_MACVLAN,
  91         NETDEV_KIND_VXLAN,
  92         NETDEV_KIND_IPIP,
  93         NETDEV_KIND_GRE,
  94         NETDEV_KIND_SIT,
  95         NETDEV_KIND_VETH,
  96         NETDEV_KIND_VTI,
  97         NETDEV_KIND_DUMMY,
  98         NETDEV_KIND_TUN,
  99         NETDEV_KIND_TAP,
 100         _NETDEV_KIND_MAX,
 101         _NETDEV_KIND_INVALID = -1
 102 } NetDevKind;
 103
 104 typedef enum NetDevState {
 105         NETDEV_STATE_FAILED,
 106         NETDEV_STATE_CREATING,
 107         NETDEV_STATE_READY,
 108         NETDEV_STATE_LINGER,
 109         _NETDEV_STATE_MAX,
 110         _NETDEV_STATE_INVALID = -1,
 111 } NetDevState;
 112
 113 struct NetDev {
 114         Manager *manager;
 115
 116         int n_ref;
 117
 118         char *filename;
 119
 120         Condition *match_host;
 121         Condition *match_virt;
 122         Condition *match_kernel;
 123         Condition *match_arch;
 124
 125         char *description;
 126         char *ifname;
 127         char *ifname_peer;
 128         char *user_name;
 129         char *group_name;
 130         size_t mtu;
 131         struct ether_addr *mac;
 132         struct ether_addr *mac_peer;
 133         NetDevKind kind;
 134
 135         uint64_t vlanid;
 136         uint64_t vxlanid;
 137         int32_t macvlan_mode;
 138         int32_t bond_mode;
 139
 140         int ifindex;
 141         NetDevState state;
 142
 143         bool tunnel_pmtudisc;
 144         bool learning;
 145         bool one_queue;
 146         bool multi_queue;
 147         bool packet_info;
 148
 149         unsigned ttl;
 150         unsigned tos;
 151         unsigned char family;
 152         union in_addr_union local;
 153         union in_addr_union remote;
 154         union in_addr_union group;
 155
 156         LIST_HEAD(netdev_enslave_callback, callbacks);
 157 };
 158
 159 typedef enum DHCPSupport {
 160         DHCP_SUPPORT_NONE,
 161         DHCP_SUPPORT_BOTH,
 162         DHCP_SUPPORT_V4,
 163         DHCP_SUPPORT_V6,
 164         _DHCP_SUPPORT_MAX,
 165         _DHCP_SUPPORT_INVALID = -1,
 166 } DHCPSupport;
 167
 168 struct Network {
 169         Manager *manager;
 170
 171         char *filename;
 172
 173         struct ether_addr *match_mac;
 174         char *match_path;
 175         char *match_driver;
 176         char *match_type;
 177         char *match_name;
 178         Condition *match_host;
 179         Condition *match_virt;
 180         Condition *match_kernel;
 181         Condition *match_arch;
 182
 183         char *description;
 184         NetDev *bridge;
 185         NetDev *bond;
 186         NetDev *tunnel;
 187         Hashmap *vlans;
 188         Hashmap *macvlans;
 189         Hashmap *vxlans;
 190         DHCPSupport dhcp;
 191         bool dhcp_dns;
 192         bool dhcp_ntp;
 193         bool dhcp_mtu;
 194         bool dhcp_hostname;
 195         bool dhcp_domainname;
 196         bool dhcp_sendhost;
 197         bool dhcp_critical;
 198         bool dhcp_routes;
 199         bool ipv4ll;
 200
 201         bool dhcp_server;
 202
 203         LIST_HEAD(Address, static_addresses);
 204         LIST_HEAD(Route, static_routes);
 205
 206         Hashmap *addresses_by_section;
 207         Hashmap *routes_by_section;
 208
 209         LIST_HEAD(Address, dns);
 210         LIST_HEAD(Address, ntp);
 211
 212         LIST_FIELDS(Network, networks);
 213 };
 214
 215 struct Address {
 216         Network *network;
 217         uint64_t section;
 218
 219         unsigned char family;
 220         unsigned char prefixlen;
 221         unsigned char scope;
 222         char *label;
 223
 224         struct in_addr broadcast;
 225         struct ifa_cacheinfo cinfo;
 226
 227         union in_addr_union in_addr;
 228         union in_addr_union in_addr_peer;
 229
 230         LIST_FIELDS(Address, addresses);
 231 };
 232
 233 struct Route {
 234         Network *network;
 235         uint64_t section;
 236
 237         unsigned char family;
 238         unsigned char dst_prefixlen;
 239         unsigned char scope;
 240         uint32_t metrics;
 241
 242         union in_addr_union in_addr;
 243         union in_addr_union dst_addr;
 244
 245         LIST_FIELDS(Route, routes);
 246 };
 247
 248 typedef enum LinkState {
 249         LINK_STATE_INITIALIZING,
 250         LINK_STATE_ENSLAVING,
 251         LINK_STATE_SETTING_ADDRESSES,
 252         LINK_STATE_SETTING_ROUTES,
 253         LINK_STATE_CONFIGURED,
 254         LINK_STATE_UNMANAGED,
 255         LINK_STATE_FAILED,
 256         LINK_STATE_LINGER,
 257         _LINK_STATE_MAX,
 258         _LINK_STATE_INVALID = -1
 259 } LinkState;
 260
 261 typedef enum LinkOperationalState {
 262         LINK_OPERSTATE_UNKNOWN,
 263         LINK_OPERSTATE_DORMANT,
 264         LINK_OPERSTATE_CARRIER,
 265         LINK_OPERSTATE_DEGRADED,
 266         LINK_OPERSTATE_ROUTABLE,
 267         _LINK_OPERSTATE_MAX,
 268         _LINK_OPERSTATE_INVALID = -1
 269 } LinkOperationalState;
 270
 271 struct Link {
 272         Manager *manager;
 273
 274         int n_ref;
 275
 276         uint64_t ifindex;
 277         char *ifname;
 278         char *state_file;
 279         struct ether_addr mac;
 280         struct udev_device *udev_device;
 281
 282         unsigned flags;
 283         uint8_t kernel_operstate;
 284
 285         Network *network;
 286
 287         LinkState state;
 288         LinkOperationalState operstate;
 289
 290         unsigned addr_messages;
 291         unsigned route_messages;
 292         unsigned enslaving;
 293
 294         LIST_HEAD(Address, addresses);
 295
 296         sd_dhcp_client *dhcp_client;
 297         sd_dhcp_lease *dhcp_lease;
 298         char *lease_file;
 299         uint16_t original_mtu;
 300         sd_ipv4ll *ipv4ll;
 301
 302         LIST_HEAD(Address, pool_addresses);
 303
 304         sd_dhcp_server *dhcp_server;
 305
 306         sd_icmp6_nd *icmp6_router_discovery;
 307         sd_dhcp6_client *dhcp6_client;
 308 };
 309
 310 struct AddressPool {
 311         Manager *manager;
 312
 313         unsigned family;
 314         unsigned prefixlen;
 315
 316         union in_addr_union in_addr;
 317
 318         LIST_FIELDS(AddressPool, address_pools);
 319 };
 320
 321 struct Manager {
 322         sd_rtnl *rtnl;
 323         sd_event *event;
 324         sd_bus *bus;
 325         struct udev *udev;
 326         struct udev_monitor *udev_monitor;
 327         sd_event_source *udev_event_source;
 328         sd_event_source *sigterm_event_source;
 329         sd_event_source *sigint_event_source;
 330
 331         char *state_file;
 332
 333         Hashmap *links;
 334         Hashmap *netdevs;
 335         LIST_HEAD(Network, networks);
 336         LIST_HEAD(AddressPool, address_pools);
 337
 338         usec_t network_dirs_ts_usec;
 339 };
 340
 341 extern const char* const network_dirs[];
 342
 343 /* Manager */
 344
 345 int manager_new(Manager **ret);
 346 void manager_free(Manager *m);
 347
 348 int manager_load_config(Manager *m);
 349 bool manager_should_reload(Manager *m);
 350
 351 int manager_rtnl_enumerate_links(Manager *m);
 352
 353 int manager_rtnl_listen(Manager *m);
 354 int manager_udev_listen(Manager *m);
 355 int manager_bus_listen(Manager *m);
 356
 357 int manager_save(Manager *m);
 358
 359 int manager_address_pool_acquire(Manager *m, unsigned family, unsigned prefixlen, union in_addr_union *found);
 360
 361 DEFINE_TRIVIAL_CLEANUP_FUNC(Manager*, manager_free);
 362 #define _cleanup_manager_free_ _cleanup_(manager_freep)
 363
 364 /* NetDev */
 365
 366 #define VLANID_MAX 4094
 367
 368 int netdev_load(Manager *manager);
 369 void netdev_drop(NetDev *netdev);
 370
 371 NetDev *netdev_unref(NetDev *netdev);
 372 NetDev *netdev_ref(NetDev *netdev);
 373
 374 DEFINE_TRIVIAL_CLEANUP_FUNC(NetDev*, netdev_unref);
 375 #define _cleanup_netdev_unref_ _cleanup_(netdev_unrefp)
 376
 377 int netdev_get(Manager *manager, const char *name, NetDev **ret);
 378 int netdev_set_ifindex(NetDev *netdev, sd_rtnl_message *newlink);
 379 int netdev_enslave(NetDev *netdev, Link *link, sd_rtnl_message_handler_t cb);
 380 int netdev_create_tunnel(NetDev *netdev, Link *link, sd_rtnl_message_handler_t callback);
 381 int netdev_create_veth(NetDev *netdev, sd_rtnl_message_handler_t callback);
 382 int netdev_create_vxlan(NetDev *netdev, Link *link, sd_rtnl_message_handler_t callback);
 383 int netdev_create_vlan(NetDev *netdev, Link *link, sd_rtnl_message_handler_t callback);
 384 int netdev_create_macvlan(NetDev *netdev, Link *link, sd_rtnl_message_handler_t callback);
 385 int netdev_create_dummy(NetDev *netdev, sd_rtnl_message_handler_t callback);
 386 int netdev_create_tuntap(NetDev *netdev);
 387 int netdev_create_bond(NetDev *netdev, sd_rtnl_message_handler_t callback);
 388
 389
 390 const char *netdev_kind_to_string(NetDevKind d) _const_;
 391 NetDevKind netdev_kind_from_string(const char *d) _pure_;
 392
 393 const char *macvlan_mode_to_string(MacVlanMode d) _const_;
 394 MacVlanMode macvlan_mode_from_string(const char *d) _pure_;
 395
 396 const char *bond_mode_to_string(BondMode d) _const_;
 397 BondMode bond_mode_from_string(const char *d) _pure_;
 398
 399 int config_parse_netdev_kind(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);
 400
 401 int config_parse_macvlan_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);
 402
 403 int config_parse_bond_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);
 404
 405 /* gperf */
 406 const struct ConfigPerfItem* network_netdev_gperf_lookup(const char *key, unsigned length);
 407
 408 /* Network */
 409
 410 int network_load(Manager *manager);
 411
 412 void network_free(Network *network);
 413
 414 DEFINE_TRIVIAL_CLEANUP_FUNC(Network*, network_free);
 415 #define _cleanup_network_free_ _cleanup_(network_freep)
 416
 417 int network_get(Manager *manager, struct udev_device *device,
 418                 const char *ifname, const struct ether_addr *mac,
 419                 Network **ret);
 420 int network_apply(Manager *manager, Network *network, Link *link);
 421
 422 int config_parse_netdev(const char *unit, const char *filename, unsigned line,
 423                         const char *section, unsigned section_line, const char *lvalue,
 424                         int ltype, const char *rvalue, void *data, void *userdata);
 425
 426 int config_parse_tunnel(const char *unit,
 427                         const char *filename,
 428                         unsigned line,
 429                         const char *section,
 430                         unsigned section_line,
 431                         const char *lvalue,
 432                         int ltype,
 433                         const char *rvalue,
 434                         void *data,
 435                         void *userdata);
 436
 437 int config_parse_tunnel_address(const char *unit,
 438                                 const char *filename,
 439                                 unsigned line,
 440                                 const char *section,
 441                                 unsigned section_line,
 442                                 const char *lvalue,
 443                                 int ltype,
 444                                 const char *rvalue,
 445                                 void *data,
 446                                 void *userdata);
 447
 448 /* gperf */
 449 const struct ConfigPerfItem* network_network_gperf_lookup(const char *key, unsigned length);
 450
 451 /* Route */
 452 int route_new_static(Network *network, unsigned section, Route **ret);
 453 int route_new_dynamic(Route **ret);
 454 void route_free(Route *route);
 455 int route_configure(Route *route, Link *link, sd_rtnl_message_handler_t callback);
 456 int route_drop(Route *route, Link *link, sd_rtnl_message_handler_t callback);
 457
 458
 459 DEFINE_TRIVIAL_CLEANUP_FUNC(Route*, route_free);
 460 #define _cleanup_route_free_ _cleanup_(route_freep)
 461
 462 int config_parse_gateway(const char *unit, const char *filename, unsigned line,
 463                          const char *section, unsigned section_line, const char *lvalue,
 464                          int ltype, const char *rvalue, void *data, void *userdata);
 465
 466 int config_parse_destination(const char *unit, const char *filename, unsigned line,
 467                              const char *section, unsigned section_line, const char *lvalue,
 468                              int ltype, const char *rvalue, void *data, void *userdata);
 469
 470 int config_parse_route_priority(const char *unit, const char *filename, unsigned line,
 471                                 const char *section, unsigned section_line, const char *lvalue,
 472                                 int ltype, const char *rvalue, void *data, void *userdata);
 473 /* Address */
 474 int address_new_static(Network *network, unsigned section, Address **ret);
 475 int address_new_dynamic(Address **ret);
 476 void address_free(Address *address);
 477 int address_configure(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 478 int address_update(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 479 int address_drop(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 480 bool address_equal(Address *a1, Address *a2);
 481
 482 DEFINE_TRIVIAL_CLEANUP_FUNC(Address*, address_free);
 483 #define _cleanup_address_free_ _cleanup_(address_freep)
 484
 485 int config_parse_dns(const char *unit, const char *filename, unsigned line,
 486                      const char *section, unsigned section_line, const char *lvalue,
 487                      int ltype, const char *rvalue, void *data, void *userdata);
 488
 489 int config_parse_address(const char *unit, const char *filename, unsigned line,
 490                          const char *section, unsigned section_line, const char *lvalue,
 491                          int ltype, const char *rvalue, void *data, void *userdata);
 492
 493 int config_parse_broadcast(const char *unit, const char *filename, unsigned line,
 494                            const char *section, unsigned section_line, const char *lvalue,
 495                            int ltype, const char *rvalue, void *data, void *userdata);
 496
 497 int config_parse_label(const char *unit, const char *filename, unsigned line,
 498                        const char *section, unsigned section_line, const char *lvalue,
 499                        int ltype, const char *rvalue, void *data, void *userdata);
 500
 501 /* Link */
 502
 503 Link *link_unref(Link *link);
 504 Link *link_ref(Link *link);
 505 int link_get(Manager *m, int ifindex, Link **ret);
 506 int link_add(Manager *manager, sd_rtnl_message *message, Link **ret);
 507 void link_drop(Link *link);
 508
 509 int link_update(Link *link, sd_rtnl_message *message);
 510 int link_rtnl_process_address(sd_rtnl *rtnl, sd_rtnl_message *message, void *userdata);
 511
 512 int link_initialized(Link *link, struct udev_device *device);
 513
 514 int link_save(Link *link);
 515
 516 bool link_has_carrier(unsigned flags, uint8_t operstate);
 517
 518 const char* link_state_to_string(LinkState s) _const_;
 519 LinkState link_state_from_string(const char *s) _pure_;
 520
 521 const char* link_operstate_to_string(LinkOperationalState s) _const_;
 522 LinkOperationalState link_operstate_from_string(const char *s) _pure_;
 523
 524 DEFINE_TRIVIAL_CLEANUP_FUNC(Link*, link_unref);
 525 #define _cleanup_link_unref_ _cleanup_(link_unrefp)
 526
 527 /* DHCP support */
 528
 529 const char* dhcp_support_to_string(DHCPSupport i) _const_;
 530 DHCPSupport dhcp_support_from_string(const char *s) _pure_;
 531
 532 int config_parse_dhcp(const char *unit, const char *filename, unsigned line,
 533                       const char *section, unsigned section_line, const char *lvalue,
 534                       int ltype, const char *rvalue, void *data, void *userdata);
 535
 536 /* Address Pool */
 537
 538 int address_pool_new(Manager *m, AddressPool **ret, unsigned family, const union in_addr_union *u, unsigned prefixlen);
 539 int address_pool_new_from_string(Manager *m, AddressPool **ret, unsigned family, const char *p, unsigned prefixlen);
 540 void address_pool_free(AddressPool *p);
 541
 542 int address_pool_acquire(AddressPool *p, unsigned prefixlen, union in_addr_union *found);
 543
 544 /* Macros which append INTERFACE= to the message */
 545
 546 #define log_full_link(level, link, fmt, ...) log_meta_object(level, __FILE__, __LINE__, __func__, "INTERFACE=", link->ifname, "%-*s: " fmt, IFNAMSIZ, link->ifname, ##__VA_ARGS__)
 547 #define log_debug_link(link, ...)       log_full_link(LOG_DEBUG, link, ##__VA_ARGS__)
 548 #define log_info_link(link, ...)        log_full_link(LOG_INFO, link, ##__VA_ARGS__)
 549 #define log_notice_link(link, ...)      log_full_link(LOG_NOTICE, link, ##__VA_ARGS__)
 550 #define log_warning_link(link, ...)     log_full_link(LOG_WARNING, link, ##__VA_ARGS__)
 551 #define log_error_link(link, ...)       log_full_link(LOG_ERR, link, ##__VA_ARGS__)
 552
 553 #define log_struct_link(level, link, ...) log_struct(level, "INTERFACE=%s", link->ifname, __VA_ARGS__)
 554
 555 /* More macros which append INTERFACE= to the message */
 556
 557 #define log_full_netdev(level, netdev, fmt, ...) log_meta_object(level, __FILE__, __LINE__, __func__, "INTERFACE=", netdev->ifname, "%-*s: " fmt, IFNAMSIZ, netdev->ifname, ##__VA_ARGS__)
 558 #define log_debug_netdev(netdev, ...)       log_full_netdev(LOG_DEBUG, netdev, ##__VA_ARGS__)
 559 #define log_info_netdev(netdev, ...)        log_full_netdev(LOG_INFO, netdev, ##__VA_ARGS__)
 560 #define log_notice_netdev(netdev, ...)      log_full_netdev(LOG_NOTICE, netdev, ##__VA_ARGS__)
 561 #define log_warning_netdev(netdev, ...)     log_full_netdev(LOG_WARNING, netdev,## __VA_ARGS__)
 562 #define log_error_netdev(netdev, ...)       log_full_netdev(LOG_ERR, netdev, ##__VA_ARGS__)
 563
 564 #define log_struct_netdev(level, netdev, ...) log_struct(level, "INTERFACE=%s", netdev->ifname, __VA_ARGS__)
 565
 566 #define NETDEV(netdev) "INTERFACE=%s", netdev->ifname
 567 #define ADDRESS_FMT_VAL(address)            \
 568         (address).s_addr & 0xFF,            \
 569         ((address).s_addr >> 8) & 0xFF,     \
 570         ((address).s_addr >> 16) & 0xFF,    \
 571         (address).s_addr >> 24