rfc2669.txt

很多RFC的中文文档

        SYNTAX      DateAndTime
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "日期和时间，加上可选的时区信息"
        ::= { docsDevBase 2 }

docsDevResetNow OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "设为真true(1)使本设备重新启动
             读取本对象的值将一致返回假false(2)."
        ::= { docsDevBase 3 }

docsDevSerialNumber OBJECT-TYPE
        SYNTAX      SnmpAdminString
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "生产厂商为该设备所指定的串号"
        ::= { docsDevBase 4 }

docsDevSTPControl OBJECT-TYPE
        SYNTAX INTEGER {
            stEnabled(1),
            noStFilterBpdu(2),
            noStPassBpdu(3)
        }
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
"   本对象控制对STP（802.1d生成树协议）协议包的处理。
若被设为stEnabled(1)，该设备支持STP并处理STP包。
若被设为noStFilterBpdu(2), 该设备不支持STP协议并且
将接收到的BPDU包丢弃。
若被设为noStPassBpdu(3) ，该设备不支持STP协议但会
将接收到的BPDU包透明传输。
注意：该设备不必支持所有的选项，但必须支持noStFilte
-rBpdu(2)项"
        ::= { docsDevBase 5 }

--
-- 下面的表提供了对网络管理站点进行网络管理访问
-- 提供了一种控制方法。注意这种访问受到community
-- 字符串和任何的厂家指定安全层所控制
-- 
--

docsDevNmAccessTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF DocsDevNmAccessEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
"本表控制网管站点访问SNMP对象的访问权限。
若本表为空表则没有任何限制并且本表只有SNMP
版本v1和v2c存在，在SNMP版本v3中不存在。
                在SNMP版本v3中对应的MIB对象和安全模块
已经覆盖了本表的内容。"
        ::= { docsDevMIBObjects 2 }

docsDevNmAccessEntry OBJECT-TYPE
        SYNTAX      DocsDevNmAccessEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
"   网管站点访问SNMP代理的入口索引值. 若网管站点有该
SMMP代理的读写访问权限该入口索引值可被网管站点所更
改(或缺省的读写权限或者在本表中有指定的读写权限)
	每个入口索引按docsDevNmAccessIndex排序。第一个匹配
（例如匹配IP地址和community字符串）入口的访问权限被应
用于访问的网管站点。"
        INDEX { docsDevNmAccessIndex  }
        ::= {  docsDevNmAccessTable 1 }

DocsDevNmAccessEntry ::= SEQUENCE {
            docsDevNmAccessIndex         Integer32,
            docsDevNmAccessIp            IpAddress,
            docsDevNmAccessIpMask        IpAddress,
            docsDevNmAccessCommunity     OCTET STRING,
            docsDevNmAccessControl       INTEGER,
            docsDevNmAccessInterfaces    OCTET STRING,
            docsDevNmAccessStatus        RowStatus
        }

docsDevNmAccessIndex OBJECT-TYPE
        SYNTAX      Integer32 (1..2147483647)
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
"对访问权限控制排序的索引值"
        ::= { docsDevNmAccessEntry 1 }

docsDevNmAccessIp OBJECT-TYPE
        SYNTAX      IpAddress
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
"网络管理站点的IP地址。地址255.255.255.255被定义
为任何网络管理站点。若支持陷阱(Traps)则该值必须被
指定为该设备的IP地址"
        DEFVAL { 'ffffffff'h }
        ::= { docsDevNmAccessEntry 2 }

docsDevNmAccessIpMask OBJECT-TYPE
        SYNTAX      IpAddress
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "网络管理站点的子网掩码。若支持陷阱（Traps）.
             该值必须被设为255.255.255.255."
        DEFVAL { 'ffffffff'h }
        ::= { docsDevNmAccessEntry 3 }

docsDevNmAccessCommunity OBJECT-TYPE
        SYNTAX      OCTET STRING
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
"本访问入口所必需匹配的community 字符串。若被设为0，则任何的
community字符串都匹配。当被读访问时本对象应该返回0长度的字符
串"
        DEFVAL { "public" }
        ::= { docsDevNmAccessEntry 4 }

docsDevNmAccessControl OBJECT-TYPE
        SYNTAX         INTEGER {
            none(1),
            read(2),
            readWrite(3),
            roWithTraps(4),
            rwWithTraps(5),
            trapsOnly(6)
        }
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
"指定网络管理站点的访问权限。设为none(1)表示本入口已经被废弃，
 	         Read(2) 允许'get' 和 'get-next'访问
ReadWrite(3)允许再加上'set'访问
RoWithtraps(4), rwWithTraps(5), 和trapsOnly(6)用来控制由本设备发送的
Traps的发送控制。"
        DEFVAL { read }
        ::= { docsDevNmAccessEntry 5 }

-- 下面对象的语法是从RFC1493复制过来的
-- dot1dStaticAllowedToGoTo.

docsDevNmAccessInterfaces OBJECT-TYPE
        SYNTAX      OCTET STRING
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
"指定接受网络访问站点访问包的接口。
该对象值的每一个字节表示8个接口并且第1个字节
表示1-8接口第2个字节表示9-16接口以此类推。
  在每个字节中的最高有效位表示索引较低的接口值，最
地有效位表示索引较高的接口值，因此每个接口都可以被
本对象值的单独一个bit位所表示。该bit位设为1，则该
接口就被包括其中。
注意：该接口索引值仅对链路层有效（例如Ethernet和RF MAC
层）上行Upstream和下行downstream通道接口索引值不能
够在该表中被指定。"
--         DEFVAL is the bitmask corresponding to all interfaces
        ::= { docsDevNmAccessEntry 6 }

