diff options
Diffstat (limited to 'mibs/NET-SNMP-EXTEND-MIB.txt')
-rw-r--r-- | mibs/NET-SNMP-EXTEND-MIB.txt | 325 |
1 files changed, 325 insertions, 0 deletions
diff --git a/mibs/NET-SNMP-EXTEND-MIB.txt b/mibs/NET-SNMP-EXTEND-MIB.txt new file mode 100644 index 0000000..2101035 --- /dev/null +++ b/mibs/NET-SNMP-EXTEND-MIB.txt @@ -0,0 +1,325 @@ +NET-SNMP-EXTEND-MIB DEFINITIONS ::= BEGIN + +-- +-- Defines a framework for scripted extensions +-- + +IMPORTS + nsExtensions FROM NET-SNMP-AGENT-MIB + + OBJECT-TYPE, NOTIFICATION-TYPE, MODULE-IDENTITY, Integer32 + FROM SNMPv2-SMI + + OBJECT-GROUP, NOTIFICATION-GROUP + FROM SNMPv2-CONF + + DisplayString, RowStatus, StorageType FROM SNMPv2-TC; + + +netSnmpExtendMIB MODULE-IDENTITY + LAST-UPDATED "201003170000Z" + ORGANIZATION "www.net-snmp.org" + CONTACT-INFO + "postal: Wes Hardaker + P.O. Box 382 + Davis CA 95617 + + email: net-snmp-coders@lists.sourceforge.net" + DESCRIPTION + "Defines a framework for scripted extensions for the Net-SNMP agent." + REVISION "201003170000Z" + DESCRIPTION + "Fixed inconsistencies in the definition of nsExtendConfigTable." + REVISION "200405080000Z" + DESCRIPTION + "First revision." + ::= { nsExtensions 1 } + +nsExtendObjects OBJECT IDENTIFIER ::= { nsExtensions 2} +nsExtendGroups OBJECT IDENTIFIER ::= { nsExtensions 3} + +nsExtendNumEntries OBJECT-TYPE + SYNTAX INTEGER + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The number of rows in the nsExtendConfigTable" + ::= { nsExtendObjects 1 } + +nsExtendConfigTable OBJECT-TYPE + SYNTAX SEQUENCE OF NsExtendConfigEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "A table of scripted extensions - configuration and (basic) output." + ::= { nsExtendObjects 2 } + +nsExtendConfigEntry OBJECT-TYPE + SYNTAX NsExtendConfigEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "A conceptual row within the extension table." + INDEX { nsExtendToken } + ::= { nsExtendConfigTable 1 } + +NsExtendConfigEntry ::= SEQUENCE { + nsExtendToken DisplayString, + nsExtendCommand DisplayString, + nsExtendArgs DisplayString, + nsExtendInput DisplayString, + nsExtendCacheTime INTEGER, + nsExtendExecType INTEGER, + nsExtendRunType INTEGER, + + nsExtendStorage StorageType, + nsExtendStatus RowStatus +} + + -- + -- The configuration of an extension command + -- + +nsExtendToken OBJECT-TYPE + SYNTAX DisplayString + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "An arbitrary token to identify this extension entry" + ::= { nsExtendConfigEntry 1 } + +nsExtendCommand OBJECT-TYPE + SYNTAX DisplayString + MAX-ACCESS read-create + STATUS current + DESCRIPTION + "The full path of the command binary (or script) to run" + ::= { nsExtendConfigEntry 2 } + +nsExtendArgs OBJECT-TYPE + SYNTAX DisplayString + MAX-ACCESS read-create + STATUS current + DESCRIPTION + "Any command-line arguments for the command" + DEFVAL { ''H } -- the empty string + ::= { nsExtendConfigEntry 3 } + +nsExtendInput OBJECT-TYPE + SYNTAX DisplayString + MAX-ACCESS read-create + STATUS current + DESCRIPTION + "The standard input for the command" + DEFVAL { ''H } -- the empty string + ::= { nsExtendConfigEntry 4 } + +nsExtendCacheTime OBJECT-TYPE + SYNTAX INTEGER + MAX-ACCESS read-create + STATUS current + DESCRIPTION + "The length of time for which the output of + this command will be cached. During this time, + retrieving the output-related values will not + reinvoke the command. + A value of -1 indicates that the output results + should not be cached at all, and retrieving each + individual output-related value will invoke the + command afresh." + DEFVAL { 5 } + ::= { nsExtendConfigEntry 5 } + +nsExtendExecType OBJECT-TYPE + SYNTAX INTEGER + { exec (1), -- 'fork-and-exec' + shell (2) -- run via a sub-shell + } + MAX-ACCESS read-create + STATUS current + DESCRIPTION + "The mechanism used to invoke the command." + DEFVAL { exec } + ::= { nsExtendConfigEntry 6 } + +nsExtendRunType OBJECT-TYPE + SYNTAX INTEGER + { run-on-read (1), + run-on-set (2), + run-command (3) + } + MAX-ACCESS read-create + STATUS current + DESCRIPTION + "Used to implement 'push-button' command invocation. + The command for a 'run-on-read' entry will be invoked + whenever one of the corresponding output-related + instances is requested (and assuming the cached value + is not still current). + The command for a 'run-on-set' entry will only be invoked + on receipt of a SET assignment for this object with the + value 'run-command'. + Reading an instance of this object will always return either + 'run-on-read' or 'run-on-set'. + " + DEFVAL { run-on-read } + ::= { nsExtendConfigEntry 7 } + + -- + -- Standard table-manipulation objects + -- + +nsExtendStorage OBJECT-TYPE + SYNTAX StorageType + MAX-ACCESS read-create + STATUS current + DESCRIPTION + "The storage type for this conceptual row." + DEFVAL { volatile } + ::= { nsExtendConfigEntry 20 } + +nsExtendStatus OBJECT-TYPE + SYNTAX RowStatus + MAX-ACCESS read-create + STATUS current + DESCRIPTION + "Used to create new rows in the table, in the standard manner. + Note that is valid for an instance to be left with the value + notInService(2) indefinitely - i.e. the meaning of 'abnormally + long' (see RFC 2579, RowStatus) for this table is infinite." + ::= { nsExtendConfigEntry 21 } + + + -- + -- The results of running the extension command + -- + +nsExtendOutput1Table OBJECT-TYPE + SYNTAX SEQUENCE OF NsExtendOutput1Entry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "A table of scripted extensions - configuration and (basic) output." + ::= { nsExtendObjects 3 } + +nsExtendOutput1Entry OBJECT-TYPE + SYNTAX NsExtendOutput1Entry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "A conceptual row within the extension table." + AUGMENTS { nsExtendConfigEntry } + ::= { nsExtendOutput1Table 1 } + +NsExtendOutput1Entry ::= SEQUENCE { + nsExtendOutput1Line DisplayString, + nsExtendOutputFull DisplayString, + nsExtendOutNumLines Integer32, + nsExtendResult Integer32 +} + +nsExtendOutput1Line OBJECT-TYPE + SYNTAX DisplayString + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The first line of output from the command" + ::= { nsExtendOutput1Entry 1 } + +nsExtendOutputFull OBJECT-TYPE + SYNTAX DisplayString + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The full output from the command, as a single string" + ::= { nsExtendOutput1Entry 2 } + +nsExtendOutNumLines OBJECT-TYPE + SYNTAX Integer32 + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The number of lines of output (and hence + the number of rows in nsExtendOutputTable + relating to this particular entry)." + ::= { nsExtendOutput1Entry 3 } + +nsExtendResult OBJECT-TYPE + SYNTAX Integer32 + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The return value of the command." + ::= { nsExtendOutput1Entry 4 } + + + -- + -- The line-based output table + -- + +nsExtendOutput2Table OBJECT-TYPE + SYNTAX SEQUENCE OF NsExtendOutput2Entry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "A table of (line-based) output from scripted extensions." + ::= { nsExtendObjects 4 } + +nsExtendOutput2Entry OBJECT-TYPE + SYNTAX NsExtendOutput2Entry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "A conceptual row within the line-based output table." + INDEX { nsExtendToken, nsExtendLineIndex } + ::= { nsExtendOutput2Table 1 } + +NsExtendOutput2Entry ::= SEQUENCE { + nsExtendLineIndex INTEGER, + nsExtendOutLine DisplayString +} + +nsExtendLineIndex OBJECT-TYPE + SYNTAX INTEGER(1..1024) + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "The index of this line of output. + For a given nsExtendToken, this will run from + 1 to the corresponding value of nsExtendNumLines." + ::= { nsExtendOutput2Entry 1 } + +nsExtendOutLine OBJECT-TYPE + SYNTAX DisplayString + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "A single line of output from the extension command." + ::= { nsExtendOutput2Entry 2 } + +-- +-- Conformance-related definitions +-- + +nsExtendConfigGroup OBJECT-GROUP + OBJECTS { + nsExtendCommand, nsExtendArgs, nsExtendInput, + nsExtendCacheTime, nsExtendExecType, nsExtendRunType, + nsExtendStorage, nsExtendStatus, nsExtendNumEntries + } + STATUS current + DESCRIPTION + "Objects relating to the configuration of extension commands." + ::= { nsExtendGroups 1 } + +nsExtendOutputGroup OBJECT-GROUP + OBJECTS { + nsExtendOutNumLines, nsExtendResult, + nsExtendOutLine, nsExtendOutput1Line, nsExtendOutputFull + } + STATUS current + DESCRIPTION + "Objects relating to the output of extension commands." + ::= { nsExtendGroups 2 } + +END |