DISMAN-PING-MIB Table View

Table-centric layout grouping table, row, and column objects.

Tables
3
Rows
3
Columns
38
.1.3.6.1.2.1.80.1.2 · 1 row entry · 23 columns
Defines the ping Control Table for providing, via SNMP,
the capability of performing ping operations at
a remote host.  The results of these operations are
stored in the pingResultsTable and the
pingProbeHistoryTable.
pingCtlEntry entry .1.3.6.1.2.1.80.1.2.1
Defines an entry in the pingCtlTable. The first index
element, pingCtlOwnerIndex, is of type SnmpAdminString,
a textual convention that allows for use of the SNMPv3
View-Based Access Control Model (RFC 3415, VACM)
and …
Indexes
pingCtlOwnerIndex pingCtlTestName
Column Syntax OID
pingCtlOwnerIndex
To facilitate the provisioning of access control by a
security administrator using the View-Based Access
Control Model (RFC 2575, VACM) for tables in which
multiple users may need to create or
modify entries independent…
OctetString
Constraints:
range: 0-32
.1.3.6.1.2.1.80.1.2.1.1
pingCtlTestName
The name of the ping test. This is locally unique, within
the scope of a pingCtlOwnerIndex.
OctetString
Constraints:
range: 0-32
.1.3.6.1.2.1.80.1.2.1.2
pingCtlTargetAddressType
Specifies the type of host address to be used at a remote
host for performing a ping operation.
INET-ADDRESS-MIBInetAddressTyper/w
Textual Convention: INET-ADDRESS-MIBInetAddressType Enumeration
Type Values:
0unknown
1ipv4
2ipv6
3ipv4z
4ipv6z
16dns
25l2vpn
.1.3.6.1.2.1.80.1.2.1.3
pingCtlTargetAddress
Specifies the host address to be used at a remote host for
performing a ping operation. The host address type is
determined by the value of the corresponding
pingCtlTargetAddressType.

A value for this ob…
INET-ADDRESS-MIBInetAddressr/w
Textual Convention: INET-ADDRESS-MIBInetAddress OctetString
Type Constraints:
range: 0..255
.1.3.6.1.2.1.80.1.2.1.4
pingCtlDataSize
Specifies the size of the data portion to be
transmitted in a ping operation, in octets. Whether this
value can be applied depends on the selected
implementation method for performing a ping operation,
indicated by pin…
octetsUnsigned32r/w
Constraints:
range: 0-65507
.1.3.6.1.2.1.80.1.2.1.5
pingCtlTimeOut
Specifies the time-out value, in seconds, for a
remote ping operation.
secondsUnsigned32r/w
Constraints:
range: 1-60
.1.3.6.1.2.1.80.1.2.1.6
pingCtlProbeCount
Specifies the number of times to perform a ping
operation at a remote host as part of a single ping test.
probesUnsigned32r/w
Constraints:
range: 1-15
.1.3.6.1.2.1.80.1.2.1.7
pingCtlAdminStatus
Reflects the desired state that a pingCtlEntry should be
in:

enabled(1) - Attempt to activate the test as defined by
this pingCtlEntry.
disabled(2) - Deactivate the test as defined…
Enumerationr/w
Enumerated Values:
1enabled
2disabled
.1.3.6.1.2.1.80.1.2.1.8
pingCtlDataFill
The content of this object is used together with the
corresponding pingCtlDataSize value to determine how to
fill the data portion of a probe packet. The option of
selecting a data fill pattern can be useful when links…
OctetStringr/w
Constraints:
range: 0-1024
.1.3.6.1.2.1.80.1.2.1.9
pingCtlFrequency
The number of seconds to wait before repeating a ping test
as defined by the value of the various objects in the
corresponding row.

