netdevice.h 46.2 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
#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.
 */
 
96 97 98 99 100 101 102 103
#if defined(CONFIG_WLAN_80211) || defined(CONFIG_AX25) || defined(CONFIG_AX25_MODULE)
# if defined(CONFIG_MAC80211_MESH)
#  define LL_MAX_HEADER 128
# else
#  define LL_MAX_HEADER 96
# endif
#elif defined(CONFIG_TR)
# define LL_MAX_HEADER 48
L
Linus Torvalds 已提交
104
#else
105
# define LL_MAX_HEADER 32
L
Linus Torvalds 已提交
106 107
#endif

D
David S. Miller 已提交
108 109 110 111
#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 已提交
112 113 114 115 116
#define MAX_HEADER LL_MAX_HEADER
#else
#define MAX_HEADER (LL_MAX_HEADER + 48)
#endif

117 118 119 120 121 122 123 124
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 已提交
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 192 193
/*
 *	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);

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

/*
 *	We tag multicasts with these structures.
 */
207 208 209 210 211 212

#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 已提交
213 214 215 216 217

struct hh_cache
{
	struct hh_cache *hh_next;	/* Next entry			     */
	atomic_t	hh_refcnt;	/* number of users                   */
218 219 220 221 222 223 224 225
/*
 * 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 已提交
226 227 228
                                         *  NOTE:  For VLANs, this will be the
                                         *  encapuslated type. --BLG
                                         */
229
	u16		hh_len;		/* length of header */
L
Linus Torvalds 已提交
230
	int		(*hh_output)(struct sk_buff *skb);
231
	seqlock_t	hh_lock;
L
Linus Torvalds 已提交
232 233 234 235

