| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555 |
- NET-SNMP-AGENT-MIB DEFINITIONS ::= BEGIN
- --
- -- Defines control and monitoring structures for the Net-SNMP agent.
- --
- IMPORTS
- SnmpAdminString
- FROM SNMP-FRAMEWORK-MIB
- netSnmpObjects, netSnmpModuleIDs, netSnmpNotifications, netSnmpGroups
- FROM NET-SNMP-MIB
- OBJECT-TYPE, NOTIFICATION-TYPE, MODULE-IDENTITY, Integer32, Unsigned32
- FROM SNMPv2-SMI
- OBJECT-GROUP, NOTIFICATION-GROUP
- FROM SNMPv2-CONF
- TEXTUAL-CONVENTION, DisplayString, RowStatus, TruthValue
- FROM SNMPv2-TC;
- netSnmpAgentMIB 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 control and monitoring structures for the Net-SNMP agent."
- REVISION "201003170000Z"
- DESCRIPTION
- "Made sure that this MIB can be compiled by MIB compilers that do not
- recognize a double dash as end-of-comments."
- REVISION "200502070000Z"
- DESCRIPTION
- "Fixing syntax errors"
- REVISION "200202090000Z"
- DESCRIPTION
- "First revision."
- ::= { netSnmpModuleIDs 2 }
- nsVersion OBJECT IDENTIFIER ::= {netSnmpObjects 1}
- nsMibRegistry OBJECT IDENTIFIER ::= {netSnmpObjects 2}
- nsExtensions OBJECT IDENTIFIER ::= {netSnmpObjects 3}
- nsDLMod OBJECT IDENTIFIER ::= {netSnmpObjects 4}
- nsCache OBJECT IDENTIFIER ::= {netSnmpObjects 5}
- nsErrorHistory OBJECT IDENTIFIER ::= {netSnmpObjects 6}
- nsConfiguration OBJECT IDENTIFIER ::= {netSnmpObjects 7}
- nsTransactions OBJECT IDENTIFIER ::= {netSnmpObjects 8}
- --
- -- MIB Module data caching management
- --
- NetsnmpCacheStatus ::= TEXTUAL-CONVENTION
- STATUS current
- DESCRIPTION "an indication of the status of data caching entries"
- SYNTAX INTEGER {
- enabled(1),
- disabled(2),
- empty (3),
- cached (4),
- expired(5)
- }
- nsCacheDefaultTimeout OBJECT-TYPE
- SYNTAX INTEGER -- ???
- MAX-ACCESS read-write
- STATUS current
- DESCRIPTION
- "Default cache timeout value (unless overridden
- for a particular cache entry)."
- DEFVAL { 5 } --seconds--
- ::= { nsCache 1 }
- nsCacheEnabled OBJECT-TYPE
- SYNTAX TruthValue
- MAX-ACCESS read-write
- STATUS current
- DESCRIPTION
- "Whether data caching is active overall."
- DEFVAL { true }
- ::= { nsCache 2 }
- nsCacheTable OBJECT-TYPE
- SYNTAX SEQUENCE OF NsCacheEntry
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "A table of individual MIB module data caches."
- ::= { nsCache 3 }
- nsCacheEntry OBJECT-TYPE
- SYNTAX NsCacheEntry
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "A conceptual row within the cache table."
- INDEX { IMPLIED nsCachedOID }
- ::= { nsCacheTable 1 }
- NsCacheEntry ::= SEQUENCE {
- nsCachedOID OBJECT IDENTIFIER,
- nsCacheTimeout INTEGER, -- ?? TimeTicks ??
- nsCacheStatus NetsnmpCacheStatus -- ?? INTEGER ??
- }
- nsCachedOID OBJECT-TYPE
- SYNTAX OBJECT IDENTIFIER
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "The root OID of the data being cached."
- ::= { nsCacheEntry 1 }
- nsCacheTimeout OBJECT-TYPE
- SYNTAX INTEGER
- MAX-ACCESS read-write
- STATUS current
- DESCRIPTION
- "The length of time (?in seconds) for which the data in
- this particular cache entry will remain valid."
- ::= { nsCacheEntry 2 }
- nsCacheStatus OBJECT-TYPE
- SYNTAX NetsnmpCacheStatus
- MAX-ACCESS read-write
- STATUS current
- DESCRIPTION
- "The current status of this particular cache entry.
- Acceptable values for Set requests are 'enabled(1)',
- 'disabled(2)' or 'empty(3)' (to clear all cached data).
- Requests to read the value of such an object will
- return 'disabled(2)' through to 'expired(5)'."
- ::= { nsCacheEntry 3 }
- --
- -- Agent configuration
- -- Debug and logging output
- --
- nsConfigDebug OBJECT IDENTIFIER ::= {nsConfiguration 1}
- nsConfigLogging OBJECT IDENTIFIER ::= {nsConfiguration 2}
- nsDebugEnabled OBJECT-TYPE
- SYNTAX TruthValue
- MAX-ACCESS read-write
- STATUS current
- DESCRIPTION
- "Whether the agent is configured to generate debugging output"
- DEFVAL { false }
- ::= { nsConfigDebug 1 }
- nsDebugOutputAll OBJECT-TYPE
- SYNTAX TruthValue
- MAX-ACCESS read-write
- STATUS current
- DESCRIPTION
- "Whether the agent is configured to display all debugging output
- rather than filtering on individual debug tokens. Nothing will
- be generated unless nsDebugEnabled is also true(1)"
- DEFVAL { false }
- ::= { nsConfigDebug 2 }
- nsDebugDumpPdu OBJECT-TYPE
- SYNTAX TruthValue
- MAX-ACCESS read-write
- STATUS current
- DESCRIPTION
- "Whether the agent is configured to display raw packet dumps.
- This is unrelated to the nsDebugEnabled setting."
- DEFVAL { false }
- ::= { nsConfigDebug 3 }
- nsDebugTokenTable OBJECT-TYPE
- SYNTAX SEQUENCE OF NsDebugTokenEntry
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "A table of individual debug tokens, used to control the selection
- of what debugging output should be produced. This table is only
- effective if nsDebugOutputAll is false(2), and nothing will
- be generated unless nsDebugEnabled is also true(1)"
- ::= { nsConfigDebug 4 }
- nsDebugTokenEntry OBJECT-TYPE
- SYNTAX NsDebugTokenEntry
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "A conceptual row within the debug token table."
- INDEX { IMPLIED nsDebugTokenPrefix }
- ::= { nsDebugTokenTable 1 }
- NsDebugTokenEntry ::= SEQUENCE {
- nsDebugTokenPrefix DisplayString,
- nsDebugTokenStatus RowStatus
- }
- nsDebugTokenPrefix OBJECT-TYPE
- SYNTAX DisplayString
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "A token prefix for which to generate the corresponding
- debugging output. Note that debug output will be generated
- for all registered debug statements sharing this prefix
- (rather than an exact match). Nothing will be generated
- unless both nsDebuggingEnabled is set true(1) and the
- corresponding nsDebugTokenStatus value is active(1)."
- ::= { nsDebugTokenEntry 2 }
- nsDebugTokenStatus OBJECT-TYPE
- SYNTAX RowStatus
- MAX-ACCESS read-create
- STATUS current
- DESCRIPTION
- "Whether to generate debug output for the corresponding debug
- token prefix. Nothing will be generated unless both
- nsDebuggingEnabled is true(1) and this instance is active(1).
- 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."
- ::= { nsDebugTokenEntry 4 }
- --
- -- Logging configuration
- --
- nsLoggingTable OBJECT-TYPE
- SYNTAX SEQUENCE OF NsLoggingEntry
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "A table of individual logging output destinations, used to control
- where various levels of output from the agent should be directed."
- ::= { nsConfigLogging 1 }
- nsLoggingEntry OBJECT-TYPE
- SYNTAX NsLoggingEntry
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "A conceptual row within the logging table."
- INDEX { nsLogLevel, IMPLIED nsLogToken }
- ::= { nsLoggingTable 1 }
- NsLoggingEntry ::= SEQUENCE {
- nsLogLevel INTEGER,
- nsLogToken DisplayString,
- nsLogType INTEGER,
- nsLogMaxLevel INTEGER,
- nsLogStatus RowStatus
- }
- nsLogLevel OBJECT-TYPE
- SYNTAX INTEGER {
- emergency(0),
- alert (1),
- critical (2),
- error (3),
- warning (4),
- notice (5),
- info (6),
- debug (7)
- }
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "The (minimum) priority level for which this logging entry
- should be applied."
- ::= { nsLoggingEntry 1 }
- nsLogToken OBJECT-TYPE
- SYNTAX DisplayString
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "A token for which to generate logging entries.
- Depending on the style of logging, this may either
- be simply an arbitrary token, or may have some
- particular meaning (such as the filename to log to)."
- ::= { nsLoggingEntry 2 }
- nsLogType OBJECT-TYPE
- SYNTAX INTEGER {
- stdout (1),
- stderr (2),
- file (3),
- syslog (4),
- callback (5)
- }
- MAX-ACCESS read-create
- STATUS current
- DESCRIPTION
- "The type of logging for this entry."
- ::= { nsLoggingEntry 3 }
- nsLogMaxLevel OBJECT-TYPE
- SYNTAX INTEGER {
- emergency(0),
- alert (1),
- critical (2),
- error (3),
- warning (4),
- notice (5),
- info (6),
- debug (7)
- }
- MAX-ACCESS read-create
- STATUS current
- DESCRIPTION
- "The maximum priority level for which this logging entry
- should be applied."
- DEFVAL { emergency }
- ::= { nsLoggingEntry 4 }
- nsLogStatus OBJECT-TYPE
- SYNTAX RowStatus
- MAX-ACCESS read-create
- STATUS current
- DESCRIPTION
- "Whether to generate logging output for this entry.
- 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."
- ::= { nsLoggingEntry 5 }
- --
- -- Monitoring outstanding "transactions"
- -- (i.e. requests sent to AgentX subagents, or proxied agents)
- --
- nsTransactionTable OBJECT-TYPE
- SYNTAX SEQUENCE OF NsTransactionEntry
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "Lists currently outstanding transactions in the net-snmp agent.
- This includes requests to AgentX subagents, or proxied SNMP agents."
- ::= { nsTransactions 1 }
- nsTransactionEntry OBJECT-TYPE
- SYNTAX NsTransactionEntry
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "A row describing a given transaction."
- INDEX { nsTransactionID }
- ::= {nsTransactionTable 1 }
- NsTransactionEntry ::= SEQUENCE {
- nsTransactionID Unsigned32,
- nsTransactionMode Integer32
- }
- nsTransactionID OBJECT-TYPE
- SYNTAX Unsigned32 (0..4294967295)
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "The internal identifier for a given transaction."
- ::= { nsTransactionEntry 1 }
- nsTransactionMode OBJECT-TYPE
- SYNTAX Integer32
- MAX-ACCESS read-only
- STATUS current
- DESCRIPTION
- "The mode number for the current operation being performed."
- ::= { nsTransactionEntry 2 }
- --
- -- Monitoring the MIB modules currently registered in the agent
- -- (an updated version of UCD-SNMP-MIB::mrTable)
- --
- nsModuleTable OBJECT-TYPE
- SYNTAX SEQUENCE OF NsModuleEntry
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "A table displaying all the oid's registered by mib modules in
- the agent. Since the agent is modular in nature, this lists
- each module's OID it is responsible for and the name of the module"
- ::= { nsMibRegistry 1 }
- nsModuleEntry OBJECT-TYPE
- SYNTAX NsModuleEntry
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "An entry containing a registered mib oid."
- INDEX { nsmContextName, nsmRegistrationPoint,
- nsmRegistrationPriority }
- ::= { nsModuleTable 1 }
- NsModuleEntry ::= SEQUENCE {
- nsmContextName SnmpAdminString,
- nsmRegistrationPoint OBJECT IDENTIFIER,
- nsmRegistrationPriority INTEGER,
- nsModuleName DisplayString,
- nsModuleModes BITS,
- nsModuleTimeout Integer32
- }
- nsmContextName OBJECT-TYPE
- SYNTAX SnmpAdminString
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "The context name the module is registered under."
- ::= { nsModuleEntry 1 }
- nsmRegistrationPoint OBJECT-TYPE
- SYNTAX OBJECT IDENTIFIER
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "The registry OID of a mib module."
- ::= { nsModuleEntry 2 }
- nsmRegistrationPriority OBJECT-TYPE
- SYNTAX INTEGER (-2147483648..2147483647)
- MAX-ACCESS not-accessible
- STATUS current
- DESCRIPTION
- "The priority of the registered mib module."
- ::= { nsModuleEntry 3 }
- nsModuleName OBJECT-TYPE
- SYNTAX DisplayString
- MAX-ACCESS read-only
- STATUS current
- DESCRIPTION
- "The module name that registered this OID."
- ::= { nsModuleEntry 4 }
- nsModuleModes OBJECT-TYPE
- SYNTAX BITS { getAndGetNext(0), set(1), getBulk(2) }
- MAX-ACCESS read-only
- STATUS current
- DESCRIPTION
- "The modes that the particular lower level handler can cope
- with directly."
- ::= { nsModuleEntry 5 }
- nsModuleTimeout OBJECT-TYPE
- SYNTAX Integer32
- MAX-ACCESS read-only
- STATUS current
- DESCRIPTION
- "The registered timeout. This is only meaningful for handlers
- that expect to return results at a later date (subagents,
- etc)"
- ::= { nsModuleEntry 6 }
- --
- -- Notifications relating to the basic operation of the agent
- --
- nsNotifyStart NOTIFICATION-TYPE
- STATUS current
- DESCRIPTION
- "An indication that the agent has started running."
- ::= { netSnmpNotifications 1 }
-
- nsNotifyShutdown NOTIFICATION-TYPE
- STATUS current
- DESCRIPTION
- "An indication that the agent is in the process of being shut down."
- ::= { netSnmpNotifications 2 }
- nsNotifyRestart NOTIFICATION-TYPE
- STATUS current
- DESCRIPTION
- "An indication that the agent has been restarted.
- This does not imply anything about whether the configuration has
- changed or not (unlike the standard coldStart or warmStart traps)"
- ::= { netSnmpNotifications 3 }
-
- --
- -- Conformance-related definitions
- --
- nsModuleGroup OBJECT-GROUP
- OBJECTS {
- nsModuleName, nsModuleModes, nsModuleTimeout
- }
- STATUS current
- DESCRIPTION
- "The objects relating to the list of MIB modules registered
- with the Net-SNMP agent."
- ::= { netSnmpGroups 2 }
- nsCacheGroup OBJECT-GROUP
- OBJECTS {
- nsCacheDefaultTimeout, nsCacheEnabled,
- nsCacheTimeout, nsCacheStatus
- }
- STATUS current
- DESCRIPTION
- "The objects relating to data caching in the Net-SNMP agent."
- ::= { netSnmpGroups 4 }
- nsConfigGroups OBJECT IDENTIFIER ::= {netSnmpGroups 7}
- nsDebugGroup OBJECT-GROUP
- OBJECTS {
- nsDebugEnabled, nsDebugOutputAll, nsDebugDumpPdu,
- nsDebugTokenStatus
- }
- STATUS current
- DESCRIPTION
- "The objects relating to debug configuration in the Net-SNMP agent."
- ::= { nsConfigGroups 1 }
- nsLoggingGroup OBJECT-GROUP
- OBJECTS {
- nsLogType, nsLogMaxLevel, nsLogStatus
- }
- STATUS current
- DESCRIPTION
- "The objects relating to logging configuration in the Net-SNMP agent."
- ::= { nsConfigGroups 2 }
- nsTransactionGroup OBJECT-GROUP
- OBJECTS {
- nsTransactionMode
- }
- STATUS current
- DESCRIPTION
- "The objects relating to transaction monitoring in the Net-SNMP agent."
- ::= { netSnmpGroups 8 }
- nsAgentNotifyGroup NOTIFICATION-GROUP
- NOTIFICATIONS { nsNotifyStart, nsNotifyShutdown, nsNotifyRestart }
- STATUS current
- DESCRIPTION
- "The notifications relating to the basic operation of the Net-SNMP agent."
- ::= { netSnmpGroups 9 }
-
- END
|