A single ping test consists of a series of ping probes.
The number of pr…
secondsSNMPv2-SMIUnsigned32r/w
Textual Convention: SNMPv2-SMIUnsigned32 Unsigned32
Type Constraints:
range: 0..4294967295
.1.3.6.1.2.1.80.1.2.1.10
pingCtlMaxRows
The maximum number of corresponding entries allowed
in the pingProbeHistoryTable. An implementation of this
MIB will remove the oldest corresponding entry in the
pingProbeHistoryTable to allow the addition of an
new en…
rowsSNMPv2-SMIUnsigned32r/w
Textual Convention: SNMPv2-SMIUnsigned32 Unsigned32
Type Constraints:
range: 0..4294967295
.1.3.6.1.2.1.80.1.2.1.11
pingCtlStorageType
The storage type for this conceptual row.
Conceptual rows having the value 'permanent' need not
allow write-access to any columnar objects in the row.
SNMPv2-TCStorageTyper/w
Textual Convention: SNMPv2-TCStorageType Enumeration
Type Values:
1other
2volatile
3nonVolatile
4permanent
5readOnly
.1.3.6.1.2.1.80.1.2.1.12
pingCtlTrapGeneration
The value of this object determines when and whether
to generate a notification for this entry:

probeFailure(0) - Generate a pingProbeFailed
notification subject to the value of
pingCtlTrapProbe…
Bitsr/w
Enumerated Values:
0probeFailure
1testFailure
2testCompletion
.1.3.6.1.2.1.80.1.2.1.13
pingCtlTrapProbeFailureFilter
The value of this object is used to determine when
to generate a pingProbeFailed NOTIFICATION.

Setting BIT probeFailure(0) of object
pingCtlTrapGeneration to '1' implies that a
pingProbeFailed NOTIFICATIO…
Unsigned32r/w
Constraints:
range: 0-15
.1.3.6.1.2.1.80.1.2.1.14
pingCtlTrapTestFailureFilter
The value of this object is used to determine when
to generate a pingTestFailed NOTIFICATION.

Setting BIT testFailure(1) of object

pingCtlTrapGeneration to '1' implies that a
pingTestFailed…
Unsigned32r/w
Constraints:
range: 0-15
.1.3.6.1.2.1.80.1.2.1.15
pingCtlType
The value of this object is used either to report or
to select the implementation method to be used for
calculating a ping response time. The value of this
object MAY be selected from pingImplementationTypeDomains.
ObjectIdentifierr/w .1.3.6.1.2.1.80.1.2.1.16
pingCtlDescr
The purpose of this object is to provide a
descriptive name of the remote ping test.
SNMP-FRAMEWORK-MIBSnmpAdminStringr/w
Textual Convention: SNMP-FRAMEWORK-MIBSnmpAdminString OctetString
Type Constraints:
range: 0..255
.1.3.6.1.2.1.80.1.2.1.17
pingCtlSourceAddressType
Specifies the type of the source address,
pingCtlSourceAddress, to be used at a remote host
when a ping operation is performed.
INET-ADDRESS-MIBInetAddressTyper/w
Textual Convention: INET-ADDRESS-MIBInetAddressType Enumeration
Type Values:
0unknown
1ipv4
2ipv6
3ipv4z
4ipv6z
16dns
25l2vpn
.1.3.6.1.2.1.80.1.2.1.18
pingCtlSourceAddress
Use the specified IP address (which must be given in
numeric form, not as a hostname) as the source address
in outgoing probe packets. On hosts with more than one
IP address, this option can be used to select the addre…
INET-ADDRESS-MIBInetAddressr/w
Textual Convention: INET-ADDRESS-MIBInetAddress OctetString
Type Constraints:
range: 0..255
.1.3.6.1.2.1.80.1.2.1.19
pingCtlIfIndex
Setting this object to an interface's ifIndex prior
to starting a remote ping operation directs
the ping probes to be transmitted over the
specified interface. A value of zero for this object
means that this option is …
IF-MIBInterfaceIndexOrZeror/w
Textual Convention: IF-MIBInterfaceIndexOrZero Integer32
Type Constraints:
range: 0..2147483647
.1.3.6.1.2.1.80.1.2.1.20
pingCtlByPassRouteTable
The purpose of this object is to enable optional
bypassing the route table. If enabled, the remote
host will bypass the normal routing tables and send
directly to a host on an attached network. If the
host is not on a…
SNMPv2-TCTruthValuer/w
Textual Convention: SNMPv2-TCTruthValue Enumeration
Type Values:
1true
2false
.1.3.6.1.2.1.80.1.2.1.21
pingCtlDSField
Specifies the value to store in the Type of Service
(TOS) octet in the IPv4 header or in the Traffic
Class octet in the IPv6 header, respectively, of the
IP packet used to encapsulate the ping probe.

