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_MAX,
  76         _NETDEV_KIND_INVALID = -1
  77 } NetDevKind;
  78
  79 typedef enum NetDevState {
  80         NETDEV_STATE_FAILED,
  81         NETDEV_STATE_CREATING,
  82         NETDEV_STATE_READY,
  83         NETDEV_STATE_LINGER,
  84         _NETDEV_STATE_MAX,
  85         _NETDEV_STATE_INVALID = -1,
  86 } NetDevState;
  87
  88 struct NetDev {
  89         Manager *manager;
  90
  91         int n_ref;
  92
  93         char *filename;
  94
  95         Condition *match_host;
  96         Condition *match_virt;
  97         Condition *match_kernel;
  98         Condition *match_arch;
  99
 100         char *description;
 101         char *ifname;
 102         char *ifname_peer;
 103         size_t mtu;
 104         NetDevKind kind;
 105
 106         uint64_t vlanid;
 107         int32_t macvlan_mode;
 108
 109         int ifindex;
 110         NetDevState state;
 111
 112         bool tunnel_pmtudisc;
 113         unsigned tunnel_ttl;
 114         unsigned tunnel_tos;
 115         struct in_addr tunnel_local;
 116         struct in_addr tunnel_remote;
 117
 118         LIST_HEAD(netdev_enslave_callback, callbacks);
 119 };
 120
 121 struct Network {
 122         Manager *manager;
 123
 124         char *filename;
 125
 126         struct ether_addr *match_mac;
 127         char *match_path;
 128         char *match_driver;
 129         char *match_type;
 130         char *match_name;
 131         Condition *match_host;
 132         Condition *match_virt;
 133         Condition *match_kernel;
 134         Condition *match_arch;
 135
 136         char *description;
 137         NetDev *bridge;
 138         NetDev *bond;
 139         NetDev *tunnel;
 140         Hashmap *vlans;
 141         Hashmap *macvlans;
 142         bool dhcp;
 143         bool dhcp_dns;
 144         bool dhcp_ntp;
 145         bool dhcp_mtu;
 146         bool dhcp_hostname;
 147         bool dhcp_domainname;
 148         bool dhcp_critical;
 149         bool ipv4ll;
 150
 151         LIST_HEAD(Address, static_addresses);
 152         LIST_HEAD(Route, static_routes);
 153
 154         Hashmap *addresses_by_section;
 155         Hashmap *routes_by_section;
 156
 157         LIST_HEAD(Address, dns);
 158         LIST_HEAD(Address, ntp);
 159
 160         LIST_FIELDS(Network, networks);
 161 };
 162
 163 struct Address {
 164         Network *network;
 165         uint64_t section;
 166
 167         unsigned char family;
 168         unsigned char prefixlen;
 169         unsigned char scope;
 170         char *label;
 171
 172         struct in_addr broadcast;
 173         struct ifa_cacheinfo cinfo;
 174
 175         union {
 176                 struct in_addr in;
 177                 struct in6_addr in6;
 178         } in_addr;
 179
 180         LIST_FIELDS(Address, addresses);
 181 };
 182
 183 struct Route {
 184         Network *network;
 185         uint64_t section;
 186
 187         unsigned char family;
 188         unsigned char dst_prefixlen;
 189         unsigned char scope;
 190         uint32_t metrics;
 191
 192         union {
 193                 struct in_addr in;
 194                 struct in6_addr in6;
 195         } in_addr;
 196
 197         union {
 198                 struct in_addr in;
 199                 struct in6_addr in6;
 200         } dst_addr;
 201
 202         LIST_FIELDS(Route, routes);
 203 };
 204
 205 typedef enum LinkState {
 206         LINK_STATE_INITIALIZING,
 207         LINK_STATE_ENSLAVING,
 208         LINK_STATE_SETTING_ADDRESSES,
 209         LINK_STATE_SETTING_ROUTES,
 210         LINK_STATE_CONFIGURED,
 211         LINK_STATE_UNMANAGED,
 212         LINK_STATE_FAILED,
 213         LINK_STATE_LINGER,
 214         _LINK_STATE_MAX,
 215         _LINK_STATE_INVALID = -1
 216 } LinkState;
 217
 218 typedef enum LinkOperationalState {
 219         LINK_OPERSTATE_UNKNOWN,
 220         LINK_OPERSTATE_DORMANT,
 221         LINK_OPERSTATE_CARRIER,
 222         LINK_OPERSTATE_DEGRADED,
 223         LINK_OPERSTATE_ROUTABLE,
 224         _LINK_OPERSTATE_MAX,
 225         _LINK_OPERSTATE_INVALID = -1
 226 } LinkOperationalState;
 227
 228 struct Link {
 229         Manager *manager;
 230
 231         int n_ref;
 232
 233         uint64_t ifindex;
 234         char *ifname;
 235         char *state_file;
 236         struct ether_addr mac;
 237         struct udev_device *udev_device;
 238
 239         unsigned flags;
 240         uint8_t kernel_operstate;
 241
 242         Network *network;
 243
 244         LinkState state;
 245         LinkOperationalState operstate;
 246
 247         unsigned addr_messages;
 248         unsigned route_messages;
 249         unsigned enslaving;
 250
 251         LIST_HEAD(Address, addresses);
 252
 253         sd_dhcp_client *dhcp_client;
 254         sd_dhcp_lease *dhcp_lease;
 255         char *lease_file;
 256         uint16_t original_mtu;
 257         sd_ipv4ll *ipv4ll;
 258 };
 259
 260 struct Manager {
 261         sd_rtnl *rtnl;
 262         sd_event *event;
 263         sd_bus *bus;
 264         struct udev *udev;
 265         struct udev_monitor *udev_monitor;
 266         sd_event_source *udev_event_source;
 267         sd_event_source *sigterm_event_source;
 268         sd_event_source *sigint_event_source;
 269
 270         char *state_file;
 271
 272         Hashmap *links;
 273         Hashmap *netdevs;
 274         LIST_HEAD(Network, networks);
 275
 276         usec_t network_dirs_ts_usec;
 277         struct kmod_ctx *kmod_ctx;
 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