xref: /openbmc/linux/net/core/dev_ioctl.c (revision 6d21fb7d)
1 // SPDX-License-Identifier: GPL-2.0
2 #include <linux/kmod.h>
3 #include <linux/netdevice.h>
4 #include <linux/inetdevice.h>
5 #include <linux/etherdevice.h>
6 #include <linux/rtnetlink.h>
7 #include <linux/net_tstamp.h>
8 #include <linux/phylib_stubs.h>
9 #include <linux/wireless.h>
10 #include <linux/if_bridge.h>
11 #include <net/dsa_stubs.h>
12 #include <net/wext.h>
13 
14 #include "dev.h"
15 
16 /*
17  *	Map an interface index to its name (SIOCGIFNAME)
18  */
19 
20 /*
21  *	We need this ioctl for efficient implementation of the
22  *	if_indextoname() function required by the IPv6 API.  Without
23  *	it, we would have to search all the interfaces to find a
24  *	match.  --pb
25  */
26 
27 static int dev_ifname(struct net *net, struct ifreq *ifr)
28 {
29 	ifr->ifr_name[IFNAMSIZ-1] = 0;
30 	return netdev_get_name(net, ifr->ifr_name, ifr->ifr_ifindex);
31 }
32 
33 /*
34  *	Perform a SIOCGIFCONF call. This structure will change
35  *	size eventually, and there is nothing I can do about it.
36  *	Thus we will need a 'compatibility mode'.
37  */
38 int dev_ifconf(struct net *net, struct ifconf __user *uifc)
39 {
40 	struct net_device *dev;
41 	void __user *pos;
42 	size_t size;
43 	int len, total = 0, done;
44 
45 	/* both the ifconf and the ifreq structures are slightly different */
46 	if (in_compat_syscall()) {
47 		struct compat_ifconf ifc32;
48 
49 		if (copy_from_user(&ifc32, uifc, sizeof(struct compat_ifconf)))
50 			return -EFAULT;
51 
52 		pos = compat_ptr(ifc32.ifcbuf);
53 		len = ifc32.ifc_len;
54 		size = sizeof(struct compat_ifreq);
55 	} else {
56 		struct ifconf ifc;
57 
58 		if (copy_from_user(&ifc, uifc, sizeof(struct ifconf)))
59 			return -EFAULT;
60 
61 		pos = ifc.ifc_buf;
62 		len = ifc.ifc_len;
63 		size = sizeof(struct ifreq);
64 	}
65 
66 	/* Loop over the interfaces, and write an info block for each. */
67 	rtnl_lock();
68 	for_each_netdev(net, dev) {
69 		if (!pos)
70 			done = inet_gifconf(dev, NULL, 0, size);
71 		else
72 			done = inet_gifconf(dev, pos + total,
73 					    len - total, size);
74 		if (done < 0) {
75 			rtnl_unlock();
76 			return -EFAULT;
77 		}
78 		total += done;
79 	}
80 	rtnl_unlock();
81 
82 	return put_user(total, &uifc->ifc_len);
83 }
84 
85 static int dev_getifmap(struct net_device *dev, struct ifreq *ifr)
86 {
87 	struct ifmap *ifmap = &ifr->ifr_map;
88 
89 	if (in_compat_syscall()) {
90 		struct compat_ifmap *cifmap = (struct compat_ifmap *)ifmap;
91 
92 		cifmap->mem_start = dev->mem_start;
93 		cifmap->mem_end   = dev->mem_end;
94 		cifmap->base_addr = dev->base_addr;
95 		cifmap->irq       = dev->irq;
96 		cifmap->dma       = dev->dma;
97 		cifmap->port      = dev->if_port;
98 
99 		return 0;
100 	}
101 
102 	ifmap->mem_start  = dev->mem_start;
103 	ifmap->mem_end    = dev->mem_end;
104 	ifmap->base_addr  = dev->base_addr;
105 	ifmap->irq        = dev->irq;
106 	ifmap->dma        = dev->dma;
107 	ifmap->port       = dev->if_port;
108 
109 	return 0;
110 }
111 
112 static int dev_setifmap(struct net_device *dev, struct ifreq *ifr)
113 {
114 	struct compat_ifmap *cifmap = (struct compat_ifmap *)&ifr->ifr_map;
115 
116 	if (!dev->netdev_ops->ndo_set_config)
117 		return -EOPNOTSUPP;
118 
119 	if (in_compat_syscall()) {
120 		struct ifmap ifmap = {
121 			.mem_start  = cifmap->mem_start,
122 			.mem_end    = cifmap->mem_end,
123 			.base_addr  = cifmap->base_addr,
124 			.irq        = cifmap->irq,
125 			.dma        = cifmap->dma,
126 			.port       = cifmap->port,
127 		};
128 
129 		return dev->netdev_ops->ndo_set_config(dev, &ifmap);
130 	}
131 
132 	return dev->netdev_ops->ndo_set_config(dev, &ifr->ifr_map);
133 }
134 
135 /*
136  *	Perform the SIOCxIFxxx calls, inside rcu_read_lock()
137  */
138 static int dev_ifsioc_locked(struct net *net, struct ifreq *ifr, unsigned int cmd)
139 {
140 	int err;
141 	struct net_device *dev = dev_get_by_name_rcu(net, ifr->ifr_name);
142 
143 	if (!dev)
144 		return -ENODEV;
145 
146 	switch (cmd) {
147 	case SIOCGIFFLAGS:	/* Get interface flags */
148 		ifr->ifr_flags = (short) dev_get_flags(dev);
149 		return 0;
150 
151 	case SIOCGIFMETRIC:	/* Get the metric on the interface
152 				   (currently unused) */
153 		ifr->ifr_metric = 0;
154 		return 0;
155 
156 	case SIOCGIFMTU:	/* Get the MTU of a device */
157 		ifr->ifr_mtu = dev->mtu;
158 		return 0;
159 
160 	case SIOCGIFSLAVE:
161 		err = -EINVAL;
162 		break;
163 
164 	case SIOCGIFMAP:
165 		return dev_getifmap(dev, ifr);
166 
167 	case SIOCGIFINDEX:
168 		ifr->ifr_ifindex = dev->ifindex;
169 		return 0;
170 
171 	case SIOCGIFTXQLEN:
172 		ifr->ifr_qlen = dev->tx_queue_len;
173 		return 0;
174 
175 	default:
176 		/* dev_ioctl() should ensure this case
177 		 * is never reached
178 		 */
179 		WARN_ON(1);
180 		err = -ENOTTY;
181 		break;
182 
183 	}
184 	return err;
185 }
186 
187 static int net_hwtstamp_validate(const struct kernel_hwtstamp_config *cfg)
188 {
189 	enum hwtstamp_tx_types tx_type;
190 	enum hwtstamp_rx_filters rx_filter;
191 	int tx_type_valid = 0;
192 	int rx_filter_valid = 0;
193 
194 	if (cfg->flags & ~HWTSTAMP_FLAG_MASK)
195 		return -EINVAL;
196 
197 	tx_type = cfg->tx_type;
198 	rx_filter = cfg->rx_filter;
199 
200 	switch (tx_type) {
201 	case HWTSTAMP_TX_OFF:
202 	case HWTSTAMP_TX_ON:
203 	case HWTSTAMP_TX_ONESTEP_SYNC:
204 	case HWTSTAMP_TX_ONESTEP_P2P:
205 		tx_type_valid = 1;
206 		break;
207 	case __HWTSTAMP_TX_CNT:
208 		/* not a real value */
209 		break;
210 	}
211 
212 	switch (rx_filter) {
213 	case HWTSTAMP_FILTER_NONE:
214 	case HWTSTAMP_FILTER_ALL:
215 	case HWTSTAMP_FILTER_SOME:
216 	case HWTSTAMP_FILTER_PTP_V1_L4_EVENT:
217 	case HWTSTAMP_FILTER_PTP_V1_L4_SYNC:
218 	case HWTSTAMP_FILTER_PTP_V1_L4_DELAY_REQ:
219 	case HWTSTAMP_FILTER_PTP_V2_L4_EVENT:
220 	case HWTSTAMP_FILTER_PTP_V2_L4_SYNC:
221 	case HWTSTAMP_FILTER_PTP_V2_L4_DELAY_REQ:
222 	case HWTSTAMP_FILTER_PTP_V2_L2_EVENT:
223 	case HWTSTAMP_FILTER_PTP_V2_L2_SYNC:
224 	case HWTSTAMP_FILTER_PTP_V2_L2_DELAY_REQ:
225 	case HWTSTAMP_FILTER_PTP_V2_EVENT:
226 	case HWTSTAMP_FILTER_PTP_V2_SYNC:
227 	case HWTSTAMP_FILTER_PTP_V2_DELAY_REQ:
228 	case HWTSTAMP_FILTER_NTP_ALL:
229 		rx_filter_valid = 1;
230 		break;
231 	case __HWTSTAMP_FILTER_CNT:
232 		/* not a real value */
233 		break;
234 	}
235 
236 	if (!tx_type_valid || !rx_filter_valid)
237 		return -ERANGE;
238 
239 	return 0;
240 }
241 
242 static int dev_eth_ioctl(struct net_device *dev,
243 			 struct ifreq *ifr, unsigned int cmd)
244 {
245 	const struct net_device_ops *ops = dev->netdev_ops;
246 
247 	if (!ops->ndo_eth_ioctl)
248 		return -EOPNOTSUPP;
249 
250 	if (!netif_device_present(dev))
251 		return -ENODEV;
252 
253 	return ops->ndo_eth_ioctl(dev, ifr, cmd);
254 }
255 
256 /**
257  * dev_get_hwtstamp_phylib() - Get hardware timestamping settings of NIC
258  *	or of attached phylib PHY
259  * @dev: Network device
260  * @cfg: Timestamping configuration structure
261  *
262  * Helper for enforcing a common policy that phylib timestamping, if available,
263  * should take precedence in front of hardware timestamping provided by the
264  * netdev.
265  *
266  * Note: phy_mii_ioctl() only handles SIOCSHWTSTAMP (not SIOCGHWTSTAMP), and
267  * there only exists a phydev->mii_ts->hwtstamp() method. So this will return
268  * -EOPNOTSUPP for phylib for now, which is still more accurate than letting
269  * the netdev handle the GET request.
270  */
271 static int dev_get_hwtstamp_phylib(struct net_device *dev,
272 				   struct kernel_hwtstamp_config *cfg)
273 {
274 	if (phy_has_hwtstamp(dev->phydev))
275 		return phy_hwtstamp_get(dev->phydev, cfg);
276 
277 	return dev->netdev_ops->ndo_hwtstamp_get(dev, cfg);
278 }
279 
280 static int dev_get_hwtstamp(struct net_device *dev, struct ifreq *ifr)
281 {
282 	const struct net_device_ops *ops = dev->netdev_ops;
283 	struct kernel_hwtstamp_config kernel_cfg = {};
284 	struct hwtstamp_config cfg;
285 	int err;
286 
287 	if (!ops->ndo_hwtstamp_get)
288 		return dev_eth_ioctl(dev, ifr, SIOCGHWTSTAMP); /* legacy */
289 
290 	if (!netif_device_present(dev))
291 		return -ENODEV;
292 
293 	kernel_cfg.ifr = ifr;
294 	err = dev_get_hwtstamp_phylib(dev, &kernel_cfg);
295 	if (err)
296 		return err;
297 
298 	/* If the request was resolved through an unconverted driver, omit
299 	 * the copy_to_user(), since the implementation has already done that
300 	 */
301 	if (!kernel_cfg.copied_to_user) {
302 		hwtstamp_config_from_kernel(&cfg, &kernel_cfg);
303 
304 		if (copy_to_user(ifr->ifr_data, &cfg, sizeof(cfg)))
305 			return -EFAULT;
306 	}
307 
308 	return 0;
309 }
310 
311 /**
312  * dev_set_hwtstamp_phylib() - Change hardware timestamping of NIC
313  *	or of attached phylib PHY
314  * @dev: Network device
315  * @cfg: Timestamping configuration structure
316  * @extack: Netlink extended ack message structure, for error reporting
317  *
318  * Helper for enforcing a common policy that phylib timestamping, if available,
319  * should take precedence in front of hardware timestamping provided by the
320  * netdev. If the netdev driver needs to perform specific actions even for PHY
321  * timestamping to work properly (a switch port must trap the timestamped
322  * frames and not forward them), it must set IFF_SEE_ALL_HWTSTAMP_REQUESTS in
323  * dev->priv_flags.
324  */
325 static int dev_set_hwtstamp_phylib(struct net_device *dev,
326 				   struct kernel_hwtstamp_config *cfg,
327 				   struct netlink_ext_ack *extack)
328 {
329 	const struct net_device_ops *ops = dev->netdev_ops;
330 	bool phy_ts = phy_has_hwtstamp(dev->phydev);
331 	struct kernel_hwtstamp_config old_cfg = {};
332 	bool changed = false;
333 	int err;
334 
335 	cfg->source = phy_ts ? HWTSTAMP_SOURCE_PHYLIB : HWTSTAMP_SOURCE_NETDEV;
336 
337 	if (phy_ts && (dev->priv_flags & IFF_SEE_ALL_HWTSTAMP_REQUESTS)) {
338 		err = ops->ndo_hwtstamp_get(dev, &old_cfg);
339 		if (err)
340 			return err;
341 	}
342 
343 	if (!phy_ts || (dev->priv_flags & IFF_SEE_ALL_HWTSTAMP_REQUESTS)) {
344 		err = ops->ndo_hwtstamp_set(dev, cfg, extack);
345 		if (err) {
346 			if (extack->_msg)
347 				netdev_err(dev, "%s\n", extack->_msg);
348 			return err;
349 		}
350 	}
351 
352 	if (phy_ts && (dev->priv_flags & IFF_SEE_ALL_HWTSTAMP_REQUESTS))
353 		changed = kernel_hwtstamp_config_changed(&old_cfg, cfg);
354 
355 	if (phy_ts) {
356 		err = phy_hwtstamp_set(dev->phydev, cfg, extack);
357 		if (err) {
358 			if (changed)
359 				ops->ndo_hwtstamp_set(dev, &old_cfg, NULL);
360 			return err;
361 		}
362 	}
363 
364 	return 0;
365 }
366 
367 static int dev_set_hwtstamp(struct net_device *dev, struct ifreq *ifr)
368 {
369 	const struct net_device_ops *ops = dev->netdev_ops;
370 	struct kernel_hwtstamp_config kernel_cfg = {};
371 	struct netlink_ext_ack extack = {};
372 	struct hwtstamp_config cfg;
373 	int err;
374 
375 	if (copy_from_user(&cfg, ifr->ifr_data, sizeof(cfg)))
376 		return -EFAULT;
377 
378 	hwtstamp_config_to_kernel(&kernel_cfg, &cfg);
379 	kernel_cfg.ifr = ifr;
380 
381 	err = net_hwtstamp_validate(&kernel_cfg);
382 	if (err)
383 		return err;
384 
385 	err = dsa_master_hwtstamp_validate(dev, &kernel_cfg, &extack);
386 	if (err) {
387 		if (extack._msg)
388 			netdev_err(dev, "%s\n", extack._msg);
389 		return err;
390 	}
391 
392 	if (!ops->ndo_hwtstamp_set)
393 		return dev_eth_ioctl(dev, ifr, SIOCSHWTSTAMP); /* legacy */
394 
395 	if (!netif_device_present(dev))
396 		return -ENODEV;
397 
398 	err = dev_set_hwtstamp_phylib(dev, &kernel_cfg, &extack);
399 	if (err)
400 		return err;
401 
402 	/* The driver may have modified the configuration, so copy the
403 	 * updated version of it back to user space
404 	 */
405 	if (!kernel_cfg.copied_to_user) {
406 		hwtstamp_config_from_kernel(&cfg, &kernel_cfg);
407 
408 		if (copy_to_user(ifr->ifr_data, &cfg, sizeof(cfg)))
409 			return -EFAULT;
410 	}
411 
412 	return 0;
413 }
414 
415 static int generic_hwtstamp_ioctl_lower(struct net_device *dev, int cmd,
416 					struct kernel_hwtstamp_config *kernel_cfg)
417 {
418 	struct ifreq ifrr;
419 	int err;
420 
421 	strscpy_pad(ifrr.ifr_name, dev->name, IFNAMSIZ);
422 	ifrr.ifr_ifru = kernel_cfg->ifr->ifr_ifru;
423 
424 	err = dev_eth_ioctl(dev, &ifrr, cmd);
425 	if (err)
426 		return err;
427 
428 	kernel_cfg->ifr->ifr_ifru = ifrr.ifr_ifru;
429 	kernel_cfg->copied_to_user = true;
430 
431 	return 0;
432 }
433 
434 int generic_hwtstamp_get_lower(struct net_device *dev,
435 			       struct kernel_hwtstamp_config *kernel_cfg)
436 {
437 	const struct net_device_ops *ops = dev->netdev_ops;
438 
439 	if (!netif_device_present(dev))
440 		return -ENODEV;
441 
442 	if (ops->ndo_hwtstamp_get)
443 		return dev_get_hwtstamp_phylib(dev, kernel_cfg);
444 
445 	/* Legacy path: unconverted lower driver */
446 	return generic_hwtstamp_ioctl_lower(dev, SIOCGHWTSTAMP, kernel_cfg);
447 }
448 EXPORT_SYMBOL(generic_hwtstamp_get_lower);
449 
450 int generic_hwtstamp_set_lower(struct net_device *dev,
451 			       struct kernel_hwtstamp_config *kernel_cfg,
452 			       struct netlink_ext_ack *extack)
453 {
454 	const struct net_device_ops *ops = dev->netdev_ops;
455 
456 	if (!netif_device_present(dev))
457 		return -ENODEV;
458 
459 	if (ops->ndo_hwtstamp_set)
460 		return dev_set_hwtstamp_phylib(dev, kernel_cfg, extack);
461 
462 	/* Legacy path: unconverted lower driver */
463 	return generic_hwtstamp_ioctl_lower(dev, SIOCSHWTSTAMP, kernel_cfg);
464 }
465 EXPORT_SYMBOL(generic_hwtstamp_set_lower);
466 
467 static int dev_siocbond(struct net_device *dev,
468 			struct ifreq *ifr, unsigned int cmd)
469 {
470 	const struct net_device_ops *ops = dev->netdev_ops;
471 
472 	if (ops->ndo_siocbond) {
473 		if (netif_device_present(dev))
474 			return ops->ndo_siocbond(dev, ifr, cmd);
475 		else
476 			return -ENODEV;
477 	}
478 
479 	return -EOPNOTSUPP;
480 }
481 
482 static int dev_siocdevprivate(struct net_device *dev, struct ifreq *ifr,
483 			      void __user *data, unsigned int cmd)
484 {
485 	const struct net_device_ops *ops = dev->netdev_ops;
486 
487 	if (ops->ndo_siocdevprivate) {
488 		if (netif_device_present(dev))
489 			return ops->ndo_siocdevprivate(dev, ifr, data, cmd);
490 		else
491 			return -ENODEV;
492 	}
493 
494 	return -EOPNOTSUPP;
495 }
496 
497 static int dev_siocwandev(struct net_device *dev, struct if_settings *ifs)
498 {
499 	const struct net_device_ops *ops = dev->netdev_ops;
500 
501 	if (ops->ndo_siocwandev) {
502 		if (netif_device_present(dev))
503 			return ops->ndo_siocwandev(dev, ifs);
504 		else
505 			return -ENODEV;
506 	}
507 
508 	return -EOPNOTSUPP;
509 }
510 
511 /*
512  *	Perform the SIOCxIFxxx calls, inside rtnl_lock()
513  */
514 static int dev_ifsioc(struct net *net, struct ifreq *ifr, void __user *data,
515 		      unsigned int cmd)
516 {
517 	int err;
518 	struct net_device *dev = __dev_get_by_name(net, ifr->ifr_name);
519 	const struct net_device_ops *ops;
520 	netdevice_tracker dev_tracker;
521 
522 	if (!dev)
523 		return -ENODEV;
524 
525 	ops = dev->netdev_ops;
526 
527 	switch (cmd) {
528 	case SIOCSIFFLAGS:	/* Set interface flags */
529 		return dev_change_flags(dev, ifr->ifr_flags, NULL);
530 
531 	case SIOCSIFMETRIC:	/* Set the metric on the interface
532 				   (currently unused) */
533 		return -EOPNOTSUPP;
534 
535 	case SIOCSIFMTU:	/* Set the MTU of a device */
536 		return dev_set_mtu(dev, ifr->ifr_mtu);
537 
538 	case SIOCSIFHWADDR:
539 		if (dev->addr_len > sizeof(struct sockaddr))
540 			return -EINVAL;
541 		return dev_set_mac_address_user(dev, &ifr->ifr_hwaddr, NULL);
542 
543 	case SIOCSIFHWBROADCAST:
544 		if (ifr->ifr_hwaddr.sa_family != dev->type)
545 			return -EINVAL;
546 		memcpy(dev->broadcast, ifr->ifr_hwaddr.sa_data,
547 		       min(sizeof(ifr->ifr_hwaddr.sa_data_min),
548 			   (size_t)dev->addr_len));
549 		call_netdevice_notifiers(NETDEV_CHANGEADDR, dev);
550 		return 0;
551 
552 	case SIOCSIFMAP:
553 		return dev_setifmap(dev, ifr);
554 
555 	case SIOCADDMULTI:
556 		if (!ops->ndo_set_rx_mode ||
557 		    ifr->ifr_hwaddr.sa_family != AF_UNSPEC)
558 			return -EINVAL;
559 		if (!netif_device_present(dev))
560 			return -ENODEV;
561 		return dev_mc_add_global(dev, ifr->ifr_hwaddr.sa_data);
562 
563 	case SIOCDELMULTI:
564 		if (!ops->ndo_set_rx_mode ||
565 		    ifr->ifr_hwaddr.sa_family != AF_UNSPEC)
566 			return -EINVAL;
567 		if (!netif_device_present(dev))
568 			return -ENODEV;
569 		return dev_mc_del_global(dev, ifr->ifr_hwaddr.sa_data);
570 
571 	case SIOCSIFTXQLEN:
572 		if (ifr->ifr_qlen < 0)
573 			return -EINVAL;
574 		return dev_change_tx_queue_len(dev, ifr->ifr_qlen);
575 
576 	case SIOCSIFNAME:
577 		ifr->ifr_newname[IFNAMSIZ-1] = '\0';
578 		return dev_change_name(dev, ifr->ifr_newname);
579 
580 	case SIOCWANDEV:
581 		return dev_siocwandev(dev, &ifr->ifr_settings);
582 
583 	case SIOCBRADDIF:
584 	case SIOCBRDELIF:
585 		if (!netif_device_present(dev))
586 			return -ENODEV;
587 		if (!netif_is_bridge_master(dev))
588 			return -EOPNOTSUPP;
589 		netdev_hold(dev, &dev_tracker, GFP_KERNEL);
590 		rtnl_unlock();
591 		err = br_ioctl_call(net, netdev_priv(dev), cmd, ifr, NULL);
592 		netdev_put(dev, &dev_tracker);
593 		rtnl_lock();
594 		return err;
595 
596 	case SIOCDEVPRIVATE ... SIOCDEVPRIVATE + 15:
597 		return dev_siocdevprivate(dev, ifr, data, cmd);
598 
599 	case SIOCSHWTSTAMP:
600 		return dev_set_hwtstamp(dev, ifr);
601 
602 	case SIOCGHWTSTAMP:
603 		return dev_get_hwtstamp(dev, ifr);
604 
605 	case SIOCGMIIPHY:
606 	case SIOCGMIIREG:
607 	case SIOCSMIIREG:
608 		return dev_eth_ioctl(dev, ifr, cmd);
609 
610 	case SIOCBONDENSLAVE:
611 	case SIOCBONDRELEASE:
612 	case SIOCBONDSETHWADDR:
613 	case SIOCBONDSLAVEINFOQUERY:
614 	case SIOCBONDINFOQUERY:
615 	case SIOCBONDCHANGEACTIVE:
616 		return dev_siocbond(dev, ifr, cmd);
617 
618 	/* Unknown ioctl */
619 	default:
620 		err = -EINVAL;
621 	}
622 	return err;
623 }
624 
625 /**
626  *	dev_load 	- load a network module
627  *	@net: the applicable net namespace
628  *	@name: name of interface
629  *
630  *	If a network interface is not present and the process has suitable
631  *	privileges this function loads the module. If module loading is not
632  *	available in this kernel then it becomes a nop.
633  */
634 
635 void dev_load(struct net *net, const char *name)
636 {
637 	struct net_device *dev;
638 	int no_module;
639 
640 	rcu_read_lock();
641 	dev = dev_get_by_name_rcu(net, name);
642 	rcu_read_unlock();
643 
644 	no_module = !dev;
645 	if (no_module && capable(CAP_NET_ADMIN))
646 		no_module = request_module("netdev-%s", name);
647 	if (no_module && capable(CAP_SYS_MODULE))
648 		request_module("%s", name);
649 }
650 EXPORT_SYMBOL(dev_load);
651 
652 /*
653  *	This function handles all "interface"-type I/O control requests. The actual
654  *	'doing' part of this is dev_ifsioc above.
655  */
656 
657 /**
658  *	dev_ioctl	-	network device ioctl
659  *	@net: the applicable net namespace
660  *	@cmd: command to issue
661  *	@ifr: pointer to a struct ifreq in user space
662  *	@data: data exchanged with userspace
663  *	@need_copyout: whether or not copy_to_user() should be called
664  *
665  *	Issue ioctl functions to devices. This is normally called by the
666  *	user space syscall interfaces but can sometimes be useful for
667  *	other purposes. The return value is the return from the syscall if
668  *	positive or a negative errno code on error.
669  */
670 
671 int dev_ioctl(struct net *net, unsigned int cmd, struct ifreq *ifr,
672 	      void __user *data, bool *need_copyout)
673 {
674 	int ret;
675 	char *colon;
676 
677 	if (need_copyout)
678 		*need_copyout = true;
679 	if (cmd == SIOCGIFNAME)
680 		return dev_ifname(net, ifr);
681 
682 	ifr->ifr_name[IFNAMSIZ-1] = 0;
683 
684 	colon = strchr(ifr->ifr_name, ':');
685 	if (colon)
686 		*colon = 0;
687 
688 	/*
689 	 *	See which interface the caller is talking about.
690 	 */
691 
692 	switch (cmd) {
693 	case SIOCGIFHWADDR:
694 		dev_load(net, ifr->ifr_name);
695 		ret = dev_get_mac_address(&ifr->ifr_hwaddr, net, ifr->ifr_name);
696 		if (colon)
697 			*colon = ':';
698 		return ret;
699 	/*
700 	 *	These ioctl calls:
701 	 *	- can be done by all.
702 	 *	- atomic and do not require locking.
703 	 *	- return a value
704 	 */
705 	case SIOCGIFFLAGS:
706 	case SIOCGIFMETRIC:
707 	case SIOCGIFMTU:
708 	case SIOCGIFSLAVE:
709 	case SIOCGIFMAP:
710 	case SIOCGIFINDEX:
711 	case SIOCGIFTXQLEN:
712 		dev_load(net, ifr->ifr_name);
713 		rcu_read_lock();
714 		ret = dev_ifsioc_locked(net, ifr, cmd);
715 		rcu_read_unlock();
716 		if (colon)
717 			*colon = ':';
718 		return ret;
719 
720 	case SIOCETHTOOL:
721 		dev_load(net, ifr->ifr_name);
722 		ret = dev_ethtool(net, ifr, data);
723 		if (colon)
724 			*colon = ':';
725 		return ret;
726 
727 	/*
728 	 *	These ioctl calls:
729 	 *	- require superuser power.
730 	 *	- require strict serialization.
731 	 *	- return a value
732 	 */
733 	case SIOCGMIIPHY:
734 	case SIOCGMIIREG:
735 	case SIOCSIFNAME:
736 		dev_load(net, ifr->ifr_name);
737 		if (!ns_capable(net->user_ns, CAP_NET_ADMIN))
738 			return -EPERM;
739 		rtnl_lock();
740 		ret = dev_ifsioc(net, ifr, data, cmd);
741 		rtnl_unlock();
742 		if (colon)
743 			*colon = ':';
744 		return ret;
745 
746 	/*
747 	 *	These ioctl calls:
748 	 *	- require superuser power.
749 	 *	- require strict serialization.
750 	 *	- do not return a value
751 	 */
752 	case SIOCSIFMAP:
753 	case SIOCSIFTXQLEN:
754 		if (!capable(CAP_NET_ADMIN))
755 			return -EPERM;
756 		fallthrough;
757 	/*
758 	 *	These ioctl calls:
759 	 *	- require local superuser power.
760 	 *	- require strict serialization.
761 	 *	- do not return a value
762 	 */
763 	case SIOCSIFFLAGS:
764 	case SIOCSIFMETRIC:
765 	case SIOCSIFMTU:
766 	case SIOCSIFHWADDR:
767 	case SIOCSIFSLAVE:
768 	case SIOCADDMULTI:
769 	case SIOCDELMULTI:
770 	case SIOCSIFHWBROADCAST:
771 	case SIOCSMIIREG:
772 	case SIOCBONDENSLAVE:
773 	case SIOCBONDRELEASE:
774 	case SIOCBONDSETHWADDR:
775 	case SIOCBONDCHANGEACTIVE:
776 	case SIOCBRADDIF:
777 	case SIOCBRDELIF:
778 	case SIOCSHWTSTAMP:
779 		if (!ns_capable(net->user_ns, CAP_NET_ADMIN))
780 			return -EPERM;
781 		fallthrough;
782 	case SIOCBONDSLAVEINFOQUERY:
783 	case SIOCBONDINFOQUERY:
784 		dev_load(net, ifr->ifr_name);
785 		rtnl_lock();
786 		ret = dev_ifsioc(net, ifr, data, cmd);
787 		rtnl_unlock();
788 		if (need_copyout)
789 			*need_copyout = false;
790 		return ret;
791 
792 	case SIOCGIFMEM:
793 		/* Get the per device memory space. We can add this but
794 		 * currently do not support it */
795 	case SIOCSIFMEM:
796 		/* Set the per device memory buffer space.
797 		 * Not applicable in our case */
798 	case SIOCSIFLINK:
799 		return -ENOTTY;
800 
801 	/*
802 	 *	Unknown or private ioctl.
803 	 */
804 	default:
805 		if (cmd == SIOCWANDEV ||
806 		    cmd == SIOCGHWTSTAMP ||
807 		    (cmd >= SIOCDEVPRIVATE &&
808 		     cmd <= SIOCDEVPRIVATE + 15)) {
809 			dev_load(net, ifr->ifr_name);
810 			rtnl_lock();
811 			ret = dev_ifsioc(net, ifr, data, cmd);
812 			rtnl_unlock();
813 			return ret;
814 		}
815 		return -ENOTTY;
816 	}
817 }
818