1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
4 #include "sd-netlink.h"
6 #include "conf-parser.h"
8 #include "networkd-link.h"
11 #define NETDEV_COMMON_SECTIONS "Match\0NetDev\0"
12 /* This is the list of known sections. We need to ignore them in the initial parsing phase. */
13 #define NETDEV_OTHER_SECTIONS \
24 "-MACsecReceiveChannel\0" \
25 "-MACsecTransmitAssociation\0" \
26 "-MACsecReceiveAssociation\0" \
41 typedef struct netdev_join_callback netdev_join_callback
;
43 struct netdev_join_callback
{
44 link_netlink_message_handler_t callback
;
47 LIST_FIELDS(netdev_join_callback
, callbacks
);
50 typedef enum NetDevKind
{
63 NETDEV_KIND_IP6GRETAP
,
76 NETDEV_KIND_WIREGUARD
,
77 NETDEV_KIND_NETDEVSIM
,
87 _NETDEV_KIND_TUNNEL
, /* Used by config_parse_stacked_netdev() */
88 _NETDEV_KIND_INVALID
= -1
91 typedef enum NetDevState
{
94 NETDEV_STATE_CREATING
,
98 _NETDEV_STATE_INVALID
= -1,
101 typedef enum NetDevCreateType
{
102 NETDEV_CREATE_INDEPENDENT
,
103 NETDEV_CREATE_MASTER
,
104 NETDEV_CREATE_STACKED
,
105 NETDEV_CREATE_AFTER_CONFIGURED
,
107 _NETDEV_CREATE_INVALID
= -1,
110 typedef struct Manager Manager
;
111 typedef struct Condition Condition
;
113 typedef struct NetDev
{
120 LIST_HEAD(Condition
, conditions
);
126 struct ether_addr
*mac
;
130 LIST_HEAD(netdev_join_callback
, callbacks
);
133 typedef struct NetDevVTable
{
134 /* How much memory does an object of this unit type need */
137 /* Config file sections this netdev kind understands, separated
139 const char *sections
;
141 /* This should reset all type-specific variables. This should
142 * not allocate memory, and is called with zero-initialized
143 * data. It should hence only initialize variables that need
145 void (*init
)(NetDev
*n
);
147 /* This should free all kind-specific variables. It should be
149 void (*done
)(NetDev
*n
);
151 /* fill in message to create netdev */
152 int (*fill_message_create
)(NetDev
*netdev
, Link
*link
, sd_netlink_message
*message
);
154 /* specifies if netdev is independent, or a master device or a stacked device */
155 NetDevCreateType create_type
;
157 /* create netdev, if not done via rtnl */
158 int (*create
)(NetDev
*netdev
);
160 /* create netdev after link is fully configured */
161 int (*create_after_configured
)(NetDev
*netdev
, Link
*link
);
163 /* perform additional configuration after netdev has been createad */
164 int (*post_create
)(NetDev
*netdev
, Link
*link
, sd_netlink_message
*message
);
166 /* verify that compulsory configuration options were specified */
167 int (*config_verify
)(NetDev
*netdev
, const char *filename
);
169 /* Generate MAC address or not When MACAddress= is not specified. */
173 extern const NetDevVTable
* const netdev_vtable
[_NETDEV_KIND_MAX
];
175 #define NETDEV_VTABLE(n) ((n)->kind != _NETDEV_KIND_INVALID ? netdev_vtable[(n)->kind] : NULL)
177 /* For casting a netdev into the various netdev kinds */
178 #define DEFINE_NETDEV_CAST(UPPERCASE, MixedCase) \
179 static inline MixedCase* UPPERCASE(NetDev *n) { \
180 if (_unlikely_(!n || \
181 n->kind != NETDEV_KIND_##UPPERCASE) || \
182 n->state == _NETDEV_STATE_INVALID) \
185 return (MixedCase*) n; \
188 /* For casting the various netdev kinds into a netdev */
189 #define NETDEV(n) (&(n)->meta)
191 int netdev_load(Manager
*manager
, bool reload
);
192 int netdev_load_one(Manager
*manager
, const char *filename
);
193 void netdev_drop(NetDev
*netdev
);
195 NetDev
*netdev_unref(NetDev
*netdev
);
196 NetDev
*netdev_ref(NetDev
*netdev
);
197 DEFINE_TRIVIAL_DESTRUCTOR(netdev_destroy_callback
, NetDev
, netdev_unref
);
198 DEFINE_TRIVIAL_CLEANUP_FUNC(NetDev
*, netdev_unref
);
200 bool netdev_is_managed(NetDev
*netdev
);
201 int netdev_get(Manager
*manager
, const char *name
, NetDev
**ret
);
202 int netdev_set_ifindex(NetDev
*netdev
, sd_netlink_message
*newlink
);
203 int netdev_get_mac(const char *ifname
, struct ether_addr
**ret
);
204 int netdev_join(NetDev
*netdev
, Link
*link
, link_netlink_message_handler_t cb
);
205 int netdev_join_after_configured(NetDev
*netdev
, Link
*link
, link_netlink_message_handler_t callback
);
207 const char *netdev_kind_to_string(NetDevKind d
) _const_
;
208 NetDevKind
netdev_kind_from_string(const char *d
) _pure_
;
210 static inline NetDevCreateType
netdev_get_create_type(NetDev
*netdev
) {
212 assert(NETDEV_VTABLE(netdev
));
214 return NETDEV_VTABLE(netdev
)->create_type
;
217 CONFIG_PARSER_PROTOTYPE(config_parse_netdev_kind
);
220 const struct ConfigPerfItem
* network_netdev_gperf_lookup(const char *key
, GPERF_LEN_TYPE length
);
222 /* Macros which append INTERFACE= to the message */
224 #define log_netdev_full(netdev, level, error, ...) \
226 const NetDev *_n = (netdev); \
227 _n ? log_object_internal(level, error, PROJECT_FILE, __LINE__, __func__, "INTERFACE=", _n->ifname, NULL, NULL, ##__VA_ARGS__) : \
228 log_internal(level, error, PROJECT_FILE, __LINE__, __func__, ##__VA_ARGS__); \
231 #define log_netdev_debug(netdev, ...) log_netdev_full(netdev, LOG_DEBUG, 0, ##__VA_ARGS__)
232 #define log_netdev_info(netdev, ...) log_netdev_full(netdev, LOG_INFO, 0, ##__VA_ARGS__)
233 #define log_netdev_notice(netdev, ...) log_netdev_full(netdev, LOG_NOTICE, 0, ##__VA_ARGS__)
234 #define log_netdev_warning(netdev, ...) log_netdev_full(netdev, LOG_WARNING, 0, ## __VA_ARGS__)
235 #define log_netdev_error(netdev, ...) log_netdev_full(netdev, LOG_ERR, 0, ##__VA_ARGS__)
237 #define log_netdev_debug_errno(netdev, error, ...) log_netdev_full(netdev, LOG_DEBUG, error, ##__VA_ARGS__)
238 #define log_netdev_info_errno(netdev, error, ...) log_netdev_full(netdev, LOG_INFO, error, ##__VA_ARGS__)
239 #define log_netdev_notice_errno(netdev, error, ...) log_netdev_full(netdev, LOG_NOTICE, error, ##__VA_ARGS__)
240 #define log_netdev_warning_errno(netdev, error, ...) log_netdev_full(netdev, LOG_WARNING, error, ##__VA_ARGS__)
241 #define log_netdev_error_errno(netdev, error, ...) log_netdev_full(netdev, LOG_ERR, error, ##__VA_ARGS__)
243 #define LOG_NETDEV_MESSAGE(netdev, fmt, ...) "MESSAGE=%s: " fmt, (netdev)->ifname, ##__VA_ARGS__
244 #define LOG_NETDEV_INTERFACE(netdev) "INTERFACE=%s", (netdev)->ifname