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