PTOPO-MIB
AI MIB Summary
PTOPO-MIB exposes physical layer connectivity data, including interface adjacency relationships, port status, and link aggregation topology, enabling automated discovery and mapping of network device interconnections.
The MIB module for physical topology information.
Main OID:
ptopoMIB.1.3.6.1.4.1.3727.20.20.3.1.79
39
Objects
Active
Status
6
Dependencies
Imported Objects
Objects
39 total| Object Name |
|---|
ptopoMIBThe MIB module for physical topology information. MODULE-IDENTITY .1.3.6.1.4.1.3727.20.20.3.1.79 |
ptopoMIBObjects OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.79.1 |
ptopoData OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.79.1.1 |
ptopoConnTableThis 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. SEQUENCE OF PtopoConnEntry .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1 |
ptopoConnEntryInformation 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. PtopoConnEntry .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1 |
ptopoConnTimeMarkA TimeFilter for this entry. See the TimeFilter textual
convention in RFC 2021 to see how this works. TimeFilter (RMON2-MIB) .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.1 |
ptopoConnLocalChassisThe entPhysicalIndex value used to identify the chassis
component associated with the local connection endpoint. PhysicalIndex (ENTITY-MIB) .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.2 |
ptopoConnLocalPortThe entPhysicalIndex value used to identify the port
component associated with the local connection endpoint. PhysicalIndex (ENTITY-MIB) .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.3 |
ptopoConnIndexThis 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. Integer32 .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.4 |
ptopoConnRemoteChassisTypeThe 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).rw PtopoChassisIdType .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.5 |
ptopoConnRemoteChassisThe 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).rw PtopoChassisId .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.6 |
ptopoConnRemotePortTypeThe 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).rw PtopoPortIdType .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.7 |
ptopoConnRemotePortThe 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).rw PtopoPortId .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.8 |
ptopoConnDiscAlgorithmAn 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.ro AutonomousType (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.9 |
ptopoConnAgentNetAddrTypeThis 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).rw AddressFamilyNumbers (IANA-ADDRESS-FAMILY-NUMBERS-MIB) .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.10 |
ptopoConnAgentNetAddrThis 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).rw PtopoGenAddr .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.11 |
ptopoConnMultiMacSASeenThis 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.ro PtopoAddrSeenState .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.12 |
ptopoConnMultiNetSASeenThis 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.ro PtopoAddrSeenState .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.13 |
ptopoConnIsStaticThis 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).rw TruthValue (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.14 |
ptopoConnLastVerifyTimeIf 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)').ro TimeStamp (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.15 |
ptopoConnRowStatusThe status of this conceptual row.rw RowStatus (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.79.1.1.1.1.16 |
ptopoGeneral OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.79.1.2 |
ptopoLastChangeTimeThe 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.ro TimeStamp (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.79.1.2.1 |
ptopoConnTabInsertsThe number of times an entry has been inserted into the
ptopoConnTable.ro Counter32 UNITS "table entries" .1.3.6.1.4.1.3727.20.20.3.1.79.1.2.2 |
ptopoConnTabDeletesThe number of times an entry has been deleted from the
ptopoConnTable.ro Counter32 UNITS "table entries" .1.3.6.1.4.1.3727.20.20.3.1.79.1.2.3 |
ptopoConnTabDropsThe 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.ro Counter32 UNITS "table entries" .1.3.6.1.4.1.3727.20.20.3.1.79.1.2.4 |
ptopoConnTabAgeoutsThe number of times an entry has been deleted from the
ptopoConnTable because the information timeliness interval
for that entry has expired.ro Counter32 .1.3.6.1.4.1.3727.20.20.3.1.79.1.2.5 |
ptopoConfig OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.79.1.3 |
ptopoConfigTrapIntervalThis 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.rw Integer32 (0 | 5..3600) UNITS "seconds" .1.3.6.1.4.1.3727.20.20.3.1.79.1.3.1 |
ptopoConfigMaxHoldTimeThis 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.rw Integer32 .1.3.6.1.4.1.3727.20.20.3.1.79.1.3.2 |
ptopoMIBNotifications OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.79.2 |
ptopoMIBTrapPrefix OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.79.2.0 |
ptopoConfigChangeA 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. NOTIFICATION-TYPE .1.3.6.1.4.1.3727.20.20.3.1.79.2.0.1 |
ptopoRegistrationPoints OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.79.3 |
ptopoDiscoveryMechanisms OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.79.3.1 |
ptopoDiscoveryLocal OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.79.3.1.1 |
ptopoConformance OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.79.4 |
ptopoCompliances OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.79.4.1 |
ptopoGroups OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.79.4.2 |