ethtool.c 44.1 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5
/*
 * net/core/ethtool.c - Ethtool ioctl handler
 * Copyright (c) 2003 Matthew Wilcox <matthew@wil.cx>
 *
 * This file is where we call all the ethtool_ops commands to get
6
 * the information ethtool needs.
L
Linus Torvalds 已提交
7
 *
8 9 10 11
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
L
Linus Torvalds 已提交
12 13 14 15
 */

#include <linux/module.h>
#include <linux/types.h>
16
#include <linux/capability.h>
L
Linus Torvalds 已提交
17 18 19
#include <linux/errno.h>
#include <linux/ethtool.h>
#include <linux/netdevice.h>
20
#include <linux/bitops.h>
21
#include <linux/uaccess.h>
22
#include <linux/vmalloc.h>
23
#include <linux/slab.h>
24 25
#include <linux/rtnetlink.h>
#include <linux/sched.h>
L
Linus Torvalds 已提交
26

27
/*
L
Linus Torvalds 已提交
28 29 30 31 32 33 34 35 36
 * Some useful ethtool_ops methods that're device independent.
 * If we find that all drivers want to do the same thing here,
 * we can turn these into dev_() function calls.
 */

u32 ethtool_op_get_link(struct net_device *dev)
{
	return netif_carrier_ok(dev) ? 1 : 0;
}
37
EXPORT_SYMBOL(ethtool_op_get_link);
L
Linus Torvalds 已提交
38 39 40

u32 ethtool_op_get_tx_csum(struct net_device *dev)
{
41
	return (dev->features & NETIF_F_ALL_CSUM) != 0;
L
Linus Torvalds 已提交
42
}
43
EXPORT_SYMBOL(ethtool_op_get_tx_csum);
L
Linus Torvalds 已提交
44 45 46 47 48 49 50 51 52 53

int ethtool_op_set_tx_csum(struct net_device *dev, u32 data)
{
	if (data)
		dev->features |= NETIF_F_IP_CSUM;
	else
		dev->features &= ~NETIF_F_IP_CSUM;

	return 0;
}
54
EXPORT_SYMBOL(ethtool_op_set_tx_csum);
L
Linus Torvalds 已提交
55

56 57 58 59 60 61 62 63 64
int ethtool_op_set_tx_hw_csum(struct net_device *dev, u32 data)
{
	if (data)
		dev->features |= NETIF_F_HW_CSUM;
	else
		dev->features &= ~NETIF_F_HW_CSUM;

	return 0;
}
65
EXPORT_SYMBOL(ethtool_op_set_tx_hw_csum);
66 67 68 69 70 71 72 73 74 75

int ethtool_op_set_tx_ipv6_csum(struct net_device *dev, u32 data)
{
	if (data)
		dev->features |= NETIF_F_IP_CSUM | NETIF_F_IPV6_CSUM;
	else
		dev->features &= ~(NETIF_F_IP_CSUM | NETIF_F_IPV6_CSUM);

	return 0;
}
76
EXPORT_SYMBOL(ethtool_op_set_tx_ipv6_csum);
77

L
Linus Torvalds 已提交
78 79 80 81
u32 ethtool_op_get_sg(struct net_device *dev)
{
	return (dev->features & NETIF_F_SG) != 0;
}
82
EXPORT_SYMBOL(ethtool_op_get_sg);
L
Linus Torvalds 已提交
83 84 85 86 87 88 89 90 91 92

int ethtool_op_set_sg(struct net_device *dev, u32 data)
{
	if (data)
		dev->features |= NETIF_F_SG;
	else
		dev->features &= ~NETIF_F_SG;

	return 0;
}
93
EXPORT_SYMBOL(ethtool_op_set_sg);
L
Linus Torvalds 已提交
94 95 96 97 98

u32 ethtool_op_get_tso(struct net_device *dev)
{
	return (dev->features & NETIF_F_TSO) != 0;
}
99
EXPORT_SYMBOL(ethtool_op_get_tso);
L
Linus Torvalds 已提交
100 101 102 103 104 105 106 107 108 109

int ethtool_op_set_tso(struct net_device *dev, u32 data)
{
	if (data)
		dev->features |= NETIF_F_TSO;
	else
		dev->features &= ~NETIF_F_TSO;

	return 0;
}
110
EXPORT_SYMBOL(ethtool_op_set_tso);
L
Linus Torvalds 已提交
111

112 113 114 115
u32 ethtool_op_get_ufo(struct net_device *dev)
{
	return (dev->features & NETIF_F_UFO) != 0;
}
116
EXPORT_SYMBOL(ethtool_op_get_ufo);
117 118 119 120 121 122 123 124 125

int ethtool_op_set_ufo(struct net_device *dev, u32 data)
{
	if (data)
		dev->features |= NETIF_F_UFO;
	else
		dev->features &= ~NETIF_F_UFO;
	return 0;
}
126
EXPORT_SYMBOL(ethtool_op_set_ufo);
127

128 129 130 131
/* the following list of flags are the same as their associated
 * NETIF_F_xxx values in include/linux/netdevice.h
 */
static const u32 flags_dup_features =
132 133
	(ETH_FLAG_LRO | ETH_FLAG_RXVLAN | ETH_FLAG_TXVLAN | ETH_FLAG_NTUPLE |
	 ETH_FLAG_RXHASH);
134 135 136 137 138 139 140 141 142 143

u32 ethtool_op_get_flags(struct net_device *dev)
{
	/* in the future, this function will probably contain additional
	 * handling for flags which are not so easily handled
	 * by a simple masking operation
	 */

	return dev->features & flags_dup_features;
}
144
EXPORT_SYMBOL(ethtool_op_get_flags);
145

146 147 148 149 150 151 152 153 154 155 156 157 158 159 160
/* Check if device can enable (or disable) particular feature coded in "data"
 * argument. Flags "supported" describe features that can be toggled by device.
 * If feature can not be toggled, it state (enabled or disabled) must match
 * hardcoded device features state, otherwise flags are marked as invalid.
 */
bool ethtool_invalid_flags(struct net_device *dev, u32 data, u32 supported)
{
	u32 features = dev->features & flags_dup_features;
	/* "data" can contain only flags_dup_features bits,
	 * see __ethtool_set_flags */

	return (features & ~supported) != (data & ~supported);
}
EXPORT_SYMBOL(ethtool_invalid_flags);

161
int ethtool_op_set_flags(struct net_device *dev, u32 data, u32 supported)
162
{
163
	if (ethtool_invalid_flags(dev, data, supported))
164
		return -EINVAL;
165

166 167
	dev->features = ((dev->features & ~flags_dup_features) |
			 (data & flags_dup_features));
168 169
	return 0;
}
170
EXPORT_SYMBOL(ethtool_op_set_flags);
171

L
Linus Torvalds 已提交
172 173
/* Handlers for each ethtool command */

174 175
#define ETHTOOL_DEV_FEATURE_WORDS	1

176 177 178 179 180 181 182 183 184 185
static void ethtool_get_features_compat(struct net_device *dev,
	struct ethtool_get_features_block *features)
{
	if (!dev->ethtool_ops)
		return;

	/* getting RX checksum */
	if (dev->ethtool_ops->get_rx_csum)
		if (dev->ethtool_ops->get_rx_csum(dev))
			features[0].active |= NETIF_F_RXCSUM;
186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223

	/* mark legacy-changeable features */
	if (dev->ethtool_ops->set_sg)
		features[0].available |= NETIF_F_SG;
	if (dev->ethtool_ops->set_tx_csum)
		features[0].available |= NETIF_F_ALL_CSUM;
	if (dev->ethtool_ops->set_tso)
		features[0].available |= NETIF_F_ALL_TSO;
	if (dev->ethtool_ops->set_rx_csum)
		features[0].available |= NETIF_F_RXCSUM;
	if (dev->ethtool_ops->set_flags)
		features[0].available |= flags_dup_features;
}

static int ethtool_set_feature_compat(struct net_device *dev,
	int (*legacy_set)(struct net_device *, u32),
	struct ethtool_set_features_block *features, u32 mask)
{
	u32 do_set;

	if (!legacy_set)
		return 0;

	if (!(features[0].valid & mask))
		return 0;

	features[0].valid &= ~mask;

	do_set = !!(features[0].requested & mask);

	if (legacy_set(dev, do_set) < 0)
		netdev_info(dev,
			"Legacy feature change (%s) failed for 0x%08x\n",
			do_set ? "set" : "clear", mask);

	return 1;
}

224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246
static int ethtool_set_flags_compat(struct net_device *dev,
	int (*legacy_set)(struct net_device *, u32),
	struct ethtool_set_features_block *features, u32 mask)
{
	u32 value;

	if (!legacy_set)
		return 0;

	if (!(features[0].valid & mask))
		return 0;

	value = dev->features & ~features[0].valid;
	value |= features[0].requested;

	features[0].valid &= ~mask;

