netdevice.h 45.3 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5 6 7 8 9
/*
 * INET		An implementation of the TCP/IP protocol suite for the LINUX
 *		operating system.  INET is implemented using the  BSD Socket
 *		interface as the means of communication with the user level.
 *
 *		Definitions for the Interfaces handler.
 *
 * Version:	@(#)dev.h	1.0.10	08/12/93
 *
10
 * Authors:	Ross Biro
L
Linus Torvalds 已提交
11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
 *		Fred N. van Kempen, <waltje@uWalt.NL.Mugnet.ORG>
 *		Corey Minyard <wf-rch!minyard@relay.EU.net>
 *		Donald J. Becker, <becker@cesdis.gsfc.nasa.gov>
 *		Alan Cox, <Alan.Cox@linux.org>
 *		Bjorn Ekwall. <bj0rn@blox.se>
 *              Pekka Riikonen <priikone@poseidon.pspt.fi>
 *
 *		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.
 *
 *		Moved to /usr/include/linux for NET3
 */
#ifndef _LINUX_NETDEVICE_H
#define _LINUX_NETDEVICE_H

#include <linux/if.h>
#include <linux/if_ether.h>
#include <linux/if_packet.h>

#ifdef __KERNEL__
A
Al Viro 已提交
33
#include <linux/timer.h>
34
#include <linux/delay.h>
L
Linus Torvalds 已提交
35 36 37 38 39 40
#include <asm/atomic.h>
#include <asm/cache.h>
#include <asm/byteorder.h>

#include <linux/device.h>
#include <linux/percpu.h>
41
#include <linux/dmaengine.h>
42
#include <linux/workqueue.h>
L
Linus Torvalds 已提交
43

44 45
#include <net/net_namespace.h>

L
Linus Torvalds 已提交
46 47
struct vlan_group;
struct ethtool_ops;
48
struct netpoll_info;
49 50
/* 802.11 specific */
struct wireless_dev;
L
Linus Torvalds 已提交
51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75
					/* source back-compat hooks */
#define SET_ETHTOOL_OPS(netdev,ops) \
	( (netdev)->ethtool_ops = (ops) )

#define HAVE_ALLOC_NETDEV		/* feature macro: alloc_xxxdev
					   functions are available. */
#define HAVE_FREE_NETDEV		/* free_netdev() */
#define HAVE_NETDEV_PRIV		/* netdev_priv() */

#define NET_XMIT_SUCCESS	0
#define NET_XMIT_DROP		1	/* skb dropped			*/
#define NET_XMIT_CN		2	/* congestion notification	*/
#define NET_XMIT_POLICED	3	/* skb is shot by police	*/
#define NET_XMIT_BYPASS		4	/* packet does not leave via dequeue;
					   (TC use only - dev_queue_xmit
					   returns this as NET_XMIT_SUCCESS) */

/* Backlog congestion levels */
#define NET_RX_SUCCESS		0   /* keep 'em coming, baby */
#define NET_RX_DROP		1  /* packet dropped */
#define NET_RX_CN_LOW		2   /* storm alert, just in case */
#define NET_RX_CN_MOD		3   /* Storm on its way! */
#define NET_RX_CN_HIGH		4   /* The storm is here */
#define NET_RX_BAD		5  /* packet dropped due to kernel error */

76 77 78 79
/* NET_XMIT_CN is special. It does not guarantee that this packet is lost. It
 * indicates that the device will soon be dropping packets, or already drops
 * some packets of the same priority; prompting us to send less aggressively. */
#define net_xmit_eval(e)	((e) == NET_XMIT_CN? 0 : (e))
L
Linus Torvalds 已提交
80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105
#define net_xmit_errno(e)	((e) != NET_XMIT_CN ? -ENOBUFS : 0)

#endif

#define MAX_ADDR_LEN	32		/* Largest hardware address length */

/* Driver transmit return codes */
#define NETDEV_TX_OK 0		/* driver took care of packet */
#define NETDEV_TX_BUSY 1	/* driver tx path was busy*/
#define NETDEV_TX_LOCKED -1	/* driver tx lock was already taken */

/*
 *	Compute the worst case header length according to the protocols
 *	used.
 */
 
#if !defined(CONFIG_AX25) && !defined(CONFIG_AX25_MODULE) && !defined(CONFIG_TR)
#define LL_MAX_HEADER	32
#else
#if defined(CONFIG_AX25) || defined(CONFIG_AX25_MODULE)
#define LL_MAX_HEADER	96
#else
#define LL_MAX_HEADER	48
#endif
#endif

D
David S. Miller 已提交
106 107 108 109
#if !defined(CONFIG_NET_IPIP) && !defined(CONFIG_NET_IPIP_MODULE) && \
    !defined(CONFIG_NET_IPGRE) &&  !defined(CONFIG_NET_IPGRE_MODULE) && \
    !defined(CONFIG_IPV6_SIT) && !defined(CONFIG_IPV6_SIT_MODULE) && \
    !defined(CONFIG_IPV6_TUNNEL) && !defined(CONFIG_IPV6_TUNNEL_MODULE)
L
Linus Torvalds 已提交
110 111 112 113 114
#define MAX_HEADER LL_MAX_HEADER
#else
#define MAX_HEADER (LL_MAX_HEADER + 48)
#endif

115 116 117 118 119 120 121 122
struct net_device_subqueue
{
	/* Give a control state for each queue.  This struct may contain
	 * per-queue locks in the future.
	 */
	unsigned long   state;
};

L
Linus Torvalds 已提交
123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191
/*
 *	Network device statistics. Akin to the 2.0 ether stats but
 *	with byte counters.
 */
 
struct net_device_stats
{
	unsigned long	rx_packets;		/* total packets received	*/
	unsigned long	tx_packets;		/* total packets transmitted	*/
	unsigned long	rx_bytes;		/* total bytes received 	*/
	unsigned long	tx_bytes;		/* total bytes transmitted	*/
	unsigned long	rx_errors;		/* bad packets received		*/
	unsigned long	tx_errors;		/* packet transmit problems	*/
	unsigned long	rx_dropped;		/* no space in linux buffers	*/
	unsigned long	tx_dropped;		/* no space available in linux	*/
	unsigned long	multicast;		/* multicast packets received	*/
	unsigned long	collisions;

	/* detailed rx_errors: */
	unsigned long	rx_length_errors;
	unsigned long	rx_over_errors;		/* receiver ring buff overflow	*/
	unsigned long	rx_crc_errors;		/* recved pkt with crc error	*/
	unsigned long	rx_frame_errors;	/* recv'd frame alignment error */
	unsigned long	rx_fifo_errors;		/* recv'r fifo overrun		*/
	unsigned long	rx_missed_errors;	/* receiver missed packet	*/

	/* detailed tx_errors */
	unsigned long	tx_aborted_errors;
	unsigned long	tx_carrier_errors;
	unsigned long	tx_fifo_errors;
	unsigned long	tx_heartbeat_errors;
	unsigned long	tx_window_errors;
	
	/* for cslip etc */
	unsigned long	rx_compressed;
	unsigned long	tx_compressed;
};


/* Media selection options. */
enum {
        IF_PORT_UNKNOWN = 0,
        IF_PORT_10BASE2,
        IF_PORT_10BASET,
        IF_PORT_AUI,
        IF_PORT_100BASET,
        IF_PORT_100BASETX,
        IF_PORT_100BASEFX
};

#ifdef __KERNEL__

#include <linux/cache.h>
#include <linux/skbuff.h>

struct neighbour;
struct neigh_parms;
struct sk_buff;

struct netif_rx_stats
{
	unsigned total;
	unsigned dropped;
	unsigned time_squeeze;
	unsigned cpu_collision;
};

DECLARE_PER_CPU(struct netif_rx_stats, netdev_rx_stat);

192 193 194 195 196
struct dev_addr_list
{
	struct dev_addr_list	*next;
	u8			da_addr[MAX_ADDR_LEN];
	u8			da_addrlen;
197
	u8			da_synced;
198 199 200
	int			da_users;
	int			da_gusers;
};
L
Linus Torvalds 已提交
201 202 203 204

/*
 *	We tag multicasts with these structures.
 */
205 206 207 208 209 210

#define dev_mc_list	dev_addr_list
#define dmi_addr	da_addr
#define dmi_addrlen	da_addrlen
#define dmi_users	da_users
#define dmi_gusers	da_gusers
L
Linus Torvalds 已提交
211 212 213 214 215

