tun.c 53.3 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
/*
 *  TUN - Universal TUN/TAP device driver.
 *  Copyright (C) 1999-2002 Maxim Krasnyansky <maxk@qualcomm.com>
 *
 *  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.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 *  GNU General Public License for more details.
 *
 *  $Id: tun.c,v 1.15 2002/03/01 02:44:24 maxk Exp $
 */

/*
 *  Changes:
 *
21 22 23
 *  Mike Kershaw <dragorn@kismetwireless.net> 2005/08/14
 *    Add TUNSETLINK ioctl to set the link encapsulation
 *
L
Linus Torvalds 已提交
24
 *  Mark Smith <markzzzsmith@yahoo.com.au>
J
Joe Perches 已提交
25
 *    Use eth_random_addr() for tap MAC address.
L
Linus Torvalds 已提交
26 27 28 29 30 31 32 33 34 35 36
 *
 *  Harald Roelle <harald.roelle@ifi.lmu.de>  2004/04/20
 *    Fixes in packet dropping, queue length setting and queue wakeup.
 *    Increased default tx queue length.
 *    Added ethtool API.
 *    Minor cleanups
 *
 *  Daniel Podlejski <underley@underley.eu.org>
 *    Modifications for 2.3.99-pre5 kernel.
 */

37 38
#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt

L
Linus Torvalds 已提交
39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57
#define DRV_NAME	"tun"
#define DRV_VERSION	"1.6"
#define DRV_DESCRIPTION	"Universal TUN/TAP device driver"
#define DRV_COPYRIGHT	"(C) 1999-2004 Max Krasnyansky <maxk@qualcomm.com>"

#include <linux/module.h>
#include <linux/errno.h>
#include <linux/kernel.h>
#include <linux/major.h>
#include <linux/slab.h>
#include <linux/poll.h>
#include <linux/fcntl.h>
#include <linux/init.h>
#include <linux/skbuff.h>
#include <linux/netdevice.h>
#include <linux/etherdevice.h>
#include <linux/miscdevice.h>
#include <linux/ethtool.h>
#include <linux/rtnetlink.h>
58
#include <linux/compat.h>
L
Linus Torvalds 已提交
59 60 61 62
#include <linux/if.h>
#include <linux/if_arp.h>
#include <linux/if_ether.h>
#include <linux/if_tun.h>
J
Jason Wang 已提交
63
#include <linux/if_vlan.h>
L
Linus Torvalds 已提交
64
#include <linux/crc32.h>
65
#include <linux/nsproxy.h>
66
#include <linux/virtio_net.h>
M
Michael S. Tsirkin 已提交
67
#include <linux/rcupdate.h>
68
#include <net/net_namespace.h>
69
#include <net/netns/generic.h>
70
#include <net/rtnetlink.h>
71
#include <net/sock.h>
L
Linus Torvalds 已提交
72 73 74

#include <asm/uaccess.h>

75 76 77
/* Uncomment to enable debugging */
/* #define TUN_DEBUG 1 */

L
Linus Torvalds 已提交
78 79
#ifdef TUN_DEBUG
static int debug;
80

