blob: 8f00bdf95ef4360807eed2c30ecd580c499e69d1 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
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 *
Jesper Juhl02c30a82005-05-05 16:16:16 -070010 * Authors: Ross Biro
Linus Torvalds1da177e2005-04-16 15:20:36 -070011 * 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__
Al Virod7fe0f22006-12-03 23:15:30 -050033#include <linux/timer.h>
Stephen Hemmingerbea33482007-10-03 16:41:36 -070034#include <linux/delay.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070035#include <asm/atomic.h>
36#include <asm/cache.h>
37#include <asm/byteorder.h>
38
Linus Torvalds1da177e2005-04-16 15:20:36 -070039#include <linux/device.h>
40#include <linux/percpu.h>
Chris Leechdb217332006-06-17 21:24:58 -070041#include <linux/dmaengine.h>
Stephen Hemmingerbea33482007-10-03 16:41:36 -070042#include <linux/workqueue.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070043
Linus Torvalds1da177e2005-04-16 15:20:36 -070044struct vlan_group;
45struct ethtool_ops;
Jeff Moyer115c1d62005-06-22 22:05:31 -070046struct netpoll_info;
Johannes Berg704232c2007-04-23 12:20:05 -070047/* 802.11 specific */
48struct wireless_dev;
Linus Torvalds1da177e2005-04-16 15:20:36 -070049 /* source back-compat hooks */
50#define SET_ETHTOOL_OPS(netdev,ops) \
51 ( (netdev)->ethtool_ops = (ops) )
52
53#define HAVE_ALLOC_NETDEV /* feature macro: alloc_xxxdev
54 functions are available. */
55#define HAVE_FREE_NETDEV /* free_netdev() */
56#define HAVE_NETDEV_PRIV /* netdev_priv() */
57
58#define NET_XMIT_SUCCESS 0
59#define NET_XMIT_DROP 1 /* skb dropped */
60#define NET_XMIT_CN 2 /* congestion notification */
61#define NET_XMIT_POLICED 3 /* skb is shot by police */
62#define NET_XMIT_BYPASS 4 /* packet does not leave via dequeue;
63 (TC use only - dev_queue_xmit
64 returns this as NET_XMIT_SUCCESS) */
65
66/* Backlog congestion levels */
67#define NET_RX_SUCCESS 0 /* keep 'em coming, baby */
68#define NET_RX_DROP 1 /* packet dropped */
69#define NET_RX_CN_LOW 2 /* storm alert, just in case */
70#define NET_RX_CN_MOD 3 /* Storm on its way! */
71#define NET_RX_CN_HIGH 4 /* The storm is here */
72#define NET_RX_BAD 5 /* packet dropped due to kernel error */
73
Gerrit Renkerb9df3cb2006-11-14 11:21:36 -020074/* NET_XMIT_CN is special. It does not guarantee that this packet is lost. It
75 * indicates that the device will soon be dropping packets, or already drops
76 * some packets of the same priority; prompting us to send less aggressively. */
77#define net_xmit_eval(e) ((e) == NET_XMIT_CN? 0 : (e))
Linus Torvalds1da177e2005-04-16 15:20:36 -070078#define net_xmit_errno(e) ((e) != NET_XMIT_CN ? -ENOBUFS : 0)
79
80#endif
81
82#define MAX_ADDR_LEN 32 /* Largest hardware address length */
83
84/* Driver transmit return codes */
85#define NETDEV_TX_OK 0 /* driver took care of packet */
86#define NETDEV_TX_BUSY 1 /* driver tx path was busy*/
87#define NETDEV_TX_LOCKED -1 /* driver tx lock was already taken */
88
89/*
90 * Compute the worst case header length according to the protocols
91 * used.
92 */
93
94#if !defined(CONFIG_AX25) && !defined(CONFIG_AX25_MODULE) && !defined(CONFIG_TR)
95#define LL_MAX_HEADER 32
96#else
97#if defined(CONFIG_AX25) || defined(CONFIG_AX25_MODULE)
98#define LL_MAX_HEADER 96
99#else
100#define LL_MAX_HEADER 48
101#endif
102#endif
103
David S. Millere81c7352006-11-28 20:53:39 -0800104#if !defined(CONFIG_NET_IPIP) && !defined(CONFIG_NET_IPIP_MODULE) && \
105 !defined(CONFIG_NET_IPGRE) && !defined(CONFIG_NET_IPGRE_MODULE) && \
106 !defined(CONFIG_IPV6_SIT) && !defined(CONFIG_IPV6_SIT_MODULE) && \
107 !defined(CONFIG_IPV6_TUNNEL) && !defined(CONFIG_IPV6_TUNNEL_MODULE)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700108#define MAX_HEADER LL_MAX_HEADER
109#else
110#define MAX_HEADER (LL_MAX_HEADER + 48)
111#endif
112
Peter P Waskiewicz Jrf25f4e42007-07-06 13:36:20 -0700113struct net_device_subqueue
114{
115 /* Give a control state for each queue. This struct may contain
116 * per-queue locks in the future.
117 */
118 unsigned long state;
119};
120
Linus Torvalds1da177e2005-04-16 15:20:36 -0700121/*
122 * Network device statistics. Akin to the 2.0 ether stats but
123 * with byte counters.
124 */
125
126struct net_device_stats
127{
128 unsigned long rx_packets; /* total packets received */
129 unsigned long tx_packets; /* total packets transmitted */
130 unsigned long rx_bytes; /* total bytes received */
131 unsigned long tx_bytes; /* total bytes transmitted */
132 unsigned long rx_errors; /* bad packets received */
133 unsigned long tx_errors; /* packet transmit problems */
134 unsigned long rx_dropped; /* no space in linux buffers */
135 unsigned long tx_dropped; /* no space available in linux */
136 unsigned long multicast; /* multicast packets received */
137 unsigned long collisions;
138
139 /* detailed rx_errors: */
140 unsigned long rx_length_errors;
141 unsigned long rx_over_errors; /* receiver ring buff overflow */
142 unsigned long rx_crc_errors; /* recved pkt with crc error */
143 unsigned long rx_frame_errors; /* recv'd frame alignment error */
144 unsigned long rx_fifo_errors; /* recv'r fifo overrun */
145 unsigned long rx_missed_errors; /* receiver missed packet */
146
147 /* detailed tx_errors */
148 unsigned long tx_aborted_errors;
149 unsigned long tx_carrier_errors;
150 unsigned long tx_fifo_errors;
151 unsigned long tx_heartbeat_errors;
152 unsigned long tx_window_errors;
153
154 /* for cslip etc */
155 unsigned long rx_compressed;
156 unsigned long tx_compressed;
157};
158
159
160/* Media selection options. */
161enum {
162 IF_PORT_UNKNOWN = 0,
163 IF_PORT_10BASE2,
164 IF_PORT_10BASET,
165 IF_PORT_AUI,
166 IF_PORT_100BASET,
167 IF_PORT_100BASETX,
168 IF_PORT_100BASEFX
169};
170
171#ifdef __KERNEL__
172
173#include <linux/cache.h>
174#include <linux/skbuff.h>
175
176struct neighbour;
177struct neigh_parms;
178struct sk_buff;
179
180struct netif_rx_stats
181{
182 unsigned total;
183 unsigned dropped;
184 unsigned time_squeeze;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700185 unsigned cpu_collision;
186};
187
188DECLARE_PER_CPU(struct netif_rx_stats, netdev_rx_stat);
189
Patrick McHardybf742482007-06-27 01:26:19 -0700190struct dev_addr_list
191{
192 struct dev_addr_list *next;
193 u8 da_addr[MAX_ADDR_LEN];
194 u8 da_addrlen;
Patrick McHardya0a400d2007-07-14 18:52:02 -0700195 u8 da_synced;
Patrick McHardybf742482007-06-27 01:26:19 -0700196 int da_users;
197 int da_gusers;
198};
Linus Torvalds1da177e2005-04-16 15:20:36 -0700199
200/*
201 * We tag multicasts with these structures.
202 */
Patrick McHardy3fba5a82007-06-27 01:26:58 -0700203
204#define dev_mc_list dev_addr_list
205#define dmi_addr da_addr
206#define dmi_addrlen da_addrlen
207#define dmi_users da_users
208#define dmi_gusers da_gusers
Linus Torvalds1da177e2005-04-16 15:20:36 -0700209
210struct hh_cache
211{
212 struct hh_cache *hh_next; /* Next entry */
213 atomic_t hh_refcnt; /* number of users */
Eric Dumazetf0490982006-12-08 00:08:43 -0800214/*
215 * We want hh_output, hh_len, hh_lock and hh_data be a in a separate
216 * cache line on SMP.
217 * They are mostly read, but hh_refcnt may be changed quite frequently,
218 * incurring cache line ping pongs.
219 */
220 __be16 hh_type ____cacheline_aligned_in_smp;
221 /* protocol identifier, f.e ETH_P_IP
Linus Torvalds1da177e2005-04-16 15:20:36 -0700222 * NOTE: For VLANs, this will be the
223 * encapuslated type. --BLG
224 */
Arnaldo Carvalho de Melod5c42c02006-11-27 17:58:02 -0200225 u16 hh_len; /* length of header */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700226 int (*hh_output)(struct sk_buff *skb);
Stephen Hemminger3644f0c2006-12-07 15:08:17 -0800227 seqlock_t hh_lock;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700228
229 /* cached hardware header; allow for machine alignment needs. */
230#define HH_DATA_MOD 16
231#define HH_DATA_OFF(__len) \
Jiri Benc5ba0eac2005-06-02 16:48:05 -0700232 (HH_DATA_MOD - (((__len - 1) & (HH_DATA_MOD - 1)) + 1))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700233#define HH_DATA_ALIGN(__len) \
234 (((__len)+(HH_DATA_MOD-1))&~(HH_DATA_MOD - 1))
235 unsigned long hh_data[HH_DATA_ALIGN(LL_MAX_HEADER) / sizeof(long)];
236};
237
238/* Reserve HH_DATA_MOD byte aligned hard_header_len, but at least that much.
239 * Alternative is:
240 * dev->hard_header_len ? (dev->hard_header_len +
241 * (HH_DATA_MOD - 1)) & ~(HH_DATA_MOD - 1) : 0
242 *
243 * We could use other alignment values, but we must maintain the
244 * relationship HH alignment <= LL alignment.
245 */
246#define LL_RESERVED_SPACE(dev) \
247 (((dev)->hard_header_len&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
248#define LL_RESERVED_SPACE_EXTRA(dev,extra) \
249 ((((dev)->hard_header_len+extra)&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
250
251/* These flag bits are private to the generic network queueing
252 * layer, they may not be explicitly referenced by any other
253 * code.
254 */
255
256enum netdev_state_t
257{
258 __LINK_STATE_XOFF=0,
259 __LINK_STATE_START,
260 __LINK_STATE_PRESENT,
261 __LINK_STATE_SCHED,
262 __LINK_STATE_NOCARRIER,
Stefan Rompfb00055a2006-03-20 17:09:11 -0800263 __LINK_STATE_LINKWATCH_PENDING,
264 __LINK_STATE_DORMANT,
Herbert Xu48d83322006-06-19 23:57:59 -0700265 __LINK_STATE_QDISC_RUNNING,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700266};
267
268
269/*
270 * This structure holds at boot time configured netdevice settings. They
271 * are then used in the device probing.
272 */
273struct netdev_boot_setup {
274 char name[IFNAMSIZ];
275 struct ifmap map;
276};
277#define NETDEV_BOOT_SETUP_MAX 8
278
Arnaldo Carvalho de Melo20380732005-08-16 02:18:02 -0300279extern int __init netdev_boot_setup(char *str);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700280
281/*
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700282 * Structure for NAPI scheduling similar to tasklet but with weighting
283 */
284struct napi_struct {
285 /* The poll_list must only be managed by the entity which
286 * changes the state of the NAPI_STATE_SCHED bit. This means
287 * whoever atomically sets that bit can add this napi_struct
288 * to the per-cpu poll_list, and whoever clears that bit
289 * can remove from the list right before clearing the bit.
290 */
291 struct list_head poll_list;
292
293 unsigned long state;
294 int weight;
295 int (*poll)(struct napi_struct *, int);
296#ifdef CONFIG_NETPOLL
297 spinlock_t poll_lock;
298 int poll_owner;
299 struct net_device *dev;
300 struct list_head dev_list;
301#endif
302};
303
304enum
305{
306 NAPI_STATE_SCHED, /* Poll is scheduled */
307};
308
309extern void FASTCALL(__napi_schedule(struct napi_struct *n));
310
311/**
312 * napi_schedule_prep - check if napi can be scheduled
313 * @n: napi context
314 *
315 * Test if NAPI routine is already running, and if not mark
316 * it as running. This is used as a condition variable
317 * insure only one NAPI poll instance runs
318 */
319static inline int napi_schedule_prep(struct napi_struct *n)
320{
321 return !test_and_set_bit(NAPI_STATE_SCHED, &n->state);
322}
323
324/**
325 * napi_schedule - schedule NAPI poll
326 * @n: napi context
327 *
328 * Schedule NAPI poll routine to be called if it is not already
329 * running.
330 */
331static inline void napi_schedule(struct napi_struct *n)
332{
333 if (napi_schedule_prep(n))
334 __napi_schedule(n);
335}
336
337/**
338 * napi_complete - NAPI processing complete
339 * @n: napi context
340 *
341 * Mark NAPI processing as complete.
342 */
343static inline void __napi_complete(struct napi_struct *n)
344{
345 BUG_ON(!test_bit(NAPI_STATE_SCHED, &n->state));
346 list_del(&n->poll_list);
347 smp_mb__before_clear_bit();
348 clear_bit(NAPI_STATE_SCHED, &n->state);
349}
350
351static inline void napi_complete(struct napi_struct *n)
352{
353 local_irq_disable();
354 __napi_complete(n);
355 local_irq_enable();
356}
357
358/**
359 * napi_disable - prevent NAPI from scheduling
360 * @n: napi context
361 *
362 * Stop NAPI from being scheduled on this context.
363 * Waits till any outstanding processing completes.
364 */
365static inline void napi_disable(struct napi_struct *n)
366{
367 while (test_and_set_bit(NAPI_STATE_SCHED, &n->state))
368 msleep_interruptible(1);
369}
370
371/**
372 * napi_enable - enable NAPI scheduling
373 * @n: napi context
374 *
375 * Resume NAPI from being scheduled on this context.
376 * Must be paired with napi_disable.
377 */
378static inline void napi_enable(struct napi_struct *n)
379{
380 BUG_ON(!test_bit(NAPI_STATE_SCHED, &n->state));
381 smp_mb__before_clear_bit();
382 clear_bit(NAPI_STATE_SCHED, &n->state);
383}
384
385/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700386 * The DEVICE structure.
387 * Actually, this whole structure is a big mistake. It mixes I/O
388 * data with strictly "high-level" data, and it has to know about
389 * almost every data structure used in the INET module.
390 *
391 * FIXME: cleanup struct net_device such that network protocol info
392 * moves out.
393 */
394
395struct net_device
396{
397
398 /*
399 * This is the first field of the "visible" part of this structure
400 * (i.e. as seen by users in the "Space.c" file). It is the name
401 * the interface.
402 */
403 char name[IFNAMSIZ];
Eric Dumazet9356b8f2005-09-27 15:23:16 -0700404 /* device name hash chain */
405 struct hlist_node name_hlist;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700406
407 /*
408 * I/O specific fields
409 * FIXME: Merge these and struct ifmap into one
410 */
411 unsigned long mem_end; /* shared mem end */
412 unsigned long mem_start; /* shared mem start */
413 unsigned long base_addr; /* device I/O address */
414 unsigned int irq; /* device IRQ number */
415
416 /*
417 * Some hardware also needs these fields, but they are not
418 * part of the usual set specified in Space.c.
419 */
420
421 unsigned char if_port; /* Selectable AUI, TP,..*/
422 unsigned char dma; /* DMA channel */
423
424 unsigned long state;
425
Pavel Emelianov7562f872007-05-03 15:13:45 -0700426 struct list_head dev_list;
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700427#ifdef CONFIG_NETPOLL
428 struct list_head napi_list;
429#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700430
431 /* The device initialization function. Called only once. */
432 int (*init)(struct net_device *dev);
433
434 /* ------- Fields preinitialized in Space.c finish here ------- */
435
Eric Dumazet9356b8f2005-09-27 15:23:16 -0700436 /* Net device features */
437 unsigned long features;
438#define NETIF_F_SG 1 /* Scatter/gather IO. */
Stephen Hemmingerd212f872007-06-27 00:47:37 -0700439#define NETIF_F_IP_CSUM 2 /* Can checksum TCP/UDP over IPv4. */
Eric Dumazet9356b8f2005-09-27 15:23:16 -0700440#define NETIF_F_NO_CSUM 4 /* Does not require checksum. F.e. loopack. */
441#define NETIF_F_HW_CSUM 8 /* Can checksum all the packets. */
Stephen Hemmingerd212f872007-06-27 00:47:37 -0700442#define NETIF_F_IPV6_CSUM 16 /* Can checksum TCP/UDP over IPV6 */
Eric Dumazet9356b8f2005-09-27 15:23:16 -0700443#define NETIF_F_HIGHDMA 32 /* Can DMA to high memory. */
444#define NETIF_F_FRAGLIST 64 /* Scatter/gather IO. */
445#define NETIF_F_HW_VLAN_TX 128 /* Transmit VLAN hw acceleration */
446#define NETIF_F_HW_VLAN_RX 256 /* Receive VLAN hw acceleration */
447#define NETIF_F_HW_VLAN_FILTER 512 /* Receive filtering on VLAN */
448#define NETIF_F_VLAN_CHALLENGED 1024 /* Device cannot handle VLAN packets */
Herbert Xu37c31852006-06-22 03:07:29 -0700449#define NETIF_F_GSO 2048 /* Enable software GSO. */
Eric Dumazet9356b8f2005-09-27 15:23:16 -0700450#define NETIF_F_LLTX 4096 /* LockLess TX */
Peter P Waskiewicz Jrf25f4e42007-07-06 13:36:20 -0700451#define NETIF_F_MULTI_QUEUE 16384 /* Has multiple TX/RX queues */
Jeff Garzik3ae7c0b2007-08-15 16:00:51 -0700452#define NETIF_F_LRO 32768 /* large receive offload */
Herbert Xu79671682006-06-22 02:40:14 -0700453
454 /* Segmentation offload features */
455#define NETIF_F_GSO_SHIFT 16
Herbert Xubcd76112006-06-30 13:36:35 -0700456#define NETIF_F_GSO_MASK 0xffff0000
Herbert Xu79671682006-06-22 02:40:14 -0700457#define NETIF_F_TSO (SKB_GSO_TCPV4 << NETIF_F_GSO_SHIFT)
Herbert Xuf83ef8c2006-06-30 13:37:03 -0700458#define NETIF_F_UFO (SKB_GSO_UDP << NETIF_F_GSO_SHIFT)
Herbert Xu576a30e2006-06-27 13:22:38 -0700459#define NETIF_F_GSO_ROBUST (SKB_GSO_DODGY << NETIF_F_GSO_SHIFT)
Herbert Xuf83ef8c2006-06-30 13:37:03 -0700460#define NETIF_F_TSO_ECN (SKB_GSO_TCP_ECN << NETIF_F_GSO_SHIFT)
461#define NETIF_F_TSO6 (SKB_GSO_TCPV6 << NETIF_F_GSO_SHIFT)
Eric Dumazet9356b8f2005-09-27 15:23:16 -0700462
Herbert Xu78eb8872006-08-17 18:22:32 -0700463 /* List of features with software fallbacks. */
464#define NETIF_F_GSO_SOFTWARE (NETIF_F_TSO | NETIF_F_TSO_ECN | NETIF_F_TSO6)
465
Stephen Hemmingerd212f872007-06-27 00:47:37 -0700466
Herbert Xu8648b302006-06-17 22:06:05 -0700467#define NETIF_F_GEN_CSUM (NETIF_F_NO_CSUM | NETIF_F_HW_CSUM)
Stephen Hemmingerd212f872007-06-27 00:47:37 -0700468#define NETIF_F_V4_CSUM (NETIF_F_GEN_CSUM | NETIF_F_IP_CSUM)
469#define NETIF_F_V6_CSUM (NETIF_F_GEN_CSUM | NETIF_F_IPV6_CSUM)
470#define NETIF_F_ALL_CSUM (NETIF_F_V4_CSUM | NETIF_F_V6_CSUM)
Herbert Xu8648b302006-06-17 22:06:05 -0700471
Linus Torvalds1da177e2005-04-16 15:20:36 -0700472 struct net_device *next_sched;
473
474 /* Interface index. Unique device identifier */
475 int ifindex;
476 int iflink;
477
478
479 struct net_device_stats* (*get_stats)(struct net_device *dev);
Rusty Russellc45d2862007-03-28 14:29:08 -0700480 struct net_device_stats stats;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700481
Johannes Bergb86e0282007-04-26 20:48:23 -0700482#ifdef CONFIG_WIRELESS_EXT
Linus Torvalds1da177e2005-04-16 15:20:36 -0700483 /* List of functions to handle Wireless Extensions (instead of ioctl).
484 * See <net/iw_handler.h> for details. Jean II */
485 const struct iw_handler_def * wireless_handlers;
486 /* Instance data managed by the core of Wireless Extensions. */
487 struct iw_public_data * wireless_data;
Johannes Bergb86e0282007-04-26 20:48:23 -0700488#endif
Stephen Hemminger76fd8592006-09-08 11:16:13 -0700489 const struct ethtool_ops *ethtool_ops;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700490
491 /*
492 * This marks the end of the "visible" part of the structure. All
493 * fields hereafter are internal to the system, and may change at
494 * will (read: may be cleaned up at will).
495 */
496
Linus Torvalds1da177e2005-04-16 15:20:36 -0700497
Stefan Rompfb00055a2006-03-20 17:09:11 -0800498 unsigned int flags; /* interface flags (a la BSD) */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700499 unsigned short gflags;
500 unsigned short priv_flags; /* Like 'flags' but invisible to userspace. */
501 unsigned short padded; /* How much padding added by alloc_netdev() */
502
Stefan Rompfb00055a2006-03-20 17:09:11 -0800503 unsigned char operstate; /* RFC2863 operstate */
504 unsigned char link_mode; /* mapping policy to operstate */
505
Linus Torvalds1da177e2005-04-16 15:20:36 -0700506 unsigned mtu; /* interface MTU value */
507 unsigned short type; /* interface hardware type */
508 unsigned short hard_header_len; /* hardware hdr length */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700509
510 struct net_device *master; /* Pointer to master device of a group,
511 * which this device is member of.
512 */
513
514 /* Interface address info. */
Jon Wetzela6f9a702005-08-20 17:15:54 -0700515 unsigned char perm_addr[MAX_ADDR_LEN]; /* permanent hw address */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700516 unsigned char addr_len; /* hardware address length */
517 unsigned short dev_id; /* for shared network cards */
518
Patrick McHardy4417da62007-06-27 01:28:10 -0700519 struct dev_addr_list *uc_list; /* Secondary unicast mac addresses */
520 int uc_count; /* Number of installed ucasts */
521 int uc_promisc;
Patrick McHardy3fba5a82007-06-27 01:26:58 -0700522 struct dev_addr_list *mc_list; /* Multicast mac addresses */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700523 int mc_count; /* Number of installed mcasts */
524 int promiscuity;
525 int allmulti;
526
Linus Torvalds1da177e2005-04-16 15:20:36 -0700527
528 /* Protocol specific pointers */
529
530 void *atalk_ptr; /* AppleTalk link */
531 void *ip_ptr; /* IPv4 specific data */
532 void *dn_ptr; /* DECnet specific data */
533 void *ip6_ptr; /* IPv6 specific data */
534 void *ec_ptr; /* Econet specific data */
535 void *ax25_ptr; /* AX.25 specific data */
Johannes Berg704232c2007-04-23 12:20:05 -0700536 struct wireless_dev *ieee80211_ptr; /* IEEE 802.11 specific data,
537 assign before registering */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700538
Eric Dumazet9356b8f2005-09-27 15:23:16 -0700539/*
540 * Cache line mostly used on receive path (including eth_type_trans())
541 */
Eric Dumazet9356b8f2005-09-27 15:23:16 -0700542 unsigned long last_rx; /* Time of last Rx */
543 /* Interface address info used in eth_type_trans() */
544 unsigned char dev_addr[MAX_ADDR_LEN]; /* hw address, (before bcast
545 because most packets are unicast) */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700546
Eric Dumazet9356b8f2005-09-27 15:23:16 -0700547 unsigned char broadcast[MAX_ADDR_LEN]; /* hw bcast add */
548
549/*
550 * Cache line mostly used on queue transmit path (qdisc)
551 */
552 /* device queue lock */
553 spinlock_t queue_lock ____cacheline_aligned_in_smp;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700554 struct Qdisc *qdisc;
555 struct Qdisc *qdisc_sleeping;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700556 struct list_head qdisc_list;
557 unsigned long tx_queue_len; /* Max frames per queue allowed */
558
Herbert Xuf6a78bf2006-06-22 02:57:17 -0700559 /* Partially transmitted GSO packet. */
560 struct sk_buff *gso_skb;
561
Linus Torvalds1da177e2005-04-16 15:20:36 -0700562 /* ingress path synchronizer */
563 spinlock_t ingress_lock;
Eric Dumazet9356b8f2005-09-27 15:23:16 -0700564 struct Qdisc *qdisc_ingress;
565
566/*
567 * One part is mostly used on xmit path (device)
568 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700569 /* hard_start_xmit synchronizer */
Herbert Xu932ff272006-06-09 12:20:56 -0700570 spinlock_t _xmit_lock ____cacheline_aligned_in_smp;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700571 /* cpu id of processor entered to hard_start_xmit or -1,
572 if nobody entered there.
573 */
574 int xmit_lock_owner;
Eric Dumazet9356b8f2005-09-27 15:23:16 -0700575 void *priv; /* pointer to private data */
576 int (*hard_start_xmit) (struct sk_buff *skb,
577 struct net_device *dev);
578 /* These may be needed for future network-power-down code. */
579 unsigned long trans_start; /* Time (in jiffies) of last Tx */
580
581 int watchdog_timeo; /* used by dev_watchdog() */
582 struct timer_list watchdog_timer;
583
584/*
585 * refcnt is a very hot point, so align it on SMP
586 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700587 /* Number of references to this device */
Eric Dumazet9356b8f2005-09-27 15:23:16 -0700588 atomic_t refcnt ____cacheline_aligned_in_smp;
589
Linus Torvalds1da177e2005-04-16 15:20:36 -0700590 /* delayed register/unregister */
591 struct list_head todo_list;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700592 /* device index hash chain */
593 struct hlist_node index_hlist;
594
Herbert Xu572a1032007-05-08 18:34:17 -0700595 struct net_device *link_watch_next;
596
Linus Torvalds1da177e2005-04-16 15:20:36 -0700597 /* register/unregister state machine */
598 enum { NETREG_UNINITIALIZED=0,
Stephen Hemmingerb17a7c12006-05-10 13:21:17 -0700599 NETREG_REGISTERED, /* completed register_netdevice */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700600 NETREG_UNREGISTERING, /* called unregister_netdevice */
601 NETREG_UNREGISTERED, /* completed unregister todo */
602 NETREG_RELEASED, /* called free_netdev */
603 } reg_state;
604
Linus Torvalds1da177e2005-04-16 15:20:36 -0700605 /* Called after device is detached from network. */
606 void (*uninit)(struct net_device *dev);
607 /* Called after last user reference disappears. */
608 void (*destructor)(struct net_device *dev);
609
610 /* Pointers to interface service routines. */
611 int (*open)(struct net_device *dev);
612 int (*stop)(struct net_device *dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700613#define HAVE_NETDEV_POLL
Linus Torvalds1da177e2005-04-16 15:20:36 -0700614 int (*hard_header) (struct sk_buff *skb,
615 struct net_device *dev,
616 unsigned short type,
617 void *daddr,
618 void *saddr,
619 unsigned len);
620 int (*rebuild_header)(struct sk_buff *skb);
Patrick McHardy24023452007-07-14 18:51:31 -0700621#define HAVE_CHANGE_RX_FLAGS
622 void (*change_rx_flags)(struct net_device *dev,
623 int flags);
Patrick McHardy4417da62007-06-27 01:28:10 -0700624#define HAVE_SET_RX_MODE
625 void (*set_rx_mode)(struct net_device *dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700626#define HAVE_MULTICAST
627 void (*set_multicast_list)(struct net_device *dev);
628#define HAVE_SET_MAC_ADDR
629 int (*set_mac_address)(struct net_device *dev,
630 void *addr);
631#define HAVE_PRIVATE_IOCTL
632 int (*do_ioctl)(struct net_device *dev,
633 struct ifreq *ifr, int cmd);
634#define HAVE_SET_CONFIG
635 int (*set_config)(struct net_device *dev,
636 struct ifmap *map);
637#define HAVE_HEADER_CACHE
638 int (*hard_header_cache)(struct neighbour *neigh,
639 struct hh_cache *hh);
640 void (*header_cache_update)(struct hh_cache *hh,
641 struct net_device *dev,
642 unsigned char * haddr);
643#define HAVE_CHANGE_MTU
644 int (*change_mtu)(struct net_device *dev, int new_mtu);
645
646#define HAVE_TX_TIMEOUT
647 void (*tx_timeout) (struct net_device *dev);
648
649 void (*vlan_rx_register)(struct net_device *dev,
650 struct vlan_group *grp);
651 void (*vlan_rx_add_vid)(struct net_device *dev,
652 unsigned short vid);
653 void (*vlan_rx_kill_vid)(struct net_device *dev,
654 unsigned short vid);
655
656 int (*hard_header_parse)(struct sk_buff *skb,
657 unsigned char *haddr);
658 int (*neigh_setup)(struct net_device *dev, struct neigh_parms *);
659#ifdef CONFIG_NETPOLL
Jeff Moyer115c1d62005-06-22 22:05:31 -0700660 struct netpoll_info *npinfo;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700661#endif
662#ifdef CONFIG_NET_POLL_CONTROLLER
663 void (*poll_controller)(struct net_device *dev);
664#endif
665
666 /* bridge stuff */
667 struct net_bridge_port *br_port;
Patrick McHardyb863ceb2007-07-14 18:55:06 -0700668 /* macvlan */
669 struct macvlan_port *macvlan_port;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700670
Linus Torvalds1da177e2005-04-16 15:20:36 -0700671 /* class/net/name entry */
Greg Kroah-Hartman43cb76d2002-04-09 12:14:34 -0700672 struct device dev;
Stephen Hemmingerfe9925b2006-05-06 17:56:03 -0700673 /* space for optional statistics and wireless sysfs groups */
674 struct attribute_group *sysfs_groups[3];
Patrick McHardy38f7b872007-06-13 12:03:51 -0700675
676 /* rtnetlink link ops */
677 const struct rtnl_link_ops *rtnl_link_ops;
Peter P Waskiewicz Jrf25f4e42007-07-06 13:36:20 -0700678
679 /* The TX queue control structures */
680 unsigned int egress_subqueue_count;
Patrick McHardy31ce72a2007-07-20 19:45:45 -0700681 struct net_device_subqueue egress_subqueue[1];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700682};
Greg Kroah-Hartman43cb76d2002-04-09 12:14:34 -0700683#define to_net_dev(d) container_of(d, struct net_device, dev)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700684
685#define NETDEV_ALIGN 32
686#define NETDEV_ALIGN_CONST (NETDEV_ALIGN - 1)
687
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700688/**
689 * netdev_priv - access network device private data
690 * @dev: network device
691 *
692 * Get network device private data
693 */
Patrick McHardy6472ce62007-06-13 12:03:21 -0700694static inline void *netdev_priv(const struct net_device *dev)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700695{
Peter P Waskiewicz Jrf25f4e42007-07-06 13:36:20 -0700696 return dev->priv;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700697}
698
699#define SET_MODULE_OWNER(dev) do { } while (0)
700/* Set the sysfs physical device reference for the network logical device
701 * if set prior to registration will cause a symlink during initialization.
702 */
Greg Kroah-Hartman43cb76d2002-04-09 12:14:34 -0700703#define SET_NETDEV_DEV(net, pdev) ((net)->dev.parent = (pdev))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700704
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700705static inline void netif_napi_add(struct net_device *dev,
706 struct napi_struct *napi,
707 int (*poll)(struct napi_struct *, int),
708 int weight)
709{
710 INIT_LIST_HEAD(&napi->poll_list);
711 napi->poll = poll;
712 napi->weight = weight;
713#ifdef CONFIG_NETPOLL
714 napi->dev = dev;
715 list_add(&napi->dev_list, &dev->napi_list);
716 spin_lock_init(&napi->poll_lock);
717 napi->poll_owner = -1;
718#endif
719 set_bit(NAPI_STATE_SCHED, &napi->state);
720}
721
Linus Torvalds1da177e2005-04-16 15:20:36 -0700722struct packet_type {
David S. Millerf2ccd8f2005-08-09 19:34:12 -0700723 __be16 type; /* This is really htons(ether_type). */
724 struct net_device *dev; /* NULL is wildcarded here */
725 int (*func) (struct sk_buff *,
726 struct net_device *,
727 struct packet_type *,
728 struct net_device *);
Herbert Xu576a30e2006-06-27 13:22:38 -0700729 struct sk_buff *(*gso_segment)(struct sk_buff *skb,
730 int features);
Herbert Xua430a432006-07-08 13:34:56 -0700731 int (*gso_send_check)(struct sk_buff *skb);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700732 void *af_packet_priv;
733 struct list_head list;
734};
735
736#include <linux/interrupt.h>
737#include <linux/notifier.h>
738
739extern struct net_device loopback_dev; /* The loopback */
Pavel Emelianov7562f872007-05-03 15:13:45 -0700740extern struct list_head dev_base_head; /* All devices */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700741extern rwlock_t dev_base_lock; /* Device list lock */
742
Pavel Emelianov7562f872007-05-03 15:13:45 -0700743#define for_each_netdev(d) \
744 list_for_each_entry(d, &dev_base_head, dev_list)
745#define for_each_netdev_safe(d, n) \
746 list_for_each_entry_safe(d, n, &dev_base_head, dev_list)
747#define for_each_netdev_continue(d) \
748 list_for_each_entry_continue(d, &dev_base_head, dev_list)
749#define net_device_entry(lh) list_entry(lh, struct net_device, dev_list)
750
751static inline struct net_device *next_net_device(struct net_device *dev)
752{
753 struct list_head *lh;
754
755 lh = dev->dev_list.next;
756 return lh == &dev_base_head ? NULL : net_device_entry(lh);
757}
758
759static inline struct net_device *first_net_device(void)
760{
761 return list_empty(&dev_base_head) ? NULL :
762 net_device_entry(dev_base_head.next);
763}
764
Linus Torvalds1da177e2005-04-16 15:20:36 -0700765extern int netdev_boot_setup_check(struct net_device *dev);
766extern unsigned long netdev_boot_base(const char *prefix, int unit);
767extern struct net_device *dev_getbyhwaddr(unsigned short type, char *hwaddr);
768extern struct net_device *dev_getfirstbyhwtype(unsigned short type);
Patrick McHardy4e9cac22007-05-03 03:28:13 -0700769extern struct net_device *__dev_getfirstbyhwtype(unsigned short type);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700770extern void dev_add_pack(struct packet_type *pt);
771extern void dev_remove_pack(struct packet_type *pt);
772extern void __dev_remove_pack(struct packet_type *pt);
773
774extern struct net_device *dev_get_by_flags(unsigned short flags,
775 unsigned short mask);
776extern struct net_device *dev_get_by_name(const char *name);
777extern struct net_device *__dev_get_by_name(const char *name);
778extern int dev_alloc_name(struct net_device *dev, const char *name);
779extern int dev_open(struct net_device *dev);
780extern int dev_close(struct net_device *dev);
781extern int dev_queue_xmit(struct sk_buff *skb);
782extern int register_netdevice(struct net_device *dev);
Stephen Hemminger22f8cde2007-02-07 00:09:58 -0800783extern void unregister_netdevice(struct net_device *dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700784extern void free_netdev(struct net_device *dev);
785extern void synchronize_net(void);
786extern int register_netdevice_notifier(struct notifier_block *nb);
787extern int unregister_netdevice_notifier(struct notifier_block *nb);
788extern int call_netdevice_notifiers(unsigned long val, void *v);
789extern struct net_device *dev_get_by_index(int ifindex);
790extern struct net_device *__dev_get_by_index(int ifindex);
791extern int dev_restart(struct net_device *dev);
792#ifdef CONFIG_NETPOLL_TRAP
793extern int netpoll_trap(void);
794#endif
795
796typedef int gifconf_func_t(struct net_device * dev, char __user * bufptr, int len);
797extern int register_gifconf(unsigned int family, gifconf_func_t * gifconf);
798static inline int unregister_gifconf(unsigned int family)
799{
800 return register_gifconf(family, NULL);
801}
802
803/*
804 * Incoming packets are placed on per-cpu queues so that
805 * no locking is needed.
806 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700807struct softnet_data
808{
Stephen Hemminger31aa02c2005-06-23 20:12:48 -0700809 struct net_device *output_queue;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700810 struct sk_buff_head input_pkt_queue;
811 struct list_head poll_list;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700812 struct sk_buff *completion_queue;
813
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700814 struct napi_struct backlog;
Chris Leechdb217332006-06-17 21:24:58 -0700815#ifdef CONFIG_NET_DMA
816 struct dma_chan *net_dma;
817#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700818};
819
820DECLARE_PER_CPU(struct softnet_data,softnet_data);
821
822#define HAVE_NETIF_QUEUE
823
Denis Vlasenko56079432006-03-29 15:57:29 -0800824extern void __netif_schedule(struct net_device *dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700825
826static inline void netif_schedule(struct net_device *dev)
827{
828 if (!test_bit(__LINK_STATE_XOFF, &dev->state))
829 __netif_schedule(dev);
830}
831
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700832/**
833 * netif_start_queue - allow transmit
834 * @dev: network device
835 *
836 * Allow upper layers to call the device hard_start_xmit routine.
837 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700838static inline void netif_start_queue(struct net_device *dev)
839{
840 clear_bit(__LINK_STATE_XOFF, &dev->state);
841}
842
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700843/**
844 * netif_wake_queue - restart transmit
845 * @dev: network device
846 *
847 * Allow upper layers to call the device hard_start_xmit routine.
848 * Used for flow control when transmit resources are available.
849 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700850static inline void netif_wake_queue(struct net_device *dev)
851{
852#ifdef CONFIG_NETPOLL_TRAP
Sergei Shtylyov5f286e12007-04-28 20:57:37 -0700853 if (netpoll_trap()) {
854 clear_bit(__LINK_STATE_XOFF, &dev->state);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700855 return;
Sergei Shtylyov5f286e12007-04-28 20:57:37 -0700856 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700857#endif
858 if (test_and_clear_bit(__LINK_STATE_XOFF, &dev->state))
859 __netif_schedule(dev);
860}
861
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700862/**
863 * netif_stop_queue - stop transmitted packets
864 * @dev: network device
865 *
866 * Stop upper layers calling the device hard_start_xmit routine.
867 * Used for flow control when transmit resources are unavailable.
868 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700869static inline void netif_stop_queue(struct net_device *dev)
870{
Linus Torvalds1da177e2005-04-16 15:20:36 -0700871 set_bit(__LINK_STATE_XOFF, &dev->state);
872}
873
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700874/**
875 * netif_queue_stopped - test if transmit queue is flowblocked
876 * @dev: network device
877 *
878 * Test if transmit queue on device is currently unable to send.
879 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700880static inline int netif_queue_stopped(const struct net_device *dev)
881{
882 return test_bit(__LINK_STATE_XOFF, &dev->state);
883}
884
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700885/**
886 * netif_running - test if up
887 * @dev: network device
888 *
889 * Test if the device has been brought up.
890 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700891static inline int netif_running(const struct net_device *dev)
892{
893 return test_bit(__LINK_STATE_START, &dev->state);
894}
895
Peter P Waskiewicz Jrf25f4e42007-07-06 13:36:20 -0700896/*
897 * Routines to manage the subqueues on a device. We only need start
898 * stop, and a check if it's stopped. All other device management is
899 * done at the overall netdevice level.
900 * Also test the device if we're multiqueue.
901 */
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700902
903/**
904 * netif_start_subqueue - allow sending packets on subqueue
905 * @dev: network device
906 * @queue_index: sub queue index
907 *
908 * Start individual transmit queue of a device with multiple transmit queues.
909 */
Peter P Waskiewicz Jrf25f4e42007-07-06 13:36:20 -0700910static inline void netif_start_subqueue(struct net_device *dev, u16 queue_index)
911{
912#ifdef CONFIG_NETDEVICES_MULTIQUEUE
913 clear_bit(__LINK_STATE_XOFF, &dev->egress_subqueue[queue_index].state);
914#endif
915}
916
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700917/**
918 * netif_stop_subqueue - stop sending packets on subqueue
919 * @dev: network device
920 * @queue_index: sub queue index
921 *
922 * Stop individual transmit queue of a device with multiple transmit queues.
923 */
Peter P Waskiewicz Jrf25f4e42007-07-06 13:36:20 -0700924static inline void netif_stop_subqueue(struct net_device *dev, u16 queue_index)
925{
926#ifdef CONFIG_NETDEVICES_MULTIQUEUE
927#ifdef CONFIG_NETPOLL_TRAP
928 if (netpoll_trap())
929 return;
930#endif
931 set_bit(__LINK_STATE_XOFF, &dev->egress_subqueue[queue_index].state);
932#endif
933}
934
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700935/**
936 * netif_subqueue_stopped - test status of subqueue
937 * @dev: network device
938 * @queue_index: sub queue index
939 *
940 * Check individual transmit queue of a device with multiple transmit queues.
941 */
Peter P Waskiewicz Jrf25f4e42007-07-06 13:36:20 -0700942static inline int netif_subqueue_stopped(const struct net_device *dev,
943 u16 queue_index)
944{
945#ifdef CONFIG_NETDEVICES_MULTIQUEUE
946 return test_bit(__LINK_STATE_XOFF,
947 &dev->egress_subqueue[queue_index].state);
948#else
949 return 0;
950#endif
951}
952
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700953
954/**
955 * netif_wake_subqueue - allow sending packets on subqueue
956 * @dev: network device
957 * @queue_index: sub queue index
958 *
959 * Resume individual transmit queue of a device with multiple transmit queues.
960 */
Peter P Waskiewicz Jrf25f4e42007-07-06 13:36:20 -0700961static inline void netif_wake_subqueue(struct net_device *dev, u16 queue_index)
962{
963#ifdef CONFIG_NETDEVICES_MULTIQUEUE
964#ifdef CONFIG_NETPOLL_TRAP
965 if (netpoll_trap())
966 return;
967#endif
968 if (test_and_clear_bit(__LINK_STATE_XOFF,
969 &dev->egress_subqueue[queue_index].state))
970 __netif_schedule(dev);
971#endif
972}
973
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700974/**
975 * netif_is_multiqueue - test if device has multiple transmit queues
976 * @dev: network device
977 *
978 * Check if device has multiple transmit queues
979 * Always falls if NETDEVICE_MULTIQUEUE is not configured
980 */
Peter P Waskiewicz Jrf25f4e42007-07-06 13:36:20 -0700981static inline int netif_is_multiqueue(const struct net_device *dev)
982{
983#ifdef CONFIG_NETDEVICES_MULTIQUEUE
984 return (!!(NETIF_F_MULTI_QUEUE & dev->features));
985#else
986 return 0;
987#endif
988}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700989
990/* Use this variant when it is known for sure that it
991 * is executing from interrupt context.
992 */
Stephen Hemmingerbea33482007-10-03 16:41:36 -0700993extern void dev_kfree_skb_irq(struct sk_buff *skb);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700994
995/* Use this variant in places where it could be invoked
996 * either from interrupt or non-interrupt context.
997 */
Denis Vlasenko56079432006-03-29 15:57:29 -0800998extern void dev_kfree_skb_any(struct sk_buff *skb);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700999
1000#define HAVE_NETIF_RX 1
1001extern int netif_rx(struct sk_buff *skb);
1002extern int netif_rx_ni(struct sk_buff *skb);
1003#define HAVE_NETIF_RECEIVE_SKB 1
1004extern int netif_receive_skb(struct sk_buff *skb);
Mitch Williamsc2373ee2005-11-09 10:34:45 -08001005extern int dev_valid_name(const char *name);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001006extern int dev_ioctl(unsigned int cmd, void __user *);
1007extern int dev_ethtool(struct ifreq *);
1008extern unsigned dev_get_flags(const struct net_device *);
1009extern int dev_change_flags(struct net_device *, unsigned);
1010extern int dev_change_name(struct net_device *, char *);
1011extern int dev_set_mtu(struct net_device *, int);
1012extern int dev_set_mac_address(struct net_device *,
1013 struct sockaddr *);
Herbert Xuf6a78bf2006-06-22 02:57:17 -07001014extern int dev_hard_start_xmit(struct sk_buff *skb,
1015 struct net_device *dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001016
Arnaldo Carvalho de Melo20380732005-08-16 02:18:02 -03001017extern int netdev_budget;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001018
1019/* Called by rtnetlink.c:rtnl_unlock() */
1020extern void netdev_run_todo(void);
1021
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001022/**
1023 * dev_put - release reference to device
1024 * @dev: network device
1025 *
1026 * Hold reference to device to keep it from being freed.
1027 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001028static inline void dev_put(struct net_device *dev)
1029{
1030 atomic_dec(&dev->refcnt);
1031}
1032
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001033/**
1034 * dev_hold - get reference to device
1035 * @dev: network device
1036 *
1037 * Release reference to device to allow it to be freed.
1038 */
Stephen Hemminger15333062006-03-20 22:32:28 -08001039static inline void dev_hold(struct net_device *dev)
1040{
1041 atomic_inc(&dev->refcnt);
1042}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001043
1044/* Carrier loss detection, dial on demand. The functions netif_carrier_on
1045 * and _off may be called from IRQ context, but it is caller
1046 * who is responsible for serialization of these calls.
Stefan Rompfb00055a2006-03-20 17:09:11 -08001047 *
1048 * The name carrier is inappropriate, these functions should really be
1049 * called netif_lowerlayer_*() because they represent the state of any
1050 * kind of lower layer not just hardware media.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001051 */
1052
1053extern void linkwatch_fire_event(struct net_device *dev);
1054
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001055/**
1056 * netif_carrier_ok - test if carrier present
1057 * @dev: network device
1058 *
1059 * Check if carrier is present on device
1060 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001061static inline int netif_carrier_ok(const struct net_device *dev)
1062{
1063 return !test_bit(__LINK_STATE_NOCARRIER, &dev->state);
1064}
1065
1066extern void __netdev_watchdog_up(struct net_device *dev);
1067
Denis Vlasenko0a242ef2005-08-11 15:32:53 -07001068extern void netif_carrier_on(struct net_device *dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001069
Denis Vlasenko0a242ef2005-08-11 15:32:53 -07001070extern void netif_carrier_off(struct net_device *dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001071
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001072/**
1073 * netif_dormant_on - mark device as dormant.
1074 * @dev: network device
1075 *
1076 * Mark device as dormant (as per RFC2863).
1077 *
1078 * The dormant state indicates that the relevant interface is not
1079 * actually in a condition to pass packets (i.e., it is not 'up') but is
1080 * in a "pending" state, waiting for some external event. For "on-
1081 * demand" interfaces, this new state identifies the situation where the
1082 * interface is waiting for events to place it in the up state.
1083 *
1084 */
Stefan Rompfb00055a2006-03-20 17:09:11 -08001085static inline void netif_dormant_on(struct net_device *dev)
1086{
1087 if (!test_and_set_bit(__LINK_STATE_DORMANT, &dev->state))
1088 linkwatch_fire_event(dev);
1089}
1090
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001091/**
1092 * netif_dormant_off - set device as not dormant.
1093 * @dev: network device
1094 *
1095 * Device is not in dormant state.
1096 */
Stefan Rompfb00055a2006-03-20 17:09:11 -08001097static inline void netif_dormant_off(struct net_device *dev)
1098{
1099 if (test_and_clear_bit(__LINK_STATE_DORMANT, &dev->state))
1100 linkwatch_fire_event(dev);
1101}
1102
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001103/**
1104 * netif_dormant - test if carrier present
1105 * @dev: network device
1106 *
1107 * Check if carrier is present on device
1108 */
Stefan Rompfb00055a2006-03-20 17:09:11 -08001109static inline int netif_dormant(const struct net_device *dev)
1110{
1111 return test_bit(__LINK_STATE_DORMANT, &dev->state);
1112}
1113
1114
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001115/**
1116 * netif_oper_up - test if device is operational
1117 * @dev: network device
1118 *
1119 * Check if carrier is operational
1120 */
Stefan Rompfb00055a2006-03-20 17:09:11 -08001121static inline int netif_oper_up(const struct net_device *dev) {
1122 return (dev->operstate == IF_OPER_UP ||
1123 dev->operstate == IF_OPER_UNKNOWN /* backward compat */);
1124}
1125
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001126/**
1127 * netif_device_present - is device available or removed
1128 * @dev: network device
1129 *
1130 * Check if device has not been removed from system.
1131 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001132static inline int netif_device_present(struct net_device *dev)
1133{
1134 return test_bit(__LINK_STATE_PRESENT, &dev->state);
1135}
1136
Denis Vlasenko56079432006-03-29 15:57:29 -08001137extern void netif_device_detach(struct net_device *dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001138
Denis Vlasenko56079432006-03-29 15:57:29 -08001139extern void netif_device_attach(struct net_device *dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001140
1141/*
1142 * Network interface message level settings
1143 */
1144#define HAVE_NETIF_MSG 1
1145
1146enum {
1147 NETIF_MSG_DRV = 0x0001,
1148 NETIF_MSG_PROBE = 0x0002,
1149 NETIF_MSG_LINK = 0x0004,
1150 NETIF_MSG_TIMER = 0x0008,
1151 NETIF_MSG_IFDOWN = 0x0010,
1152 NETIF_MSG_IFUP = 0x0020,
1153 NETIF_MSG_RX_ERR = 0x0040,
1154 NETIF_MSG_TX_ERR = 0x0080,
1155 NETIF_MSG_TX_QUEUED = 0x0100,
1156 NETIF_MSG_INTR = 0x0200,
1157 NETIF_MSG_TX_DONE = 0x0400,
1158 NETIF_MSG_RX_STATUS = 0x0800,
1159 NETIF_MSG_PKTDATA = 0x1000,
1160 NETIF_MSG_HW = 0x2000,
1161 NETIF_MSG_WOL = 0x4000,
1162};
1163
1164#define netif_msg_drv(p) ((p)->msg_enable & NETIF_MSG_DRV)
1165#define netif_msg_probe(p) ((p)->msg_enable & NETIF_MSG_PROBE)
1166#define netif_msg_link(p) ((p)->msg_enable & NETIF_MSG_LINK)
1167#define netif_msg_timer(p) ((p)->msg_enable & NETIF_MSG_TIMER)
1168#define netif_msg_ifdown(p) ((p)->msg_enable & NETIF_MSG_IFDOWN)
1169#define netif_msg_ifup(p) ((p)->msg_enable & NETIF_MSG_IFUP)
1170#define netif_msg_rx_err(p) ((p)->msg_enable & NETIF_MSG_RX_ERR)
1171#define netif_msg_tx_err(p) ((p)->msg_enable & NETIF_MSG_TX_ERR)
1172#define netif_msg_tx_queued(p) ((p)->msg_enable & NETIF_MSG_TX_QUEUED)
1173#define netif_msg_intr(p) ((p)->msg_enable & NETIF_MSG_INTR)
1174#define netif_msg_tx_done(p) ((p)->msg_enable & NETIF_MSG_TX_DONE)
1175#define netif_msg_rx_status(p) ((p)->msg_enable & NETIF_MSG_RX_STATUS)
1176#define netif_msg_pktdata(p) ((p)->msg_enable & NETIF_MSG_PKTDATA)
1177#define netif_msg_hw(p) ((p)->msg_enable & NETIF_MSG_HW)
1178#define netif_msg_wol(p) ((p)->msg_enable & NETIF_MSG_WOL)
1179
1180static inline u32 netif_msg_init(int debug_value, int default_msg_enable_bits)
1181{
1182 /* use default */
1183 if (debug_value < 0 || debug_value >= (sizeof(u32) * 8))
1184 return default_msg_enable_bits;
1185 if (debug_value == 0) /* no output */
1186 return 0;
1187 /* set low N bits */
1188 return (1 << debug_value) - 1;
1189}
1190
shemminger@osdl.org0a122572005-11-30 11:45:17 -08001191/* Test if receive needs to be scheduled but only if up */
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001192static inline int netif_rx_schedule_prep(struct net_device *dev,
1193 struct napi_struct *napi)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001194{
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001195 return netif_running(dev) && napi_schedule_prep(napi);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001196}
1197
1198/* Add interface to tail of rx poll list. This assumes that _prep has
1199 * already been called and returned 1.
1200 */
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001201static inline void __netif_rx_schedule(struct net_device *dev,
1202 struct napi_struct *napi)
1203{
1204 dev_hold(dev);
1205 __napi_schedule(napi);
1206}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001207
1208/* Try to reschedule poll. Called by irq handler. */
1209
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001210static inline void netif_rx_schedule(struct net_device *dev,
1211 struct napi_struct *napi)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001212{
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001213 if (netif_rx_schedule_prep(dev, napi))
1214 __netif_rx_schedule(dev, napi);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001215}
1216
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001217/* Try to reschedule poll. Called by dev->poll() after netif_rx_complete(). */
1218static inline int netif_rx_reschedule(struct net_device *dev,
1219 struct napi_struct *napi)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001220{
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001221 if (napi_schedule_prep(napi)) {
1222 __netif_rx_schedule(dev, napi);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001223 return 1;
1224 }
1225 return 0;
1226}
1227
Herbert Xub0ba6662007-05-29 13:22:52 -07001228/* same as netif_rx_complete, except that local_irq_save(flags)
1229 * has already been issued
1230 */
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001231static inline void __netif_rx_complete(struct net_device *dev,
1232 struct napi_struct *napi)
Herbert Xub0ba6662007-05-29 13:22:52 -07001233{
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001234 __napi_complete(napi);
1235 dev_put(dev);
Herbert Xub0ba6662007-05-29 13:22:52 -07001236}
1237
Linus Torvalds1da177e2005-04-16 15:20:36 -07001238/* Remove interface from poll list: it must be in the poll list
1239 * on current cpu. This primitive is called by dev->poll(), when
1240 * it completes the work. The device cannot be out of poll list at this
1241 * moment, it is BUG().
1242 */
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001243static inline void netif_rx_complete(struct net_device *dev,
1244 struct napi_struct *napi)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001245{
1246 unsigned long flags;
1247
1248 local_irq_save(flags);
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001249 __netif_rx_complete(dev, napi);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001250 local_irq_restore(flags);
1251}
1252
Stephen Hemmingerbea33482007-10-03 16:41:36 -07001253/**
1254 * netif_tx_lock - grab network device transmit lock
1255 * @dev: network device
1256 *
1257 * Get network device transmit lock
1258 */
Herbert Xu932ff272006-06-09 12:20:56 -07001259static inline void netif_tx_lock(struct net_device *dev)
1260{
1261 spin_lock(&dev->_xmit_lock);
1262 dev->xmit_lock_owner = smp_processor_id();
1263}
1264
1265static inline void netif_tx_lock_bh(struct net_device *dev)
1266{
1267 spin_lock_bh(&dev->_xmit_lock);
1268 dev->xmit_lock_owner = smp_processor_id();
1269}
1270
1271static inline int netif_tx_trylock(struct net_device *dev)
1272{
Herbert Xu53c4b2c2006-07-21 14:55:38 -07001273 int ok = spin_trylock(&dev->_xmit_lock);
1274 if (likely(ok))
Herbert Xu932ff272006-06-09 12:20:56 -07001275 dev->xmit_lock_owner = smp_processor_id();
Herbert Xu53c4b2c2006-07-21 14:55:38 -07001276 return ok;
Herbert Xu932ff272006-06-09 12:20:56 -07001277}
1278
1279static inline void netif_tx_unlock(struct net_device *dev)
1280{
1281 dev->xmit_lock_owner = -1;
1282 spin_unlock(&dev->_xmit_lock);
1283}
1284
1285static inline void netif_tx_unlock_bh(struct net_device *dev)
1286{
1287 dev->xmit_lock_owner = -1;
1288 spin_unlock_bh(&dev->_xmit_lock);
1289}
1290
Linus Torvalds1da177e2005-04-16 15:20:36 -07001291static inline void netif_tx_disable(struct net_device *dev)
1292{
Herbert Xu932ff272006-06-09 12:20:56 -07001293 netif_tx_lock_bh(dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001294 netif_stop_queue(dev);
Herbert Xu932ff272006-06-09 12:20:56 -07001295 netif_tx_unlock_bh(dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001296}
1297
1298/* These functions live elsewhere (drivers/net/net_init.c, but related) */
1299
1300extern void ether_setup(struct net_device *dev);
1301
1302/* Support for loadable net-drivers */
Peter P Waskiewicz Jrf25f4e42007-07-06 13:36:20 -07001303extern struct net_device *alloc_netdev_mq(int sizeof_priv, const char *name,
1304 void (*setup)(struct net_device *),
1305 unsigned int queue_count);
1306#define alloc_netdev(sizeof_priv, name, setup) \
1307 alloc_netdev_mq(sizeof_priv, name, setup, 1)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001308extern int register_netdev(struct net_device *dev);
1309extern void unregister_netdev(struct net_device *dev);
Patrick McHardy4417da62007-06-27 01:28:10 -07001310/* Functions used for secondary unicast and multicast support */
1311extern void dev_set_rx_mode(struct net_device *dev);
1312extern void __dev_set_rx_mode(struct net_device *dev);
1313extern int dev_unicast_delete(struct net_device *dev, void *addr, int alen);
1314extern int dev_unicast_add(struct net_device *dev, void *addr, int alen);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001315extern int dev_mc_delete(struct net_device *dev, void *addr, int alen, int all);
1316extern int dev_mc_add(struct net_device *dev, void *addr, int alen, int newonly);
Patrick McHardya0a400d2007-07-14 18:52:02 -07001317extern int dev_mc_sync(struct net_device *to, struct net_device *from);
1318extern void dev_mc_unsync(struct net_device *to, struct net_device *from);
Patrick McHardy61cbc2f2007-06-30 13:35:52 -07001319extern int __dev_addr_delete(struct dev_addr_list **list, int *count, void *addr, int alen, int all);
1320extern int __dev_addr_add(struct dev_addr_list **list, int *count, void *addr, int alen, int newonly);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001321extern void dev_set_promiscuity(struct net_device *dev, int inc);
1322extern void dev_set_allmulti(struct net_device *dev, int inc);
1323extern void netdev_state_change(struct net_device *dev);
Stephen Hemmingerd8a33ac2005-05-29 14:13:47 -07001324extern void netdev_features_change(struct net_device *dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001325/* Load a device via the kmod */
1326extern void dev_load(const char *name);
1327extern void dev_mcast_init(void);
1328extern int netdev_max_backlog;
1329extern int weight_p;
1330extern int netdev_set_master(struct net_device *dev, struct net_device *master);
Patrick McHardy84fa7932006-08-29 16:44:56 -07001331extern int skb_checksum_help(struct sk_buff *skb);
Herbert Xu576a30e2006-06-27 13:22:38 -07001332extern struct sk_buff *skb_gso_segment(struct sk_buff *skb, int features);
Herbert Xufb286bb2005-11-10 13:01:24 -08001333#ifdef CONFIG_BUG
1334extern void netdev_rx_csum_fault(struct net_device *dev);
1335#else
1336static inline void netdev_rx_csum_fault(struct net_device *dev)
1337{
1338}
1339#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -07001340/* rx skb timestamps */
1341extern void net_enable_timestamp(void);
1342extern void net_disable_timestamp(void);
1343
Arnaldo Carvalho de Melo20380732005-08-16 02:18:02 -03001344#ifdef CONFIG_PROC_FS
1345extern void *dev_seq_start(struct seq_file *seq, loff_t *pos);
1346extern void *dev_seq_next(struct seq_file *seq, void *v, loff_t *pos);
1347extern void dev_seq_stop(struct seq_file *seq, void *v);
1348#endif
1349
1350extern void linkwatch_run_queue(void);
1351
Herbert Xu7f353bf2007-08-10 15:47:58 -07001352extern int netdev_compute_features(unsigned long all, unsigned long one);
1353
Herbert Xubcd76112006-06-30 13:36:35 -07001354static inline int net_gso_ok(int features, int gso_type)
1355{
1356 int feature = gso_type << NETIF_F_GSO_SHIFT;
1357 return (features & feature) == feature;
1358}
1359
Herbert Xu576a30e2006-06-27 13:22:38 -07001360static inline int skb_gso_ok(struct sk_buff *skb, int features)
1361{
Herbert Xua430a432006-07-08 13:34:56 -07001362 return net_gso_ok(features, skb_shinfo(skb)->gso_type);
Herbert Xu576a30e2006-06-27 13:22:38 -07001363}
1364
Herbert Xu79671682006-06-22 02:40:14 -07001365static inline int netif_needs_gso(struct net_device *dev, struct sk_buff *skb)
1366{
Herbert Xua430a432006-07-08 13:34:56 -07001367 return skb_is_gso(skb) &&
1368 (!skb_gso_ok(skb, dev->features) ||
Patrick McHardy84fa7932006-08-29 16:44:56 -07001369 unlikely(skb->ip_summed != CHECKSUM_PARTIAL));
Herbert Xu79671682006-06-22 02:40:14 -07001370}
1371
David S. Miller7ea49ed2006-08-14 17:08:36 -07001372/* On bonding slaves other than the currently active slave, suppress
Jay Vosburghf5b2b962006-09-22 21:54:53 -07001373 * duplicates except for 802.3ad ETH_P_SLOW, alb non-mcast/bcast, and
1374 * ARP on active-backup slaves with arp_validate enabled.
David S. Miller7ea49ed2006-08-14 17:08:36 -07001375 */
1376static inline int skb_bond_should_drop(struct sk_buff *skb)
1377{
1378 struct net_device *dev = skb->dev;
1379 struct net_device *master = dev->master;
1380
1381 if (master &&
1382 (dev->priv_flags & IFF_SLAVE_INACTIVE)) {
Jay Vosburghf5b2b962006-09-22 21:54:53 -07001383 if ((dev->priv_flags & IFF_SLAVE_NEEDARP) &&
1384 skb->protocol == __constant_htons(ETH_P_ARP))
1385 return 0;
1386
David S. Miller7ea49ed2006-08-14 17:08:36 -07001387 if (master->priv_flags & IFF_MASTER_ALB) {
1388 if (skb->pkt_type != PACKET_BROADCAST &&
1389 skb->pkt_type != PACKET_MULTICAST)
1390 return 0;
1391 }
1392 if (master->priv_flags & IFF_MASTER_8023AD &&
1393 skb->protocol == __constant_htons(ETH_P_SLOW))
1394 return 0;
1395
1396 return 1;
1397 }
1398 return 0;
1399}
1400
Linus Torvalds1da177e2005-04-16 15:20:36 -07001401#endif /* __KERNEL__ */
1402
1403#endif /* _LINUX_DEV_H */