struct hh_cache
{
	struct hh_cache *hh_next;	/* Next entry			     */
	atomic_t	hh_refcnt;	/* number of users                   */
216 217 218 219 220 221 222 223
/*
 * We want hh_output, hh_len, hh_lock and hh_data be a in a separate
 * cache line on SMP.
 * They are mostly read, but hh_refcnt may be changed quite frequently,
 * incurring cache line ping pongs.
 */
	__be16		hh_type ____cacheline_aligned_in_smp;
					/* protocol identifier, f.e ETH_P_IP
L
Linus Torvalds 已提交
224 225 226
                                         *  NOTE:  For VLANs, this will be the
                                         *  encapuslated type. --BLG
                                         */
227
	u16		hh_len;		/* length of header */
L
Linus Torvalds 已提交
228
	int		(*hh_output)(struct sk_buff *skb);
229
	seqlock_t	hh_lock;
L
Linus Torvalds 已提交
230 231 232 233

	/* cached hardware header; allow for machine alignment needs.        */
#define HH_DATA_MOD	16
#define HH_DATA_OFF(__len) \
J
Jiri Benc 已提交
234
	(HH_DATA_MOD - (((__len - 1) & (HH_DATA_MOD - 1)) + 1))
L
Linus Torvalds 已提交
235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252
#define HH_DATA_ALIGN(__len) \
	(((__len)+(HH_DATA_MOD-1))&~(HH_DATA_MOD - 1))
	unsigned long	hh_data[HH_DATA_ALIGN(LL_MAX_HEADER) / sizeof(long)];
};

/* Reserve HH_DATA_MOD byte aligned hard_header_len, but at least that much.
 * Alternative is:
 *   dev->hard_header_len ? (dev->hard_header_len +
 *                           (HH_DATA_MOD - 1)) & ~(HH_DATA_MOD - 1) : 0
 *
 * We could use other alignment values, but we must maintain the
 * relationship HH alignment <= LL alignment.
 */
