• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  *	Linux ethernet bridge
3  *
4  *	Authors:
5  *	Lennert Buytenhek		<buytenh@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