	/* cached hardware header; allow for machine alignment needs.        */
#define HH_DATA_MOD	16
#define HH_DATA_OFF(__len) \
J
Jiri Benc 已提交
236
	(HH_DATA_MOD - (((__len - 1) & (HH_DATA_MOD - 1)) + 1))
L
Linus Torvalds 已提交
237 238 239 240 241 242 243 244 245 246 247 248
#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.
249 250 251
 *
 * LL_ALLOCATED_SPACE also takes into account the tailroom the device
 * may need.
L
Linus Torvalds 已提交
252 253
 */
#define LL_RESERVED_SPACE(dev) \
254
	((((dev)->hard_header_len+(dev)->needed_headroom)&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
L
Linus Torvalds 已提交
255
#define LL_RESERVED_SPACE_EXTRA(dev,extra) \
256 257 258
	((((dev)->hard_header_len+(dev)->needed_headroom+(extra))&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
#define LL_ALLOCATED_SPACE(dev) \
	((((dev)->hard_header_len+(dev)->needed_headroom+(dev)->needed_tailroom)&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
L
Linus Torvalds 已提交
259

260 261 262 263 264 265 266 267 268 269 270 271 272
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 已提交
273 274 275 276 277 278 279 280 281 282 283 284
/* 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 已提交
285 286
	__LINK_STATE_LINKWATCH_PENDING,
	__LINK_STATE_DORMANT,
H
Herbert Xu 已提交
287
	__LINK_STATE_QDISC_RUNNING,
L
Linus Torvalds 已提交
288 289 290 291 292 293 294 295 296 297 298 299 300
};


/*
 * 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

301
extern int __init netdev_boot_setup(char *str);
L
Linus Torvalds 已提交
302

303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328
/*
 * 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 已提交
329
	NAPI_STATE_DISABLE,	/* Disable pending */
330 331
};

332
extern void __napi_schedule(struct napi_struct *n);
333

D
David S. Miller 已提交
334 335 336 337 338
static inline int napi_disable_pending(struct napi_struct *n)
{
	return test_bit(NAPI_STATE_DISABLE, &n->state);
}

339 340 341 342 343 344
/**
 *	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 已提交
345 346
 * insure only one NAPI poll instance runs.  We also make
 * sure there is no pending NAPI disable.
347 348 349
 */
static inline int napi_schedule_prep(struct napi_struct *n)
{
D
David S. Miller 已提交
350 351
	return !napi_disable_pending(n) &&
		!test_and_set_bit(NAPI_STATE_SCHED, &n->state);
352 353 354 355 356 357 358 359 360 361 362 363 364 365 366
}

/**
 *	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);
}

367 368 369 370 371 372 373 374 375 376
/* 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;
}

377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392
/**
 *	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)
{
393 394 395
	unsigned long flags;

	local_irq_save(flags);
396
	__napi_complete(n);
397
	local_irq_restore(flags);
398 399 400 401 402 403 404 405 406 407 408
}

/**
 *	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 已提交
409
	set_bit(NAPI_STATE_DISABLE, &n->state);
410
	while (test_and_set_bit(NAPI_STATE_SCHED, &n->state))
411
		msleep(1);
D
David S. Miller 已提交
412
	clear_bit(NAPI_STATE_DISABLE, &n->state);
413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428
}

/**
 *	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);
}

429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446
#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 已提交
447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465
/*
 *	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];
466 467
	/* device name hash chain */
	struct hlist_node	name_hlist;
L
Linus Torvalds 已提交
468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487

	/*
	 *	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;

488
	struct list_head	dev_list;
489 490 491
#ifdef CONFIG_NETPOLL
	struct list_head	napi_list;
#endif
L
Linus Torvalds 已提交
492 493 494 495 496 497
	
	/* The device initialization function. Called only once. */
	int			(*init)(struct net_device *dev);

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

498 499 500
	/* Net device features */
	unsigned long		features;
#define NETIF_F_SG		1	/* Scatter/gather IO. */
501
#define NETIF_F_IP_CSUM		2	/* Can checksum TCP/UDP over IPv4. */
502 503
#define NETIF_F_NO_CSUM		4	/* Does not require checksum. F.e. loopack. */
#define NETIF_F_HW_CSUM		8	/* Can checksum all the packets. */
504
#define NETIF_F_IPV6_CSUM	16	/* Can checksum TCP/UDP over IPV6 */
505 506 507 508 509 510
#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 已提交
511
#define NETIF_F_GSO		2048	/* Enable software GSO. */
512 513
#define NETIF_F_LLTX		4096	/* LockLess TX - deprecated. Please */
					/* do not use LLTX in new drivers */
514
#define NETIF_F_NETNS_LOCAL	8192	/* Does not change network namespaces */
515
#define NETIF_F_MULTI_QUEUE	16384	/* Has multiple TX/RX queues */
516
#define NETIF_F_LRO		32768	/* large receive offload */
517 518

	/* Segmentation offload features */
519 520
#define NETIF_F_GSO_SHIFT	16
#define NETIF_F_GSO_MASK	0xffff0000
521
#define NETIF_F_TSO		(SKB_GSO_TCPV4 << NETIF_F_GSO_SHIFT)
H
Herbert Xu 已提交
522
#define NETIF_F_UFO		(SKB_GSO_UDP << NETIF_F_GSO_SHIFT)
523
#define NETIF_F_GSO_ROBUST	(SKB_GSO_DODGY << NETIF_F_GSO_SHIFT)
H
Herbert Xu 已提交
524 525
#define NETIF_F_TSO_ECN		(SKB_GSO_TCP_ECN << NETIF_F_GSO_SHIFT)
#define NETIF_F_TSO6		(SKB_GSO_TCPV6 << NETIF_F_GSO_SHIFT)
526

527 528 529
	/* List of features with software fallbacks. */
#define NETIF_F_GSO_SOFTWARE	(NETIF_F_TSO | NETIF_F_TSO_ECN | NETIF_F_TSO6)

530

531
#define NETIF_F_GEN_CSUM	(NETIF_F_NO_CSUM | NETIF_F_HW_CSUM)
532 533 534
#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)
535

L
Linus Torvalds 已提交
536 537 538 539 540 541 542 543
	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 已提交
544
	struct net_device_stats	stats;
L
Linus Torvalds 已提交
545

546
#ifdef CONFIG_WIRELESS_EXT
L
Linus Torvalds 已提交
547 548 549 550 551
	/* 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;
552
#endif
553
	const struct ethtool_ops *ethtool_ops;
L
Linus Torvalds 已提交
554

555 556 557
	/* Hardware header description */
	const struct header_ops *header_ops;

L
Linus Torvalds 已提交
558 559 560 561 562 563 564
	/*
	 * 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 已提交
565
	unsigned int		flags;	/* interface flags (a la BSD)	*/
L
Linus Torvalds 已提交
566 567 568 569
	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 已提交
570 571 572
	unsigned char		operstate; /* RFC2863 operstate */
	unsigned char		link_mode; /* mapping policy to operstate */

L
Linus Torvalds 已提交
573 574 575 576
	unsigned		mtu;	/* interface MTU value		*/
	unsigned short		type;	/* interface hardware type	*/
	unsigned short		hard_header_len;	/* hardware hdr length	*/

577 578 579 580 581 582 583
	/* extra head- and tailroom the hardware may need, but not in all cases
	 * can this be guaranteed, especially tailroom. Some cases also use
	 * LL_MAX_HEADER instead to allocate the skb.
	 */
	unsigned short		needed_headroom;
	unsigned short		needed_tailroom;

L
Linus Torvalds 已提交
584 585 586 587 588
	struct net_device	*master; /* Pointer to master device of a group,
					  * which this device is member of.
					  */

	/* Interface address info. */
589
	unsigned char		perm_addr[MAX_ADDR_LEN]; /* permanent hw address */
L
Linus Torvalds 已提交
590 591 592
	unsigned char		addr_len;	/* hardware address length	*/
	unsigned short          dev_id;		/* for shared network cards */

593 594 595
	struct dev_addr_list	*uc_list;	/* Secondary unicast mac addresses */
	int			uc_count;	/* Number of installed ucasts	*/
	int			uc_promisc;
596
	struct dev_addr_list	*mc_list;	/* Multicast mac addresses	*/
L
Linus Torvalds 已提交
597
	int			mc_count;	/* Number of installed mcasts	*/
598 599
	unsigned int		promiscuity;
	unsigned int		allmulti;
L
Linus Torvalds 已提交
600 601 602 603 604 605 606 607 608 609


	/* 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 */
610 611
	struct wireless_dev	*ieee80211_ptr;	/* IEEE 802.11 specific data,
						   assign before registering */
L
Linus Torvalds 已提交
612

613 614 615 616 617 618 619 620 621
/*
 * 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 已提交
622

623 624 625 626
	/* ingress path synchronizer */
	spinlock_t		ingress_lock;
	struct Qdisc		*qdisc_ingress;

627 628 629 630 631
/*
 * Cache line mostly used on queue transmit path (qdisc)
 */
	/* device queue lock */
	spinlock_t		queue_lock ____cacheline_aligned_in_smp;
L
Linus Torvalds 已提交
632 633 634 635 636
	struct Qdisc		*qdisc;
	struct Qdisc		*qdisc_sleeping;
	struct list_head	qdisc_list;
	unsigned long		tx_queue_len;	/* Max frames per queue allowed */

637 638 639
	/* Partially transmitted GSO packet. */
	struct sk_buff		*gso_skb;

640 641 642
/*
 * One part is mostly used on xmit path (device)
 */
L
Linus Torvalds 已提交
643
	/* hard_start_xmit synchronizer */
H
Herbert Xu 已提交
644
	spinlock_t		_xmit_lock ____cacheline_aligned_in_smp;
L
Linus Torvalds 已提交
645 646 647 648
	/* cpu id of processor entered to hard_start_xmit or -1,
	   if nobody entered there.
	 */
	int			xmit_lock_owner;
649 650 651 652 653 654 655 656 657 658 659 660
	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 已提交
661
	/* Number of references to this device */
662 663
	atomic_t		refcnt ____cacheline_aligned_in_smp;

L
Linus Torvalds 已提交
664 665 666 667 668
	/* delayed register/unregister */
	struct list_head	todo_list;
	/* device index hash chain */
	struct hlist_node	index_hlist;

669 670
	struct net_device	*link_watch_next;

L
Linus Torvalds 已提交
671 672
	/* register/unregister state machine */
	enum { NETREG_UNINITIALIZED=0,
673
	       NETREG_REGISTERED,	/* completed register_netdevice */
L
Linus Torvalds 已提交
674 675 676 677 678 679 680 681 682 683 684 685 686 687
	       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
688 689 690
#define HAVE_CHANGE_RX_FLAGS
	void			(*change_rx_flags)(struct net_device *dev,
						   int flags);
691 692
#define HAVE_SET_RX_MODE
	void			(*set_rx_mode)(struct net_device *dev);
L
Linus Torvalds 已提交
693 694 695 696 697
#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);
698 699
#define HAVE_VALIDATE_ADDR
	int			(*validate_addr)(struct net_device *dev);
L
Linus Torvalds 已提交
700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720
#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
721
	struct netpoll_info	*npinfo;
L
Linus Torvalds 已提交
722 723 724 725 726
#endif
#ifdef CONFIG_NET_POLL_CONTROLLER
	void                    (*poll_controller)(struct net_device *dev);
#endif

727
#ifdef CONFIG_NET_NS
728 729
	/* Network namespace this network device is inside */
	struct net		*nd_net;
730
#endif
731

D
David S. Miller 已提交
732 733 734
	/* mid-layer private */
	void			*ml_priv;

L
Linus Torvalds 已提交
735 736
	/* bridge stuff */
	struct net_bridge_port	*br_port;
P
Patrick McHardy 已提交
737 738
	/* macvlan */
	struct macvlan_port	*macvlan_port;
L
Linus Torvalds 已提交
739 740

	/* class/net/name entry */
741
	struct device		dev;
742 743
	/* space for optional statistics and wireless sysfs groups */
	struct attribute_group  *sysfs_groups[3];
P
Patrick McHardy 已提交
744 745 746

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

748 749 750
	/* VLAN feature mask */
	unsigned long vlan_features;

751 752 753 754
	/* for setting kernel sock attribute on TCP connection setup */
#define GSO_MAX_SIZE		65536
	unsigned int		gso_max_size;

755 756
	/* The TX queue control structures */
	unsigned int			egress_subqueue_count;
757
	struct net_device_subqueue	egress_subqueue[1];
L
Linus Torvalds 已提交
758
};
759
#define to_net_dev(d) container_of(d, struct net_device, dev)
L
Linus Torvalds 已提交
760 761 762 763

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

764 765 766 767 768 769 770 771 772 773 774 775 776 777
/*
 * 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
778
void dev_net_set(struct net_device *dev, struct net *net)
779 780
{
#ifdef CONFIG_NET_NS
781 782
	release_net(dev->nd_net);
	dev->nd_net = hold_net(net);
783 784 785
#endif
}

786 787 788 789 790 791
/**
 *	netdev_priv - access network device private data
 *	@dev: network device
 *
 * Get network device private data
 */
792
static inline void *netdev_priv(const struct net_device *dev)
L
Linus Torvalds 已提交
793
{
794
	return dev->priv;
L
Linus Torvalds 已提交
795 796 797 798 799
}

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

802 803 804 805 806 807 808 809 810 811
/**
 *	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.
 */
812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828
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 已提交
829
struct packet_type {
D
David S. Miller 已提交
830 831 832 833 834 835
	__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 *);
836 837
	struct sk_buff		*(*gso_segment)(struct sk_buff *skb,
						int features);
838
	int			(*gso_send_check)(struct sk_buff *skb);
L
Linus Torvalds 已提交
839 840 841 842 843 844 845 846 847
	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 */

848

849 850 851 852 853 854 855
#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)
856

857 858 859 860 861
static inline struct net_device *next_net_device(struct net_device *dev)
{
	struct list_head *lh;
	struct net *net;

862
	net = dev_net(dev);
863 864 865 866 867 868 869 870 871
	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);
}
872

L
Linus Torvalds 已提交
873 874
extern int 			netdev_boot_setup_check(struct net_device *dev);
extern unsigned long		netdev_boot_base(const char *prefix, int unit);
875 876 877
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 已提交
878 879 880 881
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);

882
extern struct net_device	*dev_get_by_flags(struct net *net, unsigned short flags,
L
Linus Torvalds 已提交
883
						  unsigned short mask);
884 885
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 已提交
886 887 888 889 890
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);
891
extern void		unregister_netdevice(struct net_device *dev);
L
Linus Torvalds 已提交
892 893 894 895
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);
896
extern int call_netdevice_notifiers(unsigned long val, struct net_device *dev);
897 898
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 已提交
899 900 901 902 903
extern int		dev_restart(struct net_device *dev);
#ifdef CONFIG_NETPOLL_TRAP
extern int		netpoll_trap(void);
#endif

904 905
static inline int dev_hard_header(struct sk_buff *skb, struct net_device *dev,
				  unsigned short type,
906 907
				  const void *daddr, const void *saddr,
				  unsigned len)
908
{
909
	if (!dev->header_ops || !dev->header_ops->create)
910
		return 0;
911 912

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

S
Stephen Hemminger 已提交
915 916 917 918 919
static inline int dev_parse_header(const struct sk_buff *skb,
				   unsigned char *haddr)
{
	const struct net_device *dev = skb->dev;

920
	if (!dev->header_ops || !dev->header_ops->parse)
S
Stephen Hemminger 已提交
921
		return 0;
922
	return dev->header_ops->parse(skb, haddr);
S
Stephen Hemminger 已提交
923 924
}

L
Linus Torvalds 已提交
925 926 927 928 929 930 931 932 933 934 935 936 937
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
{
938
	struct net_device	*output_queue;
L
Linus Torvalds 已提交
939 940 941 942
	struct sk_buff_head	input_pkt_queue;
	struct list_head	poll_list;
	struct sk_buff		*completion_queue;

943
	struct napi_struct	backlog;
944 945 946
#ifdef CONFIG_NET_DMA
	struct dma_chan		*net_dma;
#endif
L
Linus Torvalds 已提交
947 948 949 950 951 952
};

DECLARE_PER_CPU(struct softnet_data,softnet_data);

#define HAVE_NETIF_QUEUE

953
extern void __netif_schedule(struct net_device *dev);
L
Linus Torvalds 已提交
954 955 956 957 958 959 960

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

961 962 963 964 965 966
/**
 *	netif_start_queue - allow transmit
 *	@dev: network device
 *
 *	Allow upper layers to call the device hard_start_xmit routine.
 */
L
Linus Torvalds 已提交
967 968 969 970 971
static inline void netif_start_queue(struct net_device *dev)
{
	clear_bit(__LINK_STATE_XOFF, &dev->state);
}

972 973 974 975 976 977 978
/**
 *	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 已提交
979 980 981
static inline void netif_wake_queue(struct net_device *dev)
{
#ifdef CONFIG_NETPOLL_TRAP
982 983
	if (netpoll_trap()) {
		clear_bit(__LINK_STATE_XOFF, &dev->state);
L
Linus Torvalds 已提交
984
		return;
985
	}
L
Linus Torvalds 已提交
986 987 988 989 990
#endif
	if (test_and_clear_bit(__LINK_STATE_XOFF, &dev->state))
		__netif_schedule(dev);
}

991 992 993 994 995 996 997
/**
 *	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 已提交
998 999 1000 1001 1002
static inline void netif_stop_queue(struct net_device *dev)
{
	set_bit(__LINK_STATE_XOFF, &dev->state);
}

1003 1004 1005 1006 1007 1008
/**
 *	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 已提交
1009 1010 1011 1012 1013
static inline int netif_queue_stopped(const struct net_device *dev)
{
	return test_bit(__LINK_STATE_XOFF, &dev->state);
}

1014 1015 1016 1017 1018 1019
/**
 *	netif_running - test if up
 *	@dev: network device
 *
 *	Test if the device has been brought up.
 */
L
Linus Torvalds 已提交
1020 1021 1022 1023 1024
static inline int netif_running(const struct net_device *dev)
{
	return test_bit(__LINK_STATE_START, &dev->state);
}

1025 1026 1027 1028 1029 1030
/*
 * 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.
 */
1031 1032 1033 1034 1035 1036 1037 1038

/**
 *	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.
 */
1039 1040 1041 1042 1043 1044 1045
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
}

1046 1047 1048 1049 1050 1051 1052
/**
 *	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.
 */
1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063
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
}

1064 1065 1066 1067 1068 1069 1070
/**
 *	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.
 */
1071
static inline int __netif_subqueue_stopped(const struct net_device *dev,
1072 1073 1074 1075 1076 1077 1078 1079 1080 1081
					 u16 queue_index)
{
#ifdef CONFIG_NETDEVICES_MULTIQUEUE
	return test_bit(__LINK_STATE_XOFF,
			&dev->egress_subqueue[queue_index].state);
#else
	return 0;
#endif
}

1082 1083 1084 1085 1086
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));
}
1087 1088 1089 1090 1091 1092 1093 1094

