3857517f1ca59a621f9a57381497b59b0c559b8c
[safe/jmp/linux-2.6] / include / linux / netdevice.h
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  *
10  * Authors:     Ross Biro
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@lxorguk.ukuu.org.uk>
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 #include <linux/if_link.h>
32
33 #ifdef __KERNEL__
34 #include <linux/pm_qos_params.h>
35 #include <linux/timer.h>
36 #include <linux/delay.h>
37 #include <linux/mm.h>
38 #include <asm/atomic.h>
39 #include <asm/cache.h>
40 #include <asm/byteorder.h>
41
42 #include <linux/device.h>
43 #include <linux/percpu.h>
44 #include <linux/rculist.h>
45 #include <linux/dmaengine.h>
46 #include <linux/workqueue.h>
47
48 #include <linux/ethtool.h>
49 #include <net/net_namespace.h>
50 #include <net/dsa.h>
51 #ifdef CONFIG_DCB
52 #include <net/dcbnl.h>
53 #endif
54
55 struct vlan_group;
56 struct netpoll_info;
57 /* 802.11 specific */
58 struct wireless_dev;
59                                         /* source back-compat hooks */
60 #define SET_ETHTOOL_OPS(netdev,ops) \
61         ( (netdev)->ethtool_ops = (ops) )
62
63 #define HAVE_ALLOC_NETDEV               /* feature macro: alloc_xxxdev
64                                            functions are available. */
65 #define HAVE_FREE_NETDEV                /* free_netdev() */
66 #define HAVE_NETDEV_PRIV                /* netdev_priv() */
67
68 /* Backlog congestion levels */
69 #define NET_RX_SUCCESS          0       /* keep 'em coming, baby */
70 #define NET_RX_DROP             1       /* packet dropped */
71
72 /*
73  * Transmit return codes: transmit return codes originate from three different
74  * namespaces:
75  *
76  * - qdisc return codes
77  * - driver transmit return codes
78  * - errno values
79  *
80  * Drivers are allowed to return any one of those in their hard_start_xmit()
81  * function. Real network devices commonly used with qdiscs should only return
82  * the driver transmit return codes though - when qdiscs are used, the actual
83  * transmission happens asynchronously, so the value is not propagated to
84  * higher layers. Virtual network devices transmit synchronously, in this case
85  * the driver transmit return codes are consumed by dev_queue_xmit(), all
86  * others are propagated to higher layers.
87  */
88
89 /* qdisc ->enqueue() return codes. */
90 #define NET_XMIT_SUCCESS        0x00
91 #define NET_XMIT_DROP           0x01    /* skb dropped                  */
92 #define NET_XMIT_CN             0x02    /* congestion notification      */
93 #define NET_XMIT_POLICED        0x03    /* skb is shot by police        */
94 #define NET_XMIT_MASK           0x0f    /* qdisc flags in net/sch_generic.h */
95
96 /* NET_XMIT_CN is special. It does not guarantee that this packet is lost. It
97  * indicates that the device will soon be dropping packets, or already drops
98  * some packets of the same priority; prompting us to send less aggressively. */
99 #define net_xmit_eval(e)        ((e) == NET_XMIT_CN ? 0 : (e))
100 #define net_xmit_errno(e)       ((e) != NET_XMIT_CN ? -ENOBUFS : 0)
101
102 /* Driver transmit return codes */
103 #define NETDEV_TX_MASK          0xf0
104
105 enum netdev_tx {
106         __NETDEV_TX_MIN  = INT_MIN,     /* make sure enum is signed */
107         NETDEV_TX_OK     = 0x00,        /* driver took care of packet */
108         NETDEV_TX_BUSY   = 0x10,        /* driver tx path was busy*/
109         NETDEV_TX_LOCKED = 0x20,        /* driver tx lock was already taken */
110 };
111 typedef enum netdev_tx netdev_tx_t;
112
113 /*
114  * Current order: NETDEV_TX_MASK > NET_XMIT_MASK >= 0 is significant;
115  * hard_start_xmit() return < NET_XMIT_MASK means skb was consumed.
116  */
117 static inline bool dev_xmit_complete(int rc)
118 {
119         /*
120          * Positive cases with an skb consumed by a driver:
121          * - successful transmission (rc == NETDEV_TX_OK)
122          * - error while transmitting (rc < 0)
123          * - error while queueing to a different device (rc & NET_XMIT_MASK)
124          */
125         if (likely(rc < NET_XMIT_MASK))
126                 return true;
127
128         return false;
129 }
130
131 #endif
132
133 #define MAX_ADDR_LEN    32              /* Largest hardware address length */
134
135 #ifdef  __KERNEL__
136 /*
137  *      Compute the worst case header length according to the protocols
138  *      used.
139  */
140
141 #if defined(CONFIG_WLAN) || defined(CONFIG_AX25) || defined(CONFIG_AX25_MODULE)
142 # if defined(CONFIG_MAC80211_MESH)
143 #  define LL_MAX_HEADER 128
144 # else
145 #  define LL_MAX_HEADER 96
146 # endif
147 #elif defined(CONFIG_TR) || defined(CONFIG_TR_MODULE)
148 # define LL_MAX_HEADER 48
149 #else
150 # define LL_MAX_HEADER 32
151 #endif
152
153 #if !defined(CONFIG_NET_IPIP) && !defined(CONFIG_NET_IPIP_MODULE) && \
154     !defined(CONFIG_NET_IPGRE) &&  !defined(CONFIG_NET_IPGRE_MODULE) && \
155     !defined(CONFIG_IPV6_SIT) && !defined(CONFIG_IPV6_SIT_MODULE) && \
156     !defined(CONFIG_IPV6_TUNNEL) && !defined(CONFIG_IPV6_TUNNEL_MODULE)
157 #define MAX_HEADER LL_MAX_HEADER
158 #else
159 #define MAX_HEADER (LL_MAX_HEADER + 48)
160 #endif
161
162 #endif  /*  __KERNEL__  */
163
164 /*
165  *      Network device statistics. Akin to the 2.0 ether stats but
166  *      with byte counters.
167  */
168
169 struct net_device_stats {
170         unsigned long   rx_packets;             /* total packets received       */
171         unsigned long   tx_packets;             /* total packets transmitted    */
172         unsigned long   rx_bytes;               /* total bytes received         */
173         unsigned long   tx_bytes;               /* total bytes transmitted      */
174         unsigned long   rx_errors;              /* bad packets received         */
175         unsigned long   tx_errors;              /* packet transmit problems     */
176         unsigned long   rx_dropped;             /* no space in linux buffers    */
177         unsigned long   tx_dropped;             /* no space available in linux  */
178         unsigned long   multicast;              /* multicast packets received   */
179         unsigned long   collisions;
180
181         /* detailed rx_errors: */
182         unsigned long   rx_length_errors;
183         unsigned long   rx_over_errors;         /* receiver ring buff overflow  */
184         unsigned long   rx_crc_errors;          /* recved pkt with crc error    */
185         unsigned long   rx_frame_errors;        /* recv'd frame alignment error */
186         unsigned long   rx_fifo_errors;         /* recv'r fifo overrun          */
187         unsigned long   rx_missed_errors;       /* receiver missed packet       */
188
189         /* detailed tx_errors */
190         unsigned long   tx_aborted_errors;
191         unsigned long   tx_carrier_errors;
192         unsigned long   tx_fifo_errors;
193         unsigned long   tx_heartbeat_errors;
194         unsigned long   tx_window_errors;
195         
196         /* for cslip etc */
197         unsigned long   rx_compressed;
198         unsigned long   tx_compressed;
199 };
200
201
202 /* Media selection options. */
203 enum {
204         IF_PORT_UNKNOWN = 0,
205         IF_PORT_10BASE2,
206         IF_PORT_10BASET,
207         IF_PORT_AUI,
208         IF_PORT_100BASET,
209         IF_PORT_100BASETX,
210         IF_PORT_100BASEFX
211 };
212
213 #ifdef __KERNEL__
214
215 #include <linux/cache.h>
216 #include <linux/skbuff.h>
217
218 struct neighbour;
219 struct neigh_parms;
220 struct sk_buff;
221
222 struct netif_rx_stats {
223         unsigned total;
224         unsigned dropped;
225         unsigned time_squeeze;
226         unsigned cpu_collision;
227 };
228
229 DECLARE_PER_CPU(struct netif_rx_stats, netdev_rx_stat);
230
231 struct dev_addr_list {
232         struct dev_addr_list    *next;
233         u8                      da_addr[MAX_ADDR_LEN];
234         u8                      da_addrlen;
235         u8                      da_synced;
236         int                     da_users;
237         int                     da_gusers;
238 };
239
240 /*
241  *      We tag multicasts with these structures.
242  */
243
244 #define dev_mc_list     dev_addr_list
245 #define dmi_addr        da_addr
246 #define dmi_addrlen     da_addrlen
247 #define dmi_users       da_users
248 #define dmi_gusers      da_gusers
249
250 struct netdev_hw_addr {
251         struct list_head        list;
252         unsigned char           addr[MAX_ADDR_LEN];
253         unsigned char           type;
254 #define NETDEV_HW_ADDR_T_LAN            1
255 #define NETDEV_HW_ADDR_T_SAN            2
256 #define NETDEV_HW_ADDR_T_SLAVE          3
257 #define NETDEV_HW_ADDR_T_UNICAST        4
258         int                     refcount;
259         bool                    synced;
260         struct rcu_head         rcu_head;
261 };
262
263 struct netdev_hw_addr_list {
264         struct list_head        list;
265         int                     count;
266 };
267
268 #define netdev_uc_count(dev) ((dev)->uc.count)
269 #define netdev_uc_empty(dev) ((dev)->uc.count == 0)
270 #define netdev_for_each_uc_addr(ha, dev) \
271         list_for_each_entry(ha, &dev->uc.list, list)
272
273 #define netdev_mc_count(dev) ((dev)->mc_count)
274 #define netdev_mc_empty(dev) (netdev_mc_count(dev) == 0)
275
276 #define netdev_for_each_mc_addr(mclist, dev) \
277         for (mclist = dev->mc_list; mclist; mclist = mclist->next)
278
279 struct hh_cache {
280         struct hh_cache *hh_next;       /* Next entry                        */
281         atomic_t        hh_refcnt;      /* number of users                   */
282 /*
283  * We want hh_output, hh_len, hh_lock and hh_data be a in a separate
284  * cache line on SMP.
285  * They are mostly read, but hh_refcnt may be changed quite frequently,
286  * incurring cache line ping pongs.
287  */
288         __be16          hh_type ____cacheline_aligned_in_smp;
289                                         /* protocol identifier, f.e ETH_P_IP
290                                          *  NOTE:  For VLANs, this will be the
291                                          *  encapuslated type. --BLG
292                                          */
293         u16             hh_len;         /* length of header */
294         int             (*hh_output)(struct sk_buff *skb);
295         seqlock_t       hh_lock;
296
297         /* cached hardware header; allow for machine alignment needs.        */
298 #define HH_DATA_MOD     16
299 #define HH_DATA_OFF(__len) \
300         (HH_DATA_MOD - (((__len - 1) & (HH_DATA_MOD - 1)) + 1))
301 #define HH_DATA_ALIGN(__len) \
302         (((__len)+(HH_DATA_MOD-1))&~(HH_DATA_MOD - 1))
303         unsigned long   hh_data[HH_DATA_ALIGN(LL_MAX_HEADER) / sizeof(long)];
304 };
305
306 /* Reserve HH_DATA_MOD byte aligned hard_header_len, but at least that much.
307  * Alternative is:
308  *   dev->hard_header_len ? (dev->hard_header_len +
309  *                           (HH_DATA_MOD - 1)) & ~(HH_DATA_MOD - 1) : 0
310  *
311  * We could use other alignment values, but we must maintain the
312  * relationship HH alignment <= LL alignment.
313  *
314  * LL_ALLOCATED_SPACE also takes into account the tailroom the device
315  * may need.
316  */
317 #define LL_RESERVED_SPACE(dev) \
318         ((((dev)->hard_header_len+(dev)->needed_headroom)&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
319 #define LL_RESERVED_SPACE_EXTRA(dev,extra) \
320         ((((dev)->hard_header_len+(dev)->needed_headroom+(extra))&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
321 #define LL_ALLOCATED_SPACE(dev) \
322         ((((dev)->hard_header_len+(dev)->needed_headroom+(dev)->needed_tailroom)&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
323
324 struct header_ops {
325         int     (*create) (struct sk_buff *skb, struct net_device *dev,
326                            unsigned short type, const void *daddr,
327                            const void *saddr, unsigned len);
328         int     (*parse)(const struct sk_buff *skb, unsigned char *haddr);
329         int     (*rebuild)(struct sk_buff *skb);
330 #define HAVE_HEADER_CACHE
331         int     (*cache)(const struct neighbour *neigh, struct hh_cache *hh);
332         void    (*cache_update)(struct hh_cache *hh,
333                                 const struct net_device *dev,
334                                 const unsigned char *haddr);
335 };
336
337 /* These flag bits are private to the generic network queueing
338  * layer, they may not be explicitly referenced by any other
339  * code.
340  */
341
342 enum netdev_state_t {
343         __LINK_STATE_START,
344         __LINK_STATE_PRESENT,
345         __LINK_STATE_NOCARRIER,
346         __LINK_STATE_LINKWATCH_PENDING,
347         __LINK_STATE_DORMANT,
348 };
349
350
351 /*
352  * This structure holds at boot time configured netdevice settings. They
353  * are then used in the device probing.
354  */
355 struct netdev_boot_setup {
356         char name[IFNAMSIZ];
357         struct ifmap map;
358 };
359 #define NETDEV_BOOT_SETUP_MAX 8
360
361 extern int __init netdev_boot_setup(char *str);
362
363 /*
364  * Structure for NAPI scheduling similar to tasklet but with weighting
365  */
366 struct napi_struct {
367         /* The poll_list must only be managed by the entity which
368          * changes the state of the NAPI_STATE_SCHED bit.  This means
369          * whoever atomically sets that bit can add this napi_struct
370          * to the per-cpu poll_list, and whoever clears that bit
371          * can remove from the list right before clearing the bit.
372          */
373         struct list_head        poll_list;
374
375         unsigned long           state;
376         int                     weight;
377         int                     (*poll)(struct napi_struct *, int);
378 #ifdef CONFIG_NETPOLL
379         spinlock_t              poll_lock;
380         int                     poll_owner;
381 #endif
382
383         unsigned int            gro_count;
384
385         struct net_device       *dev;
386         struct list_head        dev_list;
387         struct sk_buff          *gro_list;
388         struct sk_buff          *skb;
389 };
390
391 enum {
392         NAPI_STATE_SCHED,       /* Poll is scheduled */
393         NAPI_STATE_DISABLE,     /* Disable pending */
394         NAPI_STATE_NPSVC,       /* Netpoll - don't dequeue from poll_list */
395 };
396
397 enum gro_result {
398         GRO_MERGED,
399         GRO_MERGED_FREE,
400         GRO_HELD,
401         GRO_NORMAL,
402         GRO_DROP,
403 };
404 typedef enum gro_result gro_result_t;
405
406 extern void __napi_schedule(struct napi_struct *n);
407
408 static inline int napi_disable_pending(struct napi_struct *n)
409 {
410         return test_bit(NAPI_STATE_DISABLE, &n->state);
411 }
412
413 /**
414  *      napi_schedule_prep - check if napi can be scheduled
415  *      @n: napi context
416  *
417  * Test if NAPI routine is already running, and if not mark
418  * it as running.  This is used as a condition variable
419  * insure only one NAPI poll instance runs.  We also make
420  * sure there is no pending NAPI disable.
421  */
422 static inline int napi_schedule_prep(struct napi_struct *n)
423 {
424         return !napi_disable_pending(n) &&
425                 !test_and_set_bit(NAPI_STATE_SCHED, &n->state);
426 }
427
428 /**
429  *      napi_schedule - schedule NAPI poll
430  *      @n: napi context
431  *
432  * Schedule NAPI poll routine to be called if it is not already
433  * running.
434  */
435 static inline void napi_schedule(struct napi_struct *n)
436 {
437         if (napi_schedule_prep(n))
438                 __napi_schedule(n);
439 }
440
441 /* Try to reschedule poll. Called by dev->poll() after napi_complete().  */
442 static inline int napi_reschedule(struct napi_struct *napi)
443 {
444         if (napi_schedule_prep(napi)) {
445                 __napi_schedule(napi);
446                 return 1;
447         }
448         return 0;
449 }
450
451 /**
452  *      napi_complete - NAPI processing complete
453  *      @n: napi context
454  *
455  * Mark NAPI processing as complete.
456  */
457 extern void __napi_complete(struct napi_struct *n);
458 extern void napi_complete(struct napi_struct *n);
459
460 /**
461  *      napi_disable - prevent NAPI from scheduling
462  *      @n: napi context
463  *
464  * Stop NAPI from being scheduled on this context.
465  * Waits till any outstanding processing completes.
466  */
467 static inline void napi_disable(struct napi_struct *n)
468 {
469         set_bit(NAPI_STATE_DISABLE, &n->state);
470         while (test_and_set_bit(NAPI_STATE_SCHED, &n->state))
471                 msleep(1);
472         clear_bit(NAPI_STATE_DISABLE, &n->state);
473 }
474
475 /**
476  *      napi_enable - enable NAPI scheduling
477  *      @n: napi context
478  *
479  * Resume NAPI from being scheduled on this context.
480  * Must be paired with napi_disable.
481  */
482 static inline void napi_enable(struct napi_struct *n)
483 {
484         BUG_ON(!test_bit(NAPI_STATE_SCHED, &n->state));
485         smp_mb__before_clear_bit();
486         clear_bit(NAPI_STATE_SCHED, &n->state);
487 }
488
489 #ifdef CONFIG_SMP
490 /**
491  *      napi_synchronize - wait until NAPI is not running
492  *      @n: napi context
493  *
494  * Wait until NAPI is done being scheduled on this context.
495  * Waits till any outstanding processing completes but
496  * does not disable future activations.
497  */
498 static inline void napi_synchronize(const struct napi_struct *n)
499 {
500         while (test_bit(NAPI_STATE_SCHED, &n->state))
501                 msleep(1);
502 }
503 #else
504 # define napi_synchronize(n)    barrier()
505 #endif
506
507 enum netdev_queue_state_t {
508         __QUEUE_STATE_XOFF,
509         __QUEUE_STATE_FROZEN,
510 };
511
512 struct netdev_queue {
513 /*
514  * read mostly part
515  */
516         struct net_device       *dev;
517         struct Qdisc            *qdisc;
518         unsigned long           state;
519         struct Qdisc            *qdisc_sleeping;
520 /*
521  * write mostly part
522  */
523         spinlock_t              _xmit_lock ____cacheline_aligned_in_smp;
524         int                     xmit_lock_owner;
525         /*
526          * please use this field instead of dev->trans_start
527          */
528         unsigned long           trans_start;
529         unsigned long           tx_bytes;
530         unsigned long           tx_packets;
531         unsigned long           tx_dropped;
532 } ____cacheline_aligned_in_smp;
533
534
535 /*
536  * This structure defines the management hooks for network devices.
537  * The following hooks can be defined; unless noted otherwise, they are
538  * optional and can be filled with a null pointer.
539  *
540  * int (*ndo_init)(struct net_device *dev);
541  *     This function is called once when network device is registered.
542  *     The network device can use this to any late stage initializaton
543  *     or semantic validattion. It can fail with an error code which will
544  *     be propogated back to register_netdev
545  *
546  * void (*ndo_uninit)(struct net_device *dev);
547  *     This function is called when device is unregistered or when registration
548  *     fails. It is not called if init fails.
549  *
550  * int (*ndo_open)(struct net_device *dev);
551  *     This function is called when network device transistions to the up
552  *     state.
553  *
554  * int (*ndo_stop)(struct net_device *dev);
555  *     This function is called when network device transistions to the down
556  *     state.
557  *
558  * netdev_tx_t (*ndo_start_xmit)(struct sk_buff *skb,
559  *                               struct net_device *dev);
560  *      Called when a packet needs to be transmitted.
561  *      Must return NETDEV_TX_OK , NETDEV_TX_BUSY.
562  *        (can also return NETDEV_TX_LOCKED iff NETIF_F_LLTX)
563  *      Required can not be NULL.
564  *
565  * u16 (*ndo_select_queue)(struct net_device *dev, struct sk_buff *skb);
566  *      Called to decide which queue to when device supports multiple
567  *      transmit queues.
568  *
569  * void (*ndo_change_rx_flags)(struct net_device *dev, int flags);
570  *      This function is called to allow device receiver to make
571  *      changes to configuration when multicast or promiscious is enabled.
572  *
573  * void (*ndo_set_rx_mode)(struct net_device *dev);
574  *      This function is called device changes address list filtering.
575  *
576  * void (*ndo_set_multicast_list)(struct net_device *dev);
577  *      This function is called when the multicast address list changes.
578  *
579  * int (*ndo_set_mac_address)(struct net_device *dev, void *addr);
580  *      This function  is called when the Media Access Control address
581  *      needs to be changed. If this interface is not defined, the
582  *      mac address can not be changed.
583  *
584  * int (*ndo_validate_addr)(struct net_device *dev);
585  *      Test if Media Access Control address is valid for the device.
586  *
587  * int (*ndo_do_ioctl)(struct net_device *dev, struct ifreq *ifr, int cmd);
588  *      Called when a user request an ioctl which can't be handled by
589  *      the generic interface code. If not defined ioctl's return
590  *      not supported error code.
591  *
592  * int (*ndo_set_config)(struct net_device *dev, struct ifmap *map);
593  *      Used to set network devices bus interface parameters. This interface
594  *      is retained for legacy reason, new devices should use the bus
595  *      interface (PCI) for low level management.
596  *
597  * int (*ndo_change_mtu)(struct net_device *dev, int new_mtu);
598  *      Called when a user wants to change the Maximum Transfer Unit
599  *      of a device. If not defined, any request to change MTU will
600  *      will return an error.
601  *
602  * void (*ndo_tx_timeout)(struct net_device *dev);
603  *      Callback uses when the transmitter has not made any progress
604  *      for dev->watchdog ticks.
605  *
606  * struct net_device_stats* (*ndo_get_stats)(struct net_device *dev);
607  *      Called when a user wants to get the network device usage
608  *      statistics. If not defined, the counters in dev->stats will
609  *      be used.
610  *
611  * void (*ndo_vlan_rx_register)(struct net_device *dev, struct vlan_group *grp);
612  *      If device support VLAN receive accleration
613  *      (ie. dev->features & NETIF_F_HW_VLAN_RX), then this function is called
614  *      when vlan groups for the device changes.  Note: grp is NULL
615  *      if no vlan's groups are being used.
616  *
617  * void (*ndo_vlan_rx_add_vid)(struct net_device *dev, unsigned short vid);
618  *      If device support VLAN filtering (dev->features & NETIF_F_HW_VLAN_FILTER)
619  *      this function is called when a VLAN id is registered.
620  *
621  * void (*ndo_vlan_rx_kill_vid)(struct net_device *dev, unsigned short vid);
622  *      If device support VLAN filtering (dev->features & NETIF_F_HW_VLAN_FILTER)
623  *      this function is called when a VLAN id is unregistered.
624  *
625  * void (*ndo_poll_controller)(struct net_device *dev);
626  *
627  *      SR-IOV management functions.
628  * int (*ndo_set_vf_mac)(struct net_device *dev, int vf, u8* mac);
629  * int (*ndo_set_vf_vlan)(struct net_device *dev, int vf, u16 vlan, u8 qos);
630  * int (*ndo_set_vf_tx_rate)(struct net_device *dev, int vf, int rate);
631  * int (*ndo_get_vf_config)(struct net_device *dev,
632  *                          int vf, struct ifla_vf_info *ivf);
633  */
634 #define HAVE_NET_DEVICE_OPS
635 struct net_device_ops {
636         int                     (*ndo_init)(struct net_device *dev);
637         void                    (*ndo_uninit)(struct net_device *dev);
638         int                     (*ndo_open)(struct net_device *dev);
639         int                     (*ndo_stop)(struct net_device *dev);
640         netdev_tx_t             (*ndo_start_xmit) (struct sk_buff *skb,
641                                                    struct net_device *dev);
642         u16                     (*ndo_select_queue)(struct net_device *dev,
643                                                     struct sk_buff *skb);
644         void                    (*ndo_change_rx_flags)(struct net_device *dev,
645                                                        int flags);
646         void                    (*ndo_set_rx_mode)(struct net_device *dev);
647         void                    (*ndo_set_multicast_list)(struct net_device *dev);
648         int                     (*ndo_set_mac_address)(struct net_device *dev,
649                                                        void *addr);
650         int                     (*ndo_validate_addr)(struct net_device *dev);
651         int                     (*ndo_do_ioctl)(struct net_device *dev,
652                                                 struct ifreq *ifr, int cmd);
653         int                     (*ndo_set_config)(struct net_device *dev,
654                                                   struct ifmap *map);
655         int                     (*ndo_change_mtu)(struct net_device *dev,
656                                                   int new_mtu);
657         int                     (*ndo_neigh_setup)(struct net_device *dev,
658                                                    struct neigh_parms *);
659         void                    (*ndo_tx_timeout) (struct net_device *dev);
660
661         struct net_device_stats* (*ndo_get_stats)(struct net_device *dev);
662
663         void                    (*ndo_vlan_rx_register)(struct net_device *dev,
664                                                         struct vlan_group *grp);
665         void                    (*ndo_vlan_rx_add_vid)(struct net_device *dev,
666                                                        unsigned short vid);
667         void                    (*ndo_vlan_rx_kill_vid)(struct net_device *dev,
668                                                         unsigned short vid);
669 #ifdef CONFIG_NET_POLL_CONTROLLER
670         void                    (*ndo_poll_controller)(struct net_device *dev);
671 #endif
672         int                     (*ndo_set_vf_mac)(struct net_device *dev,
673                                                   int queue, u8 *mac);
674         int                     (*ndo_set_vf_vlan)(struct net_device *dev,
675                                                    int queue, u16 vlan, u8 qos);
676         int                     (*ndo_set_vf_tx_rate)(struct net_device *dev,
677                                                       int vf, int rate);
678         int                     (*ndo_get_vf_config)(struct net_device *dev,
679                                                      int vf,
680                                                      struct ifla_vf_info *ivf);
681 #if defined(CONFIG_FCOE) || defined(CONFIG_FCOE_MODULE)
682         int                     (*ndo_fcoe_enable)(struct net_device *dev);
683         int                     (*ndo_fcoe_disable)(struct net_device *dev);
684         int                     (*ndo_fcoe_ddp_setup)(struct net_device *dev,
685                                                       u16 xid,
686                                                       struct scatterlist *sgl,
687                                                       unsigned int sgc);
688         int                     (*ndo_fcoe_ddp_done)(struct net_device *dev,
689                                                      u16 xid);
690 #define NETDEV_FCOE_WWNN 0
691 #define NETDEV_FCOE_WWPN 1
692         int                     (*ndo_fcoe_get_wwn)(struct net_device *dev,
693                                                     u64 *wwn, int type);
694 #endif
695 };
696
697 /*
698  *      The DEVICE structure.
699  *      Actually, this whole structure is a big mistake.  It mixes I/O
700  *      data with strictly "high-level" data, and it has to know about
701  *      almost every data structure used in the INET module.
702  *
703  *      FIXME: cleanup struct net_device such that network protocol info
704  *      moves out.
705  */
706
707 struct net_device {
708
709         /*
710          * This is the first field of the "visible" part of this structure
711          * (i.e. as seen by users in the "Space.c" file).  It is the name
712          * the interface.
713          */
714         char                    name[IFNAMSIZ];
715
716         struct pm_qos_request_list *pm_qos_req;
717
718         /* device name hash chain */
719         struct hlist_node       name_hlist;
720         /* snmp alias */
721         char                    *ifalias;
722
723         /*
724          *      I/O specific fields
725          *      FIXME: Merge these and struct ifmap into one
726          */
727         unsigned long           mem_end;        /* shared mem end       */
728         unsigned long           mem_start;      /* shared mem start     */
729         unsigned long           base_addr;      /* device I/O address   */
730         unsigned int            irq;            /* device IRQ number    */
731
732         /*
733          *      Some hardware also needs these fields, but they are not
734          *      part of the usual set specified in Space.c.
735          */
736
737         unsigned char           if_port;        /* Selectable AUI, TP,..*/
738         unsigned char           dma;            /* DMA channel          */
739
740         unsigned long           state;
741
742         struct list_head        dev_list;
743         struct list_head        napi_list;
744         struct list_head        unreg_list;
745
746         /* Net device features */
747         unsigned long           features;
748 #define NETIF_F_SG              1       /* Scatter/gather IO. */
749 #define NETIF_F_IP_CSUM         2       /* Can checksum TCP/UDP over IPv4. */
750 #define NETIF_F_NO_CSUM         4       /* Does not require checksum. F.e. loopack. */
751 #define NETIF_F_HW_CSUM         8       /* Can checksum all the packets. */
752 #define NETIF_F_IPV6_CSUM       16      /* Can checksum TCP/UDP over IPV6 */
753 #define NETIF_F_HIGHDMA         32      /* Can DMA to high memory. */
754 #define NETIF_F_FRAGLIST        64      /* Scatter/gather IO. */
755 #define NETIF_F_HW_VLAN_TX      128     /* Transmit VLAN hw acceleration */
756 #define NETIF_F_HW_VLAN_RX      256     /* Receive VLAN hw acceleration */
757 #define NETIF_F_HW_VLAN_FILTER  512     /* Receive filtering on VLAN */
758 #define NETIF_F_VLAN_CHALLENGED 1024    /* Device cannot handle VLAN packets */
759 #define NETIF_F_GSO             2048    /* Enable software GSO. */
760 #define NETIF_F_LLTX            4096    /* LockLess TX - deprecated. Please */
761                                         /* do not use LLTX in new drivers */
762 #define NETIF_F_NETNS_LOCAL     8192    /* Does not change network namespaces */
763 #define NETIF_F_GRO             16384   /* Generic receive offload */
764 #define NETIF_F_LRO             32768   /* large receive offload */
765
766 /* the GSO_MASK reserves bits 16 through 23 */
767 #define NETIF_F_FCOE_CRC        (1 << 24) /* FCoE CRC32 */
768 #define NETIF_F_SCTP_CSUM       (1 << 25) /* SCTP checksum offload */
769 #define NETIF_F_FCOE_MTU        (1 << 26) /* Supports max FCoE MTU, 2158 bytes*/
770 #define NETIF_F_NTUPLE          (1 << 27) /* N-tuple filters supported */
771
772         /* Segmentation offload features */
773 #define NETIF_F_GSO_SHIFT       16
774 #define NETIF_F_GSO_MASK        0x00ff0000
775 #define NETIF_F_TSO             (SKB_GSO_TCPV4 << NETIF_F_GSO_SHIFT)
776 #define NETIF_F_UFO             (SKB_GSO_UDP << NETIF_F_GSO_SHIFT)
777 #define NETIF_F_GSO_ROBUST      (SKB_GSO_DODGY << NETIF_F_GSO_SHIFT)
778 #define NETIF_F_TSO_ECN         (SKB_GSO_TCP_ECN << NETIF_F_GSO_SHIFT)
779 #define NETIF_F_TSO6            (SKB_GSO_TCPV6 << NETIF_F_GSO_SHIFT)
780 #define NETIF_F_FSO             (SKB_GSO_FCOE << NETIF_F_GSO_SHIFT)
781
782         /* List of features with software fallbacks. */
783 #define NETIF_F_GSO_SOFTWARE    (NETIF_F_TSO | NETIF_F_TSO_ECN | NETIF_F_TSO6)
784
785
786 #define NETIF_F_GEN_CSUM        (NETIF_F_NO_CSUM | NETIF_F_HW_CSUM)
787 #define NETIF_F_V4_CSUM         (NETIF_F_GEN_CSUM | NETIF_F_IP_CSUM)
788 #define NETIF_F_V6_CSUM         (NETIF_F_GEN_CSUM | NETIF_F_IPV6_CSUM)
789 #define NETIF_F_ALL_CSUM        (NETIF_F_V4_CSUM | NETIF_F_V6_CSUM)
790
791         /*
792          * If one device supports one of these features, then enable them
793          * for all in netdev_increment_features.
794          */
795 #define NETIF_F_ONE_FOR_ALL     (NETIF_F_GSO_SOFTWARE | NETIF_F_GSO_ROBUST | \
796                                  NETIF_F_SG | NETIF_F_HIGHDMA |         \
797                                  NETIF_F_FRAGLIST)
798
799         /* Interface index. Unique device identifier    */
800         int                     ifindex;
801         int                     iflink;
802
803         struct net_device_stats stats;
804
805 #ifdef CONFIG_WIRELESS_EXT
806         /* List of functions to handle Wireless Extensions (instead of ioctl).
807          * See <net/iw_handler.h> for details. Jean II */
808         const struct iw_handler_def *   wireless_handlers;
809         /* Instance data managed by the core of Wireless Extensions. */
810         struct iw_public_data * wireless_data;
811 #endif
812         /* Management operations */
813         const struct net_device_ops *netdev_ops;
814         const struct ethtool_ops *ethtool_ops;
815
816         /* Hardware header description */
817         const struct header_ops *header_ops;
818
819         unsigned int            flags;  /* interface flags (a la BSD)   */
820         unsigned short          gflags;
821         unsigned short          priv_flags; /* Like 'flags' but invisible to userspace. */
822         unsigned short          padded; /* How much padding added by alloc_netdev() */
823
824         unsigned char           operstate; /* RFC2863 operstate */
825         unsigned char           link_mode; /* mapping policy to operstate */
826
827         unsigned                mtu;    /* interface MTU value          */
828         unsigned short          type;   /* interface hardware type      */
829         unsigned short          hard_header_len;        /* hardware hdr length  */
830
831         /* extra head- and tailroom the hardware may need, but not in all cases
832          * can this be guaranteed, especially tailroom. Some cases also use
833          * LL_MAX_HEADER instead to allocate the skb.
834          */
835         unsigned short          needed_headroom;
836         unsigned short          needed_tailroom;
837
838         struct net_device       *master; /* Pointer to master device of a group,
839                                           * which this device is member of.
840                                           */
841
842         /* Interface address info. */
843         unsigned char           perm_addr[MAX_ADDR_LEN]; /* permanent hw address */
844         unsigned char           addr_len;       /* hardware address length      */
845         unsigned short          dev_id;         /* for shared network cards */
846
847         struct netdev_hw_addr_list      uc;     /* Secondary unicast
848                                                    mac addresses */
849         int                     uc_promisc;
850         spinlock_t              addr_list_lock;
851         struct dev_addr_list    *mc_list;       /* Multicast mac addresses      */
852         int                     mc_count;       /* Number of installed mcasts   */
853         unsigned int            promiscuity;
854         unsigned int            allmulti;
855
856
857         /* Protocol specific pointers */
858         
859 #ifdef CONFIG_NET_DSA
860         void                    *dsa_ptr;       /* dsa specific data */
861 #endif
862         void                    *atalk_ptr;     /* AppleTalk link       */
863         void                    *ip_ptr;        /* IPv4 specific data   */
864         void                    *dn_ptr;        /* DECnet specific data */
865         void                    *ip6_ptr;       /* IPv6 specific data */
866         void                    *ec_ptr;        /* Econet specific data */
867         void                    *ax25_ptr;      /* AX.25 specific data */
868         struct wireless_dev     *ieee80211_ptr; /* IEEE 802.11 specific data,
869                                                    assign before registering */
870
871 /*
872  * Cache line mostly used on receive path (including eth_type_trans())
873  */
874         unsigned long           last_rx;        /* Time of last Rx      */
875         /* Interface address info used in eth_type_trans() */
876         unsigned char           *dev_addr;      /* hw address, (before bcast
877                                                    because most packets are
878                                                    unicast) */
879
880         struct netdev_hw_addr_list      dev_addrs; /* list of device
881                                                       hw addresses */
882
883         unsigned char           broadcast[MAX_ADDR_LEN];        /* hw bcast add */
884
885         struct netdev_queue     rx_queue;
886
887         struct netdev_queue     *_tx ____cacheline_aligned_in_smp;
888
889         /* Number of TX queues allocated at alloc_netdev_mq() time  */
890         unsigned int            num_tx_queues;
891
892         /* Number of TX queues currently active in device  */
893         unsigned int            real_num_tx_queues;
894
895         /* root qdisc from userspace point of view */
896         struct Qdisc            *qdisc;
897
898         unsigned long           tx_queue_len;   /* Max frames per queue allowed */
899         spinlock_t              tx_global_lock;
900 /*
901  * One part is mostly used on xmit path (device)
902  */
903         /* These may be needed for future network-power-down code. */
904
905         /*
906          * trans_start here is expensive for high speed devices on SMP,
907          * please use netdev_queue->trans_start instead.
908          */
909         unsigned long           trans_start;    /* Time (in jiffies) of last Tx */
910
911         int                     watchdog_timeo; /* used by dev_watchdog() */
912         struct timer_list       watchdog_timer;
913
914         /* Number of references to this device */
915         atomic_t                refcnt ____cacheline_aligned_in_smp;
916
917         /* delayed register/unregister */
918         struct list_head        todo_list;
919         /* device index hash chain */
920         struct hlist_node       index_hlist;
921
922         struct list_head        link_watch_list;
923
924         /* register/unregister state machine */
925         enum { NETREG_UNINITIALIZED=0,
926                NETREG_REGISTERED,       /* completed register_netdevice */
927                NETREG_UNREGISTERING,    /* called unregister_netdevice */
928                NETREG_UNREGISTERED,     /* completed unregister todo */
929                NETREG_RELEASED,         /* called free_netdev */
930                NETREG_DUMMY,            /* dummy device for NAPI poll */
931         } reg_state:16;
932
933         enum {
934                 RTNL_LINK_INITIALIZED,
935                 RTNL_LINK_INITIALIZING,
936         } rtnl_link_state:16;
937
938         /* Called from unregister, can be used to call free_netdev */
939         void (*destructor)(struct net_device *dev);
940
941 #ifdef CONFIG_NETPOLL
942         struct netpoll_info     *npinfo;
943 #endif
944
945 #ifdef CONFIG_NET_NS
946         /* Network namespace this network device is inside */
947         struct net              *nd_net;
948 #endif
949
950         /* mid-layer private */
951         void                    *ml_priv;
952
953         /* bridge stuff */
954         struct net_bridge_port  *br_port;
955         /* macvlan */
956         struct macvlan_port     *macvlan_port;
957         /* GARP */
958         struct garp_port        *garp_port;
959
960         /* class/net/name entry */
961         struct device           dev;
962         /* space for optional device, statistics, and wireless sysfs groups */
963         const struct attribute_group *sysfs_groups[4];
964
965         /* rtnetlink link ops */
966         const struct rtnl_link_ops *rtnl_link_ops;
967
968         /* VLAN feature mask */
969         unsigned long vlan_features;
970
971         /* for setting kernel sock attribute on TCP connection setup */
972 #define GSO_MAX_SIZE            65536
973         unsigned int            gso_max_size;
974
975 #ifdef CONFIG_DCB
976         /* Data Center Bridging netlink ops */
977         const struct dcbnl_rtnl_ops *dcbnl_ops;
978 #endif
979
980 #if defined(CONFIG_FCOE) || defined(CONFIG_FCOE_MODULE)
981         /* max exchange id for FCoE LRO by ddp */
982         unsigned int            fcoe_ddp_xid;
983 #endif
984         /* n-tuple filter list attached to this device */
985         struct ethtool_rx_ntuple_list ethtool_ntuple_list;
986 };
987 #define to_net_dev(d) container_of(d, struct net_device, dev)
988
989 #define NETDEV_ALIGN            32
990
991 static inline
992 struct netdev_queue *netdev_get_tx_queue(const struct net_device *dev,
993                                          unsigned int index)
994 {
995         return &dev->_tx[index];
996 }
997
998 static inline void netdev_for_each_tx_queue(struct net_device *dev,
999                                             void (*f)(struct net_device *,
1000                                                       struct netdev_queue *,
1001                                                       void *),
1002                                             void *arg)
1003 {
1004         unsigned int i;
1005
1006         for (i = 0; i < dev->num_tx_queues; i++)
1007                 f(dev, &dev->_tx[i], arg);
1008 }
1009
1010 /*
1011  * Net namespace inlines
1012  */
1013 static inline
1014 struct net *dev_net(const struct net_device *dev)
1015 {
1016 #ifdef CONFIG_NET_NS
1017         return dev->nd_net;
1018 #else
1019         return &init_net;
1020 #endif
1021 }
1022
1023 static inline
1024 void dev_net_set(struct net_device *dev, struct net *net)
1025 {
1026 #ifdef CONFIG_NET_NS
1027         release_net(dev->nd_net);
1028         dev->nd_net = hold_net(net);
1029 #endif
1030 }
1031
1032 static inline bool netdev_uses_dsa_tags(struct net_device *dev)
1033 {
1034 #ifdef CONFIG_NET_DSA_TAG_DSA
1035         if (dev->dsa_ptr != NULL)
1036                 return dsa_uses_dsa_tags(dev->dsa_ptr);
1037 #endif
1038
1039         return 0;
1040 }
1041
1042 #ifndef CONFIG_NET_NS
1043 static inline void skb_set_dev(struct sk_buff *skb, struct net_device *dev)
1044 {
1045         skb->dev = dev;
1046 }
1047 #else /* CONFIG_NET_NS */
1048 void skb_set_dev(struct sk_buff *skb, struct net_device *dev);
1049 #endif
1050
1051 static inline bool netdev_uses_trailer_tags(struct net_device *dev)
1052 {
1053 #ifdef CONFIG_NET_DSA_TAG_TRAILER
1054         if (dev->dsa_ptr != NULL)
1055                 return dsa_uses_trailer_tags(dev->dsa_ptr);
1056 #endif
1057
1058         return 0;
1059 }
1060
1061 /**
1062  *      netdev_priv - access network device private data
1063  *      @dev: network device
1064  *
1065  * Get network device private data
1066  */
1067 static inline void *netdev_priv(const struct net_device *dev)
1068 {
1069         return (char *)dev + ALIGN(sizeof(struct net_device), NETDEV_ALIGN);
1070 }
1071
1072 /* Set the sysfs physical device reference for the network logical device
1073  * if set prior to registration will cause a symlink during initialization.
1074  */
1075 #define SET_NETDEV_DEV(net, pdev)       ((net)->dev.parent = (pdev))
1076
1077 /* Set the sysfs device type for the network logical device to allow
1078  * fin grained indentification of different network device types. For
1079  * example Ethernet, Wirelss LAN, Bluetooth, WiMAX etc.
1080  */
1081 #define SET_NETDEV_DEVTYPE(net, devtype)        ((net)->dev.type = (devtype))
1082
1083 /**
1084  *      netif_napi_add - initialize a napi context
1085  *      @dev:  network device
1086  *      @napi: napi context
1087  *      @poll: polling function
1088  *      @weight: default weight
1089  *
1090  * netif_napi_add() must be used to initialize a napi context prior to calling
1091  * *any* of the other napi related functions.
1092  */
1093 void netif_napi_add(struct net_device *dev, struct napi_struct *napi,
1094                     int (*poll)(struct napi_struct *, int), int weight);
1095
1096 /**
1097  *  netif_napi_del - remove a napi context
1098  *  @napi: napi context
1099  *
1100  *  netif_napi_del() removes a napi context from the network device napi list
1101  */
1102 void netif_napi_del(struct napi_struct *napi);
1103
1104 struct napi_gro_cb {
1105         /* Virtual address of skb_shinfo(skb)->frags[0].page + offset. */
1106         void *frag0;
1107
1108         /* Length of frag0. */
1109         unsigned int frag0_len;
1110
1111         /* This indicates where we are processing relative to skb->data. */
1112         int data_offset;
1113
1114         /* This is non-zero if the packet may be of the same flow. */
1115         int same_flow;
1116
1117         /* This is non-zero if the packet cannot be merged with the new skb. */
1118         int flush;
1119
1120         /* Number of segments aggregated. */
1121         int count;
1122
1123         /* Free the skb? */
1124         int free;
1125 };
1126
1127 #define NAPI_GRO_CB(skb) ((struct napi_gro_cb *)(skb)->cb)
1128
1129 struct packet_type {
1130         __be16                  type;   /* This is really htons(ether_type). */
1131         struct net_device       *dev;   /* NULL is wildcarded here           */
1132         int                     (*func) (struct sk_buff *,
1133                                          struct net_device *,
1134                                          struct packet_type *,
1135                                          struct net_device *);
1136         struct sk_buff          *(*gso_segment)(struct sk_buff *skb,
1137                                                 int features);
1138         int                     (*gso_send_check)(struct sk_buff *skb);
1139         struct sk_buff          **(*gro_receive)(struct sk_buff **head,
1140                                                struct sk_buff *skb);
1141         int                     (*gro_complete)(struct sk_buff *skb);
1142         void                    *af_packet_priv;
1143         struct list_head        list;
1144 };
1145
1146 #include <linux/interrupt.h>
1147 #include <linux/notifier.h>
1148
1149 extern rwlock_t                         dev_base_lock;          /* Device list lock */
1150
1151
1152 #define for_each_netdev(net, d)         \
1153                 list_for_each_entry(d, &(net)->dev_base_head, dev_list)
1154 #define for_each_netdev_reverse(net, d) \
1155                 list_for_each_entry_reverse(d, &(net)->dev_base_head, dev_list)
1156 #define for_each_netdev_rcu(net, d)             \
1157                 list_for_each_entry_rcu(d, &(net)->dev_base_head, dev_list)
1158 #define for_each_netdev_safe(net, d, n) \
1159                 list_for_each_entry_safe(d, n, &(net)->dev_base_head, dev_list)
1160 #define for_each_netdev_continue(net, d)                \
1161                 list_for_each_entry_continue(d, &(net)->dev_base_head, dev_list)
1162 #define for_each_netdev_continue_rcu(net, d)            \
1163         list_for_each_entry_continue_rcu(d, &(net)->dev_base_head, dev_list)
1164 #define net_device_entry(lh)    list_entry(lh, struct net_device, dev_list)
1165
1166 static inline struct net_device *next_net_device(struct net_device *dev)
1167 {
1168         struct list_head *lh;
1169         struct net *net;
1170
1171         net = dev_net(dev);
1172         lh = dev->dev_list.next;
1173         return lh == &net->dev_base_head ? NULL : net_device_entry(lh);
1174 }
1175
1176 static inline struct net_device *next_net_device_rcu(struct net_device *dev)
1177 {
1178         struct list_head *lh;
1179         struct net *net;
1180
1181         net = dev_net(dev);
1182         lh = rcu_dereference(dev->dev_list.next);
1183         return lh == &net->dev_base_head ? NULL : net_device_entry(lh);
1184 }
1185
1186 static inline struct net_device *first_net_device(struct net *net)
1187 {
1188         return list_empty(&net->dev_base_head) ? NULL :
1189                 net_device_entry(net->dev_base_head.next);
1190 }
1191
1192 extern int                      netdev_boot_setup_check(struct net_device *dev);
1193 extern unsigned long            netdev_boot_base(const char *prefix, int unit);
1194 extern struct net_device    *dev_getbyhwaddr(struct net *net, unsigned short type, char *hwaddr);
1195 extern struct net_device *dev_getfirstbyhwtype(struct net *net, unsigned short type);
1196 extern struct net_device *__dev_getfirstbyhwtype(struct net *net, unsigned short type);
1197 extern void             dev_add_pack(struct packet_type *pt);
1198 extern void             dev_remove_pack(struct packet_type *pt);
1199 extern void             __dev_remove_pack(struct packet_type *pt);
1200
1201 extern struct net_device        *dev_get_by_flags(struct net *net, unsigned short flags,
1202                                                   unsigned short mask);
1203 extern struct net_device        *dev_get_by_name(struct net *net, const char *name);
1204 extern struct net_device        *dev_get_by_name_rcu(struct net *net, const char *name);
1205 extern struct net_device        *__dev_get_by_name(struct net *net, const char *name);
1206 extern int              dev_alloc_name(struct net_device *dev, const char *name);
1207 extern int              dev_open(struct net_device *dev);
1208 extern int              dev_close(struct net_device *dev);
1209 extern void             dev_disable_lro(struct net_device *dev);
1210 extern int              dev_queue_xmit(struct sk_buff *skb);
1211 extern int              register_netdevice(struct net_device *dev);
1212 extern void             unregister_netdevice_queue(struct net_device *dev,
1213                                                    struct list_head *head);
1214 extern void             unregister_netdevice_many(struct list_head *head);
1215 static inline void unregister_netdevice(struct net_device *dev)
1216 {
1217         unregister_netdevice_queue(dev, NULL);
1218 }
1219
1220 extern void             free_netdev(struct net_device *dev);
1221 extern void             synchronize_net(void);
1222 extern int              register_netdevice_notifier(struct notifier_block *nb);
1223 extern int              unregister_netdevice_notifier(struct notifier_block *nb);
1224 extern int              init_dummy_netdev(struct net_device *dev);
1225 extern void             netdev_resync_ops(struct net_device *dev);
1226
1227 extern int call_netdevice_notifiers(unsigned long val, struct net_device *dev);
1228 extern struct net_device        *dev_get_by_index(struct net *net, int ifindex);
1229 extern struct net_device        *__dev_get_by_index(struct net *net, int ifindex);
1230 extern struct net_device        *dev_get_by_index_rcu(struct net *net, int ifindex);
1231 extern int              dev_restart(struct net_device *dev);
1232 #ifdef CONFIG_NETPOLL_TRAP
1233 extern int              netpoll_trap(void);
1234 #endif
1235 extern int             skb_gro_receive(struct sk_buff **head,
1236                                        struct sk_buff *skb);
1237 extern void            skb_gro_reset_offset(struct sk_buff *skb);
1238
1239 static inline unsigned int skb_gro_offset(const struct sk_buff *skb)
1240 {
1241         return NAPI_GRO_CB(skb)->data_offset;
1242 }
1243
1244 static inline unsigned int skb_gro_len(const struct sk_buff *skb)
1245 {
1246         return skb->len - NAPI_GRO_CB(skb)->data_offset;
1247 }
1248
1249 static inline void skb_gro_pull(struct sk_buff *skb, unsigned int len)
1250 {
1251         NAPI_GRO_CB(skb)->data_offset += len;
1252 }
1253
1254 static inline void *skb_gro_header_fast(struct sk_buff *skb,
1255                                         unsigned int offset)
1256 {
1257         return NAPI_GRO_CB(skb)->frag0 + offset;
1258 }
1259
1260 static inline int skb_gro_header_hard(struct sk_buff *skb, unsigned int hlen)
1261 {
1262         return NAPI_GRO_CB(skb)->frag0_len < hlen;
1263 }
1264
1265 static inline void *skb_gro_header_slow(struct sk_buff *skb, unsigned int hlen,
1266                                         unsigned int offset)
1267 {
1268         NAPI_GRO_CB(skb)->frag0 = NULL;
1269         NAPI_GRO_CB(skb)->frag0_len = 0;
1270         return pskb_may_pull(skb, hlen) ? skb->data + offset : NULL;
1271 }
1272
1273 static inline void *skb_gro_mac_header(struct sk_buff *skb)
1274 {
1275         return NAPI_GRO_CB(skb)->frag0 ?: skb_mac_header(skb);
1276 }
1277
1278 static inline void *skb_gro_network_header(struct sk_buff *skb)
1279 {
1280         return (NAPI_GRO_CB(skb)->frag0 ?: skb->data) +
1281                skb_network_offset(skb);
1282 }
1283
1284 static inline int dev_hard_header(struct sk_buff *skb, struct net_device *dev,
1285                                   unsigned short type,
1286                                   const void *daddr, const void *saddr,
1287                                   unsigned len)
1288 {
1289         if (!dev->header_ops || !dev->header_ops->create)
1290                 return 0;
1291
1292         return dev->header_ops->create(skb, dev, type, daddr, saddr, len);
1293 }
1294
1295 static inline int dev_parse_header(const struct sk_buff *skb,
1296                                    unsigned char *haddr)
1297 {
1298         const struct net_device *dev = skb->dev;
1299
1300         if (!dev->header_ops || !dev->header_ops->parse)
1301                 return 0;
1302         return dev->header_ops->parse(skb, haddr);
1303 }
1304
1305 typedef int gifconf_func_t(struct net_device * dev, char __user * bufptr, int len);
1306 extern int              register_gifconf(unsigned int family, gifconf_func_t * gifconf);
1307 static inline int unregister_gifconf(unsigned int family)
1308 {
1309         return register_gifconf(family, NULL);
1310 }
1311
1312 /*
1313  * Incoming packets are placed on per-cpu queues so that
1314  * no locking is needed.
1315  */
1316 struct softnet_data {
1317         struct Qdisc            *output_queue;
1318         struct sk_buff_head     input_pkt_queue;
1319         struct list_head        poll_list;
1320         struct sk_buff          *completion_queue;
1321
1322         struct napi_struct      backlog;
1323 };
1324
1325 DECLARE_PER_CPU(struct softnet_data,softnet_data);
1326
1327 #define HAVE_NETIF_QUEUE
1328
1329 extern void __netif_schedule(struct Qdisc *q);
1330
1331 static inline void netif_schedule_queue(struct netdev_queue *txq)
1332 {
1333         if (!test_bit(__QUEUE_STATE_XOFF, &txq->state))
1334                 __netif_schedule(txq->qdisc);
1335 }
1336
1337 static inline void netif_tx_schedule_all(struct net_device *dev)
1338 {
1339         unsigned int i;
1340
1341         for (i = 0; i < dev->num_tx_queues; i++)
1342                 netif_schedule_queue(netdev_get_tx_queue(dev, i));
1343 }
1344
1345 static inline void netif_tx_start_queue(struct netdev_queue *dev_queue)
1346 {
1347         clear_bit(__QUEUE_STATE_XOFF, &dev_queue->state);
1348 }
1349
1350 /**
1351  *      netif_start_queue - allow transmit
1352  *      @dev: network device
1353  *
1354  *      Allow upper layers to call the device hard_start_xmit routine.
1355  */
1356 static inline void netif_start_queue(struct net_device *dev)
1357 {
1358         netif_tx_start_queue(netdev_get_tx_queue(dev, 0));
1359 }
1360
1361 static inline void netif_tx_start_all_queues(struct net_device *dev)
1362 {
1363         unsigned int i;
1364
1365         for (i = 0; i < dev->num_tx_queues; i++) {
1366                 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
1367                 netif_tx_start_queue(txq);
1368         }
1369 }
1370
1371 static inline void netif_tx_wake_queue(struct netdev_queue *dev_queue)
1372 {
1373 #ifdef CONFIG_NETPOLL_TRAP
1374         if (netpoll_trap()) {
1375                 netif_tx_start_queue(dev_queue);
1376                 return;
1377         }
1378 #endif
1379         if (test_and_clear_bit(__QUEUE_STATE_XOFF, &dev_queue->state))
1380                 __netif_schedule(dev_queue->qdisc);
1381 }
1382
1383 /**
1384  *      netif_wake_queue - restart transmit
1385  *      @dev: network device
1386  *
1387  *      Allow upper layers to call the device hard_start_xmit routine.
1388  *      Used for flow control when transmit resources are available.
1389  */
1390 static inline void netif_wake_queue(struct net_device *dev)
1391 {
1392         netif_tx_wake_queue(netdev_get_tx_queue(dev, 0));
1393 }
1394
1395 static inline void netif_tx_wake_all_queues(struct net_device *dev)
1396 {
1397         unsigned int i;
1398
1399         for (i = 0; i < dev->num_tx_queues; i++) {
1400                 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
1401                 netif_tx_wake_queue(txq);
1402         }
1403 }
1404
1405 static inline void netif_tx_stop_queue(struct netdev_queue *dev_queue)
1406 {
1407         set_bit(__QUEUE_STATE_XOFF, &dev_queue->state);
1408 }
1409
1410 /**
1411  *      netif_stop_queue - stop transmitted packets
1412  *      @dev: network device
1413  *
1414  *      Stop upper layers calling the device hard_start_xmit routine.
1415  *      Used for flow control when transmit resources are unavailable.
1416  */
1417 static inline void netif_stop_queue(struct net_device *dev)
1418 {
1419         netif_tx_stop_queue(netdev_get_tx_queue(dev, 0));
1420 }
1421
1422 static inline void netif_tx_stop_all_queues(struct net_device *dev)
1423 {
1424         unsigned int i;
1425
1426         for (i = 0; i < dev->num_tx_queues; i++) {
1427                 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
1428                 netif_tx_stop_queue(txq);
1429         }
1430 }
1431
1432 static inline int netif_tx_queue_stopped(const struct netdev_queue *dev_queue)
1433 {
1434         return test_bit(__QUEUE_STATE_XOFF, &dev_queue->state);
1435 }
1436
1437 /**
1438  *      netif_queue_stopped - test if transmit queue is flowblocked
1439  *      @dev: network device
1440  *
1441  *      Test if transmit queue on device is currently unable to send.
1442  */
1443 static inline int netif_queue_stopped(const struct net_device *dev)
1444 {
1445         return netif_tx_queue_stopped(netdev_get_tx_queue(dev, 0));
1446 }
1447
1448 static inline int netif_tx_queue_frozen(const struct netdev_queue *dev_queue)
1449 {
1450         return test_bit(__QUEUE_STATE_FROZEN, &dev_queue->state);
1451 }
1452
1453 /**
1454  *      netif_running - test if up
1455  *      @dev: network device
1456  *
1457  *      Test if the device has been brought up.
1458  */
1459 static inline int netif_running(const struct net_device *dev)
1460 {
1461         return test_bit(__LINK_STATE_START, &dev->state);
1462 }
1463
1464 /*
1465  * Routines to manage the subqueues on a device.  We only need start
1466  * stop, and a check if it's stopped.  All other device management is
1467  * done at the overall netdevice level.
1468  * Also test the device if we're multiqueue.
1469  */
1470
1471 /**
1472  *      netif_start_subqueue - allow sending packets on subqueue
1473  *      @dev: network device
1474  *      @queue_index: sub queue index
1475  *
1476  * Start individual transmit queue of a device with multiple transmit queues.
1477  */
1478 static inline void netif_start_subqueue(struct net_device *dev, u16 queue_index)
1479 {
1480         struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index);
1481
1482         netif_tx_start_queue(txq);
1483 }
1484
1485 /**
1486  *      netif_stop_subqueue - stop sending packets on subqueue
1487  *      @dev: network device
1488  *      @queue_index: sub queue index
1489  *
1490  * Stop individual transmit queue of a device with multiple transmit queues.
1491  */
1492 static inline void netif_stop_subqueue(struct net_device *dev, u16 queue_index)
1493 {
1494         struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index);
1495 #ifdef CONFIG_NETPOLL_TRAP
1496         if (netpoll_trap())
1497                 return;
1498 #endif
1499         netif_tx_stop_queue(txq);
1500 }
1501
1502 /**
1503  *      netif_subqueue_stopped - test status of subqueue
1504  *      @dev: network device
1505  *      @queue_index: sub queue index
1506  *
1507  * Check individual transmit queue of a device with multiple transmit queues.
1508  */
1509 static inline int __netif_subqueue_stopped(const struct net_device *dev,
1510                                          u16 queue_index)
1511 {
1512         struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index);
1513
1514         return netif_tx_queue_stopped(txq);
1515 }
1516
1517 static inline int netif_subqueue_stopped(const struct net_device *dev,
1518                                          struct sk_buff *skb)
1519 {
1520         return __netif_subqueue_stopped(dev, skb_get_queue_mapping(skb));
1521 }
1522
1523 /**
1524  *      netif_wake_subqueue - allow sending packets on subqueue
1525  *      @dev: network device
1526  *      @queue_index: sub queue index
1527  *
1528  * Resume individual transmit queue of a device with multiple transmit queues.
1529  */
1530 static inline void netif_wake_subqueue(struct net_device *dev, u16 queue_index)
1531 {
1532         struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index);
1533 #ifdef CONFIG_NETPOLL_TRAP
1534         if (netpoll_trap())
1535                 return;
1536 #endif
1537         if (test_and_clear_bit(__QUEUE_STATE_XOFF, &txq->state))
1538                 __netif_schedule(txq->qdisc);
1539 }
1540
1541 /**
1542  *      netif_is_multiqueue - test if device has multiple transmit queues
1543  *      @dev: network device
1544  *
1545  * Check if device has multiple transmit queues
1546  */
1547 static inline int netif_is_multiqueue(const struct net_device *dev)
1548 {
1549         return (dev->num_tx_queues > 1);
1550 }
1551
1552 /* Use this variant when it is known for sure that it
1553  * is executing from hardware interrupt context or with hardware interrupts
1554  * disabled.
1555  */
1556 extern void dev_kfree_skb_irq(struct sk_buff *skb);
1557
1558 /* Use this variant in places where it could be invoked
1559  * from either hardware interrupt or other context, with hardware interrupts
1560  * either disabled or enabled.
1561  */
1562 extern void dev_kfree_skb_any(struct sk_buff *skb);
1563
1564 #define HAVE_NETIF_RX 1
1565 extern int              netif_rx(struct sk_buff *skb);
1566 extern int              netif_rx_ni(struct sk_buff *skb);
1567 #define HAVE_NETIF_RECEIVE_SKB 1
1568 extern int              netif_receive_skb(struct sk_buff *skb);
1569 extern gro_result_t     dev_gro_receive(struct napi_struct *napi,
1570                                         struct sk_buff *skb);
1571 extern gro_result_t     napi_skb_finish(gro_result_t ret, struct sk_buff *skb);
1572 extern gro_result_t     napi_gro_receive(struct napi_struct *napi,
1573                                          struct sk_buff *skb);
1574 extern void             napi_reuse_skb(struct napi_struct *napi,
1575                                        struct sk_buff *skb);
1576 extern struct sk_buff * napi_get_frags(struct napi_struct *napi);
1577 extern gro_result_t     napi_frags_finish(struct napi_struct *napi,
1578                                           struct sk_buff *skb,
1579                                           gro_result_t ret);
1580 extern struct sk_buff * napi_frags_skb(struct napi_struct *napi);
1581 extern gro_result_t     napi_gro_frags(struct napi_struct *napi);
1582
1583 static inline void napi_free_frags(struct napi_struct *napi)
1584 {
1585         kfree_skb(napi->skb);
1586         napi->skb = NULL;
1587 }
1588
1589 extern void             netif_nit_deliver(struct sk_buff *skb);
1590 extern int              dev_valid_name(const char *name);
1591 extern int              dev_ioctl(struct net *net, unsigned int cmd, void __user *);
1592 extern int              dev_ethtool(struct net *net, struct ifreq *);
1593 extern unsigned         dev_get_flags(const struct net_device *);
1594 extern int              __dev_change_flags(struct net_device *, unsigned int flags);
1595 extern int              dev_change_flags(struct net_device *, unsigned);
1596 extern void             __dev_notify_flags(struct net_device *, unsigned int old_flags);
1597 extern int              dev_change_name(struct net_device *, const char *);
1598 extern int              dev_set_alias(struct net_device *, const char *, size_t);
1599 extern int              dev_change_net_namespace(struct net_device *,
1600                                                  struct net *, const char *);
1601 extern int              dev_set_mtu(struct net_device *, int);
1602 extern int              dev_set_mac_address(struct net_device *,
1603                                             struct sockaddr *);
1604 extern int              dev_hard_start_xmit(struct sk_buff *skb,
1605                                             struct net_device *dev,
1606                                             struct netdev_queue *txq);
1607 extern int              dev_forward_skb(struct net_device *dev,
1608                                         struct sk_buff *skb);
1609
1610 extern int              netdev_budget;
1611
1612 /* Called by rtnetlink.c:rtnl_unlock() */
1613 extern void netdev_run_todo(void);
1614
1615 /**
1616  *      dev_put - release reference to device
1617  *      @dev: network device
1618  *
1619  * Release reference to device to allow it to be freed.
1620  */
1621 static inline void dev_put(struct net_device *dev)
1622 {
1623         atomic_dec(&dev->refcnt);
1624 }
1625
1626 /**
1627  *      dev_hold - get reference to device
1628  *      @dev: network device
1629  *
1630  * Hold reference to device to keep it from being freed.
1631  */
1632 static inline void dev_hold(struct net_device *dev)
1633 {
1634         atomic_inc(&dev->refcnt);
1635 }
1636
1637 /* Carrier loss detection, dial on demand. The functions netif_carrier_on
1638  * and _off may be called from IRQ context, but it is caller
1639  * who is responsible for serialization of these calls.
1640  *
1641  * The name carrier is inappropriate, these functions should really be
1642  * called netif_lowerlayer_*() because they represent the state of any
1643  * kind of lower layer not just hardware media.
1644  */
1645
1646 extern void linkwatch_fire_event(struct net_device *dev);
1647 extern void linkwatch_forget_dev(struct net_device *dev);
1648
1649 /**
1650  *      netif_carrier_ok - test if carrier present
1651  *      @dev: network device
1652  *
1653  * Check if carrier is present on device
1654  */
1655 static inline int netif_carrier_ok(const struct net_device *dev)
1656 {
1657         return !test_bit(__LINK_STATE_NOCARRIER, &dev->state);
1658 }
1659
1660 extern unsigned long dev_trans_start(struct net_device *dev);
1661
1662 extern void __netdev_watchdog_up(struct net_device *dev);
1663
1664 extern void netif_carrier_on(struct net_device *dev);
1665
1666 extern void netif_carrier_off(struct net_device *dev);
1667
1668 /**
1669  *      netif_dormant_on - mark device as dormant.
1670  *      @dev: network device
1671  *
1672  * Mark device as dormant (as per RFC2863).
1673  *
1674  * The dormant state indicates that the relevant interface is not
1675  * actually in a condition to pass packets (i.e., it is not 'up') but is
1676  * in a "pending" state, waiting for some external event.  For "on-
1677  * demand" interfaces, this new state identifies the situation where the
1678  * interface is waiting for events to place it in the up state.
1679  *
1680  */
1681 static inline void netif_dormant_on(struct net_device *dev)
1682 {
1683         if (!test_and_set_bit(__LINK_STATE_DORMANT, &dev->state))
1684                 linkwatch_fire_event(dev);
1685 }
1686
1687 /**
1688  *      netif_dormant_off - set device as not dormant.
1689  *      @dev: network device
1690  *
1691  * Device is not in dormant state.
1692  */
1693 static inline void netif_dormant_off(struct net_device *dev)
1694 {
1695         if (test_and_clear_bit(__LINK_STATE_DORMANT, &dev->state))
1696                 linkwatch_fire_event(dev);
1697 }
1698
1699 /**
1700  *      netif_dormant - test if carrier present
1701  *      @dev: network device
1702  *
1703  * Check if carrier is present on device
1704  */
1705 static inline int netif_dormant(const struct net_device *dev)
1706 {
1707         return test_bit(__LINK_STATE_DORMANT, &dev->state);
1708 }
1709
1710
1711 /**
1712  *      netif_oper_up - test if device is operational
1713  *      @dev: network device
1714  *
1715  * Check if carrier is operational
1716  */
1717 static inline int netif_oper_up(const struct net_device *dev)
1718 {
1719         return (dev->operstate == IF_OPER_UP ||
1720                 dev->operstate == IF_OPER_UNKNOWN /* backward compat */);
1721 }
1722
1723 /**
1724  *      netif_device_present - is device available or removed
1725  *      @dev: network device
1726  *
1727  * Check if device has not been removed from system.
1728  */
1729 static inline int netif_device_present(struct net_device *dev)
1730 {
1731         return test_bit(__LINK_STATE_PRESENT, &dev->state);
1732 }
1733
1734 extern void netif_device_detach(struct net_device *dev);
1735
1736 extern void netif_device_attach(struct net_device *dev);
1737
1738 /*
1739  * Network interface message level settings
1740  */
1741 #define HAVE_NETIF_MSG 1
1742
1743 enum {
1744         NETIF_MSG_DRV           = 0x0001,
1745         NETIF_MSG_PROBE         = 0x0002,
1746         NETIF_MSG_LINK          = 0x0004,
1747         NETIF_MSG_TIMER         = 0x0008,
1748         NETIF_MSG_IFDOWN        = 0x0010,
1749         NETIF_MSG_IFUP          = 0x0020,
1750         NETIF_MSG_RX_ERR        = 0x0040,
1751         NETIF_MSG_TX_ERR        = 0x0080,
1752         NETIF_MSG_TX_QUEUED     = 0x0100,
1753         NETIF_MSG_INTR          = 0x0200,
1754         NETIF_MSG_TX_DONE       = 0x0400,
1755         NETIF_MSG_RX_STATUS     = 0x0800,
1756         NETIF_MSG_PKTDATA       = 0x1000,
1757         NETIF_MSG_HW            = 0x2000,
1758         NETIF_MSG_WOL           = 0x4000,
1759 };
1760
1761 #define netif_msg_drv(p)        ((p)->msg_enable & NETIF_MSG_DRV)
1762 #define netif_msg_probe(p)      ((p)->msg_enable & NETIF_MSG_PROBE)
1763 #define netif_msg_link(p)       ((p)->msg_enable & NETIF_MSG_LINK)
1764 #define netif_msg_timer(p)      ((p)->msg_enable & NETIF_MSG_TIMER)
1765 #define netif_msg_ifdown(p)     ((p)->msg_enable & NETIF_MSG_IFDOWN)
1766 #define netif_msg_ifup(p)       ((p)->msg_enable & NETIF_MSG_IFUP)
1767 #define netif_msg_rx_err(p)     ((p)->msg_enable & NETIF_MSG_RX_ERR)
1768 #define netif_msg_tx_err(p)     ((p)->msg_enable & NETIF_MSG_TX_ERR)
1769 #define netif_msg_tx_queued(p)  ((p)->msg_enable & NETIF_MSG_TX_QUEUED)
1770 #define netif_msg_intr(p)       ((p)->msg_enable & NETIF_MSG_INTR)
1771 #define netif_msg_tx_done(p)    ((p)->msg_enable & NETIF_MSG_TX_DONE)
1772 #define netif_msg_rx_status(p)  ((p)->msg_enable & NETIF_MSG_RX_STATUS)
1773 #define netif_msg_pktdata(p)    ((p)->msg_enable & NETIF_MSG_PKTDATA)
1774 #define netif_msg_hw(p)         ((p)->msg_enable & NETIF_MSG_HW)
1775 #define netif_msg_wol(p)        ((p)->msg_enable & NETIF_MSG_WOL)
1776
1777 static inline u32 netif_msg_init(int debug_value, int default_msg_enable_bits)
1778 {
1779         /* use default */
1780         if (debug_value < 0 || debug_value >= (sizeof(u32) * 8))
1781                 return default_msg_enable_bits;
1782         if (debug_value == 0)   /* no output */
1783                 return 0;
1784         /* set low N bits */
1785         return (1 << debug_value) - 1;
1786 }
1787
1788 static inline void __netif_tx_lock(struct netdev_queue *txq, int cpu)
1789 {
1790         spin_lock(&txq->_xmit_lock);
1791         txq->xmit_lock_owner = cpu;
1792 }
1793
1794 static inline void __netif_tx_lock_bh(struct netdev_queue *txq)
1795 {
1796         spin_lock_bh(&txq->_xmit_lock);
1797         txq->xmit_lock_owner = smp_processor_id();
1798 }
1799
1800 static inline int __netif_tx_trylock(struct netdev_queue *txq)
1801 {
1802         int ok = spin_trylock(&txq->_xmit_lock);
1803         if (likely(ok))
1804                 txq->xmit_lock_owner = smp_processor_id();
1805         return ok;
1806 }
1807
1808 static inline void __netif_tx_unlock(struct netdev_queue *txq)
1809 {
1810         txq->xmit_lock_owner = -1;
1811         spin_unlock(&txq->_xmit_lock);
1812 }
1813
1814 static inline void __netif_tx_unlock_bh(struct netdev_queue *txq)
1815 {
1816         txq->xmit_lock_owner = -1;
1817         spin_unlock_bh(&txq->_xmit_lock);
1818 }
1819
1820 static inline void txq_trans_update(struct netdev_queue *txq)
1821 {
1822         if (txq->xmit_lock_owner != -1)
1823                 txq->trans_start = jiffies;
1824 }
1825
1826 /**
1827  *      netif_tx_lock - grab network device transmit lock
1828  *      @dev: network device
1829  *
1830  * Get network device transmit lock
1831  */
1832 static inline void netif_tx_lock(struct net_device *dev)
1833 {
1834         unsigned int i;
1835         int cpu;
1836
1837         spin_lock(&dev->tx_global_lock);
1838         cpu = smp_processor_id();
1839         for (i = 0; i < dev->num_tx_queues; i++) {
1840                 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
1841
1842                 /* We are the only thread of execution doing a
1843                  * freeze, but we have to grab the _xmit_lock in
1844                  * order to synchronize with threads which are in
1845                  * the ->hard_start_xmit() handler and already
1846                  * checked the frozen bit.
1847                  */
1848                 __netif_tx_lock(txq, cpu);
1849                 set_bit(__QUEUE_STATE_FROZEN, &txq->state);
1850                 __netif_tx_unlock(txq);
1851         }
1852 }
1853
1854 static inline void netif_tx_lock_bh(struct net_device *dev)
1855 {
1856         local_bh_disable();
1857         netif_tx_lock(dev);
1858 }
1859
1860 static inline void netif_tx_unlock(struct net_device *dev)
1861 {
1862         unsigned int i;
1863
1864         for (i = 0; i < dev->num_tx_queues; i++) {
1865                 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
1866
1867                 /* No need to grab the _xmit_lock here.  If the
1868                  * queue is not stopped for another reason, we
1869                  * force a schedule.
1870                  */
1871                 clear_bit(__QUEUE_STATE_FROZEN, &txq->state);
1872                 netif_schedule_queue(txq);
1873         }
1874         spin_unlock(&dev->tx_global_lock);
1875 }
1876
1877 static inline void netif_tx_unlock_bh(struct net_device *dev)
1878 {
1879         netif_tx_unlock(dev);
1880         local_bh_enable();
1881 }
1882
1883 #define HARD_TX_LOCK(dev, txq, cpu) {                   \
1884         if ((dev->features & NETIF_F_LLTX) == 0) {      \
1885                 __netif_tx_lock(txq, cpu);              \
1886         }                                               \
1887 }
1888
1889 #define HARD_TX_UNLOCK(dev, txq) {                      \
1890         if ((dev->features & NETIF_F_LLTX) == 0) {      \
1891                 __netif_tx_unlock(txq);                 \
1892         }                                               \
1893 }
1894
1895 static inline void netif_tx_disable(struct net_device *dev)
1896 {
1897         unsigned int i;
1898         int cpu;
1899
1900         local_bh_disable();
1901         cpu = smp_processor_id();
1902         for (i = 0; i < dev->num_tx_queues; i++) {
1903                 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
1904
1905                 __netif_tx_lock(txq, cpu);
1906                 netif_tx_stop_queue(txq);
1907                 __netif_tx_unlock(txq);
1908         }
1909         local_bh_enable();
1910 }
1911
1912 static inline void netif_addr_lock(struct net_device *dev)
1913 {
1914         spin_lock(&dev->addr_list_lock);
1915 }
1916
1917 static inline void netif_addr_lock_bh(struct net_device *dev)
1918 {
1919         spin_lock_bh(&dev->addr_list_lock);
1920 }
1921
1922 static inline void netif_addr_unlock(struct net_device *dev)
1923 {
1924         spin_unlock(&dev->addr_list_lock);
1925 }
1926
1927 static inline void netif_addr_unlock_bh(struct net_device *dev)
1928 {
1929         spin_unlock_bh(&dev->addr_list_lock);
1930 }
1931
1932 /*
1933  * dev_addrs walker. Should be used only for read access. Call with
1934  * rcu_read_lock held.
1935  */
1936 #define for_each_dev_addr(dev, ha) \
1937                 list_for_each_entry_rcu(ha, &dev->dev_addrs.list, list)
1938
1939 /* These functions live elsewhere (drivers/net/net_init.c, but related) */
1940
1941 extern void             ether_setup(struct net_device *dev);
1942
1943 /* Support for loadable net-drivers */
1944 extern struct net_device *alloc_netdev_mq(int sizeof_priv, const char *name,
1945                                        void (*setup)(struct net_device *),
1946                                        unsigned int queue_count);
1947 #define alloc_netdev(sizeof_priv, name, setup) \
1948         alloc_netdev_mq(sizeof_priv, name, setup, 1)
1949 extern int              register_netdev(struct net_device *dev);
1950 extern void             unregister_netdev(struct net_device *dev);
1951
1952 /* Functions used for device addresses handling */
1953 extern int dev_addr_add(struct net_device *dev, unsigned char *addr,
1954                         unsigned char addr_type);
1955 extern int dev_addr_del(struct net_device *dev, unsigned char *addr,
1956                         unsigned char addr_type);
1957 extern int dev_addr_add_multiple(struct net_device *to_dev,
1958                                  struct net_device *from_dev,
1959                                  unsigned char addr_type);
1960 extern int dev_addr_del_multiple(struct net_device *to_dev,
1961                                  struct net_device *from_dev,
1962                                  unsigned char addr_type);
1963
1964 /* Functions used for secondary unicast and multicast support */
1965 extern void             dev_set_rx_mode(struct net_device *dev);
1966 extern void             __dev_set_rx_mode(struct net_device *dev);
1967 extern int              dev_unicast_delete(struct net_device *dev, void *addr);
1968 extern int              dev_unicast_add(struct net_device *dev, void *addr);
1969 extern int              dev_unicast_sync(struct net_device *to, struct net_device *from);
1970 extern void             dev_unicast_unsync(struct net_device *to, struct net_device *from);
1971 extern int              dev_mc_delete(struct net_device *dev, void *addr, int alen, int all);
1972 extern int              dev_mc_add(struct net_device *dev, void *addr, int alen, int newonly);
1973 extern int              dev_mc_sync(struct net_device *to, struct net_device *from);
1974 extern void             dev_mc_unsync(struct net_device *to, struct net_device *from);
1975 extern int              __dev_addr_delete(struct dev_addr_list **list, int *count, void *addr, int alen, int all);
1976 extern int              __dev_addr_add(struct dev_addr_list **list, int *count, void *addr, int alen, int newonly);
1977 extern int              __dev_addr_sync(struct dev_addr_list **to, int *to_count, struct dev_addr_list **from, int *from_count);
1978 extern void             __dev_addr_unsync(struct dev_addr_list **to, int *to_count, struct dev_addr_list **from, int *from_count);
1979 extern int              dev_set_promiscuity(struct net_device *dev, int inc);
1980 extern int              dev_set_allmulti(struct net_device *dev, int inc);
1981 extern void             netdev_state_change(struct net_device *dev);
1982 extern void             netdev_bonding_change(struct net_device *dev,
1983                                               unsigned long event);
1984 extern void             netdev_features_change(struct net_device *dev);
1985 /* Load a device via the kmod */
1986 extern void             dev_load(struct net *net, const char *name);
1987 extern void             dev_mcast_init(void);
1988 extern const struct net_device_stats *dev_get_stats(struct net_device *dev);
1989 extern void             dev_txq_stats_fold(const struct net_device *dev, struct net_device_stats *stats);
1990
1991 extern int              netdev_max_backlog;
1992 extern int              weight_p;
1993 extern int              netdev_set_master(struct net_device *dev, struct net_device *master);
1994 extern int skb_checksum_help(struct sk_buff *skb);
1995 extern struct sk_buff *skb_gso_segment(struct sk_buff *skb, int features);
1996 #ifdef CONFIG_BUG
1997 extern void netdev_rx_csum_fault(struct net_device *dev);
1998 #else
1999 static inline void netdev_rx_csum_fault(struct net_device *dev)
2000 {
2001 }
2002 #endif
2003 /* rx skb timestamps */
2004 extern void             net_enable_timestamp(void);
2005 extern void             net_disable_timestamp(void);
2006
2007 #ifdef CONFIG_PROC_FS
2008 extern void *dev_seq_start(struct seq_file *seq, loff_t *pos);
2009 extern void *dev_seq_next(struct seq_file *seq, void *v, loff_t *pos);
2010 extern void dev_seq_stop(struct seq_file *seq, void *v);
2011 #endif
2012
2013 extern int netdev_class_create_file(struct class_attribute *class_attr);
2014 extern void netdev_class_remove_file(struct class_attribute *class_attr);
2015
2016 extern char *netdev_drivername(const struct net_device *dev, char *buffer, int len);
2017
2018 extern void linkwatch_run_queue(void);
2019
2020 unsigned long netdev_increment_features(unsigned long all, unsigned long one,
2021                                         unsigned long mask);
2022 unsigned long netdev_fix_features(unsigned long features, const char *name);
2023
2024 void netif_stacked_transfer_operstate(const struct net_device *rootdev,
2025                                         struct net_device *dev);
2026
2027 static inline int net_gso_ok(int features, int gso_type)
2028 {
2029         int feature = gso_type << NETIF_F_GSO_SHIFT;
2030         return (features & feature) == feature;
2031 }
2032
2033 static inline int skb_gso_ok(struct sk_buff *skb, int features)
2034 {
2035         return net_gso_ok(features, skb_shinfo(skb)->gso_type) &&
2036                (!skb_has_frags(skb) || (features & NETIF_F_FRAGLIST));
2037 }
2038
2039 static inline int netif_needs_gso(struct net_device *dev, struct sk_buff *skb)
2040 {
2041         return skb_is_gso(skb) &&
2042                (!skb_gso_ok(skb, dev->features) ||
2043                 unlikely(skb->ip_summed != CHECKSUM_PARTIAL));
2044 }
2045
2046 static inline void netif_set_gso_max_size(struct net_device *dev,
2047                                           unsigned int size)
2048 {
2049         dev->gso_max_size = size;
2050 }
2051
2052 static inline void skb_bond_set_mac_by_master(struct sk_buff *skb,
2053                                               struct net_device *master)
2054 {
2055         if (skb->pkt_type == PACKET_HOST) {
2056                 u16 *dest = (u16 *) eth_hdr(skb)->h_dest;
2057
2058                 memcpy(dest, master->dev_addr, ETH_ALEN);
2059         }
2060 }
2061
2062 /* On bonding slaves other than the currently active slave, suppress
2063  * duplicates except for 802.3ad ETH_P_SLOW, alb non-mcast/bcast, and
2064  * ARP on active-backup slaves with arp_validate enabled.
2065  */
2066 static inline int skb_bond_should_drop(struct sk_buff *skb,
2067                                        struct net_device *master)
2068 {
2069         if (master) {
2070                 struct net_device *dev = skb->dev;
2071
2072                 if (master->priv_flags & IFF_MASTER_ARPMON)
2073                         dev->last_rx = jiffies;
2074
2075                 if ((master->priv_flags & IFF_MASTER_ALB) && master->br_port) {
2076                         /* Do address unmangle. The local destination address
2077                          * will be always the one master has. Provides the right
2078                          * functionality in a bridge.
2079                          */
2080                         skb_bond_set_mac_by_master(skb, master);
2081                 }
2082
2083                 if (dev->priv_flags & IFF_SLAVE_INACTIVE) {
2084                         if ((dev->priv_flags & IFF_SLAVE_NEEDARP) &&
2085                             skb->protocol == __cpu_to_be16(ETH_P_ARP))
2086                                 return 0;
2087
2088                         if (master->priv_flags & IFF_MASTER_ALB) {
2089                                 if (skb->pkt_type != PACKET_BROADCAST &&
2090                                     skb->pkt_type != PACKET_MULTICAST)
2091                                         return 0;
2092                         }
2093                         if (master->priv_flags & IFF_MASTER_8023AD &&
2094                             skb->protocol == __cpu_to_be16(ETH_P_SLOW))
2095                                 return 0;
2096
2097                         return 1;
2098                 }
2099         }
2100         return 0;
2101 }
2102
2103 extern struct pernet_operations __net_initdata loopback_net_ops;
2104
2105 static inline int dev_ethtool_get_settings(struct net_device *dev,
2106                                            struct ethtool_cmd *cmd)
2107 {
2108         if (!dev->ethtool_ops || !dev->ethtool_ops->get_settings)
2109                 return -EOPNOTSUPP;
2110         return dev->ethtool_ops->get_settings(dev, cmd);
2111 }
2112
2113 static inline u32 dev_ethtool_get_rx_csum(struct net_device *dev)
2114 {
2115         if (!dev->ethtool_ops || !dev->ethtool_ops->get_rx_csum)
2116                 return 0;
2117         return dev->ethtool_ops->get_rx_csum(dev);
2118 }
2119
2120 static inline u32 dev_ethtool_get_flags(struct net_device *dev)
2121 {
2122         if (!dev->ethtool_ops || !dev->ethtool_ops->get_flags)
2123                 return 0;
2124         return dev->ethtool_ops->get_flags(dev);
2125 }
2126
2127 /* Logging, debugging and troubleshooting/diagnostic helpers. */
2128
2129 /* netdev_printk helpers, similar to dev_printk */
2130
2131 static inline const char *netdev_name(const struct net_device *dev)
2132 {
2133         if (dev->reg_state != NETREG_REGISTERED)
2134                 return "(unregistered net_device)";
2135         return dev->name;
2136 }
2137
2138 #define netdev_printk(level, netdev, format, args...)           \
2139         dev_printk(level, (netdev)->dev.parent,                 \
2140                    "%s: " format,                               \
2141                    netdev_name(netdev), ##args)
2142
2143 #define netdev_emerg(dev, format, args...)                      \
2144         netdev_printk(KERN_EMERG, dev, format, ##args)
2145 #define netdev_alert(dev, format, args...)                      \
2146         netdev_printk(KERN_ALERT, dev, format, ##args)
2147 #define netdev_crit(dev, format, args...)                       \
2148         netdev_printk(KERN_CRIT, dev, format, ##args)
2149 #define netdev_err(dev, format, args...)                        \
2150         netdev_printk(KERN_ERR, dev, format, ##args)
2151 #define netdev_warn(dev, format, args...)                       \
2152         netdev_printk(KERN_WARNING, dev, format, ##args)
2153 #define netdev_notice(dev, format, args...)                     \
2154         netdev_printk(KERN_NOTICE, dev, format, ##args)
2155 #define netdev_info(dev, format, args...)                       \
2156         netdev_printk(KERN_INFO, dev, format, ##args)
2157
2158 #if defined(DEBUG)
2159 #define netdev_dbg(__dev, format, args...)                      \
2160         netdev_printk(KERN_DEBUG, __dev, format, ##args)
2161 #elif defined(CONFIG_DYNAMIC_DEBUG)
2162 #define netdev_dbg(__dev, format, args...)                      \
2163 do {                                                            \
2164         dynamic_dev_dbg((__dev)->dev.parent, "%s: " format,     \
2165                         netdev_name(__dev), ##args);            \
2166 } while (0)
2167 #else
2168 #define netdev_dbg(__dev, format, args...)                      \
2169 ({                                                              \
2170         if (0)                                                  \
2171                 netdev_printk(KERN_DEBUG, __dev, format, ##args); \
2172         0;                                                      \
2173 })
2174 #endif
2175
2176 #if defined(VERBOSE_DEBUG)
2177 #define netdev_vdbg     netdev_dbg
2178 #else
2179
2180 #define netdev_vdbg(dev, format, args...)                       \
2181 ({                                                              \
2182         if (0)                                                  \
2183                 netdev_printk(KERN_DEBUG, dev, format, ##args); \
2184         0;                                                      \
2185 })
2186 #endif
2187
2188 /*
2189  * netdev_WARN() acts like dev_printk(), but with the key difference
2190  * of using a WARN/WARN_ON to get the message out, including the
2191  * file/line information and a backtrace.
2192  */
2193 #define netdev_WARN(dev, format, args...)                       \
2194         WARN(1, "netdevice: %s\n" format, netdev_name(dev), ##args);
2195
2196 /* netif printk helpers, similar to netdev_printk */
2197
2198 #define netif_printk(priv, type, level, dev, fmt, args...)      \
2199 do {                                                            \
2200         if (netif_msg_##type(priv))                             \
2201                 netdev_printk(level, (dev), fmt, ##args);       \
2202 } while (0)
2203
2204 #define netif_emerg(priv, type, dev, fmt, args...)              \
2205         netif_printk(priv, type, KERN_EMERG, dev, fmt, ##args)
2206 #define netif_alert(priv, type, dev, fmt, args...)              \
2207         netif_printk(priv, type, KERN_ALERT, dev, fmt, ##args)
2208 #define netif_crit(priv, type, dev, fmt, args...)               \
2209         netif_printk(priv, type, KERN_CRIT, dev, fmt, ##args)
2210 #define netif_err(priv, type, dev, fmt, args...)                \
2211         netif_printk(priv, type, KERN_ERR, dev, fmt, ##args)
2212 #define netif_warn(priv, type, dev, fmt, args...)               \
2213         netif_printk(priv, type, KERN_WARNING, dev, fmt, ##args)
2214 #define netif_notice(priv, type, dev, fmt, args...)             \
2215         netif_printk(priv, type, KERN_NOTICE, dev, fmt, ##args)
2216 #define netif_info(priv, type, dev, fmt, args...)               \
2217         netif_printk(priv, type, KERN_INFO, (dev), fmt, ##args)
2218
2219 #if defined(DEBUG)
2220 #define netif_dbg(priv, type, dev, format, args...)             \
2221         netif_printk(priv, type, KERN_DEBUG, dev, format, ##args)
2222 #elif defined(CONFIG_DYNAMIC_DEBUG)
2223 #define netif_dbg(priv, type, netdev, format, args...)          \
2224 do {                                                            \
2225         if (netif_msg_##type(priv))                             \
2226                 dynamic_dev_dbg((netdev)->dev.parent,           \
2227                                 "%s: " format,                  \
2228                                 netdev_name(netdev), ##args);   \
2229 } while (0)
2230 #else
2231 #define netif_dbg(priv, type, dev, format, args...)                     \
2232 ({                                                                      \
2233         if (0)                                                          \
2234                 netif_printk(priv, type, KERN_DEBUG, dev, format, ##args); \
2235         0;                                                              \
2236 })
2237 #endif
2238
2239 #if defined(VERBOSE_DEBUG)
2240 #define netif_vdbg      netdev_dbg
2241 #else
2242 #define netif_vdbg(priv, type, dev, format, args...)            \
2243 ({                                                              \
2244         if (0)                                                  \
2245                 netif_printk(KERN_DEBUG, dev, format, ##args);  \
2246         0;                                                      \
2247 })
2248 #endif
2249
2250 #endif /* __KERNEL__ */
2251
2252 #endif  /* _LINUX_NETDEVICE_H */