| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326 |
- 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
|