/**
 *	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.
 */
1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107
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
}

1108 1109 1110 1111 1112 1113 1114
/**
 *	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
 */
1115 1116 1117 1118 1119 1120 1121 1122
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 已提交
1123 1124

/* Use this variant when it is known for sure that it
1125 1126
 * is executing from hardware interrupt context or with hardware interrupts
 * disabled.
L
Linus Torvalds 已提交
1127
 */
1128
extern void dev_kfree_skb_irq(struct sk_buff *skb);
L
Linus Torvalds 已提交
1129 1130

/* Use this variant in places where it could be invoked
1131 1132
 * from either hardware interrupt or other context, with hardware interrupts
 * either disabled or enabled.
L
Linus Torvalds 已提交
1133
 */
1134
extern void dev_kfree_skb_any(struct sk_buff *skb);
L
Linus Torvalds 已提交
1135 1136 1137 1138 1139 1140

#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);
1141
extern int		dev_valid_name(const char *name);
1142 1143
extern int		dev_ioctl(struct net *net, unsigned int cmd, void __user *);
extern int		dev_ethtool(struct net *net, struct ifreq *);
L
Linus Torvalds 已提交
1144 1145 1146
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 *);
1147 1148
extern int		dev_change_net_namespace(struct net_device *,
						 struct net *, const char *);
