286 lines
8.9 KiB
Plaintext
286 lines
8.9 KiB
Plaintext
NET-SNMP-EXAMPLES-MIB DEFINITIONS ::= BEGIN
|
|
|
|
--
|
|
-- Example MIB objects for agent module example implementations
|
|
--
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY, OBJECT-TYPE, Integer32,
|
|
NOTIFICATION-TYPE FROM SNMPv2-SMI
|
|
SnmpAdminString FROM SNMP-FRAMEWORK-MIB
|
|
netSnmp FROM NET-SNMP-MIB
|
|
RowStatus, StorageType FROM SNMPv2-TC
|
|
InetAddressType, InetAddress FROM INET-ADDRESS-MIB
|
|
;
|
|
|
|
netSnmpExamples MODULE-IDENTITY
|
|
LAST-UPDATED "200406150000Z"
|
|
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
|
|
"Example MIB objects for agent module example implementations"
|
|
REVISION "200406150000Z"
|
|
DESCRIPTION
|
|
"Corrected notification example definitions"
|
|
REVISION "200202060000Z"
|
|
DESCRIPTION
|
|
"First draft"
|
|
::= { netSnmp 2 }
|
|
|
|
--
|
|
-- top level structure
|
|
--
|
|
netSnmpExampleScalars OBJECT IDENTIFIER ::= { netSnmpExamples 1 }
|
|
netSnmpExampleTables OBJECT IDENTIFIER ::= { netSnmpExamples 2 }
|
|
netSnmpExampleNotifications OBJECT IDENTIFIER ::= { netSnmpExamples 3 }
|
|
netSnmpExampleNotificationPrefix OBJECT IDENTIFIER
|
|
::= { netSnmpExampleNotifications 0 }
|
|
netSnmpExampleNotificationObjects OBJECT IDENTIFIER
|
|
::= { netSnmpExampleNotifications 2 }
|
|
-- netSnmpTutorial OBJECT IDENTIFIER ::= { netSnmpExamples 4 }
|
|
|
|
--
|
|
-- Example scalars
|
|
--
|
|
|
|
netSnmpExampleInteger OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This is a simple object which merely houses a writable
|
|
integer. It's only purposes is to hold the value of a single
|
|
integer. Writing to it will simply change the value for
|
|
subsequent GET/GETNEXT/GETBULK retrievals.
|
|
|
|
This example object is implemented in the
|
|
agent/mibgroup/examples/scalar_int.c file."
|
|
DEFVAL { 42 }
|
|
::= { netSnmpExampleScalars 1 }
|
|
|
|
netSnmpExampleSleeper OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This is a simple object which is a basic integer. It's value
|
|
indicates the number of seconds that the agent will take in
|
|
responding to requests of this object. This is implemented
|
|
in a way which will allow the agent to keep responding to
|
|
other requests while access to this object is blocked. It is
|
|
writable, and changing it's value will change the amount of
|
|
time the agent will effectively wait for before returning a
|
|
response when this object is manipulated. Note that SET
|
|
requests through this object will take longer, since the
|
|
delay is applied to each internal transaction phase, which
|
|
could result in delays of up to 4 times the value of this
|
|
object.
|
|
|
|
This example object is implemented in the
|
|
agent/mibgroup/examples/delayed_instance.c file."
|
|
DEFVAL { 1 }
|
|
::= { netSnmpExampleScalars 2 }
|
|
|
|
netSnmpExampleString OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This is a simple object which merely houses a writable
|
|
string. It's only purposes is to hold the value of a single
|
|
string. Writing to it will simply change the value for
|
|
subsequent GET/GETNEXT/GETBULK retrievals.
|
|
|
|
This example object is implemented in the
|
|
agent/mibgroup/examples/watched.c file."
|
|
DEFVAL { "So long, and thanks for all the fish!" }
|
|
::= { netSnmpExampleScalars 3 }
|
|
|
|
|
|
--
|
|
-- Example Tables
|
|
--
|
|
|
|
netSnmpIETFWGTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF NetSnmpIETFWGEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table merely contains a set of data which is otherwise
|
|
useless for true network management. It is a table which
|
|
describes properies about a IETF Working Group, such as the
|
|
names of the two working group chairs.
|
|
|
|
This example table is implemented in the
|
|
agent/mibgroup/examples/data_set.c file."
|
|
::= { netSnmpExampleTables 1 }
|
|
|
|
netSnmpIETFWGEntry OBJECT-TYPE
|
|
SYNTAX NetSnmpIETFWGEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A row describing a given working group"
|
|
INDEX { nsIETFWGName }
|
|
::= {netSnmpIETFWGTable 1 }
|
|
|
|
NetSnmpIETFWGEntry ::= SEQUENCE {
|
|
nsIETFWGName OCTET STRING,
|
|
nsIETFWGChair1 OCTET STRING,
|
|
nsIETFWGChair2 OCTET STRING
|
|
}
|
|
|
|
nsIETFWGName OBJECT-TYPE
|
|
SYNTAX OCTET STRING (SIZE(1..32))
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The name of the IETF Working Group this table describes."
|
|
::= { netSnmpIETFWGEntry 1 }
|
|
|
|
nsIETFWGChair1 OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"One of the names of the chairs for the IETF working group."
|
|
::= { netSnmpIETFWGEntry 2 }
|
|
|
|
nsIETFWGChair2 OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The other name, if one exists, of the chairs for the IETF
|
|
working group."
|
|
::= { netSnmpIETFWGEntry 3 }
|
|
|
|
--
|
|
-- A table used in a table_iterator example
|
|
-- (agent/mibgroup/examples/netSnmpHostsTable*.[ch])
|
|
--
|
|
|
|
netSnmpHostsTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF NetSnmpHostsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An example table that implements a wrapper around the
|
|
/etc/hosts file on a machine using the iterator helper API."
|
|
::= { netSnmpExampleTables 2 }
|
|
|
|
netSnmpHostsEntry OBJECT-TYPE
|
|
SYNTAX NetSnmpHostsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A host name mapped to an ip address"
|
|
INDEX { netSnmpHostName }
|
|
::= { netSnmpHostsTable 1 }
|
|
|
|
NetSnmpHostsEntry ::= SEQUENCE {
|
|
netSnmpHostName OCTET STRING,
|
|
netSnmpHostAddressType InetAddressType,
|
|
netSnmpHostAddress InetAddress,
|
|
netSnmpHostStorage StorageType,
|
|
netSnmpHostRowStatus RowStatus
|
|
}
|
|
|
|
netSnmpHostName OBJECT-TYPE
|
|
SYNTAX OCTET STRING (SIZE(0..64))
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A host name that exists in the /etc/hosts (unix) file."
|
|
::= { netSnmpHostsEntry 1 }
|
|
|
|
netSnmpHostAddressType OBJECT-TYPE
|
|
SYNTAX InetAddressType
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The address type of then given host."
|
|
::= { netSnmpHostsEntry 2 }
|
|
|
|
netSnmpHostAddress OBJECT-TYPE
|
|
SYNTAX InetAddress
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The address of then given host."
|
|
::= { netSnmpHostsEntry 3 }
|
|
|
|
netSnmpHostStorage OBJECT-TYPE
|
|
SYNTAX StorageType
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION "The storage type for this conceptual row."
|
|
DEFVAL { nonVolatile }
|
|
::= { netSnmpHostsEntry 4 }
|
|
|
|
netSnmpHostRowStatus OBJECT-TYPE
|
|
SYNTAX RowStatus
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION "The status of this conceptual row."
|
|
::= { netSnmpHostsEntry 5 }
|
|
|
|
|
|
--
|
|
-- Example Notifications
|
|
--
|
|
|
|
netSnmpExampleHeartbeatRate OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS accessible-for-notify
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A simple integer object, to act as a payload for the
|
|
netSnmpExampleHeartbeatNotification. The value has
|
|
no real meaning, but is nominally the interval (in
|
|
seconds) between successive heartbeat notifications."
|
|
::= { netSnmpExampleNotificationObjects 1 }
|
|
|
|
netSnmpExampleHeartbeatName OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS accessible-for-notify
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A simple string object, to act as an optional payload
|
|
for the netSnmpExampleHeartbeatNotification. This varbind
|
|
is not part of the notification definition, so is optional
|
|
and need not be included in the notification payload.
|
|
The value has no real meaning, but the romantically inclined
|
|
may take it to be the object of the sender's affection,
|
|
and hence the cause of the heart beating faster."
|
|
::= { netSnmpExampleNotificationObjects 2 }
|
|
|
|
netSnmpExampleHeartbeatNotification NOTIFICATION-TYPE
|
|
OBJECTS { netSnmpExampleHeartbeatRate }
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An example notification, used to illustrate the
|
|
definition and generation of trap and inform PDUs
|
|
(including the use of both standard and additional
|
|
varbinds in the notification payload).
|
|
This notification will typically be sent every
|
|
30 seconds, using the code found in the example module
|
|
agent/mibgroup/examples/notification.c"
|
|
::= { netSnmpExampleNotificationPrefix 1 }
|
|
|
|
netSnmpExampleNotification OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS accessible-for-notify
|
|
STATUS obsolete
|
|
DESCRIPTION
|
|
"This object was improperly defined for its original purpose,
|
|
and should no longer be used."
|
|
::= { netSnmpExampleNotifications 1 }
|
|
|
|
END
|