81 82 83 84 85 86 87 88 89 90
#define tun_debug(level, tun, fmt, args...)			\
do {								\
	if (tun->debug)						\
		netdev_printk(level, tun->dev, fmt, ##args);	\
} while (0)
#define DBG1(level, fmt, args...)				\
do {								\
	if (debug == 2)						\
		printk(level fmt, ##args);			\
} while (0)
91
#else
92 93 94 95 96 97 98 99 100 101
#define tun_debug(level, tun, fmt, args...)			\
do {								\
	if (0)							\
		netdev_printk(level, tun->dev, fmt, ##args);	\
} while (0)
#define DBG1(level, fmt, args...)				\
do {								\
	if (0)							\
		printk(level fmt, ##args);			\
} while (0)
102 103
#endif

104 105
#define GOODCOPY_LEN 128

106 107 108 109 110 111 112
#define FLT_EXACT_COUNT 8
struct tap_filter {
	unsigned int    count;    /* Number of addrs. Zero means disabled */
	u32             mask[2];  /* Mask of the hashed addrs */
	unsigned char	addr[FLT_EXACT_COUNT][ETH_ALEN];
};

113 114 115 116
/* DEFAULT_MAX_NUM_RSS_QUEUES were choosed to let the rx/tx queues allocated for
 * the netdevice to be fit in one page. So we can make sure the success of
 * memory allocation. TODO: increase the limit. */
#define MAX_TAP_QUEUES DEFAULT_MAX_NUM_RSS_QUEUES
117
#define MAX_TAP_FLOWS  4096
J
Jason Wang 已提交
118

J
Jason Wang 已提交
119 120
#define TUN_FLOW_EXPIRE (3 * HZ)

J
Jason Wang 已提交
121 122 123 124
/* A tun_file connects an open character device to a tuntap netdevice. It
 * also contains all socket related strctures (except sock_fprog and tap_filter)
 * to serve as one transmit queue for tuntap device. The sock_fprog and
 * tap_filter were kept in tun_struct since they were used for filtering for the
R
Rami Rosen 已提交
125
 * netdevice not for a specific queue (at least I didn't see the requirement for
J
Jason Wang 已提交
126
 * this).
127 128
 *
 * RCU usage:
R
Rami Rosen 已提交
129
 * The tun_file and tun_struct are loosely coupled, the pointer from one to the
130
 * other can only be read while rcu_read_lock or rtnl_lock is held.
J
Jason Wang 已提交
131
 */
E
Eric W. Biederman 已提交
132
struct tun_file {
J
Jason Wang 已提交
133 134 135
	struct sock sk;
	struct socket socket;
	struct socket_wq wq;
136
	struct tun_struct __rcu *tun;
E
Eric W. Biederman 已提交
137
	struct net *net;
J
Jason Wang 已提交
138 139 140
	struct fasync_struct *fasync;
	/* only used for fasnyc */
	unsigned int flags;
J
Jason Wang 已提交
141
	u16 queue_index;
J
Jason Wang 已提交
142 143
	struct list_head next;
	struct tun_struct *detached;
E
Eric W. Biederman 已提交
144 145
};

J
Jason Wang 已提交
146 147 148 149 150 151 152 153 154 155 156 157
struct tun_flow_entry {
	struct hlist_node hash_link;
	struct rcu_head rcu;
	struct tun_struct *tun;

	u32 rxhash;
	int queue_index;
	unsigned long updated;
};

#define TUN_NUM_FLOW_ENTRIES 1024

J
Jason Wang 已提交
158
/* Since the socket were moved to tun_file, to preserve the behavior of persist
R
Rami Rosen 已提交
159
 * device, socket filter, sndbuf and vnet header size were restore when the
J
Jason Wang 已提交
160 161
 * file were attached to a persist device.
 */
162
struct tun_struct {
J
Jason Wang 已提交
163 164
	struct tun_file __rcu	*tfiles[MAX_TAP_QUEUES];
	unsigned int            numqueues;
165
	unsigned int 		flags;
166 167
	kuid_t			owner;
	kgid_t			group;
168 169

	struct net_device	*dev;
170
	netdev_features_t	set_features;
171 172
#define TUN_USER_FEATURES (NETIF_F_HW_CSUM|NETIF_F_TSO_ECN|NETIF_F_TSO| \
			  NETIF_F_TSO6|NETIF_F_UFO)
173 174

	int			vnet_hdr_sz;
J
Jason Wang 已提交
175 176 177 178 179
	int			sndbuf;
	struct tap_filter	txflt;
	struct sock_fprog	fprog;
	/* protected by rtnl lock */
	bool			filter_attached;
180 181
#ifdef TUN_DEBUG
	int debug;
L
Linus Torvalds 已提交
182
#endif
J
Jason Wang 已提交
183 184 185 186
	spinlock_t lock;
	struct hlist_head flows[TUN_NUM_FLOW_ENTRIES];
	struct timer_list flow_gc_timer;
	unsigned long ageing_time;
J
Jason Wang 已提交
187 188
	unsigned int numdisabled;
	struct list_head disabled;
189
	void *security;
190
	u32 flow_count;
191
};
L
Linus Torvalds 已提交
192

J
Jason Wang 已提交
193 194 195 196 197 198 199 200 201
static inline u32 tun_hashfn(u32 rxhash)
{
	return rxhash & 0x3ff;
}

static struct tun_flow_entry *tun_flow_find(struct hlist_head *head, u32 rxhash)
{
	struct tun_flow_entry *e;

202
	hlist_for_each_entry_rcu(e, head, hash_link) {
J
Jason Wang 已提交
203 204 205 206 207 208 209 210 211 212
		if (e->rxhash == rxhash)
			return e;
	}
	return NULL;
}

static struct tun_flow_entry *tun_flow_create(struct tun_struct *tun,
					      struct hlist_head *head,
					      u32 rxhash, u16 queue_index)
{
213 214
	struct tun_flow_entry *e = kmalloc(sizeof(*e), GFP_ATOMIC);

J
Jason Wang 已提交
215 216 217 218 219 220 221 222
	if (e) {
		tun_debug(KERN_INFO, tun, "create flow: hash %u index %u\n",
			  rxhash, queue_index);
		e->updated = jiffies;
		e->rxhash = rxhash;
		e->queue_index = queue_index;
		e->tun = tun;
		hlist_add_head_rcu(&e->hash_link, head);
223
		++tun->flow_count;
J
Jason Wang 已提交
224 225 226 227 228 229 230 231 232
	}
	return e;
}

static void tun_flow_delete(struct tun_struct *tun, struct tun_flow_entry *e)
{
	tun_debug(KERN_INFO, tun, "delete flow: hash %u index %u\n",
		  e->rxhash, e->queue_index);
	hlist_del_rcu(&e->hash_link);
233
	kfree_rcu(e, rcu);
234
	--tun->flow_count;
J
Jason Wang 已提交
235 236 237 238 239 240 241 242 243
}

static void tun_flow_flush(struct tun_struct *tun)
{
	int i;

	spin_lock_bh(&tun->lock);
	for (i = 0; i < TUN_NUM_FLOW_ENTRIES; i++) {
		struct tun_flow_entry *e;
244
		struct hlist_node *n;
J
Jason Wang 已提交
245

246
		hlist_for_each_entry_safe(e, n, &tun->flows[i], hash_link)
J
Jason Wang 已提交
247 248 249 250 251 252 253 254 255 256 257 258
			tun_flow_delete(tun, e);
	}
	spin_unlock_bh(&tun->lock);
}

static void tun_flow_delete_by_queue(struct tun_struct *tun, u16 queue_index)
{
	int i;

	spin_lock_bh(&tun->lock);
	for (i = 0; i < TUN_NUM_FLOW_ENTRIES; i++) {
		struct tun_flow_entry *e;
259
		struct hlist_node *n;
J
Jason Wang 已提交
260

261
		hlist_for_each_entry_safe(e, n, &tun->flows[i], hash_link) {
J
Jason Wang 已提交
262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281
			if (e->queue_index == queue_index)
				tun_flow_delete(tun, e);
		}
	}
	spin_unlock_bh(&tun->lock);
}

static void tun_flow_cleanup(unsigned long data)
{
	struct tun_struct *tun = (struct tun_struct *)data;
	unsigned long delay = tun->ageing_time;
	unsigned long next_timer = jiffies + delay;
	unsigned long count = 0;
	int i;

	tun_debug(KERN_INFO, tun, "tun_flow_cleanup\n");

	spin_lock_bh(&tun->lock);
	for (i = 0; i < TUN_NUM_FLOW_ENTRIES; i++) {
		struct tun_flow_entry *e;
282
		struct hlist_node *n;
J
Jason Wang 已提交
283

284
		hlist_for_each_entry_safe(e, n, &tun->flows[i], hash_link) {
J
Jason Wang 已提交
285 286 287 288 289 290 291 292 293 294 295 296 297 298 299
			unsigned long this_timer;
			count++;
			this_timer = e->updated + delay;
			if (time_before_eq(this_timer, jiffies))
				tun_flow_delete(tun, e);
			else if (time_before(this_timer, next_timer))
				next_timer = this_timer;
		}
	}

	if (count)
		mod_timer(&tun->flow_gc_timer, round_jiffies_up(next_timer));
	spin_unlock_bh(&tun->lock);
}

300
static void tun_flow_update(struct tun_struct *tun, u32 rxhash,
301
			    struct tun_file *tfile)
J
Jason Wang 已提交
302 303 304 305
{
	struct hlist_head *head;
	struct tun_flow_entry *e;
	unsigned long delay = tun->ageing_time;
306
	u16 queue_index = tfile->queue_index;
J
Jason Wang 已提交
307 308 309 310 311 312 313 314

	if (!rxhash)
		return;
	else
		head = &tun->flows[tun_hashfn(rxhash)];

	rcu_read_lock();

315 316 317
	/* We may get a very small possibility of OOO during switching, not
	 * worth to optimize.*/
	if (tun->numqueues == 1 || tfile->detached)
J
Jason Wang 已提交
318 319 320 321 322 323 324 325 326
		goto unlock;

	e = tun_flow_find(head, rxhash);
	if (likely(e)) {
		/* TODO: keep queueing to old queue until it's empty? */
		e->queue_index = queue_index;
		e->updated = jiffies;
	} else {
		spin_lock_bh(&tun->lock);
327 328
		if (!tun_flow_find(head, rxhash) &&
		    tun->flow_count < MAX_TAP_FLOWS)
J
Jason Wang 已提交
329 330 331 332 333 334 335 336 337 338 339 340
			tun_flow_create(tun, head, rxhash, queue_index);

		if (!timer_pending(&tun->flow_gc_timer))
			mod_timer(&tun->flow_gc_timer,
				  round_jiffies_up(jiffies + delay));
		spin_unlock_bh(&tun->lock);
	}

unlock:
	rcu_read_unlock();
}

J
Jason Wang 已提交
341 342 343 344 345 346 347 348 349 350
/* We try to identify a flow through its rxhash first. The reason that
 * we do not check rxq no. is becuase some cards(e.g 82599), chooses
 * the rxq based on the txq where the last packet of the flow comes. As
 * the userspace application move between processors, we may get a
 * different rxq no. here. If we could not get rxhash, then we would
 * hope the rxq no. may help here.
 */
static u16 tun_select_queue(struct net_device *dev, struct sk_buff *skb)
{
	struct tun_struct *tun = netdev_priv(dev);
J
Jason Wang 已提交
351
	struct tun_flow_entry *e;
J
Jason Wang 已提交
352 353 354 355
	u32 txq = 0;
	u32 numqueues = 0;

	rcu_read_lock();
356
	numqueues = ACCESS_ONCE(tun->numqueues);
J
Jason Wang 已提交
357 358 359

	txq = skb_get_rxhash(skb);
	if (txq) {
J
Jason Wang 已提交
360 361 362 363 364 365
		e = tun_flow_find(&tun->flows[tun_hashfn(txq)], txq);
		if (e)
			txq = e->queue_index;
		else
			/* use multiply and shift instead of expensive divide */
			txq = ((u64)txq * numqueues) >> 32;
J
Jason Wang 已提交
366 367 368 369 370 371 372 373 374 375
	} else if (likely(skb_rx_queue_recorded(skb))) {
		txq = skb_get_rx_queue(skb);
		while (unlikely(txq >= numqueues))
			txq -= numqueues;
	}

	rcu_read_unlock();
	return txq;
}

376 377 378
static inline bool tun_not_capable(struct tun_struct *tun)
{
	const struct cred *cred = current_cred();
379
	struct net *net = dev_net(tun->dev);
380 381 382

	return ((uid_valid(tun->owner) && !uid_eq(cred->euid, tun->owner)) ||
		  (gid_valid(tun->group) && !in_egroup_p(tun->group))) &&
383
		!ns_capable(net->user_ns, CAP_NET_ADMIN);
384 385
}

J
Jason Wang 已提交
386 387 388 389 390 391
static void tun_set_real_num_queues(struct tun_struct *tun)
{
	netif_set_real_num_tx_queues(tun->dev, tun->numqueues);
	netif_set_real_num_rx_queues(tun->dev, tun->numqueues);
}

J
Jason Wang 已提交
392 393 394 395 396 397 398
static void tun_disable_queue(struct tun_struct *tun, struct tun_file *tfile)
{
	tfile->detached = tun;
	list_add_tail(&tfile->next, &tun->disabled);
	++tun->numdisabled;
}

J
Jason Wang 已提交
399
static struct tun_struct *tun_enable_queue(struct tun_file *tfile)
J
Jason Wang 已提交
400 401 402 403 404 405 406 407 408
{
	struct tun_struct *tun = tfile->detached;

	tfile->detached = NULL;
	list_del_init(&tfile->next);
	--tun->numdisabled;
	return tun;
}

J
Jason Wang 已提交
409 410 411 412 413
static void __tun_detach(struct tun_file *tfile, bool clean)
{
	struct tun_file *ntfile;
	struct tun_struct *tun;

414 415
	tun = rtnl_dereference(tfile->tun);

416
	if (tun && !tfile->detached) {
J
Jason Wang 已提交
417 418 419 420 421
		u16 index = tfile->queue_index;
		BUG_ON(index >= tun->numqueues);

		rcu_assign_pointer(tun->tfiles[index],
				   tun->tfiles[tun->numqueues - 1]);
422
		ntfile = rtnl_dereference(tun->tfiles[index]);
J
Jason Wang 已提交
423 424 425
		ntfile->queue_index = index;

		--tun->numqueues;
426 427
		if (clean) {
			rcu_assign_pointer(tfile->tun, NULL);
J
Jason Wang 已提交
428
			sock_put(&tfile->sk);
429
		} else
J
Jason Wang 已提交
430
			tun_disable_queue(tun, tfile);
J
Jason Wang 已提交
431 432

		synchronize_net();
J
Jason Wang 已提交
433
		tun_flow_delete_by_queue(tun, tun->numqueues + 1);
J
Jason Wang 已提交
434 435 436
		/* Drop read queue */
		skb_queue_purge(&tfile->sk.sk_receive_queue);
		tun_set_real_num_queues(tun);
J
Jason Wang 已提交
437
	} else if (tfile->detached && clean) {
J
Jason Wang 已提交
438
		tun = tun_enable_queue(tfile);
J
Jason Wang 已提交
439 440
		sock_put(&tfile->sk);
	}
J
Jason Wang 已提交
441 442

	if (clean) {
443 444 445 446 447
		if (tun && tun->numqueues == 0 && tun->numdisabled == 0) {
			netif_carrier_off(tun->dev);

			if (!(tun->flags & TUN_PERSIST) &&
			    tun->dev->reg_state == NETREG_REGISTERED)
J
Jason Wang 已提交
448
				unregister_netdevice(tun->dev);
449
		}
J
Jason Wang 已提交
450

J
Jason Wang 已提交
451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466
		BUG_ON(!test_bit(SOCK_EXTERNALLY_ALLOCATED,
				 &tfile->socket.flags));
		sk_release_kernel(&tfile->sk);
	}
}

static void tun_detach(struct tun_file *tfile, bool clean)
{
	rtnl_lock();
	__tun_detach(tfile, clean);
	rtnl_unlock();
}

static void tun_detach_all(struct net_device *dev)
{
	struct tun_struct *tun = netdev_priv(dev);
J
Jason Wang 已提交
467
	struct tun_file *tfile, *tmp;
J
Jason Wang 已提交
468 469 470
	int i, n = tun->numqueues;

	for (i = 0; i < n; i++) {
471
		tfile = rtnl_dereference(tun->tfiles[i]);
J
Jason Wang 已提交
472 473 474 475 476
		BUG_ON(!tfile);
		wake_up_all(&tfile->wq.wait);
		rcu_assign_pointer(tfile->tun, NULL);
		--tun->numqueues;
	}
477 478 479 480
	list_for_each_entry(tfile, &tun->disabled, next) {
		wake_up_all(&tfile->wq.wait);
		rcu_assign_pointer(tfile->tun, NULL);
	}
J
Jason Wang 已提交
481 482 483 484
	BUG_ON(tun->numqueues != 0);

	synchronize_net();
	for (i = 0; i < n; i++) {
485
		tfile = rtnl_dereference(tun->tfiles[i]);
J
Jason Wang 已提交
486 487 488 489
		/* Drop read queue */
		skb_queue_purge(&tfile->sk.sk_receive_queue);
		sock_put(&tfile->sk);
	}
J
Jason Wang 已提交
490 491 492 493 494 495
	list_for_each_entry_safe(tfile, tmp, &tun->disabled, next) {
		tun_enable_queue(tfile);
		skb_queue_purge(&tfile->sk.sk_receive_queue);
		sock_put(&tfile->sk);
	}
	BUG_ON(tun->numdisabled != 0);
J
Jason Wang 已提交
496 497 498

	if (tun->flags & TUN_PERSIST)
		module_put(THIS_MODULE);
J
Jason Wang 已提交
499 500
}

501 502
static int tun_attach(struct tun_struct *tun, struct file *file)
{
E
Eric W. Biederman 已提交
503
	struct tun_file *tfile = file->private_data;
504
	int err;
505

506 507 508 509
	err = security_tun_dev_attach(tfile->socket.sk, tun->security);
	if (err < 0)
		goto out;

510
	err = -EINVAL;
511
	if (rtnl_dereference(tfile->tun) && !tfile->detached)
512 513 514
		goto out;

	err = -EBUSY;
J
Jason Wang 已提交
515 516 517 518
	if (!(tun->flags & TUN_TAP_MQ) && tun->numqueues == 1)
		goto out;

	err = -E2BIG;
J
Jason Wang 已提交
519 520
	if (!tfile->detached &&
	    tun->numqueues + tun->numdisabled == MAX_TAP_QUEUES)
521 522 523
		goto out;

	err = 0;
J
Jason Wang 已提交
524

J
Jason Wang 已提交
525
	/* Re-attach the filter to presist device */
J
Jason Wang 已提交
526 527 528 529 530
	if (tun->filter_attached == true) {
		err = sk_attach_filter(&tun->fprog, tfile->socket.sk);
		if (!err)
			goto out;
	}
J
Jason Wang 已提交
531
	tfile->queue_index = tun->numqueues;
532
	rcu_assign_pointer(tfile->tun, tun);
J
Jason Wang 已提交
533 534
	rcu_assign_pointer(tun->tfiles[tun->numqueues], tfile);
	tun->numqueues++;
535

J
Jason Wang 已提交
536 537 538 539 540
	if (tfile->detached)
		tun_enable_queue(tfile);
	else
		sock_hold(&tfile->sk);

J
Jason Wang 已提交
541
	tun_set_real_num_queues(tun);
542

J
Jason Wang 已提交
543 544 545 546 547 548
	/* device is allowed to go away first, so no need to hold extra
	 * refcnt.
	 */

out:
	return err;
E
Eric W. Biederman 已提交
549 550 551 552
}

static struct tun_struct *__tun_get(struct tun_file *tfile)
{
553
	struct tun_struct *tun;
554

555 556 557 558 559
	rcu_read_lock();
	tun = rcu_dereference(tfile->tun);
	if (tun)
		dev_hold(tun->dev);
	rcu_read_unlock();
560 561

	return tun;
E
Eric W. Biederman 已提交
562 563 564 565 566 567 568 569 570
}

static struct tun_struct *tun_get(struct file *file)
{
	return __tun_get(file->private_data);
}

static void tun_put(struct tun_struct *tun)
{
571
	dev_put(tun->dev);
E
Eric W. Biederman 已提交
572 573
}

574
/* TAP filtering */
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 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623
static void addr_hash_set(u32 *mask, const u8 *addr)
{
	int n = ether_crc(ETH_ALEN, addr) >> 26;
	mask[n >> 5] |= (1 << (n & 31));
}

static unsigned int addr_hash_test(const u32 *mask, const u8 *addr)
{
	int n = ether_crc(ETH_ALEN, addr) >> 26;
	return mask[n >> 5] & (1 << (n & 31));
}

static int update_filter(struct tap_filter *filter, void __user *arg)
{
	struct { u8 u[ETH_ALEN]; } *addr;
	struct tun_filter uf;
	int err, alen, n, nexact;

	if (copy_from_user(&uf, arg, sizeof(uf)))
		return -EFAULT;

	if (!uf.count) {
		/* Disabled */
		filter->count = 0;
		return 0;
	}

	alen = ETH_ALEN * uf.count;
	addr = kmalloc(alen, GFP_KERNEL);
	if (!addr)
		return -ENOMEM;

	if (copy_from_user(addr, arg + sizeof(uf), alen)) {
		err = -EFAULT;
		goto done;
	}

	/* The filter is updated without holding any locks. Which is
	 * perfectly safe. We disable it first and in the worst
	 * case we'll accept a few undesired packets. */
	filter->count = 0;
	wmb();

	/* Use first set of addresses as an exact filter */
	for (n = 0; n < uf.count && n < FLT_EXACT_COUNT; n++)
		memcpy(filter->addr[n], addr[n].u, ETH_ALEN);

	nexact = n;

624 625
	/* Remaining multicast addresses are hashed,
	 * unicast will leave the filter disabled. */
626
	memset(filter->mask, 0, sizeof(filter->mask));
627 628 629 630 631
	for (; n < uf.count; n++) {
		if (!is_multicast_ether_addr(addr[n].u)) {
			err = 0; /* no filter */
			goto done;
		}
632
		addr_hash_set(filter->mask, addr[n].u);
633
	}
634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661

	/* For ALLMULTI just set the mask to all ones.
	 * This overrides the mask populated above. */
	if ((uf.flags & TUN_FLT_ALLMULTI))
		memset(filter->mask, ~0, sizeof(filter->mask));

	/* Now enable the filter */
	wmb();
	filter->count = nexact;

	/* Return the number of exact filters */
	err = nexact;

done:
	kfree(addr);
	return err;
}

/* Returns: 0 - drop, !=0 - accept */
static int run_filter(struct tap_filter *filter, const struct sk_buff *skb)
{
	/* Cannot use eth_hdr(skb) here because skb_mac_hdr() is incorrect
	 * at this point. */
	struct ethhdr *eh = (struct ethhdr *) skb->data;
	int i;

	/* Exact match */
	for (i = 0; i < filter->count; i++)
662
		if (ether_addr_equal(eh->h_dest, filter->addr[i]))
663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683
			return 1;

	/* Inexact match (multicast only) */
	if (is_multicast_ether_addr(eh->h_dest))
		return addr_hash_test(filter->mask, eh->h_dest);

	return 0;
}

/*
 * Checks whether the packet is accepted or not.
 * Returns: 0 - drop, !=0 - accept
 */
static int check_filter(struct tap_filter *filter, const struct sk_buff *skb)
{
	if (!filter->count)
		return 1;

	return run_filter(filter, skb);
}

L
Linus Torvalds 已提交
684 685
/* Network device part of the driver */

686
static const struct ethtool_ops tun_ethtool_ops;
L
Linus Torvalds 已提交
687

688 689 690
/* Net device detach from fd. */
static void tun_net_uninit(struct net_device *dev)
{
J
Jason Wang 已提交
691
	tun_detach_all(dev);
692 693
}

L
Linus Torvalds 已提交
694 695 696
/* Net device open. */
static int tun_net_open(struct net_device *dev)
{
J
Jason Wang 已提交
697
	netif_tx_start_all_queues(dev);
L
Linus Torvalds 已提交
698 699 700 701 702 703
	return 0;
}

/* Net device close. */
static int tun_net_close(struct net_device *dev)
{
J
Jason Wang 已提交
704
	netif_tx_stop_all_queues(dev);
L
Linus Torvalds 已提交
705 706 707 708
	return 0;
}

/* Net device start xmit */
709
static netdev_tx_t tun_net_xmit(struct sk_buff *skb, struct net_device *dev)
L
Linus Torvalds 已提交
710 711
{
	struct tun_struct *tun = netdev_priv(dev);
J
Jason Wang 已提交
712
	int txq = skb->queue_mapping;
713
	struct tun_file *tfile;
L
Linus Torvalds 已提交
714

715
	rcu_read_lock();
J
Jason Wang 已提交
716 717
	tfile = rcu_dereference(tun->tfiles[txq]);

L
Linus Torvalds 已提交
718
	/* Drop packet if interface is not attached */
J
Jason Wang 已提交
719
	if (txq >= tun->numqueues)
L
Linus Torvalds 已提交
720 721
		goto drop;

722 723
	tun_debug(KERN_INFO, tun, "tun_net_xmit %d\n", skb->len);

J
Jason Wang 已提交
724 725
	BUG_ON(!tfile);

726 727 728 729 730 731
	/* Drop if the filter does not like it.
	 * This is a noop if the filter is disabled.
	 * Filter can be enabled only for the TAP devices. */
	if (!check_filter(&tun->txflt, skb))
		goto drop;

J
Jason Wang 已提交
732 733
	if (tfile->socket.sk->sk_filter &&
	    sk_filter(tfile->socket.sk, skb))
M
Michael S. Tsirkin 已提交
734 735
		goto drop;

R
Rami Rosen 已提交
736
	/* Limit the number of packets queued by dividing txq length with the
J
Jason Wang 已提交
737 738
	 * number of queues.
	 */
J
Jason Wang 已提交
739
	if (skb_queue_len(&tfile->socket.sk->sk_receive_queue)
740 741
			  >= dev->tx_queue_len / tun->numqueues)
		goto drop;
L
Linus Torvalds 已提交
742

743 744 745 746 747
	if (skb->sk) {
		sock_tx_timestamp(skb->sk, &skb_shinfo(skb)->tx_flags);
		sw_tx_timestamp(skb);
	}

M
Michael S. Tsirkin 已提交
748 749
	/* Orphan the skb - required as we might hang on to it
	 * for indefinite time. */
M
Michael S. Tsirkin 已提交
750 751
	if (unlikely(skb_orphan_frags(skb, GFP_ATOMIC)))
		goto drop;
M
Michael S. Tsirkin 已提交
752 753
	skb_orphan(skb);

754 755
	nf_reset(skb);

756
	/* Enqueue packet */
J
Jason Wang 已提交
757
	skb_queue_tail(&tfile->socket.sk->sk_receive_queue, skb);
L
Linus Torvalds 已提交
758 759

	/* Notify and wake up reader process */
J
Jason Wang 已提交
760 761 762
	if (tfile->flags & TUN_FASYNC)
		kill_fasync(&tfile->fasync, SIGIO, POLL_IN);
	wake_up_interruptible_poll(&tfile->wq.wait, POLLIN |
763
				   POLLRDNORM | POLLRDBAND);
764 765

	rcu_read_unlock();
766
	return NETDEV_TX_OK;
L
Linus Torvalds 已提交
767 768

drop:
769
	dev->stats.tx_dropped++;
770
	skb_tx_error(skb);
L
Linus Torvalds 已提交
771
	kfree_skb(skb);
772
	rcu_read_unlock();
773
	return NETDEV_TX_OK;
L
Linus Torvalds 已提交
774 775
}

776
static void tun_net_mclist(struct net_device *dev)
L
Linus Torvalds 已提交
777
{
778 779 780 781 782
	/*
	 * This callback is supposed to deal with mc filter in
	 * _rx_ path and has nothing to do with the _tx_ path.
	 * In rx path we always accept everything userspace gives us.
	 */
L
Linus Torvalds 已提交
783 784
}

E
Ed Swierk 已提交
785 786 787 788 789 790 791 792 793 794 795 796
#define MIN_MTU 68
#define MAX_MTU 65535

static int
tun_net_change_mtu(struct net_device *dev, int new_mtu)
{
	if (new_mtu < MIN_MTU || new_mtu + dev->hard_header_len > MAX_MTU)
		return -EINVAL;
	dev->mtu = new_mtu;
	return 0;
}

797 798
static netdev_features_t tun_net_fix_features(struct net_device *dev,
	netdev_features_t features)
799 800 801 802 803
{
	struct tun_struct *tun = netdev_priv(dev);

	return (features & tun->set_features) | (features & ~TUN_USER_FEATURES);
}
804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820
#ifdef CONFIG_NET_POLL_CONTROLLER
static void tun_poll_controller(struct net_device *dev)
{
	/*
	 * Tun only receives frames when:
	 * 1) the char device endpoint gets data from user space
	 * 2) the tun socket gets a sendmsg call from user space
	 * Since both of those are syncronous operations, we are guaranteed
	 * never to have pending data when we poll for it
	 * so theres nothing to do here but return.
	 * We need this though so netpoll recognizes us as an interface that
	 * supports polling, which enables bridge devices in virt setups to
	 * still use netconsole
	 */
	return;
}
#endif
S
Stephen Hemminger 已提交
821
static const struct net_device_ops tun_netdev_ops = {
822
	.ndo_uninit		= tun_net_uninit,
S
Stephen Hemminger 已提交
823 824
	.ndo_open		= tun_net_open,
	.ndo_stop		= tun_net_close,
825
	.ndo_start_xmit		= tun_net_xmit,
S
Stephen Hemminger 已提交
826
	.ndo_change_mtu		= tun_net_change_mtu,
827
	.ndo_fix_features	= tun_net_fix_features,
J
Jason Wang 已提交
828
	.ndo_select_queue	= tun_select_queue,
829 830 831
#ifdef CONFIG_NET_POLL_CONTROLLER
	.ndo_poll_controller	= tun_poll_controller,
#endif
S
Stephen Hemminger 已提交
832 833 834
};

static const struct net_device_ops tap_netdev_ops = {
835
	.ndo_uninit		= tun_net_uninit,
S
Stephen Hemminger 已提交
836 837
	.ndo_open		= tun_net_open,
	.ndo_stop		= tun_net_close,
838
	.ndo_start_xmit		= tun_net_xmit,
S
Stephen Hemminger 已提交
839
	.ndo_change_mtu		= tun_net_change_mtu,
840
	.ndo_fix_features	= tun_net_fix_features,
841
	.ndo_set_rx_mode	= tun_net_mclist,
S
Stephen Hemminger 已提交
842 843
	.ndo_set_mac_address	= eth_mac_addr,
	.ndo_validate_addr	= eth_validate_addr,
J
Jason Wang 已提交
844
	.ndo_select_queue	= tun_select_queue,
845 846 847
#ifdef CONFIG_NET_POLL_CONTROLLER
	.ndo_poll_controller	= tun_poll_controller,
#endif
S
Stephen Hemminger 已提交
848 849
};

850
static void tun_flow_init(struct tun_struct *tun)
J
Jason Wang 已提交
851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868
{
	int i;

	for (i = 0; i < TUN_NUM_FLOW_ENTRIES; i++)
		INIT_HLIST_HEAD(&tun->flows[i]);

	tun->ageing_time = TUN_FLOW_EXPIRE;
	setup_timer(&tun->flow_gc_timer, tun_flow_cleanup, (unsigned long)tun);
	mod_timer(&tun->flow_gc_timer,
		  round_jiffies_up(jiffies + tun->ageing_time));
}

static void tun_flow_uninit(struct tun_struct *tun)
{
	del_timer_sync(&tun->flow_gc_timer);
	tun_flow_flush(tun);
}

L
Linus Torvalds 已提交
869 870 871 872
/* Initialize net device. */
static void tun_net_init(struct net_device *dev)
{
	struct tun_struct *tun = netdev_priv(dev);
873

L
Linus Torvalds 已提交
874 875
	switch (tun->flags & TUN_TYPE_MASK) {
	case TUN_TUN_DEV:
S
Stephen Hemminger 已提交
876 877
		dev->netdev_ops = &tun_netdev_ops;

L
Linus Torvalds 已提交
878 879 880 881 882 883
		/* Point-to-Point TUN Device */
		dev->hard_header_len = 0;
		dev->addr_len = 0;
		dev->mtu = 1500;

		/* Zero header length */
884
		dev->type = ARPHRD_NONE;
L
Linus Torvalds 已提交
885 886 887 888 889
		dev->flags = IFF_POINTOPOINT | IFF_NOARP | IFF_MULTICAST;
		dev->tx_queue_len = TUN_READQ_SIZE;  /* We prefer our own queue length */
		break;

	case TUN_TAP_DEV:
K
Kusanagi Kouichi 已提交
890
		dev->netdev_ops = &tap_netdev_ops;
L
Linus Torvalds 已提交
891 892
		/* Ethernet TAP Device */
		ether_setup(dev);
893
		dev->priv_flags &= ~IFF_TX_SKB_SHARING;
894
		dev->priv_flags |= IFF_LIVE_ADDR_CHANGE;
895

896
		eth_hw_addr_random(dev);
897

L
Linus Torvalds 已提交
898 899 900 901 902 903 904 905
		dev->tx_queue_len = TUN_READQ_SIZE;  /* We prefer our own queue length */
		break;
	}
}

/* Character device part */

/* Poll */
J
Jason Wang 已提交
906
static unsigned int tun_chr_poll(struct file *file, poll_table *wait)
907
{
908 909
	struct tun_file *tfile = file->private_data;
	struct tun_struct *tun = __tun_get(tfile);
910
	struct sock *sk;
911
	unsigned int mask = 0;
L
Linus Torvalds 已提交
912 913

	if (!tun)
914
		return POLLERR;
L
Linus Torvalds 已提交
915

J
Jason Wang 已提交
916
	sk = tfile->socket.sk;
917

918
	tun_debug(KERN_INFO, tun, "tun_chr_poll\n");
L
Linus Torvalds 已提交
919

J
Jason Wang 已提交
920
	poll_wait(file, &tfile->wq.wait, wait);
921

922
	if (!skb_queue_empty(&sk->sk_receive_queue))
L
Linus Torvalds 已提交
923 924
		mask |= POLLIN | POLLRDNORM;

925 926 927 928 929
	if (sock_writeable(sk) ||
	    (!test_and_set_bit(SOCK_ASYNC_NOSPACE, &sk->sk_socket->flags) &&
	     sock_writeable(sk)))
		mask |= POLLOUT | POLLWRNORM;

930 931 932
	if (tun->dev->reg_state != NETREG_REGISTERED)
		mask = POLLERR;

E
Eric W. Biederman 已提交
933
	tun_put(tun);
L
Linus Torvalds 已提交
934 935 936
	return mask;
}

937 938
/* prepad is the amount to reserve at front.  len is length after that.
 * linear is a hint as to how much to copy (usually headers). */
J
Jason Wang 已提交
939
static struct sk_buff *tun_alloc_skb(struct tun_file *tfile,
940 941
				     size_t prepad, size_t len,
				     size_t linear, int noblock)
942
{
J
Jason Wang 已提交
943
	struct sock *sk = tfile->socket.sk;
944
	struct sk_buff *skb;
945
	int err;
946 947

	/* Under a page?  Don't bother with paged skb. */
H
Herbert Xu 已提交
948
	if (prepad + len < PAGE_SIZE || !linear)
949
		linear = len;
950

951 952
	skb = sock_alloc_send_pskb(sk, prepad + linear, len - linear, noblock,
				   &err);
953
	if (!skb)
954
		return ERR_PTR(err);
955 956 957

	skb_reserve(skb, prepad);
	skb_put(skb, linear);
958 959
	skb->data_len = len - linear;
	skb->len += len - linear;
960 961 962 963

	return skb;
}

L
Linus Torvalds 已提交
964
/* Get packet from user space buffer */
J
Jason Wang 已提交
965 966 967
static ssize_t tun_get_user(struct tun_struct *tun, struct tun_file *tfile,
			    void *msg_control, const struct iovec *iv,
			    size_t total_len, size_t count, int noblock)
L
Linus Torvalds 已提交
968
{
969
	struct tun_pi pi = { 0, cpu_to_be16(ETH_P_IP) };
L
Linus Torvalds 已提交
970
	struct sk_buff *skb;
971
	size_t len = total_len, align = NET_SKB_PAD, linear;
972
	struct virtio_net_hdr gso = { 0 };
973
	int offset = 0;
974 975 976
	int copylen;
	bool zerocopy = false;
	int err;
977
	u32 rxhash;
L
Linus Torvalds 已提交
978 979

	if (!(tun->flags & TUN_NO_PI)) {
980
		if ((len -= sizeof(pi)) > total_len)
L
Linus Torvalds 已提交
981 982
			return -EINVAL;

983
		if (memcpy_fromiovecend((void *)&pi, iv, 0, sizeof(pi)))
L
Linus Torvalds 已提交
984
			return -EFAULT;
985
		offset += sizeof(pi);
L
Linus Torvalds 已提交
986 987
	}

988
	if (tun->flags & TUN_VNET_HDR) {
989
		if ((len -= tun->vnet_hdr_sz) > total_len)
990 991
			return -EINVAL;

992
		if (memcpy_fromiovecend((void *)&gso, iv, offset, sizeof(gso)))
993 994
			return -EFAULT;

995 996 997 998
		if ((gso.flags & VIRTIO_NET_HDR_F_NEEDS_CSUM) &&
		    gso.csum_start + gso.csum_offset + 2 > gso.hdr_len)
			gso.hdr_len = gso.csum_start + gso.csum_offset + 2;

999 1000
		if (gso.hdr_len > len)
			return -EINVAL;
1001
		offset += tun->vnet_hdr_sz;
1002 1003
	}

1004
	if ((tun->flags & TUN_TYPE_MASK) == TUN_TAP_DEV) {
1005
		align += NET_IP_ALIGN;
H
Herbert Xu 已提交
1006 1007
		if (unlikely(len < ETH_HLEN ||
			     (gso.hdr_len && gso.hdr_len < ETH_HLEN)))
1008 1009
			return -EINVAL;
	}
1010

1011 1012 1013
	if (msg_control) {
		/* There are 256 bytes to be copied in skb, so there is
		 * enough room for skb expand head in case it is used.
1014 1015
		 * The rest of the buffer is mapped from userspace.
		 */
1016
		copylen = gso.hdr_len ? gso.hdr_len : GOODCOPY_LEN;
1017
		linear = copylen;
1018 1019 1020 1021 1022
		if (iov_pages(iv, offset + copylen, count) <= MAX_SKB_FRAGS)
			zerocopy = true;
	}

	if (!zerocopy) {
1023
		copylen = len;
1024 1025
		linear = gso.hdr_len;
	}
1026

1027
	skb = tun_alloc_skb(tfile, align, copylen, linear, noblock);
1028 1029 1030 1031
	if (IS_ERR(skb)) {
		if (PTR_ERR(skb) != -EAGAIN)
			tun->dev->stats.rx_dropped++;
		return PTR_ERR(skb);
L
Linus Torvalds 已提交
1032 1033
	}

1034 1035
	if (zerocopy)
		err = zerocopy_sg_from_iovec(skb, iv, offset, count);
1036
	else {
1037
		err = skb_copy_datagram_from_iovec(skb, 0, iv, offset, len);
1038 1039 1040 1041 1042
		if (!err && msg_control) {
			struct ubuf_info *uarg = msg_control;
			uarg->callback(uarg, false);
		}
	}
1043 1044

	if (err) {
1045
		tun->dev->stats.rx_dropped++;
D
Dave Jones 已提交
1046
		kfree_skb(skb);
L
Linus Torvalds 已提交
1047
		return -EFAULT;
D
Dave Jones 已提交
1048
	}
L
Linus Torvalds 已提交
1049

1050 1051 1052 1053 1054 1055 1056
	if (gso.flags & VIRTIO_NET_HDR_F_NEEDS_CSUM) {
		if (!skb_partial_csum_set(skb, gso.csum_start,
					  gso.csum_offset)) {
			tun->dev->stats.rx_frame_errors++;
			kfree_skb(skb);
			return -EINVAL;
		}
1057
	}
1058

L
Linus Torvalds 已提交
1059 1060
	switch (tun->flags & TUN_TYPE_MASK) {
	case TUN_TUN_DEV:
1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075
		if (tun->flags & TUN_NO_PI) {
			switch (skb->data[0] & 0xf0) {
			case 0x40:
				pi.proto = htons(ETH_P_IP);
				break;
			case 0x60:
				pi.proto = htons(ETH_P_IPV6);
				break;
			default:
				tun->dev->stats.rx_dropped++;
				kfree_skb(skb);
				return -EINVAL;
			}
		}

1076
		skb_reset_mac_header(skb);
L
Linus Torvalds 已提交
1077
		skb->protocol = pi.proto;
1078
		skb->dev = tun->dev;
L
Linus Torvalds 已提交
1079 1080 1081 1082
		break;
	case TUN_TAP_DEV:
		skb->protocol = eth_type_trans(skb, tun->dev);
		break;
1083
	}
L
Linus Torvalds 已提交
1084

1085 1086 1087 1088
	if (gso.gso_type != VIRTIO_NET_HDR_GSO_NONE) {
		pr_debug("GSO!\n");
		switch (gso.gso_type & ~VIRTIO_NET_HDR_GSO_ECN) {
		case VIRTIO_NET_HDR_GSO_TCPV4:
1089
			skb_shinfo(skb)->gso_type = SKB_GSO_TCPV4;
1090 1091
			break;
		case VIRTIO_NET_HDR_GSO_TCPV6:
1092
			skb_shinfo(skb)->gso_type = SKB_GSO_TCPV6;
1093
			break;
1094
		case VIRTIO_NET_HDR_GSO_UDP:
1095
			skb_shinfo(skb)->gso_type = SKB_GSO_UDP;
1096
			break;
1097 1098 1099 1100 1101 1102 1103
		default:
			tun->dev->stats.rx_frame_errors++;
			kfree_skb(skb);
			return -EINVAL;
		}

		if (gso.gso_type & VIRTIO_NET_HDR_GSO_ECN)
1104
			skb_shinfo(skb)->gso_type |= SKB_GSO_TCP_ECN;
1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116

		skb_shinfo(skb)->gso_size = gso.gso_size;
		if (skb_shinfo(skb)->gso_size == 0) {
			tun->dev->stats.rx_frame_errors++;
			kfree_skb(skb);
			return -EINVAL;
		}

		/* Header must be checked, and gso_segs computed. */
		skb_shinfo(skb)->gso_type |= SKB_GSO_DODGY;
		skb_shinfo(skb)->gso_segs = 0;
	}
1117

1118 1119 1120 1121
	/* copy skb_ubuf_info for callback when skb has no error */
	if (zerocopy) {
		skb_shinfo(skb)->destructor_arg = msg_control;
		skb_shinfo(skb)->tx_flags |= SKBTX_DEV_ZEROCOPY;
1122
		skb_shinfo(skb)->tx_flags |= SKBTX_SHARED_FRAG;
1123 1124
	}

1125
	skb_reset_network_header(skb);
1126
	skb_probe_transport_header(skb, 0);
1127

1128
	rxhash = skb_get_rxhash(skb);
L
Linus Torvalds 已提交
1129
	netif_rx_ni(skb);
1130

1131 1132
	tun->dev->stats.rx_packets++;
	tun->dev->stats.rx_bytes += len;
L
Linus Torvalds 已提交
1133

1134
	tun_flow_update(tun, rxhash, tfile);
1135
	return total_len;
1136
}
L
Linus Torvalds 已提交
1137

1138 1139
static ssize_t tun_chr_aio_write(struct kiocb *iocb, const struct iovec *iv,
			      unsigned long count, loff_t pos)
L
Linus Torvalds 已提交
1140
{
1141
	struct file *file = iocb->ki_filp;
H
Herbert Xu 已提交
1142
	struct tun_struct *tun = tun_get(file);
J
Jason Wang 已提交
1143
	struct tun_file *tfile = file->private_data;
E
Eric W. Biederman 已提交
1144
	ssize_t result;
L
Linus Torvalds 已提交
1145 1146 1147 1148

	if (!tun)
		return -EBADFD;

1149
	tun_debug(KERN_INFO, tun, "tun_chr_write %ld\n", count);
L
Linus Torvalds 已提交
1150

J
Jason Wang 已提交
1151 1152
	result = tun_get_user(tun, tfile, NULL, iv, iov_length(iv, count),
			      count, file->f_flags & O_NONBLOCK);
E
Eric W. Biederman 已提交
1153 1154 1155

	tun_put(tun);
	return result;
L
Linus Torvalds 已提交
1156 1157 1158
}

/* Put packet to the user space buffer */
1159
static ssize_t tun_put_user(struct tun_struct *tun,
J
Jason Wang 已提交
1160
			    struct tun_file *tfile,
1161 1162
			    struct sk_buff *skb,
			    const struct iovec *iv, int len)
L
Linus Torvalds 已提交
1163 1164 1165
{
	struct tun_pi pi = { 0, skb->protocol };
	ssize_t total = 0;
J
Jason Wang 已提交
1166
	int vlan_offset = 0;
L
Linus Torvalds 已提交
1167 1168 1169 1170 1171 1172 1173 1174 1175

	if (!(tun->flags & TUN_NO_PI)) {
		if ((len -= sizeof(pi)) < 0)
			return -EINVAL;

		if (len < skb->len) {
			/* Packet will be striped */
			pi.flags |= TUN_PKT_STRIP;
		}
1176

1177
		if (memcpy_toiovecend(iv, (void *) &pi, 0, sizeof(pi)))
L
Linus Torvalds 已提交
1178 1179
			return -EFAULT;
		total += sizeof(pi);
1180
	}
L
Linus Torvalds 已提交
1181

1182 1183
	if (tun->flags & TUN_VNET_HDR) {
		struct virtio_net_hdr gso = { 0 }; /* no info leak */
1184
		if ((len -= tun->vnet_hdr_sz) < 0)
1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196
			return -EINVAL;

		if (skb_is_gso(skb)) {
			struct skb_shared_info *sinfo = skb_shinfo(skb);

			/* This is a hint as to how much should be linear. */
			gso.hdr_len = skb_headlen(skb);
			gso.gso_size = sinfo->gso_size;
			if (sinfo->gso_type & SKB_GSO_TCPV4)
				gso.gso_type = VIRTIO_NET_HDR_GSO_TCPV4;
			else if (sinfo->gso_type & SKB_GSO_TCPV6)
				gso.gso_type = VIRTIO_NET_HDR_GSO_TCPV6;
1197 1198
			else if (sinfo->gso_type & SKB_GSO_UDP)
				gso.gso_type = VIRTIO_NET_HDR_GSO_UDP;
1199
			else {
1200
				pr_err("unexpected GSO type: "
1201 1202 1203 1204 1205 1206 1207 1208 1209 1210
				       "0x%x, gso_size %d, hdr_len %d\n",
				       sinfo->gso_type, gso.gso_size,
				       gso.hdr_len);
				print_hex_dump(KERN_ERR, "tun: ",
					       DUMP_PREFIX_NONE,
					       16, 1, skb->head,
					       min((int)gso.hdr_len, 64), true);
				WARN_ON_ONCE(1);
				return -EINVAL;
			}
1211 1212 1213 1214 1215 1216 1217
			if (sinfo->gso_type & SKB_GSO_TCP_ECN)
				gso.gso_type |= VIRTIO_NET_HDR_GSO_ECN;
		} else
			gso.gso_type = VIRTIO_NET_HDR_GSO_NONE;

		if (skb->ip_summed == CHECKSUM_PARTIAL) {
			gso.flags = VIRTIO_NET_HDR_F_NEEDS_CSUM;
1218
			gso.csum_start = skb_checksum_start_offset(skb);
1219
			gso.csum_offset = skb->csum_offset;
1220 1221
		} else if (skb->ip_summed == CHECKSUM_UNNECESSARY) {
			gso.flags = VIRTIO_NET_HDR_F_DATA_VALID;
1222 1223
		} /* else everything is zero */

1224 1225
		if (unlikely(memcpy_toiovecend(iv, (void *)&gso, total,
					       sizeof(gso))))
1226
			return -EFAULT;
1227
		total += tun->vnet_hdr_sz;
1228 1229
	}

J
Jason Wang 已提交
1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258
	if (!vlan_tx_tag_present(skb)) {
		len = min_t(int, skb->len, len);
	} else {
		int copy, ret;
		struct {
			__be16 h_vlan_proto;
			__be16 h_vlan_TCI;
		} veth;

		veth.h_vlan_proto = skb->vlan_proto;
		veth.h_vlan_TCI = htons(vlan_tx_tag_get(skb));

		vlan_offset = offsetof(struct vlan_ethhdr, h_vlan_proto);
		len = min_t(int, skb->len + VLAN_HLEN, len);

		copy = min_t(int, vlan_offset, len);
		ret = skb_copy_datagram_const_iovec(skb, 0, iv, total, copy);
		len -= copy;
		total += copy;
		if (ret || !len)
			goto done;

		copy = min_t(int, sizeof(veth), len);
		ret = memcpy_toiovecend(iv, (void *)&veth, total, copy);
		len -= copy;
		total += copy;
		if (ret || !len)
			goto done;
	}
L
Linus Torvalds 已提交
1259

J
Jason Wang 已提交
1260 1261
	skb_copy_datagram_const_iovec(skb, vlan_offset, iv, total, len);
	total += len;
L
Linus Torvalds 已提交
1262

J
Jason Wang 已提交
1263
done:
1264 1265
	tun->dev->stats.tx_packets++;
	tun->dev->stats.tx_bytes += len;
L
Linus Torvalds 已提交
1266 1267 1268 1269

	return total;
}

J
Jason Wang 已提交
1270
static ssize_t tun_do_read(struct tun_struct *tun, struct tun_file *tfile,
1271 1272
			   struct kiocb *iocb, const struct iovec *iv,
			   ssize_t len, int noblock)
L
Linus Torvalds 已提交
1273 1274 1275
{
	DECLARE_WAITQUEUE(wait, current);
	struct sk_buff *skb;
1276
	ssize_t ret = 0;
L
Linus Torvalds 已提交
1277

1278
	tun_debug(KERN_INFO, tun, "tun_do_read\n");
L
Linus Torvalds 已提交
1279

1280
	if (unlikely(!noblock))
J
Jason Wang 已提交
1281
		add_wait_queue(&tfile->wq.wait, &wait);
L
Linus Torvalds 已提交
1282 1283 1284 1285
	while (len) {
		current->state = TASK_INTERRUPTIBLE;

		/* Read frames from the queue */
J
Jason Wang 已提交
1286
		if (!(skb = skb_dequeue(&tfile->socket.sk->sk_receive_queue))) {
1287
			if (noblock) {
L
Linus Torvalds 已提交
1288 1289 1290 1291 1292 1293 1294
				ret = -EAGAIN;
				break;
			}
			if (signal_pending(current)) {
				ret = -ERESTARTSYS;
				break;
			}
1295 1296 1297 1298
			if (tun->dev->reg_state != NETREG_REGISTERED) {
				ret = -EIO;
				break;
			}
L
Linus Torvalds 已提交
1299 1300 1301 1302 1303 1304

			/* Nothing to read, let's sleep */
			schedule();
			continue;
		}

J
Jason Wang 已提交
1305
		ret = tun_put_user(tun, tfile, skb, iv, len);
1306 1307
		kfree_skb(skb);
		break;
L
Linus Torvalds 已提交
1308 1309 1310
	}

	current->state = TASK_RUNNING;
1311
	if (unlikely(!noblock))
J
Jason Wang 已提交
1312
		remove_wait_queue(&tfile->wq.wait, &wait);
L
Linus Torvalds 已提交
1313

1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332
	return ret;
}

static ssize_t tun_chr_aio_read(struct kiocb *iocb, const struct iovec *iv,
			    unsigned long count, loff_t pos)
{
	struct file *file = iocb->ki_filp;
	struct tun_file *tfile = file->private_data;
	struct tun_struct *tun = __tun_get(tfile);
	ssize_t len, ret;

	if (!tun)
		return -EBADFD;
	len = iov_length(iv, count);
	if (len < 0) {
		ret = -EINVAL;
		goto out;
	}

J
Jason Wang 已提交
1333 1334
	ret = tun_do_read(tun, tfile, iocb, iv, len,
			  file->f_flags & O_NONBLOCK);
1335
	ret = min_t(ssize_t, ret, len);
E
Eric W. Biederman 已提交
1336 1337
out:
	tun_put(tun);
L
Linus Torvalds 已提交
1338 1339 1340
	return ret;
}

J
Jason Wang 已提交
1341 1342 1343 1344
static void tun_free_netdev(struct net_device *dev)
{
	struct tun_struct *tun = netdev_priv(dev);

J
Jason Wang 已提交
1345
	BUG_ON(!(list_empty(&tun->disabled)));
J
Jason Wang 已提交
1346
	tun_flow_uninit(tun);
1347
	security_tun_dev_free_security(tun->security);
J
Jason Wang 已提交
1348 1349 1350
	free_netdev(dev);
}

L
Linus Torvalds 已提交
1351 1352 1353 1354
static void tun_setup(struct net_device *dev)
{
	struct tun_struct *tun = netdev_priv(dev);

1355 1356
	tun->owner = INVALID_UID;
	tun->group = INVALID_GID;
L
Linus Torvalds 已提交
1357 1358

	dev->ethtool_ops = &tun_ethtool_ops;
J
Jason Wang 已提交
1359
	dev->destructor = tun_free_netdev;
L
Linus Torvalds 已提交
1360 1361
}

1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376
/* Trivial set of netlink ops to allow deleting tun or tap
 * device with netlink.
 */
static int tun_validate(struct nlattr *tb[], struct nlattr *data[])
{
	return -EINVAL;
}

static struct rtnl_link_ops tun_link_ops __read_mostly = {
	.kind		= DRV_NAME,
	.priv_size	= sizeof(struct tun_struct),
	.setup		= tun_setup,
	.validate	= tun_validate,
};

1377 1378
static void tun_sock_write_space(struct sock *sk)
{
J
Jason Wang 已提交
1379
	struct tun_file *tfile;
1380
	wait_queue_head_t *wqueue;
1381 1382 1383 1384 1385 1386 1387

	if (!sock_writeable(sk))
		return;

	if (!test_and_clear_bit(SOCK_ASYNC_NOSPACE, &sk->sk_socket->flags))
		return;

1388 1389 1390
	wqueue = sk_sleep(sk);
	if (wqueue && waitqueue_active(wqueue))
		wake_up_interruptible_sync_poll(wqueue, POLLOUT |
1391
						POLLWRNORM | POLLWRBAND);
H
Herbert Xu 已提交
1392

J
Jason Wang 已提交
1393 1394
	tfile = container_of(sk, struct tun_file, sk);
	kill_fasync(&tfile->fasync, SIGIO, POLL_OUT);
1395 1396
}

1397 1398 1399
static int tun_sendmsg(struct kiocb *iocb, struct socket *sock,
		       struct msghdr *m, size_t total_len)
{
J
Jason Wang 已提交
1400 1401 1402 1403 1404 1405 1406 1407 1408 1409
	int ret;
	struct tun_file *tfile = container_of(sock, struct tun_file, socket);
	struct tun_struct *tun = __tun_get(tfile);

	if (!tun)
		return -EBADFD;
	ret = tun_get_user(tun, tfile, m->msg_control, m->msg_iov, total_len,
			   m->msg_iovlen, m->msg_flags & MSG_DONTWAIT);
	tun_put(tun);
	return ret;
1410 1411 1412 1413 1414 1415
}

static int tun_recvmsg(struct kiocb *iocb, struct socket *sock,
		       struct msghdr *m, size_t total_len,
		       int flags)
{
J
Jason Wang 已提交
1416 1417
	struct tun_file *tfile = container_of(sock, struct tun_file, socket);
	struct tun_struct *tun = __tun_get(tfile);
1418
	int ret;
J
Jason Wang 已提交
1419 1420 1421 1422

	if (!tun)
		return -EBADFD;

1423
	if (flags & ~(MSG_DONTWAIT|MSG_TRUNC|MSG_ERRQUEUE)) {
1424 1425 1426
		ret = -EINVAL;
		goto out;
	}
1427 1428 1429 1430 1431
	if (flags & MSG_ERRQUEUE) {
		ret = sock_recv_errqueue(sock->sk, m, total_len,
					 SOL_PACKET, TUN_TX_TIMESTAMP);
		goto out;
	}
J
Jason Wang 已提交
1432
	ret = tun_do_read(tun, tfile, iocb, m->msg_iov, total_len,
1433 1434 1435 1436 1437
			  flags & MSG_DONTWAIT);
	if (ret > total_len) {
		m->msg_flags |= MSG_TRUNC;
		ret = flags & MSG_TRUNC ? ret : total_len;
	}
1438
out:
J
Jason Wang 已提交
1439
	tun_put(tun);
1440 1441 1442
	return ret;
}

1443 1444 1445 1446 1447 1448 1449
static int tun_release(struct socket *sock)
{
	if (sock->sk)
		sock_put(sock->sk);
	return 0;
}

1450 1451 1452 1453
/* Ops structure to mimic raw sockets with tun */
static const struct proto_ops tun_socket_ops = {
	.sendmsg = tun_sendmsg,
	.recvmsg = tun_recvmsg,
1454
	.release = tun_release,
1455 1456
};

1457 1458 1459
static struct proto tun_proto = {
	.name		= "tun",
	.owner		= THIS_MODULE,
J
Jason Wang 已提交
1460
	.obj_size	= sizeof(struct tun_file),
1461
};
1462

1463 1464 1465 1466 1467 1468 1469 1470 1471 1472 1473 1474
static int tun_flags(struct tun_struct *tun)
{
	int flags = 0;

	if (tun->flags & TUN_TUN_DEV)
		flags |= IFF_TUN;
	else
		flags |= IFF_TAP;

	if (tun->flags & TUN_NO_PI)
		flags |= IFF_NO_PI;

1475 1476 1477
	/* This flag has no real effect.  We track the value for backwards
	 * compatibility.
	 */
1478 1479 1480 1481 1482 1483
	if (tun->flags & TUN_ONE_QUEUE)
		flags |= IFF_ONE_QUEUE;

	if (tun->flags & TUN_VNET_HDR)
		flags |= IFF_VNET_HDR;

J
Jason Wang 已提交
1484 1485 1486
	if (tun->flags & TUN_TAP_MQ)
		flags |= IFF_MULTI_QUEUE;

1487 1488 1489
	if (tun->flags & TUN_PERSIST)
		flags |= IFF_PERSIST;

1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503
	return flags;
}

static ssize_t tun_show_flags(struct device *dev, struct device_attribute *attr,
			      char *buf)
{
	struct tun_struct *tun = netdev_priv(to_net_dev(dev));
	return sprintf(buf, "0x%x\n", tun_flags(tun));
}

static ssize_t tun_show_owner(struct device *dev, struct device_attribute *attr,
			      char *buf)
{
	struct tun_struct *tun = netdev_priv(to_net_dev(dev));
1504 1505 1506 1507
	return uid_valid(tun->owner)?
		sprintf(buf, "%u\n",
			from_kuid_munged(current_user_ns(), tun->owner)):
		sprintf(buf, "-1\n");
1508 1509 1510 1511 1512 1513
}

static ssize_t tun_show_group(struct device *dev, struct device_attribute *attr,
			      char *buf)
{
	struct tun_struct *tun = netdev_priv(to_net_dev(dev));
1514 1515 1516 1517
	return gid_valid(tun->group) ?
		sprintf(buf, "%u\n",
			from_kgid_munged(current_user_ns(), tun->group)):
		sprintf(buf, "-1\n");
1518 1519 1520 1521 1522 1523
}

static DEVICE_ATTR(tun_flags, 0444, tun_show_flags, NULL);
static DEVICE_ATTR(owner, 0444, tun_show_owner, NULL);
static DEVICE_ATTR(group, 0444, tun_show_group, NULL);

1524
static int tun_set_iff(struct net *net, struct file *file, struct ifreq *ifr)
L
Linus Torvalds 已提交
1525 1526
{
	struct tun_struct *tun;
J
Jason Wang 已提交
1527
	struct tun_file *tfile = file->private_data;
L
Linus Torvalds 已提交
1528 1529 1530
	struct net_device *dev;
	int err;

1531 1532 1533
	if (tfile->detached)
		return -EINVAL;

1534 1535
	dev = __dev_get_by_name(net, ifr->ifr_name);
	if (dev) {
1536 1537
		if (ifr->ifr_flags & IFF_TUN_EXCL)
			return -EBUSY;
1538 1539 1540 1541 1542 1543 1544
		if ((ifr->ifr_flags & IFF_TUN) && dev->netdev_ops == &tun_netdev_ops)
			tun = netdev_priv(dev);
		else if ((ifr->ifr_flags & IFF_TAP) && dev->netdev_ops == &tap_netdev_ops)
			tun = netdev_priv(dev);
		else
			return -EINVAL;

1545 1546 1547 1548
		if (!!(ifr->ifr_flags & IFF_MULTI_QUEUE) !=
		    !!(tun->flags & TUN_TAP_MQ))
			return -EINVAL;

1549
		if (tun_not_capable(tun))
P
Paul Moore 已提交
1550
			return -EPERM;
1551
		err = security_tun_dev_open(tun->security);
P
Paul Moore 已提交
1552 1553 1554
		if (err < 0)
			return err;

1555 1556 1557
		err = tun_attach(tun, file);
		if (err < 0)
			return err;
J
Jason Wang 已提交
1558 1559

		if (tun->flags & TUN_TAP_MQ &&
1560 1561 1562 1563 1564 1565
		    (tun->numqueues + tun->numdisabled > 1)) {
			/* One or more queue has already been attached, no need
			 * to initialize the device again.
			 */
			return 0;
		}
1566
	}
L
Linus Torvalds 已提交
1567 1568 1569
	else {
		char *name;
		unsigned long flags = 0;
1570 1571
		int queues = ifr->ifr_flags & IFF_MULTI_QUEUE ?
			     MAX_TAP_QUEUES : 1;
L
Linus Torvalds 已提交
1572

1573
		if (!ns_capable(net->user_ns, CAP_NET_ADMIN))
1574
			return -EPERM;
P
Paul Moore 已提交
1575 1576 1577
		err = security_tun_dev_create();
		if (err < 0)
			return err;
1578

L
Linus Torvalds 已提交
1579 1580 1581 1582 1583 1584 1585 1586 1587
		/* Set dev type */
		if (ifr->ifr_flags & IFF_TUN) {
			/* TUN device */
			flags |= TUN_TUN_DEV;
			name = "tun%d";
		} else if (ifr->ifr_flags & IFF_TAP) {
			/* TAP device */
			flags |= TUN_TAP_DEV;
			name = "tap%d";
1588
		} else
1589
			return -EINVAL;
1590

L
Linus Torvalds 已提交
1591 1592 1593
		if (*ifr->ifr_name)
			name = ifr->ifr_name;

J
Jason Wang 已提交
1594
		dev = alloc_netdev_mqs(sizeof(struct tun_struct), name,
1595 1596
				       tun_setup, queues, queues);

L
Linus Torvalds 已提交
1597 1598 1599
		if (!dev)
			return -ENOMEM;

1600
		dev_net_set(dev, net);
1601
		dev->rtnl_link_ops = &tun_link_ops;
S
Stephen Hemminger 已提交
1602

L
Linus Torvalds 已提交
1603 1604 1605
		tun = netdev_priv(dev);
		tun->dev = dev;
		tun->flags = flags;
1606
		tun->txflt.count = 0;
1607
		tun->vnet_hdr_sz = sizeof(struct virtio_net_hdr);
1608

J
Jason Wang 已提交
1609 1610
		tun->filter_attached = false;
		tun->sndbuf = tfile->socket.sk->sk_sndbuf;
1611

J
Jason Wang 已提交
1612 1613
		spin_lock_init(&tun->lock);

1614 1615 1616
		err = security_tun_dev_alloc_security(&tun->security);
		if (err < 0)
			goto err_free_dev;
P
Paul Moore 已提交
1617

L
Linus Torvalds 已提交
1618
		tun_net_init(dev);
1619
		tun_flow_init(tun);
J
Jason Wang 已提交
1620

1621
		dev->hw_features = NETIF_F_SG | NETIF_F_FRAGLIST |
J
Jason Wang 已提交
1622 1623
				   TUN_USER_FEATURES | NETIF_F_HW_VLAN_CTAG_TX |
				   NETIF_F_HW_VLAN_STAG_TX;
1624
		dev->features = dev->hw_features;
J
Jason Wang 已提交
1625
		dev->vlan_features = dev->features;
1626

J
Jason Wang 已提交
1627
		INIT_LIST_HEAD(&tun->disabled);
1628 1629 1630 1631
		err = tun_attach(tun, file);
		if (err < 0)
			goto err_free_dev;

L
Linus Torvalds 已提交
1632 1633
		err = register_netdevice(tun->dev);
		if (err < 0)
J
Jason Wang 已提交
1634
			goto err_free_dev;
1635

1636 1637 1638
		if (device_create_file(&tun->dev->dev, &dev_attr_tun_flags) ||
		    device_create_file(&tun->dev->dev, &dev_attr_owner) ||
		    device_create_file(&tun->dev->dev, &dev_attr_group))
1639
			pr_err("Failed to create tun sysfs files\n");
L
Linus Torvalds 已提交
1640 1641
	}

1642 1643
	netif_carrier_on(tun->dev);

1644
	tun_debug(KERN_INFO, tun, "tun_set_iff\n");
L
Linus Torvalds 已提交
1645 1646 1647

	if (ifr->ifr_flags & IFF_NO_PI)
		tun->flags |= TUN_NO_PI;
1648 1649
	else
		tun->flags &= ~TUN_NO_PI;
L
Linus Torvalds 已提交
1650

1651 1652 1653
	/* This flag has no real effect.  We track the value for backwards
	 * compatibility.
	 */
L
Linus Torvalds 已提交
1654 1655
	if (ifr->ifr_flags & IFF_ONE_QUEUE)
		tun->flags |= TUN_ONE_QUEUE;
1656 1657
	else
		tun->flags &= ~TUN_ONE_QUEUE;
L
Linus Torvalds 已提交
1658

1659 1660 1661 1662 1663
	if (ifr->ifr_flags & IFF_VNET_HDR)
		tun->flags |= TUN_VNET_HDR;
	else
		tun->flags &= ~TUN_VNET_HDR;

J
Jason Wang 已提交
1664 1665 1666 1667 1668
	if (ifr->ifr_flags & IFF_MULTI_QUEUE)
		tun->flags |= TUN_TAP_MQ;
	else
		tun->flags &= ~TUN_TAP_MQ;

1669 1670 1671 1672
	/* Make sure persistent devices do not get stuck in
	 * xoff state.
	 */
	if (netif_running(tun->dev))
J
Jason Wang 已提交
1673
		netif_tx_wake_all_queues(tun->dev);
1674

L
Linus Torvalds 已提交
1675 1676 1677 1678 1679 1680 1681 1682
	strcpy(ifr->ifr_name, tun->dev->name);
	return 0;

 err_free_dev:
	free_netdev(dev);
	return err;
}

R
Rami Rosen 已提交
1683
static void tun_get_iff(struct net *net, struct tun_struct *tun,
1684
		       struct ifreq *ifr)
1685
{
1686
	tun_debug(KERN_INFO, tun, "tun_get_iff\n");
1687 1688 1689

	strcpy(ifr->ifr_name, tun->dev->name);

1690
	ifr->ifr_flags = tun_flags(tun);
1691 1692 1693

}

1694 1695
/* This is like a cut-down ethtool ops, except done via tun fd so no
 * privs required. */
1696
static int set_offload(struct tun_struct *tun, unsigned long arg)
1697
{
1698
	netdev_features_t features = 0;
1699 1700

	if (arg & TUN_F_CSUM) {
1701
		features |= NETIF_F_HW_CSUM;
1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714
		arg &= ~TUN_F_CSUM;

		if (arg & (TUN_F_TSO4|TUN_F_TSO6)) {
			if (arg & TUN_F_TSO_ECN) {
				features |= NETIF_F_TSO_ECN;
				arg &= ~TUN_F_TSO_ECN;
			}
			if (arg & TUN_F_TSO4)
				features |= NETIF_F_TSO;
			if (arg & TUN_F_TSO6)
				features |= NETIF_F_TSO6;
			arg &= ~(TUN_F_TSO4|TUN_F_TSO6);
		}
1715 1716 1717 1718 1719

		if (arg & TUN_F_UFO) {
			features |= NETIF_F_UFO;
			arg &= ~TUN_F_UFO;
		}
1720 1721 1722 1723 1724 1725 1726
	}

	/* This gives the user a way to test for new features in future by
	 * trying to set them. */
	if (arg)
		return -EINVAL;

1727 1728
	tun->set_features = features;
	netdev_update_features(tun->dev);
1729 1730 1731 1732

	return 0;
}

J
Jason Wang 已提交
1733 1734 1735 1736 1737 1738
static void tun_detach_filter(struct tun_struct *tun, int n)
{
	int i;
	struct tun_file *tfile;

	for (i = 0; i < n; i++) {
1739
		tfile = rtnl_dereference(tun->tfiles[i]);
J
Jason Wang 已提交
1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751
		sk_detach_filter(tfile->socket.sk);
	}

	tun->filter_attached = false;
}

static int tun_attach_filter(struct tun_struct *tun)
{
	int i, ret = 0;
	struct tun_file *tfile;

	for (i = 0; i < tun->numqueues; i++) {
1752
		tfile = rtnl_dereference(tun->tfiles[i]);
J
Jason Wang 已提交
1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769
		ret = sk_attach_filter(&tun->fprog, tfile->socket.sk);
		if (ret) {
			tun_detach_filter(tun, i);
			return ret;
		}
	}

	tun->filter_attached = true;
	return ret;
}

static void tun_set_sndbuf(struct tun_struct *tun)
{
	struct tun_file *tfile;
	int i;

	for (i = 0; i < tun->numqueues; i++) {
1770
		tfile = rtnl_dereference(tun->tfiles[i]);
J
Jason Wang 已提交
1771 1772 1773 1774
		tfile->socket.sk->sk_sndbuf = tun->sndbuf;
	}
}

1775 1776 1777 1778 1779 1780 1781 1782 1783
static int tun_set_queue(struct file *file, struct ifreq *ifr)
{
	struct tun_file *tfile = file->private_data;
	struct tun_struct *tun;
	int ret = 0;

	rtnl_lock();

	if (ifr->ifr_flags & IFF_ATTACH_QUEUE) {
J
Jason Wang 已提交
1784
		tun = tfile->detached;
1785
		if (!tun) {
1786
			ret = -EINVAL;
1787 1788 1789 1790 1791 1792
			goto unlock;
		}
		ret = security_tun_dev_attach_queue(tun->security);
		if (ret < 0)
			goto unlock;
		ret = tun_attach(tun, file);
J
Jason Wang 已提交
1793
	} else if (ifr->ifr_flags & IFF_DETACH_QUEUE) {
1794
		tun = rtnl_dereference(tfile->tun);
1795
		if (!tun || !(tun->flags & TUN_TAP_MQ) || tfile->detached)
J
Jason Wang 已提交
1796 1797 1798 1799
			ret = -EINVAL;
		else
			__tun_detach(tfile, false);
	} else
1800 1801
		ret = -EINVAL;

1802
unlock:
1803 1804 1805 1806
	rtnl_unlock();
	return ret;
}

1807 1808
static long __tun_chr_ioctl(struct file *file, unsigned int cmd,
			    unsigned long arg, int ifreq_len)
L
Linus Torvalds 已提交
1809
{
E
Eric W. Biederman 已提交
1810
	struct tun_file *tfile = file->private_data;
E
Eric W. Biederman 已提交
1811
	struct tun_struct *tun;
L
Linus Torvalds 已提交
1812 1813
	void __user* argp = (void __user*)arg;
	struct ifreq ifr;
1814 1815
	kuid_t owner;
	kgid_t group;
1816
	int sndbuf;
1817
	int vnet_hdr_sz;
1818
	int ret;
L
Linus Torvalds 已提交
1819

1820
	if (cmd == TUNSETIFF || cmd == TUNSETQUEUE || _IOC_TYPE(cmd) == 0x89) {
1821
		if (copy_from_user(&ifr, argp, ifreq_len))
L
Linus Torvalds 已提交
1822
			return -EFAULT;
D
David S. Miller 已提交
1823
	} else {
1824
		memset(&ifr, 0, sizeof(ifr));
D
David S. Miller 已提交
1825
	}
E
Eric W. Biederman 已提交
1826 1827 1828 1829 1830
	if (cmd == TUNGETFEATURES) {
		/* Currently this just means: "what IFF flags are valid?".
		 * This is needed because we never checked for invalid flags on
		 * TUNSETIFF. */
		return put_user(IFF_TUN | IFF_TAP | IFF_NO_PI | IFF_ONE_QUEUE |
1831
				IFF_VNET_HDR | IFF_MULTI_QUEUE,
E
Eric W. Biederman 已提交
1832
				(unsigned int __user*)argp);
1833 1834
	} else if (cmd == TUNSETQUEUE)
		return tun_set_queue(file, &ifr);
E
Eric W. Biederman 已提交
1835

J
Jason Wang 已提交
1836
	ret = 0;
1837 1838
	rtnl_lock();

E
Eric W. Biederman 已提交
1839
	tun = __tun_get(tfile);
L
Linus Torvalds 已提交
1840 1841 1842
	if (cmd == TUNSETIFF && !tun) {
		ifr.ifr_name[IFNAMSIZ-1] = '\0';

1843
		ret = tun_set_iff(tfile->net, file, &ifr);
L
Linus Torvalds 已提交
1844

1845 1846
		if (ret)
			goto unlock;
L
Linus Torvalds 已提交
1847

1848
		if (copy_to_user(argp, &ifr, ifreq_len))
1849 1850
			ret = -EFAULT;
		goto unlock;
L
Linus Torvalds 已提交
1851 1852
	}

1853
	ret = -EBADFD;
L
Linus Torvalds 已提交
1854
	if (!tun)
1855
		goto unlock;
L
Linus Torvalds 已提交
1856

1857
	tun_debug(KERN_INFO, tun, "tun_chr_ioctl cmd %u\n", cmd);
L
Linus Torvalds 已提交
1858

E
Eric W. Biederman 已提交
1859
	ret = 0;
L
Linus Torvalds 已提交
1860
	switch (cmd) {
1861
	case TUNGETIFF:
R
Rami Rosen 已提交
1862
		tun_get_iff(current->nsproxy->net_ns, tun, &ifr);
1863

1864
		if (copy_to_user(argp, &ifr, ifreq_len))
E
Eric W. Biederman 已提交
1865
			ret = -EFAULT;
1866 1867
		break;

L
Linus Torvalds 已提交
1868 1869 1870
	case TUNSETNOCSUM:
		/* Disable/Enable checksum */

1871 1872
		/* [unimplemented] */
		tun_debug(KERN_INFO, tun, "ignored: set checksum %s\n",
1873
			  arg ? "disabled" : "enabled");
L
Linus Torvalds 已提交
1874 1875 1876
		break;

	case TUNSETPERSIST:
J
Jason Wang 已提交
1877 1878 1879
		/* Disable/Enable persist mode. Keep an extra reference to the
		 * module to prevent the module being unprobed.
		 */
J
Jason Wang 已提交
1880
		if (arg && !(tun->flags & TUN_PERSIST)) {
L
Linus Torvalds 已提交
1881
			tun->flags |= TUN_PERSIST;
J
Jason Wang 已提交
1882
			__module_get(THIS_MODULE);
J
Jason Wang 已提交
1883 1884
		}
		if (!arg && (tun->flags & TUN_PERSIST)) {
L
Linus Torvalds 已提交
1885
			tun->flags &= ~TUN_PERSIST;
J
Jason Wang 已提交
1886 1887
			module_put(THIS_MODULE);
		}
L
Linus Torvalds 已提交
1888

1889 1890
		tun_debug(KERN_INFO, tun, "persist %s\n",
			  arg ? "enabled" : "disabled");
L
Linus Torvalds 已提交
1891 1892 1893 1894
		break;

	case TUNSETOWNER:
		/* Set owner of the device */
1895 1896 1897 1898 1899 1900
		owner = make_kuid(current_user_ns(), arg);
		if (!uid_valid(owner)) {
			ret = -EINVAL;
			break;
		}
		tun->owner = owner;
1901
		tun_debug(KERN_INFO, tun, "owner set to %u\n",
1902
			  from_kuid(&init_user_ns, tun->owner));
L
Linus Torvalds 已提交
1903 1904
		break;

1905 1906
	case TUNSETGROUP:
		/* Set group of the device */
1907 1908 1909 1910 1911 1912
		group = make_kgid(current_user_ns(), arg);
		if (!gid_valid(group)) {
			ret = -EINVAL;
			break;
		}
		tun->group = group;
1913
		tun_debug(KERN_INFO, tun, "group set to %u\n",
1914
			  from_kgid(&init_user_ns, tun->group));
1915 1916
		break;

1917 1918 1919
	case TUNSETLINK:
		/* Only allow setting the type when the interface is down */
		if (tun->dev->flags & IFF_UP) {
1920 1921
			tun_debug(KERN_INFO, tun,
				  "Linktype set failed because interface is up\n");
1922
			ret = -EBUSY;
1923 1924
		} else {
			tun->dev->type = (int) arg;
1925 1926
			tun_debug(KERN_INFO, tun, "linktype set to %d\n",
				  tun->dev->type);
1927
			ret = 0;
1928
		}
E
Eric W. Biederman 已提交
1929
		break;
1930

L
Linus Torvalds 已提交
1931 1932 1933 1934 1935
#ifdef TUN_DEBUG
	case TUNSETDEBUG:
		tun->debug = arg;
		break;
#endif
1936
	case TUNSETOFFLOAD:
1937
		ret = set_offload(tun, arg);
E
Eric W. Biederman 已提交
1938
		break;
1939

1940 1941
	case TUNSETTXFILTER:
		/* Can be set only for TAPs */
E
Eric W. Biederman 已提交
1942
		ret = -EINVAL;
1943
		if ((tun->flags & TUN_TYPE_MASK) != TUN_TAP_DEV)
E
Eric W. Biederman 已提交
1944
			break;
H
Harvey Harrison 已提交
1945
		ret = update_filter(&tun->txflt, (void __user *)arg);
E
Eric W. Biederman 已提交
1946
		break;
L
Linus Torvalds 已提交
1947 1948

	case SIOCGIFHWADDR:
1949
		/* Get hw address */
1950 1951
		memcpy(ifr.ifr_hwaddr.sa_data, tun->dev->dev_addr, ETH_ALEN);
		ifr.ifr_hwaddr.sa_family = tun->dev->type;
1952
		if (copy_to_user(argp, &ifr, ifreq_len))
E
Eric W. Biederman 已提交
1953 1954
			ret = -EFAULT;
		break;
L
Linus Torvalds 已提交
1955 1956

	case SIOCSIFHWADDR:
1957
		/* Set hw address */
1958 1959
		tun_debug(KERN_DEBUG, tun, "set hw address: %pM\n",
			  ifr.ifr_hwaddr.sa_data);
1960 1961

		ret = dev_set_mac_address(tun->dev, &ifr.ifr_hwaddr);
E
Eric W. Biederman 已提交
1962
		break;
1963 1964

	case TUNGETSNDBUF:
J
Jason Wang 已提交
1965
		sndbuf = tfile->socket.sk->sk_sndbuf;
1966 1967 1968 1969 1970 1971 1972 1973 1974 1975
		if (copy_to_user(argp, &sndbuf, sizeof(sndbuf)))
			ret = -EFAULT;
		break;

	case TUNSETSNDBUF:
		if (copy_from_user(&sndbuf, argp, sizeof(sndbuf))) {
			ret = -EFAULT;
			break;
		}

J
Jason Wang 已提交
1976 1977
		tun->sndbuf = sndbuf;
		tun_set_sndbuf(tun);
1978 1979
		break;

1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998
	case TUNGETVNETHDRSZ:
		vnet_hdr_sz = tun->vnet_hdr_sz;
		if (copy_to_user(argp, &vnet_hdr_sz, sizeof(vnet_hdr_sz)))
			ret = -EFAULT;
		break;

	case TUNSETVNETHDRSZ:
		if (copy_from_user(&vnet_hdr_sz, argp, sizeof(vnet_hdr_sz))) {
			ret = -EFAULT;
			break;
		}
		if (vnet_hdr_sz < (int)sizeof(struct virtio_net_hdr)) {
			ret = -EINVAL;
			break;
		}

		tun->vnet_hdr_sz = vnet_hdr_sz;
		break;

M
Michael S. Tsirkin 已提交
1999 2000 2001 2002 2003 2004
	case TUNATTACHFILTER:
		/* Can be set only for TAPs */
		ret = -EINVAL;
		if ((tun->flags & TUN_TYPE_MASK) != TUN_TAP_DEV)
			break;
		ret = -EFAULT;
J
Jason Wang 已提交
2005
		if (copy_from_user(&tun->fprog, argp, sizeof(tun->fprog)))
M
Michael S. Tsirkin 已提交
2006 2007
			break;

J
Jason Wang 已提交
2008
		ret = tun_attach_filter(tun);
M
Michael S. Tsirkin 已提交
2009 2010 2011 2012 2013 2014 2015
		break;

	case TUNDETACHFILTER:
		/* Can be set only for TAPs */
		ret = -EINVAL;
		if ((tun->flags & TUN_TYPE_MASK) != TUN_TAP_DEV)
			break;
J
Jason Wang 已提交
2016 2017
		ret = 0;
		tun_detach_filter(tun, tun->numqueues);
M
Michael S. Tsirkin 已提交
2018 2019
		break;

L
Linus Torvalds 已提交
2020
	default:
E
Eric W. Biederman 已提交
2021 2022
		ret = -EINVAL;
		break;
2023
	}
L
Linus Torvalds 已提交
2024

2025 2026 2027 2028
unlock:
	rtnl_unlock();
	if (tun)
		tun_put(tun);
E
Eric W. Biederman 已提交
2029
	return ret;
L
Linus Torvalds 已提交
2030 2031
}

2032 2033 2034 2035 2036 2037 2038 2039 2040 2041 2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 2065 2066
static long tun_chr_ioctl(struct file *file,
			  unsigned int cmd, unsigned long arg)
{
	return __tun_chr_ioctl(file, cmd, arg, sizeof (struct ifreq));
}

#ifdef CONFIG_COMPAT
static long tun_chr_compat_ioctl(struct file *file,
			 unsigned int cmd, unsigned long arg)
{
	switch (cmd) {
	case TUNSETIFF:
	case TUNGETIFF:
	case TUNSETTXFILTER:
	case TUNGETSNDBUF:
	case TUNSETSNDBUF:
	case SIOCGIFHWADDR:
	case SIOCSIFHWADDR:
		arg = (unsigned long)compat_ptr(arg);
		break;
	default:
		arg = (compat_ulong_t)arg;
		break;
	}

	/*
	 * compat_ifreq is shorter than ifreq, so we must not access beyond
	 * the end of that structure. All fields that are used in this
	 * driver are compatible though, we don't need to convert the
	 * contents.
	 */
	return __tun_chr_ioctl(file, cmd, arg, sizeof(struct compat_ifreq));
}
#endif /* CONFIG_COMPAT */

L
Linus Torvalds 已提交
2067 2068
static int tun_chr_fasync(int fd, struct file *file, int on)
{
J
Jason Wang 已提交
2069
	struct tun_file *tfile = file->private_data;
L
Linus Torvalds 已提交
2070 2071
	int ret;

J
Jason Wang 已提交
2072
	if ((ret = fasync_helper(fd, file, on, &tfile->fasync)) < 0)
J
Jonathan Corbet 已提交
2073
		goto out;
2074

L
Linus Torvalds 已提交
2075
	if (on) {
2076
		ret = __f_setown(file, task_pid(current), PIDTYPE_PID, 0);
L
Linus Torvalds 已提交
2077
		if (ret)
J
Jonathan Corbet 已提交
2078
			goto out;
J
Jason Wang 已提交
2079
		tfile->flags |= TUN_FASYNC;
2080
	} else
J
Jason Wang 已提交
2081
		tfile->flags &= ~TUN_FASYNC;
J
Jonathan Corbet 已提交
2082 2083 2084
	ret = 0;
out:
	return ret;
L
Linus Torvalds 已提交
2085 2086 2087 2088
}

static int tun_chr_open(struct inode *inode, struct file * file)
{
E
Eric W. Biederman 已提交
2089
	struct tun_file *tfile;
T
Thomas Gleixner 已提交
2090

2091
	DBG1(KERN_INFO, "tunX: tun_chr_open\n");
E
Eric W. Biederman 已提交
2092

J
Jason Wang 已提交
2093 2094
	tfile = (struct tun_file *)sk_alloc(&init_net, AF_UNSPEC, GFP_KERNEL,
					    &tun_proto);
E
Eric W. Biederman 已提交
2095 2096
	if (!tfile)
		return -ENOMEM;
2097
	rcu_assign_pointer(tfile->tun, NULL);
E
Eric W. Biederman 已提交
2098
	tfile->net = get_net(current->nsproxy->net_ns);
J
Jason Wang 已提交
2099 2100 2101 2102 2103 2104 2105 2106 2107 2108 2109 2110 2111 2112
	tfile->flags = 0;

	rcu_assign_pointer(tfile->socket.wq, &tfile->wq);
	init_waitqueue_head(&tfile->wq.wait);

	tfile->socket.file = file;
	tfile->socket.ops = &tun_socket_ops;

	sock_init_data(&tfile->socket, &tfile->sk);
	sk_change_net(&tfile->sk, tfile->net);

	tfile->sk.sk_write_space = tun_sock_write_space;
	tfile->sk.sk_sndbuf = INT_MAX;

E
Eric W. Biederman 已提交
2113
	file->private_data = tfile;
J
Jason Wang 已提交
2114
	set_bit(SOCK_EXTERNALLY_ALLOCATED, &tfile->socket.flags);
J
Jason Wang 已提交
2115
	INIT_LIST_HEAD(&tfile->next);
J
Jason Wang 已提交
2116

2117 2118
	sock_set_flag(&tfile->sk, SOCK_ZEROCOPY);

L
Linus Torvalds 已提交
2119 2120 2121 2122 2123
	return 0;
}

static int tun_chr_close(struct inode *inode, struct file *file)
{
E
Eric W. Biederman 已提交
2124
	struct tun_file *tfile = file->private_data;
J
Jason Wang 已提交
2125
	struct net *net = tfile->net;
L
Linus Torvalds 已提交
2126

J
Jason Wang 已提交
2127
	tun_detach(tfile, true);
J
Jason Wang 已提交
2128
	put_net(net);
L
Linus Torvalds 已提交
2129 2130 2131 2132

	return 0;
}

2133
static const struct file_operations tun_fops = {
2134
	.owner	= THIS_MODULE,
L
Linus Torvalds 已提交
2135
	.llseek = no_llseek,
2136 2137 2138 2139
	.read  = do_sync_read,
	.aio_read  = tun_chr_aio_read,
	.write = do_sync_write,
	.aio_write = tun_chr_aio_write,
L
Linus Torvalds 已提交
2140
	.poll	= tun_chr_poll,
2141 2142 2143 2144
	.unlocked_ioctl	= tun_chr_ioctl,
#ifdef CONFIG_COMPAT
	.compat_ioctl = tun_chr_compat_ioctl,
#endif
L
Linus Torvalds 已提交
2145 2146
	.open	= tun_chr_open,
	.release = tun_chr_close,
2147
	.fasync = tun_chr_fasync
L
Linus Torvalds 已提交
2148 2149 2150 2151 2152
};

static struct miscdevice tun_miscdev = {
	.minor = TUN_MINOR,
	.name = "tun",
2153
	.nodename = "net/tun",
L
Linus Torvalds 已提交
2154 2155 2156 2157 2158 2159 2160 2161 2162
	.fops = &tun_fops,
};

/* ethtool interface */

static int tun_get_settings(struct net_device *dev, struct ethtool_cmd *cmd)
{
	cmd->supported		= 0;
	cmd->advertising	= 0;
2163
	ethtool_cmd_speed_set(cmd, SPEED_10);
L
Linus Torvalds 已提交
2164 2165 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 2176 2177
	cmd->duplex		= DUPLEX_FULL;
	cmd->port		= PORT_TP;
	cmd->phy_address	= 0;
	cmd->transceiver	= XCVR_INTERNAL;
	cmd->autoneg		= AUTONEG_DISABLE;
	cmd->maxtxpkt		= 0;
	cmd->maxrxpkt		= 0;
	return 0;
}

static void tun_get_drvinfo(struct net_device *dev, struct ethtool_drvinfo *info)
{
	struct tun_struct *tun = netdev_priv(dev);

2178 2179
	strlcpy(info->driver, DRV_NAME, sizeof(info->driver));
	strlcpy(info->version, DRV_VERSION, sizeof(info->version));
L
Linus Torvalds 已提交
2180 2181 2182

	switch (tun->flags & TUN_TYPE_MASK) {
	case TUN_TUN_DEV:
2183
		strlcpy(info->bus_info, "tun", sizeof(info->bus_info));
L
Linus Torvalds 已提交
2184 2185
		break;
	case TUN_TAP_DEV:
2186
		strlcpy(info->bus_info, "tap", sizeof(info->bus_info));
L
Linus Torvalds 已提交
2187 2188 2189 2190 2191 2192 2193 2194 2195 2196 2197 2198 2199 2200 2201 2202 2203 2204 2205 2206 2207 2208
		break;
	}
}

static u32 tun_get_msglevel(struct net_device *dev)
{
#ifdef TUN_DEBUG
	struct tun_struct *tun = netdev_priv(dev);
	return tun->debug;
#else
	return -EOPNOTSUPP;
#endif
}

static void tun_set_msglevel(struct net_device *dev, u32 value)
{
#ifdef TUN_DEBUG
	struct tun_struct *tun = netdev_priv(dev);
	tun->debug = value;
#endif
}

2209
static const struct ethtool_ops tun_ethtool_ops = {
L
Linus Torvalds 已提交
2210 2211 2212 2213
	.get_settings	= tun_get_settings,
	.get_drvinfo	= tun_get_drvinfo,
	.get_msglevel	= tun_get_msglevel,
	.set_msglevel	= tun_set_msglevel,
2214
	.get_link	= ethtool_op_get_link,
2215
	.get_ts_info	= ethtool_op_get_ts_info,
L
Linus Torvalds 已提交
2216 2217
};

2218

L
Linus Torvalds 已提交
2219 2220 2221 2222
static int __init tun_init(void)
{
	int ret = 0;

2223 2224
	pr_info("%s, %s\n", DRV_DESCRIPTION, DRV_VERSION);
	pr_info("%s\n", DRV_COPYRIGHT);
L
Linus Torvalds 已提交
2225

2226
	ret = rtnl_link_register(&tun_link_ops);
2227
	if (ret) {
2228
		pr_err("Can't register link_ops\n");
2229
		goto err_linkops;
2230 2231
	}

L
Linus Torvalds 已提交
2232
	ret = misc_register(&tun_miscdev);
2233
	if (ret) {
2234
		pr_err("Can't register misc device %d\n", TUN_MINOR);
2235 2236
		goto err_misc;
	}
2237
	return  0;
2238
err_misc:
2239 2240
	rtnl_link_unregister(&tun_link_ops);
err_linkops:
L
Linus Torvalds 已提交
2241 2242 2243 2244 2245
	return ret;
}

static void tun_cleanup(void)
{
2246
	misc_deregister(&tun_miscdev);
2247
	rtnl_link_unregister(&tun_link_ops);
L
Linus Torvalds 已提交
2248 2249
}

2250 2251 2252 2253 2254 2255
/* Get an underlying socket object from tun file.  Returns error unless file is
 * attached to a device.  The returned object works like a packet socket, it
 * can be used for sock_sendmsg/sock_recvmsg.  The caller is responsible for
 * holding a reference to the file for as long as the socket is in use. */
struct socket *tun_get_socket(struct file *file)
{
2256
	struct tun_file *tfile;
2257 2258
	if (file->f_op != &tun_fops)
		return ERR_PTR(-EINVAL);
2259 2260
	tfile = file->private_data;
	if (!tfile)
2261
		return ERR_PTR(-EBADFD);
J
Jason Wang 已提交
2262
	return &tfile->socket;
2263 2264 2265
}
EXPORT_SYMBOL_GPL(tun_get_socket);

L
Linus Torvalds 已提交
2266 2267 2268 2269 2270 2271
module_init(tun_init);
module_exit(tun_cleanup);
MODULE_DESCRIPTION(DRV_DESCRIPTION);
MODULE_AUTHOR(DRV_COPYRIGHT);
MODULE_LICENSE("GPL");
MODULE_ALIAS_MISCDEV(TUN_MINOR);
2272
MODULE_ALIAS("devname:net/tun");