L
Linus Torvalds 已提交
1149 1150 1151
extern int		dev_set_mtu(struct net_device *, int);
extern int		dev_set_mac_address(struct net_device *,
					    struct sockaddr *);
1152 1153
extern int		dev_hard_start_xmit(struct sk_buff *skb,
					    struct net_device *dev);
L
Linus Torvalds 已提交
1154

1155
extern int		netdev_budget;
L
Linus Torvalds 已提交
1156 1157 1158 1159

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

1160 1161 1162 1163
/**
 *	dev_put - release reference to device
 *	@dev: network device
 *
1164
 * Release reference to device to allow it to be freed.
1165
 */
L
Linus Torvalds 已提交
1166 1167 1168 1169 1170
static inline void dev_put(struct net_device *dev)
{
	atomic_dec(&dev->refcnt);
}

1171 1172 1173 1174
/**
 *	dev_hold - get reference to device
 *	@dev: network device
 *
1175
 * Hold reference to device to keep it from being freed.
1176
 */
1177 1178 1179 1180
static inline void dev_hold(struct net_device *dev)
{
	atomic_inc(&dev->refcnt);
}
L
Linus Torvalds 已提交
1181 1182 1183 1184

/* 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 已提交
1185 1186 1187 1188
 *
 * 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 已提交
1189 1190 1191 1192
 */