docsDevNmAccessStatus OBJECT-TYPE
        SYNTAX      RowStatus
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
"控制当前行的当前状态。表中的每一行可以由reate-and-go或者
create-and-wait 创建。当某一行在激活状态时本对象的值可以更改。"
        ::= { docsDevNmAccessEntry 7 }

--
--  下列组的使用过程在DOCSIS射频标准 DOCSIS Radio Frequence Interface Specification
--  的3.2.1有描述

docsDevSoftware OBJECT IDENTIFIER ::= { docsDevMIBObjects 3 }

docsDevSwServer OBJECT-TYPE
        SYNTAX      IpAddress
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "软件升级TFTP服务器IP地址，若未知，返回0.0.0.0."
        ::= { docsDevSoftware 1 }

docsDevSwFilename OBJECT-TYPE
        SYNTAX      SnmpAdminString (SIZE (0..64))
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
"被下载道被设备的软件影像文件的文件名。该项应返回CM配置文件
服务器提供的新版本软件的升级文件名除非通过网络管理进行更改。
若未知，返回'unknown' "
        ::= { docsDevSoftware 2 }

docsDevSwAdminStatus OBJECT-TYPE
        SYNTAX INTEGER {
            upgradeFromMgt(1),
            allowProvisioningUpgrade(2),
            ignoreProvisioningUpgrade(3)
        }
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
"若被设为upgradeFromMgt(1), 该设备将从软件升级TFTP服务器下载
在docsDevSwFilename.中指定的升级文件。在成功的接收到升级文件进行升
级后该设备将本对象值设为ignoreProvisioningUpgrade(3)然后重新启动。
若下载过程由于重启或电源工作失败所中止，设备将加载上一个软件影像
经过重新初始化会继续尝试下载在docsDevSwFilename指定的软件升级文件
影像。
	若被设为allowProvisioningUpgrade(2), 该设备将会根据配置服务器所提
供的升级文件信息在设备下一次启动时进行升级 (这并不会导致设备重启)。
			    若被设为ignoreProvisioningUpgrade(3), 设备将会忽略来自配置服务器所
提供的软件升级信息。
	             注意读本对象的值时可能返回upgradeFromMgt(1)，这意味着此时正在进
行软件升级而且在成功的下载完升级文件后设备会重新启动。一般情况下设备
在初始化启动结束后本对象会返回缺省值allowProvisioningUpgrade(2)."
        ::= { docsDevSoftware 3 }

docsDevSwOperStatus OBJECT-TYPE
        SYNTAX INTEGER {
            inProgress(1),
            completeFromProvisioning(2),
            completeFromMgt(3),
            failed(4),
            other(5)
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
"InProgress(1) I表明TFTP下载正在进行当中，这可能由于
配置文件中的版本信息或软件升级请求消息所导致（upgrad
eFromMgt request.）。
CompleteFromProvisioning(2)表明上一次软件升级时在配置
信息中所指定的版本信息。
CompleteFromMgt(3)表明上一次软件升级是设置docsDevS
WAdminStatus的状态为upgradeFromMgt所进行的升级。
Failed(4) 表明上一次的升级尝试失败，一般是由于TFTP等
待时间超出所导致。"
        REFERENCE
"DOCSIS射频接口规范DOCSIS Radio Frequency Interface
 Specification，8.2部分Cable Modem软件升级下载操作"
        ::= { docsDevSoftware 4 }

docsDevSwCurrentVers OBJECT-TYPE
    SYNTAX      SnmpAdminString
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
"指示本设备当前运行的软件版本，本对象的值的语法控制由
生产厂商控制如何标识软件版本。访问它时对于任何CM来讲
必须返回当前所使用的软件版本描述信息字符串，对于CMTS
来讲本对象应该包含厂家指定信息的人性化描述信息或者操作
处理器的软件信息，若这些都不是则返回值必须是空字符串。"
    ::= { docsDevSoftware 5 }

--
-- 下面的组描述了在设备初始化启动时所使用的和各种服务器相关的信息
--

docsDevServer OBJECT IDENTIFIER ::= { docsDevMIBObjects 4 }

docsDevServerBootState OBJECT-TYPE
        SYNTAX INTEGER {
            operational(1),
            disabled(2),
            waitingForDhcpOffer(3),
            waitingForDhcpResponse(4),
            waitingForTimeServer(5),
            waitingForTftp(6),
            refusedByCmts(7),
            forwardingDenied(8),
            other(9),
            unknown(10)
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
"若为operational(1),设备已经完成的配置参数的加载和处理并且
CMTS也已经完成了登记信息交换。
若为disabled(2) ，设备的启动时加载和处理配置参数被禁止或者载配置文件
中被指定网络访问被禁止。
若为waitingForDhcpOffer(3) 则DHCP广播请求信息Discover已经被发送但还
没有受到第一次响应信息offer
若为waitingForDhcpResponse(4) 则DHCP确认请求信息 Request 已经被发送
但还没有收到任何确认相应信息。
若为waitingForTimeServer(5) 则时间请求信息Time Request已经被发送但还
没有受到任何响应信息。
若为waitingForTftp(6) 则参数请求已经向TFTP服务器发送但还没有受到任
何响应信息
若为refusedByCmts(7) 则登记请求/响应信息交换失败。
若为forwardingDenied(8) 则登记处理完成但在配置文件中的网络访问选项被
设为禁止网络访问。"
        REFERENCE
" DOCSIS射频接口规范DOCSIS Radio Frequency Interface Specification，7.1
部分Cable Modem初始化启动过程"
        ::= { docsDevServer 1 }

docsDevServerDhcp OBJECT-TYPE
        SYNTAX      IpAddress
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
"为本设备分配IP地址的DHCP服务器IP地址。若没有使用DHCP分配
IP地则应返回0.0.0.0"
        ::= { docsDevServer 2 }