1 /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
3 * Linux ethernet bridge
6 * Lennert Buytenhek <buytenh@gnu.org>
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License
10 * as published by the Free Software Foundation; either version
11 * 2 of the License, or (at your option) any later version.
14 #ifndef _UAPI_LINUX_IF_BRIDGE_H
15 #define _UAPI_LINUX_IF_BRIDGE_H
17 #include <linux/types.h>
18 #include <linux/if_ether.h>
19 #include <linux/in6.h>
21 #define SYSFS_BRIDGE_ATTR "bridge"
22 #define SYSFS_BRIDGE_FDB "brforward"
23 #define SYSFS_BRIDGE_PORT_SUBDIR "brif"
24 #define SYSFS_BRIDGE_PORT_ATTR "brport"
25 #define SYSFS_BRIDGE_PORT_LINK "bridge"
27 #define BRCTL_VERSION 1
29 #define BRCTL_GET_VERSION 0
30 #define BRCTL_GET_BRIDGES 1
31 #define BRCTL_ADD_BRIDGE 2
32 #define BRCTL_DEL_BRIDGE 3
33 #define BRCTL_ADD_IF 4
34 #define BRCTL_DEL_IF 5
35 #define BRCTL_GET_BRIDGE_INFO 6
36 #define BRCTL_GET_PORT_LIST 7
37 #define BRCTL_SET_BRIDGE_FORWARD_DELAY 8
38 #define BRCTL_SET_BRIDGE_HELLO_TIME 9
39 #define BRCTL_SET_BRIDGE_MAX_AGE 10
40 #define BRCTL_SET_AGEING_TIME 11
41 #define BRCTL_SET_GC_INTERVAL 12
42 #define BRCTL_GET_PORT_INFO 13
43 #define BRCTL_SET_BRIDGE_STP_STATE 14
44 #define BRCTL_SET_BRIDGE_PRIORITY 15
45 #define BRCTL_SET_PORT_PRIORITY 16
46 #define BRCTL_SET_PATH_COST 17
47 #define BRCTL_GET_FDB_ENTRIES 18
49 #define BR_STATE_DISABLED 0
50 #define BR_STATE_LISTENING 1
51 #define BR_STATE_LEARNING 2
52 #define BR_STATE_FORWARDING 3
53 #define BR_STATE_BLOCKING 4
55 struct __bridge_info
{
56 __u64 designated_root
;
63 __u32 bridge_hello_time
;
64 __u32 bridge_forward_delay
;
66 __u8 topology_change_detected
;
71 __u32 hello_timer_value
;
72 __u32 tcn_timer_value
;
73 __u32 topology_change_timer_value
;
78 __u64 designated_root
;
79 __u64 designated_bridge
;
81 __u16 designated_port
;
83 __u32 designated_cost
;
88 __u32 message_age_timer_value
;
89 __u32 forward_delay_timer_value
;
90 __u32 hold_timer_value
;
94 __u8 mac_addr
[ETH_ALEN
];
97 __u32 ageing_timer_value
;
104 #define BRIDGE_FLAGS_MASTER 1 /* Bridge command to/from master */
105 #define BRIDGE_FLAGS_SELF 2 /* Bridge command to/from lowerdev */
107 #define BRIDGE_MODE_VEB 0 /* Default loopback mode */
108 #define BRIDGE_MODE_VEPA 1 /* 802.1Qbg defined VEPA mode */
109 #define BRIDGE_MODE_UNDEF 0xFFFF /* mode undefined */
111 /* Bridge management nested attributes
113 * [IFLA_BRIDGE_FLAGS]
115 * [IFLA_BRIDGE_VLAN_INFO]
121 IFLA_BRIDGE_VLAN_INFO
,
122 IFLA_BRIDGE_VLAN_TUNNEL_INFO
,
125 #define IFLA_BRIDGE_MAX (__IFLA_BRIDGE_MAX - 1)
127 #define BRIDGE_VLAN_INFO_MASTER (1<<0) /* Operate on Bridge device as well */
128 #define BRIDGE_VLAN_INFO_PVID (1<<1) /* VLAN is PVID, ingress untagged */
129 #define BRIDGE_VLAN_INFO_UNTAGGED (1<<2) /* VLAN egresses untagged */
130 #define BRIDGE_VLAN_INFO_RANGE_BEGIN (1<<3) /* VLAN is start of vlan range */
131 #define BRIDGE_VLAN_INFO_RANGE_END (1<<4) /* VLAN is end of vlan range */
132 #define BRIDGE_VLAN_INFO_BRENTRY (1<<5) /* Global bridge VLAN entry */
133 #define BRIDGE_VLAN_INFO_ONLY_OPTS (1<<6) /* Skip create/delete/flags */
135 struct bridge_vlan_info
{
141 IFLA_BRIDGE_VLAN_TUNNEL_UNSPEC
,
142 IFLA_BRIDGE_VLAN_TUNNEL_ID
,
143 IFLA_BRIDGE_VLAN_TUNNEL_VID
,
144 IFLA_BRIDGE_VLAN_TUNNEL_FLAGS
,
145 __IFLA_BRIDGE_VLAN_TUNNEL_MAX
,
148 #define IFLA_BRIDGE_VLAN_TUNNEL_MAX (__IFLA_BRIDGE_VLAN_TUNNEL_MAX - 1)
150 struct bridge_vlan_xstats
{
160 struct bridge_stp_xstats
{
161 __u64 transition_blk
;
162 __u64 transition_fwd
;
169 /* Bridge vlan RTM header */
178 BRIDGE_VLANDB_DUMP_UNSPEC
,
179 BRIDGE_VLANDB_DUMP_FLAGS
,
180 __BRIDGE_VLANDB_DUMP_MAX
,
182 #define BRIDGE_VLANDB_DUMP_MAX (__BRIDGE_VLANDB_DUMP_MAX - 1)
184 /* flags used in BRIDGE_VLANDB_DUMP_FLAGS attribute to affect dumps */
185 #define BRIDGE_VLANDB_DUMPF_STATS (1 << 0) /* Include stats in the dump */
187 /* Bridge vlan RTM attributes
188 * [BRIDGE_VLANDB_ENTRY] = {
189 * [BRIDGE_VLANDB_ENTRY_INFO]
194 BRIDGE_VLANDB_UNSPEC
,
198 #define BRIDGE_VLANDB_MAX (__BRIDGE_VLANDB_MAX - 1)
201 BRIDGE_VLANDB_ENTRY_UNSPEC
,
202 BRIDGE_VLANDB_ENTRY_INFO
,
203 BRIDGE_VLANDB_ENTRY_RANGE
,
204 BRIDGE_VLANDB_ENTRY_STATE
,
205 BRIDGE_VLANDB_ENTRY_TUNNEL_INFO
,
206 BRIDGE_VLANDB_ENTRY_STATS
,
207 __BRIDGE_VLANDB_ENTRY_MAX
,
209 #define BRIDGE_VLANDB_ENTRY_MAX (__BRIDGE_VLANDB_ENTRY_MAX - 1)
211 /* [BRIDGE_VLANDB_ENTRY] = {
212 * [BRIDGE_VLANDB_ENTRY_TUNNEL_INFO] = {
213 * [BRIDGE_VLANDB_TINFO_ID]
219 BRIDGE_VLANDB_TINFO_UNSPEC
,
220 BRIDGE_VLANDB_TINFO_ID
,
221 BRIDGE_VLANDB_TINFO_CMD
,
222 __BRIDGE_VLANDB_TINFO_MAX
,
224 #define BRIDGE_VLANDB_TINFO_MAX (__BRIDGE_VLANDB_TINFO_MAX - 1)
226 /* [BRIDGE_VLANDB_ENTRY] = {
227 * [BRIDGE_VLANDB_ENTRY_STATS] = {
228 * [BRIDGE_VLANDB_STATS_RX_BYTES]
235 BRIDGE_VLANDB_STATS_UNSPEC
,
236 BRIDGE_VLANDB_STATS_RX_BYTES
,
237 BRIDGE_VLANDB_STATS_RX_PACKETS
,
238 BRIDGE_VLANDB_STATS_TX_BYTES
,
239 BRIDGE_VLANDB_STATS_TX_PACKETS
,
240 BRIDGE_VLANDB_STATS_PAD
,
241 __BRIDGE_VLANDB_STATS_MAX
,
243 #define BRIDGE_VLANDB_STATS_MAX (__BRIDGE_VLANDB_STATS_MAX - 1)
245 /* Bridge multicast database attributes
247 * [MDBA_MDB_ENTRY] = {
248 * [MDBA_MDB_ENTRY_INFO] {
249 * struct br_mdb_entry
250 * [MDBA_MDB_EATTR attributes]
255 * [MDBA_ROUTER_PORT] = {
257 * [MDBA_ROUTER_PATTR attributes]
267 #define MDBA_MAX (__MDBA_MAX - 1)
274 #define MDBA_MDB_MAX (__MDBA_MDB_MAX - 1)
277 MDBA_MDB_ENTRY_UNSPEC
,
279 __MDBA_MDB_ENTRY_MAX
,
281 #define MDBA_MDB_ENTRY_MAX (__MDBA_MDB_ENTRY_MAX - 1)
283 /* per mdb entry additional attributes */
285 MDBA_MDB_EATTR_UNSPEC
,
286 MDBA_MDB_EATTR_TIMER
,
289 #define MDBA_MDB_EATTR_MAX (__MDBA_MDB_EATTR_MAX - 1)
291 /* multicast router types */
293 MDB_RTR_TYPE_DISABLED
,
294 MDB_RTR_TYPE_TEMP_QUERY
,
304 #define MDBA_ROUTER_MAX (__MDBA_ROUTER_MAX - 1)
306 /* router port attributes */
308 MDBA_ROUTER_PATTR_UNSPEC
,
309 MDBA_ROUTER_PATTR_TIMER
,
310 MDBA_ROUTER_PATTR_TYPE
,
311 __MDBA_ROUTER_PATTR_MAX
313 #define MDBA_ROUTER_PATTR_MAX (__MDBA_ROUTER_PATTR_MAX - 1)
320 struct br_mdb_entry
{
322 #define MDB_TEMPORARY 0
323 #define MDB_PERMANENT 1
325 #define MDB_FLAGS_OFFLOAD (1 << 0)
326 #define MDB_FLAGS_FAST_LEAVE (1 << 1)
339 MDBA_SET_ENTRY_UNSPEC
,
341 __MDBA_SET_ENTRY_MAX
,
343 #define MDBA_SET_ENTRY_MAX (__MDBA_SET_ENTRY_MAX - 1)
345 /* Embedded inside LINK_XSTATS_TYPE_BRIDGE */
347 BRIDGE_XSTATS_UNSPEC
,
354 #define BRIDGE_XSTATS_MAX (__BRIDGE_XSTATS_MAX - 1)
362 /* IGMP/MLD statistics */
363 struct br_mcast_stats
{
364 __u64 igmp_v1queries
[BR_MCAST_DIR_SIZE
];
365 __u64 igmp_v2queries
[BR_MCAST_DIR_SIZE
];
366 __u64 igmp_v3queries
[BR_MCAST_DIR_SIZE
];
367 __u64 igmp_leaves
[BR_MCAST_DIR_SIZE
];
368 __u64 igmp_v1reports
[BR_MCAST_DIR_SIZE
];
369 __u64 igmp_v2reports
[BR_MCAST_DIR_SIZE
];
370 __u64 igmp_v3reports
[BR_MCAST_DIR_SIZE
];
371 __u64 igmp_parse_errors
;
373 __u64 mld_v1queries
[BR_MCAST_DIR_SIZE
];
374 __u64 mld_v2queries
[BR_MCAST_DIR_SIZE
];
375 __u64 mld_leaves
[BR_MCAST_DIR_SIZE
];
376 __u64 mld_v1reports
[BR_MCAST_DIR_SIZE
];
377 __u64 mld_v2reports
[BR_MCAST_DIR_SIZE
];
378 __u64 mld_parse_errors
;
380 __u64 mcast_bytes
[BR_MCAST_DIR_SIZE
];
381 __u64 mcast_packets
[BR_MCAST_DIR_SIZE
];
384 /* bridge boolean options
385 * BR_BOOLOPT_NO_LL_LEARN - disable learning from link-local packets
387 * IMPORTANT: if adding a new option do not forget to handle
388 * it in br_boolopt_toggle/get and bridge sysfs
391 BR_BOOLOPT_NO_LL_LEARN
,
395 /* struct br_boolopt_multi - change multiple bridge boolean options
397 * @optval: new option values (bit per option)
398 * @optmask: options to change (bit per option)
400 struct br_boolopt_multi
{
404 #endif /* _UAPI_LINUX_IF_BRIDGE_H */