extern void linkwatch_fire_event(struct net_device *dev);

1193 1194 1195 1196 1197 1198
/**
 *	netif_carrier_ok - test if carrier present
 *	@dev: network device
 *
 * Check if carrier is present on device
 */
L
Linus Torvalds 已提交
1199 1200 1201 1202 1203 1204 1205
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);

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

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

1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222
/**
 *	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 已提交
1223 1224 1225 1226 1227 1228
static inline void netif_dormant_on(struct net_device *dev)
{
	if (!test_and_set_bit(__LINK_STATE_DORMANT, &dev->state))
		linkwatch_fire_event(dev);
}

1229 1230 1231 1232 1233 1234
/**
 *	netif_dormant_off - set device as not dormant.
 *	@dev: network device
 *
 * Device is not in dormant state.
 */
S
Stefan Rompf 已提交
1235 1236 1237 1238 1239 1240
static inline void netif_dormant_off(struct net_device *dev)
{
	if (test_and_clear_bit(__LINK_STATE_DORMANT, &dev->state))
		linkwatch_fire_event(dev);
}

1241 1242 1243 1244 1245 1246
/**
 *	netif_dormant - test if carrier present
 *	@dev: network device
 *
 * Check if carrier is present on device
 */
S
Stefan Rompf 已提交
1247 1248 1249 1250 1251 1252
static inline int netif_dormant(const struct net_device *dev)
{
	return test_bit(__LINK_STATE_DORMANT, &dev->state);
}