#define LL_RESERVED_SPACE(dev) \
	(((dev)->hard_header_len&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
#define LL_RESERVED_SPACE_EXTRA(dev,extra) \
	((((dev)->hard_header_len+extra)&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)

253 254 255 256 257 258 259 260 261 262 263 264 265
struct header_ops {
	int	(*create) (struct sk_buff *skb, struct net_device *dev,
			   unsigned short type, const void *daddr,
			   const void *saddr, unsigned len);
	int	(*parse)(const struct sk_buff *skb, unsigned char *haddr);
	int	(*rebuild)(struct sk_buff *skb);
#define HAVE_HEADER_CACHE
	int	(*cache)(const struct neighbour *neigh, struct hh_cache *hh);
	void	(*cache_update)(struct hh_cache *hh,
				const struct net_device *dev,
				const unsigned char *haddr);
};

L
Linus Torvalds 已提交
266 267 268 269 270 271 272 273 274 275 276 277
/* These flag bits are private to the generic network queueing
 * layer, they may not be explicitly referenced by any other
 * code.
 */

enum netdev_state_t
{
	__LINK_STATE_XOFF=0,
	__LINK_STATE_START,
	__LINK_STATE_PRESENT,
	__LINK_STATE_SCHED,
	__LINK_STATE_NOCARRIER,
S
Stefan Rompf 已提交
278 279
	__LINK_STATE_LINKWATCH_PENDING,
	__LINK_STATE_DORMANT,
H
Herbert Xu 已提交
280
	__LINK_STATE_QDISC_RUNNING,
L
Linus Torvalds 已提交
281 282 283 284 285 286 287 288 289 290 291 292 293
};


/*
 * This structure holds at boot time configured netdevice settings. They
 * are then used in the device probing. 
 */
struct netdev_boot_setup {
	char name[IFNAMSIZ];
	struct ifmap map;
};
#define NETDEV_BOOT_SETUP_MAX 8

294
extern int __init netdev_boot_setup(char *str);
L
Linus Torvalds 已提交
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
/*
 * Structure for NAPI scheduling similar to tasklet but with weighting
 */
struct napi_struct {
	/* The poll_list must only be managed by the entity which
	 * changes the state of the NAPI_STATE_SCHED bit.  This means
	 * whoever atomically sets that bit can add this napi_struct
	 * to the per-cpu poll_list, and whoever clears that bit
	 * can remove from the list right before clearing the bit.
	 */
	struct list_head	poll_list;

	unsigned long		state;
	int			weight;
	int			(*poll)(struct napi_struct *, int);
#ifdef CONFIG_NETPOLL
	spinlock_t		poll_lock;
	int			poll_owner;
	struct net_device	*dev;
	struct list_head	dev_list;
#endif
};

enum
{
	NAPI_STATE_SCHED,	/* Poll is scheduled */
D
David S. Miller 已提交
322
	NAPI_STATE_DISABLE,	/* Disable pending */
323 324
};

325
extern void __napi_schedule(struct napi_struct *n);
326

D
David S. Miller 已提交
327 328 329 330 331
static inline int napi_disable_pending(struct napi_struct *n)
{
	return test_bit(NAPI_STATE_DISABLE, &n->state);
}

332 333 334 335 336 337
/**
 *	napi_schedule_prep - check if napi can be scheduled
 *	@n: napi context
 *
 * Test if NAPI routine is already running, and if not mark
 * it as running.  This is used as a condition variable
D
David S. Miller 已提交
338 339
 * insure only one NAPI poll instance runs.  We also make
 * sure there is no pending NAPI disable.
340 341 342
 */
static inline int napi_schedule_prep(struct napi_struct *n)
{
D
David S. Miller 已提交
343 344
	return !napi_disable_pending(n) &&
		!test_and_set_bit(NAPI_STATE_SCHED, &n->state);
345 346 347 348 349 350 351 352 353 354 355 356 357 358 359
}

/**
 *	napi_schedule - schedule NAPI poll
 *	@n: napi context
 *
 * Schedule NAPI poll routine to be called if it is not already
 * running.
 */
static inline void napi_schedule(struct napi_struct *n)
{
	if (napi_schedule_prep(n))
		__napi_schedule(n);
}

360 361 362 363 364 365 366 367 368 369
/* Try to reschedule poll. Called by dev->poll() after napi_complete().  */
static inline int napi_reschedule(struct napi_struct *napi)
{
	if (napi_schedule_prep(napi)) {
		__napi_schedule(napi);
		return 1;
	}
	return 0;
}

370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385
/**
 *	napi_complete - NAPI processing complete
 *	@n: napi context
 *
 * Mark NAPI processing as complete.
 */
static inline void __napi_complete(struct napi_struct *n)
{
	BUG_ON(!test_bit(NAPI_STATE_SCHED, &n->state));
	list_del(&n->poll_list);
	smp_mb__before_clear_bit();
	clear_bit(NAPI_STATE_SCHED, &n->state);
}

static inline void napi_complete(struct napi_struct *n)
{
386 387 388
	unsigned long flags;

	local_irq_save(flags);
389
	__napi_complete(n);
390
	local_irq_restore(flags);
391 392 393 394 395 396 397 398 399 400 401
}

/**
 *	napi_disable - prevent NAPI from scheduling
 *	@n: napi context
 *
 * Stop NAPI from being scheduled on this context.
 * Waits till any outstanding processing completes.
 */
static inline void napi_disable(struct napi_struct *n)
{
D
David S. Miller 已提交
402
	set_bit(NAPI_STATE_DISABLE, &n->state);
403
	while (test_and_set_bit(NAPI_STATE_SCHED, &n->state))
404
		msleep(1);
D
David S. Miller 已提交
405
	clear_bit(NAPI_STATE_DISABLE, &n->state);
406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421
}

/**
 *	napi_enable - enable NAPI scheduling
 *	@n: napi context
 *
 * Resume NAPI from being scheduled on this context.
 * Must be paired with napi_disable.
 */
static inline void napi_enable(struct napi_struct *n)
{
	BUG_ON(!test_bit(NAPI_STATE_SCHED, &n->state));
	smp_mb__before_clear_bit();
	clear_bit(NAPI_STATE_SCHED, &n->state);
}

422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439
#ifdef CONFIG_SMP
/**
 *	napi_synchronize - wait until NAPI is not running
 *	@n: napi context
 *
 * Wait until NAPI is done being scheduled on this context.
 * Waits till any outstanding processing completes but
 * does not disable future activations.
 */
static inline void napi_synchronize(const struct napi_struct *n)
{
	while (test_bit(NAPI_STATE_SCHED, &n->state))
		msleep(1);
}
#else
# define napi_synchronize(n)	barrier()
#endif

L
Linus Torvalds 已提交
440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458
/*
 *	The DEVICE structure.
 *	Actually, this whole structure is a big mistake.  It mixes I/O
 *	data with strictly "high-level" data, and it has to know about
 *	almost every data structure used in the INET module.
 *
 *	FIXME: cleanup struct net_device such that network protocol info
 *	moves out.
 */

struct net_device
{

	/*
	 * This is the first field of the "visible" part of this structure
	 * (i.e. as seen by users in the "Space.c" file).  It is the name
	 * the interface.
	 */
	char			name[IFNAMSIZ];
459 460
	/* device name hash chain */
	struct hlist_node	name_hlist;
L
Linus Torvalds 已提交
461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480

	/*
	 *	I/O specific fields
	 *	FIXME: Merge these and struct ifmap into one
	 */
	unsigned long		mem_end;	/* shared mem end	*/
	unsigned long		mem_start;	/* shared mem start	*/
	unsigned long		base_addr;	/* device I/O address	*/
	unsigned int		irq;		/* device IRQ number	*/

	/*
	 *	Some hardware also needs these fields, but they are not
	 *	part of the usual set specified in Space.c.
	 */

	unsigned char		if_port;	/* Selectable AUI, TP,..*/
	unsigned char		dma;		/* DMA channel		*/

	unsigned long		state;

481
	struct list_head	dev_list;
482 483 484
#ifdef CONFIG_NETPOLL
	struct list_head	napi_list;
#endif
L
Linus Torvalds 已提交
485 486 487 488 489 490
	
	/* The device initialization function. Called only once. */
	int			(*init)(struct net_device *dev);

	/* ------- Fields preinitialized in Space.c finish here ------- */

491 492 493
	/* Net device features */
	unsigned long		features;
#define NETIF_F_SG		1	/* Scatter/gather IO. */
494
#define NETIF_F_IP_CSUM		2	/* Can checksum TCP/UDP over IPv4. */
495 496
#define NETIF_F_NO_CSUM		4	/* Does not require checksum. F.e. loopack. */
#define NETIF_F_HW_CSUM		8	/* Can checksum all the packets. */
497
#define NETIF_F_IPV6_CSUM	16	/* Can checksum TCP/UDP over IPV6 */
498 499 500 501 502 503
#define NETIF_F_HIGHDMA		32	/* Can DMA to high memory. */
#define NETIF_F_FRAGLIST	64	/* Scatter/gather IO. */
#define NETIF_F_HW_VLAN_TX	128	/* Transmit VLAN hw acceleration */
#define NETIF_F_HW_VLAN_RX	256	/* Receive VLAN hw acceleration */
#define NETIF_F_HW_VLAN_FILTER	512	/* Receive filtering on VLAN */
#define NETIF_F_VLAN_CHALLENGED	1024	/* Device cannot handle VLAN packets */
H
Herbert Xu 已提交
504
#define NETIF_F_GSO		2048	/* Enable software GSO. */
505 506
#define NETIF_F_LLTX		4096	/* LockLess TX - deprecated. Please */
					/* do not use LLTX in new drivers */
507
#define NETIF_F_NETNS_LOCAL	8192	/* Does not change network namespaces */
508
#define NETIF_F_MULTI_QUEUE	16384	/* Has multiple TX/RX queues */
509
#define NETIF_F_LRO		32768	/* large receive offload */
510 511 512

	/* Segmentation offload features */
#define NETIF_F_GSO_SHIFT	16
513
#define NETIF_F_GSO_MASK	0xffff0000
514
#define NETIF_F_TSO		(SKB_GSO_TCPV4 << NETIF_F_GSO_SHIFT)
H
Herbert Xu 已提交
515
#define NETIF_F_UFO		(SKB_GSO_UDP << NETIF_F_GSO_SHIFT)
516
#define NETIF_F_GSO_ROBUST	(SKB_GSO_DODGY << NETIF_F_GSO_SHIFT)
H
Herbert Xu 已提交
517 518
#define NETIF_F_TSO_ECN		(SKB_GSO_TCP_ECN << NETIF_F_GSO_SHIFT)
#define NETIF_F_TSO6		(SKB_GSO_TCPV6 << NETIF_F_GSO_SHIFT)
519

520 521 522
	/* List of features with software fallbacks. */
#define NETIF_F_GSO_SOFTWARE	(NETIF_F_TSO | NETIF_F_TSO_ECN | NETIF_F_TSO6)

523

524
#define NETIF_F_GEN_CSUM	(NETIF_F_NO_CSUM | NETIF_F_HW_CSUM)
525 526 527
#define NETIF_F_V4_CSUM		(NETIF_F_GEN_CSUM | NETIF_F_IP_CSUM)
#define NETIF_F_V6_CSUM		(NETIF_F_GEN_CSUM | NETIF_F_IPV6_CSUM)
#define NETIF_F_ALL_CSUM	(NETIF_F_V4_CSUM | NETIF_F_V6_CSUM)
528

L
Linus Torvalds 已提交
529 530 531 532 533 534 535 536
	struct net_device	*next_sched;

	/* Interface index. Unique device identifier	*/
	int			ifindex;
	int			iflink;


	struct net_device_stats* (*get_stats)(struct net_device *dev);
R
Rusty Russell 已提交
537
	struct net_device_stats	stats;
L
Linus Torvalds 已提交
538

539
#ifdef CONFIG_WIRELESS_EXT
L
Linus Torvalds 已提交
540 541 542 543 544
	/* List of functions to handle Wireless Extensions (instead of ioctl).
	 * See <net/iw_handler.h> for details. Jean II */
	const struct iw_handler_def *	wireless_handlers;
	/* Instance data managed by the core of Wireless Extensions. */
	struct iw_public_data *	wireless_data;
545
#endif
546
	const struct ethtool_ops *ethtool_ops;
L
Linus Torvalds 已提交
547

548 549 550
	/* Hardware header description */
	const struct header_ops *header_ops;

L
Linus Torvalds 已提交
551 552 553 554 555 556 557
	/*
	 * This marks the end of the "visible" part of the structure. All
	 * fields hereafter are internal to the system, and may change at
	 * will (read: may be cleaned up at will).
	 */


S
Stefan Rompf 已提交
558
	unsigned int		flags;	/* interface flags (a la BSD)	*/
L
Linus Torvalds 已提交
559 560 561 562
	unsigned short		gflags;
        unsigned short          priv_flags; /* Like 'flags' but invisible to userspace. */
	unsigned short		padded;	/* How much padding added by alloc_netdev() */

S
Stefan Rompf 已提交
563 564 565
	unsigned char		operstate; /* RFC2863 operstate */
	unsigned char		link_mode; /* mapping policy to operstate */

L
Linus Torvalds 已提交
566 567 568 569 570 571 572 573 574
	unsigned		mtu;	/* interface MTU value		*/
	unsigned short		type;	/* interface hardware type	*/
	unsigned short		hard_header_len;	/* hardware hdr length	*/

	struct net_device	*master; /* Pointer to master device of a group,
					  * which this device is member of.
					  */

	/* Interface address info. */
575
	unsigned char		perm_addr[MAX_ADDR_LEN]; /* permanent hw address */
L
Linus Torvalds 已提交
576 577 578
	unsigned char		addr_len;	/* hardware address length	*/
	unsigned short          dev_id;		/* for shared network cards */

579 580 581
	struct dev_addr_list	*uc_list;	/* Secondary unicast mac addresses */
	int			uc_count;	/* Number of installed ucasts	*/
	int			uc_promisc;
582
	struct dev_addr_list	*mc_list;	/* Multicast mac addresses	*/
L
Linus Torvalds 已提交
583 584 585 586 587 588 589 590 591 592 593 594 595
	int			mc_count;	/* Number of installed mcasts	*/
	int			promiscuity;
	int			allmulti;


	/* Protocol specific pointers */
	
	void 			*atalk_ptr;	/* AppleTalk link 	*/
	void			*ip_ptr;	/* IPv4 specific data	*/  
	void                    *dn_ptr;        /* DECnet specific data */
	void                    *ip6_ptr;       /* IPv6 specific data */
	void			*ec_ptr;	/* Econet specific data	*/
	void			*ax25_ptr;	/* AX.25 specific data */
596 597
	struct wireless_dev	*ieee80211_ptr;	/* IEEE 802.11 specific data,
						   assign before registering */
L
Linus Torvalds 已提交
598

599 600 601 602 603 604 605 606 607
/*
 * Cache line mostly used on receive path (including eth_type_trans())
 */
	unsigned long		last_rx;	/* Time of last Rx	*/
	/* Interface address info used in eth_type_trans() */
	unsigned char		dev_addr[MAX_ADDR_LEN];	/* hw address, (before bcast 
							because most packets are unicast) */

	unsigned char		broadcast[MAX_ADDR_LEN];	/* hw bcast add	*/
L
Linus Torvalds 已提交
608

609 610 611 612
	/* ingress path synchronizer */
	spinlock_t		ingress_lock;
	struct Qdisc		*qdisc_ingress;

613 614 615 616 617
/*
 * Cache line mostly used on queue transmit path (qdisc)
 */
	/* device queue lock */
	spinlock_t		queue_lock ____cacheline_aligned_in_smp;
L
Linus Torvalds 已提交
618 619 620 621 622
	struct Qdisc		*qdisc;
	struct Qdisc		*qdisc_sleeping;
	struct list_head	qdisc_list;
	unsigned long		tx_queue_len;	/* Max frames per queue allowed */

623 624 625
	/* Partially transmitted GSO packet. */
	struct sk_buff		*gso_skb;

626 627 628
/*
 * One part is mostly used on xmit path (device)
 */
L
Linus Torvalds 已提交
629
	/* hard_start_xmit synchronizer */
H
Herbert Xu 已提交
630
	spinlock_t		_xmit_lock ____cacheline_aligned_in_smp;
L
Linus Torvalds 已提交
631 632 633 634
	/* cpu id of processor entered to hard_start_xmit or -1,
	   if nobody entered there.
	 */
	int			xmit_lock_owner;
635 636 637 638 639 640 641 642 643 644 645 646
	void			*priv;	/* pointer to private data	*/
	int			(*hard_start_xmit) (struct sk_buff *skb,
						    struct net_device *dev);
	/* These may be needed for future network-power-down code. */
	unsigned long		trans_start;	/* Time (in jiffies) of last Tx	*/

	int			watchdog_timeo; /* used by dev_watchdog() */
	struct timer_list	watchdog_timer;

/*
 * refcnt is a very hot point, so align it on SMP
 */
L
Linus Torvalds 已提交
647
	/* Number of references to this device */
648 649
	atomic_t		refcnt ____cacheline_aligned_in_smp;

L
Linus Torvalds 已提交
650 651 652 653 654
	/* delayed register/unregister */
	struct list_head	todo_list;
	/* device index hash chain */
	struct hlist_node	index_hlist;

655 656
	struct net_device	*link_watch_next;

L
Linus Torvalds 已提交
657 658
	/* register/unregister state machine */
	enum { NETREG_UNINITIALIZED=0,
659
	       NETREG_REGISTERED,	/* completed register_netdevice */
L
Linus Torvalds 已提交
660 661 662 663 664 665 666 667 668 669 670 671 672 673
	       NETREG_UNREGISTERING,	/* called unregister_netdevice */
	       NETREG_UNREGISTERED,	/* completed unregister todo */
	       NETREG_RELEASED,		/* called free_netdev */
	} reg_state;

	/* Called after device is detached from network. */
	void			(*uninit)(struct net_device *dev);
	/* Called after last user reference disappears. */
	void			(*destructor)(struct net_device *dev);

	/* Pointers to interface service routines.	*/
	int			(*open)(struct net_device *dev);
	int			(*stop)(struct net_device *dev);
#define HAVE_NETDEV_POLL
674 675 676
#define HAVE_CHANGE_RX_FLAGS
	void			(*change_rx_flags)(struct net_device *dev,
						   int flags);
677 678
#define HAVE_SET_RX_MODE
	void			(*set_rx_mode)(struct net_device *dev);
L
Linus Torvalds 已提交
679 680 681 682 683
#define HAVE_MULTICAST			 
	void			(*set_multicast_list)(struct net_device *dev);
#define HAVE_SET_MAC_ADDR  		 
	int			(*set_mac_address)(struct net_device *dev,
						   void *addr);
684 685
#define HAVE_VALIDATE_ADDR
	int			(*validate_addr)(struct net_device *dev);
L
Linus Torvalds 已提交
686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706
#define HAVE_PRIVATE_IOCTL
	int			(*do_ioctl)(struct net_device *dev,
					    struct ifreq *ifr, int cmd);
#define HAVE_SET_CONFIG
	int			(*set_config)(struct net_device *dev,
					      struct ifmap *map);
#define HAVE_CHANGE_MTU
	int			(*change_mtu)(struct net_device *dev, int new_mtu);

#define HAVE_TX_TIMEOUT
	void			(*tx_timeout) (struct net_device *dev);

	void			(*vlan_rx_register)(struct net_device *dev,
						    struct vlan_group *grp);
	void			(*vlan_rx_add_vid)(struct net_device *dev,
						   unsigned short vid);
	void			(*vlan_rx_kill_vid)(struct net_device *dev,
						    unsigned short vid);

	int			(*neigh_setup)(struct net_device *dev, struct neigh_parms *);
#ifdef CONFIG_NETPOLL
707
	struct netpoll_info	*npinfo;
L
Linus Torvalds 已提交
708 709 710 711 712
#endif
#ifdef CONFIG_NET_POLL_CONTROLLER
	void                    (*poll_controller)(struct net_device *dev);
#endif

713
#ifdef CONFIG_NET_NS
714 715
	/* Network namespace this network device is inside */
	struct net		*nd_net;
716
#endif
717

D
David S. Miller 已提交
718 719 720
	/* mid-layer private */
	void			*ml_priv;

L
Linus Torvalds 已提交
721 722
	/* bridge stuff */
	struct net_bridge_port	*br_port;
P
Patrick McHardy 已提交
723 724
	/* macvlan */
	struct macvlan_port	*macvlan_port;
L
Linus Torvalds 已提交
725 726

	/* class/net/name entry */
727
	struct device		dev;
728 729
	/* space for optional statistics and wireless sysfs groups */
	struct attribute_group  *sysfs_groups[3];
P
Patrick McHardy 已提交
730 731 732

	/* rtnetlink link ops */
	const struct rtnl_link_ops *rtnl_link_ops;
733

734 735 736 737
	/* for setting kernel sock attribute on TCP connection setup */
#define GSO_MAX_SIZE		65536
	unsigned int		gso_max_size;

738 739
	/* The TX queue control structures */
	unsigned int			egress_subqueue_count;
740
	struct net_device_subqueue	egress_subqueue[1];
L
Linus Torvalds 已提交
741
};
742
#define to_net_dev(d) container_of(d, struct net_device, dev)
L
Linus Torvalds 已提交
743 744 745 746

#define	NETDEV_ALIGN		32
#define	NETDEV_ALIGN_CONST	(NETDEV_ALIGN - 1)

747 748 749 750 751 752 753 754 755 756 757 758 759 760
/*
 * Net namespace inlines
 */
static inline
struct net *dev_net(const struct net_device *dev)
{
#ifdef CONFIG_NET_NS
	return dev->nd_net;
#else
	return &init_net;
#endif
}

static inline
761
void dev_net_set(struct net_device *dev, struct net *net)
762 763
{
#ifdef CONFIG_NET_NS
764 765
	release_net(dev->nd_net);
	dev->nd_net = hold_net(net);
766 767 768
#endif
}

769 770 771 772 773 774
/**
 *	netdev_priv - access network device private data
 *	@dev: network device
 *
 * Get network device private data
 */
775
static inline void *netdev_priv(const struct net_device *dev)
L
Linus Torvalds 已提交
776
{
777
	return dev->priv;
L
Linus Torvalds 已提交
778 779 780 781 782
}

/* Set the sysfs physical device reference for the network logical device
 * if set prior to registration will cause a symlink during initialization.
 */
783
#define SET_NETDEV_DEV(net, pdev)	((net)->dev.parent = (pdev))
L
Linus Torvalds 已提交
784

785 786 787 788 789 790 791 792 793 794
/**
 *	netif_napi_add - initialize a napi context
 *	@dev:  network device
 *	@napi: napi context
 *	@poll: polling function
 *	@weight: default weight
 *
 * netif_napi_add() must be used to initialize a napi context prior to calling
 * *any* of the other napi related functions.
 */
795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811
static inline void netif_napi_add(struct net_device *dev,
				  struct napi_struct *napi,
				  int (*poll)(struct napi_struct *, int),
				  int weight)
{
	INIT_LIST_HEAD(&napi->poll_list);
	napi->poll = poll;
	napi->weight = weight;
#ifdef CONFIG_NETPOLL
	napi->dev = dev;
	list_add(&napi->dev_list, &dev->napi_list);
	spin_lock_init(&napi->poll_lock);
	napi->poll_owner = -1;
#endif
	set_bit(NAPI_STATE_SCHED, &napi->state);
}

L
Linus Torvalds 已提交
812
struct packet_type {
D
David S. Miller 已提交
813 814 815 816 817 818
	__be16			type;	/* This is really htons(ether_type). */
	struct net_device	*dev;	/* NULL is wildcarded here	     */
	int			(*func) (struct sk_buff *,
					 struct net_device *,
					 struct packet_type *,
					 struct net_device *);
819 820
	struct sk_buff		*(*gso_segment)(struct sk_buff *skb,
						int features);
821
	int			(*gso_send_check)(struct sk_buff *skb);
L
Linus Torvalds 已提交
822 823 824 825 826 827 828 829 830
	void			*af_packet_priv;
	struct list_head	list;
};

#include <linux/interrupt.h>
#include <linux/notifier.h>

extern rwlock_t				dev_base_lock;		/* Device list lock */

831

832 833 834 835 836 837 838
#define for_each_netdev(net, d)		\
		list_for_each_entry(d, &(net)->dev_base_head, dev_list)
#define for_each_netdev_safe(net, d, n)	\
		list_for_each_entry_safe(d, n, &(net)->dev_base_head, dev_list)
#define for_each_netdev_continue(net, d)		\
		list_for_each_entry_continue(d, &(net)->dev_base_head, dev_list)
#define net_device_entry(lh)	list_entry(lh, struct net_device, dev_list)
839

840 841 842 843 844
static inline struct net_device *next_net_device(struct net_device *dev)
{
	struct list_head *lh;
	struct net *net;

845
	net = dev_net(dev);
846 847 848 849 850 851 852 853 854
	lh = dev->dev_list.next;
	return lh == &net->dev_base_head ? NULL : net_device_entry(lh);
}

static inline struct net_device *first_net_device(struct net *net)
{
	return list_empty(&net->dev_base_head) ? NULL :
		net_device_entry(net->dev_base_head.next);
}
855

L
Linus Torvalds 已提交
856 857
extern int 			netdev_boot_setup_check(struct net_device *dev);
extern unsigned long		netdev_boot_base(const char *prefix, int unit);
858 859 860
extern struct net_device    *dev_getbyhwaddr(struct net *net, unsigned short type, char *hwaddr);
extern struct net_device *dev_getfirstbyhwtype(struct net *net, unsigned short type);
extern struct net_device *__dev_getfirstbyhwtype(struct net *net, unsigned short type);
L
Linus Torvalds 已提交
861 862 863 864
extern void		dev_add_pack(struct packet_type *pt);
extern void		dev_remove_pack(struct packet_type *pt);
extern void		__dev_remove_pack(struct packet_type *pt);

865
extern struct net_device	*dev_get_by_flags(struct net *net, unsigned short flags,
L
Linus Torvalds 已提交
866
						  unsigned short mask);
867 868
extern struct net_device	*dev_get_by_name(struct net *net, const char *name);
extern struct net_device	*__dev_get_by_name(struct net *net, const char *name);
L
Linus Torvalds 已提交
869 870 871 872 873
extern int		dev_alloc_name(struct net_device *dev, const char *name);
extern int		dev_open(struct net_device *dev);
extern int		dev_close(struct net_device *dev);
extern int		dev_queue_xmit(struct sk_buff *skb);
extern int		register_netdevice(struct net_device *dev);
874
extern void		unregister_netdevice(struct net_device *dev);
L
Linus Torvalds 已提交
875 876 877 878
extern void		free_netdev(struct net_device *dev);
extern void		synchronize_net(void);
extern int 		register_netdevice_notifier(struct notifier_block *nb);
extern int		unregister_netdevice_notifier(struct notifier_block *nb);
879
extern int call_netdevice_notifiers(unsigned long val, struct net_device *dev);
880 881
extern struct net_device	*dev_get_by_index(struct net *net, int ifindex);
extern struct net_device	*__dev_get_by_index(struct net *net, int ifindex);
L
Linus Torvalds 已提交
882 883 884 885 886
extern int		dev_restart(struct net_device *dev);
#ifdef CONFIG_NETPOLL_TRAP
extern int		netpoll_trap(void);
#endif

887 888
static inline int dev_hard_header(struct sk_buff *skb, struct net_device *dev,
				  unsigned short type,
889 890
				  const void *daddr, const void *saddr,
				  unsigned len)
891
{
892
	if (!dev->header_ops || !dev->header_ops->create)
893
		return 0;
894 895

	return dev->header_ops->create(skb, dev, type, daddr, saddr, len);
896 897
}

S
Stephen Hemminger 已提交
898 899 900 901 902
static inline int dev_parse_header(const struct sk_buff *skb,
				   unsigned char *haddr)
{
	const struct net_device *dev = skb->dev;

903
	if (!dev->header_ops || !dev->header_ops->parse)
S
Stephen Hemminger 已提交
904
		return 0;
905
	return dev->header_ops->parse(skb, haddr);
S
Stephen Hemminger 已提交
906 907
}

L
Linus Torvalds 已提交
908 909 910 911 912 913 914 915 916 917 918 919 920
typedef int gifconf_func_t(struct net_device * dev, char __user * bufptr, int len);
extern int		register_gifconf(unsigned int family, gifconf_func_t * gifconf);
static inline int unregister_gifconf(unsigned int family)
{
	return register_gifconf(family, NULL);
}

/*
 * Incoming packets are placed on per-cpu queues so that
 * no locking is needed.
 */
struct softnet_data
{
921
	struct net_device	*output_queue;
L
Linus Torvalds 已提交
922 923 924 925
	struct sk_buff_head	input_pkt_queue;
	struct list_head	poll_list;
	struct sk_buff		*completion_queue;

926
	struct napi_struct	backlog;
927 928 929
#ifdef CONFIG_NET_DMA
	struct dma_chan		*net_dma;
#endif
L
Linus Torvalds 已提交
930 931 932 933 934 935
};

DECLARE_PER_CPU(struct softnet_data,softnet_data);

#define HAVE_NETIF_QUEUE

936
extern void __netif_schedule(struct net_device *dev);
L
Linus Torvalds 已提交
937 938 939 940 941 942 943

static inline void netif_schedule(struct net_device *dev)
{
	if (!test_bit(__LINK_STATE_XOFF, &dev->state))
		__netif_schedule(dev);
}

944 945 946 947 948 949
/**
 *	netif_start_queue - allow transmit
 *	@dev: network device
 *
 *	Allow upper layers to call the device hard_start_xmit routine.
 */
L
Linus Torvalds 已提交
950 951 952 953 954
static inline void netif_start_queue(struct net_device *dev)
{
	clear_bit(__LINK_STATE_XOFF, &dev->state);
}

955 956 957 958 959 960 961
/**
 *	netif_wake_queue - restart transmit
 *	@dev: network device
 *
 *	Allow upper layers to call the device hard_start_xmit routine.
 *	Used for flow control when transmit resources are available.
 */
L
Linus Torvalds 已提交
962 963 964
static inline void netif_wake_queue(struct net_device *dev)
{
#ifdef CONFIG_NETPOLL_TRAP
965 966
	if (netpoll_trap()) {
		clear_bit(__LINK_STATE_XOFF, &dev->state);
L
Linus Torvalds 已提交
967
		return;
968
	}
L
Linus Torvalds 已提交
969 970 971 972 973
#endif
	if (test_and_clear_bit(__LINK_STATE_XOFF, &dev->state))
		__netif_schedule(dev);
}

974 975 976 977 978 979 980
/**
 *	netif_stop_queue - stop transmitted packets
 *	@dev: network device
 *
 *	Stop upper layers calling the device hard_start_xmit routine.
 *	Used for flow control when transmit resources are unavailable.
 */
L
Linus Torvalds 已提交
981 982 983 984 985
static inline void netif_stop_queue(struct net_device *dev)
{
	set_bit(__LINK_STATE_XOFF, &dev->state);
}

986 987 988 989 990 991
/**
 *	netif_queue_stopped - test if transmit queue is flowblocked
 *	@dev: network device
 *
 *	Test if transmit queue on device is currently unable to send.
 */
L
Linus Torvalds 已提交
992 993 994 995 996
static inline int netif_queue_stopped(const struct net_device *dev)
{
	return test_bit(__LINK_STATE_XOFF, &dev->state);
}

997 998 999 1000 1001 1002
/**
 *	netif_running - test if up
 *	@dev: network device
 *
 *	Test if the device has been brought up.
 */
L
Linus Torvalds 已提交
1003 1004 1005 1006 1007
static inline int netif_running(const struct net_device *dev)
{
	return test_bit(__LINK_STATE_START, &dev->state);
}

1008 1009 1010 1011 1012 1013
/*
 * Routines to manage the subqueues on a device.  We only need start
 * stop, and a check if it's stopped.  All other device management is
 * done at the overall netdevice level.
 * Also test the device if we're multiqueue.
 */
1014 1015 1016 1017 1018 1019 1020 1021

/**
 *	netif_start_subqueue - allow sending packets on subqueue
 *	@dev: network device
 *	@queue_index: sub queue index
 *
 * Start individual transmit queue of a device with multiple transmit queues.
 */
1022 1023 1024 1025 1026 1027 1028
static inline void netif_start_subqueue(struct net_device *dev, u16 queue_index)
{
#ifdef CONFIG_NETDEVICES_MULTIQUEUE
	clear_bit(__LINK_STATE_XOFF, &dev->egress_subqueue[queue_index].state);
#endif
}

1029 1030 1031 1032 1033 1034 1035
/**
 *	netif_stop_subqueue - stop sending packets on subqueue
 *	@dev: network device
 *	@queue_index: sub queue index
 *
 * Stop individual transmit queue of a device with multiple transmit queues.
 */
1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046
static inline void netif_stop_subqueue(struct net_device *dev, u16 queue_index)
{
#ifdef CONFIG_NETDEVICES_MULTIQUEUE
#ifdef CONFIG_NETPOLL_TRAP
	if (netpoll_trap())
		return;
#endif
	set_bit(__LINK_STATE_XOFF, &dev->egress_subqueue[queue_index].state);
#endif
}

1047 1048 1049 1050 1051 1052 1053
/**
 *	netif_subqueue_stopped - test status of subqueue
 *	@dev: network device
 *	@queue_index: sub queue index
 *
 * Check individual transmit queue of a device with multiple transmit queues.
 */
1054
static inline int __netif_subqueue_stopped(const struct net_device *dev,
1055 1056 1057 1058 1059 1060 1061 1062 1063 1064
					 u16 queue_index)
{
#ifdef CONFIG_NETDEVICES_MULTIQUEUE
	return test_bit(__LINK_STATE_XOFF,
			&dev->egress_subqueue[queue_index].state);
#else
	return 0;
#endif
}

1065 1066 1067 1068 1069
static inline int netif_subqueue_stopped(const struct net_device *dev,
					 struct sk_buff *skb)
{
	return __netif_subqueue_stopped(dev, skb_get_queue_mapping(skb));
}
1070 1071 1072 1073 1074 1075 1076 1077

/**
 *	netif_wake_subqueue - allow sending packets on subqueue
 *	@dev: network device
 *	@queue_index: sub queue index
 *
 * Resume individual transmit queue of a device with multiple transmit queues.
 */
1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090
static inline void netif_wake_subqueue(struct net_device *dev, u16 queue_index)
{
#ifdef CONFIG_NETDEVICES_MULTIQUEUE
#ifdef CONFIG_NETPOLL_TRAP
	if (netpoll_trap())
		return;
#endif
	if (test_and_clear_bit(__LINK_STATE_XOFF,
			       &dev->egress_subqueue[queue_index].state))
		__netif_schedule(dev);
#endif
}

1091 1092 1093 1094 1095 1096 1097
/**
 *	netif_is_multiqueue - test if device has multiple transmit queues
 *	@dev: network device
 *
 * Check if device has multiple transmit queues
 * Always falls if NETDEVICE_MULTIQUEUE is not configured
 */
1098 1099 1100 1101 1102 1103 1104 1105
static inline int netif_is_multiqueue(const struct net_device *dev)
{
#ifdef CONFIG_NETDEVICES_MULTIQUEUE
	return (!!(NETIF_F_MULTI_QUEUE & dev->features));
#else
	return 0;
#endif
}
L
Linus Torvalds 已提交
1106 1107

/* Use this variant when it is known for sure that it
1108 1109
 * is executing from hardware interrupt context or with hardware interrupts
 * disabled.
L
Linus Torvalds 已提交
1110
 */
1111
extern void dev_kfree_skb_irq(struct sk_buff *skb);
L
Linus Torvalds 已提交
1112 1113

/* Use this variant in places where it could be invoked
1114 1115
 * from either hardware interrupt or other context, with hardware interrupts
 * either disabled or enabled.
L
Linus Torvalds 已提交
1116
 */
1117
extern void dev_kfree_skb_any(struct sk_buff *skb);
L
Linus Torvalds 已提交
1118 1119 1120 1121 1122 1123

#define HAVE_NETIF_RX 1
extern int		netif_rx(struct sk_buff *skb);
extern int		netif_rx_ni(struct sk_buff *skb);
#define HAVE_NETIF_RECEIVE_SKB 1
extern int		netif_receive_skb(struct sk_buff *skb);
1124
extern int		dev_valid_name(const char *name);
1125 1126
extern int		dev_ioctl(struct net *net, unsigned int cmd, void __user *);
extern int		dev_ethtool(struct net *net, struct ifreq *);
L
Linus Torvalds 已提交
1127 1128 1129
extern unsigned		dev_get_flags(const struct net_device *);
extern int		dev_change_flags(struct net_device *, unsigned);
extern int		dev_change_name(struct net_device *, char *);
1130 1131
extern int		dev_change_net_namespace(struct net_device *,
						 struct net *, const char *);
L
Linus Torvalds 已提交
1132 1133 1134
extern int		dev_set_mtu(struct net_device *, int);
extern int		dev_set_mac_address(struct net_device *,
					    struct sockaddr *);
1135 1136
extern int		dev_hard_start_xmit(struct sk_buff *skb,
					    struct net_device *dev);
L
Linus Torvalds 已提交
1137

1138
extern int		netdev_budget;
L
Linus Torvalds 已提交
1139 1140 1141 1142

/* Called by rtnetlink.c:rtnl_unlock() */
extern void netdev_run_todo(void);

1143 1144 1145 1146
/**
 *	dev_put - release reference to device
 *	@dev: network device
 *
1147
 * Release reference to device to allow it to be freed.
1148
 */
L
Linus Torvalds 已提交
1149 1150 1151 1152 1153
static inline void dev_put(struct net_device *dev)
{
	atomic_dec(&dev->refcnt);
}

1154 1155 1156 1157
/**
 *	dev_hold - get reference to device
 *	@dev: network device
 *
1158
 * Hold reference to device to keep it from being freed.
1159
 */
1160 1161 1162 1163
static inline void dev_hold(struct net_device *dev)
{
	atomic_inc(&dev->refcnt);
}
L
Linus Torvalds 已提交
1164 1165 1166 1167

/* Carrier loss detection, dial on demand. The functions netif_carrier_on
 * and _off may be called from IRQ context, but it is caller
 * who is responsible for serialization of these calls.
S
Stefan Rompf 已提交
1168 1169 1170 1171
 *
 * The name carrier is inappropriate, these functions should really be
 * called netif_lowerlayer_*() because they represent the state of any
 * kind of lower layer not just hardware media.
L
Linus Torvalds 已提交
1172 1173 1174 1175
 */

extern void linkwatch_fire_event(struct net_device *dev);

1176 1177 1178 1179 1180 1181
/**
 *	netif_carrier_ok - test if carrier present
 *	@dev: network device
 *
 * Check if carrier is present on device
 */
L
Linus Torvalds 已提交
1182 1183 1184 1185 1186 1187 1188
static inline int netif_carrier_ok(const struct net_device *dev)
{
	return !test_bit(__LINK_STATE_NOCARRIER, &dev->state);
}

extern void __netdev_watchdog_up(struct net_device *dev);

1189
extern void netif_carrier_on(struct net_device *dev);
L
Linus Torvalds 已提交
1190

1191
extern void netif_carrier_off(struct net_device *dev);
L
Linus Torvalds 已提交
1192

1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205
/**
 *	netif_dormant_on - mark device as dormant.
 *	@dev: network device
 *
 * Mark device as dormant (as per RFC2863).
 *
 * The dormant state indicates that the relevant interface is not
 * actually in a condition to pass packets (i.e., it is not 'up') but is
 * in a "pending" state, waiting for some external event.  For "on-
 * demand" interfaces, this new state identifies the situation where the
 * interface is waiting for events to place it in the up state.
 *
 */
S
Stefan Rompf 已提交
1206 1207 1208 1209 1210 1211
static inline void netif_dormant_on(struct net_device *dev)
{
	if (!test_and_set_bit(__LINK_STATE_DORMANT, &dev->state))
		linkwatch_fire_event(dev);
}

1212 1213 1214 1215 1216 1217
/**
 *	netif_dormant_off - set device as not dormant.
 *	@dev: network device
 *
 * Device is not in dormant state.
 */
S
Stefan Rompf 已提交
1218 1219 1220 1221 1222 1223
static inline void netif_dormant_off(struct net_device *dev)
{
	if (test_and_clear_bit(__LINK_STATE_DORMANT, &dev->state))
		linkwatch_fire_event(dev);
}

1224 1225 1226 1227 1228 1229
/**
 *	netif_dormant - test if carrier present
 *	@dev: network device
 *
 * Check if carrier is present on device
 */
S
Stefan Rompf 已提交
1230 1231 1232 1233 1234 1235
static inline int netif_dormant(const struct net_device *dev)
{
	return test_bit(__LINK_STATE_DORMANT, &dev->state);
}


1236 1237 1238 1239 1240 1241
/**
 *	netif_oper_up - test if device is operational
 *	@dev: network device
 *
 * Check if carrier is operational
 */
S
Stefan Rompf 已提交
1242 1243 1244 1245 1246
static inline int netif_oper_up(const struct net_device *dev) {
	return (dev->operstate == IF_OPER_UP ||
		dev->operstate == IF_OPER_UNKNOWN /* backward compat */);
}

1247 1248 1249 1250 1251 1252
/**
 *	netif_device_present - is device available or removed
 *	@dev: network device
 *
 * Check if device has not been removed from system.
 */
L
Linus Torvalds 已提交
1253 1254 1255 1256 1257
static inline int netif_device_present(struct net_device *dev)
{
	return test_bit(__LINK_STATE_PRESENT, &dev->state);
}

1258
extern void netif_device_detach(struct net_device *dev);
L
Linus Torvalds 已提交
1259

1260
extern void netif_device_attach(struct net_device *dev);
L
Linus Torvalds 已提交
1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311

/*
 * Network interface message level settings
 */
#define HAVE_NETIF_MSG 1

enum {
	NETIF_MSG_DRV		= 0x0001,
	NETIF_MSG_PROBE		= 0x0002,
	NETIF_MSG_LINK		= 0x0004,
	NETIF_MSG_TIMER		= 0x0008,
	NETIF_MSG_IFDOWN	= 0x0010,
	NETIF_MSG_IFUP		= 0x0020,
	NETIF_MSG_RX_ERR	= 0x0040,
	NETIF_MSG_TX_ERR	= 0x0080,
	NETIF_MSG_TX_QUEUED	= 0x0100,
	NETIF_MSG_INTR		= 0x0200,
	NETIF_MSG_TX_DONE	= 0x0400,
	NETIF_MSG_RX_STATUS	= 0x0800,
	NETIF_MSG_PKTDATA	= 0x1000,
	NETIF_MSG_HW		= 0x2000,
	NETIF_MSG_WOL		= 0x4000,
};

#define netif_msg_drv(p)	((p)->msg_enable & NETIF_MSG_DRV)
#define netif_msg_probe(p)	((p)->msg_enable & NETIF_MSG_PROBE)
#define netif_msg_link(p)	((p)->msg_enable & NETIF_MSG_LINK)
#define netif_msg_timer(p)	((p)->msg_enable & NETIF_MSG_TIMER)
#define netif_msg_ifdown(p)	((p)->msg_enable & NETIF_MSG_IFDOWN)
#define netif_msg_ifup(p)	((p)->msg_enable & NETIF_MSG_IFUP)
#define netif_msg_rx_err(p)	((p)->msg_enable & NETIF_MSG_RX_ERR)
#define netif_msg_tx_err(p)	((p)->msg_enable & NETIF_MSG_TX_ERR)
#define netif_msg_tx_queued(p)	((p)->msg_enable & NETIF_MSG_TX_QUEUED)
#define netif_msg_intr(p)	((p)->msg_enable & NETIF_MSG_INTR)
#define netif_msg_tx_done(p)	((p)->msg_enable & NETIF_MSG_TX_DONE)
#define netif_msg_rx_status(p)	((p)->msg_enable & NETIF_MSG_RX_STATUS)
#define netif_msg_pktdata(p)	((p)->msg_enable & NETIF_MSG_PKTDATA)
#define netif_msg_hw(p)		((p)->msg_enable & NETIF_MSG_HW)
#define netif_msg_wol(p)	((p)->msg_enable & NETIF_MSG_WOL)

static inline u32 netif_msg_init(int debug_value, int default_msg_enable_bits)
{
	/* use default */
	if (debug_value < 0 || debug_value >= (sizeof(u32) * 8))
		return default_msg_enable_bits;
	if (debug_value == 0)	/* no output */
		return 0;
	/* set low N bits */
	return (1 << debug_value) - 1;
}

1312
/* Test if receive needs to be scheduled but only if up */
1313 1314
static inline int netif_rx_schedule_prep(struct net_device *dev,
					 struct napi_struct *napi)
L
Linus Torvalds 已提交
1315
{
D
David S. Miller 已提交
1316
	return napi_schedule_prep(napi);
L
Linus Torvalds 已提交
1317 1318 1319 1320 1321
}

/* Add interface to tail of rx poll list. This assumes that _prep has
 * already been called and returned 1.
 */
1322 1323 1324 1325 1326
static inline void __netif_rx_schedule(struct net_device *dev,
				       struct napi_struct *napi)
{
	__napi_schedule(napi);
}
L
Linus Torvalds 已提交
1327 1328 1329

/* Try to reschedule poll. Called by irq handler. */

1330 1331
static inline void netif_rx_schedule(struct net_device *dev,
				     struct napi_struct *napi)
L
Linus Torvalds 已提交
1332
{
1333 1334
	if (netif_rx_schedule_prep(dev, napi))
		__netif_rx_schedule(dev, napi);
L
Linus Torvalds 已提交
1335 1336
}

1337 1338 1339
/* Try to reschedule poll. Called by dev->poll() after netif_rx_complete().  */
static inline int netif_rx_reschedule(struct net_device *dev,
				      struct napi_struct *napi)
L
Linus Torvalds 已提交
1340
{
1341 1342
	if (napi_schedule_prep(napi)) {
		__netif_rx_schedule(dev, napi);
L
Linus Torvalds 已提交
1343 1344 1345 1346 1347
		return 1;
	}
	return 0;
}

1348 1349 1350
/* same as netif_rx_complete, except that local_irq_save(flags)
 * has already been issued
 */
1351 1352
static inline void __netif_rx_complete(struct net_device *dev,
				       struct napi_struct *napi)
1353
{
1354
	__napi_complete(napi);
1355 1356
}

L
Linus Torvalds 已提交
1357 1358 1359 1360 1361
/* Remove interface from poll list: it must be in the poll list
 * on current cpu. This primitive is called by dev->poll(), when
 * it completes the work. The device cannot be out of poll list at this
 * moment, it is BUG().
 */
1362 1363
static inline void netif_rx_complete(struct net_device *dev,
				     struct napi_struct *napi)
L
Linus Torvalds 已提交
1364 1365 1366 1367
{
	unsigned long flags;

	local_irq_save(flags);
1368
	__netif_rx_complete(dev, napi);
L
Linus Torvalds 已提交
1369 1370 1371
	local_irq_restore(flags);
}

1372 1373 1374
/**
 *	netif_tx_lock - grab network device transmit lock
 *	@dev: network device
1375
 *	@cpu: cpu number of lock owner
1376 1377 1378
 *
 * Get network device transmit lock
 */
1379
static inline void __netif_tx_lock(struct net_device *dev, int cpu)
H
Herbert Xu 已提交
1380 1381
{
	spin_lock(&dev->_xmit_lock);
1382 1383 1384 1385 1386 1387
	dev->xmit_lock_owner = cpu;
}

static inline void netif_tx_lock(struct net_device *dev)
{
	__netif_tx_lock(dev, smp_processor_id());
H
Herbert Xu 已提交
1388 1389 1390 1391 1392 1393 1394 1395 1396 1397
}

static inline void netif_tx_lock_bh(struct net_device *dev)
{
	spin_lock_bh(&dev->_xmit_lock);
	dev->xmit_lock_owner = smp_processor_id();
}

static inline int netif_tx_trylock(struct net_device *dev)
{
1398 1399
	int ok = spin_trylock(&dev->_xmit_lock);
	if (likely(ok))
H
Herbert Xu 已提交
1400
		dev->xmit_lock_owner = smp_processor_id();
1401
	return ok;
H
Herbert Xu 已提交
1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415
}

static inline void netif_tx_unlock(struct net_device *dev)
{
	dev->xmit_lock_owner = -1;
	spin_unlock(&dev->_xmit_lock);
}

static inline void netif_tx_unlock_bh(struct net_device *dev)
{
	dev->xmit_lock_owner = -1;
	spin_unlock_bh(&dev->_xmit_lock);
}

1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427
#define HARD_TX_LOCK(dev, cpu) {			\
	if ((dev->features & NETIF_F_LLTX) == 0) {	\
		__netif_tx_lock(dev, cpu);			\
	}						\
}

#define HARD_TX_UNLOCK(dev) {				\
	if ((dev->features & NETIF_F_LLTX) == 0) {	\
		netif_tx_unlock(dev);			\
	}						\
}

L
Linus Torvalds 已提交
1428 1429
static inline void netif_tx_disable(struct net_device *dev)
{
H
Herbert Xu 已提交
1430
	netif_tx_lock_bh(dev);
L
Linus Torvalds 已提交
1431
	netif_stop_queue(dev);
H
Herbert Xu 已提交
1432
	netif_tx_unlock_bh(dev);
L
Linus Torvalds 已提交
1433 1434 1435 1436 1437 1438 1439
}

/* These functions live elsewhere (drivers/net/net_init.c, but related) */

extern void		ether_setup(struct net_device *dev);

/* Support for loadable net-drivers */
1440 1441 1442 1443 1444
extern struct net_device *alloc_netdev_mq(int sizeof_priv, const char *name,
				       void (*setup)(struct net_device *),
				       unsigned int queue_count);
#define alloc_netdev(sizeof_priv, name, setup) \
	alloc_netdev_mq(sizeof_priv, name, setup, 1)
L
Linus Torvalds 已提交
1445 1446
extern int		register_netdev(struct net_device *dev);
extern void		unregister_netdev(struct net_device *dev);
1447 1448 1449 1450 1451
/* Functions used for secondary unicast and multicast support */
extern void		dev_set_rx_mode(struct net_device *dev);
extern void		__dev_set_rx_mode(struct net_device *dev);
extern int		dev_unicast_delete(struct net_device *dev, void *addr, int alen);
extern int		dev_unicast_add(struct net_device *dev, void *addr, int alen);
1452 1453
extern int		dev_unicast_sync(struct net_device *to, struct net_device *from);
extern void		dev_unicast_unsync(struct net_device *to, struct net_device *from);
L
Linus Torvalds 已提交
1454 1455
extern int 		dev_mc_delete(struct net_device *dev, void *addr, int alen, int all);
extern int		dev_mc_add(struct net_device *dev, void *addr, int alen, int newonly);
1456 1457
extern int		dev_mc_sync(struct net_device *to, struct net_device *from);
extern void		dev_mc_unsync(struct net_device *to, struct net_device *from);
1458 1459
extern int 		__dev_addr_delete(struct dev_addr_list **list, int *count, void *addr, int alen, int all);
extern int		__dev_addr_add(struct dev_addr_list **list, int *count, void *addr, int alen, int newonly);
1460 1461
extern int		__dev_addr_sync(struct dev_addr_list **to, int *to_count, struct dev_addr_list **from, int *from_count);
extern void		__dev_addr_unsync(struct dev_addr_list **to, int *to_count, struct dev_addr_list **from, int *from_count);
L
Linus Torvalds 已提交
1462 1463 1464
extern void		dev_set_promiscuity(struct net_device *dev, int inc);
extern void		dev_set_allmulti(struct net_device *dev, int inc);
extern void		netdev_state_change(struct net_device *dev);
1465
extern void		netdev_features_change(struct net_device *dev);
L
Linus Torvalds 已提交
1466
/* Load a device via the kmod */
1467
extern void		dev_load(struct net *net, const char *name);
L
Linus Torvalds 已提交
1468 1469 1470 1471
extern void		dev_mcast_init(void);
extern int		netdev_max_backlog;
extern int		weight_p;
extern int		netdev_set_master(struct net_device *dev, struct net_device *master);
1472
extern int skb_checksum_help(struct sk_buff *skb);
1473
extern struct sk_buff *skb_gso_segment(struct sk_buff *skb, int features);
1474 1475 1476 1477 1478 1479 1480
#ifdef CONFIG_BUG
extern void netdev_rx_csum_fault(struct net_device *dev);
#else
static inline void netdev_rx_csum_fault(struct net_device *dev)
{
}
#endif
L
Linus Torvalds 已提交
1481 1482 1483 1484
/* rx skb timestamps */
extern void		net_enable_timestamp(void);
extern void		net_disable_timestamp(void);

1485 1486 1487 1488 1489 1490 1491 1492
#ifdef CONFIG_PROC_FS
extern void *dev_seq_start(struct seq_file *seq, loff_t *pos);
extern void *dev_seq_next(struct seq_file *seq, void *v, loff_t *pos);
extern void dev_seq_stop(struct seq_file *seq, void *v);
#endif

extern void linkwatch_run_queue(void);

1493 1494
extern int netdev_compute_features(unsigned long all, unsigned long one);

1495
static inline int net_gso_ok(int features, int gso_type)
1496
{
1497
	int feature = gso_type << NETIF_F_GSO_SHIFT;
1498
	return (features & feature) == feature;
1499 1500
}

1501 1502
static inline int skb_gso_ok(struct sk_buff *skb, int features)
{
1503
	return net_gso_ok(features, skb_shinfo(skb)->gso_type);
1504 1505
}

1506 1507
static inline int netif_needs_gso(struct net_device *dev, struct sk_buff *skb)
{
1508 1509
	return skb_is_gso(skb) &&
	       (!skb_gso_ok(skb, dev->features) ||
1510
		unlikely(skb->ip_summed != CHECKSUM_PARTIAL));
1511 1512
}

1513 1514 1515 1516 1517 1518
static inline void netif_set_gso_max_size(struct net_device *dev,
					  unsigned int size)
{
	dev->gso_max_size = size;
}

1519
/* On bonding slaves other than the currently active slave, suppress
1520 1521
 * duplicates except for 802.3ad ETH_P_SLOW, alb non-mcast/bcast, and
 * ARP on active-backup slaves with arp_validate enabled.
1522 1523 1524 1525 1526 1527 1528 1529
 */
static inline int skb_bond_should_drop(struct sk_buff *skb)
{
	struct net_device *dev = skb->dev;
	struct net_device *master = dev->master;

	if (master &&
	    (dev->priv_flags & IFF_SLAVE_INACTIVE)) {
1530 1531 1532 1533
		if ((dev->priv_flags & IFF_SLAVE_NEEDARP) &&
		    skb->protocol == __constant_htons(ETH_P_ARP))
			return 0;

1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547
		if (master->priv_flags & IFF_MASTER_ALB) {
			if (skb->pkt_type != PACKET_BROADCAST &&
			    skb->pkt_type != PACKET_MULTICAST)
				return 0;
		}
		if (master->priv_flags & IFF_MASTER_8023AD &&
		    skb->protocol == __constant_htons(ETH_P_SLOW))
			return 0;

		return 1;
	}
	return 0;
}

L
Linus Torvalds 已提交
1548 1549 1550
#endif /* __KERNEL__ */

#endif	/* _LINUX_DEV_H */