]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blame - include/linux/netdevice.h
[NET]: [DOC] Multiqueue hardware support documentation
[mirror_ubuntu-artful-kernel.git] / include / linux / netdevice.h
CommitLineData
1da177e4
LT
1/*
2 * INET An implementation of the TCP/IP protocol suite for the LINUX
3 * operating system. INET is implemented using the BSD Socket
4 * interface as the means of communication with the user level.
5 *
6 * Definitions for the Interfaces handler.
7 *
8 * Version: @(#)dev.h 1.0.10 08/12/93
9 *
02c30a84 10 * Authors: Ross Biro
1da177e4
LT
11 * Fred N. van Kempen, <waltje@uWalt.NL.Mugnet.ORG>
12 * Corey Minyard <wf-rch!minyard@relay.EU.net>
13 * Donald J. Becker, <becker@cesdis.gsfc.nasa.gov>
14 * Alan Cox, <Alan.Cox@linux.org>
15 * Bjorn Ekwall. <bj0rn@blox.se>
16 * Pekka Riikonen <priikone@poseidon.pspt.fi>
17 *
18 * This program is free software; you can redistribute it and/or
19 * modify it under the terms of the GNU General Public License
20 * as published by the Free Software Foundation; either version
21 * 2 of the License, or (at your option) any later version.
22 *
23 * Moved to /usr/include/linux for NET3
24 */
25#ifndef _LINUX_NETDEVICE_H
26#define _LINUX_NETDEVICE_H
27
28#include <linux/if.h>
29#include <linux/if_ether.h>
30#include <linux/if_packet.h>
31
32#ifdef __KERNEL__
d7fe0f24 33#include <linux/timer.h>
1da177e4
LT
34#include <asm/atomic.h>
35#include <asm/cache.h>
36#include <asm/byteorder.h>
37
1da177e4
LT
38#include <linux/device.h>
39#include <linux/percpu.h>
db217334 40#include <linux/dmaengine.h>
1da177e4 41
1da177e4
LT
42struct vlan_group;
43struct ethtool_ops;
115c1d6e 44struct netpoll_info;
704232c2
JB
45/* 802.11 specific */
46struct wireless_dev;
1da177e4
LT
47 /* source back-compat hooks */
48#define SET_ETHTOOL_OPS(netdev,ops) \
49 ( (netdev)->ethtool_ops = (ops) )
50
51#define HAVE_ALLOC_NETDEV /* feature macro: alloc_xxxdev
52 functions are available. */
53#define HAVE_FREE_NETDEV /* free_netdev() */
54#define HAVE_NETDEV_PRIV /* netdev_priv() */
55
56#define NET_XMIT_SUCCESS 0
57#define NET_XMIT_DROP 1 /* skb dropped */
58#define NET_XMIT_CN 2 /* congestion notification */
59#define NET_XMIT_POLICED 3 /* skb is shot by police */
60#define NET_XMIT_BYPASS 4 /* packet does not leave via dequeue;
61 (TC use only - dev_queue_xmit
62 returns this as NET_XMIT_SUCCESS) */
63
64/* Backlog congestion levels */
65#define NET_RX_SUCCESS 0 /* keep 'em coming, baby */
66#define NET_RX_DROP 1 /* packet dropped */
67#define NET_RX_CN_LOW 2 /* storm alert, just in case */
68#define NET_RX_CN_MOD 3 /* Storm on its way! */
69#define NET_RX_CN_HIGH 4 /* The storm is here */
70#define NET_RX_BAD 5 /* packet dropped due to kernel error */
71
b9df3cb8
GR
72/* NET_XMIT_CN is special. It does not guarantee that this packet is lost. It
73 * indicates that the device will soon be dropping packets, or already drops
74 * some packets of the same priority; prompting us to send less aggressively. */
75#define net_xmit_eval(e) ((e) == NET_XMIT_CN? 0 : (e))
1da177e4
LT
76#define net_xmit_errno(e) ((e) != NET_XMIT_CN ? -ENOBUFS : 0)
77
78#endif
79
80#define MAX_ADDR_LEN 32 /* Largest hardware address length */
81
82/* Driver transmit return codes */
83#define NETDEV_TX_OK 0 /* driver took care of packet */
84#define NETDEV_TX_BUSY 1 /* driver tx path was busy*/
85#define NETDEV_TX_LOCKED -1 /* driver tx lock was already taken */
86
87/*
88 * Compute the worst case header length according to the protocols
89 * used.
90 */
91
92#if !defined(CONFIG_AX25) && !defined(CONFIG_AX25_MODULE) && !defined(CONFIG_TR)
93#define LL_MAX_HEADER 32
94#else
95#if defined(CONFIG_AX25) || defined(CONFIG_AX25_MODULE)
96#define LL_MAX_HEADER 96
97#else
98#define LL_MAX_HEADER 48
99#endif
100#endif
101
e81c7359
DM
102#if !defined(CONFIG_NET_IPIP) && !defined(CONFIG_NET_IPIP_MODULE) && \
103 !defined(CONFIG_NET_IPGRE) && !defined(CONFIG_NET_IPGRE_MODULE) && \
104 !defined(CONFIG_IPV6_SIT) && !defined(CONFIG_IPV6_SIT_MODULE) && \
105 !defined(CONFIG_IPV6_TUNNEL) && !defined(CONFIG_IPV6_TUNNEL_MODULE)
1da177e4
LT
106#define MAX_HEADER LL_MAX_HEADER
107#else
108#define MAX_HEADER (LL_MAX_HEADER + 48)
109#endif
110
111/*
112 * Network device statistics. Akin to the 2.0 ether stats but
113 * with byte counters.
114 */
115
116struct net_device_stats
117{
118 unsigned long rx_packets; /* total packets received */
119 unsigned long tx_packets; /* total packets transmitted */
120 unsigned long rx_bytes; /* total bytes received */
121 unsigned long tx_bytes; /* total bytes transmitted */
122 unsigned long rx_errors; /* bad packets received */
123 unsigned long tx_errors; /* packet transmit problems */
124 unsigned long rx_dropped; /* no space in linux buffers */
125 unsigned long tx_dropped; /* no space available in linux */
126 unsigned long multicast; /* multicast packets received */
127 unsigned long collisions;
128
129 /* detailed rx_errors: */
130 unsigned long rx_length_errors;
131 unsigned long rx_over_errors; /* receiver ring buff overflow */
132 unsigned long rx_crc_errors; /* recved pkt with crc error */
133 unsigned long rx_frame_errors; /* recv'd frame alignment error */
134 unsigned long rx_fifo_errors; /* recv'r fifo overrun */
135 unsigned long rx_missed_errors; /* receiver missed packet */
136
137 /* detailed tx_errors */
138 unsigned long tx_aborted_errors;
139 unsigned long tx_carrier_errors;
140 unsigned long tx_fifo_errors;
141 unsigned long tx_heartbeat_errors;
142 unsigned long tx_window_errors;
143
144 /* for cslip etc */
145 unsigned long rx_compressed;
146 unsigned long tx_compressed;
147};
148
149
150/* Media selection options. */
151enum {
152 IF_PORT_UNKNOWN = 0,
153 IF_PORT_10BASE2,
154 IF_PORT_10BASET,
155 IF_PORT_AUI,
156 IF_PORT_100BASET,
157 IF_PORT_100BASETX,
158 IF_PORT_100BASEFX
159};
160
161#ifdef __KERNEL__
162
163#include <linux/cache.h>
164#include <linux/skbuff.h>
165
166struct neighbour;
167struct neigh_parms;
168struct sk_buff;
169
170struct netif_rx_stats
171{
172 unsigned total;
173 unsigned dropped;
174 unsigned time_squeeze;
1da177e4
LT
175 unsigned cpu_collision;
176};
177
178DECLARE_PER_CPU(struct netif_rx_stats, netdev_rx_stat);
179
bf742482
PM
180struct dev_addr_list
181{
182 struct dev_addr_list *next;
183 u8 da_addr[MAX_ADDR_LEN];
184 u8 da_addrlen;
185 int da_users;
186 int da_gusers;
187};
1da177e4
LT
188
189/*
190 * We tag multicasts with these structures.
191 */
3fba5a8b
PM
192
193#define dev_mc_list dev_addr_list
194#define dmi_addr da_addr
195#define dmi_addrlen da_addrlen
196#define dmi_users da_users
197#define dmi_gusers da_gusers
1da177e4
LT
198
199struct hh_cache
200{
201 struct hh_cache *hh_next; /* Next entry */
202 atomic_t hh_refcnt; /* number of users */
f0490980
ED
203/*
204 * We want hh_output, hh_len, hh_lock and hh_data be a in a separate
205 * cache line on SMP.
206 * They are mostly read, but hh_refcnt may be changed quite frequently,
207 * incurring cache line ping pongs.
208 */
209 __be16 hh_type ____cacheline_aligned_in_smp;
210 /* protocol identifier, f.e ETH_P_IP
1da177e4
LT
211 * NOTE: For VLANs, this will be the
212 * encapuslated type. --BLG
213 */
d5c42c0e 214 u16 hh_len; /* length of header */
1da177e4 215 int (*hh_output)(struct sk_buff *skb);
3644f0ce 216 seqlock_t hh_lock;
1da177e4
LT
217
218 /* cached hardware header; allow for machine alignment needs. */
219#define HH_DATA_MOD 16
220#define HH_DATA_OFF(__len) \
5ba0eac6 221 (HH_DATA_MOD - (((__len - 1) & (HH_DATA_MOD - 1)) + 1))
1da177e4
LT
222#define HH_DATA_ALIGN(__len) \
223 (((__len)+(HH_DATA_MOD-1))&~(HH_DATA_MOD - 1))
224 unsigned long hh_data[HH_DATA_ALIGN(LL_MAX_HEADER) / sizeof(long)];
225};
226
227/* Reserve HH_DATA_MOD byte aligned hard_header_len, but at least that much.
228 * Alternative is:
229 * dev->hard_header_len ? (dev->hard_header_len +
230 * (HH_DATA_MOD - 1)) & ~(HH_DATA_MOD - 1) : 0
231 *
232 * We could use other alignment values, but we must maintain the
233 * relationship HH alignment <= LL alignment.
234 */
235#define LL_RESERVED_SPACE(dev) \
236 (((dev)->hard_header_len&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
237#define LL_RESERVED_SPACE_EXTRA(dev,extra) \
238 ((((dev)->hard_header_len+extra)&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
239
240/* These flag bits are private to the generic network queueing
241 * layer, they may not be explicitly referenced by any other
242 * code.
243 */
244
245enum netdev_state_t
246{
247 __LINK_STATE_XOFF=0,
248 __LINK_STATE_START,
249 __LINK_STATE_PRESENT,
250 __LINK_STATE_SCHED,
251 __LINK_STATE_NOCARRIER,
252 __LINK_STATE_RX_SCHED,
b00055aa
SR
253 __LINK_STATE_LINKWATCH_PENDING,
254 __LINK_STATE_DORMANT,
48d83325 255 __LINK_STATE_QDISC_RUNNING,
1da177e4
LT
256};
257
258
259/*
260 * This structure holds at boot time configured netdevice settings. They
261 * are then used in the device probing.
262 */
263struct netdev_boot_setup {
264 char name[IFNAMSIZ];
265 struct ifmap map;
266};
267#define NETDEV_BOOT_SETUP_MAX 8
268
20380731 269extern int __init netdev_boot_setup(char *str);
1da177e4
LT
270
271/*
272 * The DEVICE structure.
273 * Actually, this whole structure is a big mistake. It mixes I/O
274 * data with strictly "high-level" data, and it has to know about
275 * almost every data structure used in the INET module.
276 *
277 * FIXME: cleanup struct net_device such that network protocol info
278 * moves out.
279 */
280
281struct net_device
282{
283
284 /*
285 * This is the first field of the "visible" part of this structure
286 * (i.e. as seen by users in the "Space.c" file). It is the name
287 * the interface.
288 */
289 char name[IFNAMSIZ];
9356b8fc
ED
290 /* device name hash chain */
291 struct hlist_node name_hlist;
1da177e4
LT
292
293 /*
294 * I/O specific fields
295 * FIXME: Merge these and struct ifmap into one
296 */
297 unsigned long mem_end; /* shared mem end */
298 unsigned long mem_start; /* shared mem start */
299 unsigned long base_addr; /* device I/O address */
300 unsigned int irq; /* device IRQ number */
301
302 /*
303 * Some hardware also needs these fields, but they are not
304 * part of the usual set specified in Space.c.
305 */
306
307 unsigned char if_port; /* Selectable AUI, TP,..*/
308 unsigned char dma; /* DMA channel */
309
310 unsigned long state;
311
7562f876 312 struct list_head dev_list;
1da177e4
LT
313
314 /* The device initialization function. Called only once. */
315 int (*init)(struct net_device *dev);
316
317 /* ------- Fields preinitialized in Space.c finish here ------- */
318
9356b8fc
ED
319 /* Net device features */
320 unsigned long features;
321#define NETIF_F_SG 1 /* Scatter/gather IO. */
d212f87b 322#define NETIF_F_IP_CSUM 2 /* Can checksum TCP/UDP over IPv4. */
9356b8fc
ED
323#define NETIF_F_NO_CSUM 4 /* Does not require checksum. F.e. loopack. */
324#define NETIF_F_HW_CSUM 8 /* Can checksum all the packets. */
d212f87b 325#define NETIF_F_IPV6_CSUM 16 /* Can checksum TCP/UDP over IPV6 */
9356b8fc
ED
326#define NETIF_F_HIGHDMA 32 /* Can DMA to high memory. */
327#define NETIF_F_FRAGLIST 64 /* Scatter/gather IO. */
328#define NETIF_F_HW_VLAN_TX 128 /* Transmit VLAN hw acceleration */
329#define NETIF_F_HW_VLAN_RX 256 /* Receive VLAN hw acceleration */
330#define NETIF_F_HW_VLAN_FILTER 512 /* Receive filtering on VLAN */
331#define NETIF_F_VLAN_CHALLENGED 1024 /* Device cannot handle VLAN packets */
37c3185a 332#define NETIF_F_GSO 2048 /* Enable software GSO. */
9356b8fc 333#define NETIF_F_LLTX 4096 /* LockLess TX */
7967168c
HX
334
335 /* Segmentation offload features */
336#define NETIF_F_GSO_SHIFT 16
bcd76111 337#define NETIF_F_GSO_MASK 0xffff0000
7967168c 338#define NETIF_F_TSO (SKB_GSO_TCPV4 << NETIF_F_GSO_SHIFT)
f83ef8c0 339#define NETIF_F_UFO (SKB_GSO_UDP << NETIF_F_GSO_SHIFT)
576a30eb 340#define NETIF_F_GSO_ROBUST (SKB_GSO_DODGY << NETIF_F_GSO_SHIFT)
f83ef8c0
HX
341#define NETIF_F_TSO_ECN (SKB_GSO_TCP_ECN << NETIF_F_GSO_SHIFT)
342#define NETIF_F_TSO6 (SKB_GSO_TCPV6 << NETIF_F_GSO_SHIFT)
9356b8fc 343
78eb8877
HX
344 /* List of features with software fallbacks. */
345#define NETIF_F_GSO_SOFTWARE (NETIF_F_TSO | NETIF_F_TSO_ECN | NETIF_F_TSO6)
346
d212f87b 347
8648b305 348#define NETIF_F_GEN_CSUM (NETIF_F_NO_CSUM | NETIF_F_HW_CSUM)
d212f87b
SH
349#define NETIF_F_V4_CSUM (NETIF_F_GEN_CSUM | NETIF_F_IP_CSUM)
350#define NETIF_F_V6_CSUM (NETIF_F_GEN_CSUM | NETIF_F_IPV6_CSUM)
351#define NETIF_F_ALL_CSUM (NETIF_F_V4_CSUM | NETIF_F_V6_CSUM)
8648b305 352
1da177e4
LT
353 struct net_device *next_sched;
354
355 /* Interface index. Unique device identifier */
356 int ifindex;
357 int iflink;
358
359
360 struct net_device_stats* (*get_stats)(struct net_device *dev);
c45d286e 361 struct net_device_stats stats;
1da177e4 362
b86e0280 363#ifdef CONFIG_WIRELESS_EXT
1da177e4
LT
364 /* List of functions to handle Wireless Extensions (instead of ioctl).
365 * See <net/iw_handler.h> for details. Jean II */
366 const struct iw_handler_def * wireless_handlers;
367 /* Instance data managed by the core of Wireless Extensions. */
368 struct iw_public_data * wireless_data;
b86e0280 369#endif
76fd8593 370 const struct ethtool_ops *ethtool_ops;
1da177e4
LT
371
372 /*
373 * This marks the end of the "visible" part of the structure. All
374 * fields hereafter are internal to the system, and may change at
375 * will (read: may be cleaned up at will).
376 */
377
1da177e4 378
b00055aa 379 unsigned int flags; /* interface flags (a la BSD) */
1da177e4
LT
380 unsigned short gflags;
381 unsigned short priv_flags; /* Like 'flags' but invisible to userspace. */
382 unsigned short padded; /* How much padding added by alloc_netdev() */
383
b00055aa
SR
384 unsigned char operstate; /* RFC2863 operstate */
385 unsigned char link_mode; /* mapping policy to operstate */
386
1da177e4
LT
387 unsigned mtu; /* interface MTU value */
388 unsigned short type; /* interface hardware type */
389 unsigned short hard_header_len; /* hardware hdr length */
1da177e4
LT
390
391 struct net_device *master; /* Pointer to master device of a group,
392 * which this device is member of.
393 */
394
395 /* Interface address info. */
a6f9a705 396 unsigned char perm_addr[MAX_ADDR_LEN]; /* permanent hw address */
1da177e4
LT
397 unsigned char addr_len; /* hardware address length */
398 unsigned short dev_id; /* for shared network cards */
399
4417da66
PM
400 struct dev_addr_list *uc_list; /* Secondary unicast mac addresses */
401 int uc_count; /* Number of installed ucasts */
402 int uc_promisc;
3fba5a8b 403 struct dev_addr_list *mc_list; /* Multicast mac addresses */
1da177e4
LT
404 int mc_count; /* Number of installed mcasts */
405 int promiscuity;
406 int allmulti;
407
1da177e4
LT
408
409 /* Protocol specific pointers */
410
411 void *atalk_ptr; /* AppleTalk link */
412 void *ip_ptr; /* IPv4 specific data */
413 void *dn_ptr; /* DECnet specific data */
414 void *ip6_ptr; /* IPv6 specific data */
415 void *ec_ptr; /* Econet specific data */
416 void *ax25_ptr; /* AX.25 specific data */
704232c2
JB
417 struct wireless_dev *ieee80211_ptr; /* IEEE 802.11 specific data,
418 assign before registering */
1da177e4 419
9356b8fc
ED
420/*
421 * Cache line mostly used on receive path (including eth_type_trans())
422 */
423 struct list_head poll_list ____cacheline_aligned_in_smp;
424 /* Link to poll list */
425
426 int (*poll) (struct net_device *dev, int *quota);
1da177e4
LT
427 int quota;
428 int weight;
9356b8fc
ED
429 unsigned long last_rx; /* Time of last Rx */
430 /* Interface address info used in eth_type_trans() */
431 unsigned char dev_addr[MAX_ADDR_LEN]; /* hw address, (before bcast
432 because most packets are unicast) */
433
434 unsigned char broadcast[MAX_ADDR_LEN]; /* hw bcast add */
1da177e4 435
9356b8fc
ED
436/*
437 * Cache line mostly used on queue transmit path (qdisc)
438 */
439 /* device queue lock */
440 spinlock_t queue_lock ____cacheline_aligned_in_smp;
1da177e4
LT
441 struct Qdisc *qdisc;
442 struct Qdisc *qdisc_sleeping;
1da177e4
LT
443 struct list_head qdisc_list;
444 unsigned long tx_queue_len; /* Max frames per queue allowed */
445
f6a78bfc
HX
446 /* Partially transmitted GSO packet. */
447 struct sk_buff *gso_skb;
448
1da177e4
LT
449 /* ingress path synchronizer */
450 spinlock_t ingress_lock;
9356b8fc
ED
451 struct Qdisc *qdisc_ingress;
452
453/*
454 * One part is mostly used on xmit path (device)
455 */
1da177e4 456 /* hard_start_xmit synchronizer */
932ff279 457 spinlock_t _xmit_lock ____cacheline_aligned_in_smp;
1da177e4
LT
458 /* cpu id of processor entered to hard_start_xmit or -1,
459 if nobody entered there.
460 */
461 int xmit_lock_owner;
9356b8fc
ED
462 void *priv; /* pointer to private data */
463 int (*hard_start_xmit) (struct sk_buff *skb,
464 struct net_device *dev);
465 /* These may be needed for future network-power-down code. */
466 unsigned long trans_start; /* Time (in jiffies) of last Tx */
467
468 int watchdog_timeo; /* used by dev_watchdog() */
469 struct timer_list watchdog_timer;
470
471/*
472 * refcnt is a very hot point, so align it on SMP
473 */
1da177e4 474 /* Number of references to this device */
9356b8fc
ED
475 atomic_t refcnt ____cacheline_aligned_in_smp;
476
1da177e4
LT
477 /* delayed register/unregister */
478 struct list_head todo_list;
1da177e4
LT
479 /* device index hash chain */
480 struct hlist_node index_hlist;
481
572a103d
HX
482 struct net_device *link_watch_next;
483
1da177e4
LT
484 /* register/unregister state machine */
485 enum { NETREG_UNINITIALIZED=0,
b17a7c17 486 NETREG_REGISTERED, /* completed register_netdevice */
1da177e4
LT
487 NETREG_UNREGISTERING, /* called unregister_netdevice */
488 NETREG_UNREGISTERED, /* completed unregister todo */
489 NETREG_RELEASED, /* called free_netdev */
490 } reg_state;
491
1da177e4
LT
492 /* Called after device is detached from network. */
493 void (*uninit)(struct net_device *dev);
494 /* Called after last user reference disappears. */
495 void (*destructor)(struct net_device *dev);
496
497 /* Pointers to interface service routines. */
498 int (*open)(struct net_device *dev);
499 int (*stop)(struct net_device *dev);
1da177e4 500#define HAVE_NETDEV_POLL
1da177e4
LT
501 int (*hard_header) (struct sk_buff *skb,
502 struct net_device *dev,
503 unsigned short type,
504 void *daddr,
505 void *saddr,
506 unsigned len);
507 int (*rebuild_header)(struct sk_buff *skb);
4417da66
PM
508#define HAVE_SET_RX_MODE
509 void (*set_rx_mode)(struct net_device *dev);
1da177e4
LT
510#define HAVE_MULTICAST
511 void (*set_multicast_list)(struct net_device *dev);
512#define HAVE_SET_MAC_ADDR
513 int (*set_mac_address)(struct net_device *dev,
514 void *addr);
515#define HAVE_PRIVATE_IOCTL
516 int (*do_ioctl)(struct net_device *dev,
517 struct ifreq *ifr, int cmd);
518#define HAVE_SET_CONFIG
519 int (*set_config)(struct net_device *dev,
520 struct ifmap *map);
521#define HAVE_HEADER_CACHE
522 int (*hard_header_cache)(struct neighbour *neigh,
523 struct hh_cache *hh);
524 void (*header_cache_update)(struct hh_cache *hh,
525 struct net_device *dev,
526 unsigned char * haddr);
527#define HAVE_CHANGE_MTU
528 int (*change_mtu)(struct net_device *dev, int new_mtu);
529
530#define HAVE_TX_TIMEOUT
531 void (*tx_timeout) (struct net_device *dev);
532
533 void (*vlan_rx_register)(struct net_device *dev,
534 struct vlan_group *grp);
535 void (*vlan_rx_add_vid)(struct net_device *dev,
536 unsigned short vid);
537 void (*vlan_rx_kill_vid)(struct net_device *dev,
538 unsigned short vid);
539
540 int (*hard_header_parse)(struct sk_buff *skb,
541 unsigned char *haddr);
542 int (*neigh_setup)(struct net_device *dev, struct neigh_parms *);
543#ifdef CONFIG_NETPOLL
115c1d6e 544 struct netpoll_info *npinfo;
1da177e4
LT
545#endif
546#ifdef CONFIG_NET_POLL_CONTROLLER
547 void (*poll_controller)(struct net_device *dev);
548#endif
549
550 /* bridge stuff */
551 struct net_bridge_port *br_port;
552
1da177e4 553 /* class/net/name entry */
43cb76d9 554 struct device dev;
fe9925b5
SH
555 /* space for optional statistics and wireless sysfs groups */
556 struct attribute_group *sysfs_groups[3];
38f7b870
PM
557
558 /* rtnetlink link ops */
559 const struct rtnl_link_ops *rtnl_link_ops;
1da177e4 560};
43cb76d9 561#define to_net_dev(d) container_of(d, struct net_device, dev)
1da177e4
LT
562
563#define NETDEV_ALIGN 32
564#define NETDEV_ALIGN_CONST (NETDEV_ALIGN - 1)
565
6472ce60 566static inline void *netdev_priv(const struct net_device *dev)
1da177e4
LT
567{
568 return (char *)dev + ((sizeof(struct net_device)
569 + NETDEV_ALIGN_CONST)
570 & ~NETDEV_ALIGN_CONST);
571}
572
573#define SET_MODULE_OWNER(dev) do { } while (0)
574/* Set the sysfs physical device reference for the network logical device
575 * if set prior to registration will cause a symlink during initialization.
576 */
43cb76d9 577#define SET_NETDEV_DEV(net, pdev) ((net)->dev.parent = (pdev))
1da177e4
LT
578
579struct packet_type {
f2ccd8fa
DM
580 __be16 type; /* This is really htons(ether_type). */
581 struct net_device *dev; /* NULL is wildcarded here */
582 int (*func) (struct sk_buff *,
583 struct net_device *,
584 struct packet_type *,
585 struct net_device *);
576a30eb
HX
586 struct sk_buff *(*gso_segment)(struct sk_buff *skb,
587 int features);
a430a43d 588 int (*gso_send_check)(struct sk_buff *skb);
1da177e4
LT
589 void *af_packet_priv;
590 struct list_head list;
591};
592
593#include <linux/interrupt.h>
594#include <linux/notifier.h>
595
596extern struct net_device loopback_dev; /* The loopback */
7562f876 597extern struct list_head dev_base_head; /* All devices */
1da177e4
LT
598extern rwlock_t dev_base_lock; /* Device list lock */
599
7562f876
PE
600#define for_each_netdev(d) \
601 list_for_each_entry(d, &dev_base_head, dev_list)
602#define for_each_netdev_safe(d, n) \
603 list_for_each_entry_safe(d, n, &dev_base_head, dev_list)
604#define for_each_netdev_continue(d) \
605 list_for_each_entry_continue(d, &dev_base_head, dev_list)
606#define net_device_entry(lh) list_entry(lh, struct net_device, dev_list)
607
608static inline struct net_device *next_net_device(struct net_device *dev)
609{
610 struct list_head *lh;
611
612 lh = dev->dev_list.next;
613 return lh == &dev_base_head ? NULL : net_device_entry(lh);
614}
615
616static inline struct net_device *first_net_device(void)
617{
618 return list_empty(&dev_base_head) ? NULL :
619 net_device_entry(dev_base_head.next);
620}
621
1da177e4
LT
622extern int netdev_boot_setup_check(struct net_device *dev);
623extern unsigned long netdev_boot_base(const char *prefix, int unit);
624extern struct net_device *dev_getbyhwaddr(unsigned short type, char *hwaddr);
625extern struct net_device *dev_getfirstbyhwtype(unsigned short type);
4e9cac2b 626extern struct net_device *__dev_getfirstbyhwtype(unsigned short type);
1da177e4
LT
627extern void dev_add_pack(struct packet_type *pt);
628extern void dev_remove_pack(struct packet_type *pt);
629extern void __dev_remove_pack(struct packet_type *pt);
630
631extern struct net_device *dev_get_by_flags(unsigned short flags,
632 unsigned short mask);
633extern struct net_device *dev_get_by_name(const char *name);
634extern struct net_device *__dev_get_by_name(const char *name);
635extern int dev_alloc_name(struct net_device *dev, const char *name);
636extern int dev_open(struct net_device *dev);
637extern int dev_close(struct net_device *dev);
638extern int dev_queue_xmit(struct sk_buff *skb);
639extern int register_netdevice(struct net_device *dev);
22f8cde5 640extern void unregister_netdevice(struct net_device *dev);
1da177e4
LT
641extern void free_netdev(struct net_device *dev);
642extern void synchronize_net(void);
643extern int register_netdevice_notifier(struct notifier_block *nb);
644extern int unregister_netdevice_notifier(struct notifier_block *nb);
645extern int call_netdevice_notifiers(unsigned long val, void *v);
646extern struct net_device *dev_get_by_index(int ifindex);
647extern struct net_device *__dev_get_by_index(int ifindex);
648extern int dev_restart(struct net_device *dev);
649#ifdef CONFIG_NETPOLL_TRAP
650extern int netpoll_trap(void);
651#endif
652
653typedef int gifconf_func_t(struct net_device * dev, char __user * bufptr, int len);
654extern int register_gifconf(unsigned int family, gifconf_func_t * gifconf);
655static inline int unregister_gifconf(unsigned int family)
656{
657 return register_gifconf(family, NULL);
658}
659
660/*
661 * Incoming packets are placed on per-cpu queues so that
662 * no locking is needed.
663 */
664
665struct softnet_data
666{
31aa02c5 667 struct net_device *output_queue;
1da177e4
LT
668 struct sk_buff_head input_pkt_queue;
669 struct list_head poll_list;
1da177e4
LT
670 struct sk_buff *completion_queue;
671
672 struct net_device backlog_dev; /* Sorry. 8) */
db217334
CL
673#ifdef CONFIG_NET_DMA
674 struct dma_chan *net_dma;
675#endif
1da177e4
LT
676};
677
678DECLARE_PER_CPU(struct softnet_data,softnet_data);
679
680#define HAVE_NETIF_QUEUE
681
56079431 682extern void __netif_schedule(struct net_device *dev);
1da177e4
LT
683
684static inline void netif_schedule(struct net_device *dev)
685{
686 if (!test_bit(__LINK_STATE_XOFF, &dev->state))
687 __netif_schedule(dev);
688}
689
690static inline void netif_start_queue(struct net_device *dev)
691{
692 clear_bit(__LINK_STATE_XOFF, &dev->state);
693}
694
695static inline void netif_wake_queue(struct net_device *dev)
696{
697#ifdef CONFIG_NETPOLL_TRAP
5f286e11
SS
698 if (netpoll_trap()) {
699 clear_bit(__LINK_STATE_XOFF, &dev->state);
1da177e4 700 return;
5f286e11 701 }
1da177e4
LT
702#endif
703 if (test_and_clear_bit(__LINK_STATE_XOFF, &dev->state))
704 __netif_schedule(dev);
705}
706
707static inline void netif_stop_queue(struct net_device *dev)
708{
1da177e4
LT
709 set_bit(__LINK_STATE_XOFF, &dev->state);
710}
711
712static inline int netif_queue_stopped(const struct net_device *dev)
713{
714 return test_bit(__LINK_STATE_XOFF, &dev->state);
715}
716
717static inline int netif_running(const struct net_device *dev)
718{
719 return test_bit(__LINK_STATE_START, &dev->state);
720}
721
722
723/* Use this variant when it is known for sure that it
724 * is executing from interrupt context.
725 */
726static inline void dev_kfree_skb_irq(struct sk_buff *skb)
727{
728 if (atomic_dec_and_test(&skb->users)) {
729 struct softnet_data *sd;
730 unsigned long flags;
731
732 local_irq_save(flags);
733 sd = &__get_cpu_var(softnet_data);
734 skb->next = sd->completion_queue;
735 sd->completion_queue = skb;
736 raise_softirq_irqoff(NET_TX_SOFTIRQ);
737 local_irq_restore(flags);
738 }
739}
740
741/* Use this variant in places where it could be invoked
742 * either from interrupt or non-interrupt context.
743 */
56079431 744extern void dev_kfree_skb_any(struct sk_buff *skb);
1da177e4
LT
745
746#define HAVE_NETIF_RX 1
747extern int netif_rx(struct sk_buff *skb);
748extern int netif_rx_ni(struct sk_buff *skb);
749#define HAVE_NETIF_RECEIVE_SKB 1
750extern int netif_receive_skb(struct sk_buff *skb);
c2373ee9 751extern int dev_valid_name(const char *name);
1da177e4
LT
752extern int dev_ioctl(unsigned int cmd, void __user *);
753extern int dev_ethtool(struct ifreq *);
754extern unsigned dev_get_flags(const struct net_device *);
755extern int dev_change_flags(struct net_device *, unsigned);
756extern int dev_change_name(struct net_device *, char *);
757extern int dev_set_mtu(struct net_device *, int);
758extern int dev_set_mac_address(struct net_device *,
759 struct sockaddr *);
f6a78bfc
HX
760extern int dev_hard_start_xmit(struct sk_buff *skb,
761 struct net_device *dev);
1da177e4
LT
762
763extern void dev_init(void);
764
20380731 765extern int netdev_budget;
1da177e4
LT
766
767/* Called by rtnetlink.c:rtnl_unlock() */
768extern void netdev_run_todo(void);
769
770static inline void dev_put(struct net_device *dev)
771{
772 atomic_dec(&dev->refcnt);
773}
774
15333061
SH
775static inline void dev_hold(struct net_device *dev)
776{
777 atomic_inc(&dev->refcnt);
778}
1da177e4
LT
779
780/* Carrier loss detection, dial on demand. The functions netif_carrier_on
781 * and _off may be called from IRQ context, but it is caller
782 * who is responsible for serialization of these calls.
b00055aa
SR
783 *
784 * The name carrier is inappropriate, these functions should really be
785 * called netif_lowerlayer_*() because they represent the state of any
786 * kind of lower layer not just hardware media.
1da177e4
LT
787 */
788
789extern void linkwatch_fire_event(struct net_device *dev);
790
791static inline int netif_carrier_ok(const struct net_device *dev)
792{
793 return !test_bit(__LINK_STATE_NOCARRIER, &dev->state);
794}
795
796extern void __netdev_watchdog_up(struct net_device *dev);
797
0a242efc 798extern void netif_carrier_on(struct net_device *dev);
1da177e4 799
0a242efc 800extern void netif_carrier_off(struct net_device *dev);
1da177e4 801
b00055aa
SR
802static inline void netif_dormant_on(struct net_device *dev)
803{
804 if (!test_and_set_bit(__LINK_STATE_DORMANT, &dev->state))
805 linkwatch_fire_event(dev);
806}
807
808static inline void netif_dormant_off(struct net_device *dev)
809{
810 if (test_and_clear_bit(__LINK_STATE_DORMANT, &dev->state))
811 linkwatch_fire_event(dev);
812}
813
814static inline int netif_dormant(const struct net_device *dev)
815{
816 return test_bit(__LINK_STATE_DORMANT, &dev->state);
817}
818
819
820static inline int netif_oper_up(const struct net_device *dev) {
821 return (dev->operstate == IF_OPER_UP ||
822 dev->operstate == IF_OPER_UNKNOWN /* backward compat */);
823}
824
1da177e4
LT
825/* Hot-plugging. */
826static inline int netif_device_present(struct net_device *dev)
827{
828 return test_bit(__LINK_STATE_PRESENT, &dev->state);
829}
830
56079431 831extern void netif_device_detach(struct net_device *dev);
1da177e4 832
56079431 833extern void netif_device_attach(struct net_device *dev);
1da177e4
LT
834
835/*
836 * Network interface message level settings
837 */
838#define HAVE_NETIF_MSG 1
839
840enum {
841 NETIF_MSG_DRV = 0x0001,
842 NETIF_MSG_PROBE = 0x0002,
843 NETIF_MSG_LINK = 0x0004,
844 NETIF_MSG_TIMER = 0x0008,
845 NETIF_MSG_IFDOWN = 0x0010,
846 NETIF_MSG_IFUP = 0x0020,
847 NETIF_MSG_RX_ERR = 0x0040,
848 NETIF_MSG_TX_ERR = 0x0080,
849 NETIF_MSG_TX_QUEUED = 0x0100,
850 NETIF_MSG_INTR = 0x0200,
851 NETIF_MSG_TX_DONE = 0x0400,
852 NETIF_MSG_RX_STATUS = 0x0800,
853 NETIF_MSG_PKTDATA = 0x1000,
854 NETIF_MSG_HW = 0x2000,
855 NETIF_MSG_WOL = 0x4000,
856};
857
858#define netif_msg_drv(p) ((p)->msg_enable & NETIF_MSG_DRV)
859#define netif_msg_probe(p) ((p)->msg_enable & NETIF_MSG_PROBE)
860#define netif_msg_link(p) ((p)->msg_enable & NETIF_MSG_LINK)
861#define netif_msg_timer(p) ((p)->msg_enable & NETIF_MSG_TIMER)
862#define netif_msg_ifdown(p) ((p)->msg_enable & NETIF_MSG_IFDOWN)
863#define netif_msg_ifup(p) ((p)->msg_enable & NETIF_MSG_IFUP)
864#define netif_msg_rx_err(p) ((p)->msg_enable & NETIF_MSG_RX_ERR)
865#define netif_msg_tx_err(p) ((p)->msg_enable & NETIF_MSG_TX_ERR)
866#define netif_msg_tx_queued(p) ((p)->msg_enable & NETIF_MSG_TX_QUEUED)
867#define netif_msg_intr(p) ((p)->msg_enable & NETIF_MSG_INTR)
868#define netif_msg_tx_done(p) ((p)->msg_enable & NETIF_MSG_TX_DONE)
869#define netif_msg_rx_status(p) ((p)->msg_enable & NETIF_MSG_RX_STATUS)
870#define netif_msg_pktdata(p) ((p)->msg_enable & NETIF_MSG_PKTDATA)
871#define netif_msg_hw(p) ((p)->msg_enable & NETIF_MSG_HW)
872#define netif_msg_wol(p) ((p)->msg_enable & NETIF_MSG_WOL)
873
874static inline u32 netif_msg_init(int debug_value, int default_msg_enable_bits)
875{
876 /* use default */
877 if (debug_value < 0 || debug_value >= (sizeof(u32) * 8))
878 return default_msg_enable_bits;
879 if (debug_value == 0) /* no output */
880 return 0;
881 /* set low N bits */
882 return (1 << debug_value) - 1;
883}
884
0a122576
SH
885/* Test if receive needs to be scheduled */
886static inline int __netif_rx_schedule_prep(struct net_device *dev)
793b883e
SH
887{
888 return !test_and_set_bit(__LINK_STATE_RX_SCHED, &dev->state);
889}
1da177e4 890
0a122576 891/* Test if receive needs to be scheduled but only if up */
1da177e4
LT
892static inline int netif_rx_schedule_prep(struct net_device *dev)
893{
0a122576 894 return netif_running(dev) && __netif_rx_schedule_prep(dev);
1da177e4
LT
895}
896
897/* Add interface to tail of rx poll list. This assumes that _prep has
898 * already been called and returned 1.
899 */
900
56079431 901extern void __netif_rx_schedule(struct net_device *dev);
1da177e4
LT
902
903/* Try to reschedule poll. Called by irq handler. */
904
905static inline void netif_rx_schedule(struct net_device *dev)
906{
907 if (netif_rx_schedule_prep(dev))
908 __netif_rx_schedule(dev);
909}
910
d3240312
SH
911/* Try to reschedule poll. Called by dev->poll() after netif_rx_complete().
912 * Do not inline this?
913 */
1da177e4
LT
914static inline int netif_rx_reschedule(struct net_device *dev, int undo)
915{
916 if (netif_rx_schedule_prep(dev)) {
917 unsigned long flags;
d3240312
SH
918
919 dev->quota += undo;
920
1da177e4 921 local_irq_save(flags);
d3240312
SH
922 list_add_tail(&dev->poll_list, &__get_cpu_var(softnet_data).poll_list);
923 __raise_softirq_irqoff(NET_RX_SOFTIRQ);
1da177e4
LT
924 local_irq_restore(flags);
925 return 1;
926 }
927 return 0;
928}
929
b0ba6667
HX
930/* same as netif_rx_complete, except that local_irq_save(flags)
931 * has already been issued
932 */
933static inline void __netif_rx_complete(struct net_device *dev)
934{
935 BUG_ON(!test_bit(__LINK_STATE_RX_SCHED, &dev->state));
936 list_del(&dev->poll_list);
937 smp_mb__before_clear_bit();
938 clear_bit(__LINK_STATE_RX_SCHED, &dev->state);
939}
940
1da177e4
LT
941/* Remove interface from poll list: it must be in the poll list
942 * on current cpu. This primitive is called by dev->poll(), when
943 * it completes the work. The device cannot be out of poll list at this
944 * moment, it is BUG().
945 */
946static inline void netif_rx_complete(struct net_device *dev)
947{
948 unsigned long flags;
949
950 local_irq_save(flags);
b0ba6667 951 __netif_rx_complete(dev);
1da177e4
LT
952 local_irq_restore(flags);
953}
954
955static inline void netif_poll_disable(struct net_device *dev)
956{
3173c890 957 while (test_and_set_bit(__LINK_STATE_RX_SCHED, &dev->state))
1da177e4 958 /* No hurry. */
3173c890 959 schedule_timeout_interruptible(1);
1da177e4
LT
960}
961
962static inline void netif_poll_enable(struct net_device *dev)
963{
e44c39bd 964 smp_mb__before_clear_bit();
1da177e4 965 clear_bit(__LINK_STATE_RX_SCHED, &dev->state);
1da177e4
LT
966}
967
932ff279
HX
968static inline void netif_tx_lock(struct net_device *dev)
969{
970 spin_lock(&dev->_xmit_lock);
971 dev->xmit_lock_owner = smp_processor_id();
972}
973
974static inline void netif_tx_lock_bh(struct net_device *dev)
975{
976 spin_lock_bh(&dev->_xmit_lock);
977 dev->xmit_lock_owner = smp_processor_id();
978}
979
980static inline int netif_tx_trylock(struct net_device *dev)
981{
53c4b2cc
HX
982 int ok = spin_trylock(&dev->_xmit_lock);
983 if (likely(ok))
932ff279 984 dev->xmit_lock_owner = smp_processor_id();
53c4b2cc 985 return ok;
932ff279
HX
986}
987
988static inline void netif_tx_unlock(struct net_device *dev)
989{
990 dev->xmit_lock_owner = -1;
991 spin_unlock(&dev->_xmit_lock);
992}
993
994static inline void netif_tx_unlock_bh(struct net_device *dev)
995{
996 dev->xmit_lock_owner = -1;
997 spin_unlock_bh(&dev->_xmit_lock);
998}
999
1da177e4
LT
1000static inline void netif_tx_disable(struct net_device *dev)
1001{
932ff279 1002 netif_tx_lock_bh(dev);
1da177e4 1003 netif_stop_queue(dev);
932ff279 1004 netif_tx_unlock_bh(dev);
1da177e4
LT
1005}
1006
1007/* These functions live elsewhere (drivers/net/net_init.c, but related) */
1008
1009extern void ether_setup(struct net_device *dev);
1010
1011/* Support for loadable net-drivers */
1012extern struct net_device *alloc_netdev(int sizeof_priv, const char *name,
1013 void (*setup)(struct net_device *));
1014extern int register_netdev(struct net_device *dev);
1015extern void unregister_netdev(struct net_device *dev);
4417da66
PM
1016/* Functions used for secondary unicast and multicast support */
1017extern void dev_set_rx_mode(struct net_device *dev);
1018extern void __dev_set_rx_mode(struct net_device *dev);
1019extern int dev_unicast_delete(struct net_device *dev, void *addr, int alen);
1020extern int dev_unicast_add(struct net_device *dev, void *addr, int alen);
1da177e4
LT
1021extern int dev_mc_delete(struct net_device *dev, void *addr, int alen, int all);
1022extern int dev_mc_add(struct net_device *dev, void *addr, int alen, int newonly);
1023extern void dev_mc_discard(struct net_device *dev);
bf742482
PM
1024extern int __dev_addr_delete(struct dev_addr_list **list, void *addr, int alen, int all);
1025extern int __dev_addr_add(struct dev_addr_list **list, void *addr, int alen, int newonly);
1026extern void __dev_addr_discard(struct dev_addr_list **list);
1da177e4
LT
1027extern void dev_set_promiscuity(struct net_device *dev, int inc);
1028extern void dev_set_allmulti(struct net_device *dev, int inc);
1029extern void netdev_state_change(struct net_device *dev);
d8a33ac4 1030extern void netdev_features_change(struct net_device *dev);
1da177e4
LT
1031/* Load a device via the kmod */
1032extern void dev_load(const char *name);
1033extern void dev_mcast_init(void);
1034extern int netdev_max_backlog;
1035extern int weight_p;
1036extern int netdev_set_master(struct net_device *dev, struct net_device *master);
84fa7933 1037extern int skb_checksum_help(struct sk_buff *skb);
576a30eb 1038extern struct sk_buff *skb_gso_segment(struct sk_buff *skb, int features);
fb286bb2
HX
1039#ifdef CONFIG_BUG
1040extern void netdev_rx_csum_fault(struct net_device *dev);
1041#else
1042static inline void netdev_rx_csum_fault(struct net_device *dev)
1043{
1044}
1045#endif
1da177e4
LT
1046/* rx skb timestamps */
1047extern void net_enable_timestamp(void);
1048extern void net_disable_timestamp(void);
1049
20380731
ACM
1050#ifdef CONFIG_PROC_FS
1051extern void *dev_seq_start(struct seq_file *seq, loff_t *pos);
1052extern void *dev_seq_next(struct seq_file *seq, void *v, loff_t *pos);
1053extern void dev_seq_stop(struct seq_file *seq, void *v);
1054#endif
1055
1056extern void linkwatch_run_queue(void);
1057
bcd76111 1058static inline int net_gso_ok(int features, int gso_type)
576a30eb 1059{
bcd76111 1060 int feature = gso_type << NETIF_F_GSO_SHIFT;
d6b4991a 1061 return (features & feature) == feature;
576a30eb
HX
1062}
1063
bcd76111
HX
1064static inline int skb_gso_ok(struct sk_buff *skb, int features)
1065{
a430a43d 1066 return net_gso_ok(features, skb_shinfo(skb)->gso_type);
bcd76111
HX
1067}
1068
7967168c
HX
1069static inline int netif_needs_gso(struct net_device *dev, struct sk_buff *skb)
1070{
a430a43d
HX
1071 return skb_is_gso(skb) &&
1072 (!skb_gso_ok(skb, dev->features) ||
84fa7933 1073 unlikely(skb->ip_summed != CHECKSUM_PARTIAL));
7967168c
HX
1074}
1075
7ea49ed7 1076/* On bonding slaves other than the currently active slave, suppress
f5b2b966
JV
1077 * duplicates except for 802.3ad ETH_P_SLOW, alb non-mcast/bcast, and
1078 * ARP on active-backup slaves with arp_validate enabled.
7ea49ed7
DM
1079 */
1080static inline int skb_bond_should_drop(struct sk_buff *skb)
1081{
1082 struct net_device *dev = skb->dev;
1083 struct net_device *master = dev->master;
1084
1085 if (master &&
1086 (dev->priv_flags & IFF_SLAVE_INACTIVE)) {
f5b2b966
JV
1087 if ((dev->priv_flags & IFF_SLAVE_NEEDARP) &&
1088 skb->protocol == __constant_htons(ETH_P_ARP))
1089 return 0;
1090
7ea49ed7
DM
1091 if (master->priv_flags & IFF_MASTER_ALB) {
1092 if (skb->pkt_type != PACKET_BROADCAST &&
1093 skb->pkt_type != PACKET_MULTICAST)
1094 return 0;
1095 }
1096 if (master->priv_flags & IFF_MASTER_8023AD &&
1097 skb->protocol == __constant_htons(ETH_P_SLOW))
1098 return 0;
1099
1100 return 1;
1101 }
1102 return 0;
1103}
1104
1da177e4
LT
1105#endif /* __KERNEL__ */
1106
1107#endif /* _LINUX_DEV_H */