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