1 /* Copyright (c) 2013-2018, The Linux Foundation. All rights reserved.
3 * This program is free software; you can redistribute it and/or modify
4 * it under the terms of the GNU General Public License version 2 and
5 * only version 2 as published by the Free Software Foundation.
7 * This program is distributed in the hope that it will be useful,
8 * but WITHOUT ANY WARRANTY; without even the implied warranty of
9 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10 * GNU General Public License for more details.
12 * RMNET configuration engine
17 #include <linux/module.h>
18 #include <linux/netlink.h>
19 #include <linux/netdevice.h>
20 #include "rmnet_config.h"
21 #include "rmnet_handlers.h"
22 #include "rmnet_vnd.h"
23 #include "rmnet_private.h"
26 * The shared resource which needs to be protected is realdev->rx_handler_data.
27 * For the writer path, this is using rtnl_lock(). The writer paths are
28 * rmnet_newlink(), rmnet_dellink() and rmnet_force_unassociate_device(). These
29 * paths are already called with rtnl_lock() acquired in. There is also an
30 * ASSERT_RTNL() to ensure that we are calling with rtnl acquired. For
31 * dereference here, we will need to use rtnl_dereference(). Dev list writing
32 * needs to happen with rtnl_lock() acquired for netdev_master_upper_dev_link().
33 * For the reader path, the real_dev->rx_handler_data is called in the TX / RX
34 * path. We only need rcu_read_lock() for these scenarios. In these cases,
35 * the rcu_read_lock() is held in __dev_queue_xmit() and
36 * netif_receive_skb_internal(), so readers need to use rcu_dereference_rtnl()
37 * to get the relevant information. For dev list reading, we again acquire
38 * rcu_read_lock() in rmnet_dellink() for netdev_master_upper_dev_get_rcu().
39 * We also use unregister_netdevice_many() to free all rmnet devices in
40 * rmnet_force_unassociate_device() so we dont lose the rtnl_lock() and free in
44 /* Local Definitions and Declarations */
46 static const struct nla_policy rmnet_policy[IFLA_RMNET_MAX + 1] = {
47 [IFLA_RMNET_MUX_ID] = { .type = NLA_U16 },
48 [IFLA_RMNET_FLAGS] = { .len = sizeof(struct ifla_rmnet_flags) },
51 static int rmnet_is_real_dev_registered(const struct net_device *real_dev)
53 return rcu_access_pointer(real_dev->rx_handler) == rmnet_rx_handler;
57 static struct rmnet_port*
58 rmnet_get_port_rtnl(const struct net_device *real_dev)
60 return rtnl_dereference(real_dev->rx_handler_data);
63 static int rmnet_unregister_real_device(struct net_device *real_dev,
64 struct rmnet_port *port)
66 if (port->nr_rmnet_devs)
69 netdev_rx_handler_unregister(real_dev);
73 /* release reference on real_dev */
76 netdev_dbg(real_dev, "Removed from rmnet\n");
80 static int rmnet_register_real_device(struct net_device *real_dev)
82 struct rmnet_port *port;
87 if (rmnet_is_real_dev_registered(real_dev))
90 port = kzalloc(sizeof(*port), GFP_ATOMIC);
95 rc = netdev_rx_handler_register(real_dev, rmnet_rx_handler, port);
101 /* hold on to real dev for MAP data */
104 for (entry = 0; entry < RMNET_MAX_LOGICAL_EP; entry++)
105 INIT_HLIST_HEAD(&port->muxed_ep[entry]);
107 netdev_dbg(real_dev, "registered with rmnet\n");
111 static void rmnet_unregister_bridge(struct net_device *dev,
112 struct rmnet_port *port)
114 struct rmnet_port *bridge_port;
115 struct net_device *bridge_dev;
117 if (port->rmnet_mode != RMNET_EPMODE_BRIDGE)
120 /* bridge slave handling */
121 if (!port->nr_rmnet_devs) {
122 bridge_dev = port->bridge_ep;
124 bridge_port = rmnet_get_port_rtnl(bridge_dev);
125 bridge_port->bridge_ep = NULL;
126 bridge_port->rmnet_mode = RMNET_EPMODE_VND;
128 bridge_dev = port->bridge_ep;
130 bridge_port = rmnet_get_port_rtnl(bridge_dev);
131 rmnet_unregister_real_device(bridge_dev, bridge_port);
135 static int rmnet_newlink(struct net *src_net, struct net_device *dev,
136 struct nlattr *tb[], struct nlattr *data[],
137 struct netlink_ext_ack *extack)
139 u32 data_format = RMNET_FLAGS_INGRESS_DEAGGREGATION;
140 struct net_device *real_dev;
141 int mode = RMNET_EPMODE_VND;
142 struct rmnet_endpoint *ep;
143 struct rmnet_port *port;
147 if (!tb[IFLA_LINK]) {
148 NL_SET_ERR_MSG_MOD(extack, "link not specified");
152 real_dev = __dev_get_by_index(src_net, nla_get_u32(tb[IFLA_LINK]));
153 if (!real_dev || !dev)
156 if (!data[IFLA_RMNET_MUX_ID])
159 ep = kzalloc(sizeof(*ep), GFP_ATOMIC);
163 mux_id = nla_get_u16(data[IFLA_RMNET_MUX_ID]);
165 err = rmnet_register_real_device(real_dev);
169 port = rmnet_get_port_rtnl(real_dev);
170 err = rmnet_vnd_newlink(mux_id, dev, port, real_dev, ep);
174 port->rmnet_mode = mode;
176 hlist_add_head_rcu(&ep->hlnode, &port->muxed_ep[mux_id]);
178 if (data[IFLA_RMNET_FLAGS]) {
179 struct ifla_rmnet_flags *flags;
181 flags = nla_data(data[IFLA_RMNET_FLAGS]);
182 data_format = flags->flags & flags->mask;
185 netdev_dbg(dev, "data format [0x%08X]\n", data_format);
186 port->data_format = data_format;
191 rmnet_unregister_real_device(real_dev, port);
197 static void rmnet_dellink(struct net_device *dev, struct list_head *head)
199 struct rmnet_priv *priv = netdev_priv(dev);
200 struct net_device *real_dev;
201 struct rmnet_endpoint *ep;
202 struct rmnet_port *port;
205 real_dev = priv->real_dev;
207 if (!real_dev || !rmnet_is_real_dev_registered(real_dev))
210 port = rmnet_get_port_rtnl(real_dev);
212 mux_id = rmnet_vnd_get_mux(dev);
214 ep = rmnet_get_endpoint(port, mux_id);
216 hlist_del_init_rcu(&ep->hlnode);
217 rmnet_unregister_bridge(dev, port);
218 rmnet_vnd_dellink(mux_id, port, ep);
221 rmnet_unregister_real_device(real_dev, port);
223 unregister_netdevice_queue(dev, head);
226 static void rmnet_force_unassociate_device(struct net_device *dev)
228 struct net_device *real_dev = dev;
229 struct hlist_node *tmp_ep;
230 struct rmnet_endpoint *ep;
231 struct rmnet_port *port;
232 unsigned long bkt_ep;
235 if (!rmnet_is_real_dev_registered(real_dev))
240 port = rmnet_get_port_rtnl(dev);
243 rmnet_unregister_bridge(dev, port);
245 hash_for_each_safe(port->muxed_ep, bkt_ep, tmp_ep, ep, hlnode) {
246 unregister_netdevice_queue(ep->egress_dev, &list);
247 rmnet_vnd_dellink(ep->mux_id, port, ep);
249 hlist_del_init_rcu(&ep->hlnode);
254 unregister_netdevice_many(&list);
256 rmnet_unregister_real_device(real_dev, port);
259 static int rmnet_config_notify_cb(struct notifier_block *nb,
260 unsigned long event, void *data)
262 struct net_device *dev = netdev_notifier_info_to_dev(data);
268 case NETDEV_UNREGISTER:
269 netdev_dbg(dev, "Kernel unregister\n");
270 rmnet_force_unassociate_device(dev);
280 static struct notifier_block rmnet_dev_notifier __read_mostly = {
281 .notifier_call = rmnet_config_notify_cb,
284 static int rmnet_rtnl_validate(struct nlattr *tb[], struct nlattr *data[],
285 struct netlink_ext_ack *extack)
289 if (!data || !data[IFLA_RMNET_MUX_ID])
292 mux_id = nla_get_u16(data[IFLA_RMNET_MUX_ID]);
293 if (mux_id > (RMNET_MAX_LOGICAL_EP - 1))
299 static int rmnet_changelink(struct net_device *dev, struct nlattr *tb[],
300 struct nlattr *data[],
301 struct netlink_ext_ack *extack)
303 struct rmnet_priv *priv = netdev_priv(dev);
304 struct net_device *real_dev;
305 struct rmnet_endpoint *ep;
306 struct rmnet_port *port;
312 real_dev = priv->real_dev;
313 if (!rmnet_is_real_dev_registered(real_dev))
316 port = rmnet_get_port_rtnl(real_dev);
318 if (data[IFLA_RMNET_MUX_ID]) {
319 mux_id = nla_get_u16(data[IFLA_RMNET_MUX_ID]);
320 ep = rmnet_get_endpoint(port, priv->mux_id);
324 hlist_del_init_rcu(&ep->hlnode);
325 hlist_add_head_rcu(&ep->hlnode, &port->muxed_ep[mux_id]);
328 priv->mux_id = mux_id;
331 if (data[IFLA_RMNET_FLAGS]) {
332 struct ifla_rmnet_flags *flags;
334 flags = nla_data(data[IFLA_RMNET_FLAGS]);
335 port->data_format = flags->flags & flags->mask;
341 static size_t rmnet_get_size(const struct net_device *dev)
344 /* IFLA_RMNET_MUX_ID */
346 /* IFLA_RMNET_FLAGS */
347 nla_total_size(sizeof(struct ifla_rmnet_flags));
350 static int rmnet_fill_info(struct sk_buff *skb, const struct net_device *dev)
352 struct rmnet_priv *priv = netdev_priv(dev);
353 struct net_device *real_dev;
354 struct ifla_rmnet_flags f;
355 struct rmnet_port *port;
357 real_dev = priv->real_dev;
359 if (nla_put_u16(skb, IFLA_RMNET_MUX_ID, priv->mux_id))
360 goto nla_put_failure;
362 if (rmnet_is_real_dev_registered(real_dev)) {
363 port = rmnet_get_port_rtnl(real_dev);
364 f.flags = port->data_format;
371 if (nla_put(skb, IFLA_RMNET_FLAGS, sizeof(f), &f))
372 goto nla_put_failure;
380 struct rtnl_link_ops rmnet_link_ops __read_mostly = {
382 .maxtype = __IFLA_RMNET_MAX,
383 .priv_size = sizeof(struct rmnet_priv),
384 .setup = rmnet_vnd_setup,
385 .validate = rmnet_rtnl_validate,
386 .newlink = rmnet_newlink,
387 .dellink = rmnet_dellink,
388 .get_size = rmnet_get_size,
389 .changelink = rmnet_changelink,
390 .policy = rmnet_policy,
391 .fill_info = rmnet_fill_info,
394 /* Needs either rcu_read_lock() or rtnl lock */
395 struct rmnet_port *rmnet_get_port(struct net_device *real_dev)
397 if (rmnet_is_real_dev_registered(real_dev))
398 return rcu_dereference_rtnl(real_dev->rx_handler_data);
403 struct rmnet_endpoint *rmnet_get_endpoint(struct rmnet_port *port, u8 mux_id)
405 struct rmnet_endpoint *ep;
407 hlist_for_each_entry_rcu(ep, &port->muxed_ep[mux_id], hlnode) {
408 if (ep->mux_id == mux_id)
415 int rmnet_add_bridge(struct net_device *rmnet_dev,
416 struct net_device *slave_dev,
417 struct netlink_ext_ack *extack)
419 struct rmnet_priv *priv = netdev_priv(rmnet_dev);
420 struct net_device *real_dev = priv->real_dev;
421 struct rmnet_port *port, *slave_port;
424 port = rmnet_get_port(real_dev);
426 /* If there is more than one rmnet dev attached, its probably being
427 * used for muxing. Skip the briding in that case
429 if (port->nr_rmnet_devs > 1)
432 if (rmnet_is_real_dev_registered(slave_dev))
435 err = rmnet_register_real_device(slave_dev);
439 slave_port = rmnet_get_port(slave_dev);
440 slave_port->rmnet_mode = RMNET_EPMODE_BRIDGE;
441 slave_port->bridge_ep = real_dev;
443 port->rmnet_mode = RMNET_EPMODE_BRIDGE;
444 port->bridge_ep = slave_dev;
446 netdev_dbg(slave_dev, "registered with rmnet as slave\n");
450 int rmnet_del_bridge(struct net_device *rmnet_dev,
451 struct net_device *slave_dev)
453 struct rmnet_priv *priv = netdev_priv(rmnet_dev);
454 struct net_device *real_dev = priv->real_dev;
455 struct rmnet_port *port, *slave_port;
457 port = rmnet_get_port(real_dev);
458 port->rmnet_mode = RMNET_EPMODE_VND;
459 port->bridge_ep = NULL;
461 slave_port = rmnet_get_port(slave_dev);
462 rmnet_unregister_real_device(slave_dev, slave_port);
464 netdev_dbg(slave_dev, "removed from rmnet as slave\n");
468 /* Startup/Shutdown */
470 static int __init rmnet_init(void)
474 rc = register_netdevice_notifier(&rmnet_dev_notifier);
478 rc = rtnl_link_register(&rmnet_link_ops);
480 unregister_netdevice_notifier(&rmnet_dev_notifier);
486 static void __exit rmnet_exit(void)
488 unregister_netdevice_notifier(&rmnet_dev_notifier);
489 rtnl_link_unregister(&rmnet_link_ops);
492 module_init(rmnet_init)
493 module_exit(rmnet_exit)
494 MODULE_LICENSE("GPL v2");