	if (legacy_set(dev, value & mask) < 0)
		netdev_info(dev, "Legacy flags change failed\n");

	return 1;
}

247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262
static int ethtool_set_features_compat(struct net_device *dev,
	struct ethtool_set_features_block *features)
{
	int compat;

	if (!dev->ethtool_ops)
		return 0;

	compat  = ethtool_set_feature_compat(dev, dev->ethtool_ops->set_sg,
		features, NETIF_F_SG);
	compat |= ethtool_set_feature_compat(dev, dev->ethtool_ops->set_tx_csum,
		features, NETIF_F_ALL_CSUM);
	compat |= ethtool_set_feature_compat(dev, dev->ethtool_ops->set_tso,
		features, NETIF_F_ALL_TSO);
	compat |= ethtool_set_feature_compat(dev, dev->ethtool_ops->set_rx_csum,
		features, NETIF_F_RXCSUM);
263
	compat |= ethtool_set_flags_compat(dev, dev->ethtool_ops->set_flags,
264 265 266
		features, flags_dup_features);

	return compat;
267 268
}

269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285
static int ethtool_get_features(struct net_device *dev, void __user *useraddr)
{
	struct ethtool_gfeatures cmd = {
		.cmd = ETHTOOL_GFEATURES,
		.size = ETHTOOL_DEV_FEATURE_WORDS,
	};
	struct ethtool_get_features_block features[ETHTOOL_DEV_FEATURE_WORDS] = {
		{
			.available = dev->hw_features,
			.requested = dev->wanted_features,
			.active = dev->features,
			.never_changed = NETIF_F_NEVER_CHANGE,
		},
	};
	u32 __user *sizeaddr;
	u32 copy_size;

286 287
	ethtool_get_features_compat(dev, features);

288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322
	sizeaddr = useraddr + offsetof(struct ethtool_gfeatures, size);
	if (get_user(copy_size, sizeaddr))
		return -EFAULT;

	if (copy_size > ETHTOOL_DEV_FEATURE_WORDS)
		copy_size = ETHTOOL_DEV_FEATURE_WORDS;

	if (copy_to_user(useraddr, &cmd, sizeof(cmd)))
		return -EFAULT;
	useraddr += sizeof(cmd);
	if (copy_to_user(useraddr, features, copy_size * sizeof(*features)))
		return -EFAULT;

	return 0;
}

static int ethtool_set_features(struct net_device *dev, void __user *useraddr)
{
	struct ethtool_sfeatures cmd;
	struct ethtool_set_features_block features[ETHTOOL_DEV_FEATURE_WORDS];
	int ret = 0;

	if (copy_from_user(&cmd, useraddr, sizeof(cmd)))
		return -EFAULT;
	useraddr += sizeof(cmd);

	if (cmd.size != ETHTOOL_DEV_FEATURE_WORDS)
		return -EINVAL;

	if (copy_from_user(features, useraddr, sizeof(features)))
		return -EFAULT;

	if (features[0].valid & ~NETIF_F_ETHTOOL_BITS)
		return -EINVAL;

323 324 325
	if (ethtool_set_features_compat(dev, features))
		ret |= ETHTOOL_F_COMPAT;

326 327 328 329 330 331 332
	if (features[0].valid & ~dev->hw_features) {
		features[0].valid &= dev->hw_features;
		ret |= ETHTOOL_F_UNSUPPORTED;
	}

	dev->wanted_features &= ~features[0].valid;
	dev->wanted_features |= features[0].valid & features[0].requested;
333
	__netdev_update_features(dev);
334 335 336 337 338 339 340 341 342 343 344 345

	if ((dev->wanted_features ^ dev->features) & features[0].valid)
		ret |= ETHTOOL_F_WISH;

	return ret;
}

static const char netdev_features_strings[ETHTOOL_DEV_FEATURE_WORDS * 32][ETH_GSTRING_LEN] = {
	/* NETIF_F_SG */              "tx-scatter-gather",
	/* NETIF_F_IP_CSUM */         "tx-checksum-ipv4",
	/* NETIF_F_NO_CSUM */         "tx-checksum-unneeded",
	/* NETIF_F_HW_CSUM */         "tx-checksum-ip-generic",
346
	/* NETIF_F_IPV6_CSUM */       "tx-checksum-ipv6",
347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373
	/* NETIF_F_HIGHDMA */         "highdma",
	/* NETIF_F_FRAGLIST */        "tx-scatter-gather-fraglist",
	/* NETIF_F_HW_VLAN_TX */      "tx-vlan-hw-insert",

	/* NETIF_F_HW_VLAN_RX */      "rx-vlan-hw-parse",
	/* NETIF_F_HW_VLAN_FILTER */  "rx-vlan-filter",
	/* NETIF_F_VLAN_CHALLENGED */ "vlan-challenged",
	/* NETIF_F_GSO */             "tx-generic-segmentation",
	/* NETIF_F_LLTX */            "tx-lockless",
	/* NETIF_F_NETNS_LOCAL */     "netns-local",
	/* NETIF_F_GRO */             "rx-gro",
	/* NETIF_F_LRO */             "rx-lro",

	/* NETIF_F_TSO */             "tx-tcp-segmentation",
	/* NETIF_F_UFO */             "tx-udp-fragmentation",
	/* NETIF_F_GSO_ROBUST */      "tx-gso-robust",
	/* NETIF_F_TSO_ECN */         "tx-tcp-ecn-segmentation",
	/* NETIF_F_TSO6 */            "tx-tcp6-segmentation",
	/* NETIF_F_FSO */             "tx-fcoe-segmentation",
	"",
	"",

	/* NETIF_F_FCOE_CRC */        "tx-checksum-fcoe-crc",
	/* NETIF_F_SCTP_CSUM */       "tx-checksum-sctp",
	/* NETIF_F_FCOE_MTU */        "fcoe-mtu",
	/* NETIF_F_NTUPLE */          "rx-ntuple-filter",
	/* NETIF_F_RXHASH */          "rx-hashing",
374
	/* NETIF_F_RXCSUM */          "rx-checksum",
375
	/* NETIF_F_NOCACHE_COPY */    "tx-nocache-copy",
376
	/* NETIF_F_LOOPBACK */        "loopback",
377 378
};

379 380 381 382
static int __ethtool_get_sset_count(struct net_device *dev, int sset)
{
	const struct ethtool_ops *ops = dev->ethtool_ops;

383 384 385
	if (sset == ETH_SS_FEATURES)
		return ARRAY_SIZE(netdev_features_strings);

386 387 388 389 390 391 392 393 394 395 396
	if (ops && ops->get_sset_count && ops->get_strings)
		return ops->get_sset_count(dev, sset);
	else
		return -EOPNOTSUPP;
}

static void __ethtool_get_strings(struct net_device *dev,
	u32 stringset, u8 *data)
{
	const struct ethtool_ops *ops = dev->ethtool_ops;

397 398 399 400 401 402
	if (stringset == ETH_SS_FEATURES)
		memcpy(data, netdev_features_strings,
			sizeof(netdev_features_strings));
	else
		/* ops->get_strings is valid because checked earlier */
		ops->get_strings(dev, stringset, data);
403 404
}

405 406 407 408 409 410 411 412
static u32 ethtool_get_feature_mask(u32 eth_cmd)
{
	/* feature masks of legacy discrete ethtool ops */

	switch (eth_cmd) {
	case ETHTOOL_GTXCSUM:
	case ETHTOOL_STXCSUM:
		return NETIF_F_ALL_CSUM | NETIF_F_SCTP_CSUM;
413 414 415
	case ETHTOOL_GRXCSUM:
	case ETHTOOL_SRXCSUM:
		return NETIF_F_RXCSUM;
416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445
	case ETHTOOL_GSG:
	case ETHTOOL_SSG:
		return NETIF_F_SG;
	case ETHTOOL_GTSO:
	case ETHTOOL_STSO:
		return NETIF_F_ALL_TSO;
	case ETHTOOL_GUFO:
	case ETHTOOL_SUFO:
		return NETIF_F_UFO;
	case ETHTOOL_GGSO:
	case ETHTOOL_SGSO:
		return NETIF_F_GSO;
	case ETHTOOL_GGRO:
	case ETHTOOL_SGRO:
		return NETIF_F_GRO;
	default:
		BUG();
	}
}

static void *__ethtool_get_one_feature_actor(struct net_device *dev, u32 ethcmd)
{
	const struct ethtool_ops *ops = dev->ethtool_ops;

	if (!ops)
		return NULL;

	switch (ethcmd) {
	case ETHTOOL_GTXCSUM:
		return ops->get_tx_csum;
446 447
	case ETHTOOL_GRXCSUM:
		return ops->get_rx_csum;
448 449 450 451 452 453 454 455 456 457 458
	case ETHTOOL_SSG:
		return ops->get_sg;
	case ETHTOOL_STSO:
		return ops->get_tso;
	case ETHTOOL_SUFO:
		return ops->get_ufo;
	default:
		return NULL;
	}
}

