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