mibs/MIBS/NET-SNMP-AGENT-MIB

555 lines
16 KiB
Plaintext
Raw Permalink Normal View History

2023-12-05 12:25:34 +01:00
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