2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 * Copyright (c) 2006 Shteryana Shopova <syrinx@FreeBSD.org>
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 * Bridge MIB implementation for SNMPd.
36 #define SNMP_BRIDGE_ID_LEN 8
38 typedef uint8_t port_id[2];
39 typedef u_char bridge_id[SNMP_BRIDGE_ID_LEN];
41 #define SNMP_BRIDGE_MAX_PRIORITY 65535
43 #define SNMP_BRIDGE_MIN_AGE_TIME 10
44 #define SNMP_BRIDGE_MAX_AGE_TIME 1000000
46 #define SNMP_BRIDGE_MIN_TXHC 1
47 #define SNMP_BRIDGE_MAX_TXHC 10
49 #define SNMP_BRIDGE_MIN_MAGE 600
50 #define SNMP_BRIDGE_MAX_MAGE 4000
52 #define SNMP_BRIDGE_MIN_HTIME 100
53 #define SNMP_BRIDGE_MAX_HTIME 1000
55 #define SNMP_BRIDGE_MIN_FDELAY 400
56 #define SNMP_BRIDGE_MAX_FDELAY 3000
58 #define SNMP_PORT_PATHCOST_OBSOLETE 65535
59 #define SNMP_PORT_MIN_PATHCOST 0
60 #define SNMP_PORT_MAX_PATHCOST 200000000
61 #define SNMP_PORT_PATHCOST_AUTO 0
63 #define SNMP_BRIDGE_DATA_MAXAGE 10
64 #define SNMP_BRIDGE_DATA_MAXAGE_MIN 1
65 #define SNMP_BRIDGE_DATA_MAXAGE_MAX 300
67 /* By default poll kernel data every 5 minutes. */
68 #define SNMP_BRIDGE_POLL_INTERVAL (5 * 60)
69 #define SNMP_BRIDGE_POLL_INTERVAL_MIN 1
70 #define SNMP_BRIDGE_POLL_INTERVAL_MAX 3600
72 /* Poll for a topology change once every 30 seconds. */
73 #define SNMP_BRIDGE_TC_POLL_INTERVAL 30
75 struct bridge_if *bridge_get_default(void);
77 void bridge_set_default(struct bridge_if *bif);
79 const char *bridge_get_default_name(void);
81 int bridge_get_data_maxage(void);
84 * Bridge Addresses Table.
87 uint32_t sysindex; /* The bridge if sysindex. */
89 enum TpFdbStatus status;
90 uint8_t tp_addr[ETHER_ADDR_LEN];
92 TAILQ_ENTRY(tp_entry) tp_e;
97 * The bridge port system interface index is used for a
98 * port number. Transparent bridging statistics and STP
99 * information for a port are also contained here.
102 /* dot1dBase subtree objects. */
103 uint32_t sysindex; /* The bridge interface sysindex. */
104 int32_t port_no; /* The bridge member system index. */
105 int32_t if_idx; /* SNMP ifIndex from mibII. */
106 int8_t span_enable; /* Span flag set - private MIB. */
107 struct asn_oid circuit; /* Unused. */
108 uint32_t dly_ex_drops; /* Drops on output. */
109 uint32_t dly_mtu_drops; /* MTU exceeded drops. */
110 int32_t status; /* The entry status. */
111 enum TruthValue priv_set; /* The private flag. */
113 /* dot1dStp subtree objects. */
118 char p_name[IFNAMSIZ]; /* Not in BRIDGE-MIB. */
119 enum StpPortState state;
120 enum dot1dStpPortEnable enable;
122 bridge_id design_root;
123 bridge_id design_bridge;
125 /* rstpMib extensions. */
126 int32_t admin_path_cost;
127 enum TruthValue proto_migr;
128 enum TruthValue admin_edge;
129 enum TruthValue oper_edge;
130 enum TruthValue oper_ptp;
131 enum StpPortAdminPointToPointType admin_ptp;
133 /* dot1dTp subtree objects. */
140 TAILQ_ENTRY(bridge_port) b_p;
144 * A bridge interface.
145 * The system interface index of the bridge is not required neither by the
146 * standard BRIDGE-MIB nor by the private BEGEMOT-BRIDGE-MIB, but is used
147 * as key for looking up the other info for this bridge.
150 /* dot1dBase subtree objects. */
151 uint32_t sysindex; /* The system interface index. */
152 int32_t num_ports; /* Number of ports. */
153 enum BaseType br_type; /* Bridge type. */
154 enum RowStatus if_status; /* Bridge status. */
155 char bif_name[IFNAMSIZ]; /* Bridge interface name. */
156 struct ether_addr br_addr; /* Bridge address. */
157 struct bridge_port *f_bp; /* This bridge's first entry
158 * in the base ports TAILQ. */
159 /* dot1dStp subtree objects. */
163 int32_t max_age; /* Current max age. */
164 int32_t hello_time; /* Current hello time. */
165 int32_t fwd_delay; /* Current forward delay. */
167 int32_t bridge_max_age; /* Configured max age. */
168 int32_t bridge_hello_time; /* Configured hello time. */
169 int32_t bridge_fwd_delay; /* Configured forward delay. */
170 int32_t tx_hold_count;
171 uint32_t top_changes;
172 enum dot1dStpVersion stp_version;
173 enum dot1dStpProtocolSpecification prot_spec;
174 struct timeval last_tc_time;
175 bridge_id design_root;
177 /* dot1dTp subtree objects. */
178 int32_t lrnt_drops; /* Dropped addresses. */
179 int32_t age_time; /* Address entry timeout. */
180 int32_t num_addrs; /* Current # of addresses in cache. */
181 int32_t max_addrs; /* Max # of addresses in cache. */
182 struct tp_entry *f_tpa; /* This bridge's first entry in
183 * the tp addresses TAILQ. */
188 TAILQ_ENTRY(bridge_if) b_if;
191 void bridge_ifs_fini(void);
193 struct bridge_if *bridge_if_find_ifs(uint32_t sysindex);
195 struct bridge_if *bridge_if_find_ifname(const char *b_name);
197 const char *bridge_if_find_name(uint32_t sysindex);
199 int bridge_compare_sysidx(uint32_t i1, uint32_t i2);
201 int bridge_attach_newif(struct mibif *ifp);
203 struct bridge_if *bridge_first_bif(void);
205 struct bridge_if *bridge_next_bif(struct bridge_if *b_pr);
207 void bridge_remove_bif(struct bridge_if *bif);
209 void bridge_update_all_ports(void);
211 void bridge_update_all_addrs(void);
213 void bridge_update_all_ifs(void);
215 void bridge_update_all(void *arg);
217 void bridge_update_tc_time(void *arg);
219 void bridge_ifs_dump(void);
222 void bridge_ports_update_listage(void);
224 void bridge_ports_fini(void);
226 void bridge_members_free(struct bridge_if *bif);
228 struct bridge_port *bridge_new_port(struct mibif *mif, struct bridge_if *bif);
230 void bridge_port_remove(struct bridge_port *bp, struct bridge_if *bif);
232 struct bridge_port *bridge_port_bif_first(struct bridge_if *bif);
234 struct bridge_port *bridge_port_bif_next(struct bridge_port *bp);
236 struct bridge_port *bridge_port_find(int32_t if_idx, struct bridge_if *bif);
238 void bridge_port_getinfo_mibif(struct mibif *m_if, struct bridge_port *bp);
240 int bridge_getinfo_bif_ports(struct bridge_if *bif);
242 int bridge_update_memif(struct bridge_if *bif);
244 void bridge_ports_dump(struct bridge_if *bif);
246 /* Bridge addresses. */
247 void bridge_addrs_update_listage(void);
249 void bridge_addrs_fini(void);
251 void bridge_addrs_free(struct bridge_if *bif);
253 struct tp_entry *bridge_new_addrs(uint8_t *mac, struct bridge_if *bif);
255 void bridge_addrs_remove(struct tp_entry *te, struct bridge_if *bif);
257 struct tp_entry *bridge_addrs_find(uint8_t *mac, struct bridge_if *bif);
259 struct tp_entry *bridge_addrs_bif_first(struct bridge_if *bif);
261 struct tp_entry *bridge_addrs_bif_next(struct tp_entry *te);
263 int bridge_getinfo_bif_addrs(struct bridge_if *bif);
265 int bridge_update_addrs(struct bridge_if *bif);
267 void bridge_addrs_dump(struct bridge_if *bif);
271 void bridge_pf_dump(void);
273 /* System specific. */
275 /* Open the socket for the ioctls. */
276 int bridge_ioctl_init(void);
278 /* Load bridge kernel module. */
279 int bridge_kmod_load(void);
281 /* Get the bridge interface information. */
282 int bridge_getinfo_bif(struct bridge_if *bif);
284 /* Get the bridge interface STP parameters. */
285 int bridge_get_op_param(struct bridge_if *bif);
287 /* Set the bridge priority. */
288 int bridge_set_priority(struct bridge_if *bif, int32_t priority);
290 /* Set the bridge max age. */
291 int bridge_set_maxage(struct bridge_if *bif, int32_t max_age);
293 /* Set the bridge hello time.*/
294 int bridge_set_hello_time(struct bridge_if *bif, int32_t hello_time);
296 /* Set the bridge forward delay.*/
297 int bridge_set_forward_delay(struct bridge_if *bif, int32_t fwd_delay);
299 /* Set the bridge address cache max age. */
300 int bridge_set_aging_time(struct bridge_if *bif, int32_t age_time);
302 /* Set the max number of entries in the bridge address cache. */
303 int bridge_set_max_cache(struct bridge_if *bif, int32_t max_cache);
305 /* Set the bridge TX hold count. */
306 int bridge_set_tx_hold_count(struct bridge_if *bif, int32_t tx_hc);
308 /* Set the bridge STP protocol version. */
309 int bridge_set_stp_version(struct bridge_if *bif, int32_t stp_proto);
311 /* Set the bridge interface status to up/down. */
312 int bridge_set_if_up(const char* b_name, int8_t up);
314 /* Create a bridge interface. */
315 int bridge_create(const char *b_name);
317 /* Destroy a bridge interface. */
318 int bridge_destroy(const char *b_name);
320 /* Fetch the bridge mac address. */
321 u_char *bridge_get_basemac(const char *bif_name, u_char *mac, size_t mlen);
323 /* Set a bridge member priority. */
324 int bridge_port_set_priority(const char *bif_name, struct bridge_port *bp,
327 /* Set a bridge member STP-enabled flag. */
328 int bridge_port_set_stp_enable(const char *bif_name, struct bridge_port *bp,
331 /* Set a bridge member STP path cost. */
332 int bridge_port_set_path_cost(const char *bif_name, struct bridge_port *bp,
335 /* Set admin point-to-point link. */
336 int bridge_port_set_admin_ptp(const char *bif_name, struct bridge_port *bp,
339 /* Set admin edge. */
340 int bridge_port_set_admin_edge(const char *bif_name, struct bridge_port *bp,
343 /* Set 'private' flag. */
344 int bridge_port_set_private(const char *bif_name, struct bridge_port *bp,
347 /* Add a bridge member port. */
348 int bridge_port_addm(struct bridge_port *bp, const char *b_name);
350 /* Delete a bridge member port. */
351 int bridge_port_delm(struct bridge_port *bp, const char *b_name);
353 /* Get the current value from the module for bridge PF control. */
354 int32_t bridge_get_pfval(uint8_t which);
356 /* Get/Set a bridge PF control. */
357 int32_t bridge_do_pfctl(int32_t bridge_ctl, enum snmp_op op, int32_t *val);
359 #endif /* SNMP_BRIDGE_H */