at 9ea09af3bd3090e8349ca2899ca2011bd94cda85 1878 lines 58 kB view raw
1/* 2 * INET An implementation of the TCP/IP protocol suite for the LINUX 3 * operating system. INET is implemented using the BSD Socket 4 * interface as the means of communication with the user level. 5 * 6 * Definitions for the Interfaces handler. 7 * 8 * Version: @(#)dev.h 1.0.10 08/12/93 9 * 10 * Authors: Ross Biro 11 * Fred N. van Kempen, <waltje@uWalt.NL.Mugnet.ORG> 12 * Corey Minyard <wf-rch!minyard@relay.EU.net> 13 * Donald J. Becker, <becker@cesdis.gsfc.nasa.gov> 14 * Alan Cox, <alan@lxorguk.ukuu.org.uk> 15 * Bjorn Ekwall. <bj0rn@blox.se> 16 * Pekka Riikonen <priikone@poseidon.pspt.fi> 17 * 18 * This program is free software; you can redistribute it and/or 19 * modify it under the terms of the GNU General Public License 20 * as published by the Free Software Foundation; either version 21 * 2 of the License, or (at your option) any later version. 22 * 23 * Moved to /usr/include/linux for NET3 24 */ 25#ifndef _LINUX_NETDEVICE_H 26#define _LINUX_NETDEVICE_H 27 28#include <linux/if.h> 29#include <linux/if_ether.h> 30#include <linux/if_packet.h> 31 32#ifdef __KERNEL__ 33#include <linux/timer.h> 34#include <linux/delay.h> 35#include <asm/atomic.h> 36#include <asm/cache.h> 37#include <asm/byteorder.h> 38 39#include <linux/device.h> 40#include <linux/percpu.h> 41#include <linux/dmaengine.h> 42#include <linux/workqueue.h> 43 44#include <net/net_namespace.h> 45#include <net/dsa.h> 46#ifdef CONFIG_DCB 47#include <net/dcbnl.h> 48#endif 49 50struct vlan_group; 51struct ethtool_ops; 52struct netpoll_info; 53/* 802.11 specific */ 54struct wireless_dev; 55 /* source back-compat hooks */ 56#define SET_ETHTOOL_OPS(netdev,ops) \ 57 ( (netdev)->ethtool_ops = (ops) ) 58 59#define HAVE_ALLOC_NETDEV /* feature macro: alloc_xxxdev 60 functions are available. */ 61#define HAVE_FREE_NETDEV /* free_netdev() */ 62#define HAVE_NETDEV_PRIV /* netdev_priv() */ 63 64#define NET_XMIT_SUCCESS 0 65#define NET_XMIT_DROP 1 /* skb dropped */ 66#define NET_XMIT_CN 2 /* congestion notification */ 67#define NET_XMIT_POLICED 3 /* skb is shot by police */ 68#define NET_XMIT_MASK 0xFFFF /* qdisc flags in net/sch_generic.h */ 69 70/* Backlog congestion levels */ 71#define NET_RX_SUCCESS 0 /* keep 'em coming, baby */ 72#define NET_RX_DROP 1 /* packet dropped */ 73#define NET_RX_CN_LOW 2 /* storm alert, just in case */ 74#define NET_RX_CN_MOD 3 /* Storm on its way! */ 75#define NET_RX_CN_HIGH 4 /* The storm is here */ 76#define NET_RX_BAD 5 /* packet dropped due to kernel error */ 77 78/* NET_XMIT_CN is special. It does not guarantee that this packet is lost. It 79 * indicates that the device will soon be dropping packets, or already drops 80 * some packets of the same priority; prompting us to send less aggressively. */ 81#define net_xmit_eval(e) ((e) == NET_XMIT_CN? 0 : (e)) 82#define net_xmit_errno(e) ((e) != NET_XMIT_CN ? -ENOBUFS : 0) 83 84#endif 85 86#define MAX_ADDR_LEN 32 /* Largest hardware address length */ 87 88/* Driver transmit return codes */ 89#define NETDEV_TX_OK 0 /* driver took care of packet */ 90#define NETDEV_TX_BUSY 1 /* driver tx path was busy*/ 91#define NETDEV_TX_LOCKED -1 /* driver tx lock was already taken */ 92 93#ifdef __KERNEL__ 94 95/* 96 * Compute the worst case header length according to the protocols 97 * used. 98 */ 99 100#if defined(CONFIG_WLAN_80211) || defined(CONFIG_AX25) || defined(CONFIG_AX25_MODULE) 101# if defined(CONFIG_MAC80211_MESH) 102# define LL_MAX_HEADER 128 103# else 104# define LL_MAX_HEADER 96 105# endif 106#elif defined(CONFIG_TR) 107# define LL_MAX_HEADER 48 108#else 109# define LL_MAX_HEADER 32 110#endif 111 112#if !defined(CONFIG_NET_IPIP) && !defined(CONFIG_NET_IPIP_MODULE) && \ 113 !defined(CONFIG_NET_IPGRE) && !defined(CONFIG_NET_IPGRE_MODULE) && \ 114 !defined(CONFIG_IPV6_SIT) && !defined(CONFIG_IPV6_SIT_MODULE) && \ 115 !defined(CONFIG_IPV6_TUNNEL) && !defined(CONFIG_IPV6_TUNNEL_MODULE) 116#define MAX_HEADER LL_MAX_HEADER 117#else 118#define MAX_HEADER (LL_MAX_HEADER + 48) 119#endif 120 121#endif /* __KERNEL__ */ 122 123/* 124 * Network device statistics. Akin to the 2.0 ether stats but 125 * with byte counters. 126 */ 127 128struct net_device_stats 129{ 130 unsigned long rx_packets; /* total packets received */ 131 unsigned long tx_packets; /* total packets transmitted */ 132 unsigned long rx_bytes; /* total bytes received */ 133 unsigned long tx_bytes; /* total bytes transmitted */ 134 unsigned long rx_errors; /* bad packets received */ 135 unsigned long tx_errors; /* packet transmit problems */ 136 unsigned long rx_dropped; /* no space in linux buffers */ 137 unsigned long tx_dropped; /* no space available in linux */ 138 unsigned long multicast; /* multicast packets received */ 139 unsigned long collisions; 140 141 /* detailed rx_errors: */ 142 unsigned long rx_length_errors; 143 unsigned long rx_over_errors; /* receiver ring buff overflow */ 144 unsigned long rx_crc_errors; /* recved pkt with crc error */ 145 unsigned long rx_frame_errors; /* recv'd frame alignment error */ 146 unsigned long rx_fifo_errors; /* recv'r fifo overrun */ 147 unsigned long rx_missed_errors; /* receiver missed packet */ 148 149 /* detailed tx_errors */ 150 unsigned long tx_aborted_errors; 151 unsigned long tx_carrier_errors; 152 unsigned long tx_fifo_errors; 153 unsigned long tx_heartbeat_errors; 154 unsigned long tx_window_errors; 155 156 /* for cslip etc */ 157 unsigned long rx_compressed; 158 unsigned long tx_compressed; 159}; 160 161 162/* Media selection options. */ 163enum { 164 IF_PORT_UNKNOWN = 0, 165 IF_PORT_10BASE2, 166 IF_PORT_10BASET, 167 IF_PORT_AUI, 168 IF_PORT_100BASET, 169 IF_PORT_100BASETX, 170 IF_PORT_100BASEFX 171}; 172 173#ifdef __KERNEL__ 174 175#include <linux/cache.h> 176#include <linux/skbuff.h> 177 178struct neighbour; 179struct neigh_parms; 180struct sk_buff; 181 182struct netif_rx_stats 183{ 184 unsigned total; 185 unsigned dropped; 186 unsigned time_squeeze; 187 unsigned cpu_collision; 188}; 189 190DECLARE_PER_CPU(struct netif_rx_stats, netdev_rx_stat); 191 192struct dev_addr_list 193{ 194 struct dev_addr_list *next; 195 u8 da_addr[MAX_ADDR_LEN]; 196 u8 da_addrlen; 197 u8 da_synced; 198 int da_users; 199 int da_gusers; 200}; 201 202/* 203 * We tag multicasts with these structures. 204 */ 205 206#define dev_mc_list dev_addr_list 207#define dmi_addr da_addr 208#define dmi_addrlen da_addrlen 209#define dmi_users da_users 210#define dmi_gusers da_gusers 211 212struct hh_cache 213{ 214 struct hh_cache *hh_next; /* Next entry */ 215 atomic_t hh_refcnt; /* number of users */ 216/* 217 * We want hh_output, hh_len, hh_lock and hh_data be a in a separate 218 * cache line on SMP. 219 * They are mostly read, but hh_refcnt may be changed quite frequently, 220 * incurring cache line ping pongs. 221 */ 222 __be16 hh_type ____cacheline_aligned_in_smp; 223 /* protocol identifier, f.e ETH_P_IP 224 * NOTE: For VLANs, this will be the 225 * encapuslated type. --BLG 226 */ 227 u16 hh_len; /* length of header */ 228 int (*hh_output)(struct sk_buff *skb); 229 seqlock_t hh_lock; 230 231 /* cached hardware header; allow for machine alignment needs. */ 232#define HH_DATA_MOD 16 233#define HH_DATA_OFF(__len) \ 234 (HH_DATA_MOD - (((__len - 1) & (HH_DATA_MOD - 1)) + 1)) 235#define HH_DATA_ALIGN(__len) \ 236 (((__len)+(HH_DATA_MOD-1))&~(HH_DATA_MOD - 1)) 237 unsigned long hh_data[HH_DATA_ALIGN(LL_MAX_HEADER) / sizeof(long)]; 238}; 239 240/* Reserve HH_DATA_MOD byte aligned hard_header_len, but at least that much. 241 * Alternative is: 242 * dev->hard_header_len ? (dev->hard_header_len + 243 * (HH_DATA_MOD - 1)) & ~(HH_DATA_MOD - 1) : 0 244 * 245 * We could use other alignment values, but we must maintain the 246 * relationship HH alignment <= LL alignment. 247 * 248 * LL_ALLOCATED_SPACE also takes into account the tailroom the device 249 * may need. 250 */ 251#define LL_RESERVED_SPACE(dev) \ 252 ((((dev)->hard_header_len+(dev)->needed_headroom)&~(HH_DATA_MOD - 1)) + HH_DATA_MOD) 253#define LL_RESERVED_SPACE_EXTRA(dev,extra) \ 254 ((((dev)->hard_header_len+(dev)->needed_headroom+(extra))&~(HH_DATA_MOD - 1)) + HH_DATA_MOD) 255#define LL_ALLOCATED_SPACE(dev) \ 256 ((((dev)->hard_header_len+(dev)->needed_headroom+(dev)->needed_tailroom)&~(HH_DATA_MOD - 1)) + HH_DATA_MOD) 257 258struct header_ops { 259 int (*create) (struct sk_buff *skb, struct net_device *dev, 260 unsigned short type, const void *daddr, 261 const void *saddr, unsigned len); 262 int (*parse)(const struct sk_buff *skb, unsigned char *haddr); 263 int (*rebuild)(struct sk_buff *skb); 264#define HAVE_HEADER_CACHE 265 int (*cache)(const struct neighbour *neigh, struct hh_cache *hh); 266 void (*cache_update)(struct hh_cache *hh, 267 const struct net_device *dev, 268 const unsigned char *haddr); 269}; 270 271/* These flag bits are private to the generic network queueing 272 * layer, they may not be explicitly referenced by any other 273 * code. 274 */ 275 276enum netdev_state_t 277{ 278 __LINK_STATE_START, 279 __LINK_STATE_PRESENT, 280 __LINK_STATE_NOCARRIER, 281 __LINK_STATE_LINKWATCH_PENDING, 282 __LINK_STATE_DORMANT, 283}; 284 285 286/* 287 * This structure holds at boot time configured netdevice settings. They 288 * are then used in the device probing. 289 */ 290struct netdev_boot_setup { 291 char name[IFNAMSIZ]; 292 struct ifmap map; 293}; 294#define NETDEV_BOOT_SETUP_MAX 8 295 296extern int __init netdev_boot_setup(char *str); 297 298/* 299 * Structure for NAPI scheduling similar to tasklet but with weighting 300 */ 301struct napi_struct { 302 /* The poll_list must only be managed by the entity which 303 * changes the state of the NAPI_STATE_SCHED bit. This means 304 * whoever atomically sets that bit can add this napi_struct 305 * to the per-cpu poll_list, and whoever clears that bit 306 * can remove from the list right before clearing the bit. 307 */ 308 struct list_head poll_list; 309 310 unsigned long state; 311 int weight; 312 int (*poll)(struct napi_struct *, int); 313#ifdef CONFIG_NETPOLL 314 spinlock_t poll_lock; 315 int poll_owner; 316 struct net_device *dev; 317#endif 318 struct list_head dev_list; 319 struct sk_buff *gro_list; 320}; 321 322enum 323{ 324 NAPI_STATE_SCHED, /* Poll is scheduled */ 325 NAPI_STATE_DISABLE, /* Disable pending */ 326 NAPI_STATE_NPSVC, /* Netpoll - don't dequeue from poll_list */ 327}; 328 329extern void __napi_schedule(struct napi_struct *n); 330 331static inline int napi_disable_pending(struct napi_struct *n) 332{ 333 return test_bit(NAPI_STATE_DISABLE, &n->state); 334} 335 336/** 337 * napi_schedule_prep - check if napi can be scheduled 338 * @n: napi context 339 * 340 * Test if NAPI routine is already running, and if not mark 341 * it as running. This is used as a condition variable 342 * insure only one NAPI poll instance runs. We also make 343 * sure there is no pending NAPI disable. 344 */ 345static inline int napi_schedule_prep(struct napi_struct *n) 346{ 347 return !napi_disable_pending(n) && 348 !test_and_set_bit(NAPI_STATE_SCHED, &n->state); 349} 350 351/** 352 * napi_schedule - schedule NAPI poll 353 * @n: napi context 354 * 355 * Schedule NAPI poll routine to be called if it is not already 356 * running. 357 */ 358static inline void napi_schedule(struct napi_struct *n) 359{ 360 if (napi_schedule_prep(n)) 361 __napi_schedule(n); 362} 363 364/* Try to reschedule poll. Called by dev->poll() after napi_complete(). */ 365static inline int napi_reschedule(struct napi_struct *napi) 366{ 367 if (napi_schedule_prep(napi)) { 368 __napi_schedule(napi); 369 return 1; 370 } 371 return 0; 372} 373 374/** 375 * napi_complete - NAPI processing complete 376 * @n: napi context 377 * 378 * Mark NAPI processing as complete. 379 */ 380extern void __napi_complete(struct napi_struct *n); 381extern void napi_complete(struct napi_struct *n); 382 383/** 384 * napi_disable - prevent NAPI from scheduling 385 * @n: napi context 386 * 387 * Stop NAPI from being scheduled on this context. 388 * Waits till any outstanding processing completes. 389 */ 390static inline void napi_disable(struct napi_struct *n) 391{ 392 set_bit(NAPI_STATE_DISABLE, &n->state); 393 while (test_and_set_bit(NAPI_STATE_SCHED, &n->state)) 394 msleep(1); 395 clear_bit(NAPI_STATE_DISABLE, &n->state); 396} 397 398/** 399 * napi_enable - enable NAPI scheduling 400 * @n: napi context 401 * 402 * Resume NAPI from being scheduled on this context. 403 * Must be paired with napi_disable. 404 */ 405static inline void napi_enable(struct napi_struct *n) 406{ 407 BUG_ON(!test_bit(NAPI_STATE_SCHED, &n->state)); 408 smp_mb__before_clear_bit(); 409 clear_bit(NAPI_STATE_SCHED, &n->state); 410} 411 412#ifdef CONFIG_SMP 413/** 414 * napi_synchronize - wait until NAPI is not running 415 * @n: napi context 416 * 417 * Wait until NAPI is done being scheduled on this context. 418 * Waits till any outstanding processing completes but 419 * does not disable future activations. 420 */ 421static inline void napi_synchronize(const struct napi_struct *n) 422{ 423 while (test_bit(NAPI_STATE_SCHED, &n->state)) 424 msleep(1); 425} 426#else 427# define napi_synchronize(n) barrier() 428#endif 429 430enum netdev_queue_state_t 431{ 432 __QUEUE_STATE_XOFF, 433 __QUEUE_STATE_FROZEN, 434}; 435 436struct netdev_queue { 437 struct net_device *dev; 438 struct Qdisc *qdisc; 439 unsigned long state; 440 spinlock_t _xmit_lock; 441 int xmit_lock_owner; 442 struct Qdisc *qdisc_sleeping; 443} ____cacheline_aligned_in_smp; 444 445 446/* 447 * This structure defines the management hooks for network devices. 448 * The following hooks can be defined; unless noted otherwise, they are 449 * optional and can be filled with a null pointer. 450 * 451 * int (*ndo_init)(struct net_device *dev); 452 * This function is called once when network device is registered. 453 * The network device can use this to any late stage initializaton 454 * or semantic validattion. It can fail with an error code which will 455 * be propogated back to register_netdev 456 * 457 * void (*ndo_uninit)(struct net_device *dev); 458 * This function is called when device is unregistered or when registration 459 * fails. It is not called if init fails. 460 * 461 * int (*ndo_open)(struct net_device *dev); 462 * This function is called when network device transistions to the up 463 * state. 464 * 465 * int (*ndo_stop)(struct net_device *dev); 466 * This function is called when network device transistions to the down 467 * state. 468 * 469 * int (*ndo_hard_start_xmit)(struct sk_buff *skb, struct net_device *dev); 470 * Called when a packet needs to be transmitted. 471 * Must return NETDEV_TX_OK , NETDEV_TX_BUSY, or NETDEV_TX_LOCKED, 472 * Required can not be NULL. 473 * 474 * u16 (*ndo_select_queue)(struct net_device *dev, struct sk_buff *skb); 475 * Called to decide which queue to when device supports multiple 476 * transmit queues. 477 * 478 * void (*ndo_change_rx_flags)(struct net_device *dev, int flags); 479 * This function is called to allow device receiver to make 480 * changes to configuration when multicast or promiscious is enabled. 481 * 482 * void (*ndo_set_rx_mode)(struct net_device *dev); 483 * This function is called device changes address list filtering. 484 * 485 * void (*ndo_set_multicast_list)(struct net_device *dev); 486 * This function is called when the multicast address list changes. 487 * 488 * int (*ndo_set_mac_address)(struct net_device *dev, void *addr); 489 * This function is called when the Media Access Control address 490 * needs to be changed. If not this interface is not defined, the 491 * mac address can not be changed. 492 * 493 * int (*ndo_validate_addr)(struct net_device *dev); 494 * Test if Media Access Control address is valid for the device. 495 * 496 * int (*ndo_do_ioctl)(struct net_device *dev, struct ifreq *ifr, int cmd); 497 * Called when a user request an ioctl which can't be handled by 498 * the generic interface code. If not defined ioctl's return 499 * not supported error code. 500 * 501 * int (*ndo_set_config)(struct net_device *dev, struct ifmap *map); 502 * Used to set network devices bus interface parameters. This interface 503 * is retained for legacy reason, new devices should use the bus 504 * interface (PCI) for low level management. 505 * 506 * int (*ndo_change_mtu)(struct net_device *dev, int new_mtu); 507 * Called when a user wants to change the Maximum Transfer Unit 508 * of a device. If not defined, any request to change MTU will 509 * will return an error. 510 * 511 * void (*ndo_tx_timeout)(struct net_device *dev); 512 * Callback uses when the transmitter has not made any progress 513 * for dev->watchdog ticks. 514 * 515 * struct net_device_stats* (*get_stats)(struct net_device *dev); 516 * Called when a user wants to get the network device usage 517 * statistics. If not defined, the counters in dev->stats will 518 * be used. 519 * 520 * void (*ndo_vlan_rx_register)(struct net_device *dev, struct vlan_group *grp); 521 * If device support VLAN receive accleration 522 * (ie. dev->features & NETIF_F_HW_VLAN_RX), then this function is called 523 * when vlan groups for the device changes. Note: grp is NULL 524 * if no vlan's groups are being used. 525 * 526 * void (*ndo_vlan_rx_add_vid)(struct net_device *dev, unsigned short vid); 527 * If device support VLAN filtering (dev->features & NETIF_F_HW_VLAN_FILTER) 528 * this function is called when a VLAN id is registered. 529 * 530 * void (*ndo_vlan_rx_kill_vid)(struct net_device *dev, unsigned short vid); 531 * If device support VLAN filtering (dev->features & NETIF_F_HW_VLAN_FILTER) 532 * this function is called when a VLAN id is unregistered. 533 * 534 * void (*ndo_poll_controller)(struct net_device *dev); 535 */ 536#define HAVE_NET_DEVICE_OPS 537struct net_device_ops { 538 int (*ndo_init)(struct net_device *dev); 539 void (*ndo_uninit)(struct net_device *dev); 540 int (*ndo_open)(struct net_device *dev); 541 int (*ndo_stop)(struct net_device *dev); 542 int (*ndo_start_xmit) (struct sk_buff *skb, 543 struct net_device *dev); 544 u16 (*ndo_select_queue)(struct net_device *dev, 545 struct sk_buff *skb); 546#define HAVE_CHANGE_RX_FLAGS 547 void (*ndo_change_rx_flags)(struct net_device *dev, 548 int flags); 549#define HAVE_SET_RX_MODE 550 void (*ndo_set_rx_mode)(struct net_device *dev); 551#define HAVE_MULTICAST 552 void (*ndo_set_multicast_list)(struct net_device *dev); 553#define HAVE_SET_MAC_ADDR 554 int (*ndo_set_mac_address)(struct net_device *dev, 555 void *addr); 556#define HAVE_VALIDATE_ADDR 557 int (*ndo_validate_addr)(struct net_device *dev); 558#define HAVE_PRIVATE_IOCTL 559 int (*ndo_do_ioctl)(struct net_device *dev, 560 struct ifreq *ifr, int cmd); 561#define HAVE_SET_CONFIG 562 int (*ndo_set_config)(struct net_device *dev, 563 struct ifmap *map); 564#define HAVE_CHANGE_MTU 565 int (*ndo_change_mtu)(struct net_device *dev, 566 int new_mtu); 567 int (*ndo_neigh_setup)(struct net_device *dev, 568 struct neigh_parms *); 569#define HAVE_TX_TIMEOUT 570 void (*ndo_tx_timeout) (struct net_device *dev); 571 572 struct net_device_stats* (*ndo_get_stats)(struct net_device *dev); 573 574 void (*ndo_vlan_rx_register)(struct net_device *dev, 575 struct vlan_group *grp); 576 void (*ndo_vlan_rx_add_vid)(struct net_device *dev, 577 unsigned short vid); 578 void (*ndo_vlan_rx_kill_vid)(struct net_device *dev, 579 unsigned short vid); 580#ifdef CONFIG_NET_POLL_CONTROLLER 581#define HAVE_NETDEV_POLL 582 void (*ndo_poll_controller)(struct net_device *dev); 583#endif 584}; 585 586/* 587 * The DEVICE structure. 588 * Actually, this whole structure is a big mistake. It mixes I/O 589 * data with strictly "high-level" data, and it has to know about 590 * almost every data structure used in the INET module. 591 * 592 * FIXME: cleanup struct net_device such that network protocol info 593 * moves out. 594 */ 595 596struct net_device 597{ 598 599 /* 600 * This is the first field of the "visible" part of this structure 601 * (i.e. as seen by users in the "Space.c" file). It is the name 602 * the interface. 603 */ 604 char name[IFNAMSIZ]; 605 /* device name hash chain */ 606 struct hlist_node name_hlist; 607 /* snmp alias */ 608 char *ifalias; 609 610 /* 611 * I/O specific fields 612 * FIXME: Merge these and struct ifmap into one 613 */ 614 unsigned long mem_end; /* shared mem end */ 615 unsigned long mem_start; /* shared mem start */ 616 unsigned long base_addr; /* device I/O address */ 617 unsigned int irq; /* device IRQ number */ 618 619 /* 620 * Some hardware also needs these fields, but they are not 621 * part of the usual set specified in Space.c. 622 */ 623 624 unsigned char if_port; /* Selectable AUI, TP,..*/ 625 unsigned char dma; /* DMA channel */ 626 627 unsigned long state; 628 629 struct list_head dev_list; 630 struct list_head napi_list; 631 632 /* Net device features */ 633 unsigned long features; 634#define NETIF_F_SG 1 /* Scatter/gather IO. */ 635#define NETIF_F_IP_CSUM 2 /* Can checksum TCP/UDP over IPv4. */ 636#define NETIF_F_NO_CSUM 4 /* Does not require checksum. F.e. loopack. */ 637#define NETIF_F_HW_CSUM 8 /* Can checksum all the packets. */ 638#define NETIF_F_IPV6_CSUM 16 /* Can checksum TCP/UDP over IPV6 */ 639#define NETIF_F_HIGHDMA 32 /* Can DMA to high memory. */ 640#define NETIF_F_FRAGLIST 64 /* Scatter/gather IO. */ 641#define NETIF_F_HW_VLAN_TX 128 /* Transmit VLAN hw acceleration */ 642#define NETIF_F_HW_VLAN_RX 256 /* Receive VLAN hw acceleration */ 643#define NETIF_F_HW_VLAN_FILTER 512 /* Receive filtering on VLAN */ 644#define NETIF_F_VLAN_CHALLENGED 1024 /* Device cannot handle VLAN packets */ 645#define NETIF_F_GSO 2048 /* Enable software GSO. */ 646#define NETIF_F_LLTX 4096 /* LockLess TX - deprecated. Please */ 647 /* do not use LLTX in new drivers */ 648#define NETIF_F_NETNS_LOCAL 8192 /* Does not change network namespaces */ 649#define NETIF_F_GRO 16384 /* Generic receive offload */ 650#define NETIF_F_LRO 32768 /* large receive offload */ 651 652 /* Segmentation offload features */ 653#define NETIF_F_GSO_SHIFT 16 654#define NETIF_F_GSO_MASK 0xffff0000 655#define NETIF_F_TSO (SKB_GSO_TCPV4 << NETIF_F_GSO_SHIFT) 656#define NETIF_F_UFO (SKB_GSO_UDP << NETIF_F_GSO_SHIFT) 657#define NETIF_F_GSO_ROBUST (SKB_GSO_DODGY << NETIF_F_GSO_SHIFT) 658#define NETIF_F_TSO_ECN (SKB_GSO_TCP_ECN << NETIF_F_GSO_SHIFT) 659#define NETIF_F_TSO6 (SKB_GSO_TCPV6 << NETIF_F_GSO_SHIFT) 660 661 /* List of features with software fallbacks. */ 662#define NETIF_F_GSO_SOFTWARE (NETIF_F_TSO | NETIF_F_TSO_ECN | NETIF_F_TSO6) 663 664 665#define NETIF_F_GEN_CSUM (NETIF_F_NO_CSUM | NETIF_F_HW_CSUM) 666#define NETIF_F_V4_CSUM (NETIF_F_GEN_CSUM | NETIF_F_IP_CSUM) 667#define NETIF_F_V6_CSUM (NETIF_F_GEN_CSUM | NETIF_F_IPV6_CSUM) 668#define NETIF_F_ALL_CSUM (NETIF_F_V4_CSUM | NETIF_F_V6_CSUM) 669 670 /* 671 * If one device supports one of these features, then enable them 672 * for all in netdev_increment_features. 673 */ 674#define NETIF_F_ONE_FOR_ALL (NETIF_F_GSO_SOFTWARE | NETIF_F_GSO_ROBUST | \ 675 NETIF_F_SG | NETIF_F_HIGHDMA | \ 676 NETIF_F_FRAGLIST) 677 678 /* Interface index. Unique device identifier */ 679 int ifindex; 680 int iflink; 681 682 struct net_device_stats stats; 683 684#ifdef CONFIG_WIRELESS_EXT 685 /* List of functions to handle Wireless Extensions (instead of ioctl). 686 * See <net/iw_handler.h> for details. Jean II */ 687 const struct iw_handler_def * wireless_handlers; 688 /* Instance data managed by the core of Wireless Extensions. */ 689 struct iw_public_data * wireless_data; 690#endif 691 /* Management operations */ 692 const struct net_device_ops *netdev_ops; 693 const struct ethtool_ops *ethtool_ops; 694 695 /* Hardware header description */ 696 const struct header_ops *header_ops; 697 698 unsigned int flags; /* interface flags (a la BSD) */ 699 unsigned short gflags; 700 unsigned short priv_flags; /* Like 'flags' but invisible to userspace. */ 701 unsigned short padded; /* How much padding added by alloc_netdev() */ 702 703 unsigned char operstate; /* RFC2863 operstate */ 704 unsigned char link_mode; /* mapping policy to operstate */ 705 706 unsigned mtu; /* interface MTU value */ 707 unsigned short type; /* interface hardware type */ 708 unsigned short hard_header_len; /* hardware hdr length */ 709 710 /* extra head- and tailroom the hardware may need, but not in all cases 711 * can this be guaranteed, especially tailroom. Some cases also use 712 * LL_MAX_HEADER instead to allocate the skb. 713 */ 714 unsigned short needed_headroom; 715 unsigned short needed_tailroom; 716 717 struct net_device *master; /* Pointer to master device of a group, 718 * which this device is member of. 719 */ 720 721 /* Interface address info. */ 722 unsigned char perm_addr[MAX_ADDR_LEN]; /* permanent hw address */ 723 unsigned char addr_len; /* hardware address length */ 724 unsigned short dev_id; /* for shared network cards */ 725 726 spinlock_t addr_list_lock; 727 struct dev_addr_list *uc_list; /* Secondary unicast mac addresses */ 728 int uc_count; /* Number of installed ucasts */ 729 int uc_promisc; 730 struct dev_addr_list *mc_list; /* Multicast mac addresses */ 731 int mc_count; /* Number of installed mcasts */ 732 unsigned int promiscuity; 733 unsigned int allmulti; 734 735 736 /* Protocol specific pointers */ 737 738#ifdef CONFIG_NET_DSA 739 void *dsa_ptr; /* dsa specific data */ 740#endif 741 void *atalk_ptr; /* AppleTalk link */ 742 void *ip_ptr; /* IPv4 specific data */ 743 void *dn_ptr; /* DECnet specific data */ 744 void *ip6_ptr; /* IPv6 specific data */ 745 void *ec_ptr; /* Econet specific data */ 746 void *ax25_ptr; /* AX.25 specific data */ 747 struct wireless_dev *ieee80211_ptr; /* IEEE 802.11 specific data, 748 assign before registering */ 749 750/* 751 * Cache line mostly used on receive path (including eth_type_trans()) 752 */ 753 unsigned long last_rx; /* Time of last Rx */ 754 /* Interface address info used in eth_type_trans() */ 755 unsigned char dev_addr[MAX_ADDR_LEN]; /* hw address, (before bcast 756 because most packets are unicast) */ 757 758 unsigned char broadcast[MAX_ADDR_LEN]; /* hw bcast add */ 759 760 struct netdev_queue rx_queue; 761 762 struct netdev_queue *_tx ____cacheline_aligned_in_smp; 763 764 /* Number of TX queues allocated at alloc_netdev_mq() time */ 765 unsigned int num_tx_queues; 766 767 /* Number of TX queues currently active in device */ 768 unsigned int real_num_tx_queues; 769 770 unsigned long tx_queue_len; /* Max frames per queue allowed */ 771 spinlock_t tx_global_lock; 772/* 773 * One part is mostly used on xmit path (device) 774 */ 775 /* These may be needed for future network-power-down code. */ 776 unsigned long trans_start; /* Time (in jiffies) of last Tx */ 777 778 int watchdog_timeo; /* used by dev_watchdog() */ 779 struct timer_list watchdog_timer; 780 781 /* Number of references to this device */ 782 atomic_t refcnt ____cacheline_aligned_in_smp; 783 784 /* delayed register/unregister */ 785 struct list_head todo_list; 786 /* device index hash chain */ 787 struct hlist_node index_hlist; 788 789 struct net_device *link_watch_next; 790 791 /* register/unregister state machine */ 792 enum { NETREG_UNINITIALIZED=0, 793 NETREG_REGISTERED, /* completed register_netdevice */ 794 NETREG_UNREGISTERING, /* called unregister_netdevice */ 795 NETREG_UNREGISTERED, /* completed unregister todo */ 796 NETREG_RELEASED, /* called free_netdev */ 797 } reg_state; 798 799 /* Called from unregister, can be used to call free_netdev */ 800 void (*destructor)(struct net_device *dev); 801 802#ifdef CONFIG_NETPOLL 803 struct netpoll_info *npinfo; 804#endif 805 806#ifdef CONFIG_NET_NS 807 /* Network namespace this network device is inside */ 808 struct net *nd_net; 809#endif 810 811 /* mid-layer private */ 812 void *ml_priv; 813 814 /* bridge stuff */ 815 struct net_bridge_port *br_port; 816 /* macvlan */ 817 struct macvlan_port *macvlan_port; 818 /* GARP */ 819 struct garp_port *garp_port; 820 821 /* class/net/name entry */ 822 struct device dev; 823 /* space for optional statistics and wireless sysfs groups */ 824 struct attribute_group *sysfs_groups[3]; 825 826 /* rtnetlink link ops */ 827 const struct rtnl_link_ops *rtnl_link_ops; 828 829 /* VLAN feature mask */ 830 unsigned long vlan_features; 831 832 /* for setting kernel sock attribute on TCP connection setup */ 833#define GSO_MAX_SIZE 65536 834 unsigned int gso_max_size; 835 836#ifdef CONFIG_DCB 837 /* Data Center Bridging netlink ops */ 838 struct dcbnl_rtnl_ops *dcbnl_ops; 839#endif 840 841#ifdef CONFIG_COMPAT_NET_DEV_OPS 842 struct { 843 int (*init)(struct net_device *dev); 844 void (*uninit)(struct net_device *dev); 845 int (*open)(struct net_device *dev); 846 int (*stop)(struct net_device *dev); 847 int (*hard_start_xmit) (struct sk_buff *skb, 848 struct net_device *dev); 849 u16 (*select_queue)(struct net_device *dev, 850 struct sk_buff *skb); 851 void (*change_rx_flags)(struct net_device *dev, 852 int flags); 853 void (*set_rx_mode)(struct net_device *dev); 854 void (*set_multicast_list)(struct net_device *dev); 855 int (*set_mac_address)(struct net_device *dev, 856 void *addr); 857 int (*validate_addr)(struct net_device *dev); 858 int (*do_ioctl)(struct net_device *dev, 859 struct ifreq *ifr, int cmd); 860 int (*set_config)(struct net_device *dev, 861 struct ifmap *map); 862 int (*change_mtu)(struct net_device *dev, int new_mtu); 863 int (*neigh_setup)(struct net_device *dev, 864 struct neigh_parms *); 865 void (*tx_timeout) (struct net_device *dev); 866 struct net_device_stats* (*get_stats)(struct net_device *dev); 867 void (*vlan_rx_register)(struct net_device *dev, 868 struct vlan_group *grp); 869 void (*vlan_rx_add_vid)(struct net_device *dev, 870 unsigned short vid); 871 void (*vlan_rx_kill_vid)(struct net_device *dev, 872 unsigned short vid); 873#ifdef CONFIG_NET_POLL_CONTROLLER 874 void (*poll_controller)(struct net_device *dev); 875#endif 876 }; 877#endif 878}; 879#define to_net_dev(d) container_of(d, struct net_device, dev) 880 881#define NETDEV_ALIGN 32 882#define NETDEV_ALIGN_CONST (NETDEV_ALIGN - 1) 883 884static inline 885struct netdev_queue *netdev_get_tx_queue(const struct net_device *dev, 886 unsigned int index) 887{ 888 return &dev->_tx[index]; 889} 890 891static inline void netdev_for_each_tx_queue(struct net_device *dev, 892 void (*f)(struct net_device *, 893 struct netdev_queue *, 894 void *), 895 void *arg) 896{ 897 unsigned int i; 898 899 for (i = 0; i < dev->num_tx_queues; i++) 900 f(dev, &dev->_tx[i], arg); 901} 902 903/* 904 * Net namespace inlines 905 */ 906static inline 907struct net *dev_net(const struct net_device *dev) 908{ 909#ifdef CONFIG_NET_NS 910 return dev->nd_net; 911#else 912 return &init_net; 913#endif 914} 915 916static inline 917void dev_net_set(struct net_device *dev, struct net *net) 918{ 919#ifdef CONFIG_NET_NS 920 release_net(dev->nd_net); 921 dev->nd_net = hold_net(net); 922#endif 923} 924 925static inline bool netdev_uses_dsa_tags(struct net_device *dev) 926{ 927#ifdef CONFIG_NET_DSA_TAG_DSA 928 if (dev->dsa_ptr != NULL) 929 return dsa_uses_dsa_tags(dev->dsa_ptr); 930#endif 931 932 return 0; 933} 934 935static inline bool netdev_uses_trailer_tags(struct net_device *dev) 936{ 937#ifdef CONFIG_NET_DSA_TAG_TRAILER 938 if (dev->dsa_ptr != NULL) 939 return dsa_uses_trailer_tags(dev->dsa_ptr); 940#endif 941 942 return 0; 943} 944 945/** 946 * netdev_priv - access network device private data 947 * @dev: network device 948 * 949 * Get network device private data 950 */ 951static inline void *netdev_priv(const struct net_device *dev) 952{ 953 return (char *)dev + ((sizeof(struct net_device) 954 + NETDEV_ALIGN_CONST) 955 & ~NETDEV_ALIGN_CONST); 956} 957 958/* Set the sysfs physical device reference for the network logical device 959 * if set prior to registration will cause a symlink during initialization. 960 */ 961#define SET_NETDEV_DEV(net, pdev) ((net)->dev.parent = (pdev)) 962 963/** 964 * netif_napi_add - initialize a napi context 965 * @dev: network device 966 * @napi: napi context 967 * @poll: polling function 968 * @weight: default weight 969 * 970 * netif_napi_add() must be used to initialize a napi context prior to calling 971 * *any* of the other napi related functions. 972 */ 973void netif_napi_add(struct net_device *dev, struct napi_struct *napi, 974 int (*poll)(struct napi_struct *, int), int weight); 975 976/** 977 * netif_napi_del - remove a napi context 978 * @napi: napi context 979 * 980 * netif_napi_del() removes a napi context from the network device napi list 981 */ 982void netif_napi_del(struct napi_struct *napi); 983 984struct napi_gro_cb { 985 /* This is non-zero if the packet may be of the same flow. */ 986 int same_flow; 987 988 /* This is non-zero if the packet cannot be merged with the new skb. */ 989 int flush; 990 991 /* Number of segments aggregated. */ 992 int count; 993}; 994 995#define NAPI_GRO_CB(skb) ((struct napi_gro_cb *)(skb)->cb) 996 997struct packet_type { 998 __be16 type; /* This is really htons(ether_type). */ 999 struct net_device *dev; /* NULL is wildcarded here */ 1000 int (*func) (struct sk_buff *, 1001 struct net_device *, 1002 struct packet_type *, 1003 struct net_device *); 1004 struct sk_buff *(*gso_segment)(struct sk_buff *skb, 1005 int features); 1006 int (*gso_send_check)(struct sk_buff *skb); 1007 struct sk_buff **(*gro_receive)(struct sk_buff **head, 1008 struct sk_buff *skb); 1009 int (*gro_complete)(struct sk_buff *skb); 1010 void *af_packet_priv; 1011 struct list_head list; 1012}; 1013 1014#include <linux/interrupt.h> 1015#include <linux/notifier.h> 1016 1017extern rwlock_t dev_base_lock; /* Device list lock */ 1018 1019 1020#define for_each_netdev(net, d) \ 1021 list_for_each_entry(d, &(net)->dev_base_head, dev_list) 1022#define for_each_netdev_safe(net, d, n) \ 1023 list_for_each_entry_safe(d, n, &(net)->dev_base_head, dev_list) 1024#define for_each_netdev_continue(net, d) \ 1025 list_for_each_entry_continue(d, &(net)->dev_base_head, dev_list) 1026#define net_device_entry(lh) list_entry(lh, struct net_device, dev_list) 1027 1028static inline struct net_device *next_net_device(struct net_device *dev) 1029{ 1030 struct list_head *lh; 1031 struct net *net; 1032 1033 net = dev_net(dev); 1034 lh = dev->dev_list.next; 1035 return lh == &net->dev_base_head ? NULL : net_device_entry(lh); 1036} 1037 1038static inline struct net_device *first_net_device(struct net *net) 1039{ 1040 return list_empty(&net->dev_base_head) ? NULL : 1041 net_device_entry(net->dev_base_head.next); 1042} 1043 1044extern int netdev_boot_setup_check(struct net_device *dev); 1045extern unsigned long netdev_boot_base(const char *prefix, int unit); 1046extern struct net_device *dev_getbyhwaddr(struct net *net, unsigned short type, char *hwaddr); 1047extern struct net_device *dev_getfirstbyhwtype(struct net *net, unsigned short type); 1048extern struct net_device *__dev_getfirstbyhwtype(struct net *net, unsigned short type); 1049extern void dev_add_pack(struct packet_type *pt); 1050extern void dev_remove_pack(struct packet_type *pt); 1051extern void __dev_remove_pack(struct packet_type *pt); 1052 1053extern struct net_device *dev_get_by_flags(struct net *net, unsigned short flags, 1054 unsigned short mask); 1055extern struct net_device *dev_get_by_name(struct net *net, const char *name); 1056extern struct net_device *__dev_get_by_name(struct net *net, const char *name); 1057extern int dev_alloc_name(struct net_device *dev, const char *name); 1058extern int dev_open(struct net_device *dev); 1059extern int dev_close(struct net_device *dev); 1060extern void dev_disable_lro(struct net_device *dev); 1061extern int dev_queue_xmit(struct sk_buff *skb); 1062extern int register_netdevice(struct net_device *dev); 1063extern void unregister_netdevice(struct net_device *dev); 1064extern void free_netdev(struct net_device *dev); 1065extern void synchronize_net(void); 1066extern int register_netdevice_notifier(struct notifier_block *nb); 1067extern int unregister_netdevice_notifier(struct notifier_block *nb); 1068extern int call_netdevice_notifiers(unsigned long val, struct net_device *dev); 1069extern struct net_device *dev_get_by_index(struct net *net, int ifindex); 1070extern struct net_device *__dev_get_by_index(struct net *net, int ifindex); 1071extern int dev_restart(struct net_device *dev); 1072#ifdef CONFIG_NETPOLL_TRAP 1073extern int netpoll_trap(void); 1074#endif 1075 1076static inline int dev_hard_header(struct sk_buff *skb, struct net_device *dev, 1077 unsigned short type, 1078 const void *daddr, const void *saddr, 1079 unsigned len) 1080{ 1081 if (!dev->header_ops || !dev->header_ops->create) 1082 return 0; 1083 1084 return dev->header_ops->create(skb, dev, type, daddr, saddr, len); 1085} 1086 1087static inline int dev_parse_header(const struct sk_buff *skb, 1088 unsigned char *haddr) 1089{ 1090 const struct net_device *dev = skb->dev; 1091 1092 if (!dev->header_ops || !dev->header_ops->parse) 1093 return 0; 1094 return dev->header_ops->parse(skb, haddr); 1095} 1096 1097typedef int gifconf_func_t(struct net_device * dev, char __user * bufptr, int len); 1098extern int register_gifconf(unsigned int family, gifconf_func_t * gifconf); 1099static inline int unregister_gifconf(unsigned int family) 1100{ 1101 return register_gifconf(family, NULL); 1102} 1103 1104/* 1105 * Incoming packets are placed on per-cpu queues so that 1106 * no locking is needed. 1107 */ 1108struct softnet_data 1109{ 1110 struct Qdisc *output_queue; 1111 struct sk_buff_head input_pkt_queue; 1112 struct list_head poll_list; 1113 struct sk_buff *completion_queue; 1114 1115 struct napi_struct backlog; 1116#ifdef CONFIG_NET_DMA 1117 struct dma_chan *net_dma; 1118#endif 1119}; 1120 1121DECLARE_PER_CPU(struct softnet_data,softnet_data); 1122 1123#define HAVE_NETIF_QUEUE 1124 1125extern void __netif_schedule(struct Qdisc *q); 1126 1127static inline void netif_schedule_queue(struct netdev_queue *txq) 1128{ 1129 if (!test_bit(__QUEUE_STATE_XOFF, &txq->state)) 1130 __netif_schedule(txq->qdisc); 1131} 1132 1133static inline void netif_tx_schedule_all(struct net_device *dev) 1134{ 1135 unsigned int i; 1136 1137 for (i = 0; i < dev->num_tx_queues; i++) 1138 netif_schedule_queue(netdev_get_tx_queue(dev, i)); 1139} 1140 1141static inline void netif_tx_start_queue(struct netdev_queue *dev_queue) 1142{ 1143 clear_bit(__QUEUE_STATE_XOFF, &dev_queue->state); 1144} 1145 1146/** 1147 * netif_start_queue - allow transmit 1148 * @dev: network device 1149 * 1150 * Allow upper layers to call the device hard_start_xmit routine. 1151 */ 1152static inline void netif_start_queue(struct net_device *dev) 1153{ 1154 netif_tx_start_queue(netdev_get_tx_queue(dev, 0)); 1155} 1156 1157static inline void netif_tx_start_all_queues(struct net_device *dev) 1158{ 1159 unsigned int i; 1160 1161 for (i = 0; i < dev->num_tx_queues; i++) { 1162 struct netdev_queue *txq = netdev_get_tx_queue(dev, i); 1163 netif_tx_start_queue(txq); 1164 } 1165} 1166 1167static inline void netif_tx_wake_queue(struct netdev_queue *dev_queue) 1168{ 1169#ifdef CONFIG_NETPOLL_TRAP 1170 if (netpoll_trap()) { 1171 clear_bit(__QUEUE_STATE_XOFF, &dev_queue->state); 1172 return; 1173 } 1174#endif 1175 if (test_and_clear_bit(__QUEUE_STATE_XOFF, &dev_queue->state)) 1176 __netif_schedule(dev_queue->qdisc); 1177} 1178 1179/** 1180 * netif_wake_queue - restart transmit 1181 * @dev: network device 1182 * 1183 * Allow upper layers to call the device hard_start_xmit routine. 1184 * Used for flow control when transmit resources are available. 1185 */ 1186static inline void netif_wake_queue(struct net_device *dev) 1187{ 1188 netif_tx_wake_queue(netdev_get_tx_queue(dev, 0)); 1189} 1190 1191static inline void netif_tx_wake_all_queues(struct net_device *dev) 1192{ 1193 unsigned int i; 1194 1195 for (i = 0; i < dev->num_tx_queues; i++) { 1196 struct netdev_queue *txq = netdev_get_tx_queue(dev, i); 1197 netif_tx_wake_queue(txq); 1198 } 1199} 1200 1201static inline void netif_tx_stop_queue(struct netdev_queue *dev_queue) 1202{ 1203 set_bit(__QUEUE_STATE_XOFF, &dev_queue->state); 1204} 1205 1206/** 1207 * netif_stop_queue - stop transmitted packets 1208 * @dev: network device 1209 * 1210 * Stop upper layers calling the device hard_start_xmit routine. 1211 * Used for flow control when transmit resources are unavailable. 1212 */ 1213static inline void netif_stop_queue(struct net_device *dev) 1214{ 1215 netif_tx_stop_queue(netdev_get_tx_queue(dev, 0)); 1216} 1217 1218static inline void netif_tx_stop_all_queues(struct net_device *dev) 1219{ 1220 unsigned int i; 1221 1222 for (i = 0; i < dev->num_tx_queues; i++) { 1223 struct netdev_queue *txq = netdev_get_tx_queue(dev, i); 1224 netif_tx_stop_queue(txq); 1225 } 1226} 1227 1228static inline int netif_tx_queue_stopped(const struct netdev_queue *dev_queue) 1229{ 1230 return test_bit(__QUEUE_STATE_XOFF, &dev_queue->state); 1231} 1232 1233/** 1234 * netif_queue_stopped - test if transmit queue is flowblocked 1235 * @dev: network device 1236 * 1237 * Test if transmit queue on device is currently unable to send. 1238 */ 1239static inline int netif_queue_stopped(const struct net_device *dev) 1240{ 1241 return netif_tx_queue_stopped(netdev_get_tx_queue(dev, 0)); 1242} 1243 1244static inline int netif_tx_queue_frozen(const struct netdev_queue *dev_queue) 1245{ 1246 return test_bit(__QUEUE_STATE_FROZEN, &dev_queue->state); 1247} 1248 1249/** 1250 * netif_running - test if up 1251 * @dev: network device 1252 * 1253 * Test if the device has been brought up. 1254 */ 1255static inline int netif_running(const struct net_device *dev) 1256{ 1257 return test_bit(__LINK_STATE_START, &dev->state); 1258} 1259 1260/* 1261 * Routines to manage the subqueues on a device. We only need start 1262 * stop, and a check if it's stopped. All other device management is 1263 * done at the overall netdevice level. 1264 * Also test the device if we're multiqueue. 1265 */ 1266 1267/** 1268 * netif_start_subqueue - allow sending packets on subqueue 1269 * @dev: network device 1270 * @queue_index: sub queue index 1271 * 1272 * Start individual transmit queue of a device with multiple transmit queues. 1273 */ 1274static inline void netif_start_subqueue(struct net_device *dev, u16 queue_index) 1275{ 1276 struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index); 1277 clear_bit(__QUEUE_STATE_XOFF, &txq->state); 1278} 1279 1280/** 1281 * netif_stop_subqueue - stop sending packets on subqueue 1282 * @dev: network device 1283 * @queue_index: sub queue index 1284 * 1285 * Stop individual transmit queue of a device with multiple transmit queues. 1286 */ 1287static inline void netif_stop_subqueue(struct net_device *dev, u16 queue_index) 1288{ 1289 struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index); 1290#ifdef CONFIG_NETPOLL_TRAP 1291 if (netpoll_trap()) 1292 return; 1293#endif 1294 set_bit(__QUEUE_STATE_XOFF, &txq->state); 1295} 1296 1297/** 1298 * netif_subqueue_stopped - test status of subqueue 1299 * @dev: network device 1300 * @queue_index: sub queue index 1301 * 1302 * Check individual transmit queue of a device with multiple transmit queues. 1303 */ 1304static inline int __netif_subqueue_stopped(const struct net_device *dev, 1305 u16 queue_index) 1306{ 1307 struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index); 1308 return test_bit(__QUEUE_STATE_XOFF, &txq->state); 1309} 1310 1311static inline int netif_subqueue_stopped(const struct net_device *dev, 1312 struct sk_buff *skb) 1313{ 1314 return __netif_subqueue_stopped(dev, skb_get_queue_mapping(skb)); 1315} 1316 1317/** 1318 * netif_wake_subqueue - allow sending packets on subqueue 1319 * @dev: network device 1320 * @queue_index: sub queue index 1321 * 1322 * Resume individual transmit queue of a device with multiple transmit queues. 1323 */ 1324static inline void netif_wake_subqueue(struct net_device *dev, u16 queue_index) 1325{ 1326 struct netdev_queue *txq = netdev_get_tx_queue(dev, queue_index); 1327#ifdef CONFIG_NETPOLL_TRAP 1328 if (netpoll_trap()) 1329 return; 1330#endif 1331 if (test_and_clear_bit(__QUEUE_STATE_XOFF, &txq->state)) 1332 __netif_schedule(txq->qdisc); 1333} 1334 1335/** 1336 * netif_is_multiqueue - test if device has multiple transmit queues 1337 * @dev: network device 1338 * 1339 * Check if device has multiple transmit queues 1340 */ 1341static inline int netif_is_multiqueue(const struct net_device *dev) 1342{ 1343 return (dev->num_tx_queues > 1); 1344} 1345 1346/* Use this variant when it is known for sure that it 1347 * is executing from hardware interrupt context or with hardware interrupts 1348 * disabled. 1349 */ 1350extern void dev_kfree_skb_irq(struct sk_buff *skb); 1351 1352/* Use this variant in places where it could be invoked 1353 * from either hardware interrupt or other context, with hardware interrupts 1354 * either disabled or enabled. 1355 */ 1356extern void dev_kfree_skb_any(struct sk_buff *skb); 1357 1358#define HAVE_NETIF_RX 1 1359extern int netif_rx(struct sk_buff *skb); 1360extern int netif_rx_ni(struct sk_buff *skb); 1361#define HAVE_NETIF_RECEIVE_SKB 1 1362extern int netif_receive_skb(struct sk_buff *skb); 1363extern void napi_gro_flush(struct napi_struct *napi); 1364extern int napi_gro_receive(struct napi_struct *napi, 1365 struct sk_buff *skb); 1366extern void netif_nit_deliver(struct sk_buff *skb); 1367extern int dev_valid_name(const char *name); 1368extern int dev_ioctl(struct net *net, unsigned int cmd, void __user *); 1369extern int dev_ethtool(struct net *net, struct ifreq *); 1370extern unsigned dev_get_flags(const struct net_device *); 1371extern int dev_change_flags(struct net_device *, unsigned); 1372extern int dev_change_name(struct net_device *, const char *); 1373extern int dev_set_alias(struct net_device *, const char *, size_t); 1374extern int dev_change_net_namespace(struct net_device *, 1375 struct net *, const char *); 1376extern int dev_set_mtu(struct net_device *, int); 1377extern int dev_set_mac_address(struct net_device *, 1378 struct sockaddr *); 1379extern int dev_hard_start_xmit(struct sk_buff *skb, 1380 struct net_device *dev, 1381 struct netdev_queue *txq); 1382 1383extern int netdev_budget; 1384 1385/* Called by rtnetlink.c:rtnl_unlock() */ 1386extern void netdev_run_todo(void); 1387 1388/** 1389 * dev_put - release reference to device 1390 * @dev: network device 1391 * 1392 * Release reference to device to allow it to be freed. 1393 */ 1394static inline void dev_put(struct net_device *dev) 1395{ 1396 atomic_dec(&dev->refcnt); 1397} 1398 1399/** 1400 * dev_hold - get reference to device 1401 * @dev: network device 1402 * 1403 * Hold reference to device to keep it from being freed. 1404 */ 1405static inline void dev_hold(struct net_device *dev) 1406{ 1407 atomic_inc(&dev->refcnt); 1408} 1409 1410/* Carrier loss detection, dial on demand. The functions netif_carrier_on 1411 * and _off may be called from IRQ context, but it is caller 1412 * who is responsible for serialization of these calls. 1413 * 1414 * The name carrier is inappropriate, these functions should really be 1415 * called netif_lowerlayer_*() because they represent the state of any 1416 * kind of lower layer not just hardware media. 1417 */ 1418 1419extern void linkwatch_fire_event(struct net_device *dev); 1420 1421/** 1422 * netif_carrier_ok - test if carrier present 1423 * @dev: network device 1424 * 1425 * Check if carrier is present on device 1426 */ 1427static inline int netif_carrier_ok(const struct net_device *dev) 1428{ 1429 return !test_bit(__LINK_STATE_NOCARRIER, &dev->state); 1430} 1431 1432extern void __netdev_watchdog_up(struct net_device *dev); 1433 1434extern void netif_carrier_on(struct net_device *dev); 1435 1436extern void netif_carrier_off(struct net_device *dev); 1437 1438/** 1439 * netif_dormant_on - mark device as dormant. 1440 * @dev: network device 1441 * 1442 * Mark device as dormant (as per RFC2863). 1443 * 1444 * The dormant state indicates that the relevant interface is not 1445 * actually in a condition to pass packets (i.e., it is not 'up') but is 1446 * in a "pending" state, waiting for some external event. For "on- 1447 * demand" interfaces, this new state identifies the situation where the 1448 * interface is waiting for events to place it in the up state. 1449 * 1450 */ 1451static inline void netif_dormant_on(struct net_device *dev) 1452{ 1453 if (!test_and_set_bit(__LINK_STATE_DORMANT, &dev->state)) 1454 linkwatch_fire_event(dev); 1455} 1456 1457/** 1458 * netif_dormant_off - set device as not dormant. 1459 * @dev: network device 1460 * 1461 * Device is not in dormant state. 1462 */ 1463static inline void netif_dormant_off(struct net_device *dev) 1464{ 1465 if (test_and_clear_bit(__LINK_STATE_DORMANT, &dev->state)) 1466 linkwatch_fire_event(dev); 1467} 1468 1469/** 1470 * netif_dormant - test if carrier present 1471 * @dev: network device 1472 * 1473 * Check if carrier is present on device 1474 */ 1475static inline int netif_dormant(const struct net_device *dev) 1476{ 1477 return test_bit(__LINK_STATE_DORMANT, &dev->state); 1478} 1479 1480 1481/** 1482 * netif_oper_up - test if device is operational 1483 * @dev: network device 1484 * 1485 * Check if carrier is operational 1486 */ 1487static inline int netif_oper_up(const struct net_device *dev) { 1488 return (dev->operstate == IF_OPER_UP || 1489 dev->operstate == IF_OPER_UNKNOWN /* backward compat */); 1490} 1491 1492/** 1493 * netif_device_present - is device available or removed 1494 * @dev: network device 1495 * 1496 * Check if device has not been removed from system. 1497 */ 1498static inline int netif_device_present(struct net_device *dev) 1499{ 1500 return test_bit(__LINK_STATE_PRESENT, &dev->state); 1501} 1502 1503extern void netif_device_detach(struct net_device *dev); 1504 1505extern void netif_device_attach(struct net_device *dev); 1506 1507/* 1508 * Network interface message level settings 1509 */ 1510#define HAVE_NETIF_MSG 1 1511 1512enum { 1513 NETIF_MSG_DRV = 0x0001, 1514 NETIF_MSG_PROBE = 0x0002, 1515 NETIF_MSG_LINK = 0x0004, 1516 NETIF_MSG_TIMER = 0x0008, 1517 NETIF_MSG_IFDOWN = 0x0010, 1518 NETIF_MSG_IFUP = 0x0020, 1519 NETIF_MSG_RX_ERR = 0x0040, 1520 NETIF_MSG_TX_ERR = 0x0080, 1521 NETIF_MSG_TX_QUEUED = 0x0100, 1522 NETIF_MSG_INTR = 0x0200, 1523 NETIF_MSG_TX_DONE = 0x0400, 1524 NETIF_MSG_RX_STATUS = 0x0800, 1525 NETIF_MSG_PKTDATA = 0x1000, 1526 NETIF_MSG_HW = 0x2000, 1527 NETIF_MSG_WOL = 0x4000, 1528}; 1529 1530#define netif_msg_drv(p) ((p)->msg_enable & NETIF_MSG_DRV) 1531#define netif_msg_probe(p) ((p)->msg_enable & NETIF_MSG_PROBE) 1532#define netif_msg_link(p) ((p)->msg_enable & NETIF_MSG_LINK) 1533#define netif_msg_timer(p) ((p)->msg_enable & NETIF_MSG_TIMER) 1534#define netif_msg_ifdown(p) ((p)->msg_enable & NETIF_MSG_IFDOWN) 1535#define netif_msg_ifup(p) ((p)->msg_enable & NETIF_MSG_IFUP) 1536#define netif_msg_rx_err(p) ((p)->msg_enable & NETIF_MSG_RX_ERR) 1537#define netif_msg_tx_err(p) ((p)->msg_enable & NETIF_MSG_TX_ERR) 1538#define netif_msg_tx_queued(p) ((p)->msg_enable & NETIF_MSG_TX_QUEUED) 1539#define netif_msg_intr(p) ((p)->msg_enable & NETIF_MSG_INTR) 1540#define netif_msg_tx_done(p) ((p)->msg_enable & NETIF_MSG_TX_DONE) 1541#define netif_msg_rx_status(p) ((p)->msg_enable & NETIF_MSG_RX_STATUS) 1542#define netif_msg_pktdata(p) ((p)->msg_enable & NETIF_MSG_PKTDATA) 1543#define netif_msg_hw(p) ((p)->msg_enable & NETIF_MSG_HW) 1544#define netif_msg_wol(p) ((p)->msg_enable & NETIF_MSG_WOL) 1545 1546static inline u32 netif_msg_init(int debug_value, int default_msg_enable_bits) 1547{ 1548 /* use default */ 1549 if (debug_value < 0 || debug_value >= (sizeof(u32) * 8)) 1550 return default_msg_enable_bits; 1551 if (debug_value == 0) /* no output */ 1552 return 0; 1553 /* set low N bits */ 1554 return (1 << debug_value) - 1; 1555} 1556 1557/* Test if receive needs to be scheduled but only if up */ 1558static inline int netif_rx_schedule_prep(struct napi_struct *napi) 1559{ 1560 return napi_schedule_prep(napi); 1561} 1562 1563/* Add interface to tail of rx poll list. This assumes that _prep has 1564 * already been called and returned 1. 1565 */ 1566static inline void __netif_rx_schedule(struct napi_struct *napi) 1567{ 1568 __napi_schedule(napi); 1569} 1570 1571/* Try to reschedule poll. Called by irq handler. */ 1572 1573static inline void netif_rx_schedule(struct napi_struct *napi) 1574{ 1575 if (netif_rx_schedule_prep(napi)) 1576 __netif_rx_schedule(napi); 1577} 1578 1579/* Try to reschedule poll. Called by dev->poll() after netif_rx_complete(). */ 1580static inline int netif_rx_reschedule(struct napi_struct *napi) 1581{ 1582 if (napi_schedule_prep(napi)) { 1583 __netif_rx_schedule(napi); 1584 return 1; 1585 } 1586 return 0; 1587} 1588 1589/* same as netif_rx_complete, except that local_irq_save(flags) 1590 * has already been issued 1591 */ 1592static inline void __netif_rx_complete(struct napi_struct *napi) 1593{ 1594 __napi_complete(napi); 1595} 1596 1597/* Remove interface from poll list: it must be in the poll list 1598 * on current cpu. This primitive is called by dev->poll(), when 1599 * it completes the work. The device cannot be out of poll list at this 1600 * moment, it is BUG(). 1601 */ 1602static inline void netif_rx_complete(struct napi_struct *napi) 1603{ 1604 napi_complete(napi); 1605} 1606 1607static inline void __netif_tx_lock(struct netdev_queue *txq, int cpu) 1608{ 1609 spin_lock(&txq->_xmit_lock); 1610 txq->xmit_lock_owner = cpu; 1611} 1612 1613static inline void __netif_tx_lock_bh(struct netdev_queue *txq) 1614{ 1615 spin_lock_bh(&txq->_xmit_lock); 1616 txq->xmit_lock_owner = smp_processor_id(); 1617} 1618 1619static inline int __netif_tx_trylock(struct netdev_queue *txq) 1620{ 1621 int ok = spin_trylock(&txq->_xmit_lock); 1622 if (likely(ok)) 1623 txq->xmit_lock_owner = smp_processor_id(); 1624 return ok; 1625} 1626 1627static inline void __netif_tx_unlock(struct netdev_queue *txq) 1628{ 1629 txq->xmit_lock_owner = -1; 1630 spin_unlock(&txq->_xmit_lock); 1631} 1632 1633static inline void __netif_tx_unlock_bh(struct netdev_queue *txq) 1634{ 1635 txq->xmit_lock_owner = -1; 1636 spin_unlock_bh(&txq->_xmit_lock); 1637} 1638 1639/** 1640 * netif_tx_lock - grab network device transmit lock 1641 * @dev: network device 1642 * 1643 * Get network device transmit lock 1644 */ 1645static inline void netif_tx_lock(struct net_device *dev) 1646{ 1647 unsigned int i; 1648 int cpu; 1649 1650 spin_lock(&dev->tx_global_lock); 1651 cpu = smp_processor_id(); 1652 for (i = 0; i < dev->num_tx_queues; i++) { 1653 struct netdev_queue *txq = netdev_get_tx_queue(dev, i); 1654 1655 /* We are the only thread of execution doing a 1656 * freeze, but we have to grab the _xmit_lock in 1657 * order to synchronize with threads which are in 1658 * the ->hard_start_xmit() handler and already 1659 * checked the frozen bit. 1660 */ 1661 __netif_tx_lock(txq, cpu); 1662 set_bit(__QUEUE_STATE_FROZEN, &txq->state); 1663 __netif_tx_unlock(txq); 1664 } 1665} 1666 1667static inline void netif_tx_lock_bh(struct net_device *dev) 1668{ 1669 local_bh_disable(); 1670 netif_tx_lock(dev); 1671} 1672 1673static inline void netif_tx_unlock(struct net_device *dev) 1674{ 1675 unsigned int i; 1676 1677 for (i = 0; i < dev->num_tx_queues; i++) { 1678 struct netdev_queue *txq = netdev_get_tx_queue(dev, i); 1679 1680 /* No need to grab the _xmit_lock here. If the 1681 * queue is not stopped for another reason, we 1682 * force a schedule. 1683 */ 1684 clear_bit(__QUEUE_STATE_FROZEN, &txq->state); 1685 if (!test_bit(__QUEUE_STATE_XOFF, &txq->state)) 1686 __netif_schedule(txq->qdisc); 1687 } 1688 spin_unlock(&dev->tx_global_lock); 1689} 1690 1691static inline void netif_tx_unlock_bh(struct net_device *dev) 1692{ 1693 netif_tx_unlock(dev); 1694 local_bh_enable(); 1695} 1696 1697#define HARD_TX_LOCK(dev, txq, cpu) { \ 1698 if ((dev->features & NETIF_F_LLTX) == 0) { \ 1699 __netif_tx_lock(txq, cpu); \ 1700 } \ 1701} 1702 1703#define HARD_TX_UNLOCK(dev, txq) { \ 1704 if ((dev->features & NETIF_F_LLTX) == 0) { \ 1705 __netif_tx_unlock(txq); \ 1706 } \ 1707} 1708 1709static inline void netif_tx_disable(struct net_device *dev) 1710{ 1711 unsigned int i; 1712 int cpu; 1713 1714 local_bh_disable(); 1715 cpu = smp_processor_id(); 1716 for (i = 0; i < dev->num_tx_queues; i++) { 1717 struct netdev_queue *txq = netdev_get_tx_queue(dev, i); 1718 1719 __netif_tx_lock(txq, cpu); 1720 netif_tx_stop_queue(txq); 1721 __netif_tx_unlock(txq); 1722 } 1723 local_bh_enable(); 1724} 1725 1726static inline void netif_addr_lock(struct net_device *dev) 1727{ 1728 spin_lock(&dev->addr_list_lock); 1729} 1730 1731static inline void netif_addr_lock_bh(struct net_device *dev) 1732{ 1733 spin_lock_bh(&dev->addr_list_lock); 1734} 1735 1736static inline void netif_addr_unlock(struct net_device *dev) 1737{ 1738 spin_unlock(&dev->addr_list_lock); 1739} 1740 1741static inline void netif_addr_unlock_bh(struct net_device *dev) 1742{ 1743 spin_unlock_bh(&dev->addr_list_lock); 1744} 1745 1746/* These functions live elsewhere (drivers/net/net_init.c, but related) */ 1747 1748extern void ether_setup(struct net_device *dev); 1749 1750/* Support for loadable net-drivers */ 1751extern struct net_device *alloc_netdev_mq(int sizeof_priv, const char *name, 1752 void (*setup)(struct net_device *), 1753 unsigned int queue_count); 1754#define alloc_netdev(sizeof_priv, name, setup) \ 1755 alloc_netdev_mq(sizeof_priv, name, setup, 1) 1756extern int register_netdev(struct net_device *dev); 1757extern void unregister_netdev(struct net_device *dev); 1758/* Functions used for secondary unicast and multicast support */ 1759extern void dev_set_rx_mode(struct net_device *dev); 1760extern void __dev_set_rx_mode(struct net_device *dev); 1761extern int dev_unicast_delete(struct net_device *dev, void *addr, int alen); 1762extern int dev_unicast_add(struct net_device *dev, void *addr, int alen); 1763extern int dev_unicast_sync(struct net_device *to, struct net_device *from); 1764extern void dev_unicast_unsync(struct net_device *to, struct net_device *from); 1765extern int dev_mc_delete(struct net_device *dev, void *addr, int alen, int all); 1766extern int dev_mc_add(struct net_device *dev, void *addr, int alen, int newonly); 1767extern int dev_mc_sync(struct net_device *to, struct net_device *from); 1768extern void dev_mc_unsync(struct net_device *to, struct net_device *from); 1769extern int __dev_addr_delete(struct dev_addr_list **list, int *count, void *addr, int alen, int all); 1770extern int __dev_addr_add(struct dev_addr_list **list, int *count, void *addr, int alen, int newonly); 1771extern int __dev_addr_sync(struct dev_addr_list **to, int *to_count, struct dev_addr_list **from, int *from_count); 1772extern void __dev_addr_unsync(struct dev_addr_list **to, int *to_count, struct dev_addr_list **from, int *from_count); 1773extern int dev_set_promiscuity(struct net_device *dev, int inc); 1774extern int dev_set_allmulti(struct net_device *dev, int inc); 1775extern void netdev_state_change(struct net_device *dev); 1776extern void netdev_bonding_change(struct net_device *dev); 1777extern void netdev_features_change(struct net_device *dev); 1778/* Load a device via the kmod */ 1779extern void dev_load(struct net *net, const char *name); 1780extern void dev_mcast_init(void); 1781extern const struct net_device_stats *dev_get_stats(struct net_device *dev); 1782 1783extern int netdev_max_backlog; 1784extern int weight_p; 1785extern int netdev_set_master(struct net_device *dev, struct net_device *master); 1786extern int skb_checksum_help(struct sk_buff *skb); 1787extern struct sk_buff *skb_gso_segment(struct sk_buff *skb, int features); 1788#ifdef CONFIG_BUG 1789extern void netdev_rx_csum_fault(struct net_device *dev); 1790#else 1791static inline void netdev_rx_csum_fault(struct net_device *dev) 1792{ 1793} 1794#endif 1795/* rx skb timestamps */ 1796extern void net_enable_timestamp(void); 1797extern void net_disable_timestamp(void); 1798 1799#ifdef CONFIG_PROC_FS 1800extern void *dev_seq_start(struct seq_file *seq, loff_t *pos); 1801extern void *dev_seq_next(struct seq_file *seq, void *v, loff_t *pos); 1802extern void dev_seq_stop(struct seq_file *seq, void *v); 1803#endif 1804 1805extern int netdev_class_create_file(struct class_attribute *class_attr); 1806extern void netdev_class_remove_file(struct class_attribute *class_attr); 1807 1808extern char *netdev_drivername(const struct net_device *dev, char *buffer, int len); 1809 1810extern void linkwatch_run_queue(void); 1811 1812unsigned long netdev_increment_features(unsigned long all, unsigned long one, 1813 unsigned long mask); 1814unsigned long netdev_fix_features(unsigned long features, const char *name); 1815 1816static inline int net_gso_ok(int features, int gso_type) 1817{ 1818 int feature = gso_type << NETIF_F_GSO_SHIFT; 1819 return (features & feature) == feature; 1820} 1821 1822static inline int skb_gso_ok(struct sk_buff *skb, int features) 1823{ 1824 return net_gso_ok(features, skb_shinfo(skb)->gso_type); 1825} 1826 1827static inline int netif_needs_gso(struct net_device *dev, struct sk_buff *skb) 1828{ 1829 return skb_is_gso(skb) && 1830 (!skb_gso_ok(skb, dev->features) || 1831 (skb_shinfo(skb)->frag_list && 1832 !(dev->features & NETIF_F_FRAGLIST)) || 1833 unlikely(skb->ip_summed != CHECKSUM_PARTIAL)); 1834} 1835 1836static inline void netif_set_gso_max_size(struct net_device *dev, 1837 unsigned int size) 1838{ 1839 dev->gso_max_size = size; 1840} 1841 1842/* On bonding slaves other than the currently active slave, suppress 1843 * duplicates except for 802.3ad ETH_P_SLOW, alb non-mcast/bcast, and 1844 * ARP on active-backup slaves with arp_validate enabled. 1845 */ 1846static inline int skb_bond_should_drop(struct sk_buff *skb) 1847{ 1848 struct net_device *dev = skb->dev; 1849 struct net_device *master = dev->master; 1850 1851 if (master) { 1852 if (master->priv_flags & IFF_MASTER_ARPMON) 1853 dev->last_rx = jiffies; 1854 1855 if (dev->priv_flags & IFF_SLAVE_INACTIVE) { 1856 if ((dev->priv_flags & IFF_SLAVE_NEEDARP) && 1857 skb->protocol == __constant_htons(ETH_P_ARP)) 1858 return 0; 1859 1860 if (master->priv_flags & IFF_MASTER_ALB) { 1861 if (skb->pkt_type != PACKET_BROADCAST && 1862 skb->pkt_type != PACKET_MULTICAST) 1863 return 0; 1864 } 1865 if (master->priv_flags & IFF_MASTER_8023AD && 1866 skb->protocol == __constant_htons(ETH_P_SLOW)) 1867 return 0; 1868 1869 return 1; 1870 } 1871 } 1872 return 0; 1873} 1874 1875extern struct pernet_operations __net_initdata loopback_net_ops; 1876#endif /* __KERNEL__ */ 1877 1878#endif /* _LINUX_DEV_H */