459 460 461 462 463
static u32 __ethtool_get_rx_csum_oldbug(struct net_device *dev)
{
	return !!(dev->features & NETIF_F_ALL_CSUM);
}

464 465 466
static int ethtool_get_one_feature(struct net_device *dev,
	char __user *useraddr, u32 ethcmd)
{
467
	u32 mask = ethtool_get_feature_mask(ethcmd);
468 469
	struct ethtool_value edata = {
		.cmd = ethcmd,
470
		.data = !!(dev->features & mask),
471 472
	};

473 474 475 476 477 478
	/* compatibility with discrete get_ ops */
	if (!(dev->hw_features & mask)) {
		u32 (*actor)(struct net_device *);

		actor = __ethtool_get_one_feature_actor(dev, ethcmd);

479 480 481 482
		/* bug compatibility with old get_rx_csum */
		if (ethcmd == ETHTOOL_GRXCSUM && !actor)
			actor = __ethtool_get_rx_csum_oldbug;

483 484 485
		if (actor)
			edata.data = actor(dev);
	}
486 487 488 489 490 491 492

	if (copy_to_user(useraddr, &edata, sizeof(edata)))
		return -EFAULT;
	return 0;
}

static int __ethtool_set_tx_csum(struct net_device *dev, u32 data);
493
static int __ethtool_set_rx_csum(struct net_device *dev, u32 data);
494 495 496 497 498 499 500 501 502 503 504 505 506
static int __ethtool_set_sg(struct net_device *dev, u32 data);
static int __ethtool_set_tso(struct net_device *dev, u32 data);
static int __ethtool_set_ufo(struct net_device *dev, u32 data);

static int ethtool_set_one_feature(struct net_device *dev,
	void __user *useraddr, u32 ethcmd)
{
	struct ethtool_value edata;
	u32 mask;

	if (copy_from_user(&edata, useraddr, sizeof(edata)))
		return -EFAULT;

507 508 509 510 511 512 513 514
	mask = ethtool_get_feature_mask(ethcmd);
	mask &= dev->hw_features;
	if (mask) {
		if (edata.data)
			dev->wanted_features |= mask;
		else
			dev->wanted_features &= ~mask;

515
		__netdev_update_features(dev);
516 517 518 519 520 521 522 523 524 525 526 527
		return 0;
	}

	/* Driver is not converted to ndo_fix_features or does not
	 * support changing this offload. In the latter case it won't
	 * have corresponding ethtool_ops field set.
	 *
	 * Following part is to be removed after all drivers advertise
	 * their changeable features in netdev->hw_features and stop
	 * using discrete offload setting ops.
	 */

528 529 530
	switch (ethcmd) {
	case ETHTOOL_STXCSUM:
		return __ethtool_set_tx_csum(dev, edata.data);
531 532
	case ETHTOOL_SRXCSUM:
		return __ethtool_set_rx_csum(dev, edata.data);
533 534 535 536 537 538 539 540 541 542 543
	case ETHTOOL_SSG:
		return __ethtool_set_sg(dev, edata.data);
	case ETHTOOL_STSO:
		return __ethtool_set_tso(dev, edata.data);
	case ETHTOOL_SUFO:
		return __ethtool_set_ufo(dev, edata.data);
	default:
		return -EOPNOTSUPP;
	}
}

544
int __ethtool_set_flags(struct net_device *dev, u32 data)
545 546 547 548 549 550 551 552 553 554 555 556 557 558 559
{
	u32 changed;

	if (data & ~flags_dup_features)
		return -EINVAL;

	/* legacy set_flags() op */
	if (dev->ethtool_ops->set_flags) {
		if (unlikely(dev->hw_features & flags_dup_features))
			netdev_warn(dev,
				"driver BUG: mixed hw_features and set_flags()\n");
		return dev->ethtool_ops->set_flags(dev, data);
	}

	/* allow changing only bits set in hw_features */
560
	changed = (data ^ dev->features) & flags_dup_features;
561 562 563 564
	if (changed & ~dev->hw_features)
		return (changed & dev->hw_features) ? -EINVAL : -EOPNOTSUPP;

	dev->wanted_features =
565
		(dev->wanted_features & ~changed) | (data & dev->hw_features);
566

567
	__netdev_update_features(dev);
568 569 570 571

	return 0;
}

L
Linus Torvalds 已提交
572 573
static int ethtool_get_settings(struct net_device *dev, void __user *useraddr)
{
574
	struct ethtool_cmd cmd = { .cmd = ETHTOOL_GSET };
L
Linus Torvalds 已提交
575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601
	int err;

	if (!dev->ethtool_ops->get_settings)
		return -EOPNOTSUPP;

	err = dev->ethtool_ops->get_settings(dev, &cmd);
	if (err < 0)
		return err;

	if (copy_to_user(useraddr, &cmd, sizeof(cmd)))
		return -EFAULT;
	return 0;
}

static int ethtool_set_settings(struct net_device *dev, void __user *useraddr)
{
	struct ethtool_cmd cmd;

	if (!dev->ethtool_ops->set_settings)
		return -EOPNOTSUPP;

	if (copy_from_user(&cmd, useraddr, sizeof(cmd)))
		return -EFAULT;

	return dev->ethtool_ops->set_settings(dev, &cmd);
}

602 603
static noinline_for_stack int ethtool_get_drvinfo(struct net_device *dev,
						  void __user *useraddr)
L
Linus Torvalds 已提交
604 605
{
	struct ethtool_drvinfo info;
606
	const struct ethtool_ops *ops = dev->ethtool_ops;
L
Linus Torvalds 已提交
607 608 609

	memset(&info, 0, sizeof(info));
	info.cmd = ETHTOOL_GDRVINFO;
610 611 612 613 614 615 616 617 618 619
	if (ops && ops->get_drvinfo) {
		ops->get_drvinfo(dev, &info);
	} else if (dev->dev.parent && dev->dev.parent->driver) {
		strlcpy(info.bus_info, dev_name(dev->dev.parent),
			sizeof(info.bus_info));
		strlcpy(info.driver, dev->dev.parent->driver->name,
			sizeof(info.driver));
	} else {
		return -EOPNOTSUPP;
	}
L
Linus Torvalds 已提交
620

621 622
	/*
	 * this method of obtaining string set info is deprecated;
623
	 * Use ETHTOOL_GSSET_INFO instead.
624
	 */
625
	if (ops && ops->get_sset_count) {
626 627 628 629 630 631 632 633
		int rc;

		rc = ops->get_sset_count(dev, ETH_SS_TEST);
		if (rc >= 0)
			info.testinfo_len = rc;
		rc = ops->get_sset_count(dev, ETH_SS_STATS);
		if (rc >= 0)
			info.n_stats = rc;
634 635 636
		rc = ops->get_sset_count(dev, ETH_SS_PRIV_FLAGS);
		if (rc >= 0)
			info.n_priv_flags = rc;
637
	}
638
	if (ops && ops->get_regs_len)
L
Linus Torvalds 已提交
639
		info.regdump_len = ops->get_regs_len(dev);
640
	if (ops && ops->get_eeprom_len)
L
Linus Torvalds 已提交
641 642 643 644 645 646 647
		info.eedump_len = ops->get_eeprom_len(dev);

	if (copy_to_user(useraddr, &info, sizeof(info)))
		return -EFAULT;
	return 0;
}

E
Eric Dumazet 已提交
648
static noinline_for_stack int ethtool_get_sset_info(struct net_device *dev,
649
						    void __user *useraddr)
650 651 652 653 654 655 656 657 658 659 660 661 662 663 664
{
	struct ethtool_sset_info info;
	u64 sset_mask;
	int i, idx = 0, n_bits = 0, ret, rc;
	u32 *info_buf = NULL;

	if (copy_from_user(&info, useraddr, sizeof(info)))
		return -EFAULT;

	/* store copy of mask, because we zero struct later on */
	sset_mask = info.sset_mask;
	if (!sset_mask)
		return 0;

	/* calculate size of return buffer */
665
	n_bits = hweight64(sset_mask);
666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681

	memset(&info, 0, sizeof(info));
	info.cmd = ETHTOOL_GSSET_INFO;

	info_buf = kzalloc(n_bits * sizeof(u32), GFP_USER);
	if (!info_buf)
		return -ENOMEM;

	/*
	 * fill return buffer based on input bitmask and successful
	 * get_sset_count return
	 */
	for (i = 0; i < 64; i++) {
		if (!(sset_mask & (1ULL << i)))
			continue;

682
		rc = __ethtool_get_sset_count(dev, i);
683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703
		if (rc >= 0) {
			info.sset_mask |= (1ULL << i);
			info_buf[idx++] = rc;
		}
	}

	ret = -EFAULT;
	if (copy_to_user(useraddr, &info, sizeof(info)))
		goto out;

	useraddr += offsetof(struct ethtool_sset_info, data);
	if (copy_to_user(useraddr, info_buf, idx * sizeof(u32)))
		goto out;

	ret = 0;

out:
	kfree(info_buf);
	return ret;
}

