rfc1904.txt

很多RFC的中文文档

那么它必须支持XYZv1Group组，如果没有生成遵循声明。
6 AGENT-CAPABILITIES宏映射
   AGENT-CAPABILITIES宏用来表达担任代理角色的某个SNMPv2实体的性能集合。应
该注意的是，从概念上讲，AGENT-CAPABILITIES宏扩展发生实现阶段而不是运行阶段。

当书写一个MIB模块时，把它分成几个一致性组单元。如果担任代理角色的SNMPv2
实体声明要操作一个组，那么它必须操作这个组中的所有对象。当然，无论什么原因，
SNMPv2实体都可以只操作MIB模块中的某些组的子集。此外，一些MIB对象的定义遗弃
了某些定义特征，这些特征用来判断操作者。

   实际经验证明，需要根据一个或多个MIB模块简洁的描述一个代理的性能。
AGENT-CAPABILITIES宏允许代理执行者描述其根据MIB组声明的所支持的准确级别，还
允许其把这种描述和sysORID[3]的一个实例值绑定。有其特殊的是，一些对象可能具有受
限制的或有争议的语法或访问级别。
  
   如果管理站的执行者受到了AGENT-CAPABILITIESA调用，那么该执行者能建立管理
应用程序，当与一个特殊的代理通信时，这些应用程序可以自我优化。例如，管理者可以维
护调用它们的数据库。当一个管理站与一个代理交互时，它从代理检索到sysORID[3]所有
实例的值。基于这一点，建议数据库定位每一条与sysORID检索值匹配的入口。使用定位
的入口，管理应用程序现在就可以相应的优化自己的行为。
 
   注意，AGENT-CAPABILITIES宏根据MIB模块中OBJECT-TYPE和
NOTIFICATION-TYPE宏做详细的说明或变化，而不是根据遵循声明中的
MODULE-COMPLIANCE宏。
6．1 PRODUCT-RELEASE子句映射
   PRODUCT-RELEASE子句包括产品发布的文本描述，该版本包括了这个性能集合。
PRODUCT-RELEASE子句是必须出现的。
6．2 STATUS子句映射
   STATUS子句说明了这个定义是当前状态("current")还是历史状态("obsolete")，该子句
是必须出现的。
6．3 DESCRIPTION子句映射
   DESCRIPTION子句包括了对这个性能集合的文本描述，是必须出现的。
6．4 REFERENCE子句映射
   REFERENCE子句包括了一个性能声明的文本交叉引用，该声明定义在其他的信息模块
中。该子句没有必要出现。
6．5 SUPPORTS子句映射
   SUPPORTS子句重复的用来命名每一个MIB模块，对这些模块，代理声明了全部或部分
操作。SUPPORTS子句没有必要出现。每一个MIB模块由其模块名命名，作为选择，还可
以带上它的OBJECT IDENTIFIER。
6．5．1 INCLUDES子句映射
   INCLUDES子句用来命名每一个与SUPPORTS子句关联的MIB组，代理对此MIB组声
明了操作。当使用SUPPORTS子句时必须出现INCLUDES子句。
6．5．2 VARIATION子句
   VARIATION子句用来重复的命名代理在某些变动中或以更精确形式操作的对象或通知，
这些操作是根据OBJECT-TYPE或NOTIFICATION-TYPE宏的相应引用作出的。
VARIATION子句没有必要出现。
 
   注意，变动的概念是指对一般操作进行了限制，也就是说，如果一个对象的变动依赖于
其它对象的值，那么应该在合适的DESCRIPTION子句中进行标注。

   按照定义，在VARIATION子句中规定的每个对象都跟随着一个SUPPORTS子句，该子
句命名了定义这个对象的信息模块。因此，使用一个IMPORTS语句来说明从哪里引入的这
些对象在信息模块中是多余的、没有必要的。
6．5．2．1 SYNTAX子句映射
   SYNTAX子句为相应VARIATION子句中命名的对象提供了精确的SYNATX，该子句没
有必要出现。注意，如果同时出现了该子句和WRITE-SNYTAX子句，那么只有当读取相应
VARIATION子句中命名的对象实例时，才运用该子句。

   参考[2]的第9部分，获取精确语法的更多信息。
6．5．2．2 WRITE-SYTAX子句映射
   当写对象实例时，WRITE-SYNTAX子句为在相应VARIATION子句中命名的对象提供精
确语法。WRITE-SYNTAX子句没有必要出现。

参考[2]的第9部分，获取精确语法的更多信息。
6．5．2．3 ACCESS子句映射
   ACCESS子句说明了代理为相应VARIATION子句中命名的对象或通知提供了低于最大
