1 /* SPDX-License-Identifier: LGPL-2.1+ */
5 This file is part of systemd.
7 Copyright 2013 Tom Gundersen <teg@jklm.no>
9 systemd is free software; you can redistribute it and/or modify it
10 under the terms of the GNU Lesser General Public License as published by
11 the Free Software Foundation; either version 2.1 of the License, or
12 (at your option) any later version.
14 systemd is distributed in the hope that it will be useful, but
15 WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 Lesser General Public License for more details.
19 You should have received a copy of the GNU Lesser General Public License
20 along with systemd; If not, see <http://www.gnu.org/licenses/>.
23 #include "sd-netlink.h"
26 #include "time-util.h"
28 typedef struct netdev_join_callback netdev_join_callback
;
29 typedef struct Link Link
;
31 struct netdev_join_callback
{
32 sd_netlink_message_handler_t callback
;
35 LIST_FIELDS(netdev_join_callback
, callbacks
);
38 typedef enum NetDevKind
{
50 NETDEV_KIND_IP6GRETAP
,
63 _NETDEV_KIND_INVALID
= -1
66 typedef enum NetDevState
{
68 NETDEV_STATE_CREATING
,
72 _NETDEV_STATE_INVALID
= -1,
75 typedef enum NetDevCreateType
{
76 NETDEV_CREATE_INDEPENDENT
,
78 NETDEV_CREATE_STACKED
,
80 _NETDEV_CREATE_INVALID
= -1,
83 typedef struct Manager Manager
;
84 typedef struct Condition Condition
;
86 typedef struct NetDev
{
93 Condition
*match_host
;
94 Condition
*match_virt
;
95 Condition
*match_kernel
;
96 Condition
*match_arch
;
102 struct ether_addr
*mac
;
106 LIST_HEAD(netdev_join_callback
, callbacks
);
109 typedef struct NetDevVTable
{
110 /* How much memory does an object of this unit type need */
113 /* Config file sections this netdev kind understands, separated
115 const char *sections
;
117 /* This should reset all type-specific variables. This should
118 * not allocate memory, and is called with zero-initialized
119 * data. It should hence only initialize variables that need
121 void (*init
)(NetDev
*n
);
123 /* This should free all kind-specific variables. It should be
125 void (*done
)(NetDev
*n
);
127 /* fill in message to create netdev */
128 int (*fill_message_create
)(NetDev
*netdev
, Link
*link
, sd_netlink_message
*message
);
130 /* specifies if netdev is independent, or a master device or a stacked device */
131 NetDevCreateType create_type
;
133 /* create netdev, if not done via rtnl */
134 int (*create
)(NetDev
*netdev
);
136 /* perform additional configuration after netdev has been createad */
137 int (*post_create
)(NetDev
*netdev
, Link
*link
, sd_netlink_message
*message
);
139 /* verify that compulsory configuration options were specified */
140 int (*config_verify
)(NetDev
*netdev
, const char *filename
);
143 extern const NetDevVTable
* const netdev_vtable
[_NETDEV_KIND_MAX
];
145 #define NETDEV_VTABLE(n) netdev_vtable[(n)->kind]
147 /* For casting a netdev into the various netdev kinds */
148 #define DEFINE_NETDEV_CAST(UPPERCASE, MixedCase) \
149 static inline MixedCase* UPPERCASE(NetDev *n) { \
150 if (_unlikely_(!n || n->kind != NETDEV_KIND_##UPPERCASE)) \
153 return (MixedCase*) n; \
156 /* For casting the various netdev kinds into a netdev */
157 #define NETDEV(n) (&(n)->meta)
159 int netdev_load(Manager
*manager
);
160 void netdev_drop(NetDev
*netdev
);
162 NetDev
*netdev_unref(NetDev
*netdev
);
163 NetDev
*netdev_ref(NetDev
*netdev
);
165 DEFINE_TRIVIAL_CLEANUP_FUNC(NetDev
*, netdev_unref
);
166 #define _cleanup_netdev_unref_ _cleanup_(netdev_unrefp)
168 int netdev_get(Manager
*manager
, const char *name
, NetDev
**ret
);
169 int netdev_set_ifindex(NetDev
*netdev
, sd_netlink_message
*newlink
);
170 int netdev_enslave(NetDev
*netdev
, Link
*link
, sd_netlink_message_handler_t callback
);
171 int netdev_get_mac(const char *ifname
, struct ether_addr
**ret
);
172 int netdev_join(NetDev
*netdev
, Link
*link
, sd_netlink_message_handler_t cb
);
174 const char *netdev_kind_to_string(NetDevKind d
) _const_
;
175 NetDevKind
netdev_kind_from_string(const char *d
) _pure_
;
177 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
);
180 const struct ConfigPerfItem
* network_netdev_gperf_lookup(const char *key
, GPERF_LEN_TYPE length
);
182 /* Macros which append INTERFACE= to the message */
184 #define log_netdev_full(netdev, level, error, ...) \
186 const NetDev *_n = (netdev); \
187 _n ? log_object_internal(level, error, __FILE__, __LINE__, __func__, "INTERFACE=", _n->ifname, NULL, NULL, ##__VA_ARGS__) : \
188 log_internal(level, error, __FILE__, __LINE__, __func__, ##__VA_ARGS__); \
191 #define log_netdev_debug(netdev, ...) log_netdev_full(netdev, LOG_DEBUG, 0, ##__VA_ARGS__)
192 #define log_netdev_info(netdev, ...) log_netdev_full(netdev, LOG_INFO, 0, ##__VA_ARGS__)
193 #define log_netdev_notice(netdev, ...) log_netdev_full(netdev, LOG_NOTICE, 0, ##__VA_ARGS__)
194 #define log_netdev_warning(netdev, ...) log_netdev_full(netdev, LOG_WARNING, 0, ## __VA_ARGS__)
195 #define log_netdev_error(netdev, ...) log_netdev_full(netdev, LOG_ERR, 0, ##__VA_ARGS__)
197 #define log_netdev_debug_errno(netdev, error, ...) log_netdev_full(netdev, LOG_DEBUG, error, ##__VA_ARGS__)
198 #define log_netdev_info_errno(netdev, error, ...) log_netdev_full(netdev, LOG_INFO, error, ##__VA_ARGS__)
199 #define log_netdev_notice_errno(netdev, error, ...) log_netdev_full(netdev, LOG_NOTICE, error, ##__VA_ARGS__)
200 #define log_netdev_warning_errno(netdev, error, ...) log_netdev_full(netdev, LOG_WARNING, error, ##__VA_ARGS__)
201 #define log_netdev_error_errno(netdev, error, ...) log_netdev_full(netdev, LOG_ERR, error, ##__VA_ARGS__)
203 #define LOG_NETDEV_MESSAGE(netdev, fmt, ...) "MESSAGE=%s: " fmt, (netdev)->ifname, ##__VA_ARGS__
204 #define LOG_NETDEV_INTERFACE(netdev) "INTERFACE=%s", (netdev)->ifname