704
static noinline_for_stack int ethtool_set_rxnfc(struct net_device *dev,
705
						u32 cmd, void __user *useraddr)
706
{
707 708
	struct ethtool_rxnfc info;
	size_t info_size = sizeof(info);
709

710
	if (!dev->ethtool_ops->set_rxnfc)
711 712
		return -EOPNOTSUPP;

713 714 715 716 717 718 719 720 721
	/* struct ethtool_rxnfc was originally defined for
	 * ETHTOOL_{G,S}RXFH with only the cmd, flow_type and data
	 * members.  User-space might still be using that
	 * definition. */
	if (cmd == ETHTOOL_SRXFH)
		info_size = (offsetof(struct ethtool_rxnfc, data) +
			     sizeof(info.data));

	if (copy_from_user(&info, useraddr, info_size))
722 723
		return -EFAULT;

724
	return dev->ethtool_ops->set_rxnfc(dev, &info);
725 726
}

727
static noinline_for_stack int ethtool_get_rxnfc(struct net_device *dev,
728
						u32 cmd, void __user *useraddr)
729 730
{
	struct ethtool_rxnfc info;
731
	size_t info_size = sizeof(info);
732 733 734
	const struct ethtool_ops *ops = dev->ethtool_ops;
	int ret;
	void *rule_buf = NULL;
735

736
	if (!ops->get_rxnfc)
737 738
		return -EOPNOTSUPP;

739 740 741 742 743 744 745 746 747
	/* struct ethtool_rxnfc was originally defined for
	 * ETHTOOL_{G,S}RXFH with only the cmd, flow_type and data
	 * members.  User-space might still be using that
	 * definition. */
	if (cmd == ETHTOOL_GRXFH)
		info_size = (offsetof(struct ethtool_rxnfc, data) +
			     sizeof(info.data));

	if (copy_from_user(&info, useraddr, info_size))
748 749
		return -EFAULT;

750 751
	if (info.cmd == ETHTOOL_GRXCLSRLALL) {
		if (info.rule_cnt > 0) {
752
			if (info.rule_cnt <= KMALLOC_MAX_SIZE / sizeof(u32))
753
				rule_buf = kzalloc(info.rule_cnt * sizeof(u32),
754
						   GFP_USER);
755 756 757 758
			if (!rule_buf)
				return -ENOMEM;
		}
	}
759

760 761 762 763 764
	ret = ops->get_rxnfc(dev, &info, rule_buf);
	if (ret < 0)
		goto err_out;

	ret = -EFAULT;
765
	if (copy_to_user(useraddr, &info, info_size))
766 767 768 769 770 771 772 773 774 775 776
		goto err_out;

	if (rule_buf) {
		useraddr += offsetof(struct ethtool_rxnfc, rule_locs);
		if (copy_to_user(useraddr, rule_buf,
				 info.rule_cnt * sizeof(u32)))
			goto err_out;
	}
	ret = 0;

err_out:
777
	kfree(rule_buf);
778 779

	return ret;
780 781
}

782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801
static noinline_for_stack int ethtool_get_rxfh_indir(struct net_device *dev,
						     void __user *useraddr)
{
	struct ethtool_rxfh_indir *indir;
	u32 table_size;
	size_t full_size;
	int ret;

	if (!dev->ethtool_ops->get_rxfh_indir)
		return -EOPNOTSUPP;

	if (copy_from_user(&table_size,
			   useraddr + offsetof(struct ethtool_rxfh_indir, size),
			   sizeof(table_size)))
		return -EFAULT;

	if (table_size >
	    (KMALLOC_MAX_SIZE - sizeof(*indir)) / sizeof(*indir->ring_index))
		return -ENOMEM;
	full_size = sizeof(*indir) + sizeof(*indir->ring_index) * table_size;
802
	indir = kzalloc(full_size, GFP_USER);
803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855
	if (!indir)
		return -ENOMEM;

	indir->cmd = ETHTOOL_GRXFHINDIR;
	indir->size = table_size;
	ret = dev->ethtool_ops->get_rxfh_indir(dev, indir);
	if (ret)
		goto out;

	if (copy_to_user(useraddr, indir, full_size))
		ret = -EFAULT;

out:
	kfree(indir);
	return ret;
}

static noinline_for_stack int ethtool_set_rxfh_indir(struct net_device *dev,
						     void __user *useraddr)
{
	struct ethtool_rxfh_indir *indir;
	u32 table_size;
	size_t full_size;
	int ret;

	if (!dev->ethtool_ops->set_rxfh_indir)
		return -EOPNOTSUPP;

	if (copy_from_user(&table_size,
			   useraddr + offsetof(struct ethtool_rxfh_indir, size),
			   sizeof(table_size)))
		return -EFAULT;

	if (table_size >
	    (KMALLOC_MAX_SIZE - sizeof(*indir)) / sizeof(*indir->ring_index))
		return -ENOMEM;
	full_size = sizeof(*indir) + sizeof(*indir->ring_index) * table_size;
	indir = kmalloc(full_size, GFP_USER);
	if (!indir)
		return -ENOMEM;

	if (copy_from_user(indir, useraddr, full_size)) {
		ret = -EFAULT;
		goto out;
	}

	ret = dev->ethtool_ops->set_rxfh_indir(dev, indir);

out:
	kfree(indir);
	return ret;
}

856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887
/*
 * ethtool does not (or did not) set masks for flow parameters that are
 * not specified, so if both value and mask are 0 then this must be
 * treated as equivalent to a mask with all bits set.  Implement that
 * here rather than in drivers.
 */
static void rx_ntuple_fix_masks(struct ethtool_rx_ntuple_flow_spec *fs)
{
	struct ethtool_tcpip4_spec *entry = &fs->h_u.tcp_ip4_spec;
	struct ethtool_tcpip4_spec *mask = &fs->m_u.tcp_ip4_spec;

	if (fs->flow_type != TCP_V4_FLOW &&
	    fs->flow_type != UDP_V4_FLOW &&
	    fs->flow_type != SCTP_V4_FLOW)
		return;

	if (!(entry->ip4src | mask->ip4src))
		mask->ip4src = htonl(0xffffffff);
	if (!(entry->ip4dst | mask->ip4dst))
		mask->ip4dst = htonl(0xffffffff);
	if (!(entry->psrc | mask->psrc))
		mask->psrc = htons(0xffff);
	if (!(entry->pdst | mask->pdst))
		mask->pdst = htons(0xffff);
	if (!(entry->tos | mask->tos))
		mask->tos = 0xff;
	if (!(fs->vlan_tag | fs->vlan_tag_mask))
		fs->vlan_tag_mask = 0xffff;
	if (!(fs->data | fs->data_mask))
		fs->data_mask = 0xffffffffffffffffULL;
}

888 889
static noinline_for_stack int ethtool_set_rx_ntuple(struct net_device *dev,
						    void __user *useraddr)
890 891 892 893
{
	struct ethtool_rx_ntuple cmd;
	const struct ethtool_ops *ops = dev->ethtool_ops;

894 895 896
	if (!ops->set_rx_ntuple)
		return -EOPNOTSUPP;

897 898 899 900 901 902
	if (!(dev->features & NETIF_F_NTUPLE))
		return -EINVAL;

	if (copy_from_user(&cmd, useraddr, sizeof(cmd)))
		return -EFAULT;

903 904
	rx_ntuple_fix_masks(&cmd.fs);

905
	return ops->set_rx_ntuple(dev, &cmd);
906 907
}

L
Linus Torvalds 已提交
908 909 910
static int ethtool_get_regs(struct net_device *dev, char __user *useraddr)
{
	struct ethtool_regs regs;
911
	const struct ethtool_ops *ops = dev->ethtool_ops;
L
Linus Torvalds 已提交
912 913 914 915 916 917 918 919 920 921 922 923 924
	void *regbuf;
	int reglen, ret;

	if (!ops->get_regs || !ops->get_regs_len)
		return -EOPNOTSUPP;

	if (copy_from_user(&regs, useraddr, sizeof(regs)))
		return -EFAULT;

	reglen = ops->get_regs_len(dev);
	if (regs.len > reglen)
		regs.len = reglen;

925
	regbuf = vzalloc(reglen);
926
	if (reglen && !regbuf)
L
Linus Torvalds 已提交
927 928 929 930 931 932 933 934
		return -ENOMEM;

	ops->get_regs(dev, &regs, regbuf);

	ret = -EFAULT;
	if (copy_to_user(useraddr, &regs, sizeof(regs)))
		goto out;
	useraddr += offsetof(struct ethtool_regs, data);
935
	if (regbuf && copy_to_user(useraddr, regbuf, regs.len))
L
Linus Torvalds 已提交
936 937 938 939
		goto out;
	ret = 0;

 out:
940
	vfree(regbuf);
L
Linus Torvalds 已提交
941 942 943
	return ret;
}