访问级别的访问级别。该子句没有必要出现。

   唯一适用于通知的值为“not-implemented”。

   值“not-implemented”表明代理不操作这个对象或通知，在可能数值的排序中，等同于
“not-accessible”。

   值“write-only”单独提供了向后兼容的能力，不应该用来定义新的对象类型。在可能数
值的排序中，“write-only”小于“not-accessible”。
6．5．2．4 CREATION-REQUIRES子句映射
   CREATION-REQUIRES子句用来命名一个概念行的柱状对象，在代理允许行柱状对象
的实例被设置为'active'前，必须通过管理协议的设置操作，明确的为这些对象赋值。
CREATTION-REQUIRES子句没有必要出现。（参考RowStatus[5]的定义。）

   如果概念行没有一个状态栏（也就是说，使用[6，7]中的机制定义相应概念表中的对象），
那么没有必要出现的CREATION-REQUIRES子句用来命名概念行的柱状对象，在代理创
建行中对象的实例前，必须通过管理协议的设置操作，明确为这些柱状对象赋值。   

   除非在相应VARIATION子句中命名的对象是一个概念行（也就是说，该对象具有一个
解析成SQUENCE包含柱状对象的语法），否则，这个子句绝对不能出现。在这个子句中命
名的对象通常指向在概念行的柱状对象。然而，也可以说明与概念行无关的对象。

   在CREATION-REQUIRES子句中命名的概念行的所有对象以及概念行的的所有柱状对
象必须具有“read-create”的访问级别。
6．5．2．5 DEFVAL子句映射
   DEFVAL子句为相应VARIATION子句中命名的对象提供一个精确的DEFVAL值，该子
句没有必要出现。该子句的语义与OBJECT-TYPE宏的DEFVAL子句是一致的。
6．5．2．6 DESCRIPTION子句映射
   当使用VARIATION子句时，必须出现DESCRIPTION子句，它包括对对象或通知的变
动或精确实现的文本描述。
6．6 AGENT-CAPABLITIES值映射
   AGENT-CAPABILITES的宏调用值是一个OBJECT IDENTIFIER，它命名了对这个性能
声明有效的sysORID[3]的值。
6．7 用法举例
   考虑一下代理的性能声明是如何描述的：

exampleAgent AGENT-CAPABILITIES
    PRODUCT-RELEASE      "ACME Agent release 1.1 for 4BSD"
    STATUS               current
    DESCRIPTION          "ACME agent for 4BSD"

    SUPPORTS             SNMPv2-MIB
        INCLUDES         { systemGroup, snmpGroup, snmpSetGroup,
                           snmpBasicNotificationsGroup }

        VARIATION        coldStart
            DESCRIPTION  "A coldStart trap is generated on all
                         reboots."

    SUPPORTS             IF-MIB
        INCLUDES         { ifGeneralGroup, ifPacketGroup }

        VARIATION        ifAdminStatus
            SYNTAX       INTEGER { up(1), down(2) }
            DESCRIPTION  "Unable to set test mode on 4BSD"

        VARIATION        ifOperStatus
            SYNTAX       INTEGER { up(1), down(2) }
            DESCRIPTION  "Information limited on 4BSD"

    SUPPORTS             IP-MIB
        INCLUDES         { ipGroup, icmpGroup }

VARIATION        ipDefaultTTL
            SYNTAX       INTEGER (255..255)
            DESCRIPTION  "Hard-wired on 4BSD"

        VARIATION        ipInAddrErrors
            ACCESS       not-implemented
            DESCRIPTION  "Information not available on 4BSD"

        VARIATION        ipNetToMediaEntry 
            CREATION-REQUIRES { ipNetToMediaPhysAddress }
            DESCRIPTION  "Address mappings on 4BSD require
                         both protocol and media addresses"

    SUPPORTS             TCP-MIB
        INCLUDES         { tcpGroup }
        VARIATION        tcpConnState
            ACCESS       read-only
            DESCRIPTION  "Unable to set this on 4BSD"

    SUPPORTS             UDP-MIB
        INCLUDES         { udpGroup }

SUPPORTS             EVAL-MIB
INCLUDES         { functionsGroup, expressionsGroup }
        VARIATION        exprEntry
            CREATION-REQUIRES { evalString }
            DESCRIPTION "Conceptual row creation supported"

    ::= { acmeAgents 1 }

   根据这种调用，一个sysORID值为{ acmeAgents 1 }的代理支持六个MIB模块。

对于SNMPv2-MIB，支持五个一致性组。

