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