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