1253 1254 1255 1256 1257 1258
/**
 *	netif_oper_up - test if device is operational
 *	@dev: network device
 *
 * Check if carrier is operational
 */
S
Stefan Rompf 已提交
1259 1260 1261 1262 1263
static inline int netif_oper_up(const struct net_device *dev) {
	return (dev->operstate == IF_OPER_UP ||
		dev->operstate == IF_OPER_UNKNOWN /* backward compat */);
}

1264 1265 1266 1267 1268 1269
/**
 *	netif_device_present - is device available or removed
 *	@dev: network device
 *
 * Check if device has not been removed from system.
 */
L
Linus Torvalds 已提交
1270 1271 1272 1273 1274
static inline int netif_device_present(struct net_device *dev)
{
	return test_bit(__LINK_STATE_PRESENT, &dev->state);
}

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

1277
extern void netif_device_attach(struct net_device *dev);
L
Linus Torvalds 已提交
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 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328

/*
 * 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;
}

1329
/* Test if receive needs to be scheduled but only if up */
1330 1331
static inline int netif_rx_schedule_prep(struct net_device *dev,
					 struct napi_struct *napi)
L
Linus Torvalds 已提交
1332
{
D
David S. Miller 已提交
1333
	return napi_schedule_prep(napi);
L
Linus Torvalds 已提交
1334 1335 1336 1337 1338
}

