SNMP-NOTIFICATION-MIB.txt
上传用户:wxp200602
上传日期:2007-10-30
资源大小:4028k
文件大小:20k
源码类别:

SNMP编程

开发平台:

Unix_Linux

  1. SNMP-NOTIFICATION-MIB DEFINITIONS ::= BEGIN
  2. IMPORTS
  3.     MODULE-IDENTITY,
  4.     OBJECT-TYPE,
  5.     snmpModules
  6.         FROM SNMPv2-SMI
  7.     RowStatus,
  8.     StorageType
  9.         FROM SNMPv2-TC
  10.     SnmpAdminString
  11.         FROM SNMP-FRAMEWORK-MIB
  12.     SnmpTagValue,
  13.     snmpTargetParamsName
  14.         FROM SNMP-TARGET-MIB
  15.     MODULE-COMPLIANCE,
  16.     OBJECT-GROUP
  17.         FROM SNMPv2-CONF;
  18. snmpNotificationMIB MODULE-IDENTITY
  19.     LAST-UPDATED "200210140000Z"
  20.     ORGANIZATION "IETF SNMPv3 Working Group"
  21.     CONTACT-INFO
  22.         "WG-email:   snmpv3@lists.tislabs.com
  23.          Subscribe:  majordomo@lists.tislabs.com
  24.                      In message body:  subscribe snmpv3
  25.          Co-Chair:   Russ Mundy
  26.                      Network Associates Laboratories
  27.          Postal:     15204 Omega Drive, Suite 300
  28.                      Rockville, MD 20850-4601
  29.                      USA
  30.          EMail:      mundy@tislabs.com
  31.          Phone:      +1 301-947-7107
  32.          Co-Chair:   David Harrington
  33.                      Enterasys Networks
  34.          Postal:     35 Industrial Way
  35.                      P. O. Box 5004
  36.                      Rochester, New Hampshire 03866-5005
  37.                      USA
  38.          EMail:      dbh@enterasys.com
  39.          Phone:      +1 603-337-2614
  40.          Co-editor:  David B. Levi
  41.                      Nortel Networks
  42.          Postal:     3505 Kesterwood Drive
  43.                      Knoxville, Tennessee 37918
  44.          EMail:      dlevi@nortelnetworks.com
  45.          Phone:      +1 865 686 0432
  46.          Co-editor:  Paul Meyer
  47.                      Secure Computing Corporation
  48.          Postal:     2675 Long Lake Road
  49.                      Roseville, Minnesota 55113
  50.          EMail:      paul_meyer@securecomputing.com
  51.          Phone:      +1 651 628 1592
  52.          Co-editor:  Bob Stewart
  53.                      Retired"
  54.     DESCRIPTION
  55.         "This MIB module defines MIB objects which provide
  56.          mechanisms to remotely configure the parameters
  57.          used by an SNMP entity for the generation of
  58.          notifications.
  59.          Copyright (C) The Internet Society (2002). This
  60.          version of this MIB module is part of RFC 3413;
  61.          see the RFC itself for full legal notices.
  62.         "
  63.     REVISION    "200210140000Z"             -- 14 October 2002
  64.     DESCRIPTION "Clarifications, published as
  65.                  RFC 3413."
  66.     REVISION    "199808040000Z"             -- 4 August 1998
  67.     DESCRIPTION "Clarifications, published as
  68.                  RFC 2573."
  69.     REVISION    "199707140000Z"             -- 14 July 1997
  70.     DESCRIPTION "The initial revision, published as RFC2273."
  71.     ::= { snmpModules 13 }
  72. snmpNotifyObjects       OBJECT IDENTIFIER ::=
  73.                                           { snmpNotificationMIB 1 }
  74. snmpNotifyConformance   OBJECT IDENTIFIER ::=
  75.                                           { snmpNotificationMIB 3 }
  76. --
  77. --
  78. -- The snmpNotifyObjects group
  79. --
  80. --
  81. snmpNotifyTable OBJECT-TYPE
  82.     SYNTAX      SEQUENCE OF SnmpNotifyEntry
  83.     MAX-ACCESS  not-accessible
  84.     STATUS      current
  85.     DESCRIPTION
  86.         "This table is used to select management targets which should
  87.          receive notifications, as well as the type of notification
  88.          which should be sent to each selected management target."
  89.     ::= { snmpNotifyObjects 1 }
  90. snmpNotifyEntry OBJECT-TYPE
  91.     SYNTAX      SnmpNotifyEntry
  92.     MAX-ACCESS  not-accessible
  93.     STATUS      current
  94.     DESCRIPTION
  95.         "An entry in this table selects a set of management targets
  96.          which should receive notifications, as well as the type of
  97.          notification which should be sent to each selected
  98.          management target.
  99.          Entries in the snmpNotifyTable are created and
  100.          deleted using the snmpNotifyRowStatus object."
  101.     INDEX { IMPLIED snmpNotifyName }
  102.     ::= { snmpNotifyTable 1 }
  103. SnmpNotifyEntry ::= SEQUENCE {
  104.     snmpNotifyName         SnmpAdminString,
  105.     snmpNotifyTag          SnmpTagValue,
  106.     snmpNotifyType         INTEGER,
  107.     snmpNotifyStorageType  StorageType,
  108.     snmpNotifyRowStatus    RowStatus
  109. }
  110. snmpNotifyName OBJECT-TYPE
  111.     SYNTAX      SnmpAdminString (SIZE(1..32))
  112.     MAX-ACCESS  not-accessible
  113.     STATUS      current
  114.     DESCRIPTION
  115.         "The locally arbitrary, but unique identifier associated
  116.          with this snmpNotifyEntry."
  117.     ::= { snmpNotifyEntry 1 }
  118. snmpNotifyTag OBJECT-TYPE
  119.     SYNTAX      SnmpTagValue
  120.     MAX-ACCESS  read-create
  121.     STATUS      current
  122.     DESCRIPTION
  123.         "This object contains a single tag value which is used
  124.          to select entries in the snmpTargetAddrTable.  Any entry
  125.          in the snmpTargetAddrTable which contains a tag value
  126.          which is equal to the value of an instance of this
  127.          object is selected.  If this object contains a value
  128.          of zero length, no entries are selected."
  129.     DEFVAL { "" }
  130.     ::= { snmpNotifyEntry 2 }
  131. snmpNotifyType OBJECT-TYPE
  132.     SYNTAX      INTEGER {
  133.                     trap(1),
  134.                     inform(2)
  135.                 }
  136.     MAX-ACCESS  read-create
  137.     STATUS      current
  138.     DESCRIPTION
  139.         "This object determines the type of notification to
  140.          be generated for entries in the snmpTargetAddrTable
  141.          selected by the corresponding instance of
  142.          snmpNotifyTag.  This value is only used when
  143.          generating notifications, and is ignored when
  144.          using the snmpTargetAddrTable for other purposes.
  145.          If the value of this object is trap(1), then any
  146.          messages generated for selected rows will contain
  147.          Unconfirmed-Class PDUs.
  148.          If the value of this object is inform(2), then any
  149.          messages generated for selected rows will contain
  150.          Confirmed-Class PDUs.
  151.          Note that if an SNMP entity only supports
  152.          generation of Unconfirmed-Class PDUs (and not
  153.          Confirmed-Class PDUs), then this object may be
  154.          read-only."
  155.     DEFVAL { trap }
  156.     ::= { snmpNotifyEntry 3 }
  157. snmpNotifyStorageType OBJECT-TYPE
  158.     SYNTAX      StorageType
  159.     MAX-ACCESS  read-create
  160.     STATUS      current
  161.     DESCRIPTION
  162.         "The storage type for this conceptual row.
  163.          Conceptual rows having the value 'permanent' need not
  164.          allow write-access to any columnar objects in the row."
  165.     DEFVAL { nonVolatile }
  166.     ::= { snmpNotifyEntry 4 }
  167. snmpNotifyRowStatus OBJECT-TYPE
  168.     SYNTAX      RowStatus
  169.     MAX-ACCESS  read-create
  170.     STATUS      current
  171.     DESCRIPTION
  172.         "The status of this conceptual row.
  173.          To create a row in this table, a manager must
  174.          set this object to either createAndGo(4) or
  175.          createAndWait(5)."
  176.     ::= { snmpNotifyEntry 5 }
  177. snmpNotifyFilterProfileTable OBJECT-TYPE
  178.     SYNTAX      SEQUENCE OF SnmpNotifyFilterProfileEntry
  179.     MAX-ACCESS  not-accessible
  180.     STATUS      current
  181.     DESCRIPTION
  182.         "This table is used to associate a notification filter
  183.          profile with a particular set of target parameters."
  184.     ::= { snmpNotifyObjects 2 }
  185. snmpNotifyFilterProfileEntry OBJECT-TYPE
  186.     SYNTAX      SnmpNotifyFilterProfileEntry
  187.     MAX-ACCESS  not-accessible
  188.     STATUS      current
  189.     DESCRIPTION
  190.         "An entry in this table indicates the name of the filter
  191.          profile to be used when generating notifications using
  192.          the corresponding entry in the snmpTargetParamsTable.
  193.          Entries in the snmpNotifyFilterProfileTable are created
  194.          and deleted using the snmpNotifyFilterProfileRowStatus
  195.          object."
  196.     INDEX { IMPLIED snmpTargetParamsName }
  197.     ::= { snmpNotifyFilterProfileTable 1 }
  198. SnmpNotifyFilterProfileEntry ::= SEQUENCE {
  199.     snmpNotifyFilterProfileName         SnmpAdminString,
  200.     snmpNotifyFilterProfileStorType     StorageType,
  201.     snmpNotifyFilterProfileRowStatus    RowStatus
  202. }
  203. snmpNotifyFilterProfileName OBJECT-TYPE
  204.     SYNTAX      SnmpAdminString (SIZE(1..32))
  205.     MAX-ACCESS  read-create
  206.     STATUS      current
  207.     DESCRIPTION
  208.         "The name of the filter profile to be used when generating
  209.          notifications using the corresponding entry in the
  210.          snmpTargetAddrTable."
  211.     ::= { snmpNotifyFilterProfileEntry 1 }
  212. snmpNotifyFilterProfileStorType OBJECT-TYPE
  213.     SYNTAX      StorageType
  214.     MAX-ACCESS  read-create
  215.     STATUS      current
  216.     DESCRIPTION
  217.         "The storage type for this conceptual row.
  218.          Conceptual rows having the value 'permanent' need not
  219.          allow write-access to any columnar objects in the row."
  220.     DEFVAL { nonVolatile }
  221.     ::= { snmpNotifyFilterProfileEntry 2 }
  222. snmpNotifyFilterProfileRowStatus OBJECT-TYPE
  223.     SYNTAX      RowStatus
  224.     MAX-ACCESS  read-create
  225.     STATUS      current
  226.     DESCRIPTION
  227.         "The status of this conceptual row.
  228.          To create a row in this table, a manager must
  229.          set this object to either createAndGo(4) or
  230.          createAndWait(5).
  231.          Until instances of all corresponding columns are
  232.          appropriately configured, the value of the
  233.          corresponding instance of the
  234.          snmpNotifyFilterProfileRowStatus column is 'notReady'.
  235.          In particular, a newly created row cannot be made
  236.          active until the corresponding instance of
  237.          snmpNotifyFilterProfileName has been set."
  238.     ::= { snmpNotifyFilterProfileEntry 3 }
  239. snmpNotifyFilterTable OBJECT-TYPE
  240.     SYNTAX      SEQUENCE OF SnmpNotifyFilterEntry
  241.     MAX-ACCESS  not-accessible
  242.     STATUS      current
  243.     DESCRIPTION
  244.         "The table of filter profiles.  Filter profiles are used
  245.          to determine whether particular management targets should
  246.          receive particular notifications.
  247.          When a notification is generated, it must be compared
  248.          with the filters associated with each management target
  249.          which is configured to receive notifications, in order to
  250.          determine whether it may be sent to each such management
  251.          target.
  252.          A more complete discussion of notification filtering
  253.          can be found in section 6. of [SNMP-APPL]."
  254.     ::= { snmpNotifyObjects 3 }
  255. snmpNotifyFilterEntry OBJECT-TYPE
  256.     SYNTAX      SnmpNotifyFilterEntry
  257.     MAX-ACCESS  not-accessible
  258.     STATUS      current
  259.     DESCRIPTION
  260.         "An element of a filter profile.
  261.          Entries in the snmpNotifyFilterTable are created and
  262.          deleted using the snmpNotifyFilterRowStatus object."
  263.     INDEX {         snmpNotifyFilterProfileName,
  264.             IMPLIED snmpNotifyFilterSubtree }
  265.     ::= { snmpNotifyFilterTable 1 }
  266. SnmpNotifyFilterEntry ::= SEQUENCE {
  267.     snmpNotifyFilterSubtree           OBJECT IDENTIFIER,
  268.     snmpNotifyFilterMask              OCTET STRING,
  269.     snmpNotifyFilterType              INTEGER,
  270.     snmpNotifyFilterStorageType       StorageType,
  271.     snmpNotifyFilterRowStatus         RowStatus
  272. }
  273. snmpNotifyFilterSubtree OBJECT-TYPE
  274.     SYNTAX      OBJECT IDENTIFIER
  275.     MAX-ACCESS  not-accessible
  276.     STATUS      current
  277.     DESCRIPTION
  278.         "The MIB subtree which, when combined with the corresponding
  279.          instance of snmpNotifyFilterMask, defines a family of
  280.          subtrees which are included in or excluded from the
  281.          filter profile."
  282.     ::= { snmpNotifyFilterEntry 1 }
  283. snmpNotifyFilterMask OBJECT-TYPE
  284.     SYNTAX      OCTET STRING (SIZE(0..16))
  285.     MAX-ACCESS  read-create
  286.     STATUS      current
  287.     DESCRIPTION
  288.         "The bit mask which, in combination with the corresponding
  289.          instance of snmpNotifyFilterSubtree, defines a family of
  290.          subtrees which are included in or excluded from the
  291.          filter profile.
  292.          Each bit of this bit mask corresponds to a
  293.          sub-identifier of snmpNotifyFilterSubtree, with the
  294.          most significant bit of the i-th octet of this octet
  295.          string value (extended if necessary, see below)
  296.          corresponding to the (8*i - 7)-th sub-identifier, and
  297.          the least significant bit of the i-th octet of this
  298.          octet string corresponding to the (8*i)-th
  299.          sub-identifier, where i is in the range 1 through 16.
  300.          Each bit of this bit mask specifies whether or not
  301.          the corresponding sub-identifiers must match when
  302.          determining if an OBJECT IDENTIFIER matches this
  303.          family of filter subtrees; a '1' indicates that an
  304.          exact match must occur; a '0' indicates 'wild card',
  305.          i.e., any sub-identifier value matches.
  306.          Thus, the OBJECT IDENTIFIER X of an object instance
  307.          is contained in a family of filter subtrees if, for
  308.          each sub-identifier of the value of
  309.          snmpNotifyFilterSubtree, either:
  310.            the i-th bit of snmpNotifyFilterMask is 0, or
  311.            the i-th sub-identifier of X is equal to the i-th
  312.            sub-identifier of the value of
  313.            snmpNotifyFilterSubtree.
  314.          If the value of this bit mask is M bits long and
  315.          there are more than M sub-identifiers in the
  316.          corresponding instance of snmpNotifyFilterSubtree,
  317.          then the bit mask is extended with 1's to be the
  318.          required length.
  319.          Note that when the value of this object is the
  320.          zero-length string, this extension rule results in
  321.          a mask of all-1's being used (i.e., no 'wild card'),
  322.          and the family of filter subtrees is the one
  323.          subtree uniquely identified by the corresponding
  324.          instance of snmpNotifyFilterSubtree."
  325.     DEFVAL { ''H }
  326.     ::= { snmpNotifyFilterEntry 2 }
  327. snmpNotifyFilterType OBJECT-TYPE
  328.     SYNTAX      INTEGER {
  329.                     included(1),
  330.                     excluded(2)
  331.                 }
  332.     MAX-ACCESS  read-create
  333.     STATUS      current
  334.     DESCRIPTION
  335.         "This object indicates whether the family of filter subtrees
  336.          defined by this entry are included in or excluded from a
  337.          filter.  A more detailed discussion of the use of this
  338.          object can be found in section 6. of [SNMP-APPL]."
  339.     DEFVAL { included }
  340.     ::= { snmpNotifyFilterEntry 3 }
  341. snmpNotifyFilterStorageType OBJECT-TYPE
  342.     SYNTAX      StorageType
  343.     MAX-ACCESS  read-create
  344.     STATUS      current
  345.     DESCRIPTION
  346.         "The storage type for this conceptual row.
  347.          Conceptual rows having the value 'permanent' need not
  348.          allow write-access to any columnar objects in the row."
  349.     DEFVAL { nonVolatile }
  350.     ::= { snmpNotifyFilterEntry 4 }
  351. snmpNotifyFilterRowStatus OBJECT-TYPE
  352.     SYNTAX      RowStatus
  353.     MAX-ACCESS  read-create
  354.     STATUS      current
  355.     DESCRIPTION
  356.         "The status of this conceptual row.
  357.          To create a row in this table, a manager must
  358.          set this object to either createAndGo(4) or
  359.          createAndWait(5)."
  360.     ::= { snmpNotifyFilterEntry 5 }
  361. --
  362. --
  363. -- Conformance information
  364. --
  365. --
  366. snmpNotifyCompliances OBJECT IDENTIFIER ::=
  367.                                         { snmpNotifyConformance 1 }
  368. snmpNotifyGroups      OBJECT IDENTIFIER ::=
  369.                                         { snmpNotifyConformance 2 }
  370. --
  371. --
  372. -- Compliance statements
  373. --
  374. --
  375. snmpNotifyBasicCompliance MODULE-COMPLIANCE
  376.     STATUS      current
  377.     DESCRIPTION
  378.         "The compliance statement for minimal SNMP entities which
  379.          implement only SNMP Unconfirmed-Class notifications and
  380.          read-create operations on only the snmpTargetAddrTable."
  381.     MODULE SNMP-TARGET-MIB
  382.         MANDATORY-GROUPS { snmpTargetBasicGroup }
  383.         OBJECT snmpTargetParamsMPModel
  384.         MIN-ACCESS    read-only
  385.         DESCRIPTION
  386.             "Create/delete/modify access is not required."
  387.         OBJECT snmpTargetParamsSecurityModel
  388.         MIN-ACCESS    read-only
  389.         DESCRIPTION
  390.             "Create/delete/modify access is not required."
  391.         OBJECT snmpTargetParamsSecurityName
  392.         MIN-ACCESS    read-only
  393.         DESCRIPTION
  394.             "Create/delete/modify access is not required."
  395.         OBJECT snmpTargetParamsSecurityLevel
  396.         MIN-ACCESS    read-only
  397.         DESCRIPTION
  398.             "Create/delete/modify access is not required."
  399.         OBJECT snmpTargetParamsStorageType
  400.         SYNTAX INTEGER {
  401.             readOnly(5)
  402.         }
  403.         MIN-ACCESS    read-only
  404.         DESCRIPTION
  405.             "Create/delete/modify access is not required.
  406.              Support of the values other(1), volatile(2),
  407.              nonVolatile(3), and permanent(4) is not required."
  408.         OBJECT snmpTargetParamsRowStatus
  409.         SYNTAX INTEGER {
  410.             active(1)
  411.         }
  412.         MIN-ACCESS    read-only
  413.         DESCRIPTION
  414.             "Create/delete/modify access to the
  415.              snmpTargetParamsTable is not required.
  416.              Support of the values notInService(2), notReady(3),
  417.              createAndGo(4), createAndWait(5), and destroy(6) is
  418.              not required."
  419.     MODULE -- This Module
  420.         MANDATORY-GROUPS { snmpNotifyGroup }
  421.         OBJECT snmpNotifyTag
  422.         MIN-ACCESS    read-only
  423.         DESCRIPTION
  424.             "Create/delete/modify access is not required."
  425.         OBJECT snmpNotifyType
  426.         SYNTAX INTEGER {
  427.             trap(1)
  428.         }
  429.         MIN-ACCESS    read-only
  430.         DESCRIPTION
  431.             "Create/delete/modify access is not required.
  432.              Support of the value notify(2) is not required."
  433.         OBJECT snmpNotifyStorageType
  434.         SYNTAX INTEGER {
  435.             readOnly(5)
  436.         }
  437.         MIN-ACCESS    read-only
  438.         DESCRIPTION
  439.             "Create/delete/modify access is not required.
  440.              Support of the values other(1), volatile(2),
  441.              nonVolatile(3), and permanent(4) is not required."
  442.         OBJECT snmpNotifyRowStatus
  443.         SYNTAX INTEGER {
  444.             active(1)
  445.         }
  446.         MIN-ACCESS    read-only
  447.         DESCRIPTION
  448.             "Create/delete/modify access to the
  449.              snmpNotifyTable is not required.
  450.              Support of the values notInService(2), notReady(3),
  451.              createAndGo(4), createAndWait(5), and destroy(6) is
  452.              not required."
  453.     ::= { snmpNotifyCompliances 1 }
  454. snmpNotifyBasicFiltersCompliance MODULE-COMPLIANCE
  455.     STATUS      current
  456.     DESCRIPTION
  457.         "The compliance statement for SNMP entities which implement
  458.          SNMP Unconfirmed-Class notifications with filtering, and
  459.          read-create operations on all related tables."
  460.     MODULE SNMP-TARGET-MIB
  461.         MANDATORY-GROUPS { snmpTargetBasicGroup }
  462.     MODULE -- This Module
  463.         MANDATORY-GROUPS { snmpNotifyGroup,
  464.                            snmpNotifyFilterGroup }
  465.     ::= { snmpNotifyCompliances 2 }
  466. snmpNotifyFullCompliance MODULE-COMPLIANCE
  467.     STATUS      current
  468.     DESCRIPTION
  469.         "The compliance statement for SNMP entities which either
  470.          implement only SNMP Confirmed-Class notifications, or both
  471.          SNMP Unconfirmed-Class and Confirmed-Class notifications,
  472.          plus filtering and read-create operations on all related
  473.          tables."
  474.     MODULE SNMP-TARGET-MIB
  475.         MANDATORY-GROUPS { snmpTargetBasicGroup,
  476.                            snmpTargetResponseGroup }
  477.     MODULE -- This Module
  478.         MANDATORY-GROUPS { snmpNotifyGroup,
  479.                            snmpNotifyFilterGroup }
  480.     ::= { snmpNotifyCompliances 3 }
  481. snmpNotifyGroup OBJECT-GROUP
  482.     OBJECTS {
  483.         snmpNotifyTag,
  484.         snmpNotifyType,
  485.         snmpNotifyStorageType,
  486.         snmpNotifyRowStatus
  487.     }
  488.     STATUS      current
  489.     DESCRIPTION
  490.         "A collection of objects for selecting which management
  491.          targets are used for generating notifications, and the
  492.          type of notification to be generated for each selected
  493.          management target."
  494.     ::= { snmpNotifyGroups 1 }
  495. snmpNotifyFilterGroup OBJECT-GROUP
  496.     OBJECTS {
  497.         snmpNotifyFilterProfileName,
  498.         snmpNotifyFilterProfileStorType,
  499.         snmpNotifyFilterProfileRowStatus,
  500.         snmpNotifyFilterMask,
  501.         snmpNotifyFilterType,
  502.         snmpNotifyFilterStorageType,
  503.         snmpNotifyFilterRowStatus
  504.     }
  505.     STATUS      current
  506.     DESCRIPTION
  507.         "A collection of objects providing remote configuration
  508.          of notification filters."
  509.     ::= { snmpNotifyGroups 2 }
  510. END