home *** CD-ROM | disk | FTP | other *** search
/ PC World 2005 December / PCWorld_2005-12_cd.bin / software / vyzkuste / trikyhackeru / trikyhackeru.exe / ethereal-setup-0.10.13.exe / snmp / mibs / NET-SNMP-EXTEND-MIB.txt < prev    next >
Text File  |  2004-05-18  |  9KB  |  323 lines
  1. NET-SNMP-EXTEND-MIB DEFINITIONS ::= BEGIN
  2.  
  3. --
  4. -- Defines a framework for scripted extensions
  5. --
  6.  
  7. IMPORTS
  8.     nsExtensions FROM NET-SNMP-AGENT-MIB
  9.  
  10.     OBJECT-TYPE, NOTIFICATION-TYPE, MODULE-IDENTITY, Integer32
  11.         FROM SNMPv2-SMI
  12.  
  13.     OBJECT-GROUP, NOTIFICATION-GROUP
  14.     FROM SNMPv2-CONF
  15.  
  16.     DisplayString, RowStatus, StorageType FROM SNMPv2-TC;
  17.  
  18.  
  19. netSnmpExtendMIB MODULE-IDENTITY
  20.     LAST-UPDATED "200405080000Z"
  21.     ORGANIZATION "www.net-snmp.org"
  22.     CONTACT-INFO    
  23.      "postal:   Wes Hardaker
  24.                     P.O. Box 382
  25.                     Davis CA  95617
  26.  
  27.           email:    net-snmp-coders@lists.sourceforge.net"
  28.     DESCRIPTION
  29.      "Defines a framework for scripted extensions for the Net-SNMP agent."
  30.     REVISION     "200405080000Z"
  31.     DESCRIPTION
  32.     "First revision."
  33.     ::= { nsExtensions 1 }
  34.  
  35. nsExtendObjects  OBJECT IDENTIFIER ::= { nsExtensions 2}
  36. nsExtendGroups   OBJECT IDENTIFIER ::= { nsExtensions 3}
  37.  
  38. nsExtendNumEntries OBJECT-TYPE
  39.     SYNTAX      INTEGER
  40.     MAX-ACCESS  read-only
  41.     STATUS      current
  42.     DESCRIPTION
  43.       "The number of rows in the nsExtendConfigTable"
  44.     ::= { nsExtendObjects 1 }
  45.  
  46. nsExtendConfigTable     OBJECT-TYPE
  47.     SYNTAX      SEQUENCE OF NsExtendConfigEntry
  48.     MAX-ACCESS  not-accessible
  49.     STATUS      current
  50.     DESCRIPTION
  51.       "A table of scripted extensions - configuration and (basic) output."
  52.     ::= { nsExtendObjects 2 }
  53.  
  54. nsExtendConfigEntry     OBJECT-TYPE
  55.     SYNTAX      NsExtendConfigEntry
  56.     MAX-ACCESS  not-accessible
  57.     STATUS      current
  58.     DESCRIPTION
  59.       "A conceptual row within the extension table."
  60.     INDEX       { nsExtendToken }
  61.     ::= { nsExtendConfigTable 1 }
  62.  
  63. NsExtendEntry ::= SEQUENCE {
  64.     nsExtendToken       DisplayString,
  65.     nsExtendCommand     DisplayString,
  66.     nsExtendArgs        DisplayString,
  67.     nsExtendInput       DisplayString,
  68.     nsExtendCacheTime   INTEGER,
  69.     nsExtendExecType    INTEGER,
  70.     nsExtendRunType     INTEGER,
  71.  
  72.     nsExtendStorage     StorageType,
  73.     nsExtendStatus      RowStatus
  74. }
  75.  
  76.     --
  77.     --  The configuration of an extension command
  78.     --
  79.  
  80. nsExtendToken   OBJECT-TYPE
  81.     SYNTAX      DisplayString
  82.     MAX-ACCESS  not-accessible
  83.     STATUS      current
  84.     DESCRIPTION
  85.       "An arbitrary token to identify this extension entry"
  86.     ::= { nsExtendConfigEntry 1 }
  87.  
  88. nsExtendCommand OBJECT-TYPE
  89.     SYNTAX      DisplayString
  90.     MAX-ACCESS  read-create
  91.     STATUS      current
  92.     DESCRIPTION
  93.       "The full path of the command binary (or script) to run"
  94.     ::= { nsExtendConfigEntry 2 }
  95.  
  96. nsExtendArgs    OBJECT-TYPE
  97.     SYNTAX      DisplayString
  98.     MAX-ACCESS  read-create
  99.     STATUS      current
  100.     DESCRIPTION
  101.       "Any command-line arguments for the command"
  102.     DEFVAL      { ''H }   -- the empty string
  103.     ::= { nsExtendConfigEntry 3 }
  104.  
  105. nsExtendInput   OBJECT-TYPE
  106.     SYNTAX      DisplayString
  107.     MAX-ACCESS  read-create
  108.     STATUS      current
  109.     DESCRIPTION
  110.       "The standard input for the command"
  111.     DEFVAL      { ''H }   -- the empty string
  112.     ::= { nsExtendConfigEntry 4 }
  113.  
  114. nsExtendCacheTime OBJECT-TYPE
  115.     SYNTAX      INTEGER
  116.     MAX-ACCESS  read-create
  117.     STATUS      current
  118.     DESCRIPTION
  119.       "The length of time for which the output of
  120.        this command will be cached.  During this time,
  121.        retrieving the output-related values will not
  122.        reinvoke the command.
  123.        A value of -1 indicates that the output results
  124.        should not be cached at all, and retrieving each
  125.        individual output-related value will invoke the
  126.        command afresh." 
  127.     DEFVAL      { 5 }
  128.     ::= { nsExtendConfigEntry 5 }
  129.  
  130. nsExtendExecType OBJECT-TYPE
  131.     SYNTAX      INTEGER
  132.                { exec  (1), -- 'fork-and-exec'
  133.                  shell (2)  -- run via a sub-shell
  134.                }
  135.     MAX-ACCESS  read-create
  136.     STATUS      current
  137.     DESCRIPTION
  138.       "The mechanism used to invoke the command."
  139.     DEFVAL      { exec }
  140.     ::= { nsExtendConfigEntry 6 }
  141.  
  142. nsExtendRunType OBJECT-TYPE
  143.     SYNTAX      INTEGER
  144.                { run-on-read (1),
  145.                  run-on-set  (2),
  146.                  run-command (3)
  147.                }
  148.     MAX-ACCESS  read-create
  149.     STATUS      current
  150.     DESCRIPTION
  151.       "Used to implement 'push-button' command invocation.
  152.        The command for a 'run-on-read' entry will be invoked
  153.        whenever one of the corresponding output-related
  154.        instances is requested (and assuming the cached value
  155.        is not still current).
  156.        The command for a 'run-on-set' entry will only be invoked
  157.        on receipt of a SET assignment for this object with the
  158.        value 'run-command'.
  159.        Reading an instance of this object will always return either
  160.        'run-on-read' or 'run-on-set'.
  161.       "
  162.     DEFVAL      { run-on-read }
  163.     ::= { nsExtendConfigEntry 7 }
  164.  
  165.     --
  166.     --  Standard table-manipulation objects
  167.     --
  168.  
  169. nsExtendStorage OBJECT-TYPE
  170.     SYNTAX      StorageType
  171.     MAX-ACCESS  read-create
  172.     STATUS      current
  173.     DESCRIPTION
  174.       "The storage type for this conceptual row."
  175.     DEFVAL      { volatile }
  176.     ::= { nsExtendConfigEntry 20 }
  177.  
  178. nsExtendStatus  OBJECT-TYPE
  179.     SYNTAX      RowStatus
  180.     MAX-ACCESS  read-create
  181.     STATUS      current
  182.     DESCRIPTION
  183.       "Used to create new rows in the table, in the standard manner.
  184.        Note that is valid for an instance to be left with the value
  185.        notInService(2) indefinitely - i.e. the meaning of 'abnormally
  186.        long' (see RFC 2579, RowStatus) for this table is infinite."
  187.     ::= { nsExtendConfigEntry 21 }
  188.  
  189.  
  190.     --
  191.     --  The results of running the extension command
  192.     --
  193.  
  194. nsExtendOutput1Table     OBJECT-TYPE
  195.     SYNTAX      SEQUENCE OF NsExtendOutput1Entry
  196.     MAX-ACCESS  not-accessible
  197.     STATUS      current
  198.     DESCRIPTION
  199.       "A table of scripted extensions - configuration and (basic) output."
  200.     ::= { nsExtendObjects 3 }
  201.  
  202. nsExtendOutput1Entry     OBJECT-TYPE
  203.     SYNTAX      NsExtendOutput1Entry
  204.     MAX-ACCESS  not-accessible
  205.     STATUS      current
  206.     DESCRIPTION
  207.       "A conceptual row within the extension table."
  208.     AUGMENTS    { nsExtendConfigEntry }
  209.     ::= { nsExtendOutput1Table 1 }
  210.  
  211. NsExtendOutput1Entry ::= SEQUENCE {
  212.     nsExtendOutput1Line OCTET STRING,
  213.     nsExtendOutputFull  OCTET STRING,
  214.     nsExtendOutNumLines INTEGER,
  215.     nsExtendResult      INTEGER,
  216. }
  217.  
  218. nsExtendOutput1Line OBJECT-TYPE
  219.     SYNTAX      DisplayString
  220.     MAX-ACCESS  read-only
  221.     STATUS      current
  222.     DESCRIPTION
  223.       "The first line of output from the command"
  224.     ::= { nsExtendOutput1Entry 1 }
  225.  
  226. nsExtendOutputFull  OBJECT-TYPE
  227.     SYNTAX      DisplayString
  228.     MAX-ACCESS  read-only
  229.     STATUS      current
  230.     DESCRIPTION
  231.       "The full output from the command, as a single string"
  232.     ::= { nsExtendOutput1Entry 2 }
  233.  
  234. nsExtendOutNumLines OBJECT-TYPE
  235.     SYNTAX      Integer32
  236.     MAX-ACCESS  read-only
  237.     STATUS      current
  238.     DESCRIPTION
  239.       "The number of lines of output (and hence
  240.        the number of rows in nsExtendOutputTable
  241.        relating to this particular entry)."
  242.     ::= { nsExtendOutput1Entry 3 }
  243.  
  244. nsExtendResult  OBJECT-TYPE
  245.     SYNTAX      Integer32
  246.     MAX-ACCESS  read-only
  247.     STATUS      current
  248.     DESCRIPTION
  249.       "The return value of the command."
  250.     ::= { nsExtendOutput1Entry 4 }
  251.  
  252.  
  253.     --
  254.     --  The line-based output table
  255.     --
  256.  
  257. nsExtendOutput2Table     OBJECT-TYPE
  258.     SYNTAX      SEQUENCE OF NsExtendOutput2Entry
  259.     MAX-ACCESS  not-accessible
  260.     STATUS      current
  261.     DESCRIPTION
  262.       "A table of (line-based) output from scripted extensions."
  263.     ::= { nsExtendObjects 4 }
  264.  
  265. nsExtendOutput2Entry     OBJECT-TYPE
  266.     SYNTAX      NsExtendOutput2Entry
  267.     MAX-ACCESS  not-accessible
  268.     STATUS      current
  269.     DESCRIPTION
  270.       "A conceptual row within the line-based output table."
  271.     INDEX       { nsExtendToken, nsExtendLineIndex }
  272.     ::= { nsExtendOutput2Table 1 }
  273.  
  274. NsExtendOutput2Entry ::= SEQUENCE {
  275.     nsExtendLineIndex INTEGER,
  276.     nsExtendOutLine   DisplayString
  277. }
  278.  
  279. nsExtendLineIndex OBJECT-TYPE
  280.     SYNTAX      INTEGER(1..1024)
  281.     MAX-ACCESS  not-accessible
  282.     STATUS      current
  283.     DESCRIPTION
  284.       "The index of this line of output.
  285.        For a given nsExtendToken, this will run from
  286.        1 to the corresponding value of nsExtendNumLines."
  287.     ::= { nsExtendOutput2Entry 1 }
  288.  
  289. nsExtendOutLine OBJECT-TYPE
  290.     SYNTAX      DisplayString
  291.     MAX-ACCESS  read-only
  292.     STATUS      current
  293.     DESCRIPTION
  294.       "A single line of output from the extension command."
  295.     ::= { nsExtendOutput2Entry 2 }
  296.  
  297. --
  298. -- Conformance-related definitions
  299. --
  300.  
  301. nsExtendConfigGroup  OBJECT-GROUP
  302.     OBJECTS {
  303.         nsExtendCommand,   nsExtendArgs,     nsExtendInput,
  304.         nsExtendCacheTime, nsExtendExecType, nsExtendRunType,
  305.         nsExtendStorage,   nsExtendStatus,   nsExtendNumEntries
  306.     }
  307.     STATUS    current
  308.     DESCRIPTION
  309.     "Objects relating to the configuration of extension commands."
  310.     ::= { nsExtendGroups 1 }
  311.  
  312. nsExtendOutputGroup  OBJECT-GROUP
  313.     OBJECTS {
  314.         nsExtendOutNumLines, nsExtendResult,
  315.         nsExtendOutLine,   nsExtendOutput1Line, nsExtendOutputFull
  316.     }
  317.     STATUS    current
  318.     DESCRIPTION
  319.     "Objects relating to the output of extension commands."
  320.     ::= { nsExtendGroups 2 }
  321.  
  322. END
  323.