/* Add interface to tail of rx poll list. This assumes that _prep has
 * already been called and returned 1.
 */
1339 1340 1341 1342 1343
static inline void __netif_rx_schedule(struct net_device *dev,
				       struct napi_struct *napi)
{
	__napi_schedule(napi);
}
L
Linus Torvalds 已提交
1344 1345 1346

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

1347 1348
static inline void netif_rx_schedule(struct net_device *dev,
				     struct napi_struct *napi)
L
Linus Torvalds 已提交
1349
{
1350 1351
	if (netif_rx_schedule_prep(dev, napi))
		__netif_rx_schedule(dev, napi);
L
Linus Torvalds 已提交
1352 1353
}

1354 1355 1356
/* 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 已提交
1357
{
1358 1359
	if (napi_schedule_prep(napi)) {
		__netif_rx_schedule(dev, napi);
L
Linus Torvalds 已提交
1360 1361 1362 1363 1364
		return 1;
	}
	return 0;
}

1365 1366 1367
/* same as netif_rx_complete, except that local_irq_save(flags)
 * has already been issued
 */
1368 1369
static inline void __netif_rx_complete(struct net_device *dev,
				       struct napi_struct *napi)
1370
{
1371
	__napi_complete(napi);
1372 1373
}

L
Linus Torvalds 已提交
1374 1375 1376 1377 1378
/* 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().
 */
1379 1380
static inline void netif_rx_complete(struct net_device *dev,
				     struct napi_struct *napi)
L
Linus Torvalds 已提交
1381 1382 1383 1384
{
	unsigned long flags;

	local_irq_save(flags);
1385
	__netif_rx_complete(dev, napi);
L
Linus Torvalds 已提交
1386 1387 1388
	local_irq_restore(flags);
}

1389 1390 1391
/**
 *	netif_tx_lock - grab network device transmit lock
 *	@dev: network device
1392
 *	@cpu: cpu number of lock owner
1393 1394 1395
 *
 * Get network device transmit lock
 */
