]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blame - include/linux/netdevice.h
net: Fix issue with netdev_tx_reset_queue not resetting queue from XOFF state
[mirror_ubuntu-artful-kernel.git] / include / linux / netdevice.h
CommitLineData
1da177e4
LT
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 *
02c30a84 10 * Authors: Ross Biro
1da177e4
LT
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>
113aa838 14 * Alan Cox, <alan@lxorguk.ukuu.org.uk>
1da177e4
LT
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>
95c26df8 31#include <linux/if_link.h>
1da177e4
LT
32
33#ifdef __KERNEL__
e8db0be1 34#include <linux/pm_qos.h>
d7fe0f24 35#include <linux/timer.h>
bea3348e 36#include <linux/delay.h>
60063497 37#include <linux/atomic.h>
1da177e4
LT
38#include <asm/cache.h>
39#include <asm/byteorder.h>
40
1da177e4
LT
41#include <linux/device.h>
42#include <linux/percpu.h>
4d5b78c0 43#include <linux/rculist.h>
db217334 44#include <linux/dmaengine.h>
bea3348e 45#include <linux/workqueue.h>
114cf580 46#include <linux/dynamic_queue_limits.h>
1da177e4 47
b1b67dd4 48#include <linux/ethtool.h>
a050c33f 49#include <net/net_namespace.h>
cf85d08f 50#include <net/dsa.h>
7a6b6f51 51#ifdef CONFIG_DCB
2f90b865
AD
52#include <net/dcbnl.h>
53#endif
5bc1421e 54#include <net/netprio_cgroup.h>
a050c33f 55
a59e2ecb
MM
56#include <linux/netdev_features.h>
57
115c1d6e 58struct netpoll_info;
c1f19b51 59struct phy_device;
704232c2
JB
60/* 802.11 specific */
61struct wireless_dev;
1da177e4
LT
62 /* source back-compat hooks */
63#define SET_ETHTOOL_OPS(netdev,ops) \
64 ( (netdev)->ethtool_ops = (ops) )
65
c1f79426
SA
66/* hardware address assignment types */
67#define NET_ADDR_PERM 0 /* address is permanent (default) */
68#define NET_ADDR_RANDOM 1 /* address is generated randomly */
69#define NET_ADDR_STOLEN 2 /* address is stolen from other device */
70
9a1654ba
JP
71/* Backlog congestion levels */
72#define NET_RX_SUCCESS 0 /* keep 'em coming, baby */
73#define NET_RX_DROP 1 /* packet dropped */
74
572a9d7b
PM
75/*
76 * Transmit return codes: transmit return codes originate from three different
77 * namespaces:
78 *
79 * - qdisc return codes
80 * - driver transmit return codes
81 * - errno values
82 *
83 * Drivers are allowed to return any one of those in their hard_start_xmit()
84 * function. Real network devices commonly used with qdiscs should only return
85 * the driver transmit return codes though - when qdiscs are used, the actual
86 * transmission happens asynchronously, so the value is not propagated to
87 * higher layers. Virtual network devices transmit synchronously, in this case
88 * the driver transmit return codes are consumed by dev_queue_xmit(), all
89 * others are propagated to higher layers.
90 */
91
92/* qdisc ->enqueue() return codes. */
93#define NET_XMIT_SUCCESS 0x00
9a1654ba
JP
94#define NET_XMIT_DROP 0x01 /* skb dropped */
95#define NET_XMIT_CN 0x02 /* congestion notification */
96#define NET_XMIT_POLICED 0x03 /* skb is shot by police */
97#define NET_XMIT_MASK 0x0f /* qdisc flags in net/sch_generic.h */
1da177e4 98
b9df3cb8
GR
99/* NET_XMIT_CN is special. It does not guarantee that this packet is lost. It
100 * indicates that the device will soon be dropping packets, or already drops
101 * some packets of the same priority; prompting us to send less aggressively. */
572a9d7b 102#define net_xmit_eval(e) ((e) == NET_XMIT_CN ? 0 : (e))
1da177e4
LT
103#define net_xmit_errno(e) ((e) != NET_XMIT_CN ? -ENOBUFS : 0)
104
dc1f8bf6 105/* Driver transmit return codes */
9a1654ba 106#define NETDEV_TX_MASK 0xf0
572a9d7b 107
dc1f8bf6 108enum netdev_tx {
572a9d7b 109 __NETDEV_TX_MIN = INT_MIN, /* make sure enum is signed */
9a1654ba
JP
110 NETDEV_TX_OK = 0x00, /* driver took care of packet */
111 NETDEV_TX_BUSY = 0x10, /* driver tx path was busy*/
112 NETDEV_TX_LOCKED = 0x20, /* driver tx lock was already taken */
dc1f8bf6
SH
113};
114typedef enum netdev_tx netdev_tx_t;
115
9a1654ba
JP
116/*
117 * Current order: NETDEV_TX_MASK > NET_XMIT_MASK >= 0 is significant;
118 * hard_start_xmit() return < NET_XMIT_MASK means skb was consumed.
119 */
120static inline bool dev_xmit_complete(int rc)
121{
122 /*
123 * Positive cases with an skb consumed by a driver:
124 * - successful transmission (rc == NETDEV_TX_OK)
125 * - error while transmitting (rc < 0)
126 * - error while queueing to a different device (rc & NET_XMIT_MASK)
127 */
128 if (likely(rc < NET_XMIT_MASK))
129 return true;
130
131 return false;
132}
133
1da177e4
LT
134#endif
135
136#define MAX_ADDR_LEN 32 /* Largest hardware address length */
137
23b41168
VD
138/* Initial net device group. All devices belong to group 0 by default. */
139#define INIT_NETDEV_GROUP 0
140
c88e6f51 141#ifdef __KERNEL__
1da177e4
LT
142/*
143 * Compute the worst case header length according to the protocols
144 * used.
145 */
fe2918b0 146
d11ead75 147#if defined(CONFIG_WLAN) || IS_ENABLED(CONFIG_AX25)
8388e3da
DM
148# if defined(CONFIG_MAC80211_MESH)
149# define LL_MAX_HEADER 128
150# else
151# define LL_MAX_HEADER 96
152# endif
d11ead75 153#elif IS_ENABLED(CONFIG_TR)
8388e3da 154# define LL_MAX_HEADER 48
1da177e4 155#else
8388e3da 156# define LL_MAX_HEADER 32
1da177e4
LT
157#endif
158
d11ead75
BH
159#if !IS_ENABLED(CONFIG_NET_IPIP) && !IS_ENABLED(CONFIG_NET_IPGRE) && \
160 !IS_ENABLED(CONFIG_IPV6_SIT) && !IS_ENABLED(CONFIG_IPV6_TUNNEL)
1da177e4
LT
161#define MAX_HEADER LL_MAX_HEADER
162#else
163#define MAX_HEADER (LL_MAX_HEADER + 48)
164#endif
165
166/*
be1f3c2c
BH
167 * Old network device statistics. Fields are native words
168 * (unsigned long) so they can be read and written atomically.
1da177e4 169 */
fe2918b0 170
d94d9fee 171struct net_device_stats {
3cfde79c
BH
172 unsigned long rx_packets;
173 unsigned long tx_packets;
174 unsigned long rx_bytes;
175 unsigned long tx_bytes;
176 unsigned long rx_errors;
177 unsigned long tx_errors;
178 unsigned long rx_dropped;
179 unsigned long tx_dropped;
180 unsigned long multicast;
1da177e4 181 unsigned long collisions;
1da177e4 182 unsigned long rx_length_errors;
3cfde79c
BH
183 unsigned long rx_over_errors;
184 unsigned long rx_crc_errors;
185 unsigned long rx_frame_errors;
186 unsigned long rx_fifo_errors;
187 unsigned long rx_missed_errors;
1da177e4
LT
188 unsigned long tx_aborted_errors;
189 unsigned long tx_carrier_errors;
190 unsigned long tx_fifo_errors;
191 unsigned long tx_heartbeat_errors;
192 unsigned long tx_window_errors;
1da177e4
LT
193 unsigned long rx_compressed;
194 unsigned long tx_compressed;
195};
196
be1f3c2c
BH
197#endif /* __KERNEL__ */
198
1da177e4
LT
199
200/* Media selection options. */
201enum {
202 IF_PORT_UNKNOWN = 0,
203 IF_PORT_10BASE2,
204 IF_PORT_10BASET,
205 IF_PORT_AUI,
206 IF_PORT_100BASET,
207 IF_PORT_100BASETX,
208 IF_PORT_100BASEFX
209};
210
211#ifdef __KERNEL__
212
213#include <linux/cache.h>
214#include <linux/skbuff.h>
215
adc9300e
ED
216#ifdef CONFIG_RPS
217#include <linux/jump_label.h>
218extern struct jump_label_key rps_needed;
219#endif
220
1da177e4
LT
221struct neighbour;
222struct neigh_parms;
223struct sk_buff;
224
f001fde5
JP
225struct netdev_hw_addr {
226 struct list_head list;
227 unsigned char addr[MAX_ADDR_LEN];
228 unsigned char type;
ccffad25
JP
229#define NETDEV_HW_ADDR_T_LAN 1
230#define NETDEV_HW_ADDR_T_SAN 2
231#define NETDEV_HW_ADDR_T_SLAVE 3
232#define NETDEV_HW_ADDR_T_UNICAST 4
22bedad3 233#define NETDEV_HW_ADDR_T_MULTICAST 5
ccffad25 234 bool synced;
22bedad3 235 bool global_use;
8f8f103d 236 int refcount;
f001fde5
JP
237 struct rcu_head rcu_head;
238};
239
31278e71
JP
240struct netdev_hw_addr_list {
241 struct list_head list;
242 int count;
243};
244
22bedad3
JP
245#define netdev_hw_addr_list_count(l) ((l)->count)
246#define netdev_hw_addr_list_empty(l) (netdev_hw_addr_list_count(l) == 0)
247#define netdev_hw_addr_list_for_each(ha, l) \
248 list_for_each_entry(ha, &(l)->list, list)
32e7bfc4 249
22bedad3
JP
250#define netdev_uc_count(dev) netdev_hw_addr_list_count(&(dev)->uc)
251#define netdev_uc_empty(dev) netdev_hw_addr_list_empty(&(dev)->uc)
252#define netdev_for_each_uc_addr(ha, dev) \
253 netdev_hw_addr_list_for_each(ha, &(dev)->uc)
6683ece3 254
22bedad3
JP
255#define netdev_mc_count(dev) netdev_hw_addr_list_count(&(dev)->mc)
256#define netdev_mc_empty(dev) netdev_hw_addr_list_empty(&(dev)->mc)
18e225f2 257#define netdev_for_each_mc_addr(ha, dev) \
22bedad3 258 netdev_hw_addr_list_for_each(ha, &(dev)->mc)
6683ece3 259
d94d9fee 260struct hh_cache {
f6b72b62 261 u16 hh_len;
5c25f686 262 u16 __pad;
3644f0ce 263 seqlock_t hh_lock;
1da177e4
LT
264
265 /* cached hardware header; allow for machine alignment needs. */
266#define HH_DATA_MOD 16
267#define HH_DATA_OFF(__len) \
5ba0eac6 268 (HH_DATA_MOD - (((__len - 1) & (HH_DATA_MOD - 1)) + 1))
1da177e4
LT
269#define HH_DATA_ALIGN(__len) \
270 (((__len)+(HH_DATA_MOD-1))&~(HH_DATA_MOD - 1))
271 unsigned long hh_data[HH_DATA_ALIGN(LL_MAX_HEADER) / sizeof(long)];
272};
273
274/* Reserve HH_DATA_MOD byte aligned hard_header_len, but at least that much.
275 * Alternative is:
276 * dev->hard_header_len ? (dev->hard_header_len +
277 * (HH_DATA_MOD - 1)) & ~(HH_DATA_MOD - 1) : 0
278 *
279 * We could use other alignment values, but we must maintain the
280 * relationship HH alignment <= LL alignment.
281 */
282#define LL_RESERVED_SPACE(dev) \
f5184d26 283 ((((dev)->hard_header_len+(dev)->needed_headroom)&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
1da177e4 284#define LL_RESERVED_SPACE_EXTRA(dev,extra) \
f5184d26 285 ((((dev)->hard_header_len+(dev)->needed_headroom+(extra))&~(HH_DATA_MOD - 1)) + HH_DATA_MOD)
1da177e4 286
3b04ddde
SH
287struct header_ops {
288 int (*create) (struct sk_buff *skb, struct net_device *dev,
289 unsigned short type, const void *daddr,
290 const void *saddr, unsigned len);
291 int (*parse)(const struct sk_buff *skb, unsigned char *haddr);
292 int (*rebuild)(struct sk_buff *skb);
e69dd336 293 int (*cache)(const struct neighbour *neigh, struct hh_cache *hh, __be16 type);
3b04ddde
SH
294 void (*cache_update)(struct hh_cache *hh,
295 const struct net_device *dev,
296 const unsigned char *haddr);
297};
298
1da177e4
LT
299/* These flag bits are private to the generic network queueing
300 * layer, they may not be explicitly referenced by any other
301 * code.
302 */
303
d94d9fee 304enum netdev_state_t {
1da177e4
LT
305 __LINK_STATE_START,
306 __LINK_STATE_PRESENT,
1da177e4 307 __LINK_STATE_NOCARRIER,
b00055aa
SR
308 __LINK_STATE_LINKWATCH_PENDING,
309 __LINK_STATE_DORMANT,
1da177e4
LT
310};
311
312
313/*
314 * This structure holds at boot time configured netdevice settings. They
fe2918b0 315 * are then used in the device probing.
1da177e4
LT
316 */
317struct netdev_boot_setup {
318 char name[IFNAMSIZ];
319 struct ifmap map;
320};
321#define NETDEV_BOOT_SETUP_MAX 8
322
20380731 323extern int __init netdev_boot_setup(char *str);
1da177e4 324
bea3348e
SH
325/*
326 * Structure for NAPI scheduling similar to tasklet but with weighting
327 */
328struct napi_struct {
329 /* The poll_list must only be managed by the entity which
330 * changes the state of the NAPI_STATE_SCHED bit. This means
331 * whoever atomically sets that bit can add this napi_struct
332 * to the per-cpu poll_list, and whoever clears that bit
333 * can remove from the list right before clearing the bit.
334 */
335 struct list_head poll_list;
336
337 unsigned long state;
338 int weight;
339 int (*poll)(struct napi_struct *, int);
340#ifdef CONFIG_NETPOLL
341 spinlock_t poll_lock;
342 int poll_owner;
bea3348e 343#endif
4ae5544f
HX
344
345 unsigned int gro_count;
346
5d38a079 347 struct net_device *dev;
d565b0a1
HX
348 struct list_head dev_list;
349 struct sk_buff *gro_list;
5d38a079 350 struct sk_buff *skb;
bea3348e
SH
351};
352
d94d9fee 353enum {
bea3348e 354 NAPI_STATE_SCHED, /* Poll is scheduled */
a0a46196 355 NAPI_STATE_DISABLE, /* Disable pending */
7b363e44 356 NAPI_STATE_NPSVC, /* Netpoll - don't dequeue from poll_list */
bea3348e
SH
357};
358
5b252f0c 359enum gro_result {
d1c76af9
HX
360 GRO_MERGED,
361 GRO_MERGED_FREE,
362 GRO_HELD,
363 GRO_NORMAL,
364 GRO_DROP,
365};
5b252f0c 366typedef enum gro_result gro_result_t;
d1c76af9 367
8a4eb573
JP
368/*
369 * enum rx_handler_result - Possible return values for rx_handlers.
370 * @RX_HANDLER_CONSUMED: skb was consumed by rx_handler, do not process it
371 * further.
372 * @RX_HANDLER_ANOTHER: Do another round in receive path. This is indicated in
373 * case skb->dev was changed by rx_handler.
374 * @RX_HANDLER_EXACT: Force exact delivery, no wildcard.
375 * @RX_HANDLER_PASS: Do nothing, passe the skb as if no rx_handler was called.
376 *
377 * rx_handlers are functions called from inside __netif_receive_skb(), to do
378 * special processing of the skb, prior to delivery to protocol handlers.
379 *
380 * Currently, a net_device can only have a single rx_handler registered. Trying
381 * to register a second rx_handler will return -EBUSY.
382 *
383 * To register a rx_handler on a net_device, use netdev_rx_handler_register().
384 * To unregister a rx_handler on a net_device, use
385 * netdev_rx_handler_unregister().
386 *
387 * Upon return, rx_handler is expected to tell __netif_receive_skb() what to
388 * do with the skb.
389 *
390 * If the rx_handler consumed to skb in some way, it should return
391 * RX_HANDLER_CONSUMED. This is appropriate when the rx_handler arranged for
392 * the skb to be delivered in some other ways.
393 *
394 * If the rx_handler changed skb->dev, to divert the skb to another
395 * net_device, it should return RX_HANDLER_ANOTHER. The rx_handler for the
396 * new device will be called if it exists.
397 *
398 * If the rx_handler consider the skb should be ignored, it should return
399 * RX_HANDLER_EXACT. The skb will only be delivered to protocol handlers that
400 * are registred on exact device (ptype->dev == skb->dev).
401 *
402 * If the rx_handler didn't changed skb->dev, but want the skb to be normally
403 * delivered, it should return RX_HANDLER_PASS.
404 *
405 * A device without a registered rx_handler will behave as if rx_handler
406 * returned RX_HANDLER_PASS.
407 */
408
409enum rx_handler_result {
410 RX_HANDLER_CONSUMED,
411 RX_HANDLER_ANOTHER,
412 RX_HANDLER_EXACT,
413 RX_HANDLER_PASS,
414};
415typedef enum rx_handler_result rx_handler_result_t;
416typedef rx_handler_result_t rx_handler_func_t(struct sk_buff **pskb);
ab95bfe0 417
b3c97528 418extern void __napi_schedule(struct napi_struct *n);
bea3348e 419
4d29515f 420static inline bool napi_disable_pending(struct napi_struct *n)
a0a46196
DM
421{
422 return test_bit(NAPI_STATE_DISABLE, &n->state);
423}
424
bea3348e
SH
425/**
426 * napi_schedule_prep - check if napi can be scheduled
427 * @n: napi context
428 *
429 * Test if NAPI routine is already running, and if not mark
430 * it as running. This is used as a condition variable
a0a46196
DM
431 * insure only one NAPI poll instance runs. We also make
432 * sure there is no pending NAPI disable.
bea3348e 433 */
4d29515f 434static inline bool napi_schedule_prep(struct napi_struct *n)
bea3348e 435{
a0a46196
DM
436 return !napi_disable_pending(n) &&
437 !test_and_set_bit(NAPI_STATE_SCHED, &n->state);
bea3348e
SH
438}
439
440/**
441 * napi_schedule - schedule NAPI poll
442 * @n: napi context
443 *
444 * Schedule NAPI poll routine to be called if it is not already
445 * running.
446 */
447static inline void napi_schedule(struct napi_struct *n)
448{
449 if (napi_schedule_prep(n))
450 __napi_schedule(n);
451}
452
bfe13f54 453/* Try to reschedule poll. Called by dev->poll() after napi_complete(). */
4d29515f 454static inline bool napi_reschedule(struct napi_struct *napi)
bfe13f54
RD
455{
456 if (napi_schedule_prep(napi)) {
457 __napi_schedule(napi);
4d29515f 458 return true;
bfe13f54 459 }
4d29515f 460 return false;
bfe13f54
RD
461}
462
bea3348e
SH
463/**
464 * napi_complete - NAPI processing complete
465 * @n: napi context
466 *
467 * Mark NAPI processing as complete.
468 */
d565b0a1
HX
469extern void __napi_complete(struct napi_struct *n);
470extern void napi_complete(struct napi_struct *n);
bea3348e
SH
471
472/**
473 * napi_disable - prevent NAPI from scheduling
474 * @n: napi context
475 *
476 * Stop NAPI from being scheduled on this context.
477 * Waits till any outstanding processing completes.
478 */
479static inline void napi_disable(struct napi_struct *n)
480{
a0a46196 481 set_bit(NAPI_STATE_DISABLE, &n->state);
bea3348e 482 while (test_and_set_bit(NAPI_STATE_SCHED, &n->state))
43cc7380 483 msleep(1);
a0a46196 484 clear_bit(NAPI_STATE_DISABLE, &n->state);
bea3348e
SH
485}
486
487/**
488 * napi_enable - enable NAPI scheduling
489 * @n: napi context
490 *
491 * Resume NAPI from being scheduled on this context.
492 * Must be paired with napi_disable.
493 */
494static inline void napi_enable(struct napi_struct *n)
495{
496 BUG_ON(!test_bit(NAPI_STATE_SCHED, &n->state));
497 smp_mb__before_clear_bit();
498 clear_bit(NAPI_STATE_SCHED, &n->state);
499}
500
c264c3de
SH
501#ifdef CONFIG_SMP
502/**
503 * napi_synchronize - wait until NAPI is not running
504 * @n: napi context
505 *
506 * Wait until NAPI is done being scheduled on this context.
507 * Waits till any outstanding processing completes but
508 * does not disable future activations.
509 */
510static inline void napi_synchronize(const struct napi_struct *n)
511{
512 while (test_bit(NAPI_STATE_SCHED, &n->state))
513 msleep(1);
514}
515#else
516# define napi_synchronize(n) barrier()
517#endif
518
d94d9fee 519enum netdev_queue_state_t {
73466498
TH
520 __QUEUE_STATE_DRV_XOFF,
521 __QUEUE_STATE_STACK_XOFF,
c3f26a26 522 __QUEUE_STATE_FROZEN,
73466498
TH
523#define QUEUE_STATE_ANY_XOFF ((1 << __QUEUE_STATE_DRV_XOFF) | \
524 (1 << __QUEUE_STATE_STACK_XOFF))
525#define QUEUE_STATE_ANY_XOFF_OR_FROZEN (QUEUE_STATE_ANY_XOFF | \
526 (1 << __QUEUE_STATE_FROZEN))
79d16385 527};
73466498
TH
528/*
529 * __QUEUE_STATE_DRV_XOFF is used by drivers to stop the transmit queue. The
530 * netif_tx_* functions below are used to manipulate this flag. The
531 * __QUEUE_STATE_STACK_XOFF flag is used by the stack to stop the transmit
532 * queue independently. The netif_xmit_*stopped functions below are called
533 * to check if the queue has been stopped by the driver or stack (either
534 * of the XOFF bits are set in the state). Drivers should not need to call
535 * netif_xmit*stopped functions, they should only be using netif_tx_*.
536 */
79d16385 537
bb949fbd 538struct netdev_queue {
6a321cb3
ED
539/*
540 * read mostly part
541 */
bb949fbd 542 struct net_device *dev;
b0e1e646
DM
543 struct Qdisc *qdisc;
544 struct Qdisc *qdisc_sleeping;
ccf5ff69 545#ifdef CONFIG_SYSFS
1d24eb48
TH
546 struct kobject kobj;
547#endif
f2cd2d3e
ED
548#if defined(CONFIG_XPS) && defined(CONFIG_NUMA)
549 int numa_node;
550#endif
6a321cb3
ED
551/*
552 * write mostly part
553 */
554 spinlock_t _xmit_lock ____cacheline_aligned_in_smp;
555 int xmit_lock_owner;
9d21493b
ED
556 /*
557 * please use this field instead of dev->trans_start
558 */
559 unsigned long trans_start;
ccf5ff69 560
561 /*
562 * Number of TX timeouts for this queue
563 * (/sys/class/net/DEV/Q/trans_timeout)
564 */
565 unsigned long trans_timeout;
114cf580
TH
566
567 unsigned long state;
568
569#ifdef CONFIG_BQL
570 struct dql dql;
571#endif
e8a0464c 572} ____cacheline_aligned_in_smp;
bb949fbd 573
f2cd2d3e
ED
574static inline int netdev_queue_numa_node_read(const struct netdev_queue *q)
575{
576#if defined(CONFIG_XPS) && defined(CONFIG_NUMA)
577 return q->numa_node;
578#else
b236da69 579 return NUMA_NO_NODE;
f2cd2d3e
ED
580#endif
581}
582
583static inline void netdev_queue_numa_node_write(struct netdev_queue *q, int node)
584{
585#if defined(CONFIG_XPS) && defined(CONFIG_NUMA)
586 q->numa_node = node;
587#endif
588}
589
df334545 590#ifdef CONFIG_RPS
0a9627f2
TH
591/*
592 * This structure holds an RPS map which can be of variable length. The
593 * map is an array of CPUs.
594 */
595struct rps_map {
596 unsigned int len;
597 struct rcu_head rcu;
598 u16 cpus[0];
599};
60b778ce 600#define RPS_MAP_SIZE(_num) (sizeof(struct rps_map) + ((_num) * sizeof(u16)))
0a9627f2 601
fec5e652 602/*
c445477d
BH
603 * The rps_dev_flow structure contains the mapping of a flow to a CPU, the
604 * tail pointer for that CPU's input queue at the time of last enqueue, and
605 * a hardware filter index.
fec5e652
TH
606 */
607struct rps_dev_flow {
608 u16 cpu;
c445477d 609 u16 filter;
fec5e652
TH
610 unsigned int last_qtail;
611};
c445477d 612#define RPS_NO_FILTER 0xffff
fec5e652
TH
613
614/*
615 * The rps_dev_flow_table structure contains a table of flow mappings.
616 */
617struct rps_dev_flow_table {
618 unsigned int mask;
619 struct rcu_head rcu;
620 struct work_struct free_work;
621 struct rps_dev_flow flows[0];
622};
623#define RPS_DEV_FLOW_TABLE_SIZE(_num) (sizeof(struct rps_dev_flow_table) + \
60b778ce 624 ((_num) * sizeof(struct rps_dev_flow)))
fec5e652
TH
625
626/*
627 * The rps_sock_flow_table contains mappings of flows to the last CPU
628 * on which they were processed by the application (set in recvmsg).
629 */
630struct rps_sock_flow_table {
631 unsigned int mask;
632 u16 ents[0];
633};
634#define RPS_SOCK_FLOW_TABLE_SIZE(_num) (sizeof(struct rps_sock_flow_table) + \
60b778ce 635 ((_num) * sizeof(u16)))
fec5e652
TH
636
637#define RPS_NO_CPU 0xffff
638
639static inline void rps_record_sock_flow(struct rps_sock_flow_table *table,
640 u32 hash)
641{
642 if (table && hash) {
643 unsigned int cpu, index = hash & table->mask;
644
645 /* We only give a hint, preemption can change cpu under us */
646 cpu = raw_smp_processor_id();
647
648 if (table->ents[index] != cpu)
649 table->ents[index] = cpu;
650 }
651}
652
653static inline void rps_reset_sock_flow(struct rps_sock_flow_table *table,
654 u32 hash)
655{
656 if (table && hash)
657 table->ents[hash & table->mask] = RPS_NO_CPU;
658}
659
6e3f7faf 660extern struct rps_sock_flow_table __rcu *rps_sock_flow_table;
fec5e652 661
c445477d
BH
662#ifdef CONFIG_RFS_ACCEL
663extern bool rps_may_expire_flow(struct net_device *dev, u16 rxq_index,
664 u32 flow_id, u16 filter_id);
665#endif
666
0a9627f2
TH
667/* This structure contains an instance of an RX queue. */
668struct netdev_rx_queue {
6e3f7faf
ED
669 struct rps_map __rcu *rps_map;
670 struct rps_dev_flow_table __rcu *rps_flow_table;
671 struct kobject kobj;
fe822240 672 struct net_device *dev;
0a9627f2 673} ____cacheline_aligned_in_smp;
fec5e652 674#endif /* CONFIG_RPS */
d314774c 675
bf264145
TH
676#ifdef CONFIG_XPS
677/*
678 * This structure holds an XPS map which can be of variable length. The
679 * map is an array of queues.
680 */
681struct xps_map {
682 unsigned int len;
683 unsigned int alloc_len;
684 struct rcu_head rcu;
685 u16 queues[0];
686};
60b778ce 687#define XPS_MAP_SIZE(_num) (sizeof(struct xps_map) + ((_num) * sizeof(u16)))
bf264145
TH
688#define XPS_MIN_MAP_ALLOC ((L1_CACHE_BYTES - sizeof(struct xps_map)) \
689 / sizeof(u16))
690
691/*
692 * This structure holds all XPS maps for device. Maps are indexed by CPU.
693 */
694struct xps_dev_maps {
695 struct rcu_head rcu;
a4177869 696 struct xps_map __rcu *cpu_map[0];
bf264145
TH
697};
698#define XPS_DEV_MAPS_SIZE (sizeof(struct xps_dev_maps) + \
699 (nr_cpu_ids * sizeof(struct xps_map *)))
700#endif /* CONFIG_XPS */
701
4f57c087
JF
702#define TC_MAX_QUEUE 16
703#define TC_BITMASK 15
704/* HW offloaded queuing disciplines txq count and offset maps */
705struct netdev_tc_txq {
706 u16 count;
707 u16 offset;
708};
709
68bad94e
NP
710#if defined(CONFIG_FCOE) || defined(CONFIG_FCOE_MODULE)
711/*
712 * This structure is to hold information about the device
713 * configured to run FCoE protocol stack.
714 */
715struct netdev_fcoe_hbainfo {
716 char manufacturer[64];
717 char serial_number[64];
718 char hardware_version[64];
719 char driver_version[64];
720 char optionrom_version[64];
721 char firmware_version[64];
722 char model[256];
723 char model_description[256];
724};
725#endif
726
d314774c
SH
727/*
728 * This structure defines the management hooks for network devices.
00829823
SH
729 * The following hooks can be defined; unless noted otherwise, they are
730 * optional and can be filled with a null pointer.
d314774c
SH
731 *
732 * int (*ndo_init)(struct net_device *dev);
733 * This function is called once when network device is registered.
734 * The network device can use this to any late stage initializaton
735 * or semantic validattion. It can fail with an error code which will
736 * be propogated back to register_netdev
737 *
738 * void (*ndo_uninit)(struct net_device *dev);
739 * This function is called when device is unregistered or when registration
740 * fails. It is not called if init fails.
741 *
742 * int (*ndo_open)(struct net_device *dev);
743 * This function is called when network device transistions to the up
744 * state.
745 *
746 * int (*ndo_stop)(struct net_device *dev);
747 * This function is called when network device transistions to the down
748 * state.
749 *
dc1f8bf6
SH
750 * netdev_tx_t (*ndo_start_xmit)(struct sk_buff *skb,
751 * struct net_device *dev);
00829823 752 * Called when a packet needs to be transmitted.
dc1f8bf6
SH
753 * Must return NETDEV_TX_OK , NETDEV_TX_BUSY.
754 * (can also return NETDEV_TX_LOCKED iff NETIF_F_LLTX)
00829823
SH
755 * Required can not be NULL.
756 *
757 * u16 (*ndo_select_queue)(struct net_device *dev, struct sk_buff *skb);
758 * Called to decide which queue to when device supports multiple
759 * transmit queues.
760 *
d314774c
SH
761 * void (*ndo_change_rx_flags)(struct net_device *dev, int flags);
762 * This function is called to allow device receiver to make
763 * changes to configuration when multicast or promiscious is enabled.
764 *
765 * void (*ndo_set_rx_mode)(struct net_device *dev);
766 * This function is called device changes address list filtering.
01789349
JP
767 * If driver handles unicast address filtering, it should set
768 * IFF_UNICAST_FLT to its priv_flags.
d314774c
SH
769 *
770 * int (*ndo_set_mac_address)(struct net_device *dev, void *addr);
771 * This function is called when the Media Access Control address
37b607c5 772 * needs to be changed. If this interface is not defined, the
d314774c
SH
773 * mac address can not be changed.
774 *
775 * int (*ndo_validate_addr)(struct net_device *dev);
776 * Test if Media Access Control address is valid for the device.
777 *
778 * int (*ndo_do_ioctl)(struct net_device *dev, struct ifreq *ifr, int cmd);
779 * Called when a user request an ioctl which can't be handled by
780 * the generic interface code. If not defined ioctl's return
781 * not supported error code.
782 *
783 * int (*ndo_set_config)(struct net_device *dev, struct ifmap *map);
784 * Used to set network devices bus interface parameters. This interface
785 * is retained for legacy reason, new devices should use the bus
786 * interface (PCI) for low level management.
787 *
788 * int (*ndo_change_mtu)(struct net_device *dev, int new_mtu);
789 * Called when a user wants to change the Maximum Transfer Unit
790 * of a device. If not defined, any request to change MTU will
791 * will return an error.
792 *
00829823 793 * void (*ndo_tx_timeout)(struct net_device *dev);
d314774c
SH
794 * Callback uses when the transmitter has not made any progress
795 * for dev->watchdog ticks.
796 *
3cfde79c 797 * struct rtnl_link_stats64* (*ndo_get_stats64)(struct net_device *dev,
28172739 798 * struct rtnl_link_stats64 *storage);
d308e38f 799 * struct net_device_stats* (*ndo_get_stats)(struct net_device *dev);
d314774c 800 * Called when a user wants to get the network device usage
be1f3c2c 801 * statistics. Drivers must do one of the following:
3cfde79c
BH
802 * 1. Define @ndo_get_stats64 to fill in a zero-initialised
803 * rtnl_link_stats64 structure passed by the caller.
82695d9b 804 * 2. Define @ndo_get_stats to update a net_device_stats structure
be1f3c2c
BH
805 * (which should normally be dev->stats) and return a pointer to
806 * it. The structure may be changed asynchronously only if each
807 * field is written atomically.
808 * 3. Update dev->stats asynchronously and atomically, and define
809 * neither operation.
d314774c 810 *
8e586137 811 * int (*ndo_vlan_rx_add_vid)(struct net_device *dev, unsigned short vid);
d314774c
SH
812 * If device support VLAN filtering (dev->features & NETIF_F_HW_VLAN_FILTER)
813 * this function is called when a VLAN id is registered.
814 *
8e586137 815 * int (*ndo_vlan_rx_kill_vid)(struct net_device *dev, unsigned short vid);
d314774c
SH
816 * If device support VLAN filtering (dev->features & NETIF_F_HW_VLAN_FILTER)
817 * this function is called when a VLAN id is unregistered.
818 *
819 * void (*ndo_poll_controller)(struct net_device *dev);
95c26df8
WM
820 *
821 * SR-IOV management functions.
822 * int (*ndo_set_vf_mac)(struct net_device *dev, int vf, u8* mac);
823 * int (*ndo_set_vf_vlan)(struct net_device *dev, int vf, u16 vlan, u8 qos);
824 * int (*ndo_set_vf_tx_rate)(struct net_device *dev, int vf, int rate);
5f8444a3 825 * int (*ndo_set_vf_spoofchk)(struct net_device *dev, int vf, bool setting);
95c26df8
WM
826 * int (*ndo_get_vf_config)(struct net_device *dev,
827 * int vf, struct ifla_vf_info *ivf);
57b61080
SF
828 * int (*ndo_set_vf_port)(struct net_device *dev, int vf,
829 * struct nlattr *port[]);
830 * int (*ndo_get_vf_port)(struct net_device *dev, int vf, struct sk_buff *skb);
4f57c087
JF
831 * int (*ndo_setup_tc)(struct net_device *dev, u8 tc)
832 * Called to setup 'tc' number of traffic classes in the net device. This
833 * is always called from the stack with the rtnl lock held and netif tx
834 * queues stopped. This allows the netdevice to perform queue management
835 * safely.
c445477d 836 *
e9bce845
YZ
837 * Fiber Channel over Ethernet (FCoE) offload functions.
838 * int (*ndo_fcoe_enable)(struct net_device *dev);
839 * Called when the FCoE protocol stack wants to start using LLD for FCoE
840 * so the underlying device can perform whatever needed configuration or
841 * initialization to support acceleration of FCoE traffic.
842 *
843 * int (*ndo_fcoe_disable)(struct net_device *dev);
844 * Called when the FCoE protocol stack wants to stop using LLD for FCoE
845 * so the underlying device can perform whatever needed clean-ups to
846 * stop supporting acceleration of FCoE traffic.
847 *
848 * int (*ndo_fcoe_ddp_setup)(struct net_device *dev, u16 xid,
849 * struct scatterlist *sgl, unsigned int sgc);
850 * Called when the FCoE Initiator wants to initialize an I/O that
851 * is a possible candidate for Direct Data Placement (DDP). The LLD can
852 * perform necessary setup and returns 1 to indicate the device is set up
853 * successfully to perform DDP on this I/O, otherwise this returns 0.
854 *
855 * int (*ndo_fcoe_ddp_done)(struct net_device *dev, u16 xid);
856 * Called when the FCoE Initiator/Target is done with the DDPed I/O as
857 * indicated by the FC exchange id 'xid', so the underlying device can
858 * clean up and reuse resources for later DDP requests.
859 *
860 * int (*ndo_fcoe_ddp_target)(struct net_device *dev, u16 xid,
861 * struct scatterlist *sgl, unsigned int sgc);
862 * Called when the FCoE Target wants to initialize an I/O that
863 * is a possible candidate for Direct Data Placement (DDP). The LLD can
864 * perform necessary setup and returns 1 to indicate the device is set up
865 * successfully to perform DDP on this I/O, otherwise this returns 0.
866 *
68bad94e
NP
867 * int (*ndo_fcoe_get_hbainfo)(struct net_device *dev,
868 * struct netdev_fcoe_hbainfo *hbainfo);
869 * Called when the FCoE Protocol stack wants information on the underlying
870 * device. This information is utilized by the FCoE protocol stack to
871 * register attributes with Fiber Channel management service as per the
872 * FC-GS Fabric Device Management Information(FDMI) specification.
873 *
e9bce845
YZ
874 * int (*ndo_fcoe_get_wwn)(struct net_device *dev, u64 *wwn, int type);
875 * Called when the underlying device wants to override default World Wide
876 * Name (WWN) generation mechanism in FCoE protocol stack to pass its own
877 * World Wide Port Name (WWPN) or World Wide Node Name (WWNN) to the FCoE
878 * protocol stack to use.
879 *
c445477d
BH
880 * RFS acceleration.
881 * int (*ndo_rx_flow_steer)(struct net_device *dev, const struct sk_buff *skb,
882 * u16 rxq_index, u32 flow_id);
883 * Set hardware filter for RFS. rxq_index is the target queue index;
884 * flow_id is a flow ID to be passed to rps_may_expire_flow() later.
885 * Return the filter ID on success, or a negative error code.
fbaec0ea
JP
886 *
887 * Slave management functions (for bridge, bonding, etc). User should
888 * call netdev_set_master() to set dev->master properly.
889 * int (*ndo_add_slave)(struct net_device *dev, struct net_device *slave_dev);
890 * Called to make another netdev an underling.
891 *
892 * int (*ndo_del_slave)(struct net_device *dev, struct net_device *slave_dev);
893 * Called to release previously enslaved netdev.
5455c699
MM
894 *
895 * Feature/offload setting functions.
c8f44aff
MM
896 * netdev_features_t (*ndo_fix_features)(struct net_device *dev,
897 * netdev_features_t features);
5455c699
MM
898 * Adjusts the requested feature flags according to device-specific
899 * constraints, and returns the resulting flags. Must not modify
900 * the device state.
901 *
c8f44aff 902 * int (*ndo_set_features)(struct net_device *dev, netdev_features_t features);
5455c699
MM
903 * Called to update device configuration to new features. Passed
904 * feature set might be less than what was returned by ndo_fix_features()).
905 * Must return >0 or -errno if it changed dev->features itself.
906 *
d314774c
SH
907 */
908struct net_device_ops {
909 int (*ndo_init)(struct net_device *dev);
910 void (*ndo_uninit)(struct net_device *dev);
911 int (*ndo_open)(struct net_device *dev);
912 int (*ndo_stop)(struct net_device *dev);
dc1f8bf6 913 netdev_tx_t (*ndo_start_xmit) (struct sk_buff *skb,
00829823
SH
914 struct net_device *dev);
915 u16 (*ndo_select_queue)(struct net_device *dev,
916 struct sk_buff *skb);
d314774c
SH
917 void (*ndo_change_rx_flags)(struct net_device *dev,
918 int flags);
d314774c 919 void (*ndo_set_rx_mode)(struct net_device *dev);
d314774c
SH
920 int (*ndo_set_mac_address)(struct net_device *dev,
921 void *addr);
d314774c 922 int (*ndo_validate_addr)(struct net_device *dev);
d314774c
SH
923 int (*ndo_do_ioctl)(struct net_device *dev,
924 struct ifreq *ifr, int cmd);
d314774c
SH
925 int (*ndo_set_config)(struct net_device *dev,
926 struct ifmap *map);
00829823
SH
927 int (*ndo_change_mtu)(struct net_device *dev,
928 int new_mtu);
929 int (*ndo_neigh_setup)(struct net_device *dev,
930 struct neigh_parms *);
d314774c
SH
931 void (*ndo_tx_timeout) (struct net_device *dev);
932
28172739
ED
933 struct rtnl_link_stats64* (*ndo_get_stats64)(struct net_device *dev,
934 struct rtnl_link_stats64 *storage);
d314774c
SH
935 struct net_device_stats* (*ndo_get_stats)(struct net_device *dev);
936
8e586137 937 int (*ndo_vlan_rx_add_vid)(struct net_device *dev,
d314774c 938 unsigned short vid);
8e586137 939 int (*ndo_vlan_rx_kill_vid)(struct net_device *dev,
d314774c
SH
940 unsigned short vid);
941#ifdef CONFIG_NET_POLL_CONTROLLER
d314774c 942 void (*ndo_poll_controller)(struct net_device *dev);
4247e161
HX
943 int (*ndo_netpoll_setup)(struct net_device *dev,
944 struct netpoll_info *info);
0e34e931 945 void (*ndo_netpoll_cleanup)(struct net_device *dev);
d314774c 946#endif
95c26df8
WM
947 int (*ndo_set_vf_mac)(struct net_device *dev,
948 int queue, u8 *mac);
949 int (*ndo_set_vf_vlan)(struct net_device *dev,
950 int queue, u16 vlan, u8 qos);
951 int (*ndo_set_vf_tx_rate)(struct net_device *dev,
952 int vf, int rate);
5f8444a3
GR
953 int (*ndo_set_vf_spoofchk)(struct net_device *dev,
954 int vf, bool setting);
95c26df8
WM
955 int (*ndo_get_vf_config)(struct net_device *dev,
956 int vf,
957 struct ifla_vf_info *ivf);
57b61080
SF
958 int (*ndo_set_vf_port)(struct net_device *dev,
959 int vf,
960 struct nlattr *port[]);
961 int (*ndo_get_vf_port)(struct net_device *dev,
962 int vf, struct sk_buff *skb);
4f57c087 963 int (*ndo_setup_tc)(struct net_device *dev, u8 tc);
d11ead75 964#if IS_ENABLED(CONFIG_FCOE)
cb454399
YZ
965 int (*ndo_fcoe_enable)(struct net_device *dev);
966 int (*ndo_fcoe_disable)(struct net_device *dev);
4d288d57
YZ
967 int (*ndo_fcoe_ddp_setup)(struct net_device *dev,
968 u16 xid,
969 struct scatterlist *sgl,
970 unsigned int sgc);
971 int (*ndo_fcoe_ddp_done)(struct net_device *dev,
972 u16 xid);
6247e086
YZ
973 int (*ndo_fcoe_ddp_target)(struct net_device *dev,
974 u16 xid,
975 struct scatterlist *sgl,
976 unsigned int sgc);
68bad94e
NP
977 int (*ndo_fcoe_get_hbainfo)(struct net_device *dev,
978 struct netdev_fcoe_hbainfo *hbainfo);
3c9c36bc
BPG
979#endif
980
d11ead75 981#if IS_ENABLED(CONFIG_LIBFCOE)
df5c7945
YZ
982#define NETDEV_FCOE_WWNN 0
983#define NETDEV_FCOE_WWPN 1
984 int (*ndo_fcoe_get_wwn)(struct net_device *dev,
985 u64 *wwn, int type);
4d288d57 986#endif
3c9c36bc 987
c445477d
BH
988#ifdef CONFIG_RFS_ACCEL
989 int (*ndo_rx_flow_steer)(struct net_device *dev,
990 const struct sk_buff *skb,
991 u16 rxq_index,
992 u32 flow_id);
993#endif
fbaec0ea
JP
994 int (*ndo_add_slave)(struct net_device *dev,
995 struct net_device *slave_dev);
996 int (*ndo_del_slave)(struct net_device *dev,
997 struct net_device *slave_dev);
c8f44aff
MM
998 netdev_features_t (*ndo_fix_features)(struct net_device *dev,
999 netdev_features_t features);
5455c699 1000 int (*ndo_set_features)(struct net_device *dev,
c8f44aff 1001 netdev_features_t features);
da6a8fa0 1002 int (*ndo_neigh_construct)(struct neighbour *n);
447f2191 1003 void (*ndo_neigh_destroy)(struct neighbour *n);
d314774c
SH
1004};
1005
1da177e4
LT
1006/*
1007 * The DEVICE structure.
1008 * Actually, this whole structure is a big mistake. It mixes I/O
1009 * data with strictly "high-level" data, and it has to know about
1010 * almost every data structure used in the INET module.
1011 *
1012 * FIXME: cleanup struct net_device such that network protocol info
1013 * moves out.
1014 */
1015
d94d9fee 1016struct net_device {
1da177e4
LT
1017
1018 /*
1019 * This is the first field of the "visible" part of this structure
1020 * (i.e. as seen by users in the "Space.c" file). It is the name
724df615 1021 * of the interface.
1da177e4
LT
1022 */
1023 char name[IFNAMSIZ];
ed77134b 1024
cc749986 1025 struct pm_qos_request pm_qos_req;
ed77134b 1026
9356b8fc
ED
1027 /* device name hash chain */
1028 struct hlist_node name_hlist;
0b815a1a
SH
1029 /* snmp alias */
1030 char *ifalias;
1da177e4
LT
1031
1032 /*
1033 * I/O specific fields
1034 * FIXME: Merge these and struct ifmap into one
1035 */
1036 unsigned long mem_end; /* shared mem end */
1037 unsigned long mem_start; /* shared mem start */
1038 unsigned long base_addr; /* device I/O address */
1039 unsigned int irq; /* device IRQ number */
1040
1041 /*
1042 * Some hardware also needs these fields, but they are not
1043 * part of the usual set specified in Space.c.
1044 */
1045
1da177e4
LT
1046 unsigned long state;
1047
7562f876 1048 struct list_head dev_list;
bea3348e 1049 struct list_head napi_list;
44a0873d 1050 struct list_head unreg_list;
1da177e4 1051
5455c699 1052 /* currently active device features */
c8f44aff 1053 netdev_features_t features;
5455c699 1054 /* user-changeable features */
c8f44aff 1055 netdev_features_t hw_features;
5455c699 1056 /* user-requested features */
c8f44aff 1057 netdev_features_t wanted_features;
1aac6267 1058 /* mask of features inheritable by VLAN devices */
c8f44aff 1059 netdev_features_t vlan_features;
04ed3e74 1060
1da177e4
LT
1061 /* Interface index. Unique device identifier */
1062 int ifindex;
1063 int iflink;
1064
c45d286e 1065 struct net_device_stats stats;
caf586e5
ED
1066 atomic_long_t rx_dropped; /* dropped packets by core network
1067 * Do not use this in drivers.
1068 */
1da177e4 1069
b86e0280 1070#ifdef CONFIG_WIRELESS_EXT
1da177e4
LT
1071 /* List of functions to handle Wireless Extensions (instead of ioctl).
1072 * See <net/iw_handler.h> for details. Jean II */
1073 const struct iw_handler_def * wireless_handlers;
1074 /* Instance data managed by the core of Wireless Extensions. */
1075 struct iw_public_data * wireless_data;
b86e0280 1076#endif
d314774c
SH
1077 /* Management operations */
1078 const struct net_device_ops *netdev_ops;
76fd8593 1079 const struct ethtool_ops *ethtool_ops;
1da177e4 1080
3b04ddde
SH
1081 /* Hardware header description */
1082 const struct header_ops *header_ops;
1083
b00055aa 1084 unsigned int flags; /* interface flags (a la BSD) */
3bdc0eba
BG
1085 unsigned int priv_flags; /* Like 'flags' but invisible to userspace.
1086 * See if.h for definitions. */
1da177e4 1087 unsigned short gflags;
1da177e4
LT
1088 unsigned short padded; /* How much padding added by alloc_netdev() */
1089
b00055aa
SR
1090 unsigned char operstate; /* RFC2863 operstate */
1091 unsigned char link_mode; /* mapping policy to operstate */
1092
bdc220da
JP
1093 unsigned char if_port; /* Selectable AUI, TP,..*/
1094 unsigned char dma; /* DMA channel */
1095
cd7b5396 1096 unsigned int mtu; /* interface MTU value */
1da177e4
LT
1097 unsigned short type; /* interface hardware type */
1098 unsigned short hard_header_len; /* hardware hdr length */
1da177e4 1099
f5184d26
JB
1100 /* extra head- and tailroom the hardware may need, but not in all cases
1101 * can this be guaranteed, especially tailroom. Some cases also use
1102 * LL_MAX_HEADER instead to allocate the skb.
1103 */
1104 unsigned short needed_headroom;
1105 unsigned short needed_tailroom;
1106
1da177e4 1107 /* Interface address info. */
a6f9a705 1108 unsigned char perm_addr[MAX_ADDR_LEN]; /* permanent hw address */
c1f79426 1109 unsigned char addr_assign_type; /* hw address assignment type */
1da177e4 1110 unsigned char addr_len; /* hardware address length */
596b9b68 1111 unsigned char neigh_priv_len;
1da177e4
LT
1112 unsigned short dev_id; /* for shared network cards */
1113
ccffad25 1114 spinlock_t addr_list_lock;
22bedad3
JP
1115 struct netdev_hw_addr_list uc; /* Unicast mac addresses */
1116 struct netdev_hw_addr_list mc; /* Multicast mac addresses */
2d348d1f 1117 bool uc_promisc;
9d45abe1
WC
1118 unsigned int promiscuity;
1119 unsigned int allmulti;
1da177e4 1120
1da177e4
LT
1121
1122 /* Protocol specific pointers */
65ac6a5f 1123
d11ead75 1124#if IS_ENABLED(CONFIG_VLAN_8021Q)
5b9ea6e0 1125 struct vlan_info __rcu *vlan_info; /* VLAN info */
65ac6a5f 1126#endif
34a430d7 1127#if IS_ENABLED(CONFIG_NET_DSA)
cf50dcc2 1128 struct dsa_switch_tree *dsa_ptr; /* dsa specific data */
91da11f8 1129#endif
1da177e4 1130 void *atalk_ptr; /* AppleTalk link */
95ae6b22 1131 struct in_device __rcu *ip_ptr; /* IPv4 specific data */
fc766e4c 1132 struct dn_dev __rcu *dn_ptr; /* DECnet specific data */
198caeca 1133 struct inet6_dev __rcu *ip6_ptr; /* IPv6 specific data */
1da177e4
LT
1134 void *ec_ptr; /* Econet specific data */
1135 void *ax25_ptr; /* AX.25 specific data */
704232c2
JB
1136 struct wireless_dev *ieee80211_ptr; /* IEEE 802.11 specific data,
1137 assign before registering */
1da177e4 1138
9356b8fc 1139/*
cd13539b 1140 * Cache lines mostly used on receive path (including eth_type_trans())
9356b8fc 1141 */
4dc89133
ED
1142 unsigned long last_rx; /* Time of last Rx
1143 * This should not be set in
1144 * drivers, unless really needed,
1145 * because network stack (bonding)
1146 * use it if/when necessary, to
1147 * avoid dirtying this cache line.
1148 */
1149
cd13539b
ED
1150 struct net_device *master; /* Pointer to master device of a group,
1151 * which this device is member of.
1152 */
1153
9356b8fc 1154 /* Interface address info used in eth_type_trans() */
f001fde5
JP
1155 unsigned char *dev_addr; /* hw address, (before bcast
1156 because most packets are
1157 unicast) */
1158
31278e71
JP
1159 struct netdev_hw_addr_list dev_addrs; /* list of device
1160 hw addresses */
9356b8fc
ED
1161
1162 unsigned char broadcast[MAX_ADDR_LEN]; /* hw bcast add */
1da177e4 1163
ccf5ff69 1164#ifdef CONFIG_SYSFS
0a9627f2 1165 struct kset *queues_kset;
ccf5ff69 1166#endif
0a9627f2 1167
ccf5ff69 1168#ifdef CONFIG_RPS
0a9627f2
TH
1169 struct netdev_rx_queue *_rx;
1170
62fe0b40 1171 /* Number of RX queues allocated at register_netdev() time */
0a9627f2 1172 unsigned int num_rx_queues;
62fe0b40
BH
1173
1174 /* Number of RX queues currently active in device */
1175 unsigned int real_num_rx_queues;
c445477d
BH
1176
1177#ifdef CONFIG_RFS_ACCEL
1178 /* CPU reverse-mapping for RX completion interrupts, indexed
1179 * by RX queue number. Assigned by driver. This must only be
1180 * set if the ndo_rx_flow_steer operation is defined. */
1181 struct cpu_rmap *rx_cpu_rmap;
1182#endif
df334545 1183#endif
0a9627f2 1184
61391cde 1185 rx_handler_func_t __rcu *rx_handler;
1186 void __rcu *rx_handler_data;
e8a0464c 1187
24824a09 1188 struct netdev_queue __rcu *ingress_queue;
cd13539b
ED
1189
1190/*
1191 * Cache lines mostly used on transmit path
1192 */
e8a0464c 1193 struct netdev_queue *_tx ____cacheline_aligned_in_smp;
fd2ea0a7
DM
1194
1195 /* Number of TX queues allocated at alloc_netdev_mq() time */
e8a0464c 1196 unsigned int num_tx_queues;
fd2ea0a7
DM
1197
1198 /* Number of TX queues currently active in device */
1199 unsigned int real_num_tx_queues;
1200
af356afa
PM
1201 /* root qdisc from userspace point of view */
1202 struct Qdisc *qdisc;
1203
1da177e4 1204 unsigned long tx_queue_len; /* Max frames per queue allowed */
c3f26a26 1205 spinlock_t tx_global_lock;
cd13539b 1206
bf264145 1207#ifdef CONFIG_XPS
a4177869 1208 struct xps_dev_maps __rcu *xps_maps;
bf264145 1209#endif
1d24eb48 1210
9356b8fc 1211 /* These may be needed for future network-power-down code. */
9d21493b
ED
1212
1213 /*
1214 * trans_start here is expensive for high speed devices on SMP,
1215 * please use netdev_queue->trans_start instead.
1216 */
9356b8fc
ED
1217 unsigned long trans_start; /* Time (in jiffies) of last Tx */
1218
1219 int watchdog_timeo; /* used by dev_watchdog() */
1220 struct timer_list watchdog_timer;
1221
1da177e4 1222 /* Number of references to this device */
29b4433d 1223 int __percpu *pcpu_refcnt;
9356b8fc 1224
1da177e4
LT
1225 /* delayed register/unregister */
1226 struct list_head todo_list;
1da177e4
LT
1227 /* device index hash chain */
1228 struct hlist_node index_hlist;
1229
e014debe 1230 struct list_head link_watch_list;
572a103d 1231
1da177e4
LT
1232 /* register/unregister state machine */
1233 enum { NETREG_UNINITIALIZED=0,
b17a7c17 1234 NETREG_REGISTERED, /* completed register_netdevice */
1da177e4
LT
1235 NETREG_UNREGISTERING, /* called unregister_netdevice */
1236 NETREG_UNREGISTERED, /* completed unregister todo */
1237 NETREG_RELEASED, /* called free_netdev */
937f1ba5 1238 NETREG_DUMMY, /* dummy device for NAPI poll */
449f4544
ED
1239 } reg_state:8;
1240
1241 bool dismantle; /* device is going do be freed */
a2835763
PM
1242
1243 enum {
1244 RTNL_LINK_INITIALIZED,
1245 RTNL_LINK_INITIALIZING,
1246 } rtnl_link_state:16;
1da177e4 1247
d314774c
SH
1248 /* Called from unregister, can be used to call free_netdev */
1249 void (*destructor)(struct net_device *dev);
1da177e4 1250
1da177e4 1251#ifdef CONFIG_NETPOLL
115c1d6e 1252 struct netpoll_info *npinfo;
1da177e4 1253#endif
eae792b7 1254
c346dca1 1255#ifdef CONFIG_NET_NS
4a1c5371
EB
1256 /* Network namespace this network device is inside */
1257 struct net *nd_net;
c346dca1 1258#endif
4a1c5371 1259
4951704b 1260 /* mid-layer private */
a7855c78
ED
1261 union {
1262 void *ml_priv;
1263 struct pcpu_lstats __percpu *lstats; /* loopback stats */
290b895e 1264 struct pcpu_tstats __percpu *tstats; /* tunnel stats */
6d81f41c 1265 struct pcpu_dstats __percpu *dstats; /* dummy stats */
a7855c78 1266 };
eca9ebac 1267 /* GARP */
3cc77ec7 1268 struct garp_port __rcu *garp_port;
1da177e4 1269
1da177e4 1270 /* class/net/name entry */
43cb76d9 1271 struct device dev;
0c509a6c
EB
1272 /* space for optional device, statistics, and wireless sysfs groups */
1273 const struct attribute_group *sysfs_groups[4];
38f7b870
PM
1274
1275 /* rtnetlink link ops */
1276 const struct rtnl_link_ops *rtnl_link_ops;
f25f4e44 1277
82cc1a7a
PWJ
1278 /* for setting kernel sock attribute on TCP connection setup */
1279#define GSO_MAX_SIZE 65536
1280 unsigned int gso_max_size;
d314774c 1281
7a6b6f51 1282#ifdef CONFIG_DCB
2f90b865 1283 /* Data Center Bridging netlink ops */
32953543 1284 const struct dcbnl_rtnl_ops *dcbnl_ops;
2f90b865 1285#endif
4f57c087
JF
1286 u8 num_tc;
1287 struct netdev_tc_txq tc_to_txq[TC_MAX_QUEUE];
1288 u8 prio_tc_map[TC_BITMASK + 1];
2f90b865 1289
d11ead75 1290#if IS_ENABLED(CONFIG_FCOE)
4d288d57
YZ
1291 /* max exchange id for FCoE LRO by ddp */
1292 unsigned int fcoe_ddp_xid;
5bc1421e
NH
1293#endif
1294#if IS_ENABLED(CONFIG_NETPRIO_CGROUP)
1295 struct netprio_map __rcu *priomap;
4d288d57 1296#endif
c1f19b51
RC
1297 /* phy device may attach itself for hardware timestamping */
1298 struct phy_device *phydev;
cbda10fa
VD
1299
1300 /* group the device belongs to */
1301 int group;
1da177e4 1302};
43cb76d9 1303#define to_net_dev(d) container_of(d, struct net_device, dev)
1da177e4
LT
1304
1305#define NETDEV_ALIGN 32
1da177e4 1306
4f57c087
JF
1307static inline
1308int netdev_get_prio_tc_map(const struct net_device *dev, u32 prio)
1309{
1310 return dev->prio_tc_map[prio & TC_BITMASK];
1311}
1312
1313static inline
1314int netdev_set_prio_tc_map(struct net_device *dev, u8 prio, u8 tc)
1315{
1316 if (tc >= dev->num_tc)
1317 return -EINVAL;
1318
1319 dev->prio_tc_map[prio & TC_BITMASK] = tc & TC_BITMASK;
1320 return 0;
1321}
1322
1323static inline
1324void netdev_reset_tc(struct net_device *dev)
1325{
1326 dev->num_tc = 0;
1327 memset(dev->tc_to_txq, 0, sizeof(dev->tc_to_txq));
1328 memset(dev->prio_tc_map, 0, sizeof(dev->prio_tc_map));
1329}
1330
1331static inline
1332int netdev_set_tc_queue(struct net_device *dev, u8 tc, u16 count, u16 offset)
1333{
1334 if (tc >= dev->num_tc)
1335 return -EINVAL;
1336
1337 dev->tc_to_txq[tc].count = count;
1338 dev->tc_to_txq[tc].offset = offset;
1339 return 0;
1340}
1341
1342static inline
1343int netdev_set_num_tc(struct net_device *dev, u8 num_tc)
1344{
1345 if (num_tc > TC_MAX_QUEUE)
1346 return -EINVAL;
1347
1348 dev->num_tc = num_tc;
1349 return 0;
1350}
1351
1352static inline
1353int netdev_get_num_tc(struct net_device *dev)
1354{
1355 return dev->num_tc;
1356}
1357
e8a0464c
DM
1358static inline
1359struct netdev_queue *netdev_get_tx_queue(const struct net_device *dev,
1360 unsigned int index)
1361{
1362 return &dev->_tx[index];
1363}
1364
1365static inline void netdev_for_each_tx_queue(struct net_device *dev,
1366 void (*f)(struct net_device *,
1367 struct netdev_queue *,
1368 void *),
1369 void *arg)
1370{
1371 unsigned int i;
1372
1373 for (i = 0; i < dev->num_tx_queues; i++)
1374 f(dev, &dev->_tx[i], arg);
1375}
1376
c346dca1
YH
1377/*
1378 * Net namespace inlines
1379 */
1380static inline
1381struct net *dev_net(const struct net_device *dev)
1382{
c2d9ba9b 1383 return read_pnet(&dev->nd_net);
c346dca1
YH
1384}
1385
1386static inline
f5aa23fd 1387void dev_net_set(struct net_device *dev, struct net *net)
c346dca1
YH
1388{
1389#ifdef CONFIG_NET_NS
f3005d7f
DL
1390 release_net(dev->nd_net);
1391 dev->nd_net = hold_net(net);
c346dca1
YH
1392#endif
1393}
1394
cf85d08f
LB
1395static inline bool netdev_uses_dsa_tags(struct net_device *dev)
1396{
1397#ifdef CONFIG_NET_DSA_TAG_DSA
1398 if (dev->dsa_ptr != NULL)
1399 return dsa_uses_dsa_tags(dev->dsa_ptr);
1400#endif
1401
1402 return 0;
1403}
1404
8a83a00b
AB
1405#ifndef CONFIG_NET_NS
1406static inline void skb_set_dev(struct sk_buff *skb, struct net_device *dev)
1407{
1408 skb->dev = dev;
1409}
1410#else /* CONFIG_NET_NS */
1411void skb_set_dev(struct sk_buff *skb, struct net_device *dev);
1412#endif
1413
396138f0
LB
1414static inline bool netdev_uses_trailer_tags(struct net_device *dev)
1415{
1416#ifdef CONFIG_NET_DSA_TAG_TRAILER
1417 if (dev->dsa_ptr != NULL)
1418 return dsa_uses_trailer_tags(dev->dsa_ptr);
1419#endif
1420
1421 return 0;
1422}
1423
bea3348e
SH
1424/**
1425 * netdev_priv - access network device private data
1426 * @dev: network device
1427 *
1428 * Get network device private data
1429 */
6472ce60 1430static inline void *netdev_priv(const struct net_device *dev)
1da177e4 1431{
1ce8e7b5 1432 return (char *)dev + ALIGN(sizeof(struct net_device), NETDEV_ALIGN);
1da177e4
LT
1433}
1434
1da177e4
LT
1435/* Set the sysfs physical device reference for the network logical device
1436 * if set prior to registration will cause a symlink during initialization.
1437 */
43cb76d9 1438#define SET_NETDEV_DEV(net, pdev) ((net)->dev.parent = (pdev))
1da177e4 1439
384912ed
MH
1440/* Set the sysfs device type for the network logical device to allow
1441 * fin grained indentification of different network device types. For
1442 * example Ethernet, Wirelss LAN, Bluetooth, WiMAX etc.
1443 */
1444#define SET_NETDEV_DEVTYPE(net, devtype) ((net)->dev.type = (devtype))
1445
3b582cc1
SH
1446/**
1447 * netif_napi_add - initialize a napi context
1448 * @dev: network device
1449 * @napi: napi context
1450 * @poll: polling function
1451 * @weight: default weight
1452 *
1453 * netif_napi_add() must be used to initialize a napi context prior to calling
1454 * *any* of the other napi related functions.
1455 */
d565b0a1
HX
1456void netif_napi_add(struct net_device *dev, struct napi_struct *napi,
1457 int (*poll)(struct napi_struct *, int), int weight);
bea3348e 1458
d8156534
AD
1459/**
1460 * netif_napi_del - remove a napi context
1461 * @napi: napi context
1462 *
1463 * netif_napi_del() removes a napi context from the network device napi list
1464 */
d565b0a1
HX
1465void netif_napi_del(struct napi_struct *napi);
1466
1467struct napi_gro_cb {
78a478d0
HX
1468 /* Virtual address of skb_shinfo(skb)->frags[0].page + offset. */
1469 void *frag0;
1470
7489594c
HX
1471 /* Length of frag0. */
1472 unsigned int frag0_len;
1473
86911732
HX
1474 /* This indicates where we are processing relative to skb->data. */
1475 int data_offset;
1476
d565b0a1
HX
1477 /* This is non-zero if the packet may be of the same flow. */
1478 int same_flow;
1479
1480 /* This is non-zero if the packet cannot be merged with the new skb. */
1481 int flush;
1482
1483 /* Number of segments aggregated. */
1484 int count;
5d38a079
HX
1485
1486 /* Free the skb? */
1487 int free;
d565b0a1
HX
1488};
1489
1490#define NAPI_GRO_CB(skb) ((struct napi_gro_cb *)(skb)->cb)
d8156534 1491
1da177e4 1492struct packet_type {
f2ccd8fa
DM
1493 __be16 type; /* This is really htons(ether_type). */
1494 struct net_device *dev; /* NULL is wildcarded here */
1495 int (*func) (struct sk_buff *,
1496 struct net_device *,
1497 struct packet_type *,
1498 struct net_device *);
576a30eb 1499 struct sk_buff *(*gso_segment)(struct sk_buff *skb,
c8f44aff 1500 netdev_features_t features);
a430a43d 1501 int (*gso_send_check)(struct sk_buff *skb);
d565b0a1
HX
1502 struct sk_buff **(*gro_receive)(struct sk_buff **head,
1503 struct sk_buff *skb);
1504 int (*gro_complete)(struct sk_buff *skb);
1da177e4
LT
1505 void *af_packet_priv;
1506 struct list_head list;
1507};
1508
1da177e4
LT
1509#include <linux/notifier.h>
1510
dcfe1421
AW
1511/* netdevice notifier chain. Please remember to update the rtnetlink
1512 * notification exclusion list in rtnetlink_event() when adding new
1513 * types.
1514 */
1515#define NETDEV_UP 0x0001 /* For now you can't veto a device up/down */
1516#define NETDEV_DOWN 0x0002
1517#define NETDEV_REBOOT 0x0003 /* Tell a protocol stack a network interface
1518 detected a hardware crash and restarted
1519 - we can use this eg to kick tcp sessions
1520 once done */
1521#define NETDEV_CHANGE 0x0004 /* Notify device state change */
1522#define NETDEV_REGISTER 0x0005
1523#define NETDEV_UNREGISTER 0x0006
1524#define NETDEV_CHANGEMTU 0x0007
1525#define NETDEV_CHANGEADDR 0x0008
1526#define NETDEV_GOING_DOWN 0x0009
1527#define NETDEV_CHANGENAME 0x000A
1528#define NETDEV_FEAT_CHANGE 0x000B
1529#define NETDEV_BONDING_FAILOVER 0x000C
1530#define NETDEV_PRE_UP 0x000D
1531#define NETDEV_PRE_TYPE_CHANGE 0x000E
1532#define NETDEV_POST_TYPE_CHANGE 0x000F
1533#define NETDEV_POST_INIT 0x0010
1534#define NETDEV_UNREGISTER_BATCH 0x0011
1535#define NETDEV_RELEASE 0x0012
1536#define NETDEV_NOTIFY_PEERS 0x0013
1537#define NETDEV_JOIN 0x0014
1538
1539extern int register_netdevice_notifier(struct notifier_block *nb);
1540extern int unregister_netdevice_notifier(struct notifier_block *nb);
1541extern int call_netdevice_notifiers(unsigned long val, struct net_device *dev);
1542
1543
1da177e4
LT
1544extern rwlock_t dev_base_lock; /* Device list lock */
1545
7562f876 1546
881d966b
EB
1547#define for_each_netdev(net, d) \
1548 list_for_each_entry(d, &(net)->dev_base_head, dev_list)
dcbccbd4
EB
1549#define for_each_netdev_reverse(net, d) \
1550 list_for_each_entry_reverse(d, &(net)->dev_base_head, dev_list)
c6d14c84
ED
1551#define for_each_netdev_rcu(net, d) \
1552 list_for_each_entry_rcu(d, &(net)->dev_base_head, dev_list)
881d966b
EB
1553#define for_each_netdev_safe(net, d, n) \
1554 list_for_each_entry_safe(d, n, &(net)->dev_base_head, dev_list)
1555#define for_each_netdev_continue(net, d) \
1556 list_for_each_entry_continue(d, &(net)->dev_base_head, dev_list)
254245d2 1557#define for_each_netdev_continue_rcu(net, d) \
1558 list_for_each_entry_continue_rcu(d, &(net)->dev_base_head, dev_list)
881d966b 1559#define net_device_entry(lh) list_entry(lh, struct net_device, dev_list)
7562f876 1560
a050c33f
DL
1561static inline struct net_device *next_net_device(struct net_device *dev)
1562{
1563 struct list_head *lh;
1564 struct net *net;
1565
c346dca1 1566 net = dev_net(dev);
a050c33f
DL
1567 lh = dev->dev_list.next;
1568 return lh == &net->dev_base_head ? NULL : net_device_entry(lh);
1569}
1570
ce81b76a
ED
1571static inline struct net_device *next_net_device_rcu(struct net_device *dev)
1572{
1573 struct list_head *lh;
1574 struct net *net;
1575
1576 net = dev_net(dev);
ccf43438 1577 lh = rcu_dereference(list_next_rcu(&dev->dev_list));
ce81b76a
ED
1578 return lh == &net->dev_base_head ? NULL : net_device_entry(lh);
1579}
1580
a050c33f
DL
1581static inline struct net_device *first_net_device(struct net *net)
1582{
1583 return list_empty(&net->dev_base_head) ? NULL :
1584 net_device_entry(net->dev_base_head.next);
1585}
7562f876 1586
ccf43438
ED
1587static inline struct net_device *first_net_device_rcu(struct net *net)
1588{
1589 struct list_head *lh = rcu_dereference(list_next_rcu(&net->dev_base_head));
1590
1591 return lh == &net->dev_base_head ? NULL : net_device_entry(lh);
1592}
1593
1da177e4
LT
1594extern int netdev_boot_setup_check(struct net_device *dev);
1595extern unsigned long netdev_boot_base(const char *prefix, int unit);
941666c2
ED
1596extern struct net_device *dev_getbyhwaddr_rcu(struct net *net, unsigned short type,
1597 const char *hwaddr);
881d966b
EB
1598extern struct net_device *dev_getfirstbyhwtype(struct net *net, unsigned short type);
1599extern struct net_device *__dev_getfirstbyhwtype(struct net *net, unsigned short type);
1da177e4
LT
1600extern void dev_add_pack(struct packet_type *pt);
1601extern void dev_remove_pack(struct packet_type *pt);
1602extern void __dev_remove_pack(struct packet_type *pt);
1603
bb69ae04
ED
1604extern struct net_device *dev_get_by_flags_rcu(struct net *net, unsigned short flags,
1605 unsigned short mask);
881d966b 1606extern struct net_device *dev_get_by_name(struct net *net, const char *name);
72c9528b 1607extern struct net_device *dev_get_by_name_rcu(struct net *net, const char *name);
881d966b 1608extern struct net_device *__dev_get_by_name(struct net *net, const char *name);
1da177e4
LT
1609extern int dev_alloc_name(struct net_device *dev, const char *name);
1610extern int dev_open(struct net_device *dev);
1611extern int dev_close(struct net_device *dev);
0187bdfb 1612extern void dev_disable_lro(struct net_device *dev);
1da177e4
LT
1613extern int dev_queue_xmit(struct sk_buff *skb);
1614extern int register_netdevice(struct net_device *dev);
44a0873d
ED
1615extern void unregister_netdevice_queue(struct net_device *dev,
1616 struct list_head *head);
9b5e383c 1617extern void unregister_netdevice_many(struct list_head *head);
44a0873d
ED
1618static inline void unregister_netdevice(struct net_device *dev)
1619{
1620 unregister_netdevice_queue(dev, NULL);
1621}
1622
29b4433d 1623extern int netdev_refcnt_read(const struct net_device *dev);
1da177e4
LT
1624extern void free_netdev(struct net_device *dev);
1625extern void synchronize_net(void);
937f1ba5 1626extern int init_dummy_netdev(struct net_device *dev);
9d40bbda 1627extern void netdev_resync_ops(struct net_device *dev);
937f1ba5 1628
881d966b
EB
1629extern struct net_device *dev_get_by_index(struct net *net, int ifindex);
1630extern struct net_device *__dev_get_by_index(struct net *net, int ifindex);
fb699dfd 1631extern struct net_device *dev_get_by_index_rcu(struct net *net, int ifindex);
1da177e4
LT
1632extern int dev_restart(struct net_device *dev);
1633#ifdef CONFIG_NETPOLL_TRAP
1634extern int netpoll_trap(void);
1635#endif
86911732
HX
1636extern int skb_gro_receive(struct sk_buff **head,
1637 struct sk_buff *skb);
78a478d0 1638extern void skb_gro_reset_offset(struct sk_buff *skb);
86911732
HX
1639
1640static inline unsigned int skb_gro_offset(const struct sk_buff *skb)
1641{
1642 return NAPI_GRO_CB(skb)->data_offset;
1643}
1644
1645static inline unsigned int skb_gro_len(const struct sk_buff *skb)
1646{
1647 return skb->len - NAPI_GRO_CB(skb)->data_offset;
1648}
1649
1650static inline void skb_gro_pull(struct sk_buff *skb, unsigned int len)
1651{
1652 NAPI_GRO_CB(skb)->data_offset += len;
1653}
1654
a5b1cf28
HX
1655static inline void *skb_gro_header_fast(struct sk_buff *skb,
1656 unsigned int offset)
86911732 1657{
a5b1cf28
HX
1658 return NAPI_GRO_CB(skb)->frag0 + offset;
1659}
78a478d0 1660
a5b1cf28
HX
1661static inline int skb_gro_header_hard(struct sk_buff *skb, unsigned int hlen)
1662{
1663 return NAPI_GRO_CB(skb)->frag0_len < hlen;
1664}
78a478d0 1665
a5b1cf28
HX
1666static inline void *skb_gro_header_slow(struct sk_buff *skb, unsigned int hlen,
1667 unsigned int offset)
1668{
17dd759c
HX
1669 if (!pskb_may_pull(skb, hlen))
1670 return NULL;
1671
a5b1cf28
HX
1672 NAPI_GRO_CB(skb)->frag0 = NULL;
1673 NAPI_GRO_CB(skb)->frag0_len = 0;
17dd759c 1674 return skb->data + offset;
86911732 1675}
1da177e4 1676
aa4b9f53
HX
1677static inline void *skb_gro_mac_header(struct sk_buff *skb)
1678{
78d3fd0b 1679 return NAPI_GRO_CB(skb)->frag0 ?: skb_mac_header(skb);
aa4b9f53
HX
1680}
1681
36e7b1b8
HX
1682static inline void *skb_gro_network_header(struct sk_buff *skb)
1683{
78d3fd0b
HX
1684 return (NAPI_GRO_CB(skb)->frag0 ?: skb->data) +
1685 skb_network_offset(skb);
36e7b1b8
HX
1686}
1687
0c4e8581
SH
1688static inline int dev_hard_header(struct sk_buff *skb, struct net_device *dev,
1689 unsigned short type,
3b04ddde
SH
1690 const void *daddr, const void *saddr,
1691 unsigned len)
0c4e8581 1692{
f1ecfd5d 1693 if (!dev->header_ops || !dev->header_ops->create)
0c4e8581 1694 return 0;
3b04ddde
SH
1695
1696 return dev->header_ops->create(skb, dev, type, daddr, saddr, len);
0c4e8581
SH
1697}
1698
b95cce35
SH
1699static inline int dev_parse_header(const struct sk_buff *skb,
1700 unsigned char *haddr)
1701{
1702 const struct net_device *dev = skb->dev;
1703
1b83336b 1704 if (!dev->header_ops || !dev->header_ops->parse)
b95cce35 1705 return 0;
3b04ddde 1706 return dev->header_ops->parse(skb, haddr);
b95cce35
SH
1707}
1708
1da177e4
LT
1709typedef int gifconf_func_t(struct net_device * dev, char __user * bufptr, int len);
1710extern int register_gifconf(unsigned int family, gifconf_func_t * gifconf);
1711static inline int unregister_gifconf(unsigned int family)
1712{
1713 return register_gifconf(family, NULL);
1714}
1715
1716/*
88751275 1717 * Incoming packets are placed on per-cpu queues
1da177e4 1718 */
d94d9fee 1719struct softnet_data {
37437bb2 1720 struct Qdisc *output_queue;
a9cbd588 1721 struct Qdisc **output_queue_tailp;
1da177e4 1722 struct list_head poll_list;
1da177e4 1723 struct sk_buff *completion_queue;
6e7676c1 1724 struct sk_buff_head process_queue;
1da177e4 1725
dee42870 1726 /* stats */
cd7b5396
DM
1727 unsigned int processed;
1728 unsigned int time_squeeze;
1729 unsigned int cpu_collision;
1730 unsigned int received_rps;
dee42870 1731
fd793d89 1732#ifdef CONFIG_RPS
88751275
ED
1733 struct softnet_data *rps_ipi_list;
1734
1735 /* Elements below can be accessed between CPUs for RPS */
0a9627f2 1736 struct call_single_data csd ____cacheline_aligned_in_smp;
88751275
ED
1737 struct softnet_data *rps_ipi_next;
1738 unsigned int cpu;
fec5e652 1739 unsigned int input_queue_head;
76cc8b13 1740 unsigned int input_queue_tail;
1e94d72f 1741#endif
dee42870 1742 unsigned dropped;
0a9627f2 1743 struct sk_buff_head input_pkt_queue;
bea3348e 1744 struct napi_struct backlog;
1da177e4
LT
1745};
1746
76cc8b13 1747static inline void input_queue_head_incr(struct softnet_data *sd)
fec5e652
TH
1748{
1749#ifdef CONFIG_RPS
76cc8b13
TH
1750 sd->input_queue_head++;
1751#endif
1752}
1753
1754static inline void input_queue_tail_incr_save(struct softnet_data *sd,
1755 unsigned int *qtail)
1756{
1757#ifdef CONFIG_RPS
1758 *qtail = ++sd->input_queue_tail;
fec5e652
TH
1759#endif
1760}
1761
0a9627f2 1762DECLARE_PER_CPU_ALIGNED(struct softnet_data, softnet_data);
1da177e4 1763
37437bb2 1764extern void __netif_schedule(struct Qdisc *q);
1da177e4 1765
86d804e1 1766static inline void netif_schedule_queue(struct netdev_queue *txq)
1da177e4 1767{
73466498 1768 if (!(txq->state & QUEUE_STATE_ANY_XOFF))
37437bb2 1769 __netif_schedule(txq->qdisc);
86d804e1
DM
1770}
1771
fd2ea0a7
DM
1772static inline void netif_tx_schedule_all(struct net_device *dev)
1773{
1774 unsigned int i;
1775
1776 for (i = 0; i < dev->num_tx_queues; i++)
1777 netif_schedule_queue(netdev_get_tx_queue(dev, i));
1778}
1779
d29f749e
DJ
1780static inline void netif_tx_start_queue(struct netdev_queue *dev_queue)
1781{
73466498 1782 clear_bit(__QUEUE_STATE_DRV_XOFF, &dev_queue->state);
d29f749e
DJ
1783}
1784
bea3348e
SH
1785/**
1786 * netif_start_queue - allow transmit
1787 * @dev: network device
1788 *
1789 * Allow upper layers to call the device hard_start_xmit routine.
1790 */
1da177e4
LT
1791static inline void netif_start_queue(struct net_device *dev)
1792{
e8a0464c 1793 netif_tx_start_queue(netdev_get_tx_queue(dev, 0));
1da177e4
LT
1794}
1795
fd2ea0a7
DM
1796static inline void netif_tx_start_all_queues(struct net_device *dev)
1797{
1798 unsigned int i;
1799
1800 for (i = 0; i < dev->num_tx_queues; i++) {
1801 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
1802 netif_tx_start_queue(txq);
1803 }
1804}
1805
79d16385 1806static inline void netif_tx_wake_queue(struct netdev_queue *dev_queue)
1da177e4
LT
1807{
1808#ifdef CONFIG_NETPOLL_TRAP
5f286e11 1809 if (netpoll_trap()) {
7b3d3e4f 1810 netif_tx_start_queue(dev_queue);
1da177e4 1811 return;
5f286e11 1812 }
1da177e4 1813#endif
73466498 1814 if (test_and_clear_bit(__QUEUE_STATE_DRV_XOFF, &dev_queue->state))
37437bb2 1815 __netif_schedule(dev_queue->qdisc);
79d16385
DM
1816}
1817
d29f749e
DJ
1818/**
1819 * netif_wake_queue - restart transmit
1820 * @dev: network device
1821 *
1822 * Allow upper layers to call the device hard_start_xmit routine.
1823 * Used for flow control when transmit resources are available.
1824 */
79d16385
DM
1825static inline void netif_wake_queue(struct net_device *dev)
1826{
e8a0464c 1827 netif_tx_wake_queue(netdev_get_tx_queue(dev, 0));
1da177e4
LT
1828}
1829
fd2ea0a7
DM
1830static inline void netif_tx_wake_all_queues(struct net_device *dev)
1831{
1832 unsigned int i;
1833
1834 for (i = 0; i < dev->num_tx_queues; i++) {
1835 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
1836 netif_tx_wake_queue(txq);
1837 }
1838}
1839
d29f749e
DJ
1840static inline void netif_tx_stop_queue(struct netdev_queue *dev_queue)
1841{
18543a64 1842 if (WARN_ON(!dev_queue)) {
256ee435 1843 pr_info("netif_stop_queue() cannot be called before register_netdev()\n");
18543a64
GC
1844 return;
1845 }
73466498 1846 set_bit(__QUEUE_STATE_DRV_XOFF, &dev_queue->state);
d29f749e
DJ
1847}
1848
bea3348e
SH
1849/**
1850 * netif_stop_queue - stop transmitted packets
1851 * @dev: network device
1852 *
1853 * Stop upper layers calling the device hard_start_xmit routine.
1854 * Used for flow control when transmit resources are unavailable.
1855 */
1da177e4
LT
1856static inline void netif_stop_queue(struct net_device *dev)
1857{
e8a0464c 1858 netif_tx_stop_queue(netdev_get_tx_queue(dev, 0));
1da177e4
LT
1859}
1860
fd2ea0a7
DM
1861static inline void netif_tx_stop_all_queues(struct net_device *dev)
1862{
1863 unsigned int i;
1864
1865 for (i = 0; i < dev->num_tx_queues; i++) {
1866 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
1867 netif_tx_stop_queue(txq);
1868 }
1869}
1870
4d29515f 1871static inline bool netif_tx_queue_stopped(const struct netdev_queue *dev_queue)
d29f749e 1872{
73466498 1873 return test_bit(__QUEUE_STATE_DRV_XOFF, &dev_queue->state);
d29f749e
DJ
1874}
1875
bea3348e
SH
1876/**
1877 * netif_queue_stopped - test if transmit queue is flowblocked
1878 * @dev: network device
1879 *
1880 * Test if transmit queue on device is currently unable to send.
1881 */
4d29515f 1882static inline bool netif_queue_stopped(const struct net_device *dev)
1da177e4 1883{
e8a0464c 1884 return netif_tx_queue_stopped(netdev_get_tx_queue(dev, 0));
1da177e4
LT
1885}
1886
4d29515f 1887static inline bool netif_xmit_stopped(const struct netdev_queue *dev_queue)
c3f26a26 1888{
73466498
TH
1889 return dev_queue->state & QUEUE_STATE_ANY_XOFF;
1890}
1891
4d29515f 1892static inline bool netif_xmit_frozen_or_stopped(const struct netdev_queue *dev_queue)
73466498
TH
1893{
1894 return dev_queue->state & QUEUE_STATE_ANY_XOFF_OR_FROZEN;
1895}
1896
c5d67bd7
TH
1897static inline void netdev_tx_sent_queue(struct netdev_queue *dev_queue,
1898 unsigned int bytes)
1899{
114cf580
TH
1900#ifdef CONFIG_BQL
1901 dql_queued(&dev_queue->dql, bytes);
1902 if (unlikely(dql_avail(&dev_queue->dql) < 0)) {
1903 set_bit(__QUEUE_STATE_STACK_XOFF, &dev_queue->state);
1904 if (unlikely(dql_avail(&dev_queue->dql) >= 0))
1905 clear_bit(__QUEUE_STATE_STACK_XOFF,
1906 &dev_queue->state);
1907 }
1908#endif
c5d67bd7
TH
1909}
1910
1911static inline void netdev_sent_queue(struct net_device *dev, unsigned int bytes)
1912{
1913 netdev_tx_sent_queue(netdev_get_tx_queue(dev, 0), bytes);
1914}
1915
1916static inline void netdev_tx_completed_queue(struct netdev_queue *dev_queue,
1917 unsigned pkts, unsigned bytes)
1918{
114cf580
TH
1919#ifdef CONFIG_BQL
1920 if (likely(bytes)) {
1921 dql_completed(&dev_queue->dql, bytes);
1922 if (unlikely(test_bit(__QUEUE_STATE_STACK_XOFF,
1923 &dev_queue->state) &&
1924 dql_avail(&dev_queue->dql) >= 0)) {
1925 if (test_and_clear_bit(__QUEUE_STATE_STACK_XOFF,
1926 &dev_queue->state))
1927 netif_schedule_queue(dev_queue);
1928 }
1929 }
1930#endif
c5d67bd7
TH
1931}
1932
1933static inline void netdev_completed_queue(struct net_device *dev,
1934 unsigned pkts, unsigned bytes)
1935{
1936 netdev_tx_completed_queue(netdev_get_tx_queue(dev, 0), pkts, bytes);
1937}
1938
1939static inline void netdev_tx_reset_queue(struct netdev_queue *q)
1940{
114cf580 1941#ifdef CONFIG_BQL
5c490354 1942 clear_bit(__QUEUE_STATE_STACK_XOFF, &q->state);
114cf580
TH
1943 dql_reset(&q->dql);
1944#endif
c5d67bd7
TH
1945}
1946
1947static inline void netdev_reset_queue(struct net_device *dev_queue)
1948{
1949 netdev_tx_reset_queue(netdev_get_tx_queue(dev_queue, 0));
c3f26a26
DM
1950}
1951
bea3348e
SH
1952/**
1953 * netif_running - test if up
1954 * @dev: network device
1955 *
1956 * Test if the device has been brought up.
1957 */
4d29515f 1958static inline bool netif_running(const struct net_device *dev)
1da177e4
LT
1959{
1960 return test_bit(__LINK_STATE_START, &dev->state);
1961}
1962
f25f4e44
PWJ
1963/*
1964 * Routines to manage the subqueues on a device. We only need start
1965 * stop, and a check if it's stopped. All other device management is
1966 * done at the overall netdevice level.
1967 * Also test the device if we're multiqueue.
1968 */
bea3348e
SH
1969
1970/**
1971 * netif_start_subqueue - allow sending packets on subqueue
1972 * @dev: network device
1973 * @queue_index: sub queue index
1974 *
1975 * Start individual transmit queue of a device with multiple transmit queues.
1976 */
f25f4e44
PWJ
1977static inline void netif_start_subqueue(struct net_device *dev, u16 queue_index)
1978{
fd2ea0a7 1979 struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index);
7b3d3e4f
KK
1980
1981 netif_tx_start_queue(txq);
f25f4e44
PWJ
1982}
1983
bea3348e
SH
1984/**
1985 * netif_stop_subqueue - stop sending packets on subqueue
1986 * @dev: network device
1987 * @queue_index: sub queue index
1988 *
1989 * Stop individual transmit queue of a device with multiple transmit queues.
1990 */
f25f4e44
PWJ
1991static inline void netif_stop_subqueue(struct net_device *dev, u16 queue_index)
1992{
fd2ea0a7 1993 struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index);
f25f4e44
PWJ
1994#ifdef CONFIG_NETPOLL_TRAP
1995 if (netpoll_trap())
1996 return;
1997#endif
7b3d3e4f 1998 netif_tx_stop_queue(txq);
f25f4e44
PWJ
1999}
2000
bea3348e
SH
2001/**
2002 * netif_subqueue_stopped - test status of subqueue
2003 * @dev: network device
2004 * @queue_index: sub queue index
2005 *
2006 * Check individual transmit queue of a device with multiple transmit queues.
2007 */
4d29515f
DM
2008static inline bool __netif_subqueue_stopped(const struct net_device *dev,
2009 u16 queue_index)
f25f4e44 2010{
fd2ea0a7 2011 struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index);
7b3d3e4f
KK
2012
2013 return netif_tx_queue_stopped(txq);
f25f4e44
PWJ
2014}
2015
4d29515f
DM
2016static inline bool netif_subqueue_stopped(const struct net_device *dev,
2017 struct sk_buff *skb)
668f895a
PE
2018{
2019 return __netif_subqueue_stopped(dev, skb_get_queue_mapping(skb));
2020}
bea3348e
SH
2021
2022/**
2023 * netif_wake_subqueue - allow sending packets on subqueue
2024 * @dev: network device
2025 * @queue_index: sub queue index
2026 *
2027 * Resume individual transmit queue of a device with multiple transmit queues.
2028 */
f25f4e44
PWJ
2029static inline void netif_wake_subqueue(struct net_device *dev, u16 queue_index)
2030{
fd2ea0a7 2031 struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index);
f25f4e44
PWJ
2032#ifdef CONFIG_NETPOLL_TRAP
2033 if (netpoll_trap())
2034 return;
2035#endif
73466498 2036 if (test_and_clear_bit(__QUEUE_STATE_DRV_XOFF, &txq->state))
37437bb2 2037 __netif_schedule(txq->qdisc);
f25f4e44
PWJ
2038}
2039
a3d22a68
VZ
2040/*
2041 * Returns a Tx hash for the given packet when dev->real_num_tx_queues is used
2042 * as a distribution range limit for the returned value.
2043 */
2044static inline u16 skb_tx_hash(const struct net_device *dev,
2045 const struct sk_buff *skb)
2046{
2047 return __skb_tx_hash(dev, skb, dev->real_num_tx_queues);
2048}
2049
bea3348e
SH
2050/**
2051 * netif_is_multiqueue - test if device has multiple transmit queues
2052 * @dev: network device
2053 *
2054 * Check if device has multiple transmit queues
bea3348e 2055 */
4d29515f 2056static inline bool netif_is_multiqueue(const struct net_device *dev)
f25f4e44 2057{
a02cec21 2058 return dev->num_tx_queues > 1;
f25f4e44 2059}
1da177e4 2060
e6484930
TH
2061extern int netif_set_real_num_tx_queues(struct net_device *dev,
2062 unsigned int txq);
f0796d5c 2063
62fe0b40
BH
2064#ifdef CONFIG_RPS
2065extern int netif_set_real_num_rx_queues(struct net_device *dev,
2066 unsigned int rxq);
2067#else
2068static inline int netif_set_real_num_rx_queues(struct net_device *dev,
2069 unsigned int rxq)
2070{
2071 return 0;
2072}
2073#endif
2074
3171d026
BH
2075static inline int netif_copy_real_num_queues(struct net_device *to_dev,
2076 const struct net_device *from_dev)
2077{
2078 netif_set_real_num_tx_queues(to_dev, from_dev->real_num_tx_queues);
2079#ifdef CONFIG_RPS
2080 return netif_set_real_num_rx_queues(to_dev,
2081 from_dev->real_num_rx_queues);
2082#else
2083 return 0;
2084#endif
2085}
2086
1da177e4 2087/* Use this variant when it is known for sure that it
0ef47309
ML
2088 * is executing from hardware interrupt context or with hardware interrupts
2089 * disabled.
1da177e4 2090 */
bea3348e 2091extern void dev_kfree_skb_irq(struct sk_buff *skb);
1da177e4
LT
2092
2093/* Use this variant in places where it could be invoked
0ef47309
ML
2094 * from either hardware interrupt or other context, with hardware interrupts
2095 * either disabled or enabled.
1da177e4 2096 */
56079431 2097extern void dev_kfree_skb_any(struct sk_buff *skb);
1da177e4 2098
1da177e4
LT
2099extern int netif_rx(struct sk_buff *skb);
2100extern int netif_rx_ni(struct sk_buff *skb);
1da177e4 2101extern int netif_receive_skb(struct sk_buff *skb);
5b252f0c 2102extern gro_result_t dev_gro_receive(struct napi_struct *napi,
96e93eab 2103 struct sk_buff *skb);
c7c4b3b6
BH
2104extern gro_result_t napi_skb_finish(gro_result_t ret, struct sk_buff *skb);
2105extern gro_result_t napi_gro_receive(struct napi_struct *napi,
d565b0a1 2106 struct sk_buff *skb);
86cac58b 2107extern void napi_gro_flush(struct napi_struct *napi);
76620aaf 2108extern struct sk_buff * napi_get_frags(struct napi_struct *napi);
c7c4b3b6 2109extern gro_result_t napi_frags_finish(struct napi_struct *napi,
5b252f0c
BH
2110 struct sk_buff *skb,
2111 gro_result_t ret);
76620aaf 2112extern struct sk_buff * napi_frags_skb(struct napi_struct *napi);
c7c4b3b6 2113extern gro_result_t napi_gro_frags(struct napi_struct *napi);
76620aaf
HX
2114
2115static inline void napi_free_frags(struct napi_struct *napi)
2116{
2117 kfree_skb(napi->skb);
2118 napi->skb = NULL;
2119}
2120
ab95bfe0 2121extern int netdev_rx_handler_register(struct net_device *dev,
93e2c32b
JP
2122 rx_handler_func_t *rx_handler,
2123 void *rx_handler_data);
ab95bfe0
JP
2124extern void netdev_rx_handler_unregister(struct net_device *dev);
2125
95f050bf 2126extern bool dev_valid_name(const char *name);
881d966b
EB
2127extern int dev_ioctl(struct net *net, unsigned int cmd, void __user *);
2128extern int dev_ethtool(struct net *net, struct ifreq *);
1da177e4 2129extern unsigned dev_get_flags(const struct net_device *);
bd380811 2130extern int __dev_change_flags(struct net_device *, unsigned int flags);
1da177e4 2131extern int dev_change_flags(struct net_device *, unsigned);
bd380811 2132extern void __dev_notify_flags(struct net_device *, unsigned int old_flags);
cf04a4c7 2133extern int dev_change_name(struct net_device *, const char *);
0b815a1a 2134extern int dev_set_alias(struct net_device *, const char *, size_t);
ce286d32
EB
2135extern int dev_change_net_namespace(struct net_device *,
2136 struct net *, const char *);
1da177e4 2137extern int dev_set_mtu(struct net_device *, int);
cbda10fa 2138extern void dev_set_group(struct net_device *, int);
1da177e4
LT
2139extern int dev_set_mac_address(struct net_device *,
2140 struct sockaddr *);
f6a78bfc 2141extern int dev_hard_start_xmit(struct sk_buff *skb,
fd2ea0a7
DM
2142 struct net_device *dev,
2143 struct netdev_queue *txq);
44540960
AB
2144extern int dev_forward_skb(struct net_device *dev,
2145 struct sk_buff *skb);
1da177e4 2146
20380731 2147extern int netdev_budget;
1da177e4
LT
2148
2149/* Called by rtnetlink.c:rtnl_unlock() */
2150extern void netdev_run_todo(void);
2151
bea3348e
SH
2152/**
2153 * dev_put - release reference to device
2154 * @dev: network device
2155 *
9ef4429b 2156 * Release reference to device to allow it to be freed.
bea3348e 2157 */
1da177e4
LT
2158static inline void dev_put(struct net_device *dev)
2159{
933393f5 2160 this_cpu_dec(*dev->pcpu_refcnt);
1da177e4
LT
2161}
2162
bea3348e
SH
2163/**
2164 * dev_hold - get reference to device
2165 * @dev: network device
2166 *
9ef4429b 2167 * Hold reference to device to keep it from being freed.
bea3348e 2168 */
15333061
SH
2169static inline void dev_hold(struct net_device *dev)
2170{
933393f5 2171 this_cpu_inc(*dev->pcpu_refcnt);
15333061 2172}
1da177e4
LT
2173
2174/* Carrier loss detection, dial on demand. The functions netif_carrier_on
2175 * and _off may be called from IRQ context, but it is caller
2176 * who is responsible for serialization of these calls.
b00055aa
SR
2177 *
2178 * The name carrier is inappropriate, these functions should really be
2179 * called netif_lowerlayer_*() because they represent the state of any
2180 * kind of lower layer not just hardware media.
1da177e4
LT
2181 */
2182
2183extern void linkwatch_fire_event(struct net_device *dev);
e014debe 2184extern void linkwatch_forget_dev(struct net_device *dev);
1da177e4 2185
bea3348e
SH
2186/**
2187 * netif_carrier_ok - test if carrier present
2188 * @dev: network device
2189 *
2190 * Check if carrier is present on device
2191 */
4d29515f 2192static inline bool netif_carrier_ok(const struct net_device *dev)
1da177e4
LT
2193{
2194 return !test_bit(__LINK_STATE_NOCARRIER, &dev->state);
2195}
2196
9d21493b
ED
2197extern unsigned long dev_trans_start(struct net_device *dev);
2198
1da177e4
LT
2199extern void __netdev_watchdog_up(struct net_device *dev);
2200
0a242efc 2201extern void netif_carrier_on(struct net_device *dev);
1da177e4 2202
0a242efc 2203extern void netif_carrier_off(struct net_device *dev);
1da177e4 2204
06c4648d
IC
2205extern void netif_notify_peers(struct net_device *dev);
2206
bea3348e
SH
2207/**
2208 * netif_dormant_on - mark device as dormant.
2209 * @dev: network device
2210 *
2211 * Mark device as dormant (as per RFC2863).
2212 *
2213 * The dormant state indicates that the relevant interface is not
2214 * actually in a condition to pass packets (i.e., it is not 'up') but is
2215 * in a "pending" state, waiting for some external event. For "on-
2216 * demand" interfaces, this new state identifies the situation where the
2217 * interface is waiting for events to place it in the up state.
2218 *
2219 */
b00055aa
SR
2220static inline void netif_dormant_on(struct net_device *dev)
2221{
2222 if (!test_and_set_bit(__LINK_STATE_DORMANT, &dev->state))
2223 linkwatch_fire_event(dev);
2224}
2225
bea3348e
SH
2226/**
2227 * netif_dormant_off - set device as not dormant.
2228 * @dev: network device
2229 *
2230 * Device is not in dormant state.
2231 */
b00055aa
SR
2232static inline void netif_dormant_off(struct net_device *dev)
2233{
2234 if (test_and_clear_bit(__LINK_STATE_DORMANT, &dev->state))
2235 linkwatch_fire_event(dev);
2236}
2237
bea3348e
SH
2238/**
2239 * netif_dormant - test if carrier present
2240 * @dev: network device
2241 *
2242 * Check if carrier is present on device
2243 */
4d29515f 2244static inline bool netif_dormant(const struct net_device *dev)
b00055aa
SR
2245{
2246 return test_bit(__LINK_STATE_DORMANT, &dev->state);
2247}
2248
2249
bea3348e
SH
2250/**
2251 * netif_oper_up - test if device is operational
2252 * @dev: network device
2253 *
2254 * Check if carrier is operational
2255 */
4d29515f 2256static inline bool netif_oper_up(const struct net_device *dev)
d94d9fee 2257{
b00055aa
SR
2258 return (dev->operstate == IF_OPER_UP ||
2259 dev->operstate == IF_OPER_UNKNOWN /* backward compat */);
2260}
2261
bea3348e
SH
2262/**
2263 * netif_device_present - is device available or removed
2264 * @dev: network device
2265 *
2266 * Check if device has not been removed from system.
2267 */
4d29515f 2268static inline bool netif_device_present(struct net_device *dev)
1da177e4
LT
2269{
2270 return test_bit(__LINK_STATE_PRESENT, &dev->state);
2271}
2272
56079431 2273extern void netif_device_detach(struct net_device *dev);
1da177e4 2274
56079431 2275extern void netif_device_attach(struct net_device *dev);
1da177e4
LT
2276
2277/*
2278 * Network interface message level settings
2279 */
1da177e4
LT
2280
2281enum {
2282 NETIF_MSG_DRV = 0x0001,
2283 NETIF_MSG_PROBE = 0x0002,
2284 NETIF_MSG_LINK = 0x0004,
2285 NETIF_MSG_TIMER = 0x0008,
2286 NETIF_MSG_IFDOWN = 0x0010,
2287 NETIF_MSG_IFUP = 0x0020,
2288 NETIF_MSG_RX_ERR = 0x0040,
2289 NETIF_MSG_TX_ERR = 0x0080,
2290 NETIF_MSG_TX_QUEUED = 0x0100,
2291 NETIF_MSG_INTR = 0x0200,
2292 NETIF_MSG_TX_DONE = 0x0400,
2293 NETIF_MSG_RX_STATUS = 0x0800,
2294 NETIF_MSG_PKTDATA = 0x1000,
2295 NETIF_MSG_HW = 0x2000,
2296 NETIF_MSG_WOL = 0x4000,
2297};
2298
2299#define netif_msg_drv(p) ((p)->msg_enable & NETIF_MSG_DRV)
2300#define netif_msg_probe(p) ((p)->msg_enable & NETIF_MSG_PROBE)
2301#define netif_msg_link(p) ((p)->msg_enable & NETIF_MSG_LINK)
2302#define netif_msg_timer(p) ((p)->msg_enable & NETIF_MSG_TIMER)
2303#define netif_msg_ifdown(p) ((p)->msg_enable & NETIF_MSG_IFDOWN)
2304#define netif_msg_ifup(p) ((p)->msg_enable & NETIF_MSG_IFUP)
2305#define netif_msg_rx_err(p) ((p)->msg_enable & NETIF_MSG_RX_ERR)
2306#define netif_msg_tx_err(p) ((p)->msg_enable & NETIF_MSG_TX_ERR)
2307#define netif_msg_tx_queued(p) ((p)->msg_enable & NETIF_MSG_TX_QUEUED)
2308#define netif_msg_intr(p) ((p)->msg_enable & NETIF_MSG_INTR)
2309#define netif_msg_tx_done(p) ((p)->msg_enable & NETIF_MSG_TX_DONE)
2310#define netif_msg_rx_status(p) ((p)->msg_enable & NETIF_MSG_RX_STATUS)
2311#define netif_msg_pktdata(p) ((p)->msg_enable & NETIF_MSG_PKTDATA)
2312#define netif_msg_hw(p) ((p)->msg_enable & NETIF_MSG_HW)
2313#define netif_msg_wol(p) ((p)->msg_enable & NETIF_MSG_WOL)
2314
2315static inline u32 netif_msg_init(int debug_value, int default_msg_enable_bits)
2316{
2317 /* use default */
2318 if (debug_value < 0 || debug_value >= (sizeof(u32) * 8))
2319 return default_msg_enable_bits;
2320 if (debug_value == 0) /* no output */
2321 return 0;
2322 /* set low N bits */
2323 return (1 << debug_value) - 1;
2324}
2325
c773e847 2326static inline void __netif_tx_lock(struct netdev_queue *txq, int cpu)
932ff279 2327{
c773e847
DM
2328 spin_lock(&txq->_xmit_lock);
2329 txq->xmit_lock_owner = cpu;
22dd7495
JHS
2330}
2331
fd2ea0a7
DM
2332static inline void __netif_tx_lock_bh(struct netdev_queue *txq)
2333{
2334 spin_lock_bh(&txq->_xmit_lock);
2335 txq->xmit_lock_owner = smp_processor_id();
2336}
2337
4d29515f 2338static inline bool __netif_tx_trylock(struct netdev_queue *txq)
c3f26a26 2339{
4d29515f 2340 bool ok = spin_trylock(&txq->_xmit_lock);
c3f26a26
DM
2341 if (likely(ok))
2342 txq->xmit_lock_owner = smp_processor_id();
2343 return ok;
2344}
2345
2346static inline void __netif_tx_unlock(struct netdev_queue *txq)
2347{
2348 txq->xmit_lock_owner = -1;
2349 spin_unlock(&txq->_xmit_lock);
2350}
2351
2352static inline void __netif_tx_unlock_bh(struct netdev_queue *txq)
2353{
2354 txq->xmit_lock_owner = -1;
2355 spin_unlock_bh(&txq->_xmit_lock);
2356}
2357
08baf561
ED
2358static inline void txq_trans_update(struct netdev_queue *txq)
2359{
2360 if (txq->xmit_lock_owner != -1)
2361 txq->trans_start = jiffies;
2362}
2363
d29f749e
DJ
2364/**
2365 * netif_tx_lock - grab network device transmit lock
2366 * @dev: network device
d29f749e
DJ
2367 *
2368 * Get network device transmit lock
2369 */
22dd7495
JHS
2370static inline void netif_tx_lock(struct net_device *dev)
2371{
e8a0464c 2372 unsigned int i;
c3f26a26 2373 int cpu;
c773e847 2374
c3f26a26
DM
2375 spin_lock(&dev->tx_global_lock);
2376 cpu = smp_processor_id();
e8a0464c
DM
2377 for (i = 0; i < dev->num_tx_queues; i++) {
2378 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
c3f26a26
DM
2379
2380 /* We are the only thread of execution doing a
2381 * freeze, but we have to grab the _xmit_lock in
2382 * order to synchronize with threads which are in
2383 * the ->hard_start_xmit() handler and already
2384 * checked the frozen bit.
2385 */
e8a0464c 2386 __netif_tx_lock(txq, cpu);
c3f26a26
DM
2387 set_bit(__QUEUE_STATE_FROZEN, &txq->state);
2388 __netif_tx_unlock(txq);
e8a0464c 2389 }
932ff279
HX
2390}
2391
2392static inline void netif_tx_lock_bh(struct net_device *dev)
2393{
e8a0464c
DM
2394 local_bh_disable();
2395 netif_tx_lock(dev);
932ff279
HX
2396}
2397
932ff279
HX
2398static inline void netif_tx_unlock(struct net_device *dev)
2399{
e8a0464c
DM
2400 unsigned int i;
2401
2402 for (i = 0; i < dev->num_tx_queues; i++) {
2403 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
c773e847 2404
c3f26a26
DM
2405 /* No need to grab the _xmit_lock here. If the
2406 * queue is not stopped for another reason, we
2407 * force a schedule.
2408 */
2409 clear_bit(__QUEUE_STATE_FROZEN, &txq->state);
7b3d3e4f 2410 netif_schedule_queue(txq);
c3f26a26
DM
2411 }
2412 spin_unlock(&dev->tx_global_lock);
932ff279
HX
2413}
2414
2415static inline void netif_tx_unlock_bh(struct net_device *dev)
2416{
e8a0464c
DM
2417 netif_tx_unlock(dev);
2418 local_bh_enable();
932ff279
HX
2419}
2420
c773e847 2421#define HARD_TX_LOCK(dev, txq, cpu) { \
22dd7495 2422 if ((dev->features & NETIF_F_LLTX) == 0) { \
c773e847 2423 __netif_tx_lock(txq, cpu); \
22dd7495
JHS
2424 } \
2425}
2426
c773e847 2427#define HARD_TX_UNLOCK(dev, txq) { \
22dd7495 2428 if ((dev->features & NETIF_F_LLTX) == 0) { \
c773e847 2429 __netif_tx_unlock(txq); \
22dd7495
JHS
2430 } \
2431}
2432
1da177e4
LT
2433static inline void netif_tx_disable(struct net_device *dev)
2434{
fd2ea0a7 2435 unsigned int i;
c3f26a26 2436 int cpu;
fd2ea0a7 2437
c3f26a26
DM
2438 local_bh_disable();
2439 cpu = smp_processor_id();
fd2ea0a7
DM
2440 for (i = 0; i < dev->num_tx_queues; i++) {
2441 struct netdev_queue *txq = netdev_get_tx_queue(dev, i);
c3f26a26
DM
2442
2443 __netif_tx_lock(txq, cpu);
fd2ea0a7 2444 netif_tx_stop_queue(txq);
c3f26a26 2445 __netif_tx_unlock(txq);
fd2ea0a7 2446 }
c3f26a26 2447 local_bh_enable();
1da177e4
LT
2448}
2449
e308a5d8
DM
2450static inline void netif_addr_lock(struct net_device *dev)
2451{
2452 spin_lock(&dev->addr_list_lock);
2453}
2454
2429f7ac
JP
2455static inline void netif_addr_lock_nested(struct net_device *dev)
2456{
2457 spin_lock_nested(&dev->addr_list_lock, SINGLE_DEPTH_NESTING);
2458}
2459
e308a5d8
DM
2460static inline void netif_addr_lock_bh(struct net_device *dev)
2461{
2462 spin_lock_bh(&dev->addr_list_lock);
2463}
2464
2465static inline void netif_addr_unlock(struct net_device *dev)
2466{
2467 spin_unlock(&dev->addr_list_lock);
2468}
2469
2470static inline void netif_addr_unlock_bh(struct net_device *dev)
2471{
2472 spin_unlock_bh(&dev->addr_list_lock);
2473}
2474
f001fde5 2475/*
31278e71 2476 * dev_addrs walker. Should be used only for read access. Call with
f001fde5
JP
2477 * rcu_read_lock held.
2478 */
2479#define for_each_dev_addr(dev, ha) \
31278e71 2480 list_for_each_entry_rcu(ha, &dev->dev_addrs.list, list)
f001fde5 2481
1da177e4
LT
2482/* These functions live elsewhere (drivers/net/net_init.c, but related) */
2483
2484extern void ether_setup(struct net_device *dev);
2485
2486/* Support for loadable net-drivers */
36909ea4 2487extern struct net_device *alloc_netdev_mqs(int sizeof_priv, const char *name,
f25f4e44 2488 void (*setup)(struct net_device *),
36909ea4 2489 unsigned int txqs, unsigned int rxqs);
f25f4e44 2490#define alloc_netdev(sizeof_priv, name, setup) \
36909ea4
TH
2491 alloc_netdev_mqs(sizeof_priv, name, setup, 1, 1)
2492
2493#define alloc_netdev_mq(sizeof_priv, name, setup, count) \
2494 alloc_netdev_mqs(sizeof_priv, name, setup, count, count)
2495
1da177e4
LT
2496extern int register_netdev(struct net_device *dev);
2497extern void unregister_netdev(struct net_device *dev);
f001fde5 2498
22bedad3
JP
2499/* General hardware address lists handling functions */
2500extern int __hw_addr_add_multiple(struct netdev_hw_addr_list *to_list,
2501 struct netdev_hw_addr_list *from_list,
2502 int addr_len, unsigned char addr_type);
2503extern void __hw_addr_del_multiple(struct netdev_hw_addr_list *to_list,
2504 struct netdev_hw_addr_list *from_list,
2505 int addr_len, unsigned char addr_type);
2506extern int __hw_addr_sync(struct netdev_hw_addr_list *to_list,
2507 struct netdev_hw_addr_list *from_list,
2508 int addr_len);
2509extern void __hw_addr_unsync(struct netdev_hw_addr_list *to_list,
2510 struct netdev_hw_addr_list *from_list,
2511 int addr_len);
2512extern void __hw_addr_flush(struct netdev_hw_addr_list *list);
2513extern void __hw_addr_init(struct netdev_hw_addr_list *list);
2514
f001fde5
JP
2515/* Functions used for device addresses handling */
2516extern int dev_addr_add(struct net_device *dev, unsigned char *addr,
2517 unsigned char addr_type);
2518extern int dev_addr_del(struct net_device *dev, unsigned char *addr,
2519 unsigned char addr_type);
2520extern int dev_addr_add_multiple(struct net_device *to_dev,
2521 struct net_device *from_dev,
2522 unsigned char addr_type);
2523extern int dev_addr_del_multiple(struct net_device *to_dev,
2524 struct net_device *from_dev,
2525 unsigned char addr_type);
a748ee24
JP
2526extern void dev_addr_flush(struct net_device *dev);
2527extern int dev_addr_init(struct net_device *dev);
2528
2529/* Functions used for unicast addresses handling */
2530extern int dev_uc_add(struct net_device *dev, unsigned char *addr);
2531extern int dev_uc_del(struct net_device *dev, unsigned char *addr);
2532extern int dev_uc_sync(struct net_device *to, struct net_device *from);
2533extern void dev_uc_unsync(struct net_device *to, struct net_device *from);
2534extern void dev_uc_flush(struct net_device *dev);
2535extern void dev_uc_init(struct net_device *dev);
f001fde5 2536
22bedad3
JP
2537/* Functions used for multicast addresses handling */
2538extern int dev_mc_add(struct net_device *dev, unsigned char *addr);
2539extern int dev_mc_add_global(struct net_device *dev, unsigned char *addr);
2540extern int dev_mc_del(struct net_device *dev, unsigned char *addr);
2541extern int dev_mc_del_global(struct net_device *dev, unsigned char *addr);
2542extern int dev_mc_sync(struct net_device *to, struct net_device *from);
2543extern void dev_mc_unsync(struct net_device *to, struct net_device *from);
2544extern void dev_mc_flush(struct net_device *dev);
2545extern void dev_mc_init(struct net_device *dev);
f001fde5 2546
4417da66
PM
2547/* Functions used for secondary unicast and multicast support */
2548extern void dev_set_rx_mode(struct net_device *dev);
2549extern void __dev_set_rx_mode(struct net_device *dev);
dad9b335
WC
2550extern int dev_set_promiscuity(struct net_device *dev, int inc);
2551extern int dev_set_allmulti(struct net_device *dev, int inc);
1da177e4 2552extern void netdev_state_change(struct net_device *dev);
3ca5b404 2553extern int netdev_bonding_change(struct net_device *dev,
75c78500 2554 unsigned long event);
d8a33ac4 2555extern void netdev_features_change(struct net_device *dev);
1da177e4 2556/* Load a device via the kmod */
881d966b 2557extern void dev_load(struct net *net, const char *name);
1da177e4 2558extern void dev_mcast_init(void);
d7753516
BH
2559extern struct rtnl_link_stats64 *dev_get_stats(struct net_device *dev,
2560 struct rtnl_link_stats64 *storage);
77a1abf5
ED
2561extern void netdev_stats_to_stats64(struct rtnl_link_stats64 *stats64,
2562 const struct net_device_stats *netdev_stats);
eeda3fd6 2563
1da177e4 2564extern int netdev_max_backlog;
3b098e2d 2565extern int netdev_tstamp_prequeue;
1da177e4 2566extern int weight_p;
0a14842f 2567extern int bpf_jit_enable;
1da177e4 2568extern int netdev_set_master(struct net_device *dev, struct net_device *master);
1765a575
JP
2569extern int netdev_set_bond_master(struct net_device *dev,
2570 struct net_device *master);
84fa7933 2571extern int skb_checksum_help(struct sk_buff *skb);
c8f44aff
MM
2572extern struct sk_buff *skb_gso_segment(struct sk_buff *skb,
2573 netdev_features_t features);
fb286bb2
HX
2574#ifdef CONFIG_BUG
2575extern void netdev_rx_csum_fault(struct net_device *dev);
2576#else
2577static inline void netdev_rx_csum_fault(struct net_device *dev)
2578{
2579}
2580#endif
1da177e4
LT
2581/* rx skb timestamps */
2582extern void net_enable_timestamp(void);
2583extern void net_disable_timestamp(void);
2584
20380731
ACM
2585#ifdef CONFIG_PROC_FS
2586extern void *dev_seq_start(struct seq_file *seq, loff_t *pos);
2587extern void *dev_seq_next(struct seq_file *seq, void *v, loff_t *pos);
2588extern void dev_seq_stop(struct seq_file *seq, void *v);
5cac98dd
AB
2589extern int dev_seq_open_ops(struct inode *inode, struct file *file,
2590 const struct seq_operations *ops);
20380731
ACM
2591#endif
2592
b8a9787e
JV
2593extern int netdev_class_create_file(struct class_attribute *class_attr);
2594extern void netdev_class_remove_file(struct class_attribute *class_attr);
2595
04600794
JB
2596extern struct kobj_ns_type_operations net_ns_type_operations;
2597
3019de12 2598extern const char *netdev_drivername(const struct net_device *dev);
6579e57b 2599
20380731
ACM
2600extern void linkwatch_run_queue(void);
2601
c8f44aff
MM
2602static inline netdev_features_t netdev_get_wanted_features(
2603 struct net_device *dev)
5455c699
MM
2604{
2605 return (dev->features & ~dev->hw_features) | dev->wanted_features;
2606}
c8f44aff
MM
2607netdev_features_t netdev_increment_features(netdev_features_t all,
2608 netdev_features_t one, netdev_features_t mask);
6cb6a27c 2609int __netdev_update_features(struct net_device *dev);
5455c699 2610void netdev_update_features(struct net_device *dev);
afe12cc8 2611void netdev_change_features(struct net_device *dev);
7f353bf2 2612
fc4a7489
PM
2613void netif_stacked_transfer_operstate(const struct net_device *rootdev,
2614 struct net_device *dev);
2615
c8f44aff 2616netdev_features_t netif_skb_features(struct sk_buff *skb);
58e998c6 2617
4d29515f 2618static inline bool net_gso_ok(netdev_features_t features, int gso_type)
576a30eb 2619{
c8f44aff 2620 netdev_features_t feature = gso_type << NETIF_F_GSO_SHIFT;
0345e186
MM
2621
2622 /* check flags correspondence */
2623 BUILD_BUG_ON(SKB_GSO_TCPV4 != (NETIF_F_TSO >> NETIF_F_GSO_SHIFT));
2624 BUILD_BUG_ON(SKB_GSO_UDP != (NETIF_F_UFO >> NETIF_F_GSO_SHIFT));
2625 BUILD_BUG_ON(SKB_GSO_DODGY != (NETIF_F_GSO_ROBUST >> NETIF_F_GSO_SHIFT));
2626 BUILD_BUG_ON(SKB_GSO_TCP_ECN != (NETIF_F_TSO_ECN >> NETIF_F_GSO_SHIFT));
2627 BUILD_BUG_ON(SKB_GSO_TCPV6 != (NETIF_F_TSO6 >> NETIF_F_GSO_SHIFT));
2628 BUILD_BUG_ON(SKB_GSO_FCOE != (NETIF_F_FSO >> NETIF_F_GSO_SHIFT));
2629
d6b4991a 2630 return (features & feature) == feature;
576a30eb
HX
2631}
2632
4d29515f 2633static inline bool skb_gso_ok(struct sk_buff *skb, netdev_features_t features)
bcd76111 2634{
278b2513 2635 return net_gso_ok(features, skb_shinfo(skb)->gso_type) &&
21dc3301 2636 (!skb_has_frag_list(skb) || (features & NETIF_F_FRAGLIST));
bcd76111
HX
2637}
2638
4d29515f
DM
2639static inline bool netif_needs_gso(struct sk_buff *skb,
2640 netdev_features_t features)
7967168c 2641{
fc741216
JG
2642 return skb_is_gso(skb) && (!skb_gso_ok(skb, features) ||
2643 unlikely(skb->ip_summed != CHECKSUM_PARTIAL));
7967168c
HX
2644}
2645
82cc1a7a
PWJ
2646static inline void netif_set_gso_max_size(struct net_device *dev,
2647 unsigned int size)
2648{
2649 dev->gso_max_size = size;
2650}
2651
4d29515f 2652static inline bool netif_is_bond_slave(struct net_device *dev)
1765a575
JP
2653{
2654 return dev->flags & IFF_SLAVE && dev->priv_flags & IFF_BONDING;
2655}
2656
3bdc0eba
BG
2657static inline bool netif_supports_nofcs(struct net_device *dev)
2658{
2659 return dev->priv_flags & IFF_SUPP_NOFCS;
2660}
2661
505d4f73 2662extern struct pernet_operations __net_initdata loopback_net_ops;
b1b67dd4 2663
571ba423
JP
2664/* Logging, debugging and troubleshooting/diagnostic helpers. */
2665
2666/* netdev_printk helpers, similar to dev_printk */
2667
2668static inline const char *netdev_name(const struct net_device *dev)
2669{
2670 if (dev->reg_state != NETREG_REGISTERED)
2671 return "(unregistered net_device)";
2672 return dev->name;
2673}
2674
ffa10cb4
JB
2675extern int __netdev_printk(const char *level, const struct net_device *dev,
2676 struct va_format *vaf);
2677
b9075fa9
JP
2678extern __printf(3, 4)
2679int netdev_printk(const char *level, const struct net_device *dev,
2680 const char *format, ...);
2681extern __printf(2, 3)
2682int netdev_emerg(const struct net_device *dev, const char *format, ...);
2683extern __printf(2, 3)
2684int netdev_alert(const struct net_device *dev, const char *format, ...);
2685extern __printf(2, 3)
2686int netdev_crit(const struct net_device *dev, const char *format, ...);
2687extern __printf(2, 3)
2688int netdev_err(const struct net_device *dev, const char *format, ...);
2689extern __printf(2, 3)
2690int netdev_warn(const struct net_device *dev, const char *format, ...);
2691extern __printf(2, 3)
2692int netdev_notice(const struct net_device *dev, const char *format, ...);
2693extern __printf(2, 3)
2694int netdev_info(const struct net_device *dev, const char *format, ...);
571ba423 2695
8909c9ad
VK
2696#define MODULE_ALIAS_NETDEV(device) \
2697 MODULE_ALIAS("netdev-" device)
2698
571ba423
JP
2699#if defined(DEBUG)
2700#define netdev_dbg(__dev, format, args...) \
2701 netdev_printk(KERN_DEBUG, __dev, format, ##args)
2702#elif defined(CONFIG_DYNAMIC_DEBUG)
2703#define netdev_dbg(__dev, format, args...) \
2704do { \
ffa10cb4 2705 dynamic_netdev_dbg(__dev, format, ##args); \
571ba423
JP
2706} while (0)
2707#else
2708#define netdev_dbg(__dev, format, args...) \
2709({ \
2710 if (0) \
2711 netdev_printk(KERN_DEBUG, __dev, format, ##args); \
2712 0; \
2713})
2714#endif
2715
2716#if defined(VERBOSE_DEBUG)
2717#define netdev_vdbg netdev_dbg
2718#else
2719
2720#define netdev_vdbg(dev, format, args...) \
2721({ \
2722 if (0) \
2723 netdev_printk(KERN_DEBUG, dev, format, ##args); \
2724 0; \
2725})
2726#endif
2727
2728/*
2729 * netdev_WARN() acts like dev_printk(), but with the key difference
2730 * of using a WARN/WARN_ON to get the message out, including the
2731 * file/line information and a backtrace.
2732 */
2733#define netdev_WARN(dev, format, args...) \
2734 WARN(1, "netdevice: %s\n" format, netdev_name(dev), ##args);
2735
b3d95c5c
JP
2736/* netif printk helpers, similar to netdev_printk */
2737
2738#define netif_printk(priv, type, level, dev, fmt, args...) \
2739do { \
2740 if (netif_msg_##type(priv)) \
2741 netdev_printk(level, (dev), fmt, ##args); \
2742} while (0)
2743
f45f4321
JP
2744#define netif_level(level, priv, type, dev, fmt, args...) \
2745do { \
2746 if (netif_msg_##type(priv)) \
2747 netdev_##level(dev, fmt, ##args); \
2748} while (0)
2749
b3d95c5c 2750#define netif_emerg(priv, type, dev, fmt, args...) \
f45f4321 2751 netif_level(emerg, priv, type, dev, fmt, ##args)
b3d95c5c 2752#define netif_alert(priv, type, dev, fmt, args...) \
f45f4321 2753 netif_level(alert, priv, type, dev, fmt, ##args)
b3d95c5c 2754#define netif_crit(priv, type, dev, fmt, args...) \
f45f4321 2755 netif_level(crit, priv, type, dev, fmt, ##args)
b3d95c5c 2756#define netif_err(priv, type, dev, fmt, args...) \
f45f4321 2757 netif_level(err, priv, type, dev, fmt, ##args)
b3d95c5c 2758#define netif_warn(priv, type, dev, fmt, args...) \
f45f4321 2759 netif_level(warn, priv, type, dev, fmt, ##args)
b3d95c5c 2760#define netif_notice(priv, type, dev, fmt, args...) \
f45f4321 2761 netif_level(notice, priv, type, dev, fmt, ##args)
b3d95c5c 2762#define netif_info(priv, type, dev, fmt, args...) \
f45f4321 2763 netif_level(info, priv, type, dev, fmt, ##args)
b3d95c5c
JP
2764
2765#if defined(DEBUG)
2766#define netif_dbg(priv, type, dev, format, args...) \
2767 netif_printk(priv, type, KERN_DEBUG, dev, format, ##args)
2768#elif defined(CONFIG_DYNAMIC_DEBUG)
2769#define netif_dbg(priv, type, netdev, format, args...) \
2770do { \
2771 if (netif_msg_##type(priv)) \
b5fb0a03 2772 dynamic_netdev_dbg(netdev, format, ##args); \
b3d95c5c
JP
2773} while (0)
2774#else
2775#define netif_dbg(priv, type, dev, format, args...) \
2776({ \
2777 if (0) \
2778 netif_printk(priv, type, KERN_DEBUG, dev, format, ##args); \
2779 0; \
2780})
2781#endif
2782
2783#if defined(VERBOSE_DEBUG)
bcfcc450 2784#define netif_vdbg netif_dbg
b3d95c5c
JP
2785#else
2786#define netif_vdbg(priv, type, dev, format, args...) \
2787({ \
2788 if (0) \
a4ed89cb 2789 netif_printk(priv, type, KERN_DEBUG, dev, format, ##args); \
b3d95c5c
JP
2790 0; \
2791})
2792#endif
571ba423 2793
1da177e4
LT
2794#endif /* __KERNEL__ */
2795
385a154c 2796#endif /* _LINUX_NETDEVICE_H */