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