snmp_mib_archive/CISCO-CABLE-DIAG-MIB.my 2
Heston Snodgrass 89bf4b016e initial commit
2016-12-15 15:03:18 -07:00

573 lines
17 KiB
Plaintext

-- *****************************************************************
-- Cisco Cable Diagnostic MIB
--
-- April, 2003 Lilian Jiang
--
-- Copyright (c) 2003, 2004 by cisco Systems, Inc.
-- All rights reserved.
-- *****************************************************************
CISCO-CABLE-DIAG-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY,
OBJECT-TYPE,
Gauge32,
Integer32,
Unsigned32
FROM SNMPv2-SMI
MODULE-COMPLIANCE,
OBJECT-GROUP
FROM SNMPv2-CONF
TruthValue,
TimeStamp
FROM SNMPv2-TC
ifIndex
FROM IF-MIB
ciscoMgmt
FROM CISCO-SMI
;
ciscoCableDiagMIB MODULE-IDENTITY
LAST-UPDATED "200409130000Z"
ORGANIZATION "Cisco Systems Inc. "
CONTACT-INFO
"Cisco Systems
Customer Service
Postal: 170 W Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553-NETS
E-mail: cs-lan-switch-snmp@cisco.com"
DESCRIPTION
"This MIB module defines objects for managing cable
diagnostic test capabilites supported by the Cisco devices.
Cable diagnostic tests are tests intended to exercise
the functional integrity of the cable attached to a
physical interface.
Examples of cable diagnostic test methods are: PRBS
(Pesudo Random Binary Sequence), TDR (Time Domain
reflectometery), etc.."
REVISION "200409130000Z"
DESCRIPTION
"Added a new enum value indeterminate(9) in
ccdTdrIfResultPairStatus."
REVISION "200401150000Z"
DESCRIPTION
"Initial version of this MIB module."
::= { ciscoMgmt 390 }
ciscoCableDiagMIBNotifs OBJECT IDENTIFIER
::= { ciscoCableDiagMIB 0 }
ciscoCableDiagMIBObjects OBJECT IDENTIFIER
::= { ciscoCableDiagMIB 1 }
ciscoCableDiagMIBConform OBJECT IDENTIFIER
::= { ciscoCableDiagMIB 2 }
ccdPrbsObjects OBJECT IDENTIFIER
::= { ciscoCableDiagMIBObjects 1 }
ccdTdrObjects OBJECT IDENTIFIER
::= { ciscoCableDiagMIBObjects 2 }
--
-- PRBS Test Objects
--
ccdPrbsIfTable OBJECT-TYPE
SYNTAX SEQUENCE OF CcdPrbsIfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table containing information about PRBS (Pesudo
Random Binary Sequence) test on the device's
interfaces. An entry appears in this table for each
interface which is capable to run PRBS test."
::= { ccdPrbsObjects 1 }
ccdPrbsIfEntry OBJECT-TYPE
SYNTAX CcdPrbsIfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry in the ccdPrbsIfTable, containing the information
about PRBS test on an interface."
INDEX { ifIndex }
::= { ccdPrbsIfTable 1 }
CcdPrbsIfEntry ::= SEQUENCE {
ccdPrbsIfAction
INTEGER,
ccdPrbsIfActionStatus
INTEGER,
ccdPrbsIfTestErrors
Gauge32,
ccdPrbsIfTestErrorsResetTime
TimeStamp,
ccdPrbsIfTestErrorsMaxValue
Unsigned32
}
ccdPrbsIfAction OBJECT-TYPE
SYNTAX INTEGER {
start(1),
stop(2),
errorReset(3),
running(4),
notRunning(5)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Indicates the PRBS test action to be executed on the interface
and whether the test is currently running or not.
'start' -- start the PRBS test on the interface.
'stop' -- stop the PRBS test on the interface.
'errorReset' -- reset the object value of
ccdPrbsIfTestErrors to zero on the interface.
'running' -- the PRBS test is currently running on the
interface. This value is a read-only value
and can not be set on the interface.
'notRunning' -- the PRBS test is currently not running
on the interface. This value is a read-only
value and can not be set on the interface."
::= { ccdPrbsIfEntry 1 }
ccdPrbsIfActionStatus OBJECT-TYPE
SYNTAX INTEGER {
succeeded(1),
failedDueToUnknownReason(2),
failedDueToResourceUnavailable(3),
failedDueToInternalError(4),
failedDueToTestAlreadyStarted(5),
failedDueToTestAlreadyStopped(6),
failedDueToInterfaceDisabled(7)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the status of the last PRBS test action set on the
interface."
::= { ccdPrbsIfEntry 2 }
ccdPrbsIfTestErrors OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the number of errors which occurred during the
current or most recent running of a test. This Gauge is reset
to zero each time a test starts (e.g., when ccdPrbsIfAction
is set to 'start') or each time ccdPrbsIfAction is set
to 'errorReset' on an interface.
If and when an instance of ccdPrbsIfTestErrors reaches its
maximum value as indicated by the corresponding instance of
ccdPrbsIfTestErrorsMaxValue, its value will be less or equal
to the actual number of errors."
::= { ccdPrbsIfEntry 3 }
ccdPrbsIfTestErrorsResetTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the most recent time that the corresponding
instance of ccdPrbsIfTestErrors is reset to zero. If the
the corresponding instance of ccdPrbsIfTestErrors is
never reset to zero, then the instance value for
ccdPrbsIfTestErrorsResetTime will be zero."
::= { ccdPrbsIfEntry 4 }
ccdPrbsIfTestErrorsMaxValue OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the maximum value of the corresponding instance
of ccdPrbsIfTestErrors."
::= { ccdPrbsIfEntry 5 }
--
-- TDR Objects
--
ccdTdrIfTable OBJECT-TYPE
SYNTAX SEQUENCE OF CcdTdrIfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table containing information about TDR
(Time Domain Reflectometery) test on the device's
interfaces. An entry appears in this table for each
interface which is capable to run TDR test."
::= { ccdTdrObjects 1 }
ccdTdrIfEntry OBJECT-TYPE
SYNTAX CcdTdrIfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry in the ccdTdrIfTable, containing the information
about TDR test on an interface."
INDEX { ifIndex }
::= { ccdTdrIfTable 1 }
CcdTdrIfEntry ::= SEQUENCE {
ccdTdrIfAction
INTEGER,
ccdTdrIfActionStatus
INTEGER,
ccdTdrIfLastTestTime
TimeStamp,
ccdTdrIfResultValid
TruthValue
}
ccdTdrIfAction OBJECT-TYPE
SYNTAX INTEGER {
start(1),
clear(2),
running(3),
notRunning(4)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Indicates the TDR test action to be executed on the interface
and whether the test is currently running or not.
'start' -- start the TDR test on the interface.
'clear' -- clear all the TDR test results on the interface.
After this action is executed on an interface,
the object value of ccdTdrIfResultValid for the
corresponding interface will be false(2).
'running' -- the TDR test is currently running on the
interface. This value is a read-only value
and can not be set on the interface.
'notRunning' -- the TDR test is currently not running
on the interface. This value is a read-only
value and can not be set on the interface."
::= { ccdTdrIfEntry 1 }
ccdTdrIfActionStatus OBJECT-TYPE
SYNTAX INTEGER {
succeeded(1),
failedDueToUnknownReason(2),
failedDueToResourceUnavailable(3),
failedDueToInternalError(4),
failedDueToTestAlreadyRunning(5),
failedDueToInterfaceDisabled(6)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the status of the last TDR test action set on the
interface."
::= { ccdTdrIfEntry 2 }
ccdTdrIfLastTestTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the timestamp when TDR test is last run
on the interface. If TDR test is never run on an
interface, then this object value will be zero."
::= { ccdTdrIfEntry 3 }
ccdTdrIfResultValid OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates whether the TDR test result on the interface
is valid for the user to retrieve or not."
::= { ccdTdrIfEntry 4 }
ccdTdrIfResultTable OBJECT-TYPE
SYNTAX SEQUENCE OF CcdTdrIfResultEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table containing information about TDR
test result on the device's interfaces. An entry
appears in this table for each cable pair on an interface
which has valid TDR test result, i.e., the value of
ccdTdrIfResultValid for the interface is true(1)."
::= { ccdTdrObjects 2 }
ccdTdrIfResultEntry OBJECT-TYPE
SYNTAX CcdTdrIfResultEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry in the ccdTdrIfResultTable, containing
the information about TDR test on an interface."
INDEX { ifIndex, ccdTdrIfResultPairIndex }
::= { ccdTdrIfResultTable 1 }
CcdTdrIfResultEntry ::= SEQUENCE {
ccdTdrIfResultPairIndex
INTEGER,
ccdTdrIfResultPairChannel
INTEGER,
ccdTdrIfResultPairLength
Integer32,
ccdTdrIfResultPairLenAccuracy
Integer32,
ccdTdrIfResultPairDistToFault
Integer32,
ccdTdrIfResultPairDistAccuracy
Integer32,
ccdTdrIfResultPairLengthUnit
INTEGER,
ccdTdrIfResultPairStatus
INTEGER
}
ccdTdrIfResultPairIndex OBJECT-TYPE
SYNTAX INTEGER {
pair1to2(1),
pair3to6(2),
pair4to5(3),
pair7to8(4)
}
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The local cable pair index.
'pair1to2' -- the pair with cable connectors 1 and 2.
'pair3to6' -- the pair with cable connectors 3 and 6.
'pair4to5' -- the pair with cable connectors 4 and 5.
'pair7to8' -- the pair with cable connectors 7 and 8."
REFERENCE
"IEEE 802.3-2002: Sections 40.8.1"
::= { ccdTdrIfResultEntry 1 }
ccdTdrIfResultPairChannel OBJECT-TYPE
SYNTAX INTEGER {
other(1),
channelA(2),
channelB(3),
channelC(4),
channelD(5)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The channels that the cable pair is connected to.
'other' -- none of the following.
'channelA' -- channel A.
'channelB' -- channel B.
'channelC' -- channel C.
'channelD' -- channel D."
::= { ccdTdrIfResultEntry 2 }
ccdTdrIfResultPairLength OBJECT-TYPE
SYNTAX Integer32 (-1..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The length of the cable pair. A value of -1 indicates
the length value is invalid. The unit of this value
is indicated by ccdTdrIfResultPairLengthUnit of the same
cable pair."
::= { ccdTdrIfResultEntry 3 }
ccdTdrIfResultPairLenAccuracy OBJECT-TYPE
SYNTAX Integer32 (-1..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The length accuracy of the cable pair. This value
should be added to and deducted from the value of
ccdTdrIfResultPairLength of the same cable pair to
form the upper and lower range of the cable pair length.
A value of -1 indicates the length accuracy value
is invalid. The unit of this value is indicated by
ccdTdrIfResultPairLengthUnit of the same cable pair. "
::= { ccdTdrIfResultEntry 4 }
ccdTdrIfResultPairDistToFault OBJECT-TYPE
SYNTAX Integer32 (-1..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The distance to the fault point of the cable pair.
A value of -1 indicates this value is invalid.
The unit of this value is indicated by
ccdTdrIfResultPairLengthUnit of the same cable pair."
::= { ccdTdrIfResultEntry 5 }
ccdTdrIfResultPairDistAccuracy OBJECT-TYPE
SYNTAX Integer32 (-1..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The accuracy of the distance to the fault point for
the cable pair. This value should be added to and
deducted from the value of ccdTdrIfResultPairDistToFault
of the same cable pair to form the upper and lower range
of the distance to fault point for the cable pair.
A value of -1 indicates this value is invalid.
The unit of this value is indicated by
ccdTdrIfResultPairLengthUnit of the same cable pair."
::= { ccdTdrIfResultEntry 6 }
ccdTdrIfResultPairLengthUnit OBJECT-TYPE
SYNTAX INTEGER {
unknown(1),
meter(2),
centimeter(3),
kilometer(4)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The measurement unit on the length or the distance to fault
point for the cable pair.
'unknown' -- none of the following.
'meter' -- the unit is meter.
'centimeter' -- the unit is centimeter.
'kilometer' -- the unit is kilometer."
::= { ccdTdrIfResultEntry 7 }
ccdTdrIfResultPairStatus OBJECT-TYPE
SYNTAX INTEGER {
unknown(1),
terminated(2),
notCompleted(3),
notSupported(4),
open(5),
shorted(6),
impedanceMismatch(7),
broken(8),
indeterminate(9)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The status of the cable pair.
'unknown' -- none of the following.
'terminated' -- the pair is properly terminated at the
remote end.
'notCompleted' -- the test on this pair is not completed.
'notSupported' -- the test on this pair is not supported.
'open' -- the pair is open.
'shorted' -- the pair is shorted.
'impedanceMismatch' -- the impedance of the pair is
mismatched.
'broken' -- the pair is broken.
'indeterminate' -- the status of the pair is indeterminate."
::= { ccdTdrIfResultEntry 8 }
--
-- Conformance
--
ciscoCableDiagMIBCompliances OBJECT IDENTIFIER
::= { ciscoCableDiagMIBConform 1 }
ciscoCableDiagMIBGroups OBJECT IDENTIFIER
::= { ciscoCableDiagMIBConform 2 }
ciscoCableDiagMIBComplianceRev1 MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for SNMP entities that implement the
CISCO-CABLE-DIAG-MIB."
MODULE -- this module
-- no MANDATORY-GROUPS
GROUP ccdPrbsGroup
DESCRIPTION
"This group is mandatory for implementations of PRBS cable
diagnostic test."
GROUP ccdTdrGroup
DESCRIPTION
"This group is mandatory for implementations of TDR cable
diagnostic test."
::= { ciscoCableDiagMIBCompliances 1 }
--
-- Units of Conformance
--
ccdPrbsGroup OBJECT-GROUP
OBJECTS {
ccdPrbsIfAction,
ccdPrbsIfActionStatus,
ccdPrbsIfTestErrors,
ccdPrbsIfTestErrorsResetTime,
ccdPrbsIfTestErrorsMaxValue
}
STATUS current
DESCRIPTION
"A collection of managed objects to support PRBS
cable diagnotic test on the interfaces of the device."
::= { ciscoCableDiagMIBGroups 1 }
ccdTdrGroup OBJECT-GROUP
OBJECTS {
ccdTdrIfAction,
ccdTdrIfActionStatus,
ccdTdrIfLastTestTime,
ccdTdrIfResultValid,
ccdTdrIfResultPairChannel,
ccdTdrIfResultPairLength,
ccdTdrIfResultPairLenAccuracy,
ccdTdrIfResultPairDistToFault,
ccdTdrIfResultPairDistAccuracy,
ccdTdrIfResultPairLengthUnit,
ccdTdrIfResultPairStatus
}
STATUS current
DESCRIPTION
"A collection of managed objects to support TDR
cable diagnotic test on the interfaces of the device."
::= { ciscoCableDiagMIBGroups 2 }
END