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