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