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_connect_bus(Manager *m);
 243 int manager_run(Manager *m);
 244
 245 int manager_load_config(Manager *m);
 246 bool manager_should_reload(Manager *m);
 247
 248 int manager_rtnl_enumerate_links(Manager *m);
 249 int manager_rtnl_enumerate_addresses(Manager *m);
 250
 251 int manager_send_changed(Manager *m, const char *property, ...) _sentinel_;
 252 int manager_save(Manager *m);
 253
 254 int manager_address_pool_acquire(Manager *m, int family, unsigned prefixlen, union in_addr_union *found);
 255
 256 DEFINE_TRIVIAL_CLEANUP_FUNC(Manager*, manager_free);
 257 #define _cleanup_manager_free_ _cleanup_(manager_freep)
 258
 259 /* Network */
 260
 261 int network_load(Manager *manager);
 262
 263 void network_free(Network *network);
 264
 265 DEFINE_TRIVIAL_CLEANUP_FUNC(Network*, network_free);
 266 #define _cleanup_network_free_ _cleanup_(network_freep)
 267
 268 int network_get(Manager *manager, struct udev_device *device,
 269                 const char *ifname, const struct ether_addr *mac,
 270                 Network **ret);
 271 int network_apply(Manager *manager, Network *network, Link *link);
 272
 273 int config_parse_netdev(const char *unit, const char *filename, unsigned line,
 274                         const char *section, unsigned section_line, const char *lvalue,
 275                         int ltype, const char *rvalue, void *data, void *userdata);
 276
 277 int config_parse_domains(const char *unit,
 278                          const char *filename,
 279                          unsigned line,
 280                          const char *section,
 281                          unsigned section_line,
 282                          const char *lvalue,
 283                          int ltype,
 284                          const char *rvalue,
 285                          void *data,
 286                          void *userdata);
 287
 288 int config_parse_tunnel(const char *unit,
 289                         const char *filename,
 290                         unsigned line,
 291                         const char *section,
 292                         unsigned section_line,
 293                         const char *lvalue,
 294                         int ltype,
 295                         const char *rvalue,
 296                         void *data,
 297                         void *userdata);
 298
 299 int config_parse_tunnel_address(const char *unit,
 300                                 const char *filename,
 301                                 unsigned line,
 302                                 const char *section,
 303                                 unsigned section_line,
 304                                 const char *lvalue,
 305                                 int ltype,
 306                                 const char *rvalue,
 307                                 void *data,
 308                                 void *userdata);
 309
 310 int config_parse_vxlan_group_address(const char *unit,
 311                                      const char *filename,
 312                                      unsigned line,
 313                                      const char *section,
 314                                      unsigned section_line,
 315                                      const char *lvalue,
 316                                      int ltype,
 317                                      const char *rvalue,
 318                                      void *data,
 319                                      void *userdata);
 320
 321 /* gperf */
 322 const struct ConfigPerfItem* network_network_gperf_lookup(const char *key, unsigned length);
 323
 324 /* Route */
 325 int route_new_static(Network *network, unsigned section, Route **ret);
 326 int route_new_dynamic(Route **ret, unsigned char rtm_protocol);
 327 void route_free(Route *route);
 328 int route_configure(Route *route, Link *link, sd_rtnl_message_handler_t callback);
 329 int route_drop(Route *route, Link *link, sd_rtnl_message_handler_t callback);
 330
 331
 332 DEFINE_TRIVIAL_CLEANUP_FUNC(Route*, route_free);
 333 #define _cleanup_route_free_ _cleanup_(route_freep)
 334
 335 int config_parse_gateway(const char *unit, const char *filename, unsigned line,
 336                          const char *section, unsigned section_line, const char *lvalue,
 337                          int ltype, const char *rvalue, void *data, void *userdata);
 338
 339 int config_parse_destination(const char *unit, const char *filename, unsigned line,
 340                              const char *section, unsigned section_line, const char *lvalue,
 341                              int ltype, const char *rvalue, void *data, void *userdata);
 342
 343 int config_parse_route_priority(const char *unit, const char *filename, unsigned line,
 344                                 const char *section, unsigned section_line, const char *lvalue,
 345                                 int ltype, const char *rvalue, void *data, void *userdata);
 346 /* Address */
 347 int address_new_static(Network *network, unsigned section, Address **ret);
 348 int address_new_dynamic(Address **ret);
 349 void address_free(Address *address);
 350 int address_configure(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 351 int address_update(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 352 int address_drop(Address *address, Link *link, sd_rtnl_message_handler_t callback);
 353 int address_establish(Address *address, Link *link);
 354 int address_release(Address *address, Link *link);
 355 bool address_equal(Address *a1, Address *a2);
 356
 357 DEFINE_TRIVIAL_CLEANUP_FUNC(Address*, address_free);
 358 #define _cleanup_address_free_ _cleanup_(address_freep)
 359
 360 int config_parse_address(const char *unit, const char *filename, unsigned line,
 361                          const char *section, unsigned section_line, const char *lvalue,
 362                          int ltype, const char *rvalue, void *data, void *userdata);
 363
 364 int config_parse_broadcast(const char *unit, const char *filename, unsigned line,
 365                            const char *section, unsigned section_line, const char *lvalue,
 366                            int ltype, const char *rvalue, void *data, void *userdata);
 367
 368 int config_parse_label(const char *unit, const char *filename, unsigned line,
 369                        const char *section, unsigned section_line, const char *lvalue,
 370                        int ltype, const char *rvalue, void *data, void *userdata);
 371
 372 /* Forwarding database table. */
 373 int fdb_entry_configure(sd_rtnl *const rtnl, FdbEntry *const fdb_entry, const int ifindex);
 374 void fdb_entry_free(FdbEntry *fdb_entry);
 375 int fdb_entry_new_static(Network *const network, const unsigned section, FdbEntry **ret);
 376
 377 DEFINE_TRIVIAL_CLEANUP_FUNC(FdbEntry*, fdb_entry_free);
 378 #define _cleanup_fdbentry_free_ _cleanup_(fdb_entry_freep)
 379
 380 int config_parse_fdb_hwaddr(const char *unit, const char *filename, unsigned line,
 381                             const char *section, unsigned section_line, const char *lvalue,
 382                             int ltype, const char *rvalue, void *data, void *userdata);
 383
 384 int config_parse_fdb_vlan_id(const char *unit, const char *filename, unsigned line,
 385                              const char *section, unsigned section_line, const char *lvalue,
 386                              int ltype, const char *rvalue, void *data, void *userdata);
 387
 388 /* DHCP support */
 389
 390 int config_parse_dhcp(const char *unit, const char *filename, unsigned line,
 391                       const char *section, unsigned section_line, const char *lvalue,
 392                       int ltype, const char *rvalue, void *data, void *userdata);
 393
 394 /* LLMNR support */
 395
 396 const char* llmnr_support_to_string(LLMNRSupport i) _const_;
 397 LLMNRSupport llmnr_support_from_string(const char *s) _pure_;
 398
 399 int config_parse_llmnr(const char *unit, const char *filename, unsigned line,
 400                       const char *section, unsigned section_line, const char *lvalue,
 401                       int ltype, const char *rvalue, void *data, void *userdata);
 402
 403 /* Address Pool */
 404
 405 int address_pool_new(Manager *m, AddressPool **ret, int family, const union in_addr_union *u, unsigned prefixlen);
 406 int address_pool_new_from_string(Manager *m, AddressPool **ret, int family, const char *p, unsigned prefixlen);
 407 void address_pool_free(AddressPool *p);
 408
 409 int address_pool_acquire(AddressPool *p, unsigned prefixlen, union in_addr_union *found);
 410
 411 const char *address_family_boolean_to_string(AddressFamilyBoolean b) _const_;
 412 AddressFamilyBoolean address_family_boolean_from_string(const char *s) _const_;
 413
 414 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);
 415
 416 /* Opeartional State */
 417
 418 const char* link_operstate_to_string(LinkOperationalState s) _const_;
 419 LinkOperationalState link_operstate_from_string(const char *s) _pure_;