The …
Unsigned32r/w
Constraints:
range: 0-255
.1.3.6.1.2.1.80.1.2.1.22
pingCtlRowStatus
This object allows entries to be created and deleted
in the pingCtlTable. Deletion of an entry in this
table results in the deletion of all corresponding (same
pingCtlOwnerIndex and pingCtlTestName index values)
pingRe…
SNMPv2-TCRowStatusr/w
Textual Convention: SNMPv2-TCRowStatus Enumeration
Type Values:
1active
2notInService
3notReady
4createAndGo
5createAndWait
6destroy
.1.3.6.1.2.1.80.1.2.1.23
.1.3.6.1.2.1.80.1.3 · 1 row entry · 10 columns
Defines the Ping Results Table for providing
the capability of performing ping operations at
a remote host.  The results of these operations are
stored in the pingResultsTable and the pingProbeHistoryTable.
          
An entry is added to the pingResultsTable when an
pingCtlEntry is started by successful transition
of its pingCtlAdminStatus object to enabled(1).
          
If the object pingCtlAdminStatus already has the value
enabled(1), and if the corresponding pingResultsOperStatus
object has the value completed(3), then successfully writing
enabled(1) to object pingCtlAdminStatus re-initializes the
already existing entry in the pingResultsTable.  The values
of objects in the re-initialized entry are the same as the
values of objects in a new entry would be.
          
An entry is removed from the pingResultsTable when
its corresponding pingCtlEntry is deleted.
pingResultsEntry entry .1.3.6.1.2.1.80.1.3.1
Defines an entry in the pingResultsTable. The
pingResultsTable has the same indexing as the
pingCtlTable so that a pingResultsEntry
corresponds to the pingCtlEntry that caused it to
be created.
Indexes
pingCtlOwnerIndex pingCtlTestName
Column Syntax OID
pingResultsOperStatus
Reflects the operational state of a pingCtlEntry:

enabled(1) - Test is active.
disabled(2) - Test has stopped.
completed(3) - Test is completed.
Enumeration
Enumerated Values:
1enabled
2disabled
3completed
.1.3.6.1.2.1.80.1.3.1.1
pingResultsIpTargetAddressType
This object indicates the type of address stored
in the corresponding pingResultsIpTargetAddress
object.
INET-ADDRESS-MIBInetAddressType
Textual Convention: INET-ADDRESS-MIBInetAddressType Enumeration
Type Values:
0unknown
1ipv4
2ipv6
3ipv4z
4ipv6z
16dns
25l2vpn
.1.3.6.1.2.1.80.1.3.1.2
pingResultsIpTargetAddress
This object reports the IP address associated
with a pingCtlTargetAddress value when the destination
address is specified as a DNS name. The value of
this object should be a zero-length octet string
when a DNS name is …
INET-ADDRESS-MIBInetAddress
Textual Convention: INET-ADDRESS-MIBInetAddress OctetString
Type Constraints:
range: 0..255
.1.3.6.1.2.1.80.1.3.1.3
pingResultsMinRtt
The minimum ping round-trip-time (RTT) received. A value
of 0 for this object implies that no RTT has been received.
millisecondsSNMPv2-SMIUnsigned32
Textual Convention: SNMPv2-SMIUnsigned32 Unsigned32
Type Constraints:
range: 0..4294967295
.1.3.6.1.2.1.80.1.3.1.4
pingResultsMaxRtt
The maximum ping round-trip-time (RTT) received. A value
of 0 for this object implies that no RTT has been received.
millisecondsSNMPv2-SMIUnsigned32
Textual Convention: SNMPv2-SMIUnsigned32 Unsigned32
Type Constraints:
range: 0..4294967295
.1.3.6.1.2.1.80.1.3.1.5
pingResultsAverageRtt
The current average ping round-trip-time (RTT).
millisecondsSNMPv2-SMIUnsigned32
Textual Convention: SNMPv2-SMIUnsigned32 Unsigned32
Type Constraints:
range: 0..4294967295
.1.3.6.1.2.1.80.1.3.1.6
pingResultsProbeResponses
Number of responses received for the corresponding
pingCtlEntry and pingResultsEntry. The value of this object
MUST be reported as 0 when no probe responses have been
received.
responsesSNMPv2-SMIGauge32
Textual Convention: SNMPv2-SMIGauge32 Unsigned32
Type Constraints:
range: 0..4294967295
.1.3.6.1.2.1.80.1.3.1.7
pingResultsSentProbes
The value of this object reflects the number of probes sent
for the corresponding pingCtlEntry and pingResultsEntry.
The value of this object MUST be reported as 0 when no probes
have been sent.
probesSNMPv2-SMIGauge32
Textual Convention: SNMPv2-SMIGauge32 Unsigned32
Type Constraints:
range: 0..4294967295
.1.3.6.1.2.1.80.1.3.1.8
pingResultsRttSumOfSquares
This object contains the sum of the squares for all ping
responses received. Its purpose is to enable standard
deviation calculation. The value of this object MUST
be reported as 0 when no ping responses have been
rec…
millisecondsSNMPv2-SMIUnsigned32
Textual Convention: SNMPv2-SMIUnsigned32 Unsigned32
Type Constraints:
range: 0..4294967295
.1.3.6.1.2.1.80.1.3.1.9
pingResultsLastGoodProbe
Date and time when the last response was received for
a probe.
SNMPv2-TCDateAndTime
Textual Convention: SNMPv2-TCDateAndTime OctetString
Type Constraints:
range: 8
range: 11
.1.3.6.1.2.1.80.1.3.1.10
.1.3.6.1.2.1.80.1.4 · 1 row entry · 5 columns
Defines a table for storing the results of ping
operations.  The number of entries in this table is
limited per entry in the pingCtlTable by the value
of the corresponding pingCtlMaxRows object.
          
