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