Home | History | Annotate | Download | only in linux
      1 /*
      2  *	Linux ethernet bridge
      3  *
      4  *	Authors:
      5  *	Lennert Buytenhek		<buytenh (at) gnu.org>
      6  *
      7  *	This program is free software; you can redistribute it and/or
      8  *	modify it under the terms of the GNU General Public License
      9  *	as published by the Free Software Foundation; either version
     10  *	2 of the License, or (at your option) any later version.
     11  */
     12 
     13 #ifndef _UAPI_LINUX_IF_BRIDGE_H
     14 #define _UAPI_LINUX_IF_BRIDGE_H
     15 
     16 #include <linux/types.h>
     17 #include <linux/if_ether.h>
     18 #include <linux/in6.h>
     19 
     20 #define SYSFS_BRIDGE_ATTR	"bridge"
     21 #define SYSFS_BRIDGE_FDB	"brforward"
     22 #define SYSFS_BRIDGE_PORT_SUBDIR "brif"
     23 #define SYSFS_BRIDGE_PORT_ATTR	"brport"
     24 #define SYSFS_BRIDGE_PORT_LINK	"bridge"
     25 
     26 #define BRCTL_VERSION 1
     27 
     28 #define BRCTL_GET_VERSION 0
     29 #define BRCTL_GET_BRIDGES 1
     30 #define BRCTL_ADD_BRIDGE 2
     31 #define BRCTL_DEL_BRIDGE 3
     32 #define BRCTL_ADD_IF 4
     33 #define BRCTL_DEL_IF 5
     34 #define BRCTL_GET_BRIDGE_INFO 6
     35 #define BRCTL_GET_PORT_LIST 7
     36 #define BRCTL_SET_BRIDGE_FORWARD_DELAY 8
     37 #define BRCTL_SET_BRIDGE_HELLO_TIME 9
     38 #define BRCTL_SET_BRIDGE_MAX_AGE 10
     39 #define BRCTL_SET_AGEING_TIME 11
     40 #define BRCTL_SET_GC_INTERVAL 12
     41 #define BRCTL_GET_PORT_INFO 13
     42 #define BRCTL_SET_BRIDGE_STP_STATE 14
     43 #define BRCTL_SET_BRIDGE_PRIORITY 15
     44 #define BRCTL_SET_PORT_PRIORITY 16
     45 #define BRCTL_SET_PATH_COST 17
     46 #define BRCTL_GET_FDB_ENTRIES 18
     47 
     48 #define BR_STATE_DISABLED 0
     49 #define BR_STATE_LISTENING 1
     50 #define BR_STATE_LEARNING 2
     51 #define BR_STATE_FORWARDING 3
     52 #define BR_STATE_BLOCKING 4
     53 
     54 struct __bridge_info {
     55 	__u64 designated_root;
     56 	__u64 bridge_id;
     57 	__u32 root_path_cost;
     58 	__u32 max_age;
     59 	__u32 hello_time;
     60 	__u32 forward_delay;
     61 	__u32 bridge_max_age;
     62 	__u32 bridge_hello_time;
     63 	__u32 bridge_forward_delay;
     64 	__u8 topology_change;
     65 	__u8 topology_change_detected;
     66 	__u8 root_port;
     67 	__u8 stp_enabled;
     68 	__u32 ageing_time;
     69 	__u32 gc_interval;
     70 	__u32 hello_timer_value;
     71 	__u32 tcn_timer_value;
     72 	__u32 topology_change_timer_value;
     73 	__u32 gc_timer_value;
     74 };
     75 
     76 struct __port_info {
     77 	__u64 designated_root;
     78 	__u64 designated_bridge;
     79 	__u16 port_id;
     80 	__u16 designated_port;
     81 	__u32 path_cost;
     82 	__u32 designated_cost;
     83 	__u8 state;
     84 	__u8 top_change_ack;
     85 	__u8 config_pending;
     86 	__u8 unused0;
     87 	__u32 message_age_timer_value;
     88 	__u32 forward_delay_timer_value;
     89 	__u32 hold_timer_value;
     90 };
     91 
     92 struct __fdb_entry {
     93 	__u8 mac_addr[ETH_ALEN];
     94 	__u8 port_no;
     95 	__u8 is_local;
     96 	__u32 ageing_timer_value;
     97 	__u8 port_hi;
     98 	__u8 pad0;
     99 	__u16 unused;
    100 };
    101 
    102 /* Bridge Flags */
    103 #define BRIDGE_FLAGS_MASTER	1	/* Bridge command to/from master */
    104 #define BRIDGE_FLAGS_SELF	2	/* Bridge command to/from lowerdev */
    105 
    106 #define BRIDGE_MODE_VEB		0	/* Default loopback mode */
    107 #define BRIDGE_MODE_VEPA	1	/* 802.1Qbg defined VEPA mode */
    108 #define BRIDGE_MODE_UNDEF	0xFFFF  /* mode undefined */
    109 
    110 /* Bridge management nested attributes
    111  * [IFLA_AF_SPEC] = {
    112  *     [IFLA_BRIDGE_FLAGS]
    113  *     [IFLA_BRIDGE_MODE]
    114  *     [IFLA_BRIDGE_VLAN_INFO]
    115  * }
    116  */
    117 enum {
    118 	IFLA_BRIDGE_FLAGS,
    119 	IFLA_BRIDGE_MODE,
    120 	IFLA_BRIDGE_VLAN_INFO,
    121 	__IFLA_BRIDGE_MAX,
    122 };
    123 #define IFLA_BRIDGE_MAX (__IFLA_BRIDGE_MAX - 1)
    124 
    125 #define BRIDGE_VLAN_INFO_MASTER	(1<<0)	/* Operate on Bridge device as well */
    126 #define BRIDGE_VLAN_INFO_PVID	(1<<1)	/* VLAN is PVID, ingress untagged */
    127 #define BRIDGE_VLAN_INFO_UNTAGGED	(1<<2)	/* VLAN egresses untagged */
    128 #define BRIDGE_VLAN_INFO_RANGE_BEGIN	(1<<3) /* VLAN is start of vlan range */
    129 #define BRIDGE_VLAN_INFO_RANGE_END	(1<<4) /* VLAN is end of vlan range */
    130 #define BRIDGE_VLAN_INFO_BRENTRY	(1<<5) /* Global bridge VLAN entry */
    131 
    132 struct bridge_vlan_info {
    133 	__u16 flags;
    134 	__u16 vid;
    135 };
    136 
    137 struct bridge_vlan_xstats {
    138 	__u64 rx_bytes;
    139 	__u64 rx_packets;
    140 	__u64 tx_bytes;
    141 	__u64 tx_packets;
    142 	__u16 vid;
    143 	__u16 flags;
    144 	__u32 pad2;
    145 };
    146 
    147 /* Bridge multicast database attributes
    148  * [MDBA_MDB] = {
    149  *     [MDBA_MDB_ENTRY] = {
    150  *         [MDBA_MDB_ENTRY_INFO] {
    151  *		struct br_mdb_entry
    152  *		[MDBA_MDB_EATTR attributes]
    153  *         }
    154  *     }
    155  * }
    156  * [MDBA_ROUTER] = {
    157  *    [MDBA_ROUTER_PORT] = {
    158  *        u32 ifindex
    159  *        [MDBA_ROUTER_PATTR attributes]
    160  *    }
    161  * }
    162  */
    163 enum {
    164 	MDBA_UNSPEC,
    165 	MDBA_MDB,
    166 	MDBA_ROUTER,
    167 	__MDBA_MAX,
    168 };
    169 #define MDBA_MAX (__MDBA_MAX - 1)
    170 
    171 enum {
    172 	MDBA_MDB_UNSPEC,
    173 	MDBA_MDB_ENTRY,
    174 	__MDBA_MDB_MAX,
    175 };
    176 #define MDBA_MDB_MAX (__MDBA_MDB_MAX - 1)
    177 
    178 enum {
    179 	MDBA_MDB_ENTRY_UNSPEC,
    180 	MDBA_MDB_ENTRY_INFO,
    181 	__MDBA_MDB_ENTRY_MAX,
    182 };
    183 #define MDBA_MDB_ENTRY_MAX (__MDBA_MDB_ENTRY_MAX - 1)
    184 
    185 /* per mdb entry additional attributes */
    186 enum {
    187 	MDBA_MDB_EATTR_UNSPEC,
    188 	MDBA_MDB_EATTR_TIMER,
    189 	__MDBA_MDB_EATTR_MAX
    190 };
    191 #define MDBA_MDB_EATTR_MAX (__MDBA_MDB_EATTR_MAX - 1)
    192 
    193 /* multicast router types */
    194 enum {
    195 	MDB_RTR_TYPE_DISABLED,
    196 	MDB_RTR_TYPE_TEMP_QUERY,
    197 	MDB_RTR_TYPE_PERM,
    198 	MDB_RTR_TYPE_TEMP
    199 };
    200 
    201 enum {
    202 	MDBA_ROUTER_UNSPEC,
    203 	MDBA_ROUTER_PORT,
    204 	__MDBA_ROUTER_MAX,
    205 };
    206 #define MDBA_ROUTER_MAX (__MDBA_ROUTER_MAX - 1)
    207 
    208 /* router port attributes */
    209 enum {
    210 	MDBA_ROUTER_PATTR_UNSPEC,
    211 	MDBA_ROUTER_PATTR_TIMER,
    212 	MDBA_ROUTER_PATTR_TYPE,
    213 	__MDBA_ROUTER_PATTR_MAX
    214 };
    215 #define MDBA_ROUTER_PATTR_MAX (__MDBA_ROUTER_PATTR_MAX - 1)
    216 
    217 struct br_port_msg {
    218 	__u8  family;
    219 	__u32 ifindex;
    220 };
    221 
    222 struct br_mdb_entry {
    223 	__u32 ifindex;
    224 #define MDB_TEMPORARY 0
    225 #define MDB_PERMANENT 1
    226 	__u8 state;
    227 #define MDB_FLAGS_OFFLOAD	(1 << 0)
    228 	__u8 flags;
    229 	__u16 vid;
    230 	struct {
    231 		union {
    232 			__be32	ip4;
    233 			struct in6_addr ip6;
    234 		} u;
    235 		__be16		proto;
    236 	} addr;
    237 };
    238 
    239 enum {
    240 	MDBA_SET_ENTRY_UNSPEC,
    241 	MDBA_SET_ENTRY,
    242 	__MDBA_SET_ENTRY_MAX,
    243 };
    244 #define MDBA_SET_ENTRY_MAX (__MDBA_SET_ENTRY_MAX - 1)
    245 
    246 /* Embedded inside LINK_XSTATS_TYPE_BRIDGE */
    247 enum {
    248 	BRIDGE_XSTATS_UNSPEC,
    249 	BRIDGE_XSTATS_VLAN,
    250 	BRIDGE_XSTATS_MCAST,
    251 	BRIDGE_XSTATS_PAD,
    252 	__BRIDGE_XSTATS_MAX
    253 };
    254 #define BRIDGE_XSTATS_MAX (__BRIDGE_XSTATS_MAX - 1)
    255 
    256 enum {
    257 	BR_MCAST_DIR_RX,
    258 	BR_MCAST_DIR_TX,
    259 	BR_MCAST_DIR_SIZE
    260 };
    261 
    262 /* IGMP/MLD statistics */
    263 struct br_mcast_stats {
    264 	__u64 igmp_v1queries[BR_MCAST_DIR_SIZE];
    265 	__u64 igmp_v2queries[BR_MCAST_DIR_SIZE];
    266 	__u64 igmp_v3queries[BR_MCAST_DIR_SIZE];
    267 	__u64 igmp_leaves[BR_MCAST_DIR_SIZE];
    268 	__u64 igmp_v1reports[BR_MCAST_DIR_SIZE];
    269 	__u64 igmp_v2reports[BR_MCAST_DIR_SIZE];
    270 	__u64 igmp_v3reports[BR_MCAST_DIR_SIZE];
    271 	__u64 igmp_parse_errors;
    272 
    273 	__u64 mld_v1queries[BR_MCAST_DIR_SIZE];
    274 	__u64 mld_v2queries[BR_MCAST_DIR_SIZE];
    275 	__u64 mld_leaves[BR_MCAST_DIR_SIZE];
    276 	__u64 mld_v1reports[BR_MCAST_DIR_SIZE];
    277 	__u64 mld_v2reports[BR_MCAST_DIR_SIZE];
    278 	__u64 mld_parse_errors;
    279 
    280 	__u64 mcast_bytes[BR_MCAST_DIR_SIZE];
    281 	__u64 mcast_packets[BR_MCAST_DIR_SIZE];
    282 };
    283 #endif /* _UAPI_LINUX_IF_BRIDGE_H */
    284