1SNMP-BRIDGE-MIB(1)                 Net-SNMP                 SNMP-BRIDGE-MIB(1)
2
3
4

NAME

6       snmp-bridge-mib - provide Linux bridge information via SNMP
7

SYNOPSIS

9       snmp-bridge-mib {bridge}
10

ARGUMENTS

12       The following arguments are required:
13
14       bridge
15           The name of the Linux bridge for which you want to provide
16           information via SNMP, e.g. br0.
17

DESCRIPTION

19       The snmp-bridge-mib is an extension to net-snmp. It collects
20       information about a bridge in a Linux system and exports them for query
21       from other (remote) systems for management purposes.
22

CONFIGURATION:

24       The preferred method of snmp-bridge-mib to attach to net-snmp is
25       agentx. For this to work, you will have to add the following line to
26       /etc/snmp/snmpd.conf,
27
28               master agentx
29
30
31       restart snmpd and start snmp-bridge-mib. snmp-bridge-mib will then
32       connect to the running snmpd daemon.
33
34       Another way of attaching snmp-bridge-mib to is to run it as an embedded
35       perl module. You have to add
36
37               perl do "path to location of snmp-bridge-mib"
38
39
40       and restart snmpd.
41

EXAMPLE:

43       Follow the instructions in this manpage and type
44
45               perl /usr/bin/snmp-bridge-mib br0
46
47
48       You´ll get the following output:
49
50                registering at .1.3.6.1.2.1.17
51                running as a subagent.
52                dot1qbridge agent started.
53                NET-SNMP version 5.4.2.1 AgentX subagent connected
54
55
56       Now it´s time for a first test:
57
58               $ export MIBS=+BRIDGE-MIB
59               $ snmpwalk localhost .1.3.6.1.2.1.17
60
61
62       The output produced should look like
63
64               BRIDGE-MIB::dot1dStpBridgeHelloTime = INTEGER: 199 centi-seconds
65               BRIDGE-MIB::dot1dStpBridgeForwardDelay = INTEGER: 1499 centi-seconds
66               BRIDGE-MIB::dot1dStpPort.1 = INTEGER: 1
67               BRIDGE-MIB::dot1dStpPort.3 = INTEGER: 3
68               BRIDGE-MIB::dot1dStpPortPriority.1 = INTEGER: 32
69               BRIDGE-MIB::dot1dStpPortPriority.3 = INTEGER: 32
70               BRIDGE-MIB::dot1dStpPortState.1 = INTEGER: disabled(1)
71               BRIDGE-MIB::dot1dStpPortState.3 = INTEGER: disabled(1)
72               BRIDGE-MIB::dot1dStpPortEnable.1 = INTEGER: disabled(2)
73               BRIDGE-MIB::dot1dStpPortEnable.3 = INTEGER: disabled(2)
74               BRIDGE-MIB::dot1dStpPortPathCost.1 = INTEGER: 2
75               BRIDGE-MIB::dot1dStpPortPathCost.3 = INTEGER: 4
76               BRIDGE-MIB::dot1dStpPortDesignatedRoot.1 = STRING: "8000.001018382c78"
77               BRIDGE-MIB::dot1dStpPortDesignatedRoot.3 = STRING: "8000.001018382c78"
78               BRIDGE-MIB::dot1dStpPortDesignatedCost.1 = INTEGER: 0
79               BRIDGE-MIB::dot1dStpPortDesignatedCost.3 = INTEGER: 0
80               BRIDGE-MIB::dot1dStpPortDesignatedBridge.1 = STRING: "8000.001018382c78"
81               BRIDGE-MIB::dot1dStpPortDesignatedBridge.3 = STRING: "8000.001018382c78"
82               BRIDGE-MIB::dot1dStpPortDesignatedPort.1 = STRING: "32769"
83               BRIDGE-MIB::dot1dStpPortDesignatedPort.3 = STRING: "32770"
84               BRIDGE-MIB::dot1dStpPortPathCost32.1 = INTEGER: 2
85               BRIDGE-MIB::dot1dStpPortPathCost32.3 = INTEGER: 4
86               BRIDGE-MIB::dot1dTpLearnedEntryDiscards = Counter32: 0
87               BRIDGE-MIB::dot1dTpAgingTime = INTEGER: 300 seconds
88               BRIDGE-MIB::dot1dTpFdbAddress.´...8,x´ = STRING: 0:10:18:38:2c:78
89               BRIDGE-MIB::dot1dTpFdbAddress.´.!^/B|´ = STRING: 0:21:5e:2f:42:7c
90               BRIDGE-MIB::dot1dTpFdbPort.´...8,x´ = INTEGER: 1
91               BRIDGE-MIB::dot1dTpFdbPort.´.!^/B|´ = INTEGER: 3
92               BRIDGE-MIB::dot1dTpFdbStatus.´...8,x´ = INTEGER: learned(3)
93               BRIDGE-MIB::dot1dTpFdbStatus.´.!^/B|´ = INTEGER: learned(3)
94               BRIDGE-MIB::dot1dTpPort.1 = INTEGER: 1
95               BRIDGE-MIB::dot1dTpPort.3 = INTEGER: 3
96               BRIDGE-MIB::dot1dTpPortMaxInfo.1 = INTEGER: 1500 bytes
97               BRIDGE-MIB::dot1dTpPortMaxInfo.3 = INTEGER: 1500 bytes
98               BRIDGE-MIB::dot1dTpPortInFrames.1 = Counter32: 18082 frames
99               BRIDGE-MIB::dot1dTpPortInFrames.3 = Counter32: 1546072 frames
100               BRIDGE-MIB::dot1dTpPortOutFrames.1 = Counter32: 11601 frames
101               BRIDGE-MIB::dot1dTpPortOutFrames.3 = Counter32: 10988 frames
102               BRIDGE-MIB::dot1dTpPortInDiscards.1 = Counter32: 0 frames
103               BRIDGE-MIB::dot1dTpPortInDiscards.3 = Counter32: 0 frames
104
105

BUGS

107        1. snmp-bridge-mib currently only supports one bridge which has to be
108           specified on the commandline.
109
110        2. Not all elements of RFC 4188 because they are either not available
111           in sysfs or difficult to extract from the existing data.
112

SEE ALSO

114       snmpd.conf(5), Net::SNMP(3)
115

AUTHOR

117       Jens Osterkamp <jens@linux.vnet.ibm.com>
118           Developer
119
121       Copyright © 2009, 2010 IBM Corp., All Rights Reserved
122
123       Permission is hereby granted, free of charge, to any person obtaining a
124       copy of this software and associated documentation files (the
125       "Software"), to deal in the Software without restriction, including
126       without limitation the rights to use, copy, modify, merge, publish,
127       distribute, sublicense, and/or sell copies of the Software, and to
128       permit persons to whom the Software is furnished to do so, subject to
129       the following conditions:
130
131       The above copyright notice and this permission notice shall be included
132       in all copies or substantial portions of the Software.
133
134       THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
135       OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
136       MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
137       IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
138       CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
139       TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
140       SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
141
142
143
144
145http://www.ibm.com/ v6            03/26/2010                SNMP-BRIDGE-MIB(1)
Impressum