home *** CD-ROM | disk | FTP | other *** search
/ PC World 2006 February / PCWorld_2006-02_cd.bin / software / vyzkuste / spioni / spioni.exe / ethereal-setup-0.10.14.exe / snmp / mibs / NET-SNMP-EXAMPLES-MIB.txt < prev    next >
Text File  |  2005-02-16  |  9KB  |  271 lines
  1. NET-SNMP-EXAMPLES-MIB DEFINITIONS ::= BEGIN
  2.  
  3. --
  4. -- Example MIB objects for agent module example implementations
  5. --
  6.  
  7. IMPORTS
  8.     MODULE-IDENTITY, OBJECT-TYPE, Integer32,
  9.     NOTIFICATION-TYPE                       FROM SNMPv2-SMI
  10.     SnmpAdminString                         FROM SNMP-FRAMEWORK-MIB
  11.     netSnmp                                 FROM NET-SNMP-MIB
  12.     RowStatus, StorageType                  FROM SNMPv2-TC
  13.     InetAddressType, InetAddress            FROM INET-ADDRESS-MIB
  14. ;
  15.  
  16. netSnmpExamples MODULE-IDENTITY
  17.     LAST-UPDATED "200406150000Z"
  18.     ORGANIZATION "www.net-snmp.org"
  19.     CONTACT-INFO    
  20.      "postal:   Wes Hardaker
  21.                     P.O. Box 382
  22.                     Davis CA  95617
  23.  
  24.           email:    net-snmp-coders@lists.sourceforge.net"
  25.     DESCRIPTION
  26.     "Example MIB objects for agent module example implementations"
  27.     REVISION     "200406150000Z"
  28.     DESCRIPTION
  29.     "Corrected notification example definitions"
  30.     REVISION     "200202060000Z"
  31.     DESCRIPTION
  32.     "First draft"
  33.     ::= { netSnmp 2 }
  34.  
  35. --
  36. -- top level structure
  37. --
  38. netSnmpExampleScalars       OBJECT IDENTIFIER ::= { netSnmpExamples 1 }
  39. netSnmpExampleTables        OBJECT IDENTIFIER ::= { netSnmpExamples 2 }
  40. netSnmpExampleNotifications OBJECT IDENTIFIER ::= { netSnmpExamples 3 }
  41. netSnmpExampleNotificationPrefix  OBJECT IDENTIFIER
  42.                                   ::= { netSnmpExampleNotifications 0 }
  43. netSnmpExampleNotificationObjects OBJECT IDENTIFIER
  44.                                   ::= { netSnmpExampleNotifications 2 }
  45. -- netSnmpTutorial          OBJECT IDENTIFIER ::= { netSnmpExamples 4 }
  46.  
  47. --
  48. -- Example scalars
  49. --
  50.  
  51. netSnmpExampleInteger OBJECT-TYPE
  52.     SYNTAX      Integer32
  53.     MAX-ACCESS  read-write
  54.     STATUS      current
  55.     DESCRIPTION
  56.     "This is a simple object which merely houses a writable
  57.      integer.  It's only purposes is to hold the value of a single
  58.      integer.  Writing to it will simply change the value for
  59.      subsequent GET/GETNEXT/GETBULK retrievals.
  60.  
  61.      This example object is implemented in the
  62.      agent/mibgroup/examples/scalar_int.c file."
  63.     DEFVAL { 42 }
  64.     ::= { netSnmpExampleScalars 1 }
  65.  
  66. netSnmpExampleSleeper OBJECT-TYPE
  67.     SYNTAX      Integer32
  68.     MAX-ACCESS  read-write
  69.     STATUS      current
  70.     DESCRIPTION
  71.     "This is a simple object which is a basic integer.  It's value
  72.      indicates the number of seconds that the agent will take in
  73.      responding to requests of this object.  This is implemented
  74.      in a way which will allow the agent to keep responding to
  75.      other requests while access to this object is blocked.  It is
  76.      writable, and changing it's value will change the amount of
  77.      time the agent will effectively wait for before returning a
  78.      response when this object is manipulated.  Note that SET
  79.      requests through this object will take longer, since the
  80.      delay is applied to each internal transaction phase, which
  81.      could result in delays of up to 4 times the value of this
  82.      object.
  83.  
  84.      This example object is implemented in the
  85.      agent/mibgroup/examples/delayed_instance.c file."
  86.     DEFVAL { 1 }
  87.     ::= { netSnmpExampleScalars 2 }
  88.  
  89.  
  90. --
  91. --  Example Tables
  92. --
  93.  
  94. netSnmpIETFWGTable OBJECT-TYPE
  95.     SYNTAX      SEQUENCE OF NetSnmpIETFWGEntry
  96.     MAX-ACCESS  not-accessible
  97.     STATUS      current
  98.     DESCRIPTION
  99.     "This table merely contains a set of data which is otherwise
  100.      useless for true network management.  It is a table which
  101.      describes properies about a IETF Working Group, such as the
  102.      names of the two working group chairs.
  103.  
  104.      This example table is implemented in the
  105.      agent/mibgroup/examples/data_set.c file."
  106.     ::= { netSnmpExampleTables 1 }
  107.  
  108. netSnmpIETFWGEntry OBJECT-TYPE
  109.     SYNTAX      NetSnmpIETFWGEntry
  110.     MAX-ACCESS  not-accessible
  111.     STATUS      current
  112.     DESCRIPTION
  113.     "A row describing a given working group"
  114.     INDEX   { nsIETFWGName }
  115.     ::= {netSnmpIETFWGTable 1 }
  116.  
  117. NetSnmpIETFWGEntry ::= SEQUENCE {
  118.     nsIETFWGName    OCTET STRING,
  119.     nsIETFWGChair1    OCTET STRING,
  120.     nsIETFWGChair2    OCTET STRING
  121. }
  122.  
  123. nsIETFWGName OBJECT-TYPE
  124.     SYNTAX      OCTET STRING (SIZE(1..32))
  125.     MAX-ACCESS  not-accessible
  126.     STATUS      current
  127.     DESCRIPTION
  128.     "The name of the IETF Working Group this table describes."
  129.     ::= { netSnmpIETFWGEntry 1 }
  130.  
  131. nsIETFWGChair1 OBJECT-TYPE
  132.     SYNTAX      OCTET STRING
  133.     MAX-ACCESS  read-create
  134.     STATUS      current
  135.     DESCRIPTION
  136.     "One of the names of the chairs for the IETF working group."
  137.     ::= { netSnmpIETFWGEntry 2 }
  138.  
  139. nsIETFWGChair2 OBJECT-TYPE
  140.     SYNTAX      OCTET STRING
  141.     MAX-ACCESS  read-create
  142.     STATUS      current
  143.     DESCRIPTION
  144.     "The other name, if one exists, of the chairs for the IETF
  145.     working group."
  146.     ::= { netSnmpIETFWGEntry 3 }
  147.  
  148. --
  149. -- A table used in a table_iterator example
  150. --   (agent/mibgroup/examples/netSnmpHostsTable*.[ch])
  151. --
  152.  
  153. netSnmpHostsTable OBJECT-TYPE
  154.     SYNTAX      SEQUENCE OF NetSnmpHostsEntry
  155.     MAX-ACCESS  not-accessible
  156.     STATUS      current
  157.     DESCRIPTION
  158.     "An example table that implements a wrapper around the
  159.     /etc/hosts file on a machine using the iterator helper API."
  160.     ::= { netSnmpExampleTables 2 }
  161.  
  162. netSnmpHostsEntry OBJECT-TYPE
  163.     SYNTAX      NetSnmpHostsEntry
  164.     MAX-ACCESS  not-accessible
  165.     STATUS      current
  166.     DESCRIPTION
  167.     "A host name mapped to an ip address"
  168.     INDEX   { netSnmpHostName }
  169.     ::= { netSnmpHostsTable 1 }
  170.  
  171. NetSnmpHostsEntry ::= SEQUENCE {
  172.     netSnmpHostName         OCTET STRING,
  173.     netSnmpHostAddressType  InetAddressType,
  174.     netSnmpHostAddress      InetAddress,
  175.     netSnmpHostStorage      StorageType,
  176.     netSnmpHostRowStatus    RowStatus
  177. }
  178.  
  179. netSnmpHostName OBJECT-TYPE
  180.     SYNTAX      OCTET STRING (SIZE(0..64))
  181.     MAX-ACCESS  not-accessible
  182.     STATUS      current
  183.     DESCRIPTION
  184.     "A host name that exists in the /etc/hosts (unix) file."
  185.     ::= { netSnmpHostsEntry 1 }
  186.  
  187. netSnmpHostAddressType OBJECT-TYPE
  188.     SYNTAX      InetAddressType
  189.     MAX-ACCESS  read-create
  190.     STATUS      current
  191.     DESCRIPTION
  192.     "The address type of then given host."
  193.     ::= { netSnmpHostsEntry 2 }
  194.  
  195. netSnmpHostAddress OBJECT-TYPE
  196.     SYNTAX      InetAddress
  197.     MAX-ACCESS  read-create
  198.     STATUS      current
  199.     DESCRIPTION
  200.     "The address of then given host."
  201.     ::= { netSnmpHostsEntry 3 }
  202.  
  203. netSnmpHostStorage OBJECT-TYPE
  204.     SYNTAX       StorageType
  205.     MAX-ACCESS   read-create
  206.     STATUS       current
  207.     DESCRIPTION "The storage type for this conceptual row."
  208.     DEFVAL      { nonVolatile }
  209.     ::= { netSnmpHostsEntry 4 }
  210.  
  211. netSnmpHostRowStatus OBJECT-TYPE
  212.     SYNTAX       RowStatus
  213.     MAX-ACCESS   read-create
  214.     STATUS       current
  215.     DESCRIPTION "The status of this conceptual row."
  216.     ::= { netSnmpHostsEntry 5 }
  217.  
  218.  
  219. --
  220. --  Example Notifications
  221. --
  222.  
  223. netSnmpExampleHeartbeatRate OBJECT-TYPE
  224.     SYNTAX      Integer32
  225.     MAX-ACCESS  accessible-for-notify
  226.     STATUS      current
  227.     DESCRIPTION
  228.         "A simple integer object, to act as a payload for the
  229.          netSnmpExampleHeartbeatNotification.  The value has
  230.          no real meaning, but is nominally the interval (in
  231.          seconds) between successive heartbeat notifications."
  232. ::= { netSnmpExampleNotificationObjects 1 }
  233.  
  234. netSnmpExampleHeartbeatName OBJECT-TYPE
  235.     SYNTAX      SnmpAdminString
  236.     MAX-ACCESS  accessible-for-notify
  237.     STATUS      current
  238.     DESCRIPTION
  239.         "A simple string object, to act as an optional payload
  240.          for the netSnmpExampleHeartbeatNotification.  This varbind
  241.          is not part of the notification definition, so is optional
  242.          and need not be included in the notification payload. 
  243.          The value has no real meaning, but the romantically inclined
  244.          may take it to be the object of the sender's affection,
  245.          and hence the cause of the heart beating faster."
  246. ::= { netSnmpExampleNotificationObjects 2 }
  247.  
  248. netSnmpExampleHeartbeatNotification NOTIFICATION-TYPE
  249.     OBJECTS     { netSnmpExampleHeartbeatRate }
  250.     STATUS      current
  251.     DESCRIPTION
  252.         "An example notification, used to illustrate the
  253.          definition and generation of trap and inform PDUs
  254.          (including the use of both standard and additional
  255.          varbinds in the notification payload).
  256.          This notification will typically be sent every
  257.      30 seconds, using the code found in the example module
  258.              agent/mibgroup/examples/notification.c"
  259. ::= { netSnmpExampleNotificationPrefix 1 }
  260.     
  261. netSnmpExampleNotification OBJECT-TYPE
  262.     SYNTAX      SnmpAdminString
  263.     MAX-ACCESS  accessible-for-notify
  264.     STATUS      obsolete
  265.     DESCRIPTION
  266.         "This object was improperly defined for its original purpose,
  267.          and should no longer be used."
  268. ::= { netSnmpExampleNotifications 1 }
  269.  
  270. END
  271.