userapps/opensource/net-snmp/mibs/IF-INVERTED-STACK-MIB.txt

   1 IF-INVERTED-STACK-MIB DEFINITIONS ::= BEGIN
   2
   3 IMPORTS
   4   MODULE-IDENTITY, OBJECT-TYPE, mib-2      FROM SNMPv2-SMI
   5   RowStatus                                FROM SNMPv2-TC
   6   MODULE-COMPLIANCE, OBJECT-GROUP          FROM SNMPv2-CONF
   7   ifStackGroup2,
   8   ifStackHigherLayer, ifStackLowerLayer    FROM IF-MIB;
   9
  10 ifInvertedStackMIB MODULE-IDENTITY
  11   LAST-UPDATED "200006140000Z"
  12   ORGANIZATION "IETF Interfaces MIB Working Group"
  13   CONTACT-INFO
  14           "   Keith McCloghrie
  15               Cisco Systems, Inc.
  16               170 West Tasman Drive
  17               San Jose, CA  95134-1706
  18               US
  19
  20               408-526-5260
  21               kzm@cisco.com"
  22   DESCRIPTION
  23           "The MIB module which provides the Inverted Stack Table for
  24           interface sub-layers."
  25   REVISION      "200006140000Z"
  26   DESCRIPTION
  27           "Initial revision, published as RFC 2864"
  28   ::= { mib-2 77 }
  29
  30 ifInvMIBObjects OBJECT IDENTIFIER ::= { ifInvertedStackMIB 1 }
  31
  32 --
  33 --           The Inverted Interface Stack Group
  34 --
  35
  36 ifInvStackTable  OBJECT-TYPE
  37    SYNTAX        SEQUENCE OF IfInvStackEntry
  38    MAX-ACCESS    not-accessible
  39    STATUS        current
  40    DESCRIPTION
  41           "A table containing information on the relationships between
  42
  43           the multiple sub-layers of network interfaces.  In
  44           particular, it contains information on which sub-layers run
  45           'underneath' which other sub-layers, where each sub-layer
  46           corresponds to a conceptual row in the ifTable.  For
  47           example, when the sub-layer with ifIndex value x runs
  48           underneath the sub-layer with ifIndex value y, then this
  49           table contains:
  50
  51             ifInvStackStatus.x.y=active
  52
  53           For each ifIndex value, z, which identifies an active
  54           interface, there are always at least two instantiated rows
  55           in this table associated with z.  For one of these rows, z
  56           is the value of ifStackHigherLayer; for the other, z is the
  57           value of ifStackLowerLayer.  (If z is not involved in
  58           multiplexing, then these are the only two rows associated
  59           with z.)
  60
  61           For example, two rows exist even for an interface which has
  62           no others stacked on top or below it:
  63
  64             ifInvStackStatus.z.0=active
  65             ifInvStackStatus.0.z=active
  66
  67           This table contains exactly the same number of rows as the
  68           ifStackTable, but the rows appear in a different order."
  69    REFERENCE
  70           "ifStackTable of RFC 2863"
  71    ::= { ifInvMIBObjects 1 }
  72
  73 ifInvStackEntry  OBJECT-TYPE
  74    SYNTAX        IfInvStackEntry
  75    MAX-ACCESS    not-accessible
  76    STATUS        current
  77    DESCRIPTION
  78           "Information on a particular relationship between two sub-
  79           layers, specifying that one sub-layer runs underneath the
  80           other sub-layer.  Each sub-layer corresponds to a conceptual
  81           row in the ifTable."
  82    INDEX { ifStackLowerLayer, ifStackHigherLayer }
  83    ::= { ifInvStackTable 1 }
  84
  85 IfInvStackEntry ::=
  86   SEQUENCE {
  87       ifInvStackStatus       RowStatus
  88    }
  89
  90 ifInvStackStatus  OBJECT-TYPE
  91   SYNTAX         RowStatus
  92   MAX-ACCESS     read-only
  93   STATUS         current
  94   DESCRIPTION
  95           "The status of the relationship between two sub-layers.
  96
  97           An instance of this object exists for each instance of the
  98           ifStackStatus object, and vice versa.  For example, if the
  99           variable ifStackStatus.H.L exists, then the variable
 100           ifInvStackStatus.L.H must also exist, and vice versa.  In
 101           addition, the two variables always have the same value.
 102
 103           However, unlike ifStackStatus, the ifInvStackStatus object
 104           is NOT write-able.  A network management application wishing
 105           to change a relationship between sub-layers H and L cannot
 106           do so by modifying the value of ifInvStackStatus.L.H, but
 107           must instead modify the value of ifStackStatus.H.L.  After
 108           the ifStackTable is modified, the change will be reflected
 109           in this table."
 110   ::= { ifInvStackEntry 1 }
 111
 112 -- conformance information
 113
 114 ifInvConformance OBJECT IDENTIFIER ::= { ifInvMIBObjects 2 }
 115
 116 ifInvGroups      OBJECT IDENTIFIER ::= { ifInvConformance 1 }
 117 ifInvCompliances OBJECT IDENTIFIER ::= { ifInvConformance 2 }
 118
 119 -- compliance statements
 120
 121 ifInvCompliance MODULE-COMPLIANCE
 122   STATUS  current
 123   DESCRIPTION
 124           "The compliance statement for SNMP entities which provide
 125           inverted information on the layering of network interfaces."
 126
 127   MODULE  -- this module
 128       MANDATORY-GROUPS { ifInvStackGroup }
 129
 130       OBJECT       ifInvStackStatus
 131       SYNTAX       INTEGER { active(1) }
 132       DESCRIPTION
 133           "Support is only required for 'active'."
 134
 135   MODULE  IF-MIB
 136       MANDATORY-GROUPS { ifStackGroup2 }
 137   ::= { ifInvCompliances 1 }
 138
 139 -- units of conformance
 140
 141 ifInvStackGroup    OBJECT-GROUP
 142   OBJECTS { ifInvStackStatus }
 143   STATUS  current
 144   DESCRIPTION
 145           "A collection of objects providing inverted information on
 146           the layering of MIB-II interfaces."
 147   ::= { ifInvGroups 1 }
 148
 149 END