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