B
Ben Hutchings 已提交
944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963
static int ethtool_reset(struct net_device *dev, char __user *useraddr)
{
	struct ethtool_value reset;
	int ret;

	if (!dev->ethtool_ops->reset)
		return -EOPNOTSUPP;

	if (copy_from_user(&reset, useraddr, sizeof(reset)))
		return -EFAULT;

	ret = dev->ethtool_ops->reset(dev, &reset.data);
	if (ret)
		return ret;

	if (copy_to_user(useraddr, &reset, sizeof(reset)))
		return -EFAULT;
	return 0;
}

L
Linus Torvalds 已提交
964 965
static int ethtool_get_wol(struct net_device *dev, char __user *useraddr)
{
966
	struct ethtool_wolinfo wol = { .cmd = ETHTOOL_GWOL };
L
Linus Torvalds 已提交
967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998

	if (!dev->ethtool_ops->get_wol)
		return -EOPNOTSUPP;

	dev->ethtool_ops->get_wol(dev, &wol);

	if (copy_to_user(useraddr, &wol, sizeof(wol)))
		return -EFAULT;
	return 0;
}

static int ethtool_set_wol(struct net_device *dev, char __user *useraddr)
{
	struct ethtool_wolinfo wol;

	if (!dev->ethtool_ops->set_wol)
		return -EOPNOTSUPP;

	if (copy_from_user(&wol, useraddr, sizeof(wol)))
		return -EFAULT;

	return dev->ethtool_ops->set_wol(dev, &wol);
}

static int ethtool_nway_reset(struct net_device *dev)
{
	if (!dev->ethtool_ops->nway_reset)
		return -EOPNOTSUPP;

	return dev->ethtool_ops->nway_reset(dev);
}

999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012
static int ethtool_get_link(struct net_device *dev, char __user *useraddr)
{
	struct ethtool_value edata = { .cmd = ETHTOOL_GLINK };

	if (!dev->ethtool_ops->get_link)
		return -EOPNOTSUPP;

	edata.data = netif_running(dev) && dev->ethtool_ops->get_link(dev);

	if (copy_to_user(useraddr, &edata, sizeof(edata)))
		return -EFAULT;
	return 0;
}

L
Linus Torvalds 已提交
1013 1014 1015
static int ethtool_get_eeprom(struct net_device *dev, void __user *useraddr)
{
	struct ethtool_eeprom eeprom;
1016
	const struct ethtool_ops *ops = dev->ethtool_ops;
1017 1018
	void __user *userbuf = useraddr + sizeof(eeprom);
	u32 bytes_remaining;
L
Linus Torvalds 已提交
1019
	u8 *data;
1020
	int ret = 0;
L
Linus Torvalds 已提交
1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035

	if (!ops->get_eeprom || !ops->get_eeprom_len)
		return -EOPNOTSUPP;

	if (copy_from_user(&eeprom, useraddr, sizeof(eeprom)))
		return -EFAULT;

	/* Check for wrap and zero */
	if (eeprom.offset + eeprom.len <= eeprom.offset)
		return -EINVAL;

	/* Check for exceeding total eeprom len */
	if (eeprom.offset + eeprom.len > ops->get_eeprom_len(dev))
		return -EINVAL;

1036
	data = kmalloc(PAGE_SIZE, GFP_USER);
L
Linus Torvalds 已提交
1037 1038 1039
	if (!data)
		return -ENOMEM;

1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054
	bytes_remaining = eeprom.len;
	while (bytes_remaining > 0) {
		eeprom.len = min(bytes_remaining, (u32)PAGE_SIZE);

		ret = ops->get_eeprom(dev, &eeprom, data);
		if (ret)
			break;
		if (copy_to_user(userbuf, data, eeprom.len)) {
			ret = -EFAULT;
			break;
		}
		userbuf += eeprom.len;
		eeprom.offset += eeprom.len;
		bytes_remaining -= eeprom.len;
	}
L
Linus Torvalds 已提交
1055

1056 1057 1058 1059 1060
	eeprom.len = userbuf - (useraddr + sizeof(eeprom));
	eeprom.offset -= eeprom.len;
	if (copy_to_user(useraddr, &eeprom, sizeof(eeprom)))
		ret = -EFAULT;

L
Linus Torvalds 已提交
1061 1062 1063 1064 1065 1066 1067
	kfree(data);
	return ret;
}

static int ethtool_set_eeprom(struct net_device *dev, void __user *useraddr)
{
	struct ethtool_eeprom eeprom;
1068
	const struct ethtool_ops *ops = dev->ethtool_ops;
1069 1070
	void __user *userbuf = useraddr + sizeof(eeprom);
	u32 bytes_remaining;
L
Linus Torvalds 已提交
1071
	u8 *data;
1072
	int ret = 0;
L
Linus Torvalds 已提交
1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087

	if (!ops->set_eeprom || !ops->get_eeprom_len)
		return -EOPNOTSUPP;

	if (copy_from_user(&eeprom, useraddr, sizeof(eeprom)))
		return -EFAULT;

	/* Check for wrap and zero */
	if (eeprom.offset + eeprom.len <= eeprom.offset)
		return -EINVAL;

	/* Check for exceeding total eeprom len */
	if (eeprom.offset + eeprom.len > ops->get_eeprom_len(dev))
		return -EINVAL;

1088
	data = kmalloc(PAGE_SIZE, GFP_USER);
L
Linus Torvalds 已提交
1089 1090 1091
	if (!data)
		return -ENOMEM;

1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106
	bytes_remaining = eeprom.len;
	while (bytes_remaining > 0) {
		eeprom.len = min(bytes_remaining, (u32)PAGE_SIZE);

		if (copy_from_user(data, userbuf, eeprom.len)) {
			ret = -EFAULT;
			break;
		}
		ret = ops->set_eeprom(dev, &eeprom, data);
		if (ret)
			break;
		userbuf += eeprom.len;
		eeprom.offset += eeprom.len;
		bytes_remaining -= eeprom.len;
	}
L
Linus Torvalds 已提交
1107 1108 1109 1110 1111

	kfree(data);
	return ret;
}

1112 1113
static noinline_for_stack int ethtool_get_coalesce(struct net_device *dev,
						   void __user *useraddr)
L
Linus Torvalds 已提交
1114
{
1115
	struct ethtool_coalesce coalesce = { .cmd = ETHTOOL_GCOALESCE };
L
Linus Torvalds 已提交
1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126

	if (!dev->ethtool_ops->get_coalesce)
		return -EOPNOTSUPP;

	dev->ethtool_ops->get_coalesce(dev, &coalesce);

	if (copy_to_user(useraddr, &coalesce, sizeof(coalesce)))
		return -EFAULT;
	return 0;
}

1127 1128
static noinline_for_stack int ethtool_set_coalesce(struct net_device *dev,
						   void __user *useraddr)
L
Linus Torvalds 已提交
1129 1130 1131
{
	struct ethtool_coalesce coalesce;

1132
	if (!dev->ethtool_ops->set_coalesce)
L
Linus Torvalds 已提交
1133 1134 1135 1136 1137 1138 1139 1140 1141 1142
		return -EOPNOTSUPP;

	if (copy_from_user(&coalesce, useraddr, sizeof(coalesce)))
		return -EFAULT;

	return dev->ethtool_ops->set_coalesce(dev, &coalesce);
}

static int ethtool_get_ringparam(struct net_device *dev, void __user *useraddr)
{
1143
	struct ethtool_ringparam ringparam = { .cmd = ETHTOOL_GRINGPARAM };
L
Linus Torvalds 已提交
1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167

	if (!dev->ethtool_ops->get_ringparam)
		return -EOPNOTSUPP;

	dev->ethtool_ops->get_ringparam(dev, &ringparam);

	if (copy_to_user(useraddr, &ringparam, sizeof(ringparam)))
		return -EFAULT;
	return 0;
}

static int ethtool_set_ringparam(struct net_device *dev, void __user *useraddr)
{
	struct ethtool_ringparam ringparam;

	if (!dev->ethtool_ops->set_ringparam)
		return -EOPNOTSUPP;

	if (copy_from_user(&ringparam, useraddr, sizeof(ringparam)))
		return -EFAULT;

	return dev->ethtool_ops->set_ringparam(dev, &ringparam);
}

1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196
static noinline_for_stack int ethtool_get_channels(struct net_device *dev,
						   void __user *useraddr)
{
	struct ethtool_channels channels = { .cmd = ETHTOOL_GCHANNELS };

	if (!dev->ethtool_ops->get_channels)
		return -EOPNOTSUPP;

	dev->ethtool_ops->get_channels(dev, &channels);

	if (copy_to_user(useraddr, &channels, sizeof(channels)))
		return -EFAULT;
	return 0;
}

