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