]> bbs.cooldavid.org Git - net-next-2.6.git/blame_incremental - include/linux/netdevice.h
bridge: add proper RCU annotation to should_route_hook
[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/*
507 * write mostly part
508 */
509 spinlock_t _xmit_lock ____cacheline_aligned_in_smp;
510 int xmit_lock_owner;
511 /*
512 * please use this field instead of dev->trans_start
513 */
514 unsigned long trans_start;
515 u64 tx_bytes;
516 u64 tx_packets;
517 u64 tx_dropped;
518} ____cacheline_aligned_in_smp;
519
520#ifdef CONFIG_RPS
521/*
522 * This structure holds an RPS map which can be of variable length. The
523 * map is an array of CPUs.
524 */
525struct rps_map {
526 unsigned int len;
527 struct rcu_head rcu;
528 u16 cpus[0];
529};
530#define RPS_MAP_SIZE(_num) (sizeof(struct rps_map) + (_num * sizeof(u16)))
531
532/*
533 * The rps_dev_flow structure contains the mapping of a flow to a CPU and the
534 * tail pointer for that CPU's input queue at the time of last enqueue.
535 */
536struct rps_dev_flow {
537 u16 cpu;
538 u16 fill;
539 unsigned int last_qtail;
540};
541
542/*
543 * The rps_dev_flow_table structure contains a table of flow mappings.
544 */
545struct rps_dev_flow_table {
546 unsigned int mask;
547 struct rcu_head rcu;
548 struct work_struct free_work;
549 struct rps_dev_flow flows[0];
550};
551#define RPS_DEV_FLOW_TABLE_SIZE(_num) (sizeof(struct rps_dev_flow_table) + \
552 (_num * sizeof(struct rps_dev_flow)))
553
554/*
555 * The rps_sock_flow_table contains mappings of flows to the last CPU
556 * on which they were processed by the application (set in recvmsg).
557 */
558struct rps_sock_flow_table {
559 unsigned int mask;
560 u16 ents[0];
561};
562#define RPS_SOCK_FLOW_TABLE_SIZE(_num) (sizeof(struct rps_sock_flow_table) + \
563 (_num * sizeof(u16)))
564
565#define RPS_NO_CPU 0xffff
566
567static inline void rps_record_sock_flow(struct rps_sock_flow_table *table,
568 u32 hash)
569{
570 if (table && hash) {
571 unsigned int cpu, index = hash & table->mask;
572
573 /* We only give a hint, preemption can change cpu under us */
574 cpu = raw_smp_processor_id();
575
576 if (table->ents[index] != cpu)
577 table->ents[index] = cpu;
578 }
579}
580
581static inline void rps_reset_sock_flow(struct rps_sock_flow_table *table,
582 u32 hash)
583{
584 if (table && hash)
585 table->ents[hash & table->mask] = RPS_NO_CPU;
586}
587
588extern struct rps_sock_flow_table __rcu *rps_sock_flow_table;
589
590/* This structure contains an instance of an RX queue. */
591struct netdev_rx_queue {
592 struct rps_map __rcu *rps_map;
593 struct rps_dev_flow_table __rcu *rps_flow_table;
594 struct kobject kobj;
595 struct net_device *dev;
596} ____cacheline_aligned_in_smp;
597#endif /* CONFIG_RPS */
598
599/*
600 * This structure defines the management hooks for network devices.
601 * The following hooks can be defined; unless noted otherwise, they are
602 * optional and can be filled with a null pointer.
603 *
604 * int (*ndo_init)(struct net_device *dev);
605 * This function is called once when network device is registered.
606 * The network device can use this to any late stage initializaton
607 * or semantic validattion. It can fail with an error code which will
608 * be propogated back to register_netdev
609 *
610 * void (*ndo_uninit)(struct net_device *dev);
611 * This function is called when device is unregistered or when registration
612 * fails. It is not called if init fails.
613 *
614 * int (*ndo_open)(struct net_device *dev);
615 * This function is called when network device transistions to the up
616 * state.
617 *
618 * int (*ndo_stop)(struct net_device *dev);
619 * This function is called when network device transistions to the down
620 * state.
621 *
622 * netdev_tx_t (*ndo_start_xmit)(struct sk_buff *skb,
623 * struct net_device *dev);
624 * Called when a packet needs to be transmitted.
625 * Must return NETDEV_TX_OK , NETDEV_TX_BUSY.
626 * (can also return NETDEV_TX_LOCKED iff NETIF_F_LLTX)
627 * Required can not be NULL.
628 *
629 * u16 (*ndo_select_queue)(struct net_device *dev, struct sk_buff *skb);
630 * Called to decide which queue to when device supports multiple
631 * transmit queues.
632 *
633 * void (*ndo_change_rx_flags)(struct net_device *dev, int flags);
634 * This function is called to allow device receiver to make
635 * changes to configuration when multicast or promiscious is enabled.
636 *
637 * void (*ndo_set_rx_mode)(struct net_device *dev);
638 * This function is called device changes address list filtering.
639 *
640 * void (*ndo_set_multicast_list)(struct net_device *dev);
641 * This function is called when the multicast address list changes.
642 *
643 * int (*ndo_set_mac_address)(struct net_device *dev, void *addr);
644 * This function is called when the Media Access Control address
645 * needs to be changed. If this interface is not defined, the
646 * mac address can not be changed.
647 *
648 * int (*ndo_validate_addr)(struct net_device *dev);
649 * Test if Media Access Control address is valid for the device.
650 *
651 * int (*ndo_do_ioctl)(struct net_device *dev, struct ifreq *ifr, int cmd);
652 * Called when a user request an ioctl which can't be handled by
653 * the generic interface code. If not defined ioctl's return
654 * not supported error code.
655 *
656 * int (*ndo_set_config)(struct net_device *dev, struct ifmap *map);
657 * Used to set network devices bus interface parameters. This interface
658 * is retained for legacy reason, new devices should use the bus
659 * interface (PCI) for low level management.
660 *
661 * int (*ndo_change_mtu)(struct net_device *dev, int new_mtu);
662 * Called when a user wants to change the Maximum Transfer Unit
663 * of a device. If not defined, any request to change MTU will
664 * will return an error.
665 *
666 * void (*ndo_tx_timeout)(struct net_device *dev);
667 * Callback uses when the transmitter has not made any progress
668 * for dev->watchdog ticks.
669 *
670 * struct rtnl_link_stats64* (*ndo_get_stats64)(struct net_device *dev,
671 * struct rtnl_link_stats64 *storage);
672 * struct net_device_stats* (*ndo_get_stats)(struct net_device *dev);
673 * Called when a user wants to get the network device usage
674 * statistics. Drivers must do one of the following:
675 * 1. Define @ndo_get_stats64 to fill in a zero-initialised
676 * rtnl_link_stats64 structure passed by the caller.
677 * 2. Define @ndo_get_stats to update a net_device_stats structure
678 * (which should normally be dev->stats) and return a pointer to
679 * it. The structure may be changed asynchronously only if each
680 * field is written atomically.
681 * 3. Update dev->stats asynchronously and atomically, and define
682 * neither operation.
683 *
684 * void (*ndo_vlan_rx_register)(struct net_device *dev, struct vlan_group *grp);
685 * If device support VLAN receive accleration
686 * (ie. dev->features & NETIF_F_HW_VLAN_RX), then this function is called
687 * when vlan groups for the device changes. Note: grp is NULL
688 * if no vlan's groups are being used.
689 *
690 * void (*ndo_vlan_rx_add_vid)(struct net_device *dev, unsigned short vid);
691 * If device support VLAN filtering (dev->features & NETIF_F_HW_VLAN_FILTER)
692 * this function is called when a VLAN id is registered.
693 *
694 * void (*ndo_vlan_rx_kill_vid)(struct net_device *dev, unsigned short vid);
695 * If device support VLAN filtering (dev->features & NETIF_F_HW_VLAN_FILTER)
696 * this function is called when a VLAN id is unregistered.
697 *
698 * void (*ndo_poll_controller)(struct net_device *dev);
699 *
700 * SR-IOV management functions.
701 * int (*ndo_set_vf_mac)(struct net_device *dev, int vf, u8* mac);
702 * int (*ndo_set_vf_vlan)(struct net_device *dev, int vf, u16 vlan, u8 qos);
703 * int (*ndo_set_vf_tx_rate)(struct net_device *dev, int vf, int rate);
704 * int (*ndo_get_vf_config)(struct net_device *dev,
705 * int vf, struct ifla_vf_info *ivf);
706 * int (*ndo_set_vf_port)(struct net_device *dev, int vf,
707 * struct nlattr *port[]);
708 * int (*ndo_get_vf_port)(struct net_device *dev, int vf, struct sk_buff *skb);
709 */
710#define HAVE_NET_DEVICE_OPS
711struct net_device_ops {
712 int (*ndo_init)(struct net_device *dev);
713 void (*ndo_uninit)(struct net_device *dev);
714 int (*ndo_open)(struct net_device *dev);
715 int (*ndo_stop)(struct net_device *dev);
716 netdev_tx_t (*ndo_start_xmit) (struct sk_buff *skb,
717 struct net_device *dev);
718 u16 (*ndo_select_queue)(struct net_device *dev,
719 struct sk_buff *skb);
720 void (*ndo_change_rx_flags)(struct net_device *dev,
721 int flags);
722 void (*ndo_set_rx_mode)(struct net_device *dev);
723 void (*ndo_set_multicast_list)(struct net_device *dev);
724 int (*ndo_set_mac_address)(struct net_device *dev,
725 void *addr);
726 int (*ndo_validate_addr)(struct net_device *dev);
727 int (*ndo_do_ioctl)(struct net_device *dev,
728 struct ifreq *ifr, int cmd);
729 int (*ndo_set_config)(struct net_device *dev,
730 struct ifmap *map);
731 int (*ndo_change_mtu)(struct net_device *dev,
732 int new_mtu);
733 int (*ndo_neigh_setup)(struct net_device *dev,
734 struct neigh_parms *);
735 void (*ndo_tx_timeout) (struct net_device *dev);
736
737 struct rtnl_link_stats64* (*ndo_get_stats64)(struct net_device *dev,
738 struct rtnl_link_stats64 *storage);
739 struct net_device_stats* (*ndo_get_stats)(struct net_device *dev);
740
741 void (*ndo_vlan_rx_register)(struct net_device *dev,
742 struct vlan_group *grp);
743 void (*ndo_vlan_rx_add_vid)(struct net_device *dev,
744 unsigned short vid);
745 void (*ndo_vlan_rx_kill_vid)(struct net_device *dev,
746 unsigned short vid);
747#ifdef CONFIG_NET_POLL_CONTROLLER
748 void (*ndo_poll_controller)(struct net_device *dev);
749 int (*ndo_netpoll_setup)(struct net_device *dev,
750 struct netpoll_info *info);
751 void (*ndo_netpoll_cleanup)(struct net_device *dev);
752#endif
753 int (*ndo_set_vf_mac)(struct net_device *dev,
754 int queue, u8 *mac);
755 int (*ndo_set_vf_vlan)(struct net_device *dev,
756 int queue, u16 vlan, u8 qos);
757 int (*ndo_set_vf_tx_rate)(struct net_device *dev,
758 int vf, int rate);
759 int (*ndo_get_vf_config)(struct net_device *dev,
760 int vf,
761 struct ifla_vf_info *ivf);
762 int (*ndo_set_vf_port)(struct net_device *dev,
763 int vf,
764 struct nlattr *port[]);
765 int (*ndo_get_vf_port)(struct net_device *dev,
766 int vf, struct sk_buff *skb);
767#if defined(CONFIG_FCOE) || defined(CONFIG_FCOE_MODULE)
768 int (*ndo_fcoe_enable)(struct net_device *dev);
769 int (*ndo_fcoe_disable)(struct net_device *dev);
770 int (*ndo_fcoe_ddp_setup)(struct net_device *dev,
771 u16 xid,
772 struct scatterlist *sgl,
773 unsigned int sgc);
774 int (*ndo_fcoe_ddp_done)(struct net_device *dev,
775 u16 xid);
776#define NETDEV_FCOE_WWNN 0
777#define NETDEV_FCOE_WWPN 1
778 int (*ndo_fcoe_get_wwn)(struct net_device *dev,
779 u64 *wwn, int type);
780#endif
781};
782
783/*
784 * The DEVICE structure.
785 * Actually, this whole structure is a big mistake. It mixes I/O
786 * data with strictly "high-level" data, and it has to know about
787 * almost every data structure used in the INET module.
788 *
789 * FIXME: cleanup struct net_device such that network protocol info
790 * moves out.
791 */
792
793struct net_device {
794
795 /*
796 * This is the first field of the "visible" part of this structure
797 * (i.e. as seen by users in the "Space.c" file). It is the name
798 * of the interface.
799 */
800 char name[IFNAMSIZ];
801
802 struct pm_qos_request_list pm_qos_req;
803
804 /* device name hash chain */
805 struct hlist_node name_hlist;
806 /* snmp alias */
807 char *ifalias;
808
809 /*
810 * I/O specific fields
811 * FIXME: Merge these and struct ifmap into one
812 */
813 unsigned long mem_end; /* shared mem end */
814 unsigned long mem_start; /* shared mem start */
815 unsigned long base_addr; /* device I/O address */
816 unsigned int irq; /* device IRQ number */
817
818 /*
819 * Some hardware also needs these fields, but they are not
820 * part of the usual set specified in Space.c.
821 */
822
823 unsigned char if_port; /* Selectable AUI, TP,..*/
824 unsigned char dma; /* DMA channel */
825
826 unsigned long state;
827
828 struct list_head dev_list;
829 struct list_head napi_list;
830 struct list_head unreg_list;
831
832 /* Net device features */
833 unsigned long features;
834#define NETIF_F_SG 1 /* Scatter/gather IO. */
835#define NETIF_F_IP_CSUM 2 /* Can checksum TCP/UDP over IPv4. */
836#define NETIF_F_NO_CSUM 4 /* Does not require checksum. F.e. loopack. */
837#define NETIF_F_HW_CSUM 8 /* Can checksum all the packets. */
838#define NETIF_F_IPV6_CSUM 16 /* Can checksum TCP/UDP over IPV6 */
839#define NETIF_F_HIGHDMA 32 /* Can DMA to high memory. */
840#define NETIF_F_FRAGLIST 64 /* Scatter/gather IO. */
841#define NETIF_F_HW_VLAN_TX 128 /* Transmit VLAN hw acceleration */
842#define NETIF_F_HW_VLAN_RX 256 /* Receive VLAN hw acceleration */
843#define NETIF_F_HW_VLAN_FILTER 512 /* Receive filtering on VLAN */
844#define NETIF_F_VLAN_CHALLENGED 1024 /* Device cannot handle VLAN packets */
845#define NETIF_F_GSO 2048 /* Enable software GSO. */
846#define NETIF_F_LLTX 4096 /* LockLess TX - deprecated. Please */
847 /* do not use LLTX in new drivers */
848#define NETIF_F_NETNS_LOCAL 8192 /* Does not change network namespaces */
849#define NETIF_F_GRO 16384 /* Generic receive offload */
850#define NETIF_F_LRO 32768 /* large receive offload */
851
852/* the GSO_MASK reserves bits 16 through 23 */
853#define NETIF_F_FCOE_CRC (1 << 24) /* FCoE CRC32 */
854#define NETIF_F_SCTP_CSUM (1 << 25) /* SCTP checksum offload */
855#define NETIF_F_FCOE_MTU (1 << 26) /* Supports max FCoE MTU, 2158 bytes*/
856#define NETIF_F_NTUPLE (1 << 27) /* N-tuple filters supported */
857#define NETIF_F_RXHASH (1 << 28) /* Receive hashing offload */
858
859 /* Segmentation offload features */
860#define NETIF_F_GSO_SHIFT 16
861#define NETIF_F_GSO_MASK 0x00ff0000
862#define NETIF_F_TSO (SKB_GSO_TCPV4 << NETIF_F_GSO_SHIFT)
863#define NETIF_F_UFO (SKB_GSO_UDP << NETIF_F_GSO_SHIFT)
864#define NETIF_F_GSO_ROBUST (SKB_GSO_DODGY << NETIF_F_GSO_SHIFT)
865#define NETIF_F_TSO_ECN (SKB_GSO_TCP_ECN << NETIF_F_GSO_SHIFT)
866#define NETIF_F_TSO6 (SKB_GSO_TCPV6 << NETIF_F_GSO_SHIFT)
867#define NETIF_F_FSO (SKB_GSO_FCOE << NETIF_F_GSO_SHIFT)
868
869 /* List of features with software fallbacks. */
870#define NETIF_F_GSO_SOFTWARE (NETIF_F_TSO | NETIF_F_TSO_ECN | \
871 NETIF_F_TSO6 | NETIF_F_UFO)
872
873
874#define NETIF_F_GEN_CSUM (NETIF_F_NO_CSUM | NETIF_F_HW_CSUM)
875#define NETIF_F_V4_CSUM (NETIF_F_GEN_CSUM | NETIF_F_IP_CSUM)
876#define NETIF_F_V6_CSUM (NETIF_F_GEN_CSUM | NETIF_F_IPV6_CSUM)
877#define NETIF_F_ALL_CSUM (NETIF_F_V4_CSUM | NETIF_F_V6_CSUM)
878
879 /*
880 * If one device supports one of these features, then enable them
881 * for all in netdev_increment_features.
882 */
883#define NETIF_F_ONE_FOR_ALL (NETIF_F_GSO_SOFTWARE | NETIF_F_GSO_ROBUST | \
884 NETIF_F_SG | NETIF_F_HIGHDMA | \
885 NETIF_F_FRAGLIST)
886
887 /* Interface index. Unique device identifier */
888 int ifindex;
889 int iflink;
890
891 struct net_device_stats stats;
892 atomic_long_t rx_dropped; /* dropped packets by core network
893 * Do not use this in drivers.
894 */
895
896#ifdef CONFIG_WIRELESS_EXT
897 /* List of functions to handle Wireless Extensions (instead of ioctl).
898 * See <net/iw_handler.h> for details. Jean II */
899 const struct iw_handler_def * wireless_handlers;
900 /* Instance data managed by the core of Wireless Extensions. */
901 struct iw_public_data * wireless_data;
902#endif
903 /* Management operations */
904 const struct net_device_ops *netdev_ops;
905 const struct ethtool_ops *ethtool_ops;
906
907 /* Hardware header description */
908 const struct header_ops *header_ops;
909
910 unsigned int flags; /* interface flags (a la BSD) */
911 unsigned short gflags;
912 unsigned int priv_flags; /* Like 'flags' but invisible to userspace. */
913 unsigned short padded; /* How much padding added by alloc_netdev() */
914
915 unsigned char operstate; /* RFC2863 operstate */
916 unsigned char link_mode; /* mapping policy to operstate */
917
918 unsigned int mtu; /* interface MTU value */
919 unsigned short type; /* interface hardware type */
920 unsigned short hard_header_len; /* hardware hdr length */
921
922 /* extra head- and tailroom the hardware may need, but not in all cases
923 * can this be guaranteed, especially tailroom. Some cases also use
924 * LL_MAX_HEADER instead to allocate the skb.
925 */
926 unsigned short needed_headroom;
927 unsigned short needed_tailroom;
928
929 /* Interface address info. */
930 unsigned char perm_addr[MAX_ADDR_LEN]; /* permanent hw address */
931 unsigned char addr_assign_type; /* hw address assignment type */
932 unsigned char addr_len; /* hardware address length */
933 unsigned short dev_id; /* for shared network cards */
934
935 spinlock_t addr_list_lock;
936 struct netdev_hw_addr_list uc; /* Unicast mac addresses */
937 struct netdev_hw_addr_list mc; /* Multicast mac addresses */
938 int uc_promisc;
939 unsigned int promiscuity;
940 unsigned int allmulti;
941
942
943 /* Protocol specific pointers */
944
945#if defined(CONFIG_VLAN_8021Q) || defined(CONFIG_VLAN_8021Q_MODULE)
946 struct vlan_group __rcu *vlgrp; /* VLAN group */
947#endif
948#ifdef CONFIG_NET_DSA
949 void *dsa_ptr; /* dsa specific data */
950#endif
951 void *atalk_ptr; /* AppleTalk link */
952 struct in_device __rcu *ip_ptr; /* IPv4 specific data */
953 struct dn_dev __rcu *dn_ptr; /* DECnet specific data */
954 struct inet6_dev __rcu *ip6_ptr; /* IPv6 specific data */
955 void *ec_ptr; /* Econet specific data */
956 void *ax25_ptr; /* AX.25 specific data */
957 struct wireless_dev *ieee80211_ptr; /* IEEE 802.11 specific data,
958 assign before registering */
959
960/*
961 * Cache lines mostly used on receive path (including eth_type_trans())
962 */
963 unsigned long last_rx; /* Time of last Rx
964 * This should not be set in
965 * drivers, unless really needed,
966 * because network stack (bonding)
967 * use it if/when necessary, to
968 * avoid dirtying this cache line.
969 */
970
971 struct net_device *master; /* Pointer to master device of a group,
972 * which this device is member of.
973 */
974
975 /* Interface address info used in eth_type_trans() */
976 unsigned char *dev_addr; /* hw address, (before bcast
977 because most packets are
978 unicast) */
979
980 struct netdev_hw_addr_list dev_addrs; /* list of device
981 hw addresses */
982
983 unsigned char broadcast[MAX_ADDR_LEN]; /* hw bcast add */
984
985#ifdef CONFIG_RPS
986 struct kset *queues_kset;
987
988 struct netdev_rx_queue *_rx;
989
990 /* Number of RX queues allocated at register_netdev() time */
991 unsigned int num_rx_queues;
992
993 /* Number of RX queues currently active in device */
994 unsigned int real_num_rx_queues;
995#endif
996
997 rx_handler_func_t *rx_handler;
998 void *rx_handler_data;
999
1000 struct netdev_queue __rcu *ingress_queue;
1001
1002/*
1003 * Cache lines mostly used on transmit path
1004 */
1005 struct netdev_queue *_tx ____cacheline_aligned_in_smp;
1006
1007 /* Number of TX queues allocated at alloc_netdev_mq() time */
1008 unsigned int num_tx_queues;
1009
1010 /* Number of TX queues currently active in device */
1011 unsigned int real_num_tx_queues;
1012
1013 /* root qdisc from userspace point of view */
1014 struct Qdisc *qdisc;
1015
1016 unsigned long tx_queue_len; /* Max frames per queue allowed */
1017 spinlock_t tx_global_lock;
1018
1019 /* These may be needed for future network-power-down code. */
1020
1021 /*
1022 * trans_start here is expensive for high speed devices on SMP,
1023 * please use netdev_queue->trans_start instead.
1024 */
1025 unsigned long trans_start; /* Time (in jiffies) of last Tx */
1026
1027 int watchdog_timeo; /* used by dev_watchdog() */
1028 struct timer_list watchdog_timer;
1029
1030 /* Number of references to this device */
1031 int __percpu *pcpu_refcnt;
1032
1033 /* delayed register/unregister */
1034 struct list_head todo_list;
1035 /* device index hash chain */
1036 struct hlist_node index_hlist;
1037
1038 struct list_head link_watch_list;
1039
1040 /* register/unregister state machine */
1041 enum { NETREG_UNINITIALIZED=0,
1042 NETREG_REGISTERED, /* completed register_netdevice */
1043 NETREG_UNREGISTERING, /* called unregister_netdevice */
1044 NETREG_UNREGISTERED, /* completed unregister todo */
1045 NETREG_RELEASED, /* called free_netdev */
1046 NETREG_DUMMY, /* dummy device for NAPI poll */
1047 } reg_state:16;
1048
1049 enum {
1050 RTNL_LINK_INITIALIZED,
1051 RTNL_LINK_INITIALIZING,
1052 } rtnl_link_state:16;
1053
1054 /* Called from unregister, can be used to call free_netdev */
1055 void (*destructor)(struct net_device *dev);
1056
1057#ifdef CONFIG_NETPOLL
1058 struct netpoll_info *npinfo;
1059#endif
1060
1061#ifdef CONFIG_NET_NS
1062 /* Network namespace this network device is inside */
1063 struct net *nd_net;
1064#endif
1065
1066 /* mid-layer private */
1067 union {
1068 void *ml_priv;
1069 struct pcpu_lstats __percpu *lstats; /* loopback stats */
1070 struct pcpu_tstats __percpu *tstats; /* tunnel stats */
1071 struct pcpu_dstats __percpu *dstats; /* dummy stats */
1072 };
1073 /* GARP */
1074 struct garp_port __rcu *garp_port;
1075
1076 /* class/net/name entry */
1077 struct device dev;
1078 /* space for optional device, statistics, and wireless sysfs groups */
1079 const struct attribute_group *sysfs_groups[4];
1080
1081 /* rtnetlink link ops */
1082 const struct rtnl_link_ops *rtnl_link_ops;
1083
1084 /* VLAN feature mask */
1085 unsigned long vlan_features;
1086
1087 /* for setting kernel sock attribute on TCP connection setup */
1088#define GSO_MAX_SIZE 65536
1089 unsigned int gso_max_size;
1090
1091#ifdef CONFIG_DCB
1092 /* Data Center Bridging netlink ops */
1093 const struct dcbnl_rtnl_ops *dcbnl_ops;
1094#endif
1095
1096#if defined(CONFIG_FCOE) || defined(CONFIG_FCOE_MODULE)
1097 /* max exchange id for FCoE LRO by ddp */
1098 unsigned int fcoe_ddp_xid;
1099#endif
1100 /* n-tuple filter list attached to this device */
1101 struct ethtool_rx_ntuple_list ethtool_ntuple_list;
1102
1103 /* phy device may attach itself for hardware timestamping */
1104 struct phy_device *phydev;
1105};
1106#define to_net_dev(d) container_of(d, struct net_device, dev)
1107
1108#define NETDEV_ALIGN 32
1109
1110static inline
1111struct netdev_queue *netdev_get_tx_queue(const struct net_device *dev,
1112 unsigned int index)
1113{
1114 return &dev->_tx[index];
1115}
1116
1117static inline void netdev_for_each_tx_queue(struct net_device *dev,
1118 void (*f)(struct net_device *,
1119 struct netdev_queue *,
1120 void *),
1121 void *arg)
1122{
1123 unsigned int i;
1124
1125 for (i = 0; i < dev->num_tx_queues; i++)
1126 f(dev, &dev->_tx[i], arg);
1127}
1128
1129/*
1130 * Net namespace inlines
1131 */
1132static inline
1133struct net *dev_net(const struct net_device *dev)
1134{
1135 return read_pnet(&dev->nd_net);
1136}
1137
1138static inline
1139void dev_net_set(struct net_device *dev, struct net *net)
1140{
1141#ifdef CONFIG_NET_NS
1142 release_net(dev->nd_net);
1143 dev->nd_net = hold_net(net);
1144#endif
1145}
1146
1147static inline bool netdev_uses_dsa_tags(struct net_device *dev)
1148{
1149#ifdef CONFIG_NET_DSA_TAG_DSA
1150 if (dev->dsa_ptr != NULL)
1151 return dsa_uses_dsa_tags(dev->dsa_ptr);
1152#endif
1153
1154 return 0;
1155}
1156
1157#ifndef CONFIG_NET_NS
1158static inline void skb_set_dev(struct sk_buff *skb, struct net_device *dev)
1159{
1160 skb->dev = dev;
1161}
1162#else /* CONFIG_NET_NS */
1163void skb_set_dev(struct sk_buff *skb, struct net_device *dev);
1164#endif
1165
1166static inline bool netdev_uses_trailer_tags(struct net_device *dev)
1167{
1168#ifdef CONFIG_NET_DSA_TAG_TRAILER
1169 if (dev->dsa_ptr != NULL)
1170 return dsa_uses_trailer_tags(dev->dsa_ptr);
1171#endif
1172
1173 return 0;
1174}
1175
1176/**
1177 * netdev_priv - access network device private data
1178 * @dev: network device
1179 *
1180 * Get network device private data
1181 */
1182static inline void *netdev_priv(const struct net_device *dev)
1183{
1184 return (char *)dev + ALIGN(sizeof(struct net_device), NETDEV_ALIGN);
1185}
1186
1187/* Set the sysfs physical device reference for the network logical device
1188 * if set prior to registration will cause a symlink during initialization.
1189 */
1190#define SET_NETDEV_DEV(net, pdev) ((net)->dev.parent = (pdev))
1191
1192/* Set the sysfs device type for the network logical device to allow
1193 * fin grained indentification of different network device types. For
1194 * example Ethernet, Wirelss LAN, Bluetooth, WiMAX etc.
1195 */
1196#define SET_NETDEV_DEVTYPE(net, devtype) ((net)->dev.type = (devtype))
1197
1198/**
1199 * netif_napi_add - initialize a napi context
1200 * @dev: network device
1201 * @napi: napi context
1202 * @poll: polling function
1203 * @weight: default weight
1204 *
1205 * netif_napi_add() must be used to initialize a napi context prior to calling
1206 * *any* of the other napi related functions.
1207 */
1208void netif_napi_add(struct net_device *dev, struct napi_struct *napi,
1209 int (*poll)(struct napi_struct *, int), int weight);
1210
1211/**
1212 * netif_napi_del - remove a napi context
1213 * @napi: napi context
1214 *
1215 * netif_napi_del() removes a napi context from the network device napi list
1216 */
1217void netif_napi_del(struct napi_struct *napi);
1218
1219struct napi_gro_cb {
1220 /* Virtual address of skb_shinfo(skb)->frags[0].page + offset. */
1221 void *frag0;
1222
1223 /* Length of frag0. */
1224 unsigned int frag0_len;
1225
1226 /* This indicates where we are processing relative to skb->data. */
1227 int data_offset;
1228
1229 /* This is non-zero if the packet may be of the same flow. */
1230 int same_flow;
1231
1232 /* This is non-zero if the packet cannot be merged with the new skb. */
1233 int flush;
1234
1235 /* Number of segments aggregated. */
1236 int count;
1237
1238 /* Free the skb? */
1239 int free;
1240};
1241
1242#define NAPI_GRO_CB(skb) ((struct napi_gro_cb *)(skb)->cb)
1243
1244struct packet_type {
1245 __be16 type; /* This is really htons(ether_type). */
1246 struct net_device *dev; /* NULL is wildcarded here */
1247 int (*func) (struct sk_buff *,
1248 struct net_device *,
1249 struct packet_type *,
1250 struct net_device *);
1251 struct sk_buff *(*gso_segment)(struct sk_buff *skb,
1252 int features);
1253 int (*gso_send_check)(struct sk_buff *skb);
1254 struct sk_buff **(*gro_receive)(struct sk_buff **head,
1255 struct sk_buff *skb);
1256 int (*gro_complete)(struct sk_buff *skb);
1257 void *af_packet_priv;
1258 struct list_head list;
1259};
1260
1261#include <linux/interrupt.h>
1262#include <linux/notifier.h>
1263
1264extern rwlock_t dev_base_lock; /* Device list lock */
1265
1266
1267#define for_each_netdev(net, d) \
1268 list_for_each_entry(d, &(net)->dev_base_head, dev_list)
1269#define for_each_netdev_reverse(net, d) \
1270 list_for_each_entry_reverse(d, &(net)->dev_base_head, dev_list)
1271#define for_each_netdev_rcu(net, d) \
1272 list_for_each_entry_rcu(d, &(net)->dev_base_head, dev_list)
1273#define for_each_netdev_safe(net, d, n) \
1274 list_for_each_entry_safe(d, n, &(net)->dev_base_head, dev_list)
1275#define for_each_netdev_continue(net, d) \
1276 list_for_each_entry_continue(d, &(net)->dev_base_head, dev_list)
1277#define for_each_netdev_continue_rcu(net, d) \
1278 list_for_each_entry_continue_rcu(d, &(net)->dev_base_head, dev_list)
1279#define net_device_entry(lh) list_entry(lh, struct net_device, dev_list)
1280
1281static inline struct net_device *next_net_device(struct net_device *dev)
1282{
1283 struct list_head *lh;
1284 struct net *net;
1285
1286 net = dev_net(dev);
1287 lh = dev->dev_list.next;
1288 return lh == &net->dev_base_head ? NULL : net_device_entry(lh);
1289}
1290
1291static inline struct net_device *next_net_device_rcu(struct net_device *dev)
1292{
1293 struct list_head *lh;
1294 struct net *net;
1295
1296 net = dev_net(dev);
1297 lh = rcu_dereference(dev->dev_list.next);
1298 return lh == &net->dev_base_head ? NULL : net_device_entry(lh);
1299}
1300
1301static inline struct net_device *first_net_device(struct net *net)
1302{
1303 return list_empty(&net->dev_base_head) ? NULL :
1304 net_device_entry(net->dev_base_head.next);
1305}
1306
1307extern int netdev_boot_setup_check(struct net_device *dev);
1308extern unsigned long netdev_boot_base(const char *prefix, int unit);
1309extern struct net_device *dev_getbyhwaddr(struct net *net, unsigned short type, char *hwaddr);
1310extern struct net_device *dev_getfirstbyhwtype(struct net *net, unsigned short type);
1311extern struct net_device *__dev_getfirstbyhwtype(struct net *net, unsigned short type);
1312extern void dev_add_pack(struct packet_type *pt);
1313extern void dev_remove_pack(struct packet_type *pt);
1314extern void __dev_remove_pack(struct packet_type *pt);
1315
1316extern struct net_device *dev_get_by_flags_rcu(struct net *net, unsigned short flags,
1317 unsigned short mask);
1318extern struct net_device *dev_get_by_name(struct net *net, const char *name);
1319extern struct net_device *dev_get_by_name_rcu(struct net *net, const char *name);
1320extern struct net_device *__dev_get_by_name(struct net *net, const char *name);
1321extern int dev_alloc_name(struct net_device *dev, const char *name);
1322extern int dev_open(struct net_device *dev);
1323extern int dev_close(struct net_device *dev);
1324extern void dev_disable_lro(struct net_device *dev);
1325extern int dev_queue_xmit(struct sk_buff *skb);
1326extern int register_netdevice(struct net_device *dev);
1327extern void unregister_netdevice_queue(struct net_device *dev,
1328 struct list_head *head);
1329extern void unregister_netdevice_many(struct list_head *head);
1330static inline void unregister_netdevice(struct net_device *dev)
1331{
1332 unregister_netdevice_queue(dev, NULL);
1333}
1334
1335extern int netdev_refcnt_read(const struct net_device *dev);
1336extern void free_netdev(struct net_device *dev);
1337extern void synchronize_net(void);
1338extern int register_netdevice_notifier(struct notifier_block *nb);
1339extern int unregister_netdevice_notifier(struct notifier_block *nb);
1340extern int init_dummy_netdev(struct net_device *dev);
1341extern void netdev_resync_ops(struct net_device *dev);
1342
1343extern int call_netdevice_notifiers(unsigned long val, struct net_device *dev);
1344extern struct net_device *dev_get_by_index(struct net *net, int ifindex);
1345extern struct net_device *__dev_get_by_index(struct net *net, int ifindex);
1346extern struct net_device *dev_get_by_index_rcu(struct net *net, int ifindex);
1347extern int dev_restart(struct net_device *dev);
1348#ifdef CONFIG_NETPOLL_TRAP
1349extern int netpoll_trap(void);
1350#endif
1351extern int skb_gro_receive(struct sk_buff **head,
1352 struct sk_buff *skb);
1353extern void skb_gro_reset_offset(struct sk_buff *skb);
1354
1355static inline unsigned int skb_gro_offset(const struct sk_buff *skb)
1356{
1357 return NAPI_GRO_CB(skb)->data_offset;
1358}
1359
1360static inline unsigned int skb_gro_len(const struct sk_buff *skb)
1361{
1362 return skb->len - NAPI_GRO_CB(skb)->data_offset;
1363}
1364
1365static inline void skb_gro_pull(struct sk_buff *skb, unsigned int len)
1366{
1367 NAPI_GRO_CB(skb)->data_offset += len;
1368}
1369
1370static inline void *skb_gro_header_fast(struct sk_buff *skb,
1371 unsigned int offset)
1372{
1373 return NAPI_GRO_CB(skb)->frag0 + offset;
1374}
1375
1376static inline int skb_gro_header_hard(struct sk_buff *skb, unsigned int hlen)
1377{
1378 return NAPI_GRO_CB(skb)->frag0_len < hlen;
1379}
1380
1381static inline void *skb_gro_header_slow(struct sk_buff *skb, unsigned int hlen,
1382 unsigned int offset)
1383{
1384 NAPI_GRO_CB(skb)->frag0 = NULL;
1385 NAPI_GRO_CB(skb)->frag0_len = 0;
1386 return pskb_may_pull(skb, hlen) ? skb->data + offset : NULL;
1387}
1388
1389static inline void *skb_gro_mac_header(struct sk_buff *skb)
1390{
1391 return NAPI_GRO_CB(skb)->frag0 ?: skb_mac_header(skb);
1392}
1393
1394static inline void *skb_gro_network_header(struct sk_buff *skb)
1395{
1396 return (NAPI_GRO_CB(skb)->frag0 ?: skb->data) +
1397 skb_network_offset(skb);
1398}
1399
1400static inline int dev_hard_header(struct sk_buff *skb, struct net_device *dev,
1401 unsigned short type,
1402 const void *daddr, const void *saddr,
1403 unsigned len)
1404{
1405 if (!dev->header_ops || !dev->header_ops->create)
1406 return 0;
1407
1408 return dev->header_ops->create(skb, dev, type, daddr, saddr, len);
1409}
1410
1411static inline int dev_parse_header(const struct sk_buff *skb,
1412 unsigned char *haddr)
1413{
1414 const struct net_device *dev = skb->dev;
1415
1416 if (!dev->header_ops || !dev->header_ops->parse)
1417 return 0;
1418 return dev->header_ops->parse(skb, haddr);
1419}
1420
1421typedef int gifconf_func_t(struct net_device * dev, char __user * bufptr, int len);
1422extern int register_gifconf(unsigned int family, gifconf_func_t * gifconf);
1423static inline int unregister_gifconf(unsigned int family)
1424{
1425 return register_gifconf(family, NULL);
1426}
1427
1428/*
1429 * Incoming packets are placed on per-cpu queues
1430 */
1431struct softnet_data {
1432 struct Qdisc *output_queue;
1433 struct Qdisc **output_queue_tailp;
1434 struct list_head poll_list;
1435 struct sk_buff *completion_queue;
1436 struct sk_buff_head process_queue;
1437
1438 /* stats */
1439 unsigned int processed;
1440 unsigned int time_squeeze;
1441 unsigned int cpu_collision;
1442 unsigned int received_rps;
1443
1444#ifdef CONFIG_RPS
1445 struct softnet_data *rps_ipi_list;
1446
1447 /* Elements below can be accessed between CPUs for RPS */
1448 struct call_single_data csd ____cacheline_aligned_in_smp;
1449 struct softnet_data *rps_ipi_next;
1450 unsigned int cpu;
1451 unsigned int input_queue_head;
1452 unsigned int input_queue_tail;
1453#endif
1454 unsigned dropped;
1455 struct sk_buff_head input_pkt_queue;
1456 struct napi_struct backlog;
1457};
1458
1459static inline void input_queue_head_incr(struct softnet_data *sd)
1460{
1461#ifdef CONFIG_RPS
1462 sd->input_queue_head++;
1463#endif
1464}
1465
1466static inline void input_queue_tail_incr_save(struct softnet_data *sd,
1467 unsigned int *qtail)
1468{
1469#ifdef CONFIG_RPS
1470 *qtail = ++sd->input_queue_tail;
1471#endif
1472}
1473
1474DECLARE_PER_CPU_ALIGNED(struct softnet_data, softnet_data);
1475
1476#define HAVE_NETIF_QUEUE
1477
1478extern void __netif_schedule(struct Qdisc *q);
1479
1480static inline void netif_schedule_queue(struct netdev_queue *txq)
1481{
1482 if (!test_bit(__QUEUE_STATE_XOFF, &txq->state))
1483 __netif_schedule(txq->qdisc);
1484}
1485
1486static inline void netif_tx_schedule_all(struct net_device *dev)
1487{
1488 unsigned int i;
1489
1490 for (i = 0; i < dev->num_tx_queues; i++)
1491 netif_schedule_queue(netdev_get_tx_queue(dev, i));
1492}
1493
1494static inline void netif_tx_start_queue(struct netdev_queue *dev_queue)
1495{
1496 clear_bit(__QUEUE_STATE_XOFF, &dev_queue->state);
1497}
1498
1499/**
1500 * netif_start_queue - allow transmit
1501 * @dev: network device
1502 *
1503 * Allow upper layers to call the device hard_start_xmit routine.
1504 */
1505static inline void netif_start_queue(struct net_device *dev)
1506{
1507 netif_tx_start_queue(netdev_get_tx_queue(dev, 0));
1508}
1509
1510static inline void netif_tx_start_all_queues(struct net_device *dev)
1511{
1512 unsigned int i;
1513
1514 for (i = 0; i < dev->num_tx_queues; i++) {
1515 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
1516 netif_tx_start_queue(txq);
1517 }
1518}
1519
1520static inline void netif_tx_wake_queue(struct netdev_queue *dev_queue)
1521{
1522#ifdef CONFIG_NETPOLL_TRAP
1523 if (netpoll_trap()) {
1524 netif_tx_start_queue(dev_queue);
1525 return;
1526 }
1527#endif
1528 if (test_and_clear_bit(__QUEUE_STATE_XOFF, &dev_queue->state))
1529 __netif_schedule(dev_queue->qdisc);
1530}
1531
1532/**
1533 * netif_wake_queue - restart transmit
1534 * @dev: network device
1535 *
1536 * Allow upper layers to call the device hard_start_xmit routine.
1537 * Used for flow control when transmit resources are available.
1538 */
1539static inline void netif_wake_queue(struct net_device *dev)
1540{
1541 netif_tx_wake_queue(netdev_get_tx_queue(dev, 0));
1542}
1543
1544static inline void netif_tx_wake_all_queues(struct net_device *dev)
1545{
1546 unsigned int i;
1547
1548 for (i = 0; i < dev->num_tx_queues; i++) {
1549 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
1550 netif_tx_wake_queue(txq);
1551 }
1552}
1553
1554static inline void netif_tx_stop_queue(struct netdev_queue *dev_queue)
1555{
1556 if (WARN_ON(!dev_queue)) {
1557 printk(KERN_INFO "netif_stop_queue() cannot be called before "
1558 "register_netdev()");
1559 return;
1560 }
1561 set_bit(__QUEUE_STATE_XOFF, &dev_queue->state);
1562}
1563
1564/**
1565 * netif_stop_queue - stop transmitted packets
1566 * @dev: network device
1567 *
1568 * Stop upper layers calling the device hard_start_xmit routine.
1569 * Used for flow control when transmit resources are unavailable.
1570 */
1571static inline void netif_stop_queue(struct net_device *dev)
1572{
1573 netif_tx_stop_queue(netdev_get_tx_queue(dev, 0));
1574}
1575
1576static inline void netif_tx_stop_all_queues(struct net_device *dev)
1577{
1578 unsigned int i;
1579
1580 for (i = 0; i < dev->num_tx_queues; i++) {
1581 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
1582 netif_tx_stop_queue(txq);
1583 }
1584}
1585
1586static inline int netif_tx_queue_stopped(const struct netdev_queue *dev_queue)
1587{
1588 return test_bit(__QUEUE_STATE_XOFF, &dev_queue->state);
1589}
1590
1591/**
1592 * netif_queue_stopped - test if transmit queue is flowblocked
1593 * @dev: network device
1594 *
1595 * Test if transmit queue on device is currently unable to send.
1596 */
1597static inline int netif_queue_stopped(const struct net_device *dev)
1598{
1599 return netif_tx_queue_stopped(netdev_get_tx_queue(dev, 0));
1600}
1601
1602static inline int netif_tx_queue_frozen(const struct netdev_queue *dev_queue)
1603{
1604 return test_bit(__QUEUE_STATE_FROZEN, &dev_queue->state);
1605}
1606
1607/**
1608 * netif_running - test if up
1609 * @dev: network device
1610 *
1611 * Test if the device has been brought up.
1612 */
1613static inline int netif_running(const struct net_device *dev)
1614{
1615 return test_bit(__LINK_STATE_START, &dev->state);
1616}
1617
1618/*
1619 * Routines to manage the subqueues on a device. We only need start
1620 * stop, and a check if it's stopped. All other device management is
1621 * done at the overall netdevice level.
1622 * Also test the device if we're multiqueue.
1623 */
1624
1625/**
1626 * netif_start_subqueue - allow sending packets on subqueue
1627 * @dev: network device
1628 * @queue_index: sub queue index
1629 *
1630 * Start individual transmit queue of a device with multiple transmit queues.
1631 */
1632static inline void netif_start_subqueue(struct net_device *dev, u16 queue_index)
1633{
1634 struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index);
1635
1636 netif_tx_start_queue(txq);
1637}
1638
1639/**
1640 * netif_stop_subqueue - stop sending packets on subqueue
1641 * @dev: network device
1642 * @queue_index: sub queue index
1643 *
1644 * Stop individual transmit queue of a device with multiple transmit queues.
1645 */
1646static inline void netif_stop_subqueue(struct net_device *dev, u16 queue_index)
1647{
1648 struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index);
1649#ifdef CONFIG_NETPOLL_TRAP
1650 if (netpoll_trap())
1651 return;
1652#endif
1653 netif_tx_stop_queue(txq);
1654}
1655
1656/**
1657 * netif_subqueue_stopped - test status of subqueue
1658 * @dev: network device
1659 * @queue_index: sub queue index
1660 *
1661 * Check individual transmit queue of a device with multiple transmit queues.
1662 */
1663static inline int __netif_subqueue_stopped(const struct net_device *dev,
1664 u16 queue_index)
1665{
1666 struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index);
1667
1668 return netif_tx_queue_stopped(txq);
1669}
1670
1671static inline int netif_subqueue_stopped(const struct net_device *dev,
1672 struct sk_buff *skb)
1673{
1674 return __netif_subqueue_stopped(dev, skb_get_queue_mapping(skb));
1675}
1676
1677/**
1678 * netif_wake_subqueue - allow sending packets on subqueue
1679 * @dev: network device
1680 * @queue_index: sub queue index
1681 *
1682 * Resume individual transmit queue of a device with multiple transmit queues.
1683 */
1684static inline void netif_wake_subqueue(struct net_device *dev, u16 queue_index)
1685{
1686 struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index);
1687#ifdef CONFIG_NETPOLL_TRAP
1688 if (netpoll_trap())
1689 return;
1690#endif
1691 if (test_and_clear_bit(__QUEUE_STATE_XOFF, &txq->state))
1692 __netif_schedule(txq->qdisc);
1693}
1694
1695/**
1696 * netif_is_multiqueue - test if device has multiple transmit queues
1697 * @dev: network device
1698 *
1699 * Check if device has multiple transmit queues
1700 */
1701static inline int netif_is_multiqueue(const struct net_device *dev)
1702{
1703 return dev->num_tx_queues > 1;
1704}
1705
1706extern int netif_set_real_num_tx_queues(struct net_device *dev,
1707 unsigned int txq);
1708
1709#ifdef CONFIG_RPS
1710extern int netif_set_real_num_rx_queues(struct net_device *dev,
1711 unsigned int rxq);
1712#else
1713static inline int netif_set_real_num_rx_queues(struct net_device *dev,
1714 unsigned int rxq)
1715{
1716 return 0;
1717}
1718#endif
1719
1720static inline int netif_copy_real_num_queues(struct net_device *to_dev,
1721 const struct net_device *from_dev)
1722{
1723 netif_set_real_num_tx_queues(to_dev, from_dev->real_num_tx_queues);
1724#ifdef CONFIG_RPS
1725 return netif_set_real_num_rx_queues(to_dev,
1726 from_dev->real_num_rx_queues);
1727#else
1728 return 0;
1729#endif
1730}
1731
1732/* Use this variant when it is known for sure that it
1733 * is executing from hardware interrupt context or with hardware interrupts
1734 * disabled.
1735 */
1736extern void dev_kfree_skb_irq(struct sk_buff *skb);
1737
1738/* Use this variant in places where it could be invoked
1739 * from either hardware interrupt or other context, with hardware interrupts
1740 * either disabled or enabled.
1741 */
1742extern void dev_kfree_skb_any(struct sk_buff *skb);
1743
1744#define HAVE_NETIF_RX 1
1745extern int netif_rx(struct sk_buff *skb);
1746extern int netif_rx_ni(struct sk_buff *skb);
1747#define HAVE_NETIF_RECEIVE_SKB 1
1748extern int netif_receive_skb(struct sk_buff *skb);
1749extern gro_result_t dev_gro_receive(struct napi_struct *napi,
1750 struct sk_buff *skb);
1751extern gro_result_t napi_skb_finish(gro_result_t ret, struct sk_buff *skb);
1752extern gro_result_t napi_gro_receive(struct napi_struct *napi,
1753 struct sk_buff *skb);
1754extern void napi_gro_flush(struct napi_struct *napi);
1755extern struct sk_buff * napi_get_frags(struct napi_struct *napi);
1756extern gro_result_t napi_frags_finish(struct napi_struct *napi,
1757 struct sk_buff *skb,
1758 gro_result_t ret);
1759extern struct sk_buff * napi_frags_skb(struct napi_struct *napi);
1760extern gro_result_t napi_gro_frags(struct napi_struct *napi);
1761
1762static inline void napi_free_frags(struct napi_struct *napi)
1763{
1764 kfree_skb(napi->skb);
1765 napi->skb = NULL;
1766}
1767
1768extern int netdev_rx_handler_register(struct net_device *dev,
1769 rx_handler_func_t *rx_handler,
1770 void *rx_handler_data);
1771extern void netdev_rx_handler_unregister(struct net_device *dev);
1772
1773extern int dev_valid_name(const char *name);
1774extern int dev_ioctl(struct net *net, unsigned int cmd, void __user *);
1775extern int dev_ethtool(struct net *net, struct ifreq *);
1776extern unsigned dev_get_flags(const struct net_device *);
1777extern int __dev_change_flags(struct net_device *, unsigned int flags);
1778extern int dev_change_flags(struct net_device *, unsigned);
1779extern void __dev_notify_flags(struct net_device *, unsigned int old_flags);
1780extern int dev_change_name(struct net_device *, const char *);
1781extern int dev_set_alias(struct net_device *, const char *, size_t);
1782extern int dev_change_net_namespace(struct net_device *,
1783 struct net *, const char *);
1784extern int dev_set_mtu(struct net_device *, int);
1785extern int dev_set_mac_address(struct net_device *,
1786 struct sockaddr *);
1787extern int dev_hard_start_xmit(struct sk_buff *skb,
1788 struct net_device *dev,
1789 struct netdev_queue *txq);
1790extern int dev_forward_skb(struct net_device *dev,
1791 struct sk_buff *skb);
1792
1793extern int netdev_budget;
1794
1795/* Called by rtnetlink.c:rtnl_unlock() */
1796extern void netdev_run_todo(void);
1797
1798/**
1799 * dev_put - release reference to device
1800 * @dev: network device
1801 *
1802 * Release reference to device to allow it to be freed.
1803 */
1804static inline void dev_put(struct net_device *dev)
1805{
1806 irqsafe_cpu_dec(*dev->pcpu_refcnt);
1807}
1808
1809/**
1810 * dev_hold - get reference to device
1811 * @dev: network device
1812 *
1813 * Hold reference to device to keep it from being freed.
1814 */
1815static inline void dev_hold(struct net_device *dev)
1816{
1817 irqsafe_cpu_inc(*dev->pcpu_refcnt);
1818}
1819
1820/* Carrier loss detection, dial on demand. The functions netif_carrier_on
1821 * and _off may be called from IRQ context, but it is caller
1822 * who is responsible for serialization of these calls.
1823 *
1824 * The name carrier is inappropriate, these functions should really be
1825 * called netif_lowerlayer_*() because they represent the state of any
1826 * kind of lower layer not just hardware media.
1827 */
1828
1829extern void linkwatch_fire_event(struct net_device *dev);
1830extern void linkwatch_forget_dev(struct net_device *dev);
1831
1832/**
1833 * netif_carrier_ok - test if carrier present
1834 * @dev: network device
1835 *
1836 * Check if carrier is present on device
1837 */
1838static inline int netif_carrier_ok(const struct net_device *dev)
1839{
1840 return !test_bit(__LINK_STATE_NOCARRIER, &dev->state);
1841}
1842
1843extern unsigned long dev_trans_start(struct net_device *dev);
1844
1845extern void __netdev_watchdog_up(struct net_device *dev);
1846
1847extern void netif_carrier_on(struct net_device *dev);
1848
1849extern void netif_carrier_off(struct net_device *dev);
1850
1851extern void netif_notify_peers(struct net_device *dev);
1852
1853/**
1854 * netif_dormant_on - mark device as dormant.
1855 * @dev: network device
1856 *
1857 * Mark device as dormant (as per RFC2863).
1858 *
1859 * The dormant state indicates that the relevant interface is not
1860 * actually in a condition to pass packets (i.e., it is not 'up') but is
1861 * in a "pending" state, waiting for some external event. For "on-
1862 * demand" interfaces, this new state identifies the situation where the
1863 * interface is waiting for events to place it in the up state.
1864 *
1865 */
1866static inline void netif_dormant_on(struct net_device *dev)
1867{
1868 if (!test_and_set_bit(__LINK_STATE_DORMANT, &dev->state))
1869 linkwatch_fire_event(dev);
1870}
1871
1872/**
1873 * netif_dormant_off - set device as not dormant.
1874 * @dev: network device
1875 *
1876 * Device is not in dormant state.
1877 */
1878static inline void netif_dormant_off(struct net_device *dev)
1879{
1880 if (test_and_clear_bit(__LINK_STATE_DORMANT, &dev->state))
1881 linkwatch_fire_event(dev);
1882}
1883
1884/**
1885 * netif_dormant - test if carrier present
1886 * @dev: network device
1887 *
1888 * Check if carrier is present on device
1889 */
1890static inline int netif_dormant(const struct net_device *dev)
1891{
1892 return test_bit(__LINK_STATE_DORMANT, &dev->state);
1893}
1894
1895
1896/**
1897 * netif_oper_up - test if device is operational
1898 * @dev: network device
1899 *
1900 * Check if carrier is operational
1901 */
1902static inline int netif_oper_up(const struct net_device *dev)
1903{
1904 return (dev->operstate == IF_OPER_UP ||
1905 dev->operstate == IF_OPER_UNKNOWN /* backward compat */);
1906}
1907
1908/**
1909 * netif_device_present - is device available or removed
1910 * @dev: network device
1911 *
1912 * Check if device has not been removed from system.
1913 */
1914static inline int netif_device_present(struct net_device *dev)
1915{
1916 return test_bit(__LINK_STATE_PRESENT, &dev->state);
1917}
1918
1919extern void netif_device_detach(struct net_device *dev);
1920
1921extern void netif_device_attach(struct net_device *dev);
1922
1923/*
1924 * Network interface message level settings
1925 */
1926#define HAVE_NETIF_MSG 1
1927
1928enum {
1929 NETIF_MSG_DRV = 0x0001,
1930 NETIF_MSG_PROBE = 0x0002,
1931 NETIF_MSG_LINK = 0x0004,
1932 NETIF_MSG_TIMER = 0x0008,
1933 NETIF_MSG_IFDOWN = 0x0010,
1934 NETIF_MSG_IFUP = 0x0020,
1935 NETIF_MSG_RX_ERR = 0x0040,
1936 NETIF_MSG_TX_ERR = 0x0080,
1937 NETIF_MSG_TX_QUEUED = 0x0100,
1938 NETIF_MSG_INTR = 0x0200,
1939 NETIF_MSG_TX_DONE = 0x0400,
1940 NETIF_MSG_RX_STATUS = 0x0800,
1941 NETIF_MSG_PKTDATA = 0x1000,
1942 NETIF_MSG_HW = 0x2000,
1943 NETIF_MSG_WOL = 0x4000,
1944};
1945
1946#define netif_msg_drv(p) ((p)->msg_enable & NETIF_MSG_DRV)
1947#define netif_msg_probe(p) ((p)->msg_enable & NETIF_MSG_PROBE)
1948#define netif_msg_link(p) ((p)->msg_enable & NETIF_MSG_LINK)
1949#define netif_msg_timer(p) ((p)->msg_enable & NETIF_MSG_TIMER)
1950#define netif_msg_ifdown(p) ((p)->msg_enable & NETIF_MSG_IFDOWN)
1951#define netif_msg_ifup(p) ((p)->msg_enable & NETIF_MSG_IFUP)
1952#define netif_msg_rx_err(p) ((p)->msg_enable & NETIF_MSG_RX_ERR)
1953#define netif_msg_tx_err(p) ((p)->msg_enable & NETIF_MSG_TX_ERR)
1954#define netif_msg_tx_queued(p) ((p)->msg_enable & NETIF_MSG_TX_QUEUED)
1955#define netif_msg_intr(p) ((p)->msg_enable & NETIF_MSG_INTR)
1956#define netif_msg_tx_done(p) ((p)->msg_enable & NETIF_MSG_TX_DONE)
1957#define netif_msg_rx_status(p) ((p)->msg_enable & NETIF_MSG_RX_STATUS)
1958#define netif_msg_pktdata(p) ((p)->msg_enable & NETIF_MSG_PKTDATA)
1959#define netif_msg_hw(p) ((p)->msg_enable & NETIF_MSG_HW)
1960#define netif_msg_wol(p) ((p)->msg_enable & NETIF_MSG_WOL)
1961
1962static inline u32 netif_msg_init(int debug_value, int default_msg_enable_bits)
1963{
1964 /* use default */
1965 if (debug_value < 0 || debug_value >= (sizeof(u32) * 8))
1966 return default_msg_enable_bits;
1967 if (debug_value == 0) /* no output */
1968 return 0;
1969 /* set low N bits */
1970 return (1 << debug_value) - 1;
1971}
1972
1973static inline void __netif_tx_lock(struct netdev_queue *txq, int cpu)
1974{
1975 spin_lock(&txq->_xmit_lock);
1976 txq->xmit_lock_owner = cpu;
1977}
1978
1979static inline void __netif_tx_lock_bh(struct netdev_queue *txq)
1980{
1981 spin_lock_bh(&txq->_xmit_lock);
1982 txq->xmit_lock_owner = smp_processor_id();
1983}
1984
1985static inline int __netif_tx_trylock(struct netdev_queue *txq)
1986{
1987 int ok = spin_trylock(&txq->_xmit_lock);
1988 if (likely(ok))
1989 txq->xmit_lock_owner = smp_processor_id();
1990 return ok;
1991}
1992
1993static inline void __netif_tx_unlock(struct netdev_queue *txq)
1994{
1995 txq->xmit_lock_owner = -1;
1996 spin_unlock(&txq->_xmit_lock);
1997}
1998
1999static inline void __netif_tx_unlock_bh(struct netdev_queue *txq)
2000{
2001 txq->xmit_lock_owner = -1;
2002 spin_unlock_bh(&txq->_xmit_lock);
2003}
2004
2005static inline void txq_trans_update(struct netdev_queue *txq)
2006{
2007 if (txq->xmit_lock_owner != -1)
2008 txq->trans_start = jiffies;
2009}
2010
2011/**
2012 * netif_tx_lock - grab network device transmit lock
2013 * @dev: network device
2014 *
2015 * Get network device transmit lock
2016 */
2017static inline void netif_tx_lock(struct net_device *dev)
2018{
2019 unsigned int i;
2020 int cpu;
2021
2022 spin_lock(&dev->tx_global_lock);
2023 cpu = smp_processor_id();
2024 for (i = 0; i < dev->num_tx_queues; i++) {
2025 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
2026
2027 /* We are the only thread of execution doing a
2028 * freeze, but we have to grab the _xmit_lock in
2029 * order to synchronize with threads which are in
2030 * the ->hard_start_xmit() handler and already
2031 * checked the frozen bit.
2032 */
2033 __netif_tx_lock(txq, cpu);
2034 set_bit(__QUEUE_STATE_FROZEN, &txq->state);
2035 __netif_tx_unlock(txq);
2036 }
2037}
2038
2039static inline void netif_tx_lock_bh(struct net_device *dev)
2040{
2041 local_bh_disable();
2042 netif_tx_lock(dev);
2043}
2044
2045static inline void netif_tx_unlock(struct net_device *dev)
2046{
2047 unsigned int i;
2048
2049 for (i = 0; i < dev->num_tx_queues; i++) {
2050 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
2051
2052 /* No need to grab the _xmit_lock here. If the
2053 * queue is not stopped for another reason, we
2054 * force a schedule.
2055 */
2056 clear_bit(__QUEUE_STATE_FROZEN, &txq->state);
2057 netif_schedule_queue(txq);
2058 }
2059 spin_unlock(&dev->tx_global_lock);
2060}
2061
2062static inline void netif_tx_unlock_bh(struct net_device *dev)
2063{
2064 netif_tx_unlock(dev);
2065 local_bh_enable();
2066}
2067
2068#define HARD_TX_LOCK(dev, txq, cpu) { \
2069 if ((dev->features & NETIF_F_LLTX) == 0) { \
2070 __netif_tx_lock(txq, cpu); \
2071 } \
2072}
2073
2074#define HARD_TX_UNLOCK(dev, txq) { \
2075 if ((dev->features & NETIF_F_LLTX) == 0) { \
2076 __netif_tx_unlock(txq); \
2077 } \
2078}
2079
2080static inline void netif_tx_disable(struct net_device *dev)
2081{
2082 unsigned int i;
2083 int cpu;
2084
2085 local_bh_disable();
2086 cpu = smp_processor_id();
2087 for (i = 0; i < dev->num_tx_queues; i++) {
2088 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
2089
2090 __netif_tx_lock(txq, cpu);
2091 netif_tx_stop_queue(txq);
2092 __netif_tx_unlock(txq);
2093 }
2094 local_bh_enable();
2095}
2096
2097static inline void netif_addr_lock(struct net_device *dev)
2098{
2099 spin_lock(&dev->addr_list_lock);
2100}
2101
2102static inline void netif_addr_lock_bh(struct net_device *dev)
2103{
2104 spin_lock_bh(&dev->addr_list_lock);
2105}
2106
2107static inline void netif_addr_unlock(struct net_device *dev)
2108{
2109 spin_unlock(&dev->addr_list_lock);
2110}
2111
2112static inline void netif_addr_unlock_bh(struct net_device *dev)
2113{
2114 spin_unlock_bh(&dev->addr_list_lock);
2115}
2116
2117/*
2118 * dev_addrs walker. Should be used only for read access. Call with
2119 * rcu_read_lock held.
2120 */
2121#define for_each_dev_addr(dev, ha) \
2122 list_for_each_entry_rcu(ha, &dev->dev_addrs.list, list)
2123
2124/* These functions live elsewhere (drivers/net/net_init.c, but related) */
2125
2126extern void ether_setup(struct net_device *dev);
2127
2128/* Support for loadable net-drivers */
2129extern struct net_device *alloc_netdev_mq(int sizeof_priv, const char *name,
2130 void (*setup)(struct net_device *),
2131 unsigned int queue_count);
2132#define alloc_netdev(sizeof_priv, name, setup) \
2133 alloc_netdev_mq(sizeof_priv, name, setup, 1)
2134extern int register_netdev(struct net_device *dev);
2135extern void unregister_netdev(struct net_device *dev);
2136
2137/* General hardware address lists handling functions */
2138extern int __hw_addr_add_multiple(struct netdev_hw_addr_list *to_list,
2139 struct netdev_hw_addr_list *from_list,
2140 int addr_len, unsigned char addr_type);
2141extern void __hw_addr_del_multiple(struct netdev_hw_addr_list *to_list,
2142 struct netdev_hw_addr_list *from_list,
2143 int addr_len, unsigned char addr_type);
2144extern int __hw_addr_sync(struct netdev_hw_addr_list *to_list,
2145 struct netdev_hw_addr_list *from_list,
2146 int addr_len);
2147extern void __hw_addr_unsync(struct netdev_hw_addr_list *to_list,
2148 struct netdev_hw_addr_list *from_list,
2149 int addr_len);
2150extern void __hw_addr_flush(struct netdev_hw_addr_list *list);
2151extern void __hw_addr_init(struct netdev_hw_addr_list *list);
2152
2153/* Functions used for device addresses handling */
2154extern int dev_addr_add(struct net_device *dev, unsigned char *addr,
2155 unsigned char addr_type);
2156extern int dev_addr_del(struct net_device *dev, unsigned char *addr,
2157 unsigned char addr_type);
2158extern int dev_addr_add_multiple(struct net_device *to_dev,
2159 struct net_device *from_dev,
2160 unsigned char addr_type);
2161extern int dev_addr_del_multiple(struct net_device *to_dev,
2162 struct net_device *from_dev,
2163 unsigned char addr_type);
2164extern void dev_addr_flush(struct net_device *dev);
2165extern int dev_addr_init(struct net_device *dev);
2166
2167/* Functions used for unicast addresses handling */
2168extern int dev_uc_add(struct net_device *dev, unsigned char *addr);
2169extern int dev_uc_del(struct net_device *dev, unsigned char *addr);
2170extern int dev_uc_sync(struct net_device *to, struct net_device *from);
2171extern void dev_uc_unsync(struct net_device *to, struct net_device *from);
2172extern void dev_uc_flush(struct net_device *dev);
2173extern void dev_uc_init(struct net_device *dev);
2174
2175/* Functions used for multicast addresses handling */
2176extern int dev_mc_add(struct net_device *dev, unsigned char *addr);
2177extern int dev_mc_add_global(struct net_device *dev, unsigned char *addr);
2178extern int dev_mc_del(struct net_device *dev, unsigned char *addr);
2179extern int dev_mc_del_global(struct net_device *dev, unsigned char *addr);
2180extern int dev_mc_sync(struct net_device *to, struct net_device *from);
2181extern void dev_mc_unsync(struct net_device *to, struct net_device *from);
2182extern void dev_mc_flush(struct net_device *dev);
2183extern void dev_mc_init(struct net_device *dev);
2184
2185/* Functions used for secondary unicast and multicast support */
2186extern void dev_set_rx_mode(struct net_device *dev);
2187extern void __dev_set_rx_mode(struct net_device *dev);
2188extern int dev_set_promiscuity(struct net_device *dev, int inc);
2189extern int dev_set_allmulti(struct net_device *dev, int inc);
2190extern void netdev_state_change(struct net_device *dev);
2191extern int netdev_bonding_change(struct net_device *dev,
2192 unsigned long event);
2193extern void netdev_features_change(struct net_device *dev);
2194/* Load a device via the kmod */
2195extern void dev_load(struct net *net, const char *name);
2196extern void dev_mcast_init(void);
2197extern struct rtnl_link_stats64 *dev_get_stats(struct net_device *dev,
2198 struct rtnl_link_stats64 *storage);
2199extern void dev_txq_stats_fold(const struct net_device *dev,
2200 struct rtnl_link_stats64 *stats);
2201
2202extern int netdev_max_backlog;
2203extern int netdev_tstamp_prequeue;
2204extern int weight_p;
2205extern int netdev_set_master(struct net_device *dev, struct net_device *master);
2206extern int skb_checksum_help(struct sk_buff *skb);
2207extern struct sk_buff *skb_gso_segment(struct sk_buff *skb, int features);
2208#ifdef CONFIG_BUG
2209extern void netdev_rx_csum_fault(struct net_device *dev);
2210#else
2211static inline void netdev_rx_csum_fault(struct net_device *dev)
2212{
2213}
2214#endif
2215/* rx skb timestamps */
2216extern void net_enable_timestamp(void);
2217extern void net_disable_timestamp(void);
2218
2219#ifdef CONFIG_PROC_FS
2220extern void *dev_seq_start(struct seq_file *seq, loff_t *pos);
2221extern void *dev_seq_next(struct seq_file *seq, void *v, loff_t *pos);
2222extern void dev_seq_stop(struct seq_file *seq, void *v);
2223#endif
2224
2225extern int netdev_class_create_file(struct class_attribute *class_attr);
2226extern void netdev_class_remove_file(struct class_attribute *class_attr);
2227
2228extern struct kobj_ns_type_operations net_ns_type_operations;
2229
2230extern char *netdev_drivername(const struct net_device *dev, char *buffer, int len);
2231
2232extern void linkwatch_run_queue(void);
2233
2234unsigned long netdev_increment_features(unsigned long all, unsigned long one,
2235 unsigned long mask);
2236unsigned long netdev_fix_features(unsigned long features, const char *name);
2237
2238void netif_stacked_transfer_operstate(const struct net_device *rootdev,
2239 struct net_device *dev);
2240
2241int netif_get_vlan_features(struct sk_buff *skb, struct net_device *dev);
2242
2243static inline int net_gso_ok(int features, int gso_type)
2244{
2245 int feature = gso_type << NETIF_F_GSO_SHIFT;
2246 return (features & feature) == feature;
2247}
2248
2249static inline int skb_gso_ok(struct sk_buff *skb, int features)
2250{
2251 return net_gso_ok(features, skb_shinfo(skb)->gso_type) &&
2252 (!skb_has_frag_list(skb) || (features & NETIF_F_FRAGLIST));
2253}
2254
2255static inline int netif_needs_gso(struct net_device *dev, struct sk_buff *skb)
2256{
2257 if (skb_is_gso(skb)) {
2258 int features = netif_get_vlan_features(skb, dev);
2259
2260 return (!skb_gso_ok(skb, features) ||
2261 unlikely(skb->ip_summed != CHECKSUM_PARTIAL));
2262 }
2263
2264 return 0;
2265}
2266
2267static inline void netif_set_gso_max_size(struct net_device *dev,
2268 unsigned int size)
2269{
2270 dev->gso_max_size = size;
2271}
2272
2273extern int __skb_bond_should_drop(struct sk_buff *skb,
2274 struct net_device *master);
2275
2276static inline int skb_bond_should_drop(struct sk_buff *skb,
2277 struct net_device *master)
2278{
2279 if (master)
2280 return __skb_bond_should_drop(skb, master);
2281 return 0;
2282}
2283
2284extern struct pernet_operations __net_initdata loopback_net_ops;
2285
2286static inline int dev_ethtool_get_settings(struct net_device *dev,
2287 struct ethtool_cmd *cmd)
2288{
2289 if (!dev->ethtool_ops || !dev->ethtool_ops->get_settings)
2290 return -EOPNOTSUPP;
2291 return dev->ethtool_ops->get_settings(dev, cmd);
2292}
2293
2294static inline u32 dev_ethtool_get_rx_csum(struct net_device *dev)
2295{
2296 if (!dev->ethtool_ops || !dev->ethtool_ops->get_rx_csum)
2297 return 0;
2298 return dev->ethtool_ops->get_rx_csum(dev);
2299}
2300
2301static inline u32 dev_ethtool_get_flags(struct net_device *dev)
2302{
2303 if (!dev->ethtool_ops || !dev->ethtool_ops->get_flags)
2304 return 0;
2305 return dev->ethtool_ops->get_flags(dev);
2306}
2307
2308/* Logging, debugging and troubleshooting/diagnostic helpers. */
2309
2310/* netdev_printk helpers, similar to dev_printk */
2311
2312static inline const char *netdev_name(const struct net_device *dev)
2313{
2314 if (dev->reg_state != NETREG_REGISTERED)
2315 return "(unregistered net_device)";
2316 return dev->name;
2317}
2318
2319extern int netdev_printk(const char *level, const struct net_device *dev,
2320 const char *format, ...)
2321 __attribute__ ((format (printf, 3, 4)));
2322extern int netdev_emerg(const struct net_device *dev, const char *format, ...)
2323 __attribute__ ((format (printf, 2, 3)));
2324extern int netdev_alert(const struct net_device *dev, const char *format, ...)
2325 __attribute__ ((format (printf, 2, 3)));
2326extern int netdev_crit(const struct net_device *dev, const char *format, ...)
2327 __attribute__ ((format (printf, 2, 3)));
2328extern int netdev_err(const struct net_device *dev, const char *format, ...)
2329 __attribute__ ((format (printf, 2, 3)));
2330extern int netdev_warn(const struct net_device *dev, const char *format, ...)
2331 __attribute__ ((format (printf, 2, 3)));
2332extern int netdev_notice(const struct net_device *dev, const char *format, ...)
2333 __attribute__ ((format (printf, 2, 3)));
2334extern int netdev_info(const struct net_device *dev, const char *format, ...)
2335 __attribute__ ((format (printf, 2, 3)));
2336
2337#if defined(DEBUG)
2338#define netdev_dbg(__dev, format, args...) \
2339 netdev_printk(KERN_DEBUG, __dev, format, ##args)
2340#elif defined(CONFIG_DYNAMIC_DEBUG)
2341#define netdev_dbg(__dev, format, args...) \
2342do { \
2343 dynamic_dev_dbg((__dev)->dev.parent, "%s: " format, \
2344 netdev_name(__dev), ##args); \
2345} while (0)
2346#else
2347#define netdev_dbg(__dev, format, args...) \
2348({ \
2349 if (0) \
2350 netdev_printk(KERN_DEBUG, __dev, format, ##args); \
2351 0; \
2352})
2353#endif
2354
2355#if defined(VERBOSE_DEBUG)
2356#define netdev_vdbg netdev_dbg
2357#else
2358
2359#define netdev_vdbg(dev, format, args...) \
2360({ \
2361 if (0) \
2362 netdev_printk(KERN_DEBUG, dev, format, ##args); \
2363 0; \
2364})
2365#endif
2366
2367/*
2368 * netdev_WARN() acts like dev_printk(), but with the key difference
2369 * of using a WARN/WARN_ON to get the message out, including the
2370 * file/line information and a backtrace.
2371 */
2372#define netdev_WARN(dev, format, args...) \
2373 WARN(1, "netdevice: %s\n" format, netdev_name(dev), ##args);
2374
2375/* netif printk helpers, similar to netdev_printk */
2376
2377#define netif_printk(priv, type, level, dev, fmt, args...) \
2378do { \
2379 if (netif_msg_##type(priv)) \
2380 netdev_printk(level, (dev), fmt, ##args); \
2381} while (0)
2382
2383#define netif_level(level, priv, type, dev, fmt, args...) \
2384do { \
2385 if (netif_msg_##type(priv)) \
2386 netdev_##level(dev, fmt, ##args); \
2387} while (0)
2388
2389#define netif_emerg(priv, type, dev, fmt, args...) \
2390 netif_level(emerg, priv, type, dev, fmt, ##args)
2391#define netif_alert(priv, type, dev, fmt, args...) \
2392 netif_level(alert, priv, type, dev, fmt, ##args)
2393#define netif_crit(priv, type, dev, fmt, args...) \
2394 netif_level(crit, priv, type, dev, fmt, ##args)
2395#define netif_err(priv, type, dev, fmt, args...) \
2396 netif_level(err, priv, type, dev, fmt, ##args)
2397#define netif_warn(priv, type, dev, fmt, args...) \
2398 netif_level(warn, priv, type, dev, fmt, ##args)
2399#define netif_notice(priv, type, dev, fmt, args...) \
2400 netif_level(notice, priv, type, dev, fmt, ##args)
2401#define netif_info(priv, type, dev, fmt, args...) \
2402 netif_level(info, priv, type, dev, fmt, ##args)
2403
2404#if defined(DEBUG)
2405#define netif_dbg(priv, type, dev, format, args...) \
2406 netif_printk(priv, type, KERN_DEBUG, dev, format, ##args)
2407#elif defined(CONFIG_DYNAMIC_DEBUG)
2408#define netif_dbg(priv, type, netdev, format, args...) \
2409do { \
2410 if (netif_msg_##type(priv)) \
2411 dynamic_dev_dbg((netdev)->dev.parent, \
2412 "%s: " format, \
2413 netdev_name(netdev), ##args); \
2414} while (0)
2415#else
2416#define netif_dbg(priv, type, dev, format, args...) \
2417({ \
2418 if (0) \
2419 netif_printk(priv, type, KERN_DEBUG, dev, format, ##args); \
2420 0; \
2421})
2422#endif
2423
2424#if defined(VERBOSE_DEBUG)
2425#define netif_vdbg netif_dbg
2426#else
2427#define netif_vdbg(priv, type, dev, format, args...) \
2428({ \
2429 if (0) \
2430 netif_printk(priv, type, KERN_DEBUG, dev, format, ##args); \
2431 0; \
2432})
2433#endif
2434
2435#endif /* __KERNEL__ */
2436
2437#endif /* _LINUX_NETDEVICE_H */