static noinline_for_stack int ethtool_set_channels(struct net_device *dev,
						   void __user *useraddr)
{
	struct ethtool_channels channels;

	if (!dev->ethtool_ops->set_channels)
		return -EOPNOTSUPP;

	if (copy_from_user(&channels, useraddr, sizeof(channels)))
		return -EFAULT;

	return dev->ethtool_ops->set_channels(dev, &channels);
}

L
Linus Torvalds 已提交
1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214
static int ethtool_get_pauseparam(struct net_device *dev, void __user *useraddr)
{
	struct ethtool_pauseparam pauseparam = { ETHTOOL_GPAUSEPARAM };

	if (!dev->ethtool_ops->get_pauseparam)
		return -EOPNOTSUPP;

	dev->ethtool_ops->get_pauseparam(dev, &pauseparam);

	if (copy_to_user(useraddr, &pauseparam, sizeof(pauseparam)))
		return -EFAULT;
	return 0;
}

static int ethtool_set_pauseparam(struct net_device *dev, void __user *useraddr)
{
	struct ethtool_pauseparam pauseparam;

1215
	if (!dev->ethtool_ops->set_pauseparam)
L
Linus Torvalds 已提交
1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227
		return -EOPNOTSUPP;

	if (copy_from_user(&pauseparam, useraddr, sizeof(pauseparam)))
		return -EFAULT;

	return dev->ethtool_ops->set_pauseparam(dev, &pauseparam);
}

static int __ethtool_set_sg(struct net_device *dev, u32 data)
{
	int err;

1228 1229 1230
	if (!dev->ethtool_ops->set_sg)
		return -EOPNOTSUPP;

1231 1232 1233
	if (data && !(dev->features & NETIF_F_ALL_CSUM))
		return -EINVAL;

L
Linus Torvalds 已提交
1234 1235 1236 1237 1238 1239
	if (!data && dev->ethtool_ops->set_tso) {
		err = dev->ethtool_ops->set_tso(dev, 0);
		if (err)
			return err;
	}

1240 1241 1242 1243 1244
	if (!data && dev->ethtool_ops->set_ufo) {
		err = dev->ethtool_ops->set_ufo(dev, 0);
		if (err)
			return err;
	}
L
Linus Torvalds 已提交
1245 1246 1247
	return dev->ethtool_ops->set_sg(dev, data);
}

1248
static int __ethtool_set_tx_csum(struct net_device *dev, u32 data)
L
Linus Torvalds 已提交
1249 1250 1251 1252 1253 1254
{
	int err;

	if (!dev->ethtool_ops->set_tx_csum)
		return -EOPNOTSUPP;

1255
	if (!data && dev->ethtool_ops->set_sg) {
L
Linus Torvalds 已提交
1256 1257 1258 1259 1260
		err = __ethtool_set_sg(dev, 0);
		if (err)
			return err;
	}

1261
	return dev->ethtool_ops->set_tx_csum(dev, data);
L
Linus Torvalds 已提交
1262 1263
}

1264
static int __ethtool_set_rx_csum(struct net_device *dev, u32 data)
H
Herbert Xu 已提交
1265 1266 1267 1268
{
	if (!dev->ethtool_ops->set_rx_csum)
		return -EOPNOTSUPP;

1269
	if (!data)
H
Herbert Xu 已提交
1270 1271
		dev->features &= ~NETIF_F_GRO;

1272
	return dev->ethtool_ops->set_rx_csum(dev, data);
H
Herbert Xu 已提交
1273 1274
}

1275
static int __ethtool_set_tso(struct net_device *dev, u32 data)
L
Linus Torvalds 已提交
1276 1277 1278 1279
{
	if (!dev->ethtool_ops->set_tso)
		return -EOPNOTSUPP;

1280
	if (data && !(dev->features & NETIF_F_SG))
L
Linus Torvalds 已提交
1281 1282
		return -EINVAL;

1283
	return dev->ethtool_ops->set_tso(dev, data);
L
Linus Torvalds 已提交
1284 1285
}

1286
static int __ethtool_set_ufo(struct net_device *dev, u32 data)
1287 1288 1289
{
	if (!dev->ethtool_ops->set_ufo)
		return -EOPNOTSUPP;
1290
	if (data && !(dev->features & NETIF_F_SG))
1291
		return -EINVAL;
1292
	if (data && !((dev->features & NETIF_F_GEN_CSUM) ||
1293 1294
		(dev->features & (NETIF_F_IP_CSUM|NETIF_F_IPV6_CSUM))
			== (NETIF_F_IP_CSUM|NETIF_F_IPV6_CSUM)))
1295
		return -EINVAL;
1296
	return dev->ethtool_ops->set_ufo(dev, data);
H
Herbert Xu 已提交
1297 1298
}

L
Linus Torvalds 已提交
1299 1300 1301
static int ethtool_self_test(struct net_device *dev, char __user *useraddr)
{
	struct ethtool_test test;
1302
	const struct ethtool_ops *ops = dev->ethtool_ops;
L
Linus Torvalds 已提交
1303
	u64 *data;
1304
	int ret, test_len;
L
Linus Torvalds 已提交
1305

1306
	if (!ops->self_test || !ops->get_sset_count)
L
Linus Torvalds 已提交
1307 1308
		return -EOPNOTSUPP;

1309
	test_len = ops->get_sset_count(dev, ETH_SS_TEST);
1310 1311 1312 1313
	if (test_len < 0)
		return test_len;
	WARN_ON(test_len == 0);

L
Linus Torvalds 已提交
1314 1315 1316
	if (copy_from_user(&test, useraddr, sizeof(test)))
		return -EFAULT;

1317 1318
	test.len = test_len;
	data = kmalloc(test_len * sizeof(u64), GFP_USER);
L
Linus Torvalds 已提交
1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345
	if (!data)
		return -ENOMEM;

	ops->self_test(dev, &test, data);

	ret = -EFAULT;
	if (copy_to_user(useraddr, &test, sizeof(test)))
		goto out;
	useraddr += sizeof(test);
	if (copy_to_user(useraddr, data, test.len * sizeof(u64)))
		goto out;
	ret = 0;

 out:
	kfree(data);
	return ret;
}

static int ethtool_get_strings(struct net_device *dev, void __user *useraddr)
{
	struct ethtool_gstrings gstrings;
	u8 *data;
	int ret;

	if (copy_from_user(&gstrings, useraddr, sizeof(gstrings)))
		return -EFAULT;

1346
	ret = __ethtool_get_sset_count(dev, gstrings.string_set);
1347 1348 1349 1350
	if (ret < 0)
		return ret;

	gstrings.len = ret;
L
Linus Torvalds 已提交
1351 1352 1353 1354 1355

	data = kmalloc(gstrings.len * ETH_GSTRING_LEN, GFP_USER);
	if (!data)
		return -ENOMEM;

1356
	__ethtool_get_strings(dev, gstrings.string_set, data);
L
Linus Torvalds 已提交
1357 1358 1359 1360 1361 1362 1363 1364 1365

	ret = -EFAULT;
	if (copy_to_user(useraddr, &gstrings, sizeof(gstrings)))
		goto out;
	useraddr += sizeof(gstrings);
	if (copy_to_user(useraddr, data, gstrings.len * ETH_GSTRING_LEN))
		goto out;
	ret = 0;

1366
out:
L
Linus Torvalds 已提交
1367 1368 1369 1370 1371 1372 1373
	kfree(data);
	return ret;
}

static int ethtool_phys_id(struct net_device *dev, void __user *useraddr)
{
	struct ethtool_value id;
1374 1375
	static bool busy;
	int rc;
L
Linus Torvalds 已提交
1376

1377
	if (!dev->ethtool_ops->set_phys_id)
L
Linus Torvalds 已提交
1378 1379
		return -EOPNOTSUPP;

1380 1381 1382
	if (busy)
		return -EBUSY;

L
Linus Torvalds 已提交
1383 1384 1385
	if (copy_from_user(&id, useraddr, sizeof(id)))
		return -EFAULT;

1386
	rc = dev->ethtool_ops->set_phys_id(dev, ETHTOOL_ID_ACTIVE);
1387
	if (rc < 0)
1388 1389 1390 1391 1392 1393 1394 1395 1396 1397 1398 1399
		return rc;

	/* Drop the RTNL lock while waiting, but prevent reentry or
	 * removal of the device.
	 */
	busy = true;
	dev_hold(dev);
	rtnl_unlock();

	if (rc == 0) {
		/* Driver will handle this itself */
		schedule_timeout_interruptible(
1400
			id.data ? (id.data * HZ) : MAX_SCHEDULE_TIMEOUT);
1401
	} else {
1402 1403 1404 1405
		/* Driver expects to be called at twice the frequency in rc */
		int n = rc * 2, i, interval = HZ / n;

		/* Count down seconds */
1406
		do {
1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417
			/* Count down iterations per second */
			i = n;
			do {
				rtnl_lock();
				rc = dev->ethtool_ops->set_phys_id(dev,
				    (i & 1) ? ETHTOOL_ID_OFF : ETHTOOL_ID_ON);
				rtnl_unlock();
				if (rc)
					break;
				schedule_timeout_interruptible(interval);
			} while (!signal_pending(current) && --i != 0);
1418 1419 1420 1421 1422 1423 1424 1425 1426 1427
		} while (!signal_pending(current) &&
			 (id.data == 0 || --id.data != 0));
	}

	rtnl_lock();
	dev_put(dev);
	busy = false;

	(void)dev->ethtool_ops->set_phys_id(dev, ETHTOOL_ID_INACTIVE);
	return rc;
L
Linus Torvalds 已提交
1428 1429 1430 1431 1432
}

