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_MAX,
  72         _NETDEV_KIND_INVALID = -1
  73 } NetDevKind;
  74
  75 typedef enum NetDevState {
  76         NETDEV_STATE_FAILED,
  77         NETDEV_STATE_CREATING,
  78         NETDEV_STATE_READY,
  79         _NETDEV_STATE_MAX,
  80         _NETDEV_STATE_INVALID = -1,
  81 } NetDevState;
  82
  83 struct NetDev {
  84         Manager *manager;
  85
  86         int n_ref;
  87
  88         char *filename;
  89
  90         Condition *match_host;
  91         Condition *match_virt;
  92         Condition *match_kernel;
  93         Condition *match_arch;
  94
  95         char *description;
  96         char *name;
  97         NetDevKind kind;
  98
  99         uint64_t vlanid;
 100         int32_t macvlan_mode;
 101
 102         int ifindex;
 103         NetDevState state;
 104
 105         LIST_HEAD(netdev_enslave_callback, callbacks);
 106 };
 107
 108 struct Network {
 109         Manager *manager;
 110
 111         char *filename;
 112
 113         struct ether_addr *match_mac;
 114         char *match_path;
 115         char *match_driver;
 116         char *match_type;
 117         char *match_name;
 118         Condition *match_host;
 119         Condition *match_virt;
 120         Condition *match_kernel;
 121         Condition *match_arch;
 122
 123         char *description;
 124         NetDev *bridge;
 125         NetDev *bond;
 126         Hashmap *vlans;
 127         Hashmap *macvlans;
 128         bool dhcp;
 129         bool dhcp_dns;
 130         bool dhcp_mtu;
 131         bool dhcp_hostname;
 132         bool dhcp_domainname;
 133         bool dhcp_critical;
 134         bool ipv4ll;
 135
 136         LIST_HEAD(Address, static_addresses);
 137         LIST_HEAD(Route, static_routes);
 138
 139         Hashmap *addresses_by_section;
 140         Hashmap *routes_by_section;
 141
 142         Set *dns;
 143
 144         LIST_FIELDS(Network, networks);
 145 };
 146
 147 struct Address {
 148         Network *network;
 149         uint64_t section;
 150
 151         unsigned char family;
 152         unsigned char prefixlen;
 153         unsigned char scope;
 154         char *label;
 155
 156         struct in_addr broadcast;
 157         struct ifa_cacheinfo cinfo;
 158
 159         union {
 160                 struct in_addr in;
 161                 struct in6_addr in6;
 162         } in_addr;
 163
 164         LIST_FIELDS(Address, static_addresses);
 165 };
 166
 167 struct Route {
 168         Network *network;
 169         uint64_t section;
 170
 171         unsigned char family;
 172         unsigned char dst_prefixlen;
 173         unsigned char scope;
 174         uint32_t metrics;
 175
 176         union {
 177                 struct in_addr in;
 178                 struct in6_addr in6;
 179         } in_addr;
 180
 181         union {
 182                 struct in_addr in;
 183                 struct in6_addr in6;
 184         } dst_addr;
 185
 186         LIST_FIELDS(Route, static_routes);
 187 };
 188
 189 typedef enum LinkState {
 190         LINK_STATE_INITIALIZING,
 191         LINK_STATE_ENSLAVING,
 192         LINK_STATE_SETTING_ADDRESSES,
 193         LINK_STATE_SETTING_ROUTES,
 194         LINK_STATE_CONFIGURED,
 195         LINK_STATE_UNMANAGED,
 196         LINK_STATE_FAILED,
 197         _LINK_STATE_MAX,
 198         _LINK_STATE_INVALID = -1
 199 } LinkState;
 200
 201 struct Link {
 202         Manager *manager;
 203
 204         int n_ref;
 205
 206         uint64_t ifindex;
 207         char *ifname;
 208         char *state_file;
 209         struct ether_addr mac;
 210         struct udev_device *udev_device;
 211
 212         unsigned flags;
 213         uint8_t operstate;
 214
 215         Network *network;
 216
 217         LinkState state;
 218
 219         unsigned addr_messages;
 220         unsigned route_messages;
 221         unsigned enslaving;
 222
 223         sd_dhcp_client *dhcp_client;
 224         sd_dhcp_lease *dhcp_lease;
 225         char *lease_file;
 226         uint16_t original_mtu;
 227         sd_ipv4ll *ipv4ll;
 228 };
 229
 230 struct Manager {
 231         sd_rtnl *rtnl;
 232         sd_event *event;
 233         sd_bus *bus;
 234         struct udev *udev;
 235         struct udev_monitor *udev_monitor;
 236         sd_event_source *udev_event_source;
 237         sd_event_source *sigterm_event_source;
 238         sd_event_source *sigint_event_source;
 239
 240         char *state_file;
 241
 242         Hashmap *links;
 243         Hashmap *netdevs;
 244         LIST_HEAD(Network, networks);
 245
 246         usec_t network_dirs_ts_usec;
 247 };
 248
 249 extern const char* const network_dirs[];
 250
 251 /* Manager */
 252
 253 int manager_new(Manager **ret);
 254 void manager_free(Manager *m);
 255
 256 int manager_load_config(Manager *m);
 257 bool manager_should_reload(Manager *m);
 258
 259 int manager_rtnl_enumerate_links(Manager *m);
 260
 261 int manager_rtnl_listen(Manager *m);
 262 int manager_udev_listen(Manager *m);
 263 int manager_bus_listen(Manager *m);
 264
 265 int manager_update_resolv_conf(Manager *m);
 266 int manager_save(Manager *m);
 267
 268 DEFINE_TRIVIAL_CLEANUP_FUNC(Manager*, manager_free);
 269 #define _cleanup_manager_free_ _cleanup_(manager_freep)
 270
 271 /* NetDev */
 272
 273 int netdev_load(Manager *manager);
 274
 275 NetDev *netdev_unref(NetDev *netdev);
 276 NetDev *netdev_ref(NetDev *netdev);
 277
 278 DEFINE_TRIVIAL_CLEANUP_FUNC(NetDev*, netdev_unref);
 279 #define _cleanup_netdev_unref_ _cleanup_(netdev_unrefp)
 280
 281 int netdev_get(Manager *manager, const char *name, NetDev **ret);
 282 int netdev_set_ifindex(NetDev *netdev, sd_rtnl_message *newlink);
 283 int netdev_enslave(NetDev *netdev, Link *link, sd_rtnl_message_handler_t cb);
 284
 285 const char *netdev_kind_to_string(NetDevKind d) _const_;
 286 NetDevKind netdev_kind_from_string(const char *d) _pure_;
 287
 288 const char *macvlan_mode_to_string(MacVlanMode d) _const_;
 289 MacVlanMode macvlan_mode_from_string(const char *d) _pure_;
 290
 291 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);
 292
 293 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);
 294
 295 /* gperf */
 296 const struct ConfigPerfItem* network_netdev_gperf_lookup(const char *key, unsigned length);
 297
 298 /* Network */
 299
 300 int network_load(Manager *manager);
 301
 302 void network_free(Network *network);
 303
 304 DEFINE_TRIVIAL_CLEANUP_FUNC(Network*, network_free);
 305 #define _cleanup_network_free_ _cleanup_(network_freep)
 306
 307 int network_get(Manager *manager, struct udev_device *device,
 308                 const char *ifname, const struct ether_addr *mac,
 309                 Network **ret);
 310 int network_apply(Manager *manager, Network *network, Link *link);
 311
 312 int config_parse_netdev(const char *unit, const char *filename, unsigned line,
 313                         const char *section, unsigned section_line, const char *lvalue,
 314                         int ltype, const char *rvalue, void *data, void *userdata);
 315
 316 /* gperf */
 317 const struct ConfigPerfItem* network_network_gperf_lookup(const char *key, unsigned length);
 318
 319 /* Route */
 320 int route_new_static(Network *network, unsigned section, Route **ret);
 321 int route_new_dynamic(Route **ret);
 322 void route_free(Route *route);
 323 int route_configure(Route *route, Link *link, sd_rtnl_message_handler_t callback);
 324 int route_drop(Route *route, Link *link, sd_rtnl_message_handler_t callback);
 325
 326
 327 DEFINE_TRIVIAL_CLEANUP_FUNC(Route*, route_free);
 328 #define _cleanup_route_free_ _cleanup_(route_freep)
 329
 330 int config_parse_gateway(const char *unit, const char *filename, unsigned line,
 331                          const char *section, unsigned section_line, const char *lvalue,
 332                          int ltype, const char *rvalue, void *data, void *userdata);
 333
 334 int config_parse_destination(const char *unit, const char *filename, unsigned line,
 335                              const char *section, unsigned section_line, const char *lvalue,
 336                              int ltype, const char *rvalue, void *data, void *userdata);
 337
 338 /* Address */
 339 int address_new_static(Network *network, unsigned section, Address **ret);
 340 int address_new_dynamic(Address **ret);
 341 void address_free(Address *address);
 342 int address_configure(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 343 int address_update(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 344 int address_drop(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 345
 346 DEFINE_TRIVIAL_CLEANUP_FUNC(Address*, address_free);
 347 #define _cleanup_address_free_ _cleanup_(address_freep)
 348
 349 int config_parse_dns(const char *unit, const char *filename, unsigned line,
 350                      const char *section, unsigned section_line, const char *lvalue,
 351                      int ltype, const char *rvalue, void *data, void *userdata);
 352
 353 int config_parse_address(const char *unit, const char *filename, unsigned line,
 354                          const char *section, unsigned section_line, const char *lvalue,
 355                          int ltype, const char *rvalue, void *data, void *userdata);
 356
 357 int config_parse_broadcast(const char *unit, const char *filename, unsigned line,
 358                            const char *section, unsigned section_line, const char *lvalue,
 359                            int ltype, const char *rvalue, void *data, void *userdata);
 360
 361 int config_parse_label(const char *unit, const char *filename, unsigned line,
 362                        const char *section, unsigned section_line, const char *lvalue,
 363                        int ltype, const char *rvalue, void *data, void *userdata);
 364
 365 /* Link */
 366
 367 Link *link_unref(Link *link);
 368 Link *link_ref(Link *link);
 369 int link_get(Manager *m, int ifindex, Link **ret);
 370 int link_add(Manager *manager, sd_rtnl_message *message, Link **ret);
 371
 372 int link_update(Link *link, sd_rtnl_message *message);
 373
 374 int link_initialized(Link *link, struct udev_device *device);
 375
 376 int link_save(Link *link);
 377
 378 bool link_has_carrier(unsigned flags, uint8_t operstate);
 379
 380 const char* link_state_to_string(LinkState s) _const_;
 381 LinkState link_state_from_string(const char *s) _pure_;
 382
 383 DEFINE_TRIVIAL_CLEANUP_FUNC(Link*, link_unref);
 384 #define _cleanup_link_unref_ _cleanup_(link_unrefp)
 385
 386 /* Macros which append INTERFACE= to the message */
 387
 388 #define log_full_link(level, link, fmt, ...) log_meta_object(level, __FILE__, __LINE__, __func__, "INTERFACE=", link->ifname, "%s: " fmt, link->ifname, ##__VA_ARGS__)
 389 #define log_debug_link(link, ...)       log_full_link(LOG_DEBUG, link, ##__VA_ARGS__)
 390 #define log_info_link(link, ...)        log_full_link(LOG_INFO, link, ##__VA_ARGS__)
 391 #define log_notice_link(link, ...)      log_full_link(LOG_NOTICE, link, ##__VA_ARGS__)
 392 #define log_warning_link(link, ...)     log_full_link(LOG_WARNING, link, ##__VA_ARGS__)
 393 #define log_error_link(link, ...)       log_full_link(LOG_ERR, link, ##__VA_ARGS__)
 394
 395 #define log_struct_link(level, link, ...) log_struct(level, "INTERFACE=%s", link->ifname, __VA_ARGS__)
 396
 397 /* More macros which append INTERFACE= to the message */
 398
 399 #define log_full_netdev(level, netdev, fmt, ...) log_meta_object(level, __FILE__, __LINE__, __func__, "INTERFACE=", netdev->name, "%s: " fmt, netdev->name, ##__VA_ARGS__)
 400 #define log_debug_netdev(netdev, ...)       log_full_netdev(LOG_DEBUG, netdev, ##__VA_ARGS__)
 401 #define log_info_netdev(netdev, ...)        log_full_netdev(LOG_INFO, netdev, ##__VA_ARGS__)
 402 #define log_notice_netdev(netdev, ...)      log_full_netdev(LOG_NOTICE, netdev, ##__VA_ARGS__)
 403 #define log_warning_netdev(netdev, ...)     log_full_netdev(LOG_WARNING, netdev,## __VA_ARGS__)
 404 #define log_error_netdev(netdev, ...)       log_full_netdev(LOG_ERR, netdev, ##__VA_ARGS__)
 405
 406 #define log_struct_netdev(level, netdev, ...) log_struct(level, "INTERFACE=%s", netdev->name, __VA_ARGS__)
 407
 408 #define NETDEV(netdev) "INTERFACE=%s", netdev->name
 409 #define ADDRESS_FMT_VAL(address)            \
 410         (address).s_addr & 0xFF,            \
 411         ((address).s_addr >> 8) & 0xFF,     \
 412         ((address).s_addr >> 16) & 0xFF,    \
 413         (address).s_addr >> 24