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 "sd-icmp6-nd.h"
  33 #include "sd-dhcp6-client.h"
  34 #include "udev.h"
  35 #include "sd-lldp.h"
  36
  37 #include "rtnl-util.h"
  38 #include "hashmap.h"
  39 #include "list.h"
  40 #include "set.h"
  41 #include "condition.h"
  42 #include "in-addr-util.h"
  43
  44 #define CACHE_INFO_INFINITY_LIFE_TIME 0xFFFFFFFFU
  45 #define DHCP_ROUTE_METRIC 1024
  46 #define IPV4LL_ROUTE_METRIC 2048
  47
  48 typedef struct NetDev NetDev;
  49 typedef struct Network Network;
  50 typedef struct Link Link;
  51 typedef struct Address Address;
  52 typedef struct Route Route;
  53 typedef struct Manager Manager;
  54 typedef struct AddressPool AddressPool;
  55 typedef struct FdbEntry FdbEntry;
  56
  57 typedef enum AddressFamilyBoolean {
  58         /* This is a bitmask, though it usually doesn't feel that way! */
  59         ADDRESS_FAMILY_NO = 0,
  60         ADDRESS_FAMILY_IPV4 = 1,
  61         ADDRESS_FAMILY_IPV6 = 2,
  62         ADDRESS_FAMILY_YES = 3,
  63         _ADDRESS_FAMILY_BOOLEAN_MAX,
  64         _ADDRESS_FAMILY_BOOLEAN_INVALID = -1,
  65 } AddressFamilyBoolean;
  66
  67 typedef enum LLMNRSupport {
  68         LLMNR_SUPPORT_NO,
  69         LLMNR_SUPPORT_YES,
  70         LLMNR_SUPPORT_RESOLVE,
  71         _LLMNR_SUPPORT_MAX,
  72         _LLMNR_SUPPORT_INVALID = -1,
  73 } LLMNRSupport;
  74
  75 typedef enum LinkOperationalState {
  76         LINK_OPERSTATE_OFF,
  77         LINK_OPERSTATE_NO_CARRIER,
  78         LINK_OPERSTATE_DORMANT,
  79         LINK_OPERSTATE_CARRIER,
  80         LINK_OPERSTATE_DEGRADED,
  81         LINK_OPERSTATE_ROUTABLE,
  82         _LINK_OPERSTATE_MAX,
  83         _LINK_OPERSTATE_INVALID = -1
  84 } LinkOperationalState;
  85
  86 struct FdbEntry {
  87         Network *network;
  88         unsigned section;
  89
  90         struct ether_addr *mac_addr;
  91         uint16_t vlan_id;
  92
  93         LIST_FIELDS(FdbEntry, static_fdb_entries);
  94 };
  95
  96 struct Network {
  97         Manager *manager;
  98
  99         char *filename;
 100
 101         struct ether_addr *match_mac;
 102         char *match_path;
 103         char *match_driver;
 104         char *match_type;
 105         char *match_name;
 106         char *dhcp_vendor_class_identifier;
 107
 108         Condition *match_host;
 109         Condition *match_virt;
 110         Condition *match_kernel;
 111         Condition *match_arch;
 112
 113         char *description;
 114         NetDev *bridge;
 115         NetDev *bond;
 116         Hashmap *stacked_netdevs;
 117         AddressFamilyBoolean dhcp;
 118         bool dhcp_dns;
 119         bool dhcp_ntp;
 120         bool dhcp_mtu;
 121         bool dhcp_hostname;
 122         bool dhcp_domains;
 123         bool dhcp_sendhost;
 124         bool dhcp_broadcast;
 125         bool dhcp_critical;
 126         bool dhcp_routes;
 127         unsigned dhcp_route_metric;
 128         bool ipv4ll;
 129         bool ipv4ll_route;
 130
 131         bool dhcp_server;
 132
 133         unsigned cost;
 134
 135         AddressFamilyBoolean ip_forward;
 136         bool ip_masquerade;
 137
 138         struct ether_addr *mac;
 139         unsigned mtu;
 140
 141         bool lldp;
 142
 143         LIST_HEAD(Address, static_addresses);
 144         LIST_HEAD(Route, static_routes);
 145         LIST_HEAD(FdbEntry, static_fdb_entries);
 146
 147         Hashmap *addresses_by_section;
 148         Hashmap *routes_by_section;
 149         Hashmap *fdb_entries_by_section;
 150
 151         bool wildcard_domain;
 152         char **domains, **dns, **ntp;
 153
 154         LLMNRSupport llmnr;
 155
 156         LIST_FIELDS(Network, networks);
 157 };
 158
 159 struct Address {
 160         Network *network;
 161         unsigned section;
 162
 163         int family;
 164         unsigned char prefixlen;
 165         unsigned char scope;
 166         unsigned char flags;
 167         char *label;
 168
 169         struct in_addr broadcast;
 170         struct ifa_cacheinfo cinfo;
 171
 172         union in_addr_union in_addr;
 173         union in_addr_union in_addr_peer;
 174
 175         bool ip_masquerade_done;
 176
 177         LIST_FIELDS(Address, addresses);
 178 };
 179
 180 struct Route {
 181         Network *network;
 182         unsigned section;
 183
 184         int family;
 185         unsigned char dst_prefixlen;
 186         unsigned char src_prefixlen;
 187         unsigned char scope;
 188         uint32_t metrics;
 189         unsigned char protocol;  /* RTPROT_* */
 190
 191         union in_addr_union in_addr;
 192         union in_addr_union dst_addr;
 193         union in_addr_union src_addr;
 194         union in_addr_union prefsrc_addr;
 195
 196         LIST_FIELDS(Route, routes);
 197 };
 198
 199 struct AddressPool {
 200         Manager *manager;
 201
 202         int family;
 203         unsigned prefixlen;
 204
 205         union in_addr_union in_addr;
 206
 207         LIST_FIELDS(AddressPool, address_pools);
 208 };
 209
 210 struct Manager {
 211         sd_rtnl *rtnl;
 212         sd_event *event;
 213         sd_event_source *bus_retry_event_source;
 214         sd_bus *bus;
 215         sd_bus_slot *prepare_for_sleep_slot;
 216         struct udev *udev;
 217         struct udev_monitor *udev_monitor;
 218         sd_event_source *udev_event_source;
 219
 220         bool enumerating;
 221
 222         char *state_file;
 223         LinkOperationalState operational_state;
 224
 225         Hashmap *links;
 226         Hashmap *netdevs;
 227         LIST_HEAD(Network, networks);
 228         LIST_HEAD(AddressPool, address_pools);
 229
 230         usec_t network_dirs_ts_usec;
 231 };
 232
 233 extern const char* const network_dirs[];
 234
 235 /* Manager */
 236
 237 extern const sd_bus_vtable manager_vtable[];
 238
 239 int manager_new(Manager **ret);
 240 void manager_free(Manager *m);
 241
 242 int manager_run(Manager *m);
 243
 244 int manager_load_config(Manager *m);
 245 bool manager_should_reload(Manager *m);
 246
 247 int manager_rtnl_enumerate_links(Manager *m);
 248 int manager_rtnl_enumerate_addresses(Manager *m);
 249
 250 int manager_send_changed(Manager *m, const char *property, ...) _sentinel_;
 251 int manager_save(Manager *m);
 252
 253 int manager_address_pool_acquire(Manager *m, int family, unsigned prefixlen, union in_addr_union *found);
 254
 255 DEFINE_TRIVIAL_CLEANUP_FUNC(Manager*, manager_free);
 256 #define _cleanup_manager_free_ _cleanup_(manager_freep)
 257
 258 /* Network */
 259
 260 int network_load(Manager *manager);
 261
 262 void network_free(Network *network);
 263
 264 DEFINE_TRIVIAL_CLEANUP_FUNC(Network*, network_free);
 265 #define _cleanup_network_free_ _cleanup_(network_freep)
 266
 267 int network_get(Manager *manager, struct udev_device *device,
 268                 const char *ifname, const struct ether_addr *mac,
 269                 Network **ret);
 270 int network_apply(Manager *manager, Network *network, Link *link);
 271
 272 int config_parse_netdev(const char *unit, const char *filename, unsigned line,
 273                         const char *section, unsigned section_line, const char *lvalue,
 274                         int ltype, const char *rvalue, void *data, void *userdata);
 275
 276 int config_parse_domains(const char *unit,
 277                          const char *filename,
 278                          unsigned line,
 279                          const char *section,
 280                          unsigned section_line,
 281                          const char *lvalue,
 282                          int ltype,
 283                          const char *rvalue,
 284                          void *data,
 285                          void *userdata);
 286
 287 int config_parse_tunnel(const char *unit,
 288                         const char *filename,
 289                         unsigned line,
 290                         const char *section,
 291                         unsigned section_line,
 292                         const char *lvalue,
 293                         int ltype,
 294                         const char *rvalue,
 295                         void *data,
 296                         void *userdata);
 297
 298 int config_parse_tunnel_address(const char *unit,
 299                                 const char *filename,
 300                                 unsigned line,
 301                                 const char *section,
 302                                 unsigned section_line,
 303                                 const char *lvalue,
 304                                 int ltype,
 305                                 const char *rvalue,
 306                                 void *data,
 307                                 void *userdata);
 308
 309 int config_parse_vxlan_group_address(const char *unit,
 310                                      const char *filename,
 311                                      unsigned line,
 312                                      const char *section,
 313                                      unsigned section_line,
 314                                      const char *lvalue,
 315                                      int ltype,
 316                                      const char *rvalue,
 317                                      void *data,
 318                                      void *userdata);
 319
 320 /* gperf */
 321 const struct ConfigPerfItem* network_network_gperf_lookup(const char *key, unsigned length);
 322
 323 /* Route */
 324 int route_new_static(Network *network, unsigned section, Route **ret);
 325 int route_new_dynamic(Route **ret, unsigned char rtm_protocol);
 326 void route_free(Route *route);
 327 int route_configure(Route *route, Link *link, sd_rtnl_message_handler_t callback);
 328 int route_drop(Route *route, Link *link, sd_rtnl_message_handler_t callback);
 329
 330
 331 DEFINE_TRIVIAL_CLEANUP_FUNC(Route*, route_free);
 332 #define _cleanup_route_free_ _cleanup_(route_freep)
 333
 334 int config_parse_gateway(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 int config_parse_destination(const char *unit, const char *filename, unsigned line,
 339                              const char *section, unsigned section_line, const char *lvalue,
 340                              int ltype, const char *rvalue, void *data, void *userdata);
 341
 342 int config_parse_route_priority(const char *unit, const char *filename, unsigned line,
 343                                 const char *section, unsigned section_line, const char *lvalue,
 344                                 int ltype, const char *rvalue, void *data, void *userdata);
 345 /* Address */
 346 int address_new_static(Network *network, unsigned section, Address **ret);
 347 int address_new_dynamic(Address **ret);
 348 void address_free(Address *address);
 349 int address_configure(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 350 int address_update(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 351 int address_drop(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 352 int address_establish(Address *address, Link *link);
 353 int address_release(Address *address, Link *link);
 354 bool address_equal(Address *a1, Address *a2);
 355
 356 DEFINE_TRIVIAL_CLEANUP_FUNC(Address*, address_free);
 357 #define _cleanup_address_free_ _cleanup_(address_freep)
 358
 359 int config_parse_address(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_broadcast(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 int config_parse_label(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 /* Forwarding database table. */
 372 int fdb_entry_configure(sd_rtnl *const rtnl, FdbEntry *const fdb_entry, const int ifindex);
 373 void fdb_entry_free(FdbEntry *fdb_entry);
 374 int fdb_entry_new_static(Network *const network, const unsigned section, FdbEntry **ret);
 375
 376 DEFINE_TRIVIAL_CLEANUP_FUNC(FdbEntry*, fdb_entry_free);
 377 #define _cleanup_fdbentry_free_ _cleanup_(fdb_entry_freep)
 378
 379 int config_parse_fdb_hwaddr(const char *unit, const char *filename, unsigned line,
 380                             const char *section, unsigned section_line, const char *lvalue,
 381                             int ltype, const char *rvalue, void *data, void *userdata);
 382
 383 int config_parse_fdb_vlan_id(const char *unit, const char *filename, unsigned line,
 384                              const char *section, unsigned section_line, const char *lvalue,
 385                              int ltype, const char *rvalue, void *data, void *userdata);
 386
 387 /* DHCP support */
 388
 389 int config_parse_dhcp(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 /* LLMNR support */
 394
 395 const char* llmnr_support_to_string(LLMNRSupport i) _const_;
 396 LLMNRSupport llmnr_support_from_string(const char *s) _pure_;
 397
 398 int config_parse_llmnr(const char *unit, const char *filename, unsigned line,
 399                       const char *section, unsigned section_line, const char *lvalue,
 400                       int ltype, const char *rvalue, void *data, void *userdata);
 401
 402 /* Address Pool */
 403
 404 int address_pool_new(Manager *m, AddressPool **ret, int family, const union in_addr_union *u, unsigned prefixlen);
 405 int address_pool_new_from_string(Manager *m, AddressPool **ret, int family, const char *p, unsigned prefixlen);
 406 void address_pool_free(AddressPool *p);
 407
 408 int address_pool_acquire(AddressPool *p, unsigned prefixlen, union in_addr_union *found);
 409
 410 const char *address_family_boolean_to_string(AddressFamilyBoolean b) _const_;
 411 AddressFamilyBoolean address_family_boolean_from_string(const char *s) _const_;
 412
 413 int config_parse_address_family_boolean(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);
 414
 415 /* Opeartional State */
 416
 417 const char* link_operstate_to_string(LinkOperationalState s) _const_;
 418 LinkOperationalState link_operstate_from_string(const char *s) _pure_;