对于IF-MIB，支持ifGeneralGroup和ifPacketGroup组。然而，对象ifAdminStatus
和ifOpenStatus的语法有限制。

对于TCP-MIB，支持tcpGroup，但是只能读tcpConnState。

对于UDP-MIB，支持所有的udpGroup。

对于EVAL-MIB，支持包括在functionsGroup和expressionsGroup一致性组中的所有对象，
没有任何变动。此外，支持在expr表中创建新的实例。
7 信息模块的扩展
   当从一种出版了的信息模块获得了经验时，就可能想修改该信息模块。
   
   [2]的第10部分定义了扩展信息模块的规则。这一章节的剩余部分定义了如何扩展一致
性组、遵循声明和性能声明。
7．1 一致性组
   如果对一个对象组的任何子句作了任何非编辑上的改变，那么，与该对象组相关的
OBJECT IDENTIFIER值以及其描述符也必须发生改变。
7．2 遵循定义
   如果对遵循定义的任何子句作了任何非编辑上的改变，那么，与该遵循定义相关的
OBJECT IDENTIFIER值以及其描述符也必须发生改变。
7．3 性能定义
   如果对性能定义的任何子句作了任何非编辑上的改变，那么，与该性能定义相关的
OBJECT IDENTIFIER值以及其描述符也必须发生改变。
8 安全考虑
   本备忘录没有讨论安全议题。
9 作者地址
   Keith McCloghrie
   Cisco Systems, Inc.
   170 West Tasman Drive
   San Jose, CA  95134-1706
   US

   Phone: [phone]
   EMail: [e-mail]

10 致谢
   本文档是四个主要成员卓越工作的成果：

   Jeffrey D. Case (SNMP Research, [e-mail])
   Keith McCloghrie (Cisco Systems, [e-mail])
   Marshall T. Rose (Dover Beach Consulting, [e-mail])
   Steven Waldbusser (International Network Services, [e-mail])

   此外，要感谢SNMPv2 Working Group的参与。尤其要感谢的是下面的参与者：

     Alexander I. Alten (Novell)
     Dave Arneson (Cabletron)
     Uri Blumenthal (IBM)
     Doug Book (Chipcom)
     Kim Curran (Bell-Northern Research)
     Jim Galvin (Trusted Information Systems)
     Maria Greene (Ascom Timeplex)
     Iain Hanson (Digital)
     Dave Harrington (Cabletron)
     Nguyen Hien (IBM)
     Jeff Johnson (Cisco Systems)
     Michael Kornegay (Object Quest)
     Deirdre Kostick (AT&T Bell Labs)
     David Levi (SNMP Research)
     Daniel Mahoney (Cabletron)
     Bob Natale (ACE*COMM)
     Brian O'Keefe (Hewlett Packard)
     Andrew Pearson (SNMP Research)
     Dave Perkins (Peer Networks)
     Randy Presuhn (Peer Networks)
     Aleksey Romanov (Quality Quorum)
     Shawn Routhier (Epilogue)
     Jon Saperia (BGS Systems)
     Bob Stewart (Cisco Systems, [e-mail]), chair
     Kaj Tesink (Bellcore)
     Glenn Waters (Bell-Northern Research)
     Bert Wijnen (IBM)

11 参考资料
[1]  Information processing systems - Open Systems Interconnection -
     Specification of Abstract Syntax Notation One (ASN.1),
     International Organization for Standardization.  International
     Standard 8824, (December, 1987).

[2]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
     S. Waldbusser, "Structure of Management Information for Version 2
     of the Simple Network Management Protocol (SNMPv2)", RFC 1902,
     January 1996.

[3]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
     S. Waldbusser, "Management Information Base for Version 2 of the
     Simple Network Management Protocol (SNMPv2)", RFC 1907,
     January 1996.

[4]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
     S. Waldbusser, "Protocol Operations for Version 2 of the Simple
     Network Management Protocol (SNMPv2)", RFC 1905, January 1996.

[5]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
     S. Waldbusser, "Textual Conventions for Version 2 of the Simple
     Network Management Protocol (SNMPv2)", RFC 1903, January 1996.

[6]  Rose, M., and K. McCloghrie, "Structure and Identification of
     Management Information for TCP/IP-based internets", STD 16, RFC
     1155, May 1990.

[7]  Rose, M., and K. McCloghrie, "Concise MIB Definitions", STD 16,
     RFC 1212, March 1991.
RFC1904 Conformance Statements for Version 2 of the Simple Network Management Prototol(SNMPv2)
简单网络管理协议版本2（SNMPv2）的一致性声明


1
RFC文档中文翻译计划