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