1396
static inline void __netif_tx_lock(struct net_device *dev, int cpu)
H
Herbert Xu 已提交
1397 1398
{
	spin_lock(&dev->_xmit_lock);
1399 1400 1401 1402 1403 1404
	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 已提交
1405 1406 1407 1408 1409 1410 1411 1412 1413 1414
}

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)
{
1415 1416
	int ok = spin_trylock(&dev->_xmit_lock);
	if (likely(ok))
H
Herbert Xu 已提交
1417
		dev->xmit_lock_owner = smp_processor_id();
1418
	return ok;
H
Herbert Xu 已提交
1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429 1430 1431 1432
}

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);
}

1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444
#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 已提交
1445 1446
static inline void netif_tx_disable(struct net_device *dev)
{
H
Herbert Xu 已提交
1447
	netif_tx_lock_bh(dev);
L
Linus Torvalds 已提交
1448
	netif_stop_queue(dev);
H
Herbert Xu 已提交
1449
	netif_tx_unlock_bh(dev);
L
Linus Torvalds 已提交
1450 1451 1452 1453 1454 1455 1456
}

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

extern void		ether_setup(struct net_device *dev);

/* Support for loadable net-drivers */
1457 1458 1459 1460 1461
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 已提交
1462 1463
extern int		register_netdev(struct net_device *dev);
extern void		unregister_netdev(struct net_device *dev);
1464 1465 1466 1467 1468
/* 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);
1469 1470
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 已提交
1471 1472
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);
1473 1474
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);
1475 1476
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);
1477 1478
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 已提交
1479 1480 1481
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);
1482
extern void		netdev_bonding_change(struct net_device *dev);
1483
extern void		netdev_features_change(struct net_device *dev);
L
Linus Torvalds 已提交
1484
/* Load a device via the kmod */
1485
extern void		dev_load(struct net *net, const char *name);
L
Linus Torvalds 已提交
1486 1487 1488 1489
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);
1490
extern int skb_checksum_help(struct sk_buff *skb);
1491
extern struct sk_buff *skb_gso_segment(struct sk_buff *skb, int features);
1492 1493 1494 1495 1496 1497 1498
#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 已提交
1499 1500 1501 1502
/* rx skb timestamps */
extern void		net_enable_timestamp(void);
extern void		net_disable_timestamp(void);

1503 1504 1505 1506 1507 1508
#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

1509 1510 1511
extern int netdev_class_create_file(struct class_attribute *class_attr);
extern void netdev_class_remove_file(struct class_attribute *class_attr);

1512 1513
extern void linkwatch_run_queue(void);

1514 1515
extern int netdev_compute_features(unsigned long all, unsigned long one);

1516
static inline int net_gso_ok(int features, int gso_type)
1517
{
1518
	int feature = gso_type << NETIF_F_GSO_SHIFT;
1519
	return (features & feature) == feature;
1520 1521
}

1522 1523
static inline int skb_gso_ok(struct sk_buff *skb, int features)
{
1524
	return net_gso_ok(features, skb_shinfo(skb)->gso_type);
1525 1526
}

1527 1528
static inline int netif_needs_gso(struct net_device *dev, struct sk_buff *skb)
{
1529 1530
	return skb_is_gso(skb) &&
	       (!skb_gso_ok(skb, dev->features) ||
1531
		unlikely(skb->ip_summed != CHECKSUM_PARTIAL));
1532 1533
}

1534 1535 1536 1537 1538 1539
static inline void netif_set_gso_max_size(struct net_device *dev,
					  unsigned int size)
{
	dev->gso_max_size = size;
}

1540
/* On bonding slaves other than the currently active slave, suppress
1541 1542
 * duplicates except for 802.3ad ETH_P_SLOW, alb non-mcast/bcast, and
 * ARP on active-backup slaves with arp_validate enabled.
1543 1544 1545 1546 1547 1548 1549 1550
 */
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)) {
1551 1552 1553 1554
		if ((dev->priv_flags & IFF_SLAVE_NEEDARP) &&
		    skb->protocol == __constant_htons(ETH_P_ARP))
			return 0;

1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 1568
		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 已提交
1569 1570 1571
#endif /* __KERNEL__ */

#endif	/* _LINUX_DEV_H */