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.
6 * Definitions for the Interfaces handler.
8 * Version: @(#)dev.h 1.0.10 08/12/93
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>
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.
23 * Moved to /usr/include/linux for NET3
25 #ifndef _LINUX_NETDEVICE_H
26 #define _LINUX_NETDEVICE_H
29 #include <linux/if_ether.h>
30 #include <linux/if_packet.h>
33 #include <linux/timer.h>
34 #include <linux/delay.h>
35 #include <asm/atomic.h>
36 #include <asm/cache.h>
37 #include <asm/byteorder.h>
39 #include <linux/device.h>
40 #include <linux/percpu.h>
41 #include <linux/dmaengine.h>
42 #include <linux/workqueue.h>
44 #include <net/net_namespace.h>
47 #include <net/dcbnl.h>
55 /* source back-compat hooks */
56 #define SET_ETHTOOL_OPS(netdev,ops) \
57 ( (netdev)->ethtool_ops = (ops) )
59 #define HAVE_ALLOC_NETDEV /* feature macro: alloc_xxxdev
60 functions are available. */
61 #define HAVE_FREE_NETDEV /* free_netdev() */
62 #define HAVE_NETDEV_PRIV /* netdev_priv() */
64 #define NET_XMIT_SUCCESS 0
65 #define NET_XMIT_DROP 1 /* skb dropped */
66 #define NET_XMIT_CN 2 /* congestion notification */
67 #define NET_XMIT_POLICED 3 /* skb is shot by police */
68 #define NET_XMIT_MASK 0xFFFF /* qdisc flags in net/sch_generic.h */
70 /* Backlog congestion levels */
71 #define NET_RX_SUCCESS 0 /* keep 'em coming, baby */
72 #define NET_RX_DROP 1 /* packet dropped */
73 #define NET_RX_CN_LOW 2 /* storm alert, just in case */
74 #define NET_RX_CN_MOD 3 /* Storm on its way! */
75 #define NET_RX_CN_HIGH 4 /* The storm is here */
76 #define NET_RX_BAD 5 /* packet dropped due to kernel error */
78 /* NET_XMIT_CN is special. It does not guarantee that this packet is lost. It
79 * indicates that the device will soon be dropping packets, or already drops
80 * some packets of the same priority; prompting us to send less aggressively. */
81 #define net_xmit_eval(e) ((e) == NET_XMIT_CN? 0 : (e))
82 #define net_xmit_errno(e) ((e) != NET_XMIT_CN ? -ENOBUFS : 0)
86 #define MAX_ADDR_LEN 32 /* Largest hardware address length */
88 /* Driver transmit return codes */
89 #define NETDEV_TX_OK 0 /* driver took care of packet */
90 #define NETDEV_TX_BUSY 1 /* driver tx path was busy*/
91 #define NETDEV_TX_LOCKED -1 /* driver tx lock was already taken */
96 * Compute the worst case header length according to the protocols
100 #if defined(CONFIG_WLAN_80211) || defined(CONFIG_AX25) || defined(CONFIG_AX25_MODULE)
101 # if defined(CONFIG_MAC80211_MESH)
102 # define LL_MAX_HEADER 128
104 # define LL_MAX_HEADER 96
106 #elif defined(CONFIG_TR)
107 # define LL_MAX_HEADER 48
109 # define LL_MAX_HEADER 32
112 #if !defined(CONFIG_NET_IPIP) && !defined(CONFIG_NET_IPIP_MODULE) && \
113 !defined(CONFIG_NET_IPGRE) && !defined(CONFIG_NET_IPGRE_MODULE) && \
114 !defined(CONFIG_IPV6_SIT) && !defined(CONFIG_IPV6_SIT_MODULE) && \
115 !defined(CONFIG_IPV6_TUNNEL) && !defined(CONFIG_IPV6_TUNNEL_MODULE)
116 #define MAX_HEADER LL_MAX_HEADER
118 #define MAX_HEADER (LL_MAX_HEADER + 48)
121 #endif /* __KERNEL__ */
124 * Network device statistics. Akin to the 2.0 ether stats but
125 * with byte counters.
128 struct net_device_stats
130 unsigned long rx_packets
; /* total packets received */
131 unsigned long tx_packets
; /* total packets transmitted */
132 unsigned long rx_bytes
; /* total bytes received */
133 unsigned long tx_bytes
; /* total bytes transmitted */
134 unsigned long rx_errors
; /* bad packets received */
135 unsigned long tx_errors
; /* packet transmit problems */
136 unsigned long rx_dropped
; /* no space in linux buffers */
137 unsigned long tx_dropped
; /* no space available in linux */
138 unsigned long multicast
; /* multicast packets received */
139 unsigned long collisions
;
141 /* detailed rx_errors: */
142 unsigned long rx_length_errors
;
143 unsigned long rx_over_errors
; /* receiver ring buff overflow */
144 unsigned long rx_crc_errors
; /* recved pkt with crc error */
145 unsigned long rx_frame_errors
; /* recv'd frame alignment error */
146 unsigned long rx_fifo_errors
; /* recv'r fifo overrun */
147 unsigned long rx_missed_errors
; /* receiver missed packet */
149 /* detailed tx_errors */
150 unsigned long tx_aborted_errors
;
151 unsigned long tx_carrier_errors
;
152 unsigned long tx_fifo_errors
;
153 unsigned long tx_heartbeat_errors
;
154 unsigned long tx_window_errors
;
157 unsigned long rx_compressed
;
158 unsigned long tx_compressed
;
162 /* Media selection options. */
175 #include <linux/cache.h>
176 #include <linux/skbuff.h>
182 struct netif_rx_stats
186 unsigned time_squeeze
;
187 unsigned cpu_collision
;
190 DECLARE_PER_CPU(struct netif_rx_stats
, netdev_rx_stat
);
194 struct dev_addr_list
*next
;
195 u8 da_addr
[MAX_ADDR_LEN
];
203 * We tag multicasts with these structures.
206 #define dev_mc_list dev_addr_list
207 #define dmi_addr da_addr
208 #define dmi_addrlen da_addrlen
209 #define dmi_users da_users
210 #define dmi_gusers da_gusers
214 struct hh_cache
*hh_next
; /* Next entry */
215 atomic_t hh_refcnt
; /* number of users */
217 * We want hh_output, hh_len, hh_lock and hh_data be a in a separate
219 * They are mostly read, but hh_refcnt may be changed quite frequently,
220 * incurring cache line ping pongs.
222 __be16 hh_type ____cacheline_aligned_in_smp
;
223 /* protocol identifier, f.e ETH_P_IP
224 * NOTE: For VLANs, this will be the
225 * encapuslated type. --BLG
227 u16 hh_len
; /* length of header */
228 int (*hh_output
)(struct sk_buff
*skb
);
231 /* cached hardware header; allow for machine alignment needs. */
232 #define HH_DATA_MOD 16
233 #define HH_DATA_OFF(__len) \
234 (HH_DATA_MOD - (((__len - 1) & (HH_DATA_MOD - 1)) + 1))
235 #define HH_DATA_ALIGN(__len) \
236 (((__len)+(HH_DATA_MOD-1))&~(HH_DATA_MOD - 1))
237 unsigned long hh_data
[HH_DATA_ALIGN(LL_MAX_HEADER
) / sizeof(long)];
240 /* Reserve HH_DATA_MOD byte aligned hard_header_len, but at least that much.
242 * dev->hard_header_len ? (dev->hard_header_len +
243 * (HH_DATA_MOD - 1)) & ~(HH_DATA_MOD - 1) : 0
245 * We could use other alignment values, but we must maintain the
246 * relationship HH alignment <= LL alignment.
248 * LL_ALLOCATED_SPACE also takes into account the tailroom the device
251 #define LL_RESERVED_SPACE(dev) \
252 ((((dev)->hard_header_len+(dev)->needed_headroom)&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
253 #define LL_RESERVED_SPACE_EXTRA(dev,extra) \
254 ((((dev)->hard_header_len+(dev)->needed_headroom+(extra))&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
255 #define LL_ALLOCATED_SPACE(dev) \
256 ((((dev)->hard_header_len+(dev)->needed_headroom+(dev)->needed_tailroom)&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
259 int (*create
) (struct sk_buff
*skb
, struct net_device
*dev
,
260 unsigned short type
, const void *daddr
,
261 const void *saddr
, unsigned len
);
262 int (*parse
)(const struct sk_buff
*skb
, unsigned char *haddr
);
263 int (*rebuild
)(struct sk_buff
*skb
);
264 #define HAVE_HEADER_CACHE
265 int (*cache
)(const struct neighbour
*neigh
, struct hh_cache
*hh
);
266 void (*cache_update
)(struct hh_cache
*hh
,
267 const struct net_device
*dev
,
268 const unsigned char *haddr
);
271 /* These flag bits are private to the generic network queueing
272 * layer, they may not be explicitly referenced by any other
279 __LINK_STATE_PRESENT
,
280 __LINK_STATE_NOCARRIER
,
281 __LINK_STATE_LINKWATCH_PENDING
,
282 __LINK_STATE_DORMANT
,
287 * This structure holds at boot time configured netdevice settings. They
288 * are then used in the device probing.
290 struct netdev_boot_setup
{
294 #define NETDEV_BOOT_SETUP_MAX 8
296 extern int __init
netdev_boot_setup(char *str
);
299 * Structure for NAPI scheduling similar to tasklet but with weighting
302 /* The poll_list must only be managed by the entity which
303 * changes the state of the NAPI_STATE_SCHED bit. This means
304 * whoever atomically sets that bit can add this napi_struct
305 * to the per-cpu poll_list, and whoever clears that bit
306 * can remove from the list right before clearing the bit.
308 struct list_head poll_list
;
312 int (*poll
)(struct napi_struct
*, int);
313 #ifdef CONFIG_NETPOLL
314 spinlock_t poll_lock
;
317 struct net_device
*dev
;
318 struct list_head dev_list
;
319 struct sk_buff
*gro_list
;
325 NAPI_STATE_SCHED
, /* Poll is scheduled */
326 NAPI_STATE_DISABLE
, /* Disable pending */
327 NAPI_STATE_NPSVC
, /* Netpoll - don't dequeue from poll_list */
330 extern void __napi_schedule(struct napi_struct
*n
);
332 static inline int napi_disable_pending(struct napi_struct
*n
)
334 return test_bit(NAPI_STATE_DISABLE
, &n
->state
);
338 * napi_schedule_prep - check if napi can be scheduled
341 * Test if NAPI routine is already running, and if not mark
342 * it as running. This is used as a condition variable
343 * insure only one NAPI poll instance runs. We also make
344 * sure there is no pending NAPI disable.
346 static inline int napi_schedule_prep(struct napi_struct
*n
)
348 return !napi_disable_pending(n
) &&
349 !test_and_set_bit(NAPI_STATE_SCHED
, &n
->state
);
353 * napi_schedule - schedule NAPI poll
356 * Schedule NAPI poll routine to be called if it is not already
359 static inline void napi_schedule(struct napi_struct
*n
)
361 if (napi_schedule_prep(n
))
365 /* Try to reschedule poll. Called by dev->poll() after napi_complete(). */
366 static inline int napi_reschedule(struct napi_struct
*napi
)
368 if (napi_schedule_prep(napi
)) {
369 __napi_schedule(napi
);
376 * napi_complete - NAPI processing complete
379 * Mark NAPI processing as complete.
381 extern void __napi_complete(struct napi_struct
*n
);
382 extern void napi_complete(struct napi_struct
*n
);
385 * napi_disable - prevent NAPI from scheduling
388 * Stop NAPI from being scheduled on this context.
389 * Waits till any outstanding processing completes.
391 static inline void napi_disable(struct napi_struct
*n
)
393 set_bit(NAPI_STATE_DISABLE
, &n
->state
);
394 while (test_and_set_bit(NAPI_STATE_SCHED
, &n
->state
))
396 clear_bit(NAPI_STATE_DISABLE
, &n
->state
);
400 * napi_enable - enable NAPI scheduling
403 * Resume NAPI from being scheduled on this context.
404 * Must be paired with napi_disable.
406 static inline void napi_enable(struct napi_struct
*n
)
408 BUG_ON(!test_bit(NAPI_STATE_SCHED
, &n
->state
));
409 smp_mb__before_clear_bit();
410 clear_bit(NAPI_STATE_SCHED
, &n
->state
);
415 * napi_synchronize - wait until NAPI is not running
418 * Wait until NAPI is done being scheduled on this context.
419 * Waits till any outstanding processing completes but
420 * does not disable future activations.
422 static inline void napi_synchronize(const struct napi_struct
*n
)
424 while (test_bit(NAPI_STATE_SCHED
, &n
->state
))
428 # define napi_synchronize(n) barrier()
431 enum netdev_queue_state_t
434 __QUEUE_STATE_FROZEN
,
437 struct netdev_queue
{
438 struct net_device
*dev
;
441 spinlock_t _xmit_lock
;
443 struct Qdisc
*qdisc_sleeping
;
444 } ____cacheline_aligned_in_smp
;
448 * This structure defines the management hooks for network devices.
449 * The following hooks can be defined; unless noted otherwise, they are
450 * optional and can be filled with a null pointer.
452 * int (*ndo_init)(struct net_device *dev);
453 * This function is called once when network device is registered.
454 * The network device can use this to any late stage initializaton
455 * or semantic validattion. It can fail with an error code which will
456 * be propogated back to register_netdev
458 * void (*ndo_uninit)(struct net_device *dev);
459 * This function is called when device is unregistered or when registration
460 * fails. It is not called if init fails.
462 * int (*ndo_open)(struct net_device *dev);
463 * This function is called when network device transistions to the up
466 * int (*ndo_stop)(struct net_device *dev);
467 * This function is called when network device transistions to the down
470 * int (*ndo_start_xmit)(struct sk_buff *skb, struct net_device *dev);
471 * Called when a packet needs to be transmitted.
472 * Must return NETDEV_TX_OK , NETDEV_TX_BUSY, or NETDEV_TX_LOCKED,
473 * Required can not be NULL.
475 * u16 (*ndo_select_queue)(struct net_device *dev, struct sk_buff *skb);
476 * Called to decide which queue to when device supports multiple
479 * void (*ndo_change_rx_flags)(struct net_device *dev, int flags);
480 * This function is called to allow device receiver to make
481 * changes to configuration when multicast or promiscious is enabled.
483 * void (*ndo_set_rx_mode)(struct net_device *dev);
484 * This function is called device changes address list filtering.
486 * void (*ndo_set_multicast_list)(struct net_device *dev);
487 * This function is called when the multicast address list changes.
489 * int (*ndo_set_mac_address)(struct net_device *dev, void *addr);
490 * This function is called when the Media Access Control address
491 * needs to be changed. If not this interface is not defined, the
492 * mac address can not be changed.
494 * int (*ndo_validate_addr)(struct net_device *dev);
495 * Test if Media Access Control address is valid for the device.
497 * int (*ndo_do_ioctl)(struct net_device *dev, struct ifreq *ifr, int cmd);
498 * Called when a user request an ioctl which can't be handled by
499 * the generic interface code. If not defined ioctl's return
500 * not supported error code.
502 * int (*ndo_set_config)(struct net_device *dev, struct ifmap *map);
503 * Used to set network devices bus interface parameters. This interface
504 * is retained for legacy reason, new devices should use the bus
505 * interface (PCI) for low level management.
507 * int (*ndo_change_mtu)(struct net_device *dev, int new_mtu);
508 * Called when a user wants to change the Maximum Transfer Unit
509 * of a device. If not defined, any request to change MTU will
510 * will return an error.
512 * void (*ndo_tx_timeout)(struct net_device *dev);
513 * Callback uses when the transmitter has not made any progress
514 * for dev->watchdog ticks.
516 * struct net_device_stats* (*get_stats)(struct net_device *dev);
517 * Called when a user wants to get the network device usage
518 * statistics. If not defined, the counters in dev->stats will
521 * void (*ndo_vlan_rx_register)(struct net_device *dev, struct vlan_group *grp);
522 * If device support VLAN receive accleration
523 * (ie. dev->features & NETIF_F_HW_VLAN_RX), then this function is called
524 * when vlan groups for the device changes. Note: grp is NULL
525 * if no vlan's groups are being used.
527 * void (*ndo_vlan_rx_add_vid)(struct net_device *dev, unsigned short vid);
528 * If device support VLAN filtering (dev->features & NETIF_F_HW_VLAN_FILTER)
529 * this function is called when a VLAN id is registered.
531 * void (*ndo_vlan_rx_kill_vid)(struct net_device *dev, unsigned short vid);
532 * If device support VLAN filtering (dev->features & NETIF_F_HW_VLAN_FILTER)
533 * this function is called when a VLAN id is unregistered.
535 * void (*ndo_poll_controller)(struct net_device *dev);
537 #define HAVE_NET_DEVICE_OPS
538 struct net_device_ops
{
539 int (*ndo_init
)(struct net_device
*dev
);
540 void (*ndo_uninit
)(struct net_device
*dev
);
541 int (*ndo_open
)(struct net_device
*dev
);
542 int (*ndo_stop
)(struct net_device
*dev
);
543 int (*ndo_start_xmit
) (struct sk_buff
*skb
,
544 struct net_device
*dev
);
545 u16 (*ndo_select_queue
)(struct net_device
*dev
,
546 struct sk_buff
*skb
);
547 #define HAVE_CHANGE_RX_FLAGS
548 void (*ndo_change_rx_flags
)(struct net_device
*dev
,
550 #define HAVE_SET_RX_MODE
551 void (*ndo_set_rx_mode
)(struct net_device
*dev
);
552 #define HAVE_MULTICAST
553 void (*ndo_set_multicast_list
)(struct net_device
*dev
);
554 #define HAVE_SET_MAC_ADDR
555 int (*ndo_set_mac_address
)(struct net_device
*dev
,
557 #define HAVE_VALIDATE_ADDR
558 int (*ndo_validate_addr
)(struct net_device
*dev
);
559 #define HAVE_PRIVATE_IOCTL
560 int (*ndo_do_ioctl
)(struct net_device
*dev
,
561 struct ifreq
*ifr
, int cmd
);
562 #define HAVE_SET_CONFIG
563 int (*ndo_set_config
)(struct net_device
*dev
,
565 #define HAVE_CHANGE_MTU
566 int (*ndo_change_mtu
)(struct net_device
*dev
,
568 int (*ndo_neigh_setup
)(struct net_device
*dev
,
569 struct neigh_parms
*);
570 #define HAVE_TX_TIMEOUT
571 void (*ndo_tx_timeout
) (struct net_device
*dev
);
573 struct net_device_stats
* (*ndo_get_stats
)(struct net_device
*dev
);
575 void (*ndo_vlan_rx_register
)(struct net_device
*dev
,
576 struct vlan_group
*grp
);
577 void (*ndo_vlan_rx_add_vid
)(struct net_device
*dev
,
579 void (*ndo_vlan_rx_kill_vid
)(struct net_device
*dev
,
581 #ifdef CONFIG_NET_POLL_CONTROLLER
582 #define HAVE_NETDEV_POLL
583 void (*ndo_poll_controller
)(struct net_device
*dev
);
588 * The DEVICE structure.
589 * Actually, this whole structure is a big mistake. It mixes I/O
590 * data with strictly "high-level" data, and it has to know about
591 * almost every data structure used in the INET module.
593 * FIXME: cleanup struct net_device such that network protocol info
601 * This is the first field of the "visible" part of this structure
602 * (i.e. as seen by users in the "Space.c" file). It is the name
606 /* device name hash chain */
607 struct hlist_node name_hlist
;
612 * I/O specific fields
613 * FIXME: Merge these and struct ifmap into one
615 unsigned long mem_end
; /* shared mem end */
616 unsigned long mem_start
; /* shared mem start */
617 unsigned long base_addr
; /* device I/O address */
618 unsigned int irq
; /* device IRQ number */
621 * Some hardware also needs these fields, but they are not
622 * part of the usual set specified in Space.c.
625 unsigned char if_port
; /* Selectable AUI, TP,..*/
626 unsigned char dma
; /* DMA channel */
630 struct list_head dev_list
;
631 struct list_head napi_list
;
633 /* Net device features */
634 unsigned long features
;
635 #define NETIF_F_SG 1 /* Scatter/gather IO. */
636 #define NETIF_F_IP_CSUM 2 /* Can checksum TCP/UDP over IPv4. */
637 #define NETIF_F_NO_CSUM 4 /* Does not require checksum. F.e. loopack. */
638 #define NETIF_F_HW_CSUM 8 /* Can checksum all the packets. */
639 #define NETIF_F_IPV6_CSUM 16 /* Can checksum TCP/UDP over IPV6 */
640 #define NETIF_F_HIGHDMA 32 /* Can DMA to high memory. */
641 #define NETIF_F_FRAGLIST 64 /* Scatter/gather IO. */
642 #define NETIF_F_HW_VLAN_TX 128 /* Transmit VLAN hw acceleration */
643 #define NETIF_F_HW_VLAN_RX 256 /* Receive VLAN hw acceleration */
644 #define NETIF_F_HW_VLAN_FILTER 512 /* Receive filtering on VLAN */
645 #define NETIF_F_VLAN_CHALLENGED 1024 /* Device cannot handle VLAN packets */
646 #define NETIF_F_GSO 2048 /* Enable software GSO. */
647 #define NETIF_F_LLTX 4096 /* LockLess TX - deprecated. Please */
648 /* do not use LLTX in new drivers */
649 #define NETIF_F_NETNS_LOCAL 8192 /* Does not change network namespaces */
650 #define NETIF_F_GRO 16384 /* Generic receive offload */
651 #define NETIF_F_LRO 32768 /* large receive offload */
653 #define NETIF_F_FCOE_CRC (1 << 24) /* FCoE CRC32 */
655 /* Segmentation offload features */
656 #define NETIF_F_GSO_SHIFT 16
657 #define NETIF_F_GSO_MASK 0x00ff0000
658 #define NETIF_F_TSO (SKB_GSO_TCPV4 << NETIF_F_GSO_SHIFT)
659 #define NETIF_F_UFO (SKB_GSO_UDP << NETIF_F_GSO_SHIFT)
660 #define NETIF_F_GSO_ROBUST (SKB_GSO_DODGY << NETIF_F_GSO_SHIFT)
661 #define NETIF_F_TSO_ECN (SKB_GSO_TCP_ECN << NETIF_F_GSO_SHIFT)
662 #define NETIF_F_TSO6 (SKB_GSO_TCPV6 << NETIF_F_GSO_SHIFT)
663 #define NETIF_F_FSO (SKB_GSO_FCOE << NETIF_F_GSO_SHIFT)
665 /* List of features with software fallbacks. */
666 #define NETIF_F_GSO_SOFTWARE (NETIF_F_TSO | NETIF_F_TSO_ECN | NETIF_F_TSO6)
669 #define NETIF_F_GEN_CSUM (NETIF_F_NO_CSUM | NETIF_F_HW_CSUM)
670 #define NETIF_F_V4_CSUM (NETIF_F_GEN_CSUM | NETIF_F_IP_CSUM)
671 #define NETIF_F_V6_CSUM (NETIF_F_GEN_CSUM | NETIF_F_IPV6_CSUM)
672 #define NETIF_F_ALL_CSUM (NETIF_F_V4_CSUM | NETIF_F_V6_CSUM)
675 * If one device supports one of these features, then enable them
676 * for all in netdev_increment_features.
678 #define NETIF_F_ONE_FOR_ALL (NETIF_F_GSO_SOFTWARE | NETIF_F_GSO_ROBUST | \
679 NETIF_F_SG | NETIF_F_HIGHDMA | \
682 /* Interface index. Unique device identifier */
686 struct net_device_stats stats
;
688 #ifdef CONFIG_WIRELESS_EXT
689 /* List of functions to handle Wireless Extensions (instead of ioctl).
690 * See <net/iw_handler.h> for details. Jean II */
691 const struct iw_handler_def
* wireless_handlers
;
692 /* Instance data managed by the core of Wireless Extensions. */
693 struct iw_public_data
* wireless_data
;
695 /* Management operations */
696 const struct net_device_ops
*netdev_ops
;
697 const struct ethtool_ops
*ethtool_ops
;
699 /* Hardware header description */
700 const struct header_ops
*header_ops
;
702 unsigned int flags
; /* interface flags (a la BSD) */
703 unsigned short gflags
;
704 unsigned short priv_flags
; /* Like 'flags' but invisible to userspace. */
705 unsigned short padded
; /* How much padding added by alloc_netdev() */
707 unsigned char operstate
; /* RFC2863 operstate */
708 unsigned char link_mode
; /* mapping policy to operstate */
710 unsigned mtu
; /* interface MTU value */
711 unsigned short type
; /* interface hardware type */
712 unsigned short hard_header_len
; /* hardware hdr length */
714 /* extra head- and tailroom the hardware may need, but not in all cases
715 * can this be guaranteed, especially tailroom. Some cases also use
716 * LL_MAX_HEADER instead to allocate the skb.
718 unsigned short needed_headroom
;
719 unsigned short needed_tailroom
;
721 struct net_device
*master
; /* Pointer to master device of a group,
722 * which this device is member of.
725 /* Interface address info. */
726 unsigned char perm_addr
[MAX_ADDR_LEN
]; /* permanent hw address */
727 unsigned char addr_len
; /* hardware address length */
728 unsigned short dev_id
; /* for shared network cards */
730 spinlock_t addr_list_lock
;
731 struct dev_addr_list
*uc_list
; /* Secondary unicast mac addresses */
732 int uc_count
; /* Number of installed ucasts */
734 struct dev_addr_list
*mc_list
; /* Multicast mac addresses */
735 int mc_count
; /* Number of installed mcasts */
736 unsigned int promiscuity
;
737 unsigned int allmulti
;
740 /* Protocol specific pointers */
742 #ifdef CONFIG_NET_DSA
743 void *dsa_ptr
; /* dsa specific data */
745 void *atalk_ptr
; /* AppleTalk link */
746 void *ip_ptr
; /* IPv4 specific data */
747 void *dn_ptr
; /* DECnet specific data */
748 void *ip6_ptr
; /* IPv6 specific data */
749 void *ec_ptr
; /* Econet specific data */
750 void *ax25_ptr
; /* AX.25 specific data */
751 struct wireless_dev
*ieee80211_ptr
; /* IEEE 802.11 specific data,
752 assign before registering */
755 * Cache line mostly used on receive path (including eth_type_trans())
757 unsigned long last_rx
; /* Time of last Rx */
758 /* Interface address info used in eth_type_trans() */
759 unsigned char dev_addr
[MAX_ADDR_LEN
]; /* hw address, (before bcast
760 because most packets are unicast) */
762 unsigned char broadcast
[MAX_ADDR_LEN
]; /* hw bcast add */
764 struct netdev_queue rx_queue
;
766 struct netdev_queue
*_tx ____cacheline_aligned_in_smp
;
768 /* Number of TX queues allocated at alloc_netdev_mq() time */
769 unsigned int num_tx_queues
;
771 /* Number of TX queues currently active in device */
772 unsigned int real_num_tx_queues
;
774 unsigned long tx_queue_len
; /* Max frames per queue allowed */
775 spinlock_t tx_global_lock
;
777 * One part is mostly used on xmit path (device)
779 /* These may be needed for future network-power-down code. */
780 unsigned long trans_start
; /* Time (in jiffies) of last Tx */
782 int watchdog_timeo
; /* used by dev_watchdog() */
783 struct timer_list watchdog_timer
;
785 /* Number of references to this device */
786 atomic_t refcnt ____cacheline_aligned_in_smp
;
788 /* delayed register/unregister */
789 struct list_head todo_list
;
790 /* device index hash chain */
791 struct hlist_node index_hlist
;
793 struct net_device
*link_watch_next
;
795 /* register/unregister state machine */
796 enum { NETREG_UNINITIALIZED
=0,
797 NETREG_REGISTERED
, /* completed register_netdevice */
798 NETREG_UNREGISTERING
, /* called unregister_netdevice */
799 NETREG_UNREGISTERED
, /* completed unregister todo */
800 NETREG_RELEASED
, /* called free_netdev */
801 NETREG_DUMMY
, /* dummy device for NAPI poll */
804 /* Called from unregister, can be used to call free_netdev */
805 void (*destructor
)(struct net_device
*dev
);
807 #ifdef CONFIG_NETPOLL
808 struct netpoll_info
*npinfo
;
812 /* Network namespace this network device is inside */
816 /* mid-layer private */
820 struct net_bridge_port
*br_port
;
822 struct macvlan_port
*macvlan_port
;
824 struct garp_port
*garp_port
;
826 /* class/net/name entry */
828 /* space for optional statistics and wireless sysfs groups */
829 struct attribute_group
*sysfs_groups
[3];
831 /* rtnetlink link ops */
832 const struct rtnl_link_ops
*rtnl_link_ops
;
834 /* VLAN feature mask */
835 unsigned long vlan_features
;
837 /* for setting kernel sock attribute on TCP connection setup */
838 #define GSO_MAX_SIZE 65536
839 unsigned int gso_max_size
;
842 /* Data Center Bridging netlink ops */
843 struct dcbnl_rtnl_ops
*dcbnl_ops
;
846 #ifdef CONFIG_COMPAT_NET_DEV_OPS
848 int (*init
)(struct net_device
*dev
);
849 void (*uninit
)(struct net_device
*dev
);
850 int (*open
)(struct net_device
*dev
);
851 int (*stop
)(struct net_device
*dev
);
852 int (*hard_start_xmit
) (struct sk_buff
*skb
,
853 struct net_device
*dev
);
854 u16 (*select_queue
)(struct net_device
*dev
,
855 struct sk_buff
*skb
);
856 void (*change_rx_flags
)(struct net_device
*dev
,
858 void (*set_rx_mode
)(struct net_device
*dev
);
859 void (*set_multicast_list
)(struct net_device
*dev
);
860 int (*set_mac_address
)(struct net_device
*dev
,
862 int (*validate_addr
)(struct net_device
*dev
);
863 int (*do_ioctl
)(struct net_device
*dev
,
864 struct ifreq
*ifr
, int cmd
);
865 int (*set_config
)(struct net_device
*dev
,
867 int (*change_mtu
)(struct net_device
*dev
, int new_mtu
);
868 int (*neigh_setup
)(struct net_device
*dev
,
869 struct neigh_parms
*);
870 void (*tx_timeout
) (struct net_device
*dev
);
871 struct net_device_stats
* (*get_stats
)(struct net_device
*dev
);
872 void (*vlan_rx_register
)(struct net_device
*dev
,
873 struct vlan_group
*grp
);
874 void (*vlan_rx_add_vid
)(struct net_device
*dev
,
876 void (*vlan_rx_kill_vid
)(struct net_device
*dev
,
878 #ifdef CONFIG_NET_POLL_CONTROLLER
879 void (*poll_controller
)(struct net_device
*dev
);
884 #define to_net_dev(d) container_of(d, struct net_device, dev)
886 #define NETDEV_ALIGN 32
887 #define NETDEV_ALIGN_CONST (NETDEV_ALIGN - 1)
890 struct netdev_queue
*netdev_get_tx_queue(const struct net_device
*dev
,
893 return &dev
->_tx
[index
];
896 static inline void netdev_for_each_tx_queue(struct net_device
*dev
,
897 void (*f
)(struct net_device
*,
898 struct netdev_queue
*,
904 for (i
= 0; i
< dev
->num_tx_queues
; i
++)
905 f(dev
, &dev
->_tx
[i
], arg
);
909 * Net namespace inlines
912 struct net
*dev_net(const struct net_device
*dev
)
922 void dev_net_set(struct net_device
*dev
, struct net
*net
)
925 release_net(dev
->nd_net
);
926 dev
->nd_net
= hold_net(net
);
930 static inline bool netdev_uses_dsa_tags(struct net_device
*dev
)
932 #ifdef CONFIG_NET_DSA_TAG_DSA
933 if (dev
->dsa_ptr
!= NULL
)
934 return dsa_uses_dsa_tags(dev
->dsa_ptr
);
940 static inline bool netdev_uses_trailer_tags(struct net_device
*dev
)
942 #ifdef CONFIG_NET_DSA_TAG_TRAILER
943 if (dev
->dsa_ptr
!= NULL
)
944 return dsa_uses_trailer_tags(dev
->dsa_ptr
);
951 * netdev_priv - access network device private data
952 * @dev: network device
954 * Get network device private data
956 static inline void *netdev_priv(const struct net_device
*dev
)
958 return (char *)dev
+ ((sizeof(struct net_device
)
959 + NETDEV_ALIGN_CONST
)
960 & ~NETDEV_ALIGN_CONST
);
963 /* Set the sysfs physical device reference for the network logical device
964 * if set prior to registration will cause a symlink during initialization.
966 #define SET_NETDEV_DEV(net, pdev) ((net)->dev.parent = (pdev))
969 * netif_napi_add - initialize a napi context
970 * @dev: network device
971 * @napi: napi context
972 * @poll: polling function
973 * @weight: default weight
975 * netif_napi_add() must be used to initialize a napi context prior to calling
976 * *any* of the other napi related functions.
978 void netif_napi_add(struct net_device
*dev
, struct napi_struct
*napi
,
979 int (*poll
)(struct napi_struct
*, int), int weight
);
982 * netif_napi_del - remove a napi context
983 * @napi: napi context
985 * netif_napi_del() removes a napi context from the network device napi list
987 void netif_napi_del(struct napi_struct
*napi
);
990 /* This is non-zero if the packet may be of the same flow. */
993 /* This is non-zero if the packet cannot be merged with the new skb. */
996 /* Number of segments aggregated. */
1003 #define NAPI_GRO_CB(skb) ((struct napi_gro_cb *)(skb)->cb)
1005 struct packet_type
{
1006 __be16 type
; /* This is really htons(ether_type). */
1007 struct net_device
*dev
; /* NULL is wildcarded here */
1008 int (*func
) (struct sk_buff
*,
1009 struct net_device
*,
1010 struct packet_type
*,
1011 struct net_device
*);
1012 struct sk_buff
*(*gso_segment
)(struct sk_buff
*skb
,
1014 int (*gso_send_check
)(struct sk_buff
*skb
);
1015 struct sk_buff
**(*gro_receive
)(struct sk_buff
**head
,
1016 struct sk_buff
*skb
);
1017 int (*gro_complete
)(struct sk_buff
*skb
);
1018 void *af_packet_priv
;
1019 struct list_head list
;
1022 struct napi_gro_fraginfo
{
1023 skb_frag_t frags
[MAX_SKB_FRAGS
];
1024 unsigned int nr_frags
;
1025 unsigned int ip_summed
;
1030 #include <linux/interrupt.h>
1031 #include <linux/notifier.h>
1033 extern rwlock_t dev_base_lock
; /* Device list lock */
1036 #define for_each_netdev(net, d) \
1037 list_for_each_entry(d, &(net)->dev_base_head, dev_list)
1038 #define for_each_netdev_safe(net, d, n) \
1039 list_for_each_entry_safe(d, n, &(net)->dev_base_head, dev_list)
1040 #define for_each_netdev_continue(net, d) \
1041 list_for_each_entry_continue(d, &(net)->dev_base_head, dev_list)
1042 #define net_device_entry(lh) list_entry(lh, struct net_device, dev_list)
1044 static inline struct net_device
*next_net_device(struct net_device
*dev
)
1046 struct list_head
*lh
;
1050 lh
= dev
->dev_list
.next
;
1051 return lh
== &net
->dev_base_head
? NULL
: net_device_entry(lh
);
1054 static inline struct net_device
*first_net_device(struct net
*net
)
1056 return list_empty(&net
->dev_base_head
) ? NULL
:
1057 net_device_entry(net
->dev_base_head
.next
);
1060 extern int netdev_boot_setup_check(struct net_device
*dev
);
1061 extern unsigned long netdev_boot_base(const char *prefix
, int unit
);
1062 extern struct net_device
*dev_getbyhwaddr(struct net
*net
, unsigned short type
, char *hwaddr
);
1063 extern struct net_device
*dev_getfirstbyhwtype(struct net
*net
, unsigned short type
);
1064 extern struct net_device
*__dev_getfirstbyhwtype(struct net
*net
, unsigned short type
);
1065 extern void dev_add_pack(struct packet_type
*pt
);
1066 extern void dev_remove_pack(struct packet_type
*pt
);
1067 extern void __dev_remove_pack(struct packet_type
*pt
);
1069 extern struct net_device
*dev_get_by_flags(struct net
*net
, unsigned short flags
,
1070 unsigned short mask
);
1071 extern struct net_device
*dev_get_by_name(struct net
*net
, const char *name
);
1072 extern struct net_device
*__dev_get_by_name(struct net
*net
, const char *name
);
1073 extern int dev_alloc_name(struct net_device
*dev
, const char *name
);
1074 extern int dev_open(struct net_device
*dev
);
1075 extern int dev_close(struct net_device
*dev
);
1076 extern void dev_disable_lro(struct net_device
*dev
);
1077 extern int dev_queue_xmit(struct sk_buff
*skb
);
1078 extern int register_netdevice(struct net_device
*dev
);
1079 extern void unregister_netdevice(struct net_device
*dev
);
1080 extern void free_netdev(struct net_device
*dev
);
1081 extern void synchronize_net(void);
1082 extern int register_netdevice_notifier(struct notifier_block
*nb
);
1083 extern int unregister_netdevice_notifier(struct notifier_block
*nb
);
1084 extern int init_dummy_netdev(struct net_device
*dev
);
1086 extern int call_netdevice_notifiers(unsigned long val
, struct net_device
*dev
);
1087 extern struct net_device
*dev_get_by_index(struct net
*net
, int ifindex
);
1088 extern struct net_device
*__dev_get_by_index(struct net
*net
, int ifindex
);
1089 extern int dev_restart(struct net_device
*dev
);
1090 #ifdef CONFIG_NETPOLL_TRAP
1091 extern int netpoll_trap(void);
1094 static inline int dev_hard_header(struct sk_buff
*skb
, struct net_device
*dev
,
1095 unsigned short type
,
1096 const void *daddr
, const void *saddr
,
1099 if (!dev
->header_ops
|| !dev
->header_ops
->create
)
1102 return dev
->header_ops
->create(skb
, dev
, type
, daddr
, saddr
, len
);
1105 static inline int dev_parse_header(const struct sk_buff
*skb
,
1106 unsigned char *haddr
)
1108 const struct net_device
*dev
= skb
->dev
;
1110 if (!dev
->header_ops
|| !dev
->header_ops
->parse
)
1112 return dev
->header_ops
->parse(skb
, haddr
);
1115 typedef int gifconf_func_t(struct net_device
* dev
, char __user
* bufptr
, int len
);
1116 extern int register_gifconf(unsigned int family
, gifconf_func_t
* gifconf
);
1117 static inline int unregister_gifconf(unsigned int family
)
1119 return register_gifconf(family
, NULL
);
1123 * Incoming packets are placed on per-cpu queues so that
1124 * no locking is needed.
1128 struct Qdisc
*output_queue
;
1129 struct sk_buff_head input_pkt_queue
;
1130 struct list_head poll_list
;
1131 struct sk_buff
*completion_queue
;
1133 struct napi_struct backlog
;
1136 DECLARE_PER_CPU(struct softnet_data
,softnet_data
);
1138 #define HAVE_NETIF_QUEUE
1140 extern void __netif_schedule(struct Qdisc
*q
);
1142 static inline void netif_schedule_queue(struct netdev_queue
*txq
)
1144 if (!test_bit(__QUEUE_STATE_XOFF
, &txq
->state
))
1145 __netif_schedule(txq
->qdisc
);
1148 static inline void netif_tx_schedule_all(struct net_device
*dev
)
1152 for (i
= 0; i
< dev
->num_tx_queues
; i
++)
1153 netif_schedule_queue(netdev_get_tx_queue(dev
, i
));
1156 static inline void netif_tx_start_queue(struct netdev_queue
*dev_queue
)
1158 clear_bit(__QUEUE_STATE_XOFF
, &dev_queue
->state
);
1162 * netif_start_queue - allow transmit
1163 * @dev: network device
1165 * Allow upper layers to call the device hard_start_xmit routine.
1167 static inline void netif_start_queue(struct net_device
*dev
)
1169 netif_tx_start_queue(netdev_get_tx_queue(dev
, 0));
1172 static inline void netif_tx_start_all_queues(struct net_device
*dev
)
1176 for (i
= 0; i
< dev
->num_tx_queues
; i
++) {
1177 struct netdev_queue
*txq
= netdev_get_tx_queue(dev
, i
);
1178 netif_tx_start_queue(txq
);
1182 static inline void netif_tx_wake_queue(struct netdev_queue
*dev_queue
)
1184 #ifdef CONFIG_NETPOLL_TRAP
1185 if (netpoll_trap()) {
1186 clear_bit(__QUEUE_STATE_XOFF
, &dev_queue
->state
);
1190 if (test_and_clear_bit(__QUEUE_STATE_XOFF
, &dev_queue
->state
))
1191 __netif_schedule(dev_queue
->qdisc
);
1195 * netif_wake_queue - restart transmit
1196 * @dev: network device
1198 * Allow upper layers to call the device hard_start_xmit routine.
1199 * Used for flow control when transmit resources are available.
1201 static inline void netif_wake_queue(struct net_device
*dev
)
1203 netif_tx_wake_queue(netdev_get_tx_queue(dev
, 0));
1206 static inline void netif_tx_wake_all_queues(struct net_device
*dev
)
1210 for (i
= 0; i
< dev
->num_tx_queues
; i
++) {
1211 struct netdev_queue
*txq
= netdev_get_tx_queue(dev
, i
);
1212 netif_tx_wake_queue(txq
);
1216 static inline void netif_tx_stop_queue(struct netdev_queue
*dev_queue
)
1218 set_bit(__QUEUE_STATE_XOFF
, &dev_queue
->state
);
1222 * netif_stop_queue - stop transmitted packets
1223 * @dev: network device
1225 * Stop upper layers calling the device hard_start_xmit routine.
1226 * Used for flow control when transmit resources are unavailable.
1228 static inline void netif_stop_queue(struct net_device
*dev
)
1230 netif_tx_stop_queue(netdev_get_tx_queue(dev
, 0));
1233 static inline void netif_tx_stop_all_queues(struct net_device
*dev
)
1237 for (i
= 0; i
< dev
->num_tx_queues
; i
++) {
1238 struct netdev_queue
*txq
= netdev_get_tx_queue(dev
, i
);
1239 netif_tx_stop_queue(txq
);
1243 static inline int netif_tx_queue_stopped(const struct netdev_queue
*dev_queue
)
1245 return test_bit(__QUEUE_STATE_XOFF
, &dev_queue
->state
);
1249 * netif_queue_stopped - test if transmit queue is flowblocked
1250 * @dev: network device
1252 * Test if transmit queue on device is currently unable to send.
1254 static inline int netif_queue_stopped(const struct net_device
*dev
)
1256 return netif_tx_queue_stopped(netdev_get_tx_queue(dev
, 0));
1259 static inline int netif_tx_queue_frozen(const struct netdev_queue
*dev_queue
)
1261 return test_bit(__QUEUE_STATE_FROZEN
, &dev_queue
->state
);
1265 * netif_running - test if up
1266 * @dev: network device
1268 * Test if the device has been brought up.
1270 static inline int netif_running(const struct net_device
*dev
)
1272 return test_bit(__LINK_STATE_START
, &dev
->state
);
1276 * Routines to manage the subqueues on a device. We only need start
1277 * stop, and a check if it's stopped. All other device management is
1278 * done at the overall netdevice level.
1279 * Also test the device if we're multiqueue.
1283 * netif_start_subqueue - allow sending packets on subqueue
1284 * @dev: network device
1285 * @queue_index: sub queue index
1287 * Start individual transmit queue of a device with multiple transmit queues.
1289 static inline void netif_start_subqueue(struct net_device
*dev
, u16 queue_index
)
1291 struct netdev_queue
*txq
= netdev_get_tx_queue(dev
, queue_index
);
1292 clear_bit(__QUEUE_STATE_XOFF
, &txq
->state
);
1296 * netif_stop_subqueue - stop sending packets on subqueue
1297 * @dev: network device
1298 * @queue_index: sub queue index
1300 * Stop individual transmit queue of a device with multiple transmit queues.
1302 static inline void netif_stop_subqueue(struct net_device
*dev
, u16 queue_index
)
1304 struct netdev_queue
*txq
= netdev_get_tx_queue(dev
, queue_index
);
1305 #ifdef CONFIG_NETPOLL_TRAP
1309 set_bit(__QUEUE_STATE_XOFF
, &txq
->state
);
1313 * netif_subqueue_stopped - test status of subqueue
1314 * @dev: network device
1315 * @queue_index: sub queue index
1317 * Check individual transmit queue of a device with multiple transmit queues.
1319 static inline int __netif_subqueue_stopped(const struct net_device
*dev
,
1322 struct netdev_queue
*txq
= netdev_get_tx_queue(dev
, queue_index
);
1323 return test_bit(__QUEUE_STATE_XOFF
, &txq
->state
);
1326 static inline int netif_subqueue_stopped(const struct net_device
*dev
,
1327 struct sk_buff
*skb
)
1329 return __netif_subqueue_stopped(dev
, skb_get_queue_mapping(skb
));
1333 * netif_wake_subqueue - allow sending packets on subqueue
1334 * @dev: network device
1335 * @queue_index: sub queue index
1337 * Resume individual transmit queue of a device with multiple transmit queues.
1339 static inline void netif_wake_subqueue(struct net_device
*dev
, u16 queue_index
)
1341 struct netdev_queue
*txq
= netdev_get_tx_queue(dev
, queue_index
);
1342 #ifdef CONFIG_NETPOLL_TRAP
1346 if (test_and_clear_bit(__QUEUE_STATE_XOFF
, &txq
->state
))
1347 __netif_schedule(txq
->qdisc
);
1351 * netif_is_multiqueue - test if device has multiple transmit queues
1352 * @dev: network device
1354 * Check if device has multiple transmit queues
1356 static inline int netif_is_multiqueue(const struct net_device
*dev
)
1358 return (dev
->num_tx_queues
> 1);
1361 /* Use this variant when it is known for sure that it
1362 * is executing from hardware interrupt context or with hardware interrupts
1365 extern void dev_kfree_skb_irq(struct sk_buff
*skb
);
1367 /* Use this variant in places where it could be invoked
1368 * from either hardware interrupt or other context, with hardware interrupts
1369 * either disabled or enabled.
1371 extern void dev_kfree_skb_any(struct sk_buff
*skb
);
1373 #define HAVE_NETIF_RX 1
1374 extern int netif_rx(struct sk_buff
*skb
);
1375 extern int netif_rx_ni(struct sk_buff
*skb
);
1376 #define HAVE_NETIF_RECEIVE_SKB 1
1377 extern int netif_receive_skb(struct sk_buff
*skb
);
1378 extern void napi_gro_flush(struct napi_struct
*napi
);
1379 extern int dev_gro_receive(struct napi_struct
*napi
,
1380 struct sk_buff
*skb
);
1381 extern int napi_gro_receive(struct napi_struct
*napi
,
1382 struct sk_buff
*skb
);
1383 extern void napi_reuse_skb(struct napi_struct
*napi
,
1384 struct sk_buff
*skb
);
1385 extern struct sk_buff
* napi_fraginfo_skb(struct napi_struct
*napi
,
1386 struct napi_gro_fraginfo
*info
);
1387 extern int napi_gro_frags(struct napi_struct
*napi
,
1388 struct napi_gro_fraginfo
*info
);
1389 extern void netif_nit_deliver(struct sk_buff
*skb
);
1390 extern int dev_valid_name(const char *name
);
1391 extern int dev_ioctl(struct net
*net
, unsigned int cmd
, void __user
*);
1392 extern int dev_ethtool(struct net
*net
, struct ifreq
*);
1393 extern unsigned dev_get_flags(const struct net_device
*);
1394 extern int dev_change_flags(struct net_device
*, unsigned);
1395 extern int dev_change_name(struct net_device
*, const char *);
1396 extern int dev_set_alias(struct net_device
*, const char *, size_t);
1397 extern int dev_change_net_namespace(struct net_device
*,
1398 struct net
*, const char *);
1399 extern int dev_set_mtu(struct net_device
*, int);
1400 extern int dev_set_mac_address(struct net_device
*,
1402 extern int dev_hard_start_xmit(struct sk_buff
*skb
,
1403 struct net_device
*dev
,
1404 struct netdev_queue
*txq
);
1406 extern int netdev_budget
;
1408 /* Called by rtnetlink.c:rtnl_unlock() */
1409 extern void netdev_run_todo(void);
1412 * dev_put - release reference to device
1413 * @dev: network device
1415 * Release reference to device to allow it to be freed.
1417 static inline void dev_put(struct net_device
*dev
)
1419 atomic_dec(&dev
->refcnt
);
1423 * dev_hold - get reference to device
1424 * @dev: network device
1426 * Hold reference to device to keep it from being freed.
1428 static inline void dev_hold(struct net_device
*dev
)
1430 atomic_inc(&dev
->refcnt
);
1433 /* Carrier loss detection, dial on demand. The functions netif_carrier_on
1434 * and _off may be called from IRQ context, but it is caller
1435 * who is responsible for serialization of these calls.
1437 * The name carrier is inappropriate, these functions should really be
1438 * called netif_lowerlayer_*() because they represent the state of any
1439 * kind of lower layer not just hardware media.
1442 extern void linkwatch_fire_event(struct net_device
*dev
);
1445 * netif_carrier_ok - test if carrier present
1446 * @dev: network device
1448 * Check if carrier is present on device
1450 static inline int netif_carrier_ok(const struct net_device
*dev
)
1452 return !test_bit(__LINK_STATE_NOCARRIER
, &dev
->state
);
1455 extern void __netdev_watchdog_up(struct net_device
*dev
);
1457 extern void netif_carrier_on(struct net_device
*dev
);
1459 extern void netif_carrier_off(struct net_device
*dev
);
1462 * netif_dormant_on - mark device as dormant.
1463 * @dev: network device
1465 * Mark device as dormant (as per RFC2863).
1467 * The dormant state indicates that the relevant interface is not
1468 * actually in a condition to pass packets (i.e., it is not 'up') but is
1469 * in a "pending" state, waiting for some external event. For "on-
1470 * demand" interfaces, this new state identifies the situation where the
1471 * interface is waiting for events to place it in the up state.
1474 static inline void netif_dormant_on(struct net_device
*dev
)
1476 if (!test_and_set_bit(__LINK_STATE_DORMANT
, &dev
->state
))
1477 linkwatch_fire_event(dev
);
1481 * netif_dormant_off - set device as not dormant.
1482 * @dev: network device
1484 * Device is not in dormant state.
1486 static inline void netif_dormant_off(struct net_device
*dev
)
1488 if (test_and_clear_bit(__LINK_STATE_DORMANT
, &dev
->state
))
1489 linkwatch_fire_event(dev
);
1493 * netif_dormant - test if carrier present
1494 * @dev: network device
1496 * Check if carrier is present on device
1498 static inline int netif_dormant(const struct net_device
*dev
)
1500 return test_bit(__LINK_STATE_DORMANT
, &dev
->state
);
1505 * netif_oper_up - test if device is operational
1506 * @dev: network device
1508 * Check if carrier is operational
1510 static inline int netif_oper_up(const struct net_device
*dev
) {
1511 return (dev
->operstate
== IF_OPER_UP
||
1512 dev
->operstate
== IF_OPER_UNKNOWN
/* backward compat */);
1516 * netif_device_present - is device available or removed
1517 * @dev: network device
1519 * Check if device has not been removed from system.
1521 static inline int netif_device_present(struct net_device
*dev
)
1523 return test_bit(__LINK_STATE_PRESENT
, &dev
->state
);
1526 extern void netif_device_detach(struct net_device
*dev
);
1528 extern void netif_device_attach(struct net_device
*dev
);
1531 * Network interface message level settings
1533 #define HAVE_NETIF_MSG 1
1536 NETIF_MSG_DRV
= 0x0001,
1537 NETIF_MSG_PROBE
= 0x0002,
1538 NETIF_MSG_LINK
= 0x0004,
1539 NETIF_MSG_TIMER
= 0x0008,
1540 NETIF_MSG_IFDOWN
= 0x0010,
1541 NETIF_MSG_IFUP
= 0x0020,
1542 NETIF_MSG_RX_ERR
= 0x0040,
1543 NETIF_MSG_TX_ERR
= 0x0080,
1544 NETIF_MSG_TX_QUEUED
= 0x0100,
1545 NETIF_MSG_INTR
= 0x0200,
1546 NETIF_MSG_TX_DONE
= 0x0400,
1547 NETIF_MSG_RX_STATUS
= 0x0800,
1548 NETIF_MSG_PKTDATA
= 0x1000,
1549 NETIF_MSG_HW
= 0x2000,
1550 NETIF_MSG_WOL
= 0x4000,
1553 #define netif_msg_drv(p) ((p)->msg_enable & NETIF_MSG_DRV)
1554 #define netif_msg_probe(p) ((p)->msg_enable & NETIF_MSG_PROBE)
1555 #define netif_msg_link(p) ((p)->msg_enable & NETIF_MSG_LINK)
1556 #define netif_msg_timer(p) ((p)->msg_enable & NETIF_MSG_TIMER)
1557 #define netif_msg_ifdown(p) ((p)->msg_enable & NETIF_MSG_IFDOWN)
1558 #define netif_msg_ifup(p) ((p)->msg_enable & NETIF_MSG_IFUP)
1559 #define netif_msg_rx_err(p) ((p)->msg_enable & NETIF_MSG_RX_ERR)
1560 #define netif_msg_tx_err(p) ((p)->msg_enable & NETIF_MSG_TX_ERR)
1561 #define netif_msg_tx_queued(p) ((p)->msg_enable & NETIF_MSG_TX_QUEUED)
1562 #define netif_msg_intr(p) ((p)->msg_enable & NETIF_MSG_INTR)
1563 #define netif_msg_tx_done(p) ((p)->msg_enable & NETIF_MSG_TX_DONE)
1564 #define netif_msg_rx_status(p) ((p)->msg_enable & NETIF_MSG_RX_STATUS)
1565 #define netif_msg_pktdata(p) ((p)->msg_enable & NETIF_MSG_PKTDATA)
1566 #define netif_msg_hw(p) ((p)->msg_enable & NETIF_MSG_HW)
1567 #define netif_msg_wol(p) ((p)->msg_enable & NETIF_MSG_WOL)
1569 static inline u32
netif_msg_init(int debug_value
, int default_msg_enable_bits
)
1572 if (debug_value
< 0 || debug_value
>= (sizeof(u32
) * 8))
1573 return default_msg_enable_bits
;
1574 if (debug_value
== 0) /* no output */
1576 /* set low N bits */
1577 return (1 << debug_value
) - 1;
1580 /* Test if receive needs to be scheduled but only if up */
1581 static inline int netif_rx_schedule_prep(struct napi_struct
*napi
)
1583 return napi_schedule_prep(napi
);
1586 /* Add interface to tail of rx poll list. This assumes that _prep has
1587 * already been called and returned 1.
1589 static inline void __netif_rx_schedule(struct napi_struct
*napi
)
1591 __napi_schedule(napi
);
1594 /* Try to reschedule poll. Called by irq handler. */
1596 static inline void netif_rx_schedule(struct napi_struct
*napi
)
1598 if (netif_rx_schedule_prep(napi
))
1599 __netif_rx_schedule(napi
);
1602 /* Try to reschedule poll. Called by dev->poll() after netif_rx_complete(). */
1603 static inline int netif_rx_reschedule(struct napi_struct
*napi
)
1605 if (napi_schedule_prep(napi
)) {
1606 __netif_rx_schedule(napi
);
1612 /* same as netif_rx_complete, except that local_irq_save(flags)
1613 * has already been issued
1615 static inline void __netif_rx_complete(struct napi_struct
*napi
)
1617 __napi_complete(napi
);
1620 /* Remove interface from poll list: it must be in the poll list
1621 * on current cpu. This primitive is called by dev->poll(), when
1622 * it completes the work. The device cannot be out of poll list at this
1623 * moment, it is BUG().
1625 static inline void netif_rx_complete(struct napi_struct
*napi
)
1627 napi_complete(napi
);
1630 static inline void __netif_tx_lock(struct netdev_queue
*txq
, int cpu
)
1632 spin_lock(&txq
->_xmit_lock
);
1633 txq
->xmit_lock_owner
= cpu
;
1636 static inline void __netif_tx_lock_bh(struct netdev_queue
*txq
)
1638 spin_lock_bh(&txq
->_xmit_lock
);
1639 txq
->xmit_lock_owner
= smp_processor_id();
1642 static inline int __netif_tx_trylock(struct netdev_queue
*txq
)
1644 int ok
= spin_trylock(&txq
->_xmit_lock
);
1646 txq
->xmit_lock_owner
= smp_processor_id();
1650 static inline void __netif_tx_unlock(struct netdev_queue
*txq
)
1652 txq
->xmit_lock_owner
= -1;
1653 spin_unlock(&txq
->_xmit_lock
);
1656 static inline void __netif_tx_unlock_bh(struct netdev_queue
*txq
)
1658 txq
->xmit_lock_owner
= -1;
1659 spin_unlock_bh(&txq
->_xmit_lock
);
1663 * netif_tx_lock - grab network device transmit lock
1664 * @dev: network device
1666 * Get network device transmit lock
1668 static inline void netif_tx_lock(struct net_device
*dev
)
1673 spin_lock(&dev
->tx_global_lock
);
1674 cpu
= smp_processor_id();
1675 for (i
= 0; i
< dev
->num_tx_queues
; i
++) {
1676 struct netdev_queue
*txq
= netdev_get_tx_queue(dev
, i
);
1678 /* We are the only thread of execution doing a
1679 * freeze, but we have to grab the _xmit_lock in
1680 * order to synchronize with threads which are in
1681 * the ->hard_start_xmit() handler and already
1682 * checked the frozen bit.
1684 __netif_tx_lock(txq
, cpu
);
1685 set_bit(__QUEUE_STATE_FROZEN
, &txq
->state
);
1686 __netif_tx_unlock(txq
);
1690 static inline void netif_tx_lock_bh(struct net_device
*dev
)
1696 static inline void netif_tx_unlock(struct net_device
*dev
)
1700 for (i
= 0; i
< dev
->num_tx_queues
; i
++) {
1701 struct netdev_queue
*txq
= netdev_get_tx_queue(dev
, i
);
1703 /* No need to grab the _xmit_lock here. If the
1704 * queue is not stopped for another reason, we
1707 clear_bit(__QUEUE_STATE_FROZEN
, &txq
->state
);
1708 if (!test_bit(__QUEUE_STATE_XOFF
, &txq
->state
))
1709 __netif_schedule(txq
->qdisc
);
1711 spin_unlock(&dev
->tx_global_lock
);
1714 static inline void netif_tx_unlock_bh(struct net_device
*dev
)
1716 netif_tx_unlock(dev
);
1720 #define HARD_TX_LOCK(dev, txq, cpu) { \
1721 if ((dev->features & NETIF_F_LLTX) == 0) { \
1722 __netif_tx_lock(txq, cpu); \
1726 #define HARD_TX_UNLOCK(dev, txq) { \
1727 if ((dev->features & NETIF_F_LLTX) == 0) { \
1728 __netif_tx_unlock(txq); \
1732 static inline void netif_tx_disable(struct net_device
*dev
)
1738 cpu
= smp_processor_id();
1739 for (i
= 0; i
< dev
->num_tx_queues
; i
++) {
1740 struct netdev_queue
*txq
= netdev_get_tx_queue(dev
, i
);
1742 __netif_tx_lock(txq
, cpu
);
1743 netif_tx_stop_queue(txq
);
1744 __netif_tx_unlock(txq
);
1749 static inline void netif_addr_lock(struct net_device
*dev
)
1751 spin_lock(&dev
->addr_list_lock
);
1754 static inline void netif_addr_lock_bh(struct net_device
*dev
)
1756 spin_lock_bh(&dev
->addr_list_lock
);
1759 static inline void netif_addr_unlock(struct net_device
*dev
)
1761 spin_unlock(&dev
->addr_list_lock
);
1764 static inline void netif_addr_unlock_bh(struct net_device
*dev
)
1766 spin_unlock_bh(&dev
->addr_list_lock
);
1769 /* These functions live elsewhere (drivers/net/net_init.c, but related) */
1771 extern void ether_setup(struct net_device
*dev
);
1773 /* Support for loadable net-drivers */
1774 extern struct net_device
*alloc_netdev_mq(int sizeof_priv
, const char *name
,
1775 void (*setup
)(struct net_device
*),
1776 unsigned int queue_count
);
1777 #define alloc_netdev(sizeof_priv, name, setup) \
1778 alloc_netdev_mq(sizeof_priv, name, setup, 1)
1779 extern int register_netdev(struct net_device
*dev
);
1780 extern void unregister_netdev(struct net_device
*dev
);
1781 /* Functions used for secondary unicast and multicast support */
1782 extern void dev_set_rx_mode(struct net_device
*dev
);
1783 extern void __dev_set_rx_mode(struct net_device
*dev
);
1784 extern int dev_unicast_delete(struct net_device
*dev
, void *addr
, int alen
);
1785 extern int dev_unicast_add(struct net_device
*dev
, void *addr
, int alen
);
1786 extern int dev_unicast_sync(struct net_device
*to
, struct net_device
*from
);
1787 extern void dev_unicast_unsync(struct net_device
*to
, struct net_device
*from
);
1788 extern int dev_mc_delete(struct net_device
*dev
, void *addr
, int alen
, int all
);
1789 extern int dev_mc_add(struct net_device
*dev
, void *addr
, int alen
, int newonly
);
1790 extern int dev_mc_sync(struct net_device
*to
, struct net_device
*from
);
1791 extern void dev_mc_unsync(struct net_device
*to
, struct net_device
*from
);
1792 extern int __dev_addr_delete(struct dev_addr_list
**list
, int *count
, void *addr
, int alen
, int all
);
1793 extern int __dev_addr_add(struct dev_addr_list
**list
, int *count
, void *addr
, int alen
, int newonly
);
1794 extern int __dev_addr_sync(struct dev_addr_list
**to
, int *to_count
, struct dev_addr_list
**from
, int *from_count
);
1795 extern void __dev_addr_unsync(struct dev_addr_list
**to
, int *to_count
, struct dev_addr_list
**from
, int *from_count
);
1796 extern int dev_set_promiscuity(struct net_device
*dev
, int inc
);
1797 extern int dev_set_allmulti(struct net_device
*dev
, int inc
);
1798 extern void netdev_state_change(struct net_device
*dev
);
1799 extern void netdev_bonding_change(struct net_device
*dev
);
1800 extern void netdev_features_change(struct net_device
*dev
);
1801 /* Load a device via the kmod */
1802 extern void dev_load(struct net
*net
, const char *name
);
1803 extern void dev_mcast_init(void);
1804 extern const struct net_device_stats
*dev_get_stats(struct net_device
*dev
);
1806 extern int netdev_max_backlog
;
1807 extern int weight_p
;
1808 extern int netdev_set_master(struct net_device
*dev
, struct net_device
*master
);
1809 extern int skb_checksum_help(struct sk_buff
*skb
);
1810 extern struct sk_buff
*skb_gso_segment(struct sk_buff
*skb
, int features
);
1812 extern void netdev_rx_csum_fault(struct net_device
*dev
);
1814 static inline void netdev_rx_csum_fault(struct net_device
*dev
)
1818 /* rx skb timestamps */
1819 extern void net_enable_timestamp(void);
1820 extern void net_disable_timestamp(void);
1822 #ifdef CONFIG_PROC_FS
1823 extern void *dev_seq_start(struct seq_file
*seq
, loff_t
*pos
);
1824 extern void *dev_seq_next(struct seq_file
*seq
, void *v
, loff_t
*pos
);
1825 extern void dev_seq_stop(struct seq_file
*seq
, void *v
);
1828 extern int netdev_class_create_file(struct class_attribute
*class_attr
);
1829 extern void netdev_class_remove_file(struct class_attribute
*class_attr
);
1831 extern char *netdev_drivername(const struct net_device
*dev
, char *buffer
, int len
);
1833 extern void linkwatch_run_queue(void);
1835 unsigned long netdev_increment_features(unsigned long all
, unsigned long one
,
1836 unsigned long mask
);
1837 unsigned long netdev_fix_features(unsigned long features
, const char *name
);
1839 static inline int net_gso_ok(int features
, int gso_type
)
1841 int feature
= gso_type
<< NETIF_F_GSO_SHIFT
;
1842 return (features
& feature
) == feature
;
1845 static inline int skb_gso_ok(struct sk_buff
*skb
, int features
)
1847 return net_gso_ok(features
, skb_shinfo(skb
)->gso_type
);
1850 static inline int netif_needs_gso(struct net_device
*dev
, struct sk_buff
*skb
)
1852 return skb_is_gso(skb
) &&
1853 (!skb_gso_ok(skb
, dev
->features
) ||
1854 (skb_shinfo(skb
)->frag_list
&&
1855 !(dev
->features
& NETIF_F_FRAGLIST
)) ||
1856 unlikely(skb
->ip_summed
!= CHECKSUM_PARTIAL
));
1859 static inline void netif_set_gso_max_size(struct net_device
*dev
,
1862 dev
->gso_max_size
= size
;
1865 /* On bonding slaves other than the currently active slave, suppress
1866 * duplicates except for 802.3ad ETH_P_SLOW, alb non-mcast/bcast, and
1867 * ARP on active-backup slaves with arp_validate enabled.
1869 static inline int skb_bond_should_drop(struct sk_buff
*skb
)
1871 struct net_device
*dev
= skb
->dev
;
1872 struct net_device
*master
= dev
->master
;
1875 if (master
->priv_flags
& IFF_MASTER_ARPMON
)
1876 dev
->last_rx
= jiffies
;
1878 if (dev
->priv_flags
& IFF_SLAVE_INACTIVE
) {
1879 if ((dev
->priv_flags
& IFF_SLAVE_NEEDARP
) &&
1880 skb
->protocol
== __constant_htons(ETH_P_ARP
))
1883 if (master
->priv_flags
& IFF_MASTER_ALB
) {
1884 if (skb
->pkt_type
!= PACKET_BROADCAST
&&
1885 skb
->pkt_type
!= PACKET_MULTICAST
)
1888 if (master
->priv_flags
& IFF_MASTER_8023AD
&&
1889 skb
->protocol
== __constant_htons(ETH_P_SLOW
))
1898 extern struct pernet_operations __net_initdata loopback_net_ops
;
1899 #endif /* __KERNEL__ */
1901 #endif /* _LINUX_DEV_H */