开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Internet/网络编程 > SNMP编程 > 查看源码
BRIDGE-MIB
资源名称：AdventNetSNMPAPI_4.zip　[点击查看]
上传用户：aonuowh
上传日期：2021-05-23
资源大小：35390k
文件大小：47k
源码类别：

SNMP编程

开发平台：

C/C++

BRIDGE-MIB：源码内容
  1. -- Changes to rfc1493 (Bridge MIB):
  2. --      No changes needed.
  3. -- dperkins@scruznet.com
  6. BRIDGE-MIB DEFINITIONS ::= BEGIN
  8.           IMPORTS
  9.                      Counter, TimeTicks
  10.                              FROM RFC1155-SMI
  11.                      mib-2
  12.                              FROM RFC1213-MIB
  13.                      OBJECT-TYPE
  14.                              FROM RFC-1212
  15.                      TRAP-TYPE
  16.                              FROM RFC-1215;
  18.           -- All representations of MAC addresses in this MIB Module
  19.           -- use, as a textual convention (i.e. this convention does
  20.           -- not affect their encoding), the data type:
  22.           MacAddress ::= OCTET STRING (SIZE (6))    -- a 6 octet address
  23.                                                     -- in the
  24.                                                     -- "canonical"
  25.                                                     -- order
  26.           -- defined by IEEE 802.1a, i.e., as if it were transmitted
  27.           -- least significant bit first, even though 802.5 (in
  28.           -- contrast to other n802.x protocols) requires MAC
  29.           -- addresses to be transmitted most significant bit first.
  30.           --
  31.           -- 16-bit addresses, if needed, are represented by setting
  32.           -- their upper 4 octets to all 0's, i.e., AAFF would be
  33.           -- represented as 00000000AAFF.
  35.           -- Similarly, all representations of Bridge-Id in this MIB
  36.           -- Module use, as a textual convention (i.e. this
  37.           -- convention does not affect their encoding), the data
  38.           -- type:
  40.           BridgeId ::= OCTET STRING (SIZE (8))   -- the
  41.                                                  -- Bridge-Identifier
  42.                                                  -- as used in the
  43.                                                  -- Spanning Tree
  45.           -- Protocol to uniquely identify a bridge.  Its first two
  46.           -- octets (in network byte order) contain a priority
  47.           -- value and its last 6 octets contain the MAC address
  48.           -- used to refer to a bridge in a unique fashion
  49.           -- (typically, the numerically smallest MAC address
  50.           -- of all ports on the bridge).
  53.           -- Several objects in this MIB module represent values of
  54.           -- timers used by the Spanning Tree Protocol.  In this
  55.           -- MIB, these timers have values in units of hundreths of
  56.           -- a second (i.e. 1/100 secs).
  57.           -- These timers, when stored in a Spanning Tree Protocol's
  58.           -- BPDU, are in units of 1/256 seconds.  Note, however,
  59.           -- that 802.1D-1990 specifies a settable granularity of
  60.           -- no more than 1 second for these timers.  To avoid
  61.           -- ambiguity, a data type is defined here as a textual
  62.           -- convention and all representation of these timers
  63.           -- in this MIB module are defined using this data type.  An
  64.           -- algorithm is also defined for converting between the
  65.           -- different units, to ensure a timer's value is not
  66.           -- distorted by multiple conversions.
  67.           -- The data type is:
  69.           Timeout ::= INTEGER -- a STP timer in units of 1/100 seconds
  71.           -- To convert a Timeout value into a value in units of
  72.           -- 1/256 seconds, the following algorithm should be used:
  73.           --
  74.           --      b  = floor( (n * 256) / 100)
  75.           --
  76.           -- where:
  77.           --      floor   =  quotient [ignore remainder]
  78.           --      n is the value in 1/100 second units
  79.           --      b is the value in 1/256 second units
  80.           --
  81.           -- To convert the value from 1/256 second units back to
  82.           -- 1/100 seconds, the following algorithm should be used:
  83.           --
  84.           --      n = ceiling( (b * 100) / 256)
  85.           --
  86.           -- where:
  87.           --      ceiling =  quotient [if remainder is 0], or
  88.           --                 quotient + 1 [if remainder is non-zero]
  89.           --      n is the value in 1/100 second units
  90.           --      b is the value in 1/256 second units
  91.           --
  92.           -- Note: it is important that the arithmetic operations are
  93.           -- done in the order specified (i.e., multiply first, divide
  94.           -- second).
  96.              dot1dBridge   OBJECT IDENTIFIER ::= { mib-2 17 }
  99.           -- groups in the Bridge MIB
  101.           dot1dBase     OBJECT IDENTIFIER ::= { dot1dBridge 1 }
  103.           dot1dStp      OBJECT IDENTIFIER ::= { dot1dBridge 2 }
  105.           dot1dSr       OBJECT IDENTIFIER ::= { dot1dBridge 3 }
  106.           -- separately documented
  108.           dot1dTp       OBJECT IDENTIFIER ::= { dot1dBridge 4 }
  110.           dot1dStatic   OBJECT IDENTIFIER ::= { dot1dBridge 5 }
  112.           -- the dot1dBase group
  114.           -- Implementation of the dot1dBase group is mandatory for all
  115.           -- bridges.
  117.           dot1dBaseBridgeAddress OBJECT-TYPE
  118.               SYNTAX  MacAddress
  119.               ACCESS  read-only
  120.               STATUS  mandatory
  121.               DESCRIPTION
  122.                       "The MAC address used by this bridge when it must
  123.                       be referred to in a unique fashion.   It is
  124.                       recommended that this be the numerically smallest
  125.                       MAC address of all ports that belong to this
  126.                       bridge.  However it is only required to be unique.
  127.                       When concatenated with dot1dStpPriority a unique
  128.                       BridgeIdentifier is formed which is used in the
  129.                       Spanning Tree Protocol."
  130.               REFERENCE
  131.                       "IEEE 802.1D-1990: Sections 6.4.1.1.3 and 3.12.5"
  132.               ::= { dot1dBase 1 }
  134.           dot1dBaseNumPorts OBJECT-TYPE
  135.               SYNTAX  INTEGER
  136.               ACCESS  read-only
  137.               STATUS  mandatory
  138.               DESCRIPTION
  139.                       "The number of ports controlled by this bridging
  140.                       entity."
  141.               REFERENCE
  142.                       "IEEE 802.1D-1990: Section 6.4.1.1.3"
  143.               ::= { dot1dBase 2 }
  145.           dot1dBaseType OBJECT-TYPE
  146.               SYNTAX  INTEGER {
  147.                           unknown(1),
  148.                           transparent-only(2),
  149.                           sourceroute-only(3),
  150.                           srt(4)
  151.                       }
  152.               ACCESS  read-only
  153.               STATUS  mandatory
  154.               DESCRIPTION
  155.                       "Indicates what type of bridging this bridge can
  156.                       perform.  If a bridge is actually performing a
  157.                       certain type of bridging this will be indicated by
  158.                       entries in the port table for the given type."
  159.               ::= { dot1dBase 3 }
  161.           -- The Generic Bridge Port Table
  163.           dot1dBasePortTable OBJECT-TYPE
  164.               SYNTAX  SEQUENCE OF Dot1dBasePortEntry
  165.               ACCESS  not-accessible
  166.               STATUS  mandatory
  167.               DESCRIPTION
  168.                       "A table that contains generic information about
  169.                       every port that is associated with this bridge.
  170.                       Transparent, source-route, and srt ports are
  171.                       included."
  172.               ::= { dot1dBase 4 }
  174.           dot1dBasePortEntry OBJECT-TYPE
  175.               SYNTAX  Dot1dBasePortEntry
  176.               ACCESS  not-accessible
  177.               STATUS  mandatory
  178.               DESCRIPTION
  179.                       "A list of information for each port of the
  180.                       bridge."
  181.               REFERENCE
  182.                       "IEEE 802.1D-1990: Section 6.4.2, 6.6.1"
  183.               INDEX  { dot1dBasePort }
  184.               ::= { dot1dBasePortTable 1 }
  186.           Dot1dBasePortEntry ::=
  187.               SEQUENCE {
  188.                   dot1dBasePort
  189.                       INTEGER,
  190.                   dot1dBasePortIfIndex
  191.                       INTEGER,
  192.                   dot1dBasePortCircuit
  193.                       OBJECT IDENTIFIER,
  194.                   dot1dBasePortDelayExceededDiscards
  195.                       Counter,
  196.                   dot1dBasePortMtuExceededDiscards
  197.                       Counter
  198.               }
  200.           dot1dBasePort OBJECT-TYPE
  201.               SYNTAX  INTEGER (1..65535)
  202.               ACCESS  read-only
  203.               STATUS  mandatory
  204.               DESCRIPTION
  205.                       "The port number of the port for which this entry
  206.                       contains bridge management information."
  207.               ::= { dot1dBasePortEntry 1 }
  209.           dot1dBasePortIfIndex OBJECT-TYPE
  210.               SYNTAX  INTEGER
  211.               ACCESS  read-only
  212.               STATUS  mandatory
  213.               DESCRIPTION
  214.                       "The value of the instance of the ifIndex object,
  215.                       defined in MIB-II, for the interface corresponding
  216.                       to this port."
  217.               ::= { dot1dBasePortEntry 2 }
  219.           dot1dBasePortCircuit OBJECT-TYPE
  220.               SYNTAX  OBJECT IDENTIFIER
  221.               ACCESS  read-only
  222.               STATUS  mandatory
  223.               DESCRIPTION
  224.                       "For a port which (potentially) has the same value
  225.                       of dot1dBasePortIfIndex as another port on the
  226.                       same bridge, this object contains the name of an
  227.                       object instance unique to this port.  For example,
  228.                       in the case where multiple ports correspond one-
  229.                       to-one with multiple X.25 virtual circuits, this
  230.                       value might identify an (e.g., the first) object
  231.                       instance associated with the X.25 virtual circuit
  232.                       corresponding to this port.
  234.                       For a port which has a unique value of
  235.                       dot1dBasePortIfIndex, this object can have the
  236.                       value { 0 0 }."
  237.               ::= { dot1dBasePortEntry 3 }
  239.           dot1dBasePortDelayExceededDiscards OBJECT-TYPE
  240.               SYNTAX  Counter
  241.               ACCESS  read-only
  242.               STATUS  mandatory
  243.               DESCRIPTION
  244.                       "The number of frames discarded by this port due
  245.                       to excessive transit delay through the bridge.  It
  246.                       is incremented by both transparent and source
  247.                       route bridges."
  248.               REFERENCE
  249.                        "IEEE 802.1D-1990: Section 6.6.1.1.3"
  250.               ::= { dot1dBasePortEntry 4 }
  252.           dot1dBasePortMtuExceededDiscards OBJECT-TYPE
  253.               SYNTAX  Counter
  254.               ACCESS  read-only
  255.               STATUS  mandatory
  256.               DESCRIPTION
  257.                       "The number of frames discarded by this port due
  258.                       to an excessive size.  It is incremented by both
  259.                       transparent and source route bridges."
  260.               REFERENCE
  261.                       "IEEE 802.1D-1990: Section 6.6.1.1.3"
  262.               ::= { dot1dBasePortEntry 5 }
  264.           -- the dot1dStp group
  266.           -- Implementation of the dot1dStp group is optional.  It is
  267.           -- implemented by those bridges that support the Spanning Tree
  268.           -- Protocol.
  270.           dot1dStpProtocolSpecification OBJECT-TYPE
  271.               SYNTAX  INTEGER {
  272.                           unknown(1),
  273.                           decLb100(2),
  274.                           ieee8021d(3)
  275.                       }
  276.               ACCESS  read-only
  277.               STATUS  mandatory
  278.               DESCRIPTION
  279.                       "An indication of what version of the Spanning
  280.                       Tree Protocol is being run.  The value
  281.                       'decLb100(2)' indicates the DEC LANbridge 100
  282.                       Spanning Tree protocol.  IEEE 802.1d
  283.                       implementations will return 'ieee8021d(3)'.  If
  284.                       future versions of the IEEE Spanning Tree Protocol
  285.                       are released that are incompatible with the
  286.                       current version a new value will be defined."
  287.               ::= { dot1dStp 1 }
  289.           dot1dStpPriority OBJECT-TYPE
  290.               SYNTAX  INTEGER (0..65535)
  291.               ACCESS  read-write
  292.               STATUS  mandatory
  293.               DESCRIPTION
  294.                       "The value of the write-able portion of the Bridge
  295.                       ID, i.e., the first two octets of the (8 octet
  296.                       long) Bridge ID.  The other (last) 6 octets of the
  297.                       Bridge ID are given by the value of
  298.                       dot1dBaseBridgeAddress."
  299.               REFERENCE
  300.                       "IEEE 802.1D-1990: Section 4.5.3.7"
  301.               ::= { dot1dStp 2 }
  303.           dot1dStpTimeSinceTopologyChange OBJECT-TYPE
  304.               SYNTAX  TimeTicks
  305.               ACCESS  read-only
  306.               STATUS  mandatory
  307.               DESCRIPTION
  308.                       "The time (in hundredths of a second) since the
  309.                       last time a topology change was detected by the
  310.                       bridge entity."
  311.               REFERENCE
  312.                       "IEEE 802.1D-1990: Section 6.8.1.1.3"
  313.               ::= { dot1dStp 3 }
  315.           dot1dStpTopChanges OBJECT-TYPE
  316.               SYNTAX  Counter
  317.               ACCESS  read-only
  318.               STATUS  mandatory
  319.               DESCRIPTION
  320.                       "The total number of topology changes detected by
  321.                       this bridge since the management entity was last
  322.                       reset or initialized."
  323.               REFERENCE
  324.                       "IEEE 802.1D-1990: Section 6.8.1.1.3"
  325.               ::= { dot1dStp 4 }
  327.           dot1dStpDesignatedRoot OBJECT-TYPE
  328.               SYNTAX  BridgeId
  329.               ACCESS  read-only
  330.               STATUS  mandatory
  331.               DESCRIPTION
  332.                       "The bridge identifier of the root of the spanning
  333.                       tree as determined by the Spanning Tree Protocol
  334.                       as executed by this node.  This value is used as
  335.                       the Root Identifier parameter in all Configuration
  336.                       Bridge PDUs originated by this node."
  337.               REFERENCE
  338.                       "IEEE 802.1D-1990: Section 4.5.3.1"
  339.               ::= { dot1dStp 5 }
  341.           dot1dStpRootCost OBJECT-TYPE
  342.               SYNTAX  INTEGER
  343.               ACCESS  read-only
  344.               STATUS  mandatory
  345.               DESCRIPTION
  346.                       "The cost of the path to the root as seen from
  347.                       this bridge."
  348.               REFERENCE
  349.                       "IEEE 802.1D-1990: Section 4.5.3.2"
  350.               ::= { dot1dStp 6 }
  352.           dot1dStpRootPort OBJECT-TYPE
  353.               SYNTAX  INTEGER
  354.               ACCESS  read-only
  355.               STATUS  mandatory
  356.               DESCRIPTION
  357.                       "The port number of the port which offers the
  358.                       lowest cost path from this bridge to the root
  359.                       bridge."
  360.               REFERENCE
  361.                       "IEEE 802.1D-1990: Section 4.5.3.3"
  362.               ::= { dot1dStp 7 }
  364.           dot1dStpMaxAge OBJECT-TYPE
  365.               SYNTAX  Timeout
  366.               ACCESS  read-only
  367.               STATUS  mandatory
  368.               DESCRIPTION
  369.                       "The maximum age of Spanning Tree Protocol
  370.                       information learned from the network on any port
  371.                       before it is discarded, in units of hundredths of
  372.                       a second.  This is the actual value that this
  373.                       bridge is currently using."
  374.               REFERENCE
  375.                       "IEEE 802.1D-1990: Section 4.5.3.4"
  376.               ::= { dot1dStp 8 }
  378.           dot1dStpHelloTime OBJECT-TYPE
  379.               SYNTAX  Timeout
  380.               ACCESS  read-only
  381.               STATUS  mandatory
  382.               DESCRIPTION
  383.                       "The amount of time between the transmission of
  384.                       Configuration bridge PDUs by this node on any port
  385.                       when it is the root of the spanning tree or trying
  386.                       to become so, in units of hundredths of a second.
  387.                       This is the actual value that this bridge is
  388.                       currently using."
  389.               REFERENCE
  390.                       "IEEE 802.1D-1990: Section 4.5.3.5"
  391.               ::= { dot1dStp 9 }
  393.           dot1dStpHoldTime OBJECT-TYPE
  394.               SYNTAX  INTEGER
  395.               ACCESS  read-only
  396.               STATUS  mandatory
  397.               DESCRIPTION
  398.                       "This time value determines the interval length
  399.                       during which no more than two Configuration bridge
  400.                       PDUs shall be transmitted by this node, in units
  401.                       of hundredths of a second."
  402.               REFERENCE
  403.                       "IEEE 802.1D-1990: Section 4.5.3.14"
  404.               ::= { dot1dStp 10 }
  406.           dot1dStpForwardDelay OBJECT-TYPE
  407.               SYNTAX  Timeout
  408.               ACCESS  read-only
  409.               STATUS  mandatory
  410.               DESCRIPTION
  411.                       "This time value, measured in units of hundredths
  412.                       of a second, controls how fast a port changes its
  413.                       spanning state when moving towards the Forwarding
  414.                       state.  The value determines how long the port
  415.                       stays in each of the Listening and Learning
  416.                       states, which precede the Forwarding state.  This
  417.                       value is also used, when a topology change has
  418.                       been detected and is underway, to age all dynamic
  419.                       entries in the Forwarding Database.  [Note that
  420.                       this value is the one that this bridge is
  421.                       currently using, in contrast to
  422.                       dot1dStpBridgeForwardDelay which is the value that
  423.                       this bridge and all others would start using
  424.                       if/when this bridge were to become the root.]"
  425.               REFERENCE
  426.                       "IEEE 802.1D-1990: Section 4.5.3.6"
  427.               ::= { dot1dStp 11 }
  429.           dot1dStpBridgeMaxAge OBJECT-TYPE
  430.               SYNTAX  Timeout (600..4000)
  431.               ACCESS  read-write
  432.               STATUS  mandatory
  433.               DESCRIPTION
  434.                       "The value that all bridges use for MaxAge when
  435.                       this bridge is acting as the root.  Note that
  436.                       802.1D-1990 specifies that the range for this
  437.                       parameter is related to the value of
  438.                       dot1dStpBridgeHelloTime. The granularity of this
  439.                       timer is specified by 802.1D-1990 to be 1 second.
  440.                       An agent may return a badValue error if a set is
  441.                       attempted to a value which is not a whole number
  442.                       of seconds."
  443.               REFERENCE
  444.                       "IEEE 802.1D-1990: Section 4.5.3.8"
  445.               ::= { dot1dStp 12 }
  447.           dot1dStpBridgeHelloTime OBJECT-TYPE
  448.               SYNTAX  Timeout (100..1000)
  449.               ACCESS  read-write
  450.               STATUS  mandatory
  451.               DESCRIPTION
  452.                       "The value that all bridges use for HelloTime when
  453.                       this bridge is acting as the root.  The
  454.                       granularity of this timer is specified by 802.1D-
  455.                       1990 to be 1 second.  An agent may return a
  456.                       badValue error if a set is attempted to a value
  457.                       which is not a whole number of seconds."
  458.               REFERENCE
  459.                       "IEEE 802.1D-1990: Section 4.5.3.9"
  460.               ::= { dot1dStp 13 }
  462.           dot1dStpBridgeForwardDelay OBJECT-TYPE
  463.               SYNTAX  Timeout (400..3000)
  464.               ACCESS  read-write
  465.               STATUS  mandatory
  466.               DESCRIPTION
  467.                       "The value that all bridges use for ForwardDelay
  468.                       when this bridge is acting as the root.  Note that
  469.                       802.1D-1990 specifies that the range for this
  470.                       parameter is related to the value of
  471.                       dot1dStpBridgeMaxAge.  The granularity of this
  472.                       timer is specified by 802.1D-1990 to be 1 second.
  473.                       An agent may return a badValue error if a set is
  474.                       attempted to a value which is not a whole number
  475.                       of seconds."
  476.               REFERENCE
  477.                       "IEEE 802.1D-1990: Section 4.5.3.10"
  478.               ::= { dot1dStp 14 }
  481.           -- The Spanning Tree Port Table
  483.           dot1dStpPortTable OBJECT-TYPE
  484.               SYNTAX  SEQUENCE OF Dot1dStpPortEntry
  485.               ACCESS  not-accessible
  486.               STATUS  mandatory
  487.               DESCRIPTION
  488.                       "A table that contains port-specific information
  489.                       for the Spanning Tree Protocol."
  490.               ::= { dot1dStp 15 }
  492.           dot1dStpPortEntry OBJECT-TYPE
  493.               SYNTAX  Dot1dStpPortEntry
  494.               ACCESS  not-accessible
  495.               STATUS  mandatory
  496.               DESCRIPTION
  497.                       "A list of information maintained by every port
  498.                       about the Spanning Tree Protocol state for that
  499.                       port."
  500.               INDEX   { dot1dStpPort }
  501.               ::= { dot1dStpPortTable 1 }
  503.           Dot1dStpPortEntry ::=
  504.               SEQUENCE {
  505.                   dot1dStpPort
  506.                       INTEGER,
  507.                   dot1dStpPortPriority
  508.                       INTEGER,
  509.                   dot1dStpPortState
  510.                       INTEGER,
  511.                   dot1dStpPortEnable
  512.                       INTEGER,
  513.                   dot1dStpPortPathCost
  514.                       INTEGER,
  515.                   dot1dStpPortDesignatedRoot
  516.                       BridgeId,
  517.                   dot1dStpPortDesignatedCost
  518.                       INTEGER,
  519.                   dot1dStpPortDesignatedBridge
  520.                       BridgeId,
  521.                   dot1dStpPortDesignatedPort
  522.                       OCTET STRING,
  523.                   dot1dStpPortForwardTransitions
  524.                       Counter
  525.               }
  527.           dot1dStpPort OBJECT-TYPE
  528.               SYNTAX  INTEGER (1..65535)
  529.               ACCESS  read-only
  530.               STATUS  mandatory
  531.               DESCRIPTION
  532.                       "The port number of the port for which this entry
  533.                       contains Spanning Tree Protocol management
  534.                       information."
  535.               REFERENCE
  536.                       "IEEE 802.1D-1990: Section 6.8.2.1.2"
  537.               ::= { dot1dStpPortEntry 1 }
  539.           dot1dStpPortPriority OBJECT-TYPE
  540.               SYNTAX  INTEGER (0..255)
  541.               ACCESS  read-write
  542.               STATUS  mandatory
  543.               DESCRIPTION
  544.                       "The value of the priority field which is
  545.                       contained in the first (in network byte order)
  546.                       octet of the (2 octet long) Port ID.  The other
  547.                       octet of the Port ID is given by the value of
  548.                       dot1dStpPort."
  549.               REFERENCE
  550.                       "IEEE 802.1D-1990: Section 4.5.5.1"
  551.               ::= { dot1dStpPortEntry 2 }
  553.           dot1dStpPortState OBJECT-TYPE
  554.               SYNTAX  INTEGER {
  555.                           disabled(1),
  556.                           blocking(2),
  557.                           listening(3),
  558.                           learning(4),
  559.                           forwarding(5),
  560.                           broken(6)
  561.                       }
  562.               ACCESS  read-only
  563.               STATUS  mandatory
  564.               DESCRIPTION
  565.                       "The port's current state as defined by
  566.                       application of the Spanning Tree Protocol.  This
  567.                       state controls what action a port takes on
  568.                       reception of a frame.  If the bridge has detected
  569.                       a port that is malfunctioning it will place that
  570.                       port into the broken(6) state.  For ports which
  571.                       are disabled (see dot1dStpPortEnable), this object
  572.                       will have a value of disabled(1)."
  573.               REFERENCE
  574.                       "IEEE 802.1D-1990: Section 4.5.5.2"
  575.               ::= { dot1dStpPortEntry 3 }
  577.           dot1dStpPortEnable OBJECT-TYPE
  578.               SYNTAX  INTEGER {
  579.                           enabled(1),
  580.                           disabled(2)
  581.                       }
  582.               ACCESS  read-write
  583.               STATUS  mandatory
  584.               DESCRIPTION
  585.                       "The enabled/disabled status of the port."
  586.               REFERENCE
  587.                       "IEEE 802.1D-1990: Section 4.5.5.2"
  588.               ::= { dot1dStpPortEntry 4 }
  590.           dot1dStpPortPathCost OBJECT-TYPE
  591.               SYNTAX  INTEGER (1..65535)
  592.               ACCESS  read-write
  593.               STATUS  mandatory
  594.               DESCRIPTION
  595.                       "The contribution of this port to the path cost of
  596.                       paths towards the spanning tree root which include
  597.                       this port.  802.1D-1990 recommends that the
  598.                       default value of this parameter be in inverse
  599.                       proportion to the speed of the attached LAN."
  600.               REFERENCE
  601.                       "IEEE 802.1D-1990: Section 4.5.5.3"
  602.               ::= { dot1dStpPortEntry 5 }
  604.           dot1dStpPortDesignatedRoot OBJECT-TYPE
  605.               SYNTAX  BridgeId
  606.               ACCESS  read-only
  607.               STATUS  mandatory
  608.               DESCRIPTION
  609.                       "The unique Bridge Identifier of the Bridge
  610.                       recorded as the Root in the Configuration BPDUs
  611.                       transmitted by the Designated Bridge for the
  612.                       segment to which the port is attached."
  613.               REFERENCE
  614.                       "IEEE 802.1D-1990: Section 4.5.5.4"
  615.               ::= { dot1dStpPortEntry 6 }
  617.           dot1dStpPortDesignatedCost OBJECT-TYPE
  618.               SYNTAX  INTEGER
  619.               ACCESS  read-only
  620.               STATUS  mandatory
  621.               DESCRIPTION
  622.                       "The path cost of the Designated Port of the
  623.                       segment connected to this port.  This value is
  624.                       compared to the Root Path Cost field in received
  625.                       bridge PDUs."
  626.               REFERENCE
  627.                       "IEEE 802.1D-1990: Section 4.5.5.5"
  628.               ::= { dot1dStpPortEntry 7 }
  630.           dot1dStpPortDesignatedBridge OBJECT-TYPE
  631.               SYNTAX  BridgeId
  632.               ACCESS  read-only
  633.               STATUS  mandatory
  634.               DESCRIPTION
  635.                       "The Bridge Identifier of the bridge which this
  636.                       port considers to be the Designated Bridge for
  637.                       this port's segment."
  638.               REFERENCE
  639.                       "IEEE 802.1D-1990: Section 4.5.5.6"
  640.               ::= { dot1dStpPortEntry 8 }
  642.           dot1dStpPortDesignatedPort OBJECT-TYPE
  643.               SYNTAX  OCTET STRING (SIZE (2))
  644.               ACCESS  read-only
  645.               STATUS  mandatory
  646.               DESCRIPTION
  647.                       "The Port Identifier of the port on the Designated
  648.                       Bridge for this port's segment."
  649.               REFERENCE
  650.                       "IEEE 802.1D-1990: Section 4.5.5.7"
  651.               ::= { dot1dStpPortEntry 9 }
  653.           dot1dStpPortForwardTransitions OBJECT-TYPE
  654.               SYNTAX  Counter
  655.               ACCESS  read-only
  656.               STATUS  mandatory
  657.               DESCRIPTION
  658.                       "The number of times this port has transitioned
  659.                       from the Learning state to the Forwarding state."
  660.               ::= { dot1dStpPortEntry 10 }
  662.           -- the dot1dTp group
  664.           -- Implementation of the dot1dTp group is optional.  It is
  665.           -- implemented by those bridges that support the transparent
  666.           -- bridging mode.  A transparent or SRT bridge will implement
  667.           -- this group.
  669.           dot1dTpLearnedEntryDiscards OBJECT-TYPE
  670.               SYNTAX  Counter
  671.               ACCESS  read-only
  672.               STATUS  mandatory
  673.               DESCRIPTION
  674.                       "The total number of Forwarding Database entries,
  675.                       which have been or would have been learnt, but
  676.                       have been discarded due to a lack of space to
  677.                       store them in the Forwarding Database.  If this
  678.                       counter is increasing, it indicates that the
  679.                       Forwarding Database is regularly becoming full (a
  680.                       condition which has unpleasant performance effects
  681.                       on the subnetwork).  If this counter has a
  682.                       significant value but is not presently increasing,
  683.                       it indicates that the problem has been occurring
  684.                       but is not persistent."
  685.               REFERENCE
  686.                       "IEEE 802.1D-1990: Section 6.7.1.1.3"
  687.               ::= { dot1dTp 1 }
  689.           dot1dTpAgingTime OBJECT-TYPE
  690.               SYNTAX   INTEGER (10..1000000)
  691.               ACCESS   read-write
  692.               STATUS   mandatory
  693.               DESCRIPTION
  694.                       "The timeout period in seconds for aging out
  695.                       dynamically learned forwarding information.
  696.                       802.1D-1990 recommends a default of 300 seconds."
  697.               REFERENCE
  698.                       "IEEE 802.1D-1990: Section 6.7.1.1.3"
  699.               ::= { dot1dTp 2 }
  701.           --  The Forwarding Database for Transparent Bridges
  703.           dot1dTpFdbTable OBJECT-TYPE
  704.               SYNTAX  SEQUENCE OF Dot1dTpFdbEntry
  705.               ACCESS  not-accessible
  706.               STATUS  mandatory
  707.               DESCRIPTION
  708.                       "A table that contains information about unicast
  709.                       entries for which the bridge has forwarding and/or
  710.                       filtering information.  This information is used
  711.                       by the transparent bridging function in
  712.                       determining how to propagate a received frame."
  713.               ::= { dot1dTp 3 }
  715.           dot1dTpFdbEntry OBJECT-TYPE
  716.               SYNTAX  Dot1dTpFdbEntry
  717.               ACCESS  not-accessible
  718.               STATUS  mandatory
  719.               DESCRIPTION
  720.                       "Information about a specific unicast MAC address
  721.                       for which the bridge has some forwarding and/or
  722.                       filtering information."
  723.               INDEX   { dot1dTpFdbAddress }
  724.               ::= { dot1dTpFdbTable 1 }
  726.           Dot1dTpFdbEntry ::=
  727.               SEQUENCE {
  728.                   dot1dTpFdbAddress
  729.                       MacAddress,
  730.                   dot1dTpFdbPort
  731.                       INTEGER,
  732.                   dot1dTpFdbStatus
  733.                       INTEGER
  734.               }
  736.           dot1dTpFdbAddress OBJECT-TYPE
  737.               SYNTAX  MacAddress
  738.               ACCESS  read-only
  739.               STATUS  mandatory
  740.               DESCRIPTION
  741.                       "A unicast MAC address for which the bridge has
  742.                       forwarding and/or filtering information."
  743.               REFERENCE
  744.                       "IEEE 802.1D-1990: Section 3.9.1, 3.9.2"
  745.               ::= { dot1dTpFdbEntry 1 }
  747.           dot1dTpFdbPort OBJECT-TYPE
  748.               SYNTAX  INTEGER
  749.               ACCESS  read-only
  750.               STATUS  mandatory
  751.               DESCRIPTION
  752.                       "Either the value '0', or the port number of the
  753.                       port on which a frame having a source address
  754.                       equal to the value of the corresponding instance
  755.                       of dot1dTpFdbAddress has been seen.  A value of
  756.                       '0' indicates that the port number has not been
  757.                       learned but that the bridge does have some
  758.                       forwarding/filtering information about this
  759.                       address (e.g. in the dot1dStaticTable).
  760.                       Implementors are encouraged to assign the port
  761.                       value to this object whenever it is learned even
  762.                       for addresses for which the corresponding value of
  763.                       dot1dTpFdbStatus is not learned(3)."
  764.               ::= { dot1dTpFdbEntry 2 }
  766.           dot1dTpFdbStatus OBJECT-TYPE
  767.               SYNTAX  INTEGER {
  768.                           other(1),
  769.                           invalid(2),
  770.                           learned(3),
  771.                           self(4),
  772.                           mgmt(5)
  773.                       }
  774.               ACCESS  read-only
  775.               STATUS  mandatory
  776.               DESCRIPTION
  777.                       "The status of this entry.  The meanings of the
  778.                       values are:
  780.                         other(1)   : none of the following.  This would
  781.                                      include the case where some other
  782.                                      MIB object (not the corresponding
  783.                                      instance of dot1dTpFdbPort, nor an
  784.                                      entry in the dot1dStaticTable) is
  785.                                      being used to determine if and how
  786.                                      frames addressed to the value of
  787.                                      the corresponding instance of
  788.                                      dot1dTpFdbAddress are being
  789.                                      forwarded.
  791.                         invalid(2) : this entry is not longer valid
  792.                                      (e.g., it was learned but has since
  793.                                      aged-out), but has not yet been
  794.                                      flushed from the table.
  796.                         learned(3) : the value of the corresponding
  797.                                      instance of dot1dTpFdbPort was
  798.                                      learned, and is being used.
  800.                         self(4)    : the value of the corresponding
  801.                                      instance of dot1dTpFdbAddress
  802.                                      represents one of the bridge's
  803.                                      addresses.  The corresponding
  804.                                      instance of dot1dTpFdbPort
  805.                                      indicates which of the bridge's
  806.                                      ports has this address.
  808.                         mgmt(5)    : the value of the corresponding
  809.                                      instance of dot1dTpFdbAddress is
  810.                                      also the value of an existing
  811.                                      instance of dot1dStaticAddress."
  812.               ::= { dot1dTpFdbEntry 3 }
  815.           --  Port Table for Transparent Bridges
  817.           dot1dTpPortTable OBJECT-TYPE
  818.               SYNTAX  SEQUENCE OF Dot1dTpPortEntry
  819.               ACCESS  not-accessible
  820.               STATUS  mandatory
  821.               DESCRIPTION
  822.                       "A table that contains information about every
  823.                       port that is associated with this transparent
  824.                       bridge."
  825.               ::= { dot1dTp 4 }
  827.           dot1dTpPortEntry OBJECT-TYPE
  828.               SYNTAX  Dot1dTpPortEntry
  829.               ACCESS  not-accessible
  830.               STATUS  mandatory
  831.               DESCRIPTION
  832.                       "A list of information for each port of a
  833.                       transparent bridge."
  834.               INDEX   { dot1dTpPort }
  835.               ::= { dot1dTpPortTable 1 }
  837.           Dot1dTpPortEntry ::=
  838.               SEQUENCE {
  839.                   dot1dTpPort
  840.                       INTEGER,
  841.                   dot1dTpPortMaxInfo
  842.                       INTEGER,
  843.                   dot1dTpPortInFrames
  844.                       Counter,
  845.                   dot1dTpPortOutFrames
  846.                       Counter,
  847.                   dot1dTpPortInDiscards
  848.                       Counter
  849.               }
  851.           dot1dTpPort OBJECT-TYPE
  852.               SYNTAX  INTEGER (1..65535)
  853.               ACCESS  read-only
  854.               STATUS  mandatory
  855.               DESCRIPTION
  856.                       "The port number of the port for which this entry
  857.                       contains Transparent bridging management
  858.                       information."
  859.               ::= { dot1dTpPortEntry 1 }
  861.           -- It would be nice if we could use ifMtu as the size of the
  862.           -- largest INFO field, but we can't because ifMtu is defined
  863.           -- to be the size that the (inter-)network layer can use which
  864.           -- can differ from the MAC layer (especially if several layers
  865.           -- of encapsulation are used).
  867.           dot1dTpPortMaxInfo OBJECT-TYPE
  868.               SYNTAX  INTEGER
  869.               ACCESS  read-only
  870.               STATUS  mandatory
  871.               DESCRIPTION
  872.                       "The maximum size of the INFO (non-MAC) field that
  873.                       this port will receive or transmit."
  874.               ::= { dot1dTpPortEntry 2 }
  876.           dot1dTpPortInFrames OBJECT-TYPE
  877.               SYNTAX  Counter
  878.               ACCESS  read-only
  879.               STATUS  mandatory
  880.               DESCRIPTION
  881.                       "The number of frames that have been received by
  882.                       this port from its segment. Note that a frame
  883.                       received on the interface corresponding to this
  884.                       port is only counted by this object if and only if
  885.                       it is for a protocol being processed by the local
  886.                       bridging function, including bridge management
  887.                       frames."
  888.               REFERENCE
  889.                       "IEEE 802.1D-1990: Section 6.6.1.1.3"
  890.               ::= { dot1dTpPortEntry 3 }
  892.           dot1dTpPortOutFrames OBJECT-TYPE
  893.               SYNTAX  Counter
  894.               ACCESS  read-only
  895.               STATUS  mandatory
  896.               DESCRIPTION
  897.                       "The number of frames that have been transmitted
  898.                       by this port to its segment.  Note that a frame
  899.                       transmitted on the interface corresponding to this
  900.                       port is only counted by this object if and only if
  901.                       it is for a protocol being processed by the local
  902.                       bridging function, including bridge management
  903.                       frames."
  904.               REFERENCE
  905.                       "IEEE 802.1D-1990: Section 6.6.1.1.3"
  906.               ::= { dot1dTpPortEntry 4 }
  908.           dot1dTpPortInDiscards OBJECT-TYPE
  909.               SYNTAX   Counter
  910.               ACCESS   read-only
  911.               STATUS   mandatory
  912.               DESCRIPTION
  913.                       "Count of valid frames received which were
  914.                       discarded (i.e., filtered) by the Forwarding
  915.                       Process."
  916.               REFERENCE
  917.                       "IEEE 802.1D-1990: Section 6.6.1.1.3"
  918.               ::= { dot1dTpPortEntry 5 }
  920.           -- The Static (Destination-Address Filtering) Database
  922.           -- Implementation of this group is optional.
  924.           dot1dStaticTable OBJECT-TYPE
  925.               SYNTAX  SEQUENCE OF Dot1dStaticEntry
  926.               ACCESS  not-accessible
  927.               STATUS  mandatory
  928.               DESCRIPTION
  929.                       "A table containing filtering information
  930.                       configured into the bridge by (local or network)
  931.                       management specifying the set of ports to which
  932.                       frames received from specific ports and containing
  933.                       specific destination addresses are allowed to be
  934.                       forwarded.  The value of zero in this table as the
  935.                       port number from which frames with a specific
  936.                       destination address are received, is used to
  937.                       specify all ports for which there is no specific
  938.                       entry in this table for that particular
  939.                       destination address.  Entries are valid for
  940.                       unicast and for group/broadcast addresses."
  941.               REFERENCE
  942.                       "IEEE 802.1D-1990: Section 6.7.2"
  943.               ::= { dot1dStatic 1 }
  945.           dot1dStaticEntry OBJECT-TYPE
  946.               SYNTAX  Dot1dStaticEntry
  947.               ACCESS  not-accessible
  948.               STATUS  mandatory
  949.               DESCRIPTION
  950.                       "Filtering information configured into the bridge
  951.                       by (local or network) management specifying the
  952.                       set of ports to which frames received from a
  953.                       specific port and containing a specific
  954.                       destination address are allowed to be forwarded."
  955.               REFERENCE
  956.                       "IEEE 802.1D-1990: Section 6.7.2"
  959.               INDEX   { dot1dStaticAddress, dot1dStaticReceivePort }
  960.               ::= { dot1dStaticTable 1 }
  962.           Dot1dStaticEntry ::=
  963.               SEQUENCE {
  964.                   dot1dStaticAddress
  965.                       MacAddress,
  966.                   dot1dStaticReceivePort
  967.                       INTEGER,
  968.                   dot1dStaticAllowedToGoTo
  969.                       OCTET STRING,
  970.                   dot1dStaticStatus
  971.                       INTEGER
  972.               }
  974.           dot1dStaticAddress OBJECT-TYPE
  975.               SYNTAX  MacAddress
  976.               ACCESS  read-write
  977.               STATUS  mandatory
  978.               DESCRIPTION
  979.                       "The destination MAC address in a frame to which
  980.                       this entry's filtering information applies.  This
  981.                       object can take the value of a unicast address, a
  982.                       group address or the broadcast address."
  983.               REFERENCE
  984.                       "IEEE 802.1D-1990: Section 3.9.1, 3.9.2"
  985.               ::= { dot1dStaticEntry 1 }
  987.           dot1dStaticReceivePort OBJECT-TYPE
  988.               SYNTAX  INTEGER
  989.               ACCESS  read-write
  990.               STATUS  mandatory
  991.               DESCRIPTION
  992.                       "Either the value '0', or the port number of the
  993.                       port from which a frame must be received in order
  994.                       for this entry's filtering information to apply.
  995.                       A value of zero indicates that this entry applies
  996.                       on all ports of the bridge for which there is no
  997.                       other applicable entry."
  998.               ::= { dot1dStaticEntry 2 }
  1000.           dot1dStaticAllowedToGoTo OBJECT-TYPE
  1001.               SYNTAX  OCTET STRING
  1002.               ACCESS  read-write
  1003.               STATUS  mandatory
  1004.               DESCRIPTION
  1005.                       "The set of ports to which frames received from a
  1006.                       specific port and destined for a specific MAC
  1007.                       address, are allowed to be forwarded.  Each octet
  1008.                       within the value of this object specifies a set of
  1009.                       eight ports, with the first octet specifying ports
  1010.                       1 through 8, the second octet specifying ports 9
  1011.                       through 16, etc.  Within each octet, the most
  1012.                       significant bit represents the lowest numbered
  1013.                       port, and the least significant bit represents the
  1014.                       highest numbered port.  Thus, each port of the
  1015.                       bridge is represented by a single bit within the
  1016.                       value of this object.  If that bit has a value of
  1017.                       '1' then that port is included in the set of
  1018.                       ports; the port is not included if its bit has a
  1019.                       value of '0'.  (Note that the setting of the bit
  1020.                       corresponding to the port from which a frame is
  1021.                       received is irrelevant.)  The default value of
  1022.                       this object is a string of ones of appropriate
  1023.                       length."
  1024.               ::= { dot1dStaticEntry 3 }
  1026.           dot1dStaticStatus OBJECT-TYPE
  1027.               SYNTAX  INTEGER {
  1028.                           other(1),
  1029.                           invalid(2),
  1030.                           permanent(3),
  1031.                           deleteOnReset(4),
  1032.                           deleteOnTimeout(5)
  1033.                       }
  1034.               ACCESS  read-write
  1035.               STATUS  mandatory
  1036.               DESCRIPTION
  1037.                       "This object indicates the status of this entry.
  1038.                       The default value is permanent(3).
  1040.                            other(1) - this entry is currently in use but
  1041.                                 the conditions under which it will
  1042.                                 remain so are different from each of the
  1043.                                 following values.
  1044.                            invalid(2) - writing this value to the object
  1045.                                 removes the corresponding entry.
  1046.                            permanent(3) - this entry is currently in use
  1047.                                 and will remain so after the next reset
  1048.                                 of the bridge.
  1049.                            deleteOnReset(4) - this entry is currently in
  1050.                                 use and will remain so until the next
  1051.                                 reset of the bridge.
  1052.                            deleteOnTimeout(5) - this entry is currently
  1053.                                 in use and will remain so until it is
  1054.                                 aged out."
  1055.               ::= { dot1dStaticEntry 4 }
  1057.           -- Traps for use by Bridges
  1059.           -- Traps for the Spanning Tree Protocol
  1061.           newRoot TRAP-TYPE
  1062.               ENTERPRISE  dot1dBridge
  1063.               DESCRIPTION
  1064.                       "The newRoot trap indicates that the sending agent
  1065.                       has become the new root of the Spanning Tree; the
  1066.                       trap is sent by a bridge soon after its election
  1067.                       as the new root, e.g., upon expiration of the
  1068.                       Topology Change Timer immediately subsequent to
  1069.                       its election.  Implementation of this trap is
  1070.                       optional."
  1071.               ::= 1
  1073.           topologyChange TRAP-TYPE
  1074.               ENTERPRISE  dot1dBridge
  1075.               DESCRIPTION
  1076.                       "A topologyChange trap is sent by a bridge when
  1077.                       any of its configured ports transitions from the
  1078.                       Learning state to the Forwarding state, or from
  1079.                       the Forwarding state to the Blocking state.  The
  1080.                       trap is not sent if a newRoot trap is sent for the
  1081.                       same transition.  Implementation of this trap is
  1082.                       optional."
  1083.               ::= 2
  1085. END