home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 May / W2KPRK.iso / apps / InternetScanner / data1.cab / Program_Files / Mibs / SNMP-TARGET-MIB.txt < prev    next >
Encoding:
Text File  |  1999-11-22  |  18.7 KB  |  612 lines
  1. SNMP-TARGET-MIB DEFINITIONS ::= BEGIN
  2.  
  3. IMPORTS
  4.    TEXTUAL-CONVENTION,
  5.    MODULE-IDENTITY,
  6.    OBJECT-TYPE,
  7.    snmpModules,
  8.    Integer32
  9.        FROM SNMPv2-SMI
  10.  
  11.    TDomain,
  12.    TAddress,
  13.    TimeInterval,
  14.    RowStatus,
  15.    StorageType,
  16.    TestAndIncr
  17.        FROM SNMPv2-TC
  18.    SnmpSecurityModel,
  19.    SnmpMessageProcessingModel,
  20.    SnmpSecurityLevel,
  21.    SnmpAdminString
  22.        FROM SNMP-FRAMEWORK-MIB
  23.  
  24.    OBJECT-GROUP
  25.        FROM SNMPv2-CONF;
  26.  
  27. snmpTargetMIB MODULE-IDENTITY
  28.    LAST-UPDATED "9711210000Z"
  29.    ORGANIZATION "IETF SNMPv3 Working Group"
  30.    CONTACT-INFO
  31.        "WG-email:   snmpv3@tis.com
  32.     Subscribe:  majordomo@tis.com
  33.             In message body:  subscribe snmpv3
  34.  
  35.     Chair:      Russ Mundy
  36.             Trusted Information Systems
  37.     Postal:     3060 Washington Rd
  38.             Glenwood MD 21738
  39.             USA
  40.     Email:      mundy@tis.com
  41.     Phone:      +1-301-854-6889
  42.  
  43.     Co-editor:  David B. Levi
  44.             SNMP Research, Inc.
  45.     Postal:     3001 Kimberlin Heights Road
  46.             Knoxville, TN 37920-9716
  47.     E-mail:     levi@snmp.com
  48.     Phone:      +1 423 573 1434
  49.  
  50.     Co-editor:  Paul Meyer
  51.             Secure Computing Corporation
  52.     Postal:     2675 Long Lake Road
  53.             Roseville, MN 55113
  54.     E-mail:     paul_meyer@securecomputing.com
  55.     Phone:      +1 612 628 1592
  56.  
  57.     Co-editor:  Bob Stewart
  58.             Cisco Systems, Inc.
  59.     Postal:     170 West Tasman Drive
  60.             San Jose, CA 95134-1706
  61.     E-mail:     bstewart@cisco.com
  62.     Phone:      +1 603 654 6923"
  63.    DESCRIPTION
  64.        "This MIB module defines MIB objects which provide
  65.     mechanisms to remotely configure the parameters used
  66.     by an SNMP entity for the generation of SNMP messages."
  67.    REVISION        "9707140000Z"
  68.    DESCRIPTION
  69.        "The initial revision."
  70.    ::= { snmpModules 15 }
  71.  
  72. snmpTargetObjects       OBJECT IDENTIFIER ::= { snmpTargetMIB 1 }
  73. snmpTargetConformance   OBJECT IDENTIFIER ::= { snmpTargetMIB 3 }
  74.  
  75. SnmpTagValue ::= TEXTUAL-CONVENTION
  76.    DISPLAY-HINT "255a"
  77.    STATUS       current
  78.    DESCRIPTION
  79.        "An octet string containing a tag value.
  80.     Tag values are preferably in human-readable form.
  81.  
  82.     To facilitate internationalization, this information
  83.     is represented using the ISO/IEC IS 10646-1 character
  84.     set, encoded as an octet string using the UTF-8
  85.     character encoding scheme described in RFC 2044.
  86.  
  87.     Since additional code points are added by amendments
  88.     to the 10646 standard from time to time,
  89.     implementations must be prepared to encounter any code
  90.     point from 0x00000000 to 0x7fffffff.
  91.  
  92.     The use of control codes should be avoided, and certain
  93.     control codes are not allowed as described below.
  94.  
  95.     For code points not directly supported by user
  96.     interface hardware or software, an alternative means
  97.     of entry and display, such as hexadecimal, may be
  98.     provided.
  99.  
  100.     For information encoded in 7-bit US-ASCII, the UTF-8
  101.     representation is identical to the US-ASCII encoding.
  102.  
  103.     Note that when this TC is used for an object that
  104.     is used or envisioned to be used as an index, then a
  105.     SIZE restriction must be specified so that the number
  106.     sub-identifiers for any object instance do not exceed
  107.     the limit of 128, as defined by [RFC1905].
  108.  
  109.     An object of this type contains a single tag value
  110.     which is used to select a set of entries in a table.
  111.     A tag value is an arbitrary string of octets, but
  112.     may not contain a delimiter character.  Delimiter
  113.     characters are defined to be one of the following:
  114.  
  115.         -  An ASCII space character (0x20).
  116.  
  117.         -  An ASCII TAB character (0x09).
  118.  
  119.         -  An ASCII carriage return (CR) character (0x0D).
  120.  
  121.         -  An ASCII line feed (LF) character (0x0B).
  122.  
  123.     Delimiter characters are used to separate tag values
  124.     in a tag list.  An object of this type may only
  125.     contain a single tag value, and so delimiter
  126.     characters are not allowed in a value of this type.
  127.  
  128.     Some examples of valid tag values are:
  129.  
  130.         - 'acme'
  131.  
  132.         - 'router'
  133.  
  134.         - 'host'
  135.  
  136.     The use of a tag value to select table entries is
  137.     application and MIB specific."
  138.    SYNTAX       OCTET STRING (SIZE (0..255))
  139.  
  140. SnmpTagList ::= TEXTUAL-CONVENTION
  141.    DISPLAY-HINT "255a"
  142.    STATUS       current
  143.    DESCRIPTION
  144.        "An octet string containing a list of tag values.
  145.     Tag values are preferably in human-readable form.
  146.  
  147.     To facilitate internationalization, this information
  148.     is represented using the ISO/IEC IS 10646-1 character
  149.     set, encoded as an octet string using the UTF-8
  150.     character encoding scheme described in RFC 2044.
  151.     Since additional code points are added by amendments
  152.     to the 10646 standard from time to time,
  153.     implementations must be prepared to encounter any code
  154.     point from 0x00000000 to 0x7fffffff.
  155.  
  156.     The use of control codes should be avoided, except as
  157.     described below.
  158.  
  159.     For code points not directly supported by user
  160.     interface hardware or software, an alternative means
  161.     of entry and display, such as hexadecimal, may be
  162.     provided.
  163.  
  164.     For information encoded in 7-bit US-ASCII, the UTF-8
  165.     representation is identical to the US-ASCII encoding.
  166.  
  167.     An object of this type contains a list of tag values
  168.     which are used to select a set of entries in a table.
  169.  
  170.     A tag value is an arbitrary string of octets, but
  171.     may not contain a delimiter character.  Delimiter
  172.     characters are defined to be one of the following:
  173.  
  174.         -  An ASCII space character (0x20).
  175.  
  176.         -  An ASCII TAB character (0x09).
  177.  
  178.         -  An ASCII carriage return (CR) character (0x0D).
  179.  
  180.         -  An ASCII line feed (LF) character (0x0B).
  181.  
  182.     Delimiter characters are used to separate tag values
  183.     in a tag list.  Only a single delimiter character may
  184.     occur between two tag values.  A tag value may not
  185.     have a zero length.  These constraints imply certain
  186.     restrictions on the contents of this object:
  187.  
  188.         - There cannot be a leading or trailing delimiter
  189.           character.
  190.  
  191.         - There cannot be multiple adjacent delimiter
  192.           characters.
  193.  
  194.     Some examples of valid tag lists are:
  195.  
  196.         - An empty string
  197.  
  198.         - 'acme router'
  199.         - 'host managerStation'
  200.  
  201.     Note that although a tag value may not have a length of
  202.     zero, an empty string is still valid.  This indicates
  203.     an empty list (i.e. there are no tag values in the list).
  204.  
  205.     The use of the tag list to select table entries is
  206.     application and MIB specific.  Typically, an application
  207.     will provide one or more tag values, and any entry
  208.     which contains some combination of these tag values
  209.     will be selected."
  210.    SYNTAX       OCTET STRING (SIZE (0..255))
  211.  
  212. --
  213. --
  214. -- The snmpTargetObjects group
  215. --
  216. --
  217.  
  218. snmpTargetSpinLock OBJECT-TYPE
  219.    SYNTAX      TestAndIncr
  220.    MAX-ACCESS  read-write
  221.    STATUS      current
  222.    DESCRIPTION
  223.        "This object is used to facilitate modification of table
  224.     entries in the SNMP-TARGET-MIB module by multiple
  225.     managers.  In particular, it is useful when modifying
  226.     the value of the snmpTargetAddrTagList object.
  227.  
  228.     The procedure for modifying the snmpTargetAddrTagList
  229.     object is as follows:
  230.  
  231.         1.  Retrieve the value of snmpTargetSpinLock and
  232.         of snmpTargetAddrTagList.
  233.  
  234.         2.  Generate a new value for snmpTargetAddrTagList.
  235.  
  236.         3.  Set the value of snmpTargetSpinLock to the
  237.         retrieved value, and the value of
  238.         snmpTargetAddrTagList to the new value.  If
  239.         the set fails for the snmpTargetSpinLock
  240.         object, go back to step 1."
  241.    ::= { snmpTargetObjects 1 }
  242.  
  243. snmpTargetAddrTable OBJECT-TYPE
  244.    SYNTAX      SEQUENCE OF SnmpTargetAddrEntry
  245.    MAX-ACCESS  not-accessible
  246.    STATUS      current
  247.    DESCRIPTION
  248.        "A table of transport addresses to be used in the generation
  249.     of SNMP messages."
  250.  
  251.    ::= { snmpTargetObjects 2 }
  252.  
  253. snmpTargetAddrEntry OBJECT-TYPE
  254.    SYNTAX      SnmpTargetAddrEntry
  255.    MAX-ACCESS  not-accessible
  256.    STATUS      current
  257.    DESCRIPTION
  258.        "A transport address to be used in the generation
  259.     of SNMP operations.
  260.  
  261.     Entries in the snmpTargetAddrTable are created and
  262.     deleted using the snmpTargetAddrRowStatus object."
  263.    INDEX { IMPLIED snmpTargetAddrName }
  264.    ::= { snmpTargetAddrTable 1 }
  265.  
  266. SnmpTargetAddrEntry ::= SEQUENCE {
  267.    snmpTargetAddrName         SnmpAdminString,
  268.    snmpTargetAddrTDomain      TDomain,
  269.    snmpTargetAddrTAddress     TAddress,
  270.    snmpTargetAddrTimeout      TimeInterval,
  271.    snmpTargetAddrRetryCount   Integer32,
  272.    snmpTargetAddrTagList      SnmpTagList,
  273.    snmpTargetAddrParams       SnmpAdminString,
  274.    snmpTargetAddrStorageType  StorageType,
  275.    snmpTargetAddrRowStatus    RowStatus
  276. }
  277.  
  278. snmpTargetAddrName OBJECT-TYPE
  279.    SYNTAX      SnmpAdminString (SIZE(1..32))
  280.    MAX-ACCESS  not-accessible
  281.    STATUS      current
  282.    DESCRIPTION
  283.        "The locally arbitrary, but unique identifier associated
  284.     with this snmpTargetAddrEntry."
  285.    ::= { snmpTargetAddrEntry 1 }
  286.  
  287. snmpTargetAddrTDomain OBJECT-TYPE
  288.    SYNTAX      TDomain
  289.    MAX-ACCESS  read-create
  290.    STATUS      current
  291.    DESCRIPTION
  292.        "This object indicates the transport type of the address
  293.     contained in the snmpTargetAddrTAddress object."
  294.    ::= { snmpTargetAddrEntry 2 }
  295.  
  296. snmpTargetAddrTAddress OBJECT-TYPE
  297.    SYNTAX      TAddress
  298.    MAX-ACCESS  read-create
  299.    STATUS      current
  300.    DESCRIPTION
  301.        "This object contains a transport address.  The format of
  302.     this address depends on the value of the
  303.     snmpTargetAddrTDomain object."
  304.    ::= { snmpTargetAddrEntry 3 }
  305.  
  306. snmpTargetAddrTimeout OBJECT-TYPE
  307.    SYNTAX      TimeInterval
  308.    MAX-ACCESS  read-create
  309.    STATUS      current
  310.    DESCRIPTION
  311.        "This object should reflect the expected maximum round
  312.     trip time for communicating with the transport address
  313.     defined by this row.  When a message is sent to this
  314.     address, and a response (if one is expected) is not
  315.     received within this time period, an implementation
  316.     may assume that the response will not be delivered.
  317.  
  318.     Note that the time interval that an application waits
  319.     for a response may actually be derived from the value
  320.     of this object.  The method for deriving the actual time
  321.     interval is implementation dependent.  One such method
  322.     is to derive the expected round trip time based on a
  323.     particular retransmission algorithm and on the number
  324.     of timeouts which have occurred.  The type of message may
  325.     also be considered when deriving expected round trip
  326.     times for retransmissions.  For example, if a message is
  327.     being sent with a securityLevel that indicates both
  328.     authentication and privacy, the derived value may be
  329.     increased to compensate for extra processing time spent
  330.     during authentication and encryption processing."
  331.    DEFVAL { 1500 }
  332.    ::= { snmpTargetAddrEntry 4 }
  333.  
  334. snmpTargetAddrRetryCount OBJECT-TYPE
  335.    SYNTAX      Integer32 (0..255)
  336.    MAX-ACCESS  read-create
  337.    STATUS      current
  338.    DESCRIPTION
  339.        "This object specifies a default number of retries to be
  340.     attempted when a response is not received for a generated
  341.     message.  An application may provide its own retry count,
  342.     in which case the value of this object is ignored."
  343.    DEFVAL { 3 }
  344.    ::= { snmpTargetAddrEntry 5 }
  345.  
  346. snmpTargetAddrTagList OBJECT-TYPE
  347.    SYNTAX      SnmpTagList
  348.    MAX-ACCESS  read-create
  349.    STATUS      current
  350.    DESCRIPTION
  351.        "This object contains a list of tag values which are
  352.     used to select target addresses for a particular
  353.     operation."
  354.    ::= { snmpTargetAddrEntry 6 }
  355.  
  356. snmpTargetAddrParams OBJECT-TYPE
  357.    SYNTAX      SnmpAdminString (SIZE(1..32))
  358.    MAX-ACCESS  read-create
  359.    STATUS      current
  360.    DESCRIPTION
  361.        "The value of this object identifies an entry in the
  362.     snmpTargetParamsTable.  The identified entry
  363.     contains SNMP parameters to be used when generating
  364.     messages to be sent to this transport address."
  365.    ::= { snmpTargetAddrEntry 7 }
  366.  
  367. snmpTargetAddrStorageType OBJECT-TYPE
  368.    SYNTAX      StorageType
  369.    MAX-ACCESS  read-create
  370.    STATUS      current
  371.    DESCRIPTION
  372.        "The storage type for this conceptual row."
  373.    ::= { snmpTargetAddrEntry 8 }
  374.  
  375. snmpTargetAddrRowStatus OBJECT-TYPE
  376.    SYNTAX      RowStatus
  377.    MAX-ACCESS  read-create
  378.    STATUS      current
  379.    DESCRIPTION
  380.        "The status of this conceptual row.
  381.  
  382.     To create a row in this table, a manager must
  383.     set this object to either createAndGo(4) or
  384.     createAndWait(5).
  385.  
  386.     Until instances of all corresponding columns are
  387.     appropriately configured, the value of the
  388.     corresponding instance of the snmpTargetAddrRowStatus
  389.     column is 'notReady'.
  390.  
  391.     In particular, a newly created row cannot be made
  392.     active until the corresponding snmpTargetAddrTDomain
  393.     and snmpTargetAddrTAddress have both been set.
  394.  
  395.     The following objects may not be modified while the
  396.     value of this object is active(1):
  397.         - snmpTargetAddrTDomain
  398.         - snmpTargetAddrTAddress"
  399.    ::= { snmpTargetAddrEntry 9 }
  400.  
  401. snmpTargetParamsTable OBJECT-TYPE
  402.    SYNTAX      SEQUENCE OF SnmpTargetParamsEntry
  403.    MAX-ACCESS  not-accessible
  404.    STATUS      current
  405.    DESCRIPTION
  406.        "A table of SNMP target information to be used
  407.     in the generation of SNMP messages."
  408.    ::= { snmpTargetObjects 3 }
  409.  
  410. snmpTargetParamsEntry OBJECT-TYPE
  411.    SYNTAX      SnmpTargetParamsEntry
  412.    MAX-ACCESS  not-accessible
  413.    STATUS      current
  414.    DESCRIPTION
  415.        "A set of SNMP target information.
  416.  
  417.     Entries in the snmpTargetParamsTable are created and
  418.     deleted using the snmpTargetParamsRowStatus object."
  419.    INDEX { IMPLIED snmpTargetParamsName }
  420.    ::= { snmpTargetParamsTable 1 }
  421.  
  422. SnmpTargetParamsEntry ::= SEQUENCE {
  423.    snmpTargetParamsName           SnmpAdminString,
  424.    snmpTargetParamsMPModel        SnmpMessageProcessingModel,
  425.    snmpTargetParamsSecurityModel  SnmpSecurityModel,
  426.    snmpTargetParamsSecurityName   SnmpAdminString,
  427.    snmpTargetParamsSecurityLevel  SnmpSecurityLevel,
  428.    snmpTargetParamsStorageType    StorageType,
  429.    snmpTargetParamsRowStatus      RowStatus
  430. }
  431.  
  432. snmpTargetParamsName OBJECT-TYPE
  433.    SYNTAX      SnmpAdminString (SIZE(1..32))
  434.    MAX-ACCESS  not-accessible
  435.    STATUS      current
  436.    DESCRIPTION
  437.        "The locally arbitrary, but unique identifier associated
  438.     with this snmpTargetParamsEntry."
  439.    ::= { snmpTargetParamsEntry 1 }
  440.  
  441. snmpTargetParamsMPModel OBJECT-TYPE
  442.    SYNTAX      SnmpMessageProcessingModel
  443.    MAX-ACCESS  read-create
  444.    STATUS      current
  445.    DESCRIPTION
  446.        "The Message Processing Model to be used when generating
  447.     SNMP messages using this entry."
  448.    ::= { snmpTargetParamsEntry 2 }
  449.  
  450. snmpTargetParamsSecurityModel OBJECT-TYPE
  451.    SYNTAX      SnmpSecurityModel (0..254 | 256..2147483647)
  452.    MAX-ACCESS  read-create
  453.    STATUS      current
  454.    DESCRIPTION
  455.        "The Security Model to be used when generating SNMP
  456.      messages using this entry."
  457.    ::= { snmpTargetParamsEntry 3 }
  458.  
  459. snmpTargetParamsSecurityName OBJECT-TYPE
  460.    SYNTAX      SnmpAdminString
  461.    MAX-ACCESS  read-create
  462.    STATUS      current
  463.    DESCRIPTION
  464.        "The securityName which identifies the Principal on
  465.     whose behalf SNMP messages will be generated using
  466.     this entry."
  467.    ::= { snmpTargetParamsEntry 4 }
  468.  
  469. snmpTargetParamsSecurityLevel OBJECT-TYPE
  470.    SYNTAX      SnmpSecurityLevel
  471.    MAX-ACCESS  read-create
  472.    STATUS      current
  473.    DESCRIPTION
  474.        "The Level of Security to be used when generating
  475.     SNMP messages using this entry."
  476.    ::= { snmpTargetParamsEntry 5 }
  477.  
  478. snmpTargetParamsStorageType OBJECT-TYPE
  479.    SYNTAX      StorageType
  480.    MAX-ACCESS  read-create
  481.    STATUS      current
  482.    DESCRIPTION
  483.        "The storage type for this conceptual row."
  484.    ::= { snmpTargetParamsEntry 6 }
  485.  
  486. snmpTargetParamsRowStatus OBJECT-TYPE
  487.    SYNTAX      RowStatus
  488.    MAX-ACCESS  read-create
  489.    STATUS      current
  490.    DESCRIPTION
  491.        "The status of this conceptual row.
  492.  
  493.     To create a row in this table, a manager must
  494.     set this object to either createAndGo(4) or
  495.     createAndWait(5).
  496.  
  497.     Until instances of all corresponding columns are
  498.     appropriately configured, the value of the
  499.     corresponding instance of the snmpTargetParamsRowStatus
  500.     column is 'notReady'.
  501.  
  502.     In particular, a newly created row cannot be made
  503.     active until the corresponding
  504.     snmpTargetParamsMPModel,
  505.     snmpTargetParamsSecurityModel,
  506.     snmpTargetParamsSecurityName,
  507.     and snmpTargetParamsSecurityLevel have all been set.
  508.  
  509.     The following objects may not be modified while the
  510.     value of this object is active(1):
  511.         - snmpTargetParamsMPModel
  512.         - snmpTargetParamsSecurityModel
  513.         - snmpTargetParamsSecurityName
  514.         - snmpTargetParamsSecurityLevel"
  515.    ::= { snmpTargetParamsEntry 7 }
  516.  
  517. snmpUnavailableContexts OBJECT-TYPE
  518.    SYNTAX       Counter32
  519.    MAX-ACCESS   read-only
  520.    STATUS       current
  521.    DESCRIPTION
  522.        "The total number of packets received by the SNMP
  523.     engine which were dropped because the context
  524.     contained in the mesage was unavailable."
  525.    ::= { snmpTargetObjects 4 }
  526.  
  527. snmpUnknownContexts OBJECT-TYPE
  528.    SYNTAX       Counter32
  529.    MAX-ACCESS   read-only
  530.    STATUS       current
  531.    DESCRIPTION
  532.        "The total number of packets received by the SNMP
  533.     engine which were dropped because the context
  534.     contained in the mesage was unknown."
  535.  
  536.    ::= { snmpTargetObjects 5 }
  537. --
  538. --
  539. -- Conformance information
  540. --
  541. --
  542.  
  543. snmpTargetCompliances OBJECT IDENTIFIER ::=
  544.                        { snmpTargetConformance 1 }
  545. snmpTargetGroups      OBJECT IDENTIFIER ::=
  546.                        { snmpTargetConformance 2 }
  547.  
  548. --
  549. --
  550. -- Compliance statements
  551. --
  552. --
  553.  
  554.  
  555. snmpTargetCommandResponderCompliance MODULE-COMPLIANCE
  556.    STATUS      current
  557.    DESCRIPTION
  558.        "The compliance statement for SNMP entities which include
  559.     a command responder application."
  560.    MODULE -- This Module
  561.        MANDATORY-GROUPS { snmpTargetCommandResponderGroup }
  562.    ::= { snmpTargetCompliances 1 }
  563.  
  564. snmpTargetBasicGroup OBJECT-GROUP
  565.    OBJECTS {
  566.        snmpTargetSpinLock,
  567.        snmpTargetAddrTDomain,
  568.        snmpTargetAddrTAddress,
  569.        snmpTargetAddrTagList,
  570.        snmpTargetAddrParams,
  571.        snmpTargetAddrStorageType,
  572.        snmpTargetAddrRowStatus,
  573.        snmpTargetParamsMPModel,
  574.        snmpTargetParamsSecurityModel,
  575.        snmpTargetParamsSecurityName,
  576.        snmpTargetParamsSecurityLevel,
  577.        snmpTargetParamsStorageType,
  578.        snmpTargetParamsRowStatus
  579.    }
  580.    STATUS      current
  581.    DESCRIPTION
  582.  
  583.        "A collection of objects providing basic remote
  584.     configuration of management targets."
  585.    ::= { snmpTargetGroups 1 }
  586.  
  587. snmpTargetResponseGroup OBJECT-GROUP
  588.    OBJECTS {
  589.        snmpTargetAddrTimeout,
  590.        snmpTargetAddrRetryCount
  591.    }
  592.    STATUS      current
  593.    DESCRIPTION
  594.        "A collection of objects providing remote configuration
  595.     of management targets for applications which generate
  596.     SNMP messages for which a response message would be
  597.     expected."
  598.    ::= { snmpTargetGroups 2 }
  599.  
  600. snmpTargetCommandResponderGroup OBJECT-GROUP
  601.    OBJECTS {
  602.        snmpUnavailableContexts,
  603.        snmpUnknownContexts
  604.    }
  605.    STATUS      current
  606.    DESCRIPTION
  607.        "A collection of objects required for command responder
  608.     applications, used for counting error conditions."
  609.    ::= { snmpTargetGroups 3 }
  610.  
  611. END
  612.