net: kdoc struct net_device flags and priv_flags
We have documentation for these flags but they're scattered all over the place. #defines don't allow documentation to be written easily so to help to start bringing some documentation together use the enums kdoc practice but keep the defines to allow userspace to be able to #ifdef them. I've verified the same values are assigned before and after with a simple userspace test program [0] and checksumming the output. [0] http://drvbp1.linux-foundation.org/~mcgrof/kdoc/netdev_flags/ mcgrof@gnat ~/tmp $ ./check-flags | sha1sum 0ec5b6b1840aa3bb9ce464e61c564820871c92c3 - Cc: netdev@vger.kernel.org Cc: linux-kernel@vger.kernel.org Cc: Ben Hutchings <ben@decadent.org.uk> Cc: Florian Fainelli <f.fainelli@gmail.com> Cc: David Miller <davem@davemloft.net> Signed-off-by: Luis R. Rodriguez <mcgrof@suse.com> Signed-off-by: David S. Miller <davem@davemloft.net>
This commit is contained in:
Luis R. Rodriguez
David S. Miller
parent
118ce7ab97
commit
589f5816f3
|
|
@ -27,64 +27,173 @@
|
||||||
#define IFALIASZ 256
|
#define IFALIASZ 256
|
||||||
#include <linux/hdlc/ioctl.h>
|
#include <linux/hdlc/ioctl.h>
|
||||||
|
|
||||||
/* Standard interface flags (netdevice->flags). */
|
/**
|
||||||
#define IFF_UP 0x1 /* interface is up */
|
* enum net_device_flags - &struct net_device flags
|
||||||
#define IFF_BROADCAST 0x2 /* broadcast address valid */
|
*
|
||||||
#define IFF_DEBUG 0x4 /* turn on debugging */
|
* These are the &struct net_device flags, they can be set by drivers, the
|
||||||
#define IFF_LOOPBACK 0x8 /* is a loopback net */
|
* kernel and some can be triggered by userspace. Userspace can query and
|
||||||
#define IFF_POINTOPOINT 0x10 /* interface is has p-p link */
|
* set these flags using userspace utilities but there is also a sysfs
|
||||||
#define IFF_NOTRAILERS 0x20 /* avoid use of trailers */
|
* entry available for all dev flags which can be queried and set. These flags
|
||||||
#define IFF_RUNNING 0x40 /* interface RFC2863 OPER_UP */
|
* are shared for all types of net_devices. The sysfs entries are available
|
||||||
#define IFF_NOARP 0x80 /* no ARP protocol */
|
* via /sys/class/net/<dev>/flags. Flags which can be toggled through sysfs
|
||||||
#define IFF_PROMISC 0x100 /* receive all packets */
|
* are annotated below, note that only a few flags can be toggled and some
|
||||||
#define IFF_ALLMULTI 0x200 /* receive all multicast packets*/
|
* other flags are always always preserved from the original net_device flags
|
||||||
|
* even if you try to set them via sysfs. Flags which are always preserved
|
||||||
|
* are kept under the flag grouping @IFF_VOLATILE. Flags which are volatile
|
||||||
|
* are annotated below as such.
|
||||||
|
*
|
||||||
|
* You should have a pretty good reason to be extending these flags.
|
||||||
|
*
|
||||||
|
* @IFF_UP: interface is up. Can be toggled through sysfs.
|
||||||
|
* @IFF_BROADCAST: broadcast address valid. Volatile.
|
||||||
|
* @IFF_DEBUG: turn on debugging. Can be toggled through sysfs.
|
||||||
|
* @IFF_LOOPBACK: is a loopback net. Volatile.
|
||||||
|
* @IFF_POINTOPOINT: interface is has p-p link. Volatile.
|
||||||
|
* @IFF_NOTRAILERS: avoid use of trailers. Can be toggled through sysfs.
|
||||||
|
* Volatile.
|
||||||
|
* @IFF_RUNNING: interface RFC2863 OPER_UP. Volatile.
|
||||||
|
* @IFF_NOARP: no ARP protocol. Can be toggled through sysfs. Volatile.
|
||||||
|
* @IFF_PROMISC: receive all packets. Can be toggled through sysfs.
|
||||||
|
* @IFF_ALLMULTI: receive all multicast packets. Can be toggled through
|
||||||
|
* sysfs.
|
||||||
|
* @IFF_MASTER: master of a load balancer. Volatile.
|
||||||
|
* @IFF_SLAVE: slave of a load balancer. Volatile.
|
||||||
|
* @IFF_MULTICAST: Supports multicast. Can be toggled through sysfs.
|
||||||
|
* @IFF_PORTSEL: can set media type. Can be toggled through sysfs.
|
||||||
|
* @IFF_AUTOMEDIA: auto media select active. Can be toggled through sysfs.
|
||||||
|
* @IFF_DYNAMIC: dialup device with changing addresses. Can be toggled
|
||||||
|
* through sysfs.
|
||||||
|
* @IFF_LOWER_UP: driver signals L1 up. Volatile.
|
||||||
|
* @IFF_DORMANT: driver signals dormant. Volatile.
|
||||||
|
* @IFF_ECHO: echo sent packets. Volatile.
|
||||||
|
*/
|
||||||
|
enum net_device_flags {
|
||||||
|
IFF_UP = 1<<0, /* sysfs */
|
||||||
|
IFF_BROADCAST = 1<<1, /* volatile */
|
||||||
|
IFF_DEBUG = 1<<2, /* sysfs */
|
||||||
|
IFF_LOOPBACK = 1<<3, /* volatile */
|
||||||
|
IFF_POINTOPOINT = 1<<4, /* volatile */
|
||||||
|
IFF_NOTRAILERS = 1<<5, /* sysfs */
|
||||||
|
IFF_RUNNING = 1<<6, /* volatile */
|
||||||
|
IFF_NOARP = 1<<7, /* sysfs */
|
||||||
|
IFF_PROMISC = 1<<8, /* sysfs */
|
||||||
|
IFF_ALLMULTI = 1<<9, /* sysfs */
|
||||||
|
IFF_MASTER = 1<<10, /* volatile */
|
||||||
|
IFF_SLAVE = 1<<11, /* volatile */
|
||||||
|
IFF_MULTICAST = 1<<12, /* sysfs */
|
||||||
|
IFF_PORTSEL = 1<<13, /* sysfs */
|
||||||
|
IFF_AUTOMEDIA = 1<<14, /* sysfs */
|
||||||
|
IFF_DYNAMIC = 1<<15, /* sysfs */
|
||||||
|
IFF_LOWER_UP = 1<<16, /* volatile */
|
||||||
|
IFF_DORMANT = 1<<17, /* volatile */
|
||||||
|
IFF_ECHO = 1<<18, /* volatile */
|
||||||
|
};
|
||||||
|
|
||||||
#define IFF_MASTER 0x400 /* master of a load balancer */
|
#define IFF_UP IFF_UP
|
||||||
#define IFF_SLAVE 0x800 /* slave of a load balancer */
|
#define IFF_BROADCAST IFF_BROADCAST
|
||||||
|
#define IFF_DEBUG IFF_DEBUG
|
||||||
#define IFF_MULTICAST 0x1000 /* Supports multicast */
|
#define IFF_LOOPBACK IFF_LOOPBACK
|
||||||
|
#define IFF_POINTOPOINT IFF_POINTOPOINT
|
||||||
#define IFF_PORTSEL 0x2000 /* can set media type */
|
#define IFF_NOTRAILERS IFF_NOTRAILERS
|
||||||
#define IFF_AUTOMEDIA 0x4000 /* auto media select active */
|
#define IFF_RUNNING IFF_RUNNING
|
||||||
#define IFF_DYNAMIC 0x8000 /* dialup device with changing addresses*/
|
#define IFF_NOARP IFF_NOARP
|
||||||
|
#define IFF_PROMISC IFF_PROMISC
|
||||||
#define IFF_LOWER_UP 0x10000 /* driver signals L1 up */
|
#define IFF_ALLMULTI IFF_ALLMULTI
|
||||||
#define IFF_DORMANT 0x20000 /* driver signals dormant */
|
#define IFF_MASTER IFF_MASTER
|
||||||
|
#define IFF_SLAVE IFF_SLAVE
|
||||||
#define IFF_ECHO 0x40000 /* echo sent packets */
|
#define IFF_MULTICAST IFF_MULTICAST
|
||||||
|
#define IFF_PORTSEL IFF_PORTSEL
|
||||||
|
#define IFF_AUTOMEDIA IFF_AUTOMEDIA
|
||||||
|
#define IFF_DYNAMIC IFF_DYNAMIC
|
||||||
|
#define IFF_LOWER_UP IFF_LOWER_UP
|
||||||
|
#define IFF_DORMANT IFF_DORMANT
|
||||||
|
#define IFF_ECHO IFF_ECHO
|
||||||
|
|
||||||
#define IFF_VOLATILE (IFF_LOOPBACK|IFF_POINTOPOINT|IFF_BROADCAST|IFF_ECHO|\
|
#define IFF_VOLATILE (IFF_LOOPBACK|IFF_POINTOPOINT|IFF_BROADCAST|IFF_ECHO|\
|
||||||
IFF_MASTER|IFF_SLAVE|IFF_RUNNING|IFF_LOWER_UP|IFF_DORMANT)
|
IFF_MASTER|IFF_SLAVE|IFF_RUNNING|IFF_LOWER_UP|IFF_DORMANT)
|
||||||
|
|
||||||
/* Private (from user) interface flags (netdevice->priv_flags). */
|
/**
|
||||||
#define IFF_802_1Q_VLAN 0x1 /* 802.1Q VLAN device. */
|
* enum net_device_priv_flags - &struct net_device priv_flags
|
||||||
#define IFF_EBRIDGE 0x2 /* Ethernet bridging device. */
|
*
|
||||||
#define IFF_SLAVE_INACTIVE 0x4 /* bonding slave not the curr. active */
|
* These are the &struct net_device, they are only set internally
|
||||||
#define IFF_MASTER_8023AD 0x8 /* bonding master, 802.3ad. */
|
* by drivers and used in the kernel. These flags are invisible to
|
||||||
#define IFF_MASTER_ALB 0x10 /* bonding master, balance-alb. */
|
* userspace, this means that the order of these flags can change
|
||||||
#define IFF_BONDING 0x20 /* bonding master or slave */
|
* during any kernel release.
|
||||||
#define IFF_SLAVE_NEEDARP 0x40 /* need ARPs for validation */
|
*
|
||||||
#define IFF_ISATAP 0x80 /* ISATAP interface (RFC4214) */
|
* You should have a pretty good reason to be extending these flags.
|
||||||
#define IFF_MASTER_ARPMON 0x100 /* bonding master, ARP mon in use */
|
*
|
||||||
#define IFF_WAN_HDLC 0x200 /* WAN HDLC device */
|
* @IFF_802_1Q_VLAN: 802.1Q VLAN device
|
||||||
#define IFF_XMIT_DST_RELEASE 0x400 /* dev_hard_start_xmit() is allowed to
|
* @IFF_EBRIDGE: Ethernet bridging device
|
||||||
* release skb->dst
|
* @IFF_SLAVE_INACTIVE: bonding slave not the curr. active
|
||||||
*/
|
* @IFF_MASTER_8023AD: bonding master, 802.3ad
|
||||||
#define IFF_DONT_BRIDGE 0x800 /* disallow bridging this ether dev */
|
* @IFF_MASTER_ALB: bonding master, balance-alb
|
||||||
#define IFF_DISABLE_NETPOLL 0x1000 /* disable netpoll at run-time */
|
* @IFF_BONDING: bonding master or slave
|
||||||
#define IFF_MACVLAN_PORT 0x2000 /* device used as macvlan port */
|
* @IFF_SLAVE_NEEDARP: need ARPs for validation
|
||||||
#define IFF_BRIDGE_PORT 0x4000 /* device used as bridge port */
|
* @IFF_ISATAP: ISATAP interface (RFC4214)
|
||||||
#define IFF_OVS_DATAPATH 0x8000 /* device used as Open vSwitch
|
* @IFF_MASTER_ARPMON: bonding master, ARP mon in use
|
||||||
* datapath port */
|
* @IFF_WAN_HDLC: WAN HDLC device
|
||||||
#define IFF_TX_SKB_SHARING 0x10000 /* The interface supports sharing
|
* @IFF_XMIT_DST_RELEASE: dev_hard_start_xmit() is allowed to
|
||||||
* skbs on transmit */
|
* release skb->dst
|
||||||
#define IFF_UNICAST_FLT 0x20000 /* Supports unicast filtering */
|
* @IFF_DONT_BRIDGE: disallow bridging this ether dev
|
||||||
#define IFF_TEAM_PORT 0x40000 /* device used as team port */
|
* @IFF_DISABLE_NETPOLL: disable netpoll at run-time
|
||||||
#define IFF_SUPP_NOFCS 0x80000 /* device supports sending custom FCS */
|
* @IFF_MACVLAN_PORT: device used as macvlan port
|
||||||
#define IFF_LIVE_ADDR_CHANGE 0x100000 /* device supports hardware address
|
* @IFF_BRIDGE_PORT: device used as bridge port
|
||||||
* change when it's running */
|
* @IFF_OVS_DATAPATH: device used as Open vSwitch datapath port
|
||||||
#define IFF_MACVLAN 0x200000 /* Macvlan device */
|
* @IFF_TX_SKB_SHARING: The interface supports sharing skbs on transmit
|
||||||
|
* @IFF_UNICAST_FLT: Supports unicast filtering
|
||||||
|
* @IFF_TEAM_PORT: device used as team port
|
||||||
|
* @IFF_SUPP_NOFCS: device supports sending custom FCS
|
||||||
|
* @IFF_LIVE_ADDR_CHANGE: device supports hardware address
|
||||||
|
* change when it's running
|
||||||
|
* @IFF_MACVLAN: Macvlan device
|
||||||
|
*/
|
||||||
|
enum netdev_priv_flags {
|
||||||
|
IFF_802_1Q_VLAN = 1<<0,
|
||||||
|
IFF_EBRIDGE = 1<<1,
|
||||||
|
IFF_SLAVE_INACTIVE = 1<<2,
|
||||||
|
IFF_MASTER_8023AD = 1<<3,
|
||||||
|
IFF_MASTER_ALB = 1<<4,
|
||||||
|
IFF_BONDING = 1<<5,
|
||||||
|
IFF_SLAVE_NEEDARP = 1<<6,
|
||||||
|
IFF_ISATAP = 1<<7,
|
||||||
|
IFF_MASTER_ARPMON = 1<<8,
|
||||||
|
IFF_WAN_HDLC = 1<<9,
|
||||||
|
IFF_XMIT_DST_RELEASE = 1<<10,
|
||||||
|
IFF_DONT_BRIDGE = 1<<11,
|
||||||
|
IFF_DISABLE_NETPOLL = 1<<12,
|
||||||
|
IFF_MACVLAN_PORT = 1<<13,
|
||||||
|
IFF_BRIDGE_PORT = 1<<14,
|
||||||
|
IFF_OVS_DATAPATH = 1<<15,
|
||||||
|
IFF_TX_SKB_SHARING = 1<<16,
|
||||||
|
IFF_UNICAST_FLT = 1<<17,
|
||||||
|
IFF_TEAM_PORT = 1<<18,
|
||||||
|
IFF_SUPP_NOFCS = 1<<19,
|
||||||
|
IFF_LIVE_ADDR_CHANGE = 1<<20,
|
||||||
|
IFF_MACVLAN = 1<<21,
|
||||||
|
};
|
||||||
|
|
||||||
|
#define IFF_802_1Q_VLAN IFF_802_1Q_VLAN
|
||||||
|
#define IFF_EBRIDGE IFF_EBRIDGE
|
||||||
|
#define IFF_SLAVE_INACTIVE IFF_SLAVE_INACTIVE
|
||||||
|
#define IFF_MASTER_8023AD IFF_MASTER_8023AD
|
||||||
|
#define IFF_MASTER_ALB IFF_MASTER_ALB
|
||||||
|
#define IFF_BONDING IFF_BONDING
|
||||||
|
#define IFF_SLAVE_NEEDARP IFF_SLAVE_NEEDARP
|
||||||
|
#define IFF_ISATAP IFF_ISATAP
|
||||||
|
#define IFF_MASTER_ARPMON IFF_MASTER_ARPMON
|
||||||
|
#define IFF_WAN_HDLC IFF_WAN_HDLC
|
||||||
|
#define IFF_XMIT_DST_RELEASE IFF_XMIT_DST_RELEASE
|
||||||
|
#define IFF_DONT_BRIDGE IFF_DONT_BRIDGE
|
||||||
|
#define IFF_DISABLE_NETPOLL IFF_DISABLE_NETPOLL
|
||||||
|
#define IFF_MACVLAN_PORT IFF_MACVLAN_PORT
|
||||||
|
#define IFF_BRIDGE_PORT IFF_BRIDGE_PORT
|
||||||
|
#define IFF_OVS_DATAPATH IFF_OVS_DATAPATH
|
||||||
|
#define IFF_TX_SKB_SHARING IFF_TX_SKB_SHARING
|
||||||
|
#define IFF_UNICAST_FLT IFF_UNICAST_FLT
|
||||||
|
#define IFF_TEAM_PORT IFF_TEAM_PORT
|
||||||
|
#define IFF_SUPP_NOFCS IFF_SUPP_NOFCS
|
||||||
|
#define IFF_LIVE_ADDR_CHANGE IFF_LIVE_ADDR_CHANGE
|
||||||
|
#define IFF_MACVLAN IFF_MACVLAN
|
||||||
|
|
||||||
#define IF_GET_IFACE 0x0001 /* for querying only */
|
#define IF_GET_IFACE 0x0001 /* for querying only */
|
||||||
#define IF_GET_PROTO 0x0002
|
#define IF_GET_PROTO 0x0002
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue