Blame mibs/ietf/PTOPO-MIB

Packit 022b05
PTOPO-MIB DEFINITIONS ::= BEGIN
Packit 022b05
Packit 022b05
IMPORTS
Packit 022b05
    MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
Packit 022b05
    Integer32, Counter32, mib-2
Packit 022b05
        FROM SNMPv2-SMI
Packit 022b05
    TEXTUAL-CONVENTION, AutonomousType, RowStatus, TimeStamp, TruthValue
Packit 022b05
        FROM SNMPv2-TC
Packit 022b05
    MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
Packit 022b05
Packit 022b05
Packit 022b05
        FROM SNMPv2-CONF
Packit 022b05
    TimeFilter
Packit 022b05
        FROM RMON2-MIB
Packit 022b05
    PhysicalIndex
Packit 022b05
        FROM ENTITY-MIB
Packit 022b05
    AddressFamilyNumbers
Packit 022b05
        FROM IANA-ADDRESS-FAMILY-NUMBERS-MIB;
Packit 022b05
Packit 022b05
ptopoMIB MODULE-IDENTITY
Packit 022b05
    LAST-UPDATED "200009210000Z"
Packit 022b05
    ORGANIZATION "IETF; PTOPOMIB Working Group"
Packit 022b05
    CONTACT-INFO
Packit 022b05
       "PTOPOMIB WG Discussion:
Packit 022b05
        ptopo@3com.com
Packit 022b05
        Subscription:
Packit 022b05
        majordomo@3com.com
Packit 022b05
          msg body: [un]subscribe ptopomib
Packit 022b05
Packit 022b05
        Andy Bierman
Packit 022b05
        Cisco Systems Inc.
Packit 022b05
        170 West Tasman Drive
Packit 022b05
        San Jose, CA 95134
Packit 022b05
        408-527-3711
Packit 022b05
        abierman@cisco.com
Packit 022b05
Packit 022b05
        Kendall S. Jones
Packit 022b05
        Nortel Networks
Packit 022b05
        4401 Great America Parkway
Packit 022b05
        Santa Clara, CA 95054
Packit 022b05
        408-495-7356
Packit 022b05
        kejones@nortelnetworks.com"
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The MIB module for physical topology information."
Packit 022b05
    REVISION        "200009210000Z"
Packit 022b05
    DESCRIPTION
Packit 022b05
            "Initial Version of the Physical Topology MIB.  This version
Packit 022b05
            published as RFC 2922."
Packit 022b05
    ::= { mib-2 79 }
Packit 022b05
Packit 022b05
ptopoMIBObjects   OBJECT IDENTIFIER ::= { ptopoMIB 1 }
Packit 022b05
Packit 022b05
Packit 022b05
-- MIB groups
Packit 022b05
ptopoData         OBJECT IDENTIFIER ::= { ptopoMIBObjects 1 }
Packit 022b05
ptopoGeneral      OBJECT IDENTIFIER ::= { ptopoMIBObjects 2 }
Packit 022b05
ptopoConfig       OBJECT IDENTIFIER ::= { ptopoMIBObjects 3 }
Packit 022b05
Packit 022b05
-- textual conventions
Packit 022b05
Packit 022b05
Packit 022b05
PtopoGenAddr ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The value of an address."
Packit 022b05
    SYNTAX      OCTET STRING (SIZE (0..20))
Packit 022b05
Packit 022b05
PtopoChassisIdType ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This TC describes the source of a chassis identifier.
Packit 022b05
Packit 022b05
            The enumeration 'chasIdEntPhysicalAlias(1)' represents a
Packit 022b05
            chassis identifier based on the value of entPhysicalAlias
Packit 022b05
            for a chassis component (i.e., an entPhysicalClass value of
Packit 022b05
            'chassis(3)').
Packit 022b05
Packit 022b05
            The enumeration 'chasIdIfAlias(2)' represents a chassis
Packit 022b05
            identifier based on the value of ifAlias for an interface
Packit 022b05
            on the containing chassis.
Packit 022b05
Packit 022b05
            The enumeration 'chasIdPortEntPhysicalAlias(3)' represents
Packit 022b05
            a chassis identifier based on the value of entPhysicalAlias
Packit 022b05
            for a port or backplane component (i.e., entPhysicalClass
Packit 022b05
            value of 'port(10)' or 'backplane(4)'), within the
Packit 022b05
            containing chassis.
Packit 022b05
Packit 022b05
            The enumeration 'chasIdMacAddress(4)' represents a chassis
Packit 022b05
            identifier based on the value of a unicast source MAC
Packit 022b05
            address (encoded in network byte order and IEEE 802.3
Packit 022b05
            canonical bit order), of a port on the containing chassis.
Packit 022b05
Packit 022b05
            The enumeration 'chasIdPtopoGenAddr(5)' represents a
Packit 022b05
            chassis identifier based on a network address, associated
Packit 022b05
            with a particular chassis.  The encoded address is actually
Packit 022b05
            composed of two fields.  The first field is a single octet,
Packit 022b05
            representing the IANA AddressFamilyNumbers value for the
Packit 022b05
            specific address type, and the second field is the
Packit 022b05
            PtopoGenAddr address value."
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
            chasIdEntPhysicalAlias(1),
Packit 022b05
            chasIdIfAlias(2),
Packit 022b05
            chasIdPortEntPhysicalAlias(3),
Packit 022b05
            chasIdMacAddress(4),
Packit 022b05
            chasIdPtopoGenAddr(5)
Packit 022b05
    }
Packit 022b05
Packit 022b05
PtopoChassisId ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
Packit 022b05
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This TC describes the format of a chassis identifier
Packit 022b05
            string.  Objects of this type are always used with an
Packit 022b05
            associated PtopoChassisIdType object, which identifies the
Packit 022b05
            format of the particular PtopoChassisId object instance.
Packit 022b05
Packit 022b05
            If the associated PtopoChassisIdType object has a value of
Packit 022b05
            'chasIdEntPhysicalAlias(1)', then the octet string
Packit 022b05
            identifies a particular instance of the entPhysicalAlias
Packit 022b05
            object for a chassis component (i.e., an entPhysicalClass
Packit 022b05
            value of 'chassis(3)').
Packit 022b05
Packit 022b05
            If the associated PtopoChassisIdType object has a value of
Packit 022b05
            'chasIdIfAlias(2)', then the octet string identifies a
Packit 022b05
            particular instance of the ifAlias object for an interface
Packit 022b05
            on the containing chassis.
Packit 022b05
Packit 022b05
            If the associated PtopoChassisIdType object has a value of
Packit 022b05
            'chasIdPortEntPhysicalAlias(3)', then the octet string
Packit 022b05
            identifies a particular instance of the entPhysicalAlias
Packit 022b05
            object for a port or backplane component within the
Packit 022b05
            containing chassis.
Packit 022b05
Packit 022b05
            If the associated PtopoChassisIdType object has a value of
Packit 022b05
            'chasIdMacAddress(4)', then this string identifies a
Packit 022b05
            particular unicast source MAC address (encoded in network
Packit 022b05
            byte order and IEEE 802.3 canonical bit order), of a port on
Packit 022b05
            the containing chassis.
Packit 022b05
Packit 022b05
            If the associated PtopoChassisIdType object has a value of
Packit 022b05
            'chasIdPtopoGenAddr(5)', then this string identifies a
Packit 022b05
            particular network address, encoded in network byte order,
Packit 022b05
            associated with one or more ports on the containing chassis.
Packit 022b05
            The first octet contains the IANA Address Family Numbers
Packit 022b05
            enumeration value for the specific address type, and octets
Packit 022b05
            2 through N contain the PtopoGenAddr address value in
Packit 022b05
            network byte order."
Packit 022b05
    SYNTAX      OCTET STRING (SIZE (1..32))
Packit 022b05
Packit 022b05
PtopoPortIdType ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This TC describes the source of a particular type of port
Packit 022b05
            identifier used in the PTOPO MIB.
Packit 022b05
Packit 022b05
            The enumeration 'portIdIfAlias(1)' represents a port
Packit 022b05
            identifier based on the ifAlias MIB object.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
            The enumeration 'portIdPortEntPhysicalAlias(2)' represents a
Packit 022b05
            port identifier based on the value of entPhysicalAlias for a
Packit 022b05
            port or backplane component (i.e., entPhysicalClass value of
Packit 022b05
            'port(10)' or 'backplane(4)'), within the containing
Packit 022b05
            chassis.
Packit 022b05
Packit 022b05
            The enumeration 'portIdMacAddr(3)' represents a port
Packit 022b05
            identifier based on a unicast source MAC address, which has
Packit 022b05
            been detected by the agent and associated with a particular
Packit 022b05
            port.
Packit 022b05
Packit 022b05
            The enumeration 'portIdPtopoGenAddr(4)' represents a port
Packit 022b05
            identifier based on a network address, detected by the agent
Packit 022b05
            and associated with a particular port."
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
            portIdIfAlias(1),
Packit 022b05
            portIdEntPhysicalAlias(2),
Packit 022b05
            portIdMacAddr(3),
Packit 022b05
            portIdPtopoGenAddr(4)
Packit 022b05
    }
Packit 022b05
Packit 022b05
PtopoPortId ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This TC describes the format of a port identifier string.
Packit 022b05
            Objects of this type are always used with an associated
Packit 022b05
            PtopoPortIdType object, which identifies the format of the
Packit 022b05
            particular PtopoPortId object instance.
Packit 022b05
Packit 022b05
            If the associated PtopoPortIdType object has a value of
Packit 022b05
            'portIdIfAlias(1)', then the octet string identifies a
Packit 022b05
            particular instance of the ifAlias object.
Packit 022b05
Packit 022b05
            If the associated PtopoPortIdType object has a value of
Packit 022b05
            'portIdEntPhysicalAlias(2)', then the octet string
Packit 022b05
            identifies a particular instance of the entPhysicalAlias
Packit 022b05
            object for a port component (i.e., entPhysicalClass value of
Packit 022b05
            'port(10)').
Packit 022b05
Packit 022b05
            If the associated PtopoPortIdType object has a value of
Packit 022b05
            'portIdMacAddr(3)', then this string identifies a particular
Packit 022b05
            unicast source MAC address associated with the port.
Packit 022b05
Packit 022b05
            If the associated PtopoPortIdType object has a value of
Packit 022b05
            'portIdPtopoGenAddr(4)', then this string identifies a
Packit 022b05
            network address associated with the port.  The first octet
Packit 022b05
            contains the IANA AddressFamilyNumbers enumeration value for
Packit 022b05
            the specific address type, and octets 2 through N contain
Packit 022b05
Packit 022b05
Packit 022b05
            the PtopoGenAddr address value in network byte order."
Packit 022b05
    SYNTAX      OCTET STRING (SIZE (1..32))
Packit 022b05
Packit 022b05
Packit 022b05
PtopoAddrSeenState ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This TC describes the state of address detection for a
Packit 022b05
            particular type of port identifier used in the PTOPO MIB.
Packit 022b05
Packit 022b05
            The enumeration 'notUsed(1)' represents an entry for which
Packit 022b05
            the particular MIB object is not applicable to the remote
Packit 022b05
            connection endpoint,
Packit 022b05
Packit 022b05
            The enumeration 'unknown(2)' represents an entry for which
Packit 022b05
            the particular address collection state is not known.
Packit 022b05
Packit 022b05
            The enumeration 'oneAddr(3)'  represents an entry for which
Packit 022b05
            exactly one source address (of the type indicated by the
Packit 022b05
            particular MIB object), has been detected.
Packit 022b05
Packit 022b05
            The enumeration 'multiAddr(4)'  represents an entry for
Packit 022b05
            which more than one source address (of the type indicated by
Packit 022b05
            the particular MIB object), has been detected.
Packit 022b05
Packit 022b05
            An agent is expected to set the initial state of the
Packit 022b05
            PtopoAddrSeenState to 'notUsed(1)' or 'unknown(2)'.
Packit 022b05
Packit 022b05
            Note that the PTOPO MIB does not restrict or specify the
Packit 022b05
            means in which the PtopoAddrSeenState is known to an agent.
Packit 022b05
            In particular, an agent may detect this information through
Packit 022b05
            configuration data, or some means other than directly
Packit 022b05
            monitoring all port traffic."
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
            notUsed(1),
Packit 022b05
            unknown(2),
Packit 022b05
            oneAddr(3),
Packit 022b05
            multiAddr(4)
Packit 022b05
    }
Packit 022b05
Packit 022b05
--  ***********************************************************
Packit 022b05
--
Packit 022b05
--           P T O P O    D A T A     G R O U P
Packit 022b05
--
Packit 022b05
--  ***********************************************************
Packit 022b05
Packit 022b05
-- Connection Table
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
ptopoConnTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF PtopoConnEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This table contains one or more rows per physical network
Packit 022b05
            connection known to this agent.  The agent may wish to
Packit 022b05
            ensure that only one ptopoConnEntry is present for each
Packit 022b05
            local port, or it may choose to maintain multiple
Packit 022b05
            ptopoConnEntries for the same local port.
Packit 022b05
Packit 022b05
            Entries based on lower numbered identifier types are
Packit 022b05
            preferred over higher numbered identifier types, i.e., lower
Packit 022b05
            values of the ptopoConnRemoteChassisType and
Packit 022b05
            ptopoConnRemotePortType objects."
Packit 022b05
    ::= { ptopoData 1 }
Packit 022b05
Packit 022b05
ptopoConnEntry       OBJECT-TYPE
Packit 022b05
    SYNTAX      PtopoConnEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "Information about a particular physical network connection.
Packit 022b05
            Entries may be created and deleted in this table, either
Packit 022b05
            manually or by the agent, if a physical topology discovery
Packit 022b05
            process is active."
Packit 022b05
    INDEX   {
Packit 022b05
           ptopoConnTimeMark,
Packit 022b05
           ptopoConnLocalChassis,
Packit 022b05
           ptopoConnLocalPort,
Packit 022b05
           ptopoConnIndex
Packit 022b05
    }
Packit 022b05
    ::= { ptopoConnTable 1 }
Packit 022b05
Packit 022b05
PtopoConnEntry ::= SEQUENCE {
Packit 022b05
      ptopoConnTimeMark            TimeFilter,
Packit 022b05
      ptopoConnLocalChassis        PhysicalIndex,
Packit 022b05
      ptopoConnLocalPort           PhysicalIndex,
Packit 022b05
      ptopoConnIndex               Integer32,
Packit 022b05
      ptopoConnRemoteChassisType   PtopoChassisIdType,
Packit 022b05
      ptopoConnRemoteChassis       PtopoChassisId,
Packit 022b05
      ptopoConnRemotePortType      PtopoPortIdType,
Packit 022b05
      ptopoConnRemotePort          PtopoPortId,
Packit 022b05
      ptopoConnDiscAlgorithm       AutonomousType,
Packit 022b05
      ptopoConnAgentNetAddrType    AddressFamilyNumbers,
Packit 022b05
      ptopoConnAgentNetAddr        PtopoGenAddr,
Packit 022b05
      ptopoConnMultiMacSASeen      PtopoAddrSeenState,
Packit 022b05
      ptopoConnMultiNetSASeen      PtopoAddrSeenState,
Packit 022b05
Packit 022b05
Packit 022b05
      ptopoConnIsStatic            TruthValue,
Packit 022b05
      ptopoConnLastVerifyTime      TimeStamp,
Packit 022b05
      ptopoConnRowStatus           RowStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
ptopoConnTimeMark  OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeFilter
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A TimeFilter for this entry.  See the TimeFilter textual
Packit 022b05
            convention in RFC 2021 to see how this works."
Packit 022b05
    ::= { ptopoConnEntry 1 }
Packit 022b05
Packit 022b05
ptopoConnLocalChassis  OBJECT-TYPE
Packit 022b05
    SYNTAX      PhysicalIndex
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The entPhysicalIndex value used to identify the chassis
Packit 022b05
            component associated with the local connection endpoint."
Packit 022b05
    ::= { ptopoConnEntry 2 }
Packit 022b05
Packit 022b05
ptopoConnLocalPort     OBJECT-TYPE
Packit 022b05
    SYNTAX      PhysicalIndex
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The entPhysicalIndex value used to identify the port
Packit 022b05
            component associated with the local connection endpoint."
Packit 022b05
    ::= { ptopoConnEntry 3 }
Packit 022b05
Packit 022b05
ptopoConnIndex    OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32  (1..2147483647)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This object represents an arbitrary local integer value
Packit 022b05
            used by this agent to identify a particular connection
Packit 022b05
            instance, unique only for the indicated local connection
Packit 022b05
            endpoint.
Packit 022b05
Packit 022b05
            A particular ptopoConnIndex value may be reused in the event
Packit 022b05
            an entry is aged out and later re-learned with the same (or
Packit 022b05
            different) remote chassis and port identifiers.
Packit 022b05
Packit 022b05
            An agent is encouraged to assign monotonically increasing
Packit 022b05
            index values to new entries, starting with one, after each
Packit 022b05
Packit 022b05
Packit 022b05
            reboot.  It is considered unlikely that the ptopoConnIndex
Packit 022b05
            will wrap between reboots."
Packit 022b05
    ::= { ptopoConnEntry 4 }
Packit 022b05
Packit 022b05
ptopoConnRemoteChassisType  OBJECT-TYPE
Packit 022b05
    SYNTAX      PtopoChassisIdType
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The type of encoding used to identify the chassis
Packit 022b05
            associated with the remote connection endpoint.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            ptopoConnRowStatus object has a value of active(1)."
Packit 022b05
    ::= { ptopoConnEntry 5 }
Packit 022b05
Packit 022b05
ptopoConnRemoteChassis  OBJECT-TYPE
Packit 022b05
    SYNTAX      PtopoChassisId
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The string value used to identify the chassis component
Packit 022b05
            associated with the remote connection endpoint.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            ptopoConnRowStatus object has a value of active(1)."
Packit 022b05
    ::= { ptopoConnEntry 6 }
Packit 022b05
Packit 022b05
ptopoConnRemotePortType  OBJECT-TYPE
Packit 022b05
    SYNTAX      PtopoPortIdType
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The type of port identifier encoding used in the associated
Packit 022b05
            'ptopoConnRemotePort' object.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            ptopoConnRowStatus object has a value of active(1)."
Packit 022b05
    ::= { ptopoConnEntry 7 }
Packit 022b05
Packit 022b05
ptopoConnRemotePort  OBJECT-TYPE
Packit 022b05
    SYNTAX      PtopoPortId
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The string value used to identify the port component
Packit 022b05
            associated with the remote connection endpoint.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            ptopoConnRowStatus object has a value of active(1)."
Packit 022b05
    ::= { ptopoConnEntry 8 }
Packit 022b05
Packit 022b05
ptopoConnDiscAlgorithm OBJECT-TYPE
Packit 022b05
    SYNTAX      AutonomousType
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An indication of the algorithm used to discover the
Packit 022b05
            information contained in this conceptual row.
Packit 022b05
Packit 022b05
            A value of ptopoDiscoveryLocal indicates this entry was
Packit 022b05
            configured by the local agent, without use of a discovery
Packit 022b05
            protocol.
Packit 022b05
Packit 022b05
            A value of { 0 0 } indicates this entry was created manually
Packit 022b05
            by an NMS via the associated RowStatus object. "
Packit 022b05
    ::= { ptopoConnEntry 9 }
Packit 022b05
Packit 022b05
ptopoConnAgentNetAddrType  OBJECT-TYPE
Packit 022b05
    SYNTAX      AddressFamilyNumbers
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This network address type of the associated
Packit 022b05
            ptopoConnNetAddr object, unless that object contains a zero
Packit 022b05
            length string.  In such a case, an NMS application should
Packit 022b05
            ignore any returned value for this object.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            ptopoConnRowStatus object has a value of active(1)."
Packit 022b05
    ::= { ptopoConnEntry 10 }
Packit 022b05
Packit 022b05
ptopoConnAgentNetAddr  OBJECT-TYPE
Packit 022b05
    SYNTAX      PtopoGenAddr
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This object identifies a network address which may be used
Packit 022b05
            to reach an SNMP agent entity containing information for the
Packit 022b05
            chassis and port components represented by the associated
Packit 022b05
            'ptopoConnRemoteChassis' and 'ptopoConnRemotePort' objects.
Packit 022b05
            If no such address is known, then this object shall contain
Packit 022b05
            an empty string.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            ptopoConnRowStatus object has a value of active(1)."
Packit 022b05
Packit 022b05
Packit 022b05
    ::= { ptopoConnEntry 11 }
Packit 022b05
Packit 022b05
ptopoConnMultiMacSASeen  OBJECT-TYPE
Packit 022b05
    SYNTAX      PtopoAddrSeenState
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This object indicates if multiple unicast source MAC
Packit 022b05
            addresses have been detected by the agent from the remote
Packit 022b05
            connection endpoint, since the creation of this entry.
Packit 022b05
Packit 022b05
            If this entry has an associated ptopoConnRemoteChassisType
Packit 022b05
            and/or ptopoConnRemotePortType value other than
Packit 022b05
            'portIdMacAddr(3)', then the value 'notUsed(1)' is returned.
Packit 022b05
Packit 022b05
            Otherwise, one of the following conditions must be true:
Packit 022b05
Packit 022b05
            If the agent has not yet detected any unicast source MAC
Packit 022b05
            addresses from the remote port, then the value 'unknown(2)'
Packit 022b05
            is returned.
Packit 022b05
Packit 022b05
            If the agent has detected exactly one unicast source MAC
Packit 022b05
            address from the remote port, then the value 'oneAddr(3)' is
Packit 022b05
            returned.
Packit 022b05
Packit 022b05
            If the agent has detected more than one unicast source MAC
Packit 022b05
            address from the remote port, then the value 'multiAddr(4)'
Packit 022b05
            is returned."
Packit 022b05
    ::= { ptopoConnEntry 12 }
Packit 022b05
Packit 022b05
ptopoConnMultiNetSASeen  OBJECT-TYPE
Packit 022b05
    SYNTAX      PtopoAddrSeenState
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This object indicates if multiple network layer source
Packit 022b05
            addresses have been detected by the agent from the remote
Packit 022b05
            connection endpoint, since the creation of this entry.
Packit 022b05
Packit 022b05
            If this entry has an associated ptopoConnRemoteChassisType
Packit 022b05
            or ptopoConnRemotePortType value other than
Packit 022b05
            'portIdGenAddr(4)' then the value 'notUsed(1)' is returned.
Packit 022b05
Packit 022b05
            Otherwise, one of the following conditions must be true:
Packit 022b05
Packit 022b05
            If the agent has not yet detected any network source
Packit 022b05
            addresses of the appropriate type from the remote port, then
Packit 022b05
            the value 'unknown(2)' is returned.
Packit 022b05
Packit 022b05
Packit 022b05
            If the agent has detected exactly one network source address
Packit 022b05
            of the appropriate type from the remote port, then the value
Packit 022b05
            'oneAddr(3)' is returned.
Packit 022b05
Packit 022b05
            If the agent has detected more than one network source
Packit 022b05
            address (of the same appropriate type) from the remote port,
Packit 022b05
            this the value 'multiAddr(4)' is returned."
Packit 022b05
    ::= { ptopoConnEntry 13 }
Packit 022b05
Packit 022b05
ptopoConnIsStatic  OBJECT-TYPE
Packit 022b05
    SYNTAX      TruthValue
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This object identifies static ptopoConnEntries.  If this
Packit 022b05
            object has the value 'true(1)', then this entry is not
Packit 022b05
            subject to any age-out mechanisms implemented by the agent.
Packit 022b05
Packit 022b05
            If this object has the value 'false(2)', then this entry is
Packit 022b05
            subject to all age-out mechanisms implemented by the agent.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            ptopoConnRowStatus object has a value of active(1)."
Packit 022b05
    DEFVAL { false }
Packit 022b05
    ::= { ptopoConnEntry 14 }
Packit 022b05
Packit 022b05
ptopoConnLastVerifyTime  OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeStamp
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "If the associated value of ptopoConnIsStatic is equal to
Packit 022b05
            'false(2)', then this object contains the value of sysUpTime
Packit 022b05
            at the time the conceptual row was last verified by the
Packit 022b05
            agent, e.g., via reception of a topology protocol message,
Packit 022b05
            pertaining to the associated remote chassis and port.
Packit 022b05
Packit 022b05
            If the associated value of ptopoConnIsStatic is equal to
Packit 022b05
            'true(1)', then this object shall contain the value of
Packit 022b05
            sysUpTime at the time this entry was last activated (i.e.,
Packit 022b05
            ptopoConnRowStatus set to 'active(1)')."
Packit 022b05
    ::= { ptopoConnEntry 15 }
Packit 022b05
Packit 022b05
ptopoConnRowStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      RowStatus
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
            "The status of this conceptual row."
Packit 022b05
    ::= { ptopoConnEntry 16 }
Packit 022b05
Packit 022b05
--  ***********************************************************
Packit 022b05
--
Packit 022b05
--           P T O P O    G E N E R A L     G R O U P
Packit 022b05
--
Packit 022b05
--  ***********************************************************
Packit 022b05
Packit 022b05
-- last change time stamp for the whole MIB
Packit 022b05
Packit 022b05
ptopoLastChangeTime OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeStamp
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The value of sysUpTime at the time a conceptual row is
Packit 022b05
            created, modified, or deleted in the ptopoConnTable.
Packit 022b05
Packit 022b05
            An NMS can use this object to reduce polling of the
Packit 022b05
            ptopoData group objects."
Packit 022b05
    ::= { ptopoGeneral 1 }
Packit 022b05
Packit 022b05
ptopoConnTabInserts OBJECT-TYPE
Packit 022b05
    SYNTAX      Counter32
Packit 022b05
    UNITS       "table entries"
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The number of times an entry has been inserted into the
Packit 022b05
            ptopoConnTable."
Packit 022b05
    ::= { ptopoGeneral 2 }
Packit 022b05
Packit 022b05
ptopoConnTabDeletes OBJECT-TYPE
Packit 022b05
    SYNTAX      Counter32
Packit 022b05
    UNITS       "table entries"
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The number of times an entry has been deleted from the
Packit 022b05
            ptopoConnTable."
Packit 022b05
    ::= { ptopoGeneral 3 }
Packit 022b05
Packit 022b05
ptopoConnTabDrops OBJECT-TYPE
Packit 022b05
    SYNTAX      Counter32
Packit 022b05
    UNITS       "table entries"
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
Packit 022b05
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The number of times an entry would have been added to the
Packit 022b05
            ptopoConnTable, (e.g., via information learned from a
Packit 022b05
            topology protocol), but was not because of insufficient
Packit 022b05
            resources."
Packit 022b05
    ::= { ptopoGeneral 4 }
Packit 022b05
Packit 022b05
ptopoConnTabAgeouts OBJECT-TYPE
Packit 022b05
    SYNTAX      Counter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The number of times an entry has been deleted from the
Packit 022b05
            ptopoConnTable because the information timeliness interval
Packit 022b05
            for that entry has expired."
Packit 022b05
    ::= { ptopoGeneral 5 }
Packit 022b05
Packit 022b05
--  ***********************************************************
Packit 022b05
--
Packit 022b05
--           P T O P O    C O N F I G     G R O U P
Packit 022b05
--
Packit 022b05
--  ***********************************************************
Packit 022b05
Packit 022b05
ptopoConfigTrapInterval OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (0 | 5..3600)
Packit 022b05
    UNITS       "seconds"
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This object controls the transmission of PTOPO
Packit 022b05
            notifications.
Packit 022b05
Packit 022b05
            If this object has a value of zero, then no
Packit 022b05
            ptopoConfigChange notifications will be transmitted by the
Packit 022b05
            agent.
Packit 022b05
Packit 022b05
            If this object has a non-zero value, then the agent must not
Packit 022b05
            generate more than one ptopoConfigChange trap-event in the
Packit 022b05
            indicated period, where a 'trap-event' is the transmission
Packit 022b05
            of a single notification PDU type to a list of notification
Packit 022b05
            destinations.  If additional configuration changes occur
Packit 022b05
            within the indicated throttling period, then these trap-
Packit 022b05
            events must be suppressed by the agent. An NMS should
Packit 022b05
            periodically check the value of ptopoLastChangeTime to
Packit 022b05
            detect any missed ptopoConfigChange trap-events, e.g. due to
Packit 022b05
            throttling or transmission loss.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
            If notification transmission is enabled, the suggested
Packit 022b05
            default throttling period is 60 seconds, but transmission
Packit 022b05
            should be disabled by default.
Packit 022b05
Packit 022b05
            If the agent is capable of storing non-volatile
Packit 022b05
            configuration, then the value of this object must be
Packit 022b05
            restored after a re-initialization of the management
Packit 022b05
            system."
Packit 022b05
    DEFVAL { 0 }
Packit 022b05
    ::= { ptopoConfig 1 }
Packit 022b05
Packit 022b05
ptopoConfigMaxHoldTime OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (1..2147483647)
Packit 022b05
    UNITS       "seconds"
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This object specifies the desired time interval for which
Packit 022b05
            an agent will maintain dynamic ptopoConnEntries.
Packit 022b05
Packit 022b05
            After the specified number of seconds since the last time an
Packit 022b05
            entry was verified, in the absence of new verification
Packit 022b05
            (e.g., receipt of a topology protocol message), the agent
Packit 022b05
            shall remove the entry.  Note that entries may not always be
Packit 022b05
            removed immediately, but may possibly be removed at periodic
Packit 022b05
            garbage collection intervals.
Packit 022b05
            This object only affects dynamic ptopoConnEntries, i.e.  for
Packit 022b05
            which ptopoConnIsStatic equals 'false(2)'. Static entries
Packit 022b05
            are not aged out.
Packit 022b05
Packit 022b05
            Note that dynamic ptopoConnEntries may also be removed by
Packit 022b05
            the agent due to the expired timeliness of learned topology
Packit 022b05
            information (e.g., timeliness interval for a remote port
Packit 022b05
            expires).  The actual age-out interval for a given entry is
Packit 022b05
            defined by the following formula:
Packit 022b05
Packit 022b05
              age-out-time =
Packit 022b05
                min(ptopoConfigMaxHoldTime, <entry-specific hold-time>)
Packit 022b05
Packit 022b05
            where <entry-specific hold-time> is determined by the
Packit 022b05
            discovery algorithm, and may be different for each entry."
Packit 022b05
    DEFVAL { 300 }
Packit 022b05
    ::= { ptopoConfig 2 }
Packit 022b05
Packit 022b05
Packit 022b05
-- PTOPO MIB Notification Definitions
Packit 022b05
ptopoMIBNotifications  OBJECT IDENTIFIER ::= { ptopoMIB 2 }
Packit 022b05
ptopoMIBTrapPrefix     OBJECT IDENTIFIER ::=
Packit 022b05
Packit 022b05
Packit 022b05
      { ptopoMIBNotifications 0 }
Packit 022b05
Packit 022b05
ptopoConfigChange NOTIFICATION-TYPE
Packit 022b05
    OBJECTS       {
Packit 022b05
             ptopoConnTabInserts,
Packit 022b05
             ptopoConnTabDeletes,
Packit 022b05
             ptopoConnTabDrops,
Packit 022b05
             ptopoConnTabAgeouts
Packit 022b05
    }
Packit 022b05
    STATUS        current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A ptopoConfigChange notification is sent when the value of
Packit 022b05
            ptopoLastChangeTime changes. It can be utilized by an NMS to
Packit 022b05
            trigger physical topology table maintenance polls.
Packit 022b05
Packit 022b05
            Note that transmission of ptopoConfigChange notifications
Packit 022b05
            are throttled by the agent, as specified by the
Packit 022b05
            'ptopoConfigTrapInterval' object."
Packit 022b05
   ::= { ptopoMIBTrapPrefix 1 }
Packit 022b05
Packit 022b05
Packit 022b05
-- PTOPO Registration Points
Packit 022b05
ptopoRegistrationPoints  OBJECT IDENTIFIER ::= { ptopoMIB 3 }
Packit 022b05
Packit 022b05
-- values used with ptopoConnDiscAlgorithm object
Packit 022b05
ptopoDiscoveryMechanisms OBJECT IDENTIFIER ::=
Packit 022b05
      { ptopoRegistrationPoints 1 }
Packit 022b05
Packit 022b05
ptopoDiscoveryLocal      OBJECT IDENTIFIER ::=
Packit 022b05
      { ptopoDiscoveryMechanisms 1 }
Packit 022b05
Packit 022b05
Packit 022b05
-- conformance information
Packit 022b05
ptopoConformance OBJECT IDENTIFIER ::= { ptopoMIB 4 }
Packit 022b05
Packit 022b05
ptopoCompliances OBJECT IDENTIFIER ::= { ptopoConformance 1 }
Packit 022b05
ptopoGroups      OBJECT IDENTIFIER ::= { ptopoConformance 2 }
Packit 022b05
Packit 022b05
Packit 022b05
-- compliance statements
Packit 022b05
ptopoCompliance MODULE-COMPLIANCE
Packit 022b05
   STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The compliance statement for SNMP entities which implement
Packit 022b05
            the PTOPO MIB."
Packit 022b05
    MODULE  -- this module
Packit 022b05
        MANDATORY-GROUPS {
Packit 022b05
              ptopoDataGroup,
Packit 022b05
Packit 022b05
Packit 022b05
              ptopoGeneralGroup,
Packit 022b05
              ptopoConfigGroup,
Packit 022b05
              ptopoNotificationsGroup
Packit 022b05
        }
Packit 022b05
    ::= { ptopoCompliances 1 }
Packit 022b05
Packit 022b05
-- MIB groupings
Packit 022b05
ptopoDataGroup   OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
         ptopoConnRemoteChassisType,
Packit 022b05
         ptopoConnRemoteChassis,
Packit 022b05
         ptopoConnRemotePortType,
Packit 022b05
         ptopoConnRemotePort,
Packit 022b05
         ptopoConnDiscAlgorithm,
Packit 022b05
         ptopoConnAgentNetAddrType,
Packit 022b05
         ptopoConnAgentNetAddr,
Packit 022b05
         ptopoConnMultiMacSASeen,
Packit 022b05
         ptopoConnMultiNetSASeen,
Packit 022b05
         ptopoConnIsStatic,
Packit 022b05
         ptopoConnLastVerifyTime,
Packit 022b05
         ptopoConnRowStatus
Packit 022b05
    }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The collection of objects which are used to represent
Packit 022b05
            physical topology information for which a single agent
Packit 022b05
            provides management information.
Packit 022b05
Packit 022b05
            This group is mandatory for all implementations of the PTOPO
Packit 022b05
            MIB."
Packit 022b05
    ::= { ptopoGroups 1 }
Packit 022b05
Packit 022b05
ptopoGeneralGroup    OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
         ptopoLastChangeTime,
Packit 022b05
         ptopoConnTabInserts,
Packit 022b05
         ptopoConnTabDeletes,
Packit 022b05
         ptopoConnTabDrops,
Packit 022b05
         ptopoConnTabAgeouts
Packit 022b05
    }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The collection of objects which are used to report the
Packit 022b05
            general status of the PTOPO MIB implementation.
Packit 022b05
Packit 022b05
            This group is mandatory for all agents which implement the
Packit 022b05
            PTOPO MIB."
Packit 022b05
    ::= { ptopoGroups 2 }
Packit 022b05
Packit 022b05
Packit 022b05
ptopoConfigGroup    OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
         ptopoConfigTrapInterval,
Packit 022b05
         ptopoConfigMaxHoldTime
Packit 022b05
    }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The collection of objects which are used to configure the
Packit 022b05
            PTOPO MIB implementation behavior.
Packit 022b05
Packit 022b05
            This group is mandatory for agents which implement the PTOPO
Packit 022b05
            MIB."
Packit 022b05
    ::= { ptopoGroups 3 }
Packit 022b05
Packit 022b05
ptopoNotificationsGroup NOTIFICATION-GROUP
Packit 022b05
    NOTIFICATIONS {
Packit 022b05
         ptopoConfigChange
Packit 022b05
    }
Packit 022b05
    STATUS        current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The collection of notifications used to indicate PTOPO MIB
Packit 022b05
            data consistency and general status information.
Packit 022b05
Packit 022b05
            This group is mandatory for agents which implement the PTOPO
Packit 022b05
            MIB."
Packit 022b05
    ::= { ptopoGroups 4 }
Packit 022b05
Packit 022b05
END