An entry in this table is created when the result of
a ping probe is determined.  The initial 2 instance
identifier index values identify the pingCtlEntry
that a probe result (pingProbeHistoryEntry) belongs
to.  An entry is removed from this table when
its corresponding pingCtlEntry is deleted.
          
An implementation of this MIB will remove the oldest
entry in the pingProbeHistoryTable of the
corresponding entry in the pingCtlTable to allow
the addition of an new entry once the number of rows
in the pingProbeHistoryTable reaches the value
specified by pingCtlMaxRows for the corresponding
entry in the pingCtlTable.
pingProbeHistoryEntry entry .1.3.6.1.2.1.80.1.4.1
Defines an entry in the pingProbeHistoryTable.
The first two index elements identify the
pingCtlEntry that a pingProbeHistoryEntry belongs
to. The third index element selects a single
probe result.
Indexes
pingCtlOwnerIndex pingCtlTestName pingProbeHistoryIndex
Column Syntax OID
pingProbeHistoryIndex
An entry in this table is created when the result of
a ping probe is determined. The initial 2 instance
identifier index values identify the pingCtlEntry
that a probe result (pingProbeHistoryEntry) belongs
to.
Unsigned32
Constraints:
range: 1-4294967295
.1.3.6.1.2.1.80.1.4.1.1
pingProbeHistoryResponse
The amount of time measured in milliseconds from when
a probe was sent to when its response was received or
when it timed out. The value of this object is reported
as 0 when it is not possible to transmit a probe.
millisecondsSNMPv2-SMIUnsigned32
Textual Convention: SNMPv2-SMIUnsigned32 Unsigned32
Type Constraints:
range: 0..4294967295
.1.3.6.1.2.1.80.1.4.1.2
pingProbeHistoryStatus
The result of a particular probe done by a remote host.
OperationResponseStatus
Textual Convention: OperationResponseStatus Enumeration
Type Values:
1responseReceived
2unknown
3internalError
4requestTimedOut
5unknownDestinationAddress
6noRouteToTarget
7interfaceInactiveToTarget
8arpFailure
9maxConcurrentLimitReached
10unableToResolveDnsName
11invalidHostAddress
.1.3.6.1.2.1.80.1.4.1.3
pingProbeHistoryLastRC
The last implementation-method-specific reply code received.
If the ICMP Echo capability is being used, then a successful
probe ends when an ICMP response is received that contains
the code ICMP_ECHOREPLY(0). The ICMP …
SNMPv2-SMIInteger32
Textual Convention: SNMPv2-SMIInteger32 Integer32
Type Constraints:
range: -2147483648..2147483647
.1.3.6.1.2.1.80.1.4.1.4
pingProbeHistoryTime
Timestamp for when this probe result was determined.
SNMPv2-TCDateAndTime
Textual Convention: SNMPv2-TCDateAndTime OctetString
Type Constraints:
range: 8
range: 11
.1.3.6.1.2.1.80.1.4.1.5