static int ethtool_get_stats(struct net_device *dev, void __user *useraddr)
{
	struct ethtool_stats stats;
1433
	const struct ethtool_ops *ops = dev->ethtool_ops;
L
Linus Torvalds 已提交
1434
	u64 *data;
1435
	int ret, n_stats;
L
Linus Torvalds 已提交
1436

1437
	if (!ops->get_ethtool_stats || !ops->get_sset_count)
L
Linus Torvalds 已提交
1438 1439
		return -EOPNOTSUPP;

1440
	n_stats = ops->get_sset_count(dev, ETH_SS_STATS);
1441 1442 1443 1444
	if (n_stats < 0)
		return n_stats;
	WARN_ON(n_stats == 0);

L
Linus Torvalds 已提交
1445 1446 1447
	if (copy_from_user(&stats, useraddr, sizeof(stats)))
		return -EFAULT;

1448 1449
	stats.n_stats = n_stats;
	data = kmalloc(n_stats * sizeof(u64), GFP_USER);
L
Linus Torvalds 已提交
1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467
	if (!data)
		return -ENOMEM;

	ops->get_ethtool_stats(dev, &stats, data);

	ret = -EFAULT;
	if (copy_to_user(useraddr, &stats, sizeof(stats)))
		goto out;
	useraddr += sizeof(stats);
	if (copy_to_user(useraddr, data, stats.n_stats * sizeof(u64)))
		goto out;
	ret = 0;

 out:
	kfree(data);
	return ret;
}

1468
static int ethtool_get_perm_addr(struct net_device *dev, void __user *useraddr)
1469 1470 1471
{
	struct ethtool_perm_addr epaddr;

1472
	if (copy_from_user(&epaddr, useraddr, sizeof(epaddr)))
1473 1474
		return -EFAULT;

1475 1476 1477
	if (epaddr.size < dev->addr_len)
		return -ETOOSMALL;
	epaddr.size = dev->addr_len;
1478 1479

	if (copy_to_user(useraddr, &epaddr, sizeof(epaddr)))
1480
		return -EFAULT;
1481
	useraddr += sizeof(epaddr);
1482 1483 1484
	if (copy_to_user(useraddr, dev->perm_addr, epaddr.size))
		return -EFAULT;
	return 0;
1485 1486
}

1487 1488
static int ethtool_get_value(struct net_device *dev, char __user *useraddr,
			     u32 cmd, u32 (*actor)(struct net_device *))
1489
{
1490
	struct ethtool_value edata = { .cmd = cmd };
1491

1492
	if (!actor)
1493 1494
		return -EOPNOTSUPP;

1495
	edata.data = actor(dev);
1496 1497 1498 1499 1500 1501

	if (copy_to_user(useraddr, &edata, sizeof(edata)))
		return -EFAULT;
	return 0;
}

1502 1503
static int ethtool_set_value_void(struct net_device *dev, char __user *useraddr,
			     void (*actor)(struct net_device *, u32))
1504 1505 1506
{
	struct ethtool_value edata;

1507
	if (!actor)
1508 1509 1510 1511 1512
		return -EOPNOTSUPP;

	if (copy_from_user(&edata, useraddr, sizeof(edata)))
		return -EFAULT;

1513
	actor(dev, edata.data);
1514 1515 1516
	return 0;
}

1517 1518
static int ethtool_set_value(struct net_device *dev, char __user *useraddr,
			     int (*actor)(struct net_device *, u32))
1519 1520 1521
{
	struct ethtool_value edata;

1522
	if (!actor)
1523 1524 1525 1526 1527
		return -EOPNOTSUPP;

	if (copy_from_user(&edata, useraddr, sizeof(edata)))
		return -EFAULT;

1528
	return actor(dev, edata.data);
1529 1530
}

1531 1532
static noinline_for_stack int ethtool_flash_device(struct net_device *dev,
						   char __user *useraddr)
1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544
{
	struct ethtool_flash efl;

	if (copy_from_user(&efl, useraddr, sizeof(efl)))
		return -EFAULT;

	if (!dev->ethtool_ops->flash_device)
		return -EOPNOTSUPP;

	return dev->ethtool_ops->flash_device(dev, &efl);
}

1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625
static int ethtool_set_dump(struct net_device *dev,
			void __user *useraddr)
{
	struct ethtool_dump dump;

	if (!dev->ethtool_ops->set_dump)
		return -EOPNOTSUPP;

	if (copy_from_user(&dump, useraddr, sizeof(dump)))
		return -EFAULT;

	return dev->ethtool_ops->set_dump(dev, &dump);
}

static int ethtool_get_dump_flag(struct net_device *dev,
				void __user *useraddr)
{
	int ret;
	struct ethtool_dump dump;
	const struct ethtool_ops *ops = dev->ethtool_ops;

	if (!dev->ethtool_ops->get_dump_flag)
		return -EOPNOTSUPP;

	if (copy_from_user(&dump, useraddr, sizeof(dump)))
		return -EFAULT;

	ret = ops->get_dump_flag(dev, &dump);
	if (ret)
		return ret;

	if (copy_to_user(useraddr, &dump, sizeof(dump)))
		return -EFAULT;
	return 0;
}

static int ethtool_get_dump_data(struct net_device *dev,
				void __user *useraddr)
{
	int ret;
	__u32 len;
	struct ethtool_dump dump, tmp;
	const struct ethtool_ops *ops = dev->ethtool_ops;
	void *data = NULL;

	if (!dev->ethtool_ops->get_dump_data ||
		!dev->ethtool_ops->get_dump_flag)
		return -EOPNOTSUPP;

	if (copy_from_user(&dump, useraddr, sizeof(dump)))
		return -EFAULT;

	memset(&tmp, 0, sizeof(tmp));
	tmp.cmd = ETHTOOL_GET_DUMP_FLAG;
	ret = ops->get_dump_flag(dev, &tmp);
	if (ret)
		return ret;

	len = (tmp.len > dump.len) ? dump.len : tmp.len;
	if (!len)
		return -EFAULT;

	data = vzalloc(tmp.len);
	if (!data)
		return -ENOMEM;
	ret = ops->get_dump_data(dev, &dump, data);
	if (ret)
		goto out;

	if (copy_to_user(useraddr, &dump, sizeof(dump))) {
		ret = -EFAULT;
		goto out;
	}
	useraddr += offsetof(struct ethtool_dump, data);
	if (copy_to_user(useraddr, data, len))
		ret = -EFAULT;
out:
	vfree(data);
	return ret;
}

L
Linus Torvalds 已提交
1626 1627
/* The main entry point in this file.  Called from net/core/dev.c */

