mirror of
https://git.valherun.com/valherun/pxe_boot_alma.git
synced 2026-10-15 22:22:03 -04:00
- restructure boot/kickstarts/scripts/docs into homelab/ - docs: alma9->10 breaking changes, CIS hardening, kickstart changes - add find_cron_entries.sh helper and codex running memory notes Co-Authored-By: Claude Fable 5 <[email protected]>
732 lines
26 KiB
Plaintext
732 lines
26 KiB
Plaintext
DISMAN-TRACEROUTE-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY, OBJECT-TYPE, Integer32,
|
|
Gauge32, Unsigned32, mib-2,
|
|
NOTIFICATION-TYPE,
|
|
OBJECT-IDENTITY
|
|
FROM SNMPv2-SMI -- RFC2578
|
|
RowStatus, StorageType,
|
|
TruthValue, DateAndTime
|
|
FROM SNMPv2-TC -- RFC2579
|
|
MODULE-COMPLIANCE, OBJECT-GROUP,
|
|
NOTIFICATION-GROUP
|
|
FROM SNMPv2-CONF -- RFC2580
|
|
SnmpAdminString
|
|
FROM SNMP-FRAMEWORK-MIB -- RFC2571
|
|
InterfaceIndexOrZero -- RFC2863
|
|
FROM IF-MIB
|
|
InetAddressType, InetAddress
|
|
FROM INET-ADDRESS-MIB; -- RFC2851
|
|
|
|
traceRouteMIB MODULE-IDENTITY
|
|
LAST-UPDATED "2009211415Z" -- 21 September 2000
|
|
|
|
ORGANIZATION "IETF Distributed Management Working Group"
|
|
CONTACT-INFO
|
|
"Kenneth White
|
|
|
|
International Business Machines Corporation
|
|
Network Computing Software Division
|
|
Research Triangle Park, NC, USA
|
|
E-mail: [email protected]"
|
|
DESCRIPTION
|
|
"The Traceroute MIB (DISMAN-TRACEROUTE-MIB) provides
|
|
access to the traceroute capability at a remote host."
|
|
|
|
-- Revision history
|
|
|
|
REVISION "9304010000Z" -- 21 September 2000
|
|
DESCRIPTION
|
|
"Initial version, published as RFC 2925."
|
|
|
|
::= { mib-2 81 }
|
|
|
|
-- Top level structure of the MIB
|
|
|
|
traceRouteNotifications OBJECT IDENTIFIER ::= { traceRouteMIB 0 }
|
|
traceRouteObjects OBJECT IDENTIFIER ::= { traceRouteMIB 1 }
|
|
traceRouteConformance OBJECT IDENTIFIER ::= { traceRouteMIB 2 }
|
|
|
|
-- The registration node (point) for traceroute implementation types
|
|
|
|
traceRouteImplementationTypeDomains OBJECT IDENTIFIER
|
|
::= { traceRouteMIB 3 }
|
|
|
|
traceRouteUsingUdpProbes OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Indicates that an implementation is using UDP probes to
|
|
perform the traceroute operation."
|
|
::= { traceRouteImplementationTypeDomains 1 }
|
|
|
|
|
|
-- Simple Object Definitions
|
|
|
|
traceRouteMaxConcurrentRequests OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "requests"
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The maximum number of concurrent active traceroute requests
|
|
that are allowed within an agent implementation. A value
|
|
of 0 for this object implies that there is no limit for
|
|
the number of concurrent active requests in effect."
|
|
DEFVAL { 10 }
|
|
::= { traceRouteObjects 1 }
|
|
|
|
|
|
-- Traceroute Control Table
|
|
|
|
traceRouteCtlTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF TraceRouteCtlEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Defines the Remote Operations Traceroute Control Table for
|
|
providing the capability of invoking traceroute from a remote
|
|
host. The results of traceroute operations can be stored in
|
|
the traceRouteResultsTable, traceRouteProbeHistoryTable, and
|
|
the traceRouteHopsTable."
|
|
::= { traceRouteObjects 2 }
|
|
|
|
traceRouteCtlEntry OBJECT-TYPE
|
|
SYNTAX TraceRouteCtlEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Defines an entry in the traceRouteCtlTable. The first
|
|
index element, traceRouteCtlOwnerIndex, is of type
|
|
SnmpAdminString, a textual convention that allows for
|
|
use of the SNMPv3 View-Based Access Control Model
|
|
(RFC 2575 [11], VACM) and allows an management
|
|
application to identify its entries. The second index,
|
|
traceRouteCtlTestName (also an SnmpAdminString),
|
|
enables the same management application to have
|
|
multiple requests outstanding."
|
|
INDEX {
|
|
traceRouteCtlOwnerIndex,
|
|
traceRouteCtlTestName
|
|
}
|
|
::= { traceRouteCtlTable 1 }
|
|
|
|
TraceRouteCtlEntry ::=
|
|
SEQUENCE {
|
|
traceRouteCtlOwnerIndex SnmpAdminString,
|
|
traceRouteCtlTestName SnmpAdminString,
|
|
traceRouteCtlTargetAddressType InetAddressType,
|
|
traceRouteCtlTargetAddress InetAddress,
|
|
traceRouteCtlByPassRouteTable TruthValue,
|
|
traceRouteCtlDataSize Unsigned32,
|
|
traceRouteCtlTimeOut Unsigned32,
|
|
traceRouteCtlProbesPerHop Unsigned32,
|
|
traceRouteCtlPort Unsigned32,
|
|
traceRouteCtlMaxTtl Unsigned32,
|
|
traceRouteCtlDSField Unsigned32,
|
|
traceRouteCtlSourceAddressType InetAddressType,
|
|
traceRouteCtlSourceAddress InetAddress,
|
|
traceRouteCtlIfIndex InterfaceIndexOrZero,
|
|
traceRouteCtlMiscOptions SnmpAdminString,
|
|
traceRouteCtlMaxFailures Unsigned32,
|
|
traceRouteCtlDontFragment TruthValue,
|
|
traceRouteCtlInitialTtl Unsigned32,
|
|
traceRouteCtlFrequency Unsigned32,
|
|
traceRouteCtlStorageType StorageType,
|
|
traceRouteCtlAdminStatus INTEGER,
|
|
traceRouteCtlMaxRows Unsigned32,
|
|
traceRouteCtlTrapGeneration BITS,
|
|
traceRouteCtlDescr SnmpAdminString,
|
|
traceRouteCtlCreateHopsEntries TruthValue,
|
|
traceRouteCtlType OBJECT IDENTIFIER,
|
|
traceRouteCtlRowStatus RowStatus
|
|
}
|
|
|
|
traceRouteCtlOwnerIndex OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE(0..32))
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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 independently create or
|
|
modify entries, the initial index is used as an 'owner
|
|
index'. Such an initial index has a syntax of
|
|
SnmpAdminString, and can thus be trivially mapped to a
|
|
securityName or groupName as defined in VACM, in
|
|
accordance with a security policy.
|
|
|
|
When used in conjunction with such a security policy
|
|
all entries in the table belonging to a particular user
|
|
(or group) will have the same value for this initial
|
|
index. For a given user's entries in a particular
|
|
table, the object identifiers for the information in
|
|
these entries will have the same subidentifiers (except
|
|
for the 'column' subidentifier) up to the end of the
|
|
encoded owner index. To configure VACM to permit access
|
|
to this portion of the table, one would create
|
|
vacmViewTreeFamilyTable entries with the value of
|
|
vacmViewTreeFamilySubtree including the owner index
|
|
portion, and vacmViewTreeFamilyMask 'wildcarding' the
|
|
column subidentifier. More elaborate configurations
|
|
are possible."
|
|
::= { traceRouteCtlEntry 1 }
|
|
|
|
traceRouteCtlTestName OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE(0..32))
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The name of a traceroute test. This is locally unique,
|
|
within the scope of an traceRouteCtlOwnerIndex."
|
|
::= { traceRouteCtlEntry 2 }
|
|
|
|
traceRouteCtlTargetAddressType OBJECT-TYPE
|
|
SYNTAX InetAddressType
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Specifies the type of host address to be used on the
|
|
traceroute request at the remote host."
|
|
DEFVAL { ipv4 }
|
|
::= { traceRouteCtlEntry 3 }
|
|
|
|
traceRouteCtlTargetAddress OBJECT-TYPE
|
|
SYNTAX InetAddress
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Specifies the host address used on the
|
|
traceroute request at the remote host. The
|
|
host address type can be determined by the
|
|
examining the value of the corresponding
|
|
traceRouteCtlTargetAddressType index element.
|
|
|
|
A value for this object MUST be set prior to
|
|
transitioning its corresponding traceRouteCtlEntry to
|
|
active(1) via traceRouteCtlRowStatus."
|
|
::= { traceRouteCtlEntry 4 }
|
|
|
|
traceRouteCtlByPassRouteTable OBJECT-TYPE
|
|
SYNTAX TruthValue
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The purpose of this object is to optionally enable
|
|
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 directly-attached network, an
|
|
error is returned. This option can be used to perform
|
|
the traceroute operation to a local host through an
|
|
interface that has no route defined (e.g., after the
|
|
interface was dropped by routed)."
|
|
DEFVAL { false }
|
|
::= { traceRouteCtlEntry 5 }
|
|
|
|
traceRouteCtlDataSize OBJECT-TYPE
|
|
SYNTAX Unsigned32 (0..65507)
|
|
UNITS "octets"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Specifies the size of the data portion of a traceroute
|
|
request in octets. A traceroute request is essentially
|
|
transmitted by encoding a UDP datagram into a
|
|
IP packet. So subtracting the size of a UDP header
|
|
(8 octets) and the size of a IP header (20 octets)
|
|
yields a maximum of 65507 octets."
|
|
DEFVAL { 0 }
|
|
::= { traceRouteCtlEntry 6 }
|
|
|
|
traceRouteCtlTimeOut OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..60)
|
|
UNITS "seconds"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Specifies the time-out value, in seconds, for
|
|
a traceroute request."
|
|
DEFVAL { 3 }
|
|
::= { traceRouteCtlEntry 7 }
|
|
|
|
traceRouteCtlProbesPerHop OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..10)
|
|
UNITS "probes"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Specifies the number of times to reissue a traceroute
|
|
request with the same time-to-live (TTL) value."
|
|
DEFVAL { 3 }
|
|
::= { traceRouteCtlEntry 8 }
|
|
|
|
traceRouteCtlPort OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..65535)
|
|
UNITS "UDP Port"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Specifies the UDP port to send the traceroute
|
|
request to. Need to specify a port that is not in
|
|
use at the destination (target) host. The default
|
|
value for this object is the IANA assigned port,
|
|
33434, for the traceroute function."
|
|
DEFVAL { 33434 }
|
|
::= { traceRouteCtlEntry 9 }
|
|
|
|
traceRouteCtlMaxTtl OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..255)
|
|
UNITS "time-to-live value"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Specifies the maximum time-to-live value."
|
|
DEFVAL { 30 }
|
|
::= { traceRouteCtlEntry 10 }
|
|
|
|
traceRouteCtlDSField OBJECT-TYPE
|
|
SYNTAX Unsigned32 (0..255)
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Specifies the value to store in the Differentiated
|
|
Services (DS) Field in the IP packet used to
|
|
encapsulate the traceroute probe. The DS Field is
|
|
defined as the Type of Service (TOS) octet in a IPv4
|
|
header or as the Traffic Class octet in a IPv6 header.
|
|
|
|
The value of this object must be a decimal integer
|
|
in the range from 0 to 255. This option can be used
|
|
to determine what effect an explicit DS Field setting
|
|
has on a traceroute response. Not all values are legal
|
|
or meaningful. DS Field usage is often not supported
|
|
by IP implementations. A value of 0 means that the
|
|
function represented by this option is not supported.
|
|
Useful TOS octet values are probably '16' (low delay)
|
|
and '8' ( high throughput)."
|
|
REFERENCE
|
|
"Refer to RFC 2474 for the definition of the
|
|
Differentiated Services Field and to RFC 1812
|
|
Section 5.3.2 for Type of Service (TOS)."
|
|
DEFVAL { 0 }
|
|
::= { traceRouteCtlEntry 11 }
|
|
|
|
traceRouteCtlSourceAddressType OBJECT-TYPE
|
|
SYNTAX InetAddressType
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Specifies the type of the source address,
|
|
traceRouteCtlSourceAddress, to be used at a remote host
|
|
when performing a traceroute operation."
|
|
DEFVAL { unknown }
|
|
::= { traceRouteCtlEntry 12 }
|
|
|
|
traceRouteCtlSourceAddress OBJECT-TYPE
|
|
SYNTAX InetAddress
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Use the specified IP address (which must be given
|
|
as an IP number, not a hostname) as the source
|
|
address in outgoing probe packets. On hosts with
|
|
more than one IP address, this option can be used
|
|
to force the source address to be something other
|
|
than the primary IP address of the interface the
|
|
probe packet is sent on. If the IP address is not
|
|
one of this machine's interface addresses, an error
|
|
is returned and nothing is sent. A zero length
|
|
octet string value for this object disables source
|
|
address specification.
|
|
|
|
The address type (InetAddressType) that relates to
|
|
this object is specified by the corresponding value
|
|
of traceRouteCtlSourceAddressType."
|
|
DEFVAL { ''H }
|
|
::= { traceRouteCtlEntry 13 }
|
|
|
|
traceRouteCtlIfIndex OBJECT-TYPE
|
|
SYNTAX InterfaceIndexOrZero
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Setting this object to an interface's ifIndex prior
|
|
to starting a remote traceroute operation directs
|
|
the traceroute probes to be transmitted over the
|
|
specified interface. A value of zero for this object
|
|
implies that this option is not enabled."
|
|
DEFVAL { 0 }
|
|
::= { traceRouteCtlEntry 14 }
|
|
|
|
traceRouteCtlMiscOptions OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Enables an application to specify implementation
|
|
dependent options."
|
|
DEFVAL { ''H }
|
|
::= { traceRouteCtlEntry 15 }
|
|
|
|
traceRouteCtlMaxFailures OBJECT-TYPE
|
|
SYNTAX Unsigned32 (0..255)
|
|
UNITS "timeouts"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object indicates the maximum number
|
|
of consecutive timeouts allowed before terminating
|
|
a remote traceroute request. A value of either 255 (maximum
|
|
hop count/possible TTL value) or a 0 indicates that the
|
|
function of terminating a remote traceroute request when a
|
|
specific number of successive timeouts are detected is
|
|
disabled."
|
|
DEFVAL { 5 }
|
|
::= { traceRouteCtlEntry 16 }
|
|
|
|
traceRouteCtlDontFragment OBJECT-TYPE
|
|
SYNTAX TruthValue
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object enables setting of the don't fragment flag (DF)
|
|
in the IP header for a probe. Use of this object enables
|
|
performing a manual PATH MTU test."
|
|
DEFVAL { false }
|
|
::= { traceRouteCtlEntry 17 }
|
|
|
|
traceRouteCtlInitialTtl OBJECT-TYPE
|
|
SYNTAX Unsigned32 (0..255)
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object specifies the initial TTL value to
|
|
use. This enables bypassing the initial (often well known)
|
|
portion of a path."
|
|
DEFVAL { 1 }
|
|
::= { traceRouteCtlEntry 18 }
|
|
|
|
traceRouteCtlFrequency OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "seconds"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The number of seconds to wait before repeating a
|
|
traceroute test as defined by the value of the
|
|
various objects in the corresponding row.
|
|
|
|
The number of hops in a single traceroute test
|
|
is determined by the value of the corresponding
|
|
traceRouteCtlProbesPerHop object. After a
|
|
single test completes the number of seconds as defined
|
|
by the value of traceRouteCtlFrequency MUST elapse
|
|
before the next traceroute test is started.
|
|
|
|
A value of 0 for this object implies that the test
|
|
as defined by the corresponding entry will not be
|
|
repeated."
|
|
DEFVAL { 0 }
|
|
::= { traceRouteCtlEntry 19 }
|
|
|
|
traceRouteCtlStorageType OBJECT-TYPE
|
|
SYNTAX StorageType
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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."
|
|
DEFVAL { nonVolatile }
|
|
::= { traceRouteCtlEntry 20 }
|
|
|
|
traceRouteCtlAdminStatus OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
enabled(1), -- operation should be started
|
|
disabled(2) -- operation should be stopped
|
|
}
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Reflects the desired state that an traceRouteCtlEntry
|
|
should be in:
|
|
|
|
enabled(1) - Attempt to activate the test as defined by
|
|
this traceRouteCtlEntry.
|
|
disabled(2) - Deactivate the test as defined by this
|
|
traceRouteCtlEntry.
|
|
|
|
Refer to the corresponding traceRouteResultsOperStatus to
|
|
determine the operational state of the test defined by
|
|
this entry."
|
|
DEFVAL { disabled }
|
|
::= { traceRouteCtlEntry 21 }
|
|
|
|
traceRouteCtlDescr OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The purpose of this object is to provide a
|
|
descriptive name of the remote traceroute
|
|
test."
|
|
DEFVAL { '00'H }
|
|
::= { traceRouteCtlEntry 22 }
|
|
|
|
traceRouteCtlMaxRows OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "rows"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The maximum number of entries allowed in the
|
|
traceRouteProbeHistoryTable. An implementation of
|
|
this MIB will remove the oldest entry in the
|
|
traceRouteProbeHistoryTable to allow the addition
|
|
of an new entry once the number of rows in the
|
|
traceRouteProbeHistoryTable reaches this value.
|
|
|
|
Old entries are not removed when a new test is
|
|
started. Entries are added to the
|
|
traceRouteProbeHistoryTable until traceRouteCtlMaxRows
|
|
is reached before entries begin to be removed.
|
|
|
|
A value of 0 for this object disables creation of
|
|
traceRouteProbeHistoryTable entries."
|
|
DEFVAL { 50 }
|
|
::= { traceRouteCtlEntry 23 }
|
|
|
|
traceRouteCtlTrapGeneration OBJECT-TYPE
|
|
SYNTAX BITS {
|
|
pathChange(0),
|
|
testFailure(1),
|
|
testCompletion(2)
|
|
}
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object determines when and if to
|
|
to generate a notification for this entry:
|
|
pathChange(0) - Generate a traceRoutePathChange
|
|
notification when the current path varies from a
|
|
previously determined path.
|
|
testFailure(1) - Generate a traceRouteTestFailed
|
|
notification when the full path to a target
|
|
can't be determined.
|
|
testCompletion(2) - Generate a traceRouteTestCompleted
|
|
notification when the path to a target has been
|
|
determined.
|
|
|
|
The value of this object defaults to zero, indicating
|
|
that none of the above options have been selected."
|
|
::= { traceRouteCtlEntry 24 }
|
|
|
|
traceRouteCtlCreateHopsEntries OBJECT-TYPE
|
|
SYNTAX TruthValue
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The current path for a traceroute test is kept in the
|
|
traceRouteHopsTable on a per hop basis when the value of
|
|
this object is true(1)."
|
|
DEFVAL { false }
|
|
::= { traceRouteCtlEntry 25 }
|
|
|
|
traceRouteCtlType OBJECT-TYPE
|
|
SYNTAX OBJECT IDENTIFIER
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object is used either to report or
|
|
select the implementation method to be used for
|
|
performing a traceroute operation. The value of this
|
|
object may be selected from
|
|
traceRouteImplementationTypeDomains.
|
|
|
|
Additional implementation types should be allocated as
|
|
required by implementers of the DISMAN-TRACEROUTE-MIB
|
|
under their enterprise specific registration point and
|
|
not beneath traceRouteImplementationTypeDomains."
|
|
DEFVAL { traceRouteUsingUdpProbes }
|
|
::= { traceRouteCtlEntry 26 }
|
|
|
|
traceRouteCtlRowStatus OBJECT-TYPE
|
|
SYNTAX RowStatus
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object allows entries to be created and deleted
|
|
in the traceRouteCtlTable. Deletion of an entry in
|
|
this table results in all corresponding (same
|
|
traceRouteCtlOwnerIndex and traceRouteCtlTestName
|
|
index values) traceRouteResultsTable,
|
|
traceRouteProbeHistoryTable, and traceRouteHopsTable
|
|
entries being deleted.
|
|
|
|
A value MUST be specified for traceRouteCtlTargetAddress
|
|
prior to a transition to active(1) state being
|
|
accepted.
|
|
|
|
Activation of a remote traceroute operation is
|
|
controlled via traceRouteCtlAdminStatus and not
|
|
by transitioning of this object's value to active(1).
|
|
|
|
Transitions in and out of active(1) state are not
|
|
allowed while an entry's traceRouteResultsOperStatus
|
|
is active(1) with the exception that deletion of
|
|
an entry in this table by setting its RowStatus
|
|
object to destroy(6) will stop an active
|
|
traceroute operation.
|
|
|
|
The operational state of an traceroute operation
|
|
can be determined by examination of the corresponding
|
|
traceRouteResultsOperStatus object."
|
|
REFERENCE
|
|
"See definition of RowStatus in RFC 2579, 'Textual
|
|
Conventions for SMIv2.'"
|
|
::= { traceRouteCtlEntry 27 }
|
|
|
|
|
|
-- Traceroute Results Table
|
|
|
|
traceRouteResultsTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF TraceRouteResultsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Defines the Remote Operations Traceroute Results Table for
|
|
keeping track of the status of a traceRouteCtlEntry.
|
|
|
|
An entry is added to the traceRouteResultsTable when an
|
|
traceRouteCtlEntry is started by successful transition
|
|
of its traceRouteCtlAdminStatus object to enabled(1).
|
|
An entry is removed from the traceRouteResultsTable when
|
|
its corresponding traceRouteCtlEntry is deleted."
|
|
::= { traceRouteObjects 3 }
|
|
|
|
traceRouteResultsEntry OBJECT-TYPE
|
|
SYNTAX TraceRouteResultsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Defines an entry in the traceRouteResultsTable. The
|
|
traceRouteResultsTable has the same indexing as the
|
|
traceRouteCtlTable in order for a traceRouteResultsEntry
|
|
to correspond to the traceRouteCtlEntry that caused it to
|
|
be created."
|
|
INDEX {
|
|
traceRouteCtlOwnerIndex,
|
|
traceRouteCtlTestName
|
|
}
|
|
::= { traceRouteResultsTable 1 }
|
|
|
|
TraceRouteResultsEntry ::=
|
|
SEQUENCE {
|
|
traceRouteResultsOperStatus INTEGER,
|
|
traceRouteResultsCurHopCount Gauge32,
|
|
traceRouteResultsCurProbeCount Gauge32,
|
|
traceRouteResultsIpTgtAddrType InetAddressType,
|
|
traceRouteResultsIpTgtAddr InetAddress,
|
|
traceRouteResultsTestAttempts Unsigned32,
|
|
traceRouteResultsTestSuccesses Unsigned32,
|
|
traceRouteResultsLastGoodPath DateAndTime
|
|
}
|
|
|
|
traceRouteResultsOperStatus OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
enabled(1), -- test is in progress
|
|
disabled(2) -- test has stopped
|
|
}
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Reflects the operational state of an traceRouteCtlEntry:
|
|
|
|
enabled(1) - Test is active.
|
|
disabled(2) - Test has stopped."
|
|
::= { traceRouteResultsEntry 1 }
|
|
|
|
traceRouteResultsCurHopCount OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "hops"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Reflects the current TTL value (range from 1 to
|
|
255) for a remote traceroute operation.
|
|
Maximum TTL value is determined by
|
|
traceRouteCtlMaxTtl."
|
|
::= { traceRouteResultsEntry 2 }
|
|
|
|
traceRouteResultsCurProbeCount OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "probes"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Reflects the current probe count (1..10) for
|
|
a remote traceroute operation. The maximum
|
|
probe count is determined by
|
|
traceRouteCtlProbesPerHop."
|
|
::= { traceRouteResultsEntry 3 }
|
|
|
|
traceRouteResultsIpTgtAddrType OBJECT-TYPE
|
|
SYNTAX InetAddressType
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This objects indicates the type of address stored
|
|
in the corresponding traceRouteResultsIpTgtAddr
|
|
object."
|
|
::= { traceRouteResultsEntry 4 }
|
|
|
|
traceRouteResultsIpTgtAddr OBJECT-TYPE
|
|
SYNTAX InetAddress
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This objects reports the IP address associated
|
|
with a traceRouteCtlTargetAddress 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 not specified or
|
|
when a specified DNS name fails to resolve."
|
|
::= { traceRouteResultsEntry 5 }
|
|
|
|
traceRouteResultsTestAttempts OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "tests"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The current number of attempts to determine a path
|
|
to a target. The value of this object MUST be started
|
|
at 0."
|
|
::= { traceRouteResultsEntry 6 }
|
|
|
|
traceRouteResultsTestSuccesses OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "tests"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The current number of attempts to determine a path
|
|
to a target that have succeeded. The value of this
|
|
object MUST be reported as 0 when no attempts have
|
|
succeeded."
|
|
::= { traceRouteResultsEntry 7 }
|
|
|
|
traceRouteResultsLastGoodPath OBJECT-TYPE
|
|
SYNTAX DateAndTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The date and time when the last complete path
|
|
was determined."
|
|
::= { traceRouteResultsEntry 8 }
|
|
|
|
|
|
END
|