1628
int dev_ethtool(struct net *net, struct ifreq *ifr)
L
Linus Torvalds 已提交
1629
{
1630
	struct net_device *dev = __dev_get_by_name(net, ifr->ifr_name);
L
Linus Torvalds 已提交
1631 1632 1633
	void __user *useraddr = ifr->ifr_data;
	u32 ethcmd;
	int rc;
1634
	u32 old_features;
L
Linus Torvalds 已提交
1635 1636 1637 1638

	if (!dev || !netif_device_present(dev))
		return -ENODEV;

1639
	if (copy_from_user(&ethcmd, useraddr, sizeof(ethcmd)))
L
Linus Torvalds 已提交
1640 1641
		return -EFAULT;

1642 1643 1644 1645 1646 1647 1648 1649 1650 1651
	if (!dev->ethtool_ops) {
		/* ETHTOOL_GDRVINFO does not require any driver support.
		 * It is also unprivileged and does not change anything,
		 * so we can take a shortcut to it. */
		if (ethcmd == ETHTOOL_GDRVINFO)
			return ethtool_get_drvinfo(dev, useraddr);
		else
			return -EOPNOTSUPP;
	}

1652
	/* Allow some commands to be done by anyone */
1653
	switch (ethcmd) {
1654
	case ETHTOOL_GSET:
1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667
	case ETHTOOL_GDRVINFO:
	case ETHTOOL_GMSGLVL:
	case ETHTOOL_GCOALESCE:
	case ETHTOOL_GRINGPARAM:
	case ETHTOOL_GPAUSEPARAM:
	case ETHTOOL_GRXCSUM:
	case ETHTOOL_GTXCSUM:
	case ETHTOOL_GSG:
	case ETHTOOL_GSTRINGS:
	case ETHTOOL_GTSO:
	case ETHTOOL_GPERMADDR:
	case ETHTOOL_GUFO:
	case ETHTOOL_GGSO:
1668
	case ETHTOOL_GGRO:
1669 1670
	case ETHTOOL_GFLAGS:
	case ETHTOOL_GPFLAGS:
1671
	case ETHTOOL_GRXFH:
1672 1673 1674 1675
	case ETHTOOL_GRXRINGS:
	case ETHTOOL_GRXCLSRLCNT:
	case ETHTOOL_GRXCLSRULE:
	case ETHTOOL_GRXCLSRLALL:
1676
	case ETHTOOL_GFEATURES:
1677 1678 1679 1680 1681 1682
		break;
	default:
		if (!capable(CAP_NET_ADMIN))
			return -EPERM;
	}

1683 1684 1685
	if (dev->ethtool_ops->begin) {
		rc = dev->ethtool_ops->begin(dev);
		if (rc  < 0)
L
Linus Torvalds 已提交
1686
			return rc;
1687
	}
1688 1689
	old_features = dev->features;

L
Linus Torvalds 已提交
1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709
	switch (ethcmd) {
	case ETHTOOL_GSET:
		rc = ethtool_get_settings(dev, useraddr);
		break;
	case ETHTOOL_SSET:
		rc = ethtool_set_settings(dev, useraddr);
		break;
	case ETHTOOL_GDRVINFO:
		rc = ethtool_get_drvinfo(dev, useraddr);
		break;
	case ETHTOOL_GREGS:
		rc = ethtool_get_regs(dev, useraddr);
		break;
	case ETHTOOL_GWOL:
		rc = ethtool_get_wol(dev, useraddr);
		break;
	case ETHTOOL_SWOL:
		rc = ethtool_set_wol(dev, useraddr);
		break;
	case ETHTOOL_GMSGLVL:
1710 1711
		rc = ethtool_get_value(dev, useraddr, ethcmd,
				       dev->ethtool_ops->get_msglevel);
L
Linus Torvalds 已提交
1712 1713
		break;
	case ETHTOOL_SMSGLVL:
1714 1715
		rc = ethtool_set_value_void(dev, useraddr,
				       dev->ethtool_ops->set_msglevel);
L
Linus Torvalds 已提交
1716 1717 1718 1719 1720
		break;
	case ETHTOOL_NWAY_RST:
		rc = ethtool_nway_reset(dev);
		break;
	case ETHTOOL_GLINK:
1721
		rc = ethtool_get_link(dev, useraddr);
L
Linus Torvalds 已提交
1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758
		break;
	case ETHTOOL_GEEPROM:
		rc = ethtool_get_eeprom(dev, useraddr);
		break;
	case ETHTOOL_SEEPROM:
		rc = ethtool_set_eeprom(dev, useraddr);
		break;
	case ETHTOOL_GCOALESCE:
		rc = ethtool_get_coalesce(dev, useraddr);
		break;
	case ETHTOOL_SCOALESCE:
		rc = ethtool_set_coalesce(dev, useraddr);
		break;
	case ETHTOOL_GRINGPARAM:
		rc = ethtool_get_ringparam(dev, useraddr);
		break;
	case ETHTOOL_SRINGPARAM:
		rc = ethtool_set_ringparam(dev, useraddr);
		break;
	case ETHTOOL_GPAUSEPARAM:
		rc = ethtool_get_pauseparam(dev, useraddr);
		break;
	case ETHTOOL_SPAUSEPARAM:
		rc = ethtool_set_pauseparam(dev, useraddr);
		break;
	case ETHTOOL_TEST:
		rc = ethtool_self_test(dev, useraddr);
		break;
	case ETHTOOL_GSTRINGS:
		rc = ethtool_get_strings(dev, useraddr);
		break;
	case ETHTOOL_PHYS_ID:
		rc = ethtool_phys_id(dev, useraddr);
		break;
	case ETHTOOL_GSTATS:
		rc = ethtool_get_stats(dev, useraddr);
		break;
1759 1760 1761
	case ETHTOOL_GPERMADDR:
		rc = ethtool_get_perm_addr(dev, useraddr);
		break;
1762
	case ETHTOOL_GFLAGS:
1763
		rc = ethtool_get_value(dev, useraddr, ethcmd,
1764 1765 1766
				       (dev->ethtool_ops->get_flags ?
					dev->ethtool_ops->get_flags :
					ethtool_op_get_flags));
1767 1768
		break;
	case ETHTOOL_SFLAGS:
1769
		rc = ethtool_set_value(dev, useraddr, __ethtool_set_flags);
1770
		break;
1771
	case ETHTOOL_GPFLAGS:
1772 1773
		rc = ethtool_get_value(dev, useraddr, ethcmd,
				       dev->ethtool_ops->get_priv_flags);
1774 1775
		break;
	case ETHTOOL_SPFLAGS:
1776 1777
		rc = ethtool_set_value(dev, useraddr,
				       dev->ethtool_ops->set_priv_flags);
1778
		break;
1779
	case ETHTOOL_GRXFH:
1780 1781 1782 1783
	case ETHTOOL_GRXRINGS:
	case ETHTOOL_GRXCLSRLCNT:
	case ETHTOOL_GRXCLSRULE:
	case ETHTOOL_GRXCLSRLALL:
1784
		rc = ethtool_get_rxnfc(dev, ethcmd, useraddr);
1785 1786
		break;
	case ETHTOOL_SRXFH:
1787 1788
	case ETHTOOL_SRXCLSRLDEL:
	case ETHTOOL_SRXCLSRLINS:
1789
		rc = ethtool_set_rxnfc(dev, ethcmd, useraddr);
1790
		break;
1791 1792 1793
	case ETHTOOL_FLASHDEV:
		rc = ethtool_flash_device(dev, useraddr);
		break;
B
Ben Hutchings 已提交
1794 1795 1796
	case ETHTOOL_RESET:
		rc = ethtool_reset(dev, useraddr);
		break;
1797 1798 1799
	case ETHTOOL_SRXNTUPLE:
		rc = ethtool_set_rx_ntuple(dev, useraddr);
		break;
1800 1801 1802
	case ETHTOOL_GSSET_INFO:
		rc = ethtool_get_sset_info(dev, useraddr);
		break;
1803 1804 1805 1806 1807 1808
	case ETHTOOL_GRXFHINDIR:
		rc = ethtool_get_rxfh_indir(dev, useraddr);
		break;
	case ETHTOOL_SRXFHINDIR:
		rc = ethtool_set_rxfh_indir(dev, useraddr);
		break;
1809 1810 1811 1812 1813 1814
	case ETHTOOL_GFEATURES:
		rc = ethtool_get_features(dev, useraddr);
		break;
	case ETHTOOL_SFEATURES:
		rc = ethtool_set_features(dev, useraddr);
		break;
1815
	case ETHTOOL_GTXCSUM:
1816
	case ETHTOOL_GRXCSUM:
1817 1818 1819 1820 1821 1822 1823 1824
	case ETHTOOL_GSG:
	case ETHTOOL_GTSO:
	case ETHTOOL_GUFO:
	case ETHTOOL_GGSO:
	case ETHTOOL_GGRO:
		rc = ethtool_get_one_feature(dev, useraddr, ethcmd);
		break;
	case ETHTOOL_STXCSUM:
1825
	case ETHTOOL_SRXCSUM:
1826 1827 1828 1829 1830 1831 1832
	case ETHTOOL_SSG:
	case ETHTOOL_STSO:
	case ETHTOOL_SUFO:
	case ETHTOOL_SGSO:
	case ETHTOOL_SGRO:
		rc = ethtool_set_one_feature(dev, useraddr, ethcmd);
		break;
1833 1834 1835 1836 1837 1838
	case ETHTOOL_GCHANNELS:
		rc = ethtool_get_channels(dev, useraddr);
		break;
	case ETHTOOL_SCHANNELS:
		rc = ethtool_set_channels(dev, useraddr);
		break;
1839 1840 1841 1842 1843 1844 1845 1846 1847
	case ETHTOOL_SET_DUMP:
		rc = ethtool_set_dump(dev, useraddr);
		break;
	case ETHTOOL_GET_DUMP_FLAG:
		rc = ethtool_get_dump_flag(dev, useraddr);
		break;
	case ETHTOOL_GET_DUMP_DATA:
		rc = ethtool_get_dump_data(dev, useraddr);
		break;
L
Linus Torvalds 已提交
1848
	default:
1849
		rc = -EOPNOTSUPP;
L
Linus Torvalds 已提交
1850
	}
1851

1852
	if (dev->ethtool_ops->complete)
L
Linus Torvalds 已提交
1853
		dev->ethtool_ops->complete(dev);
1854 1855 1856 1857

	if (old_features != dev->features)
		netdev_features_change(dev);

L
Linus Torvalds 已提交
1858 1859
	return rc;
}