idnits 2.17.1 draft-ietf-ipcdn-docs-rfmibv2-02.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** Looks like you're using RFC 2026 boilerplate. This must be updated to follow RFC 3978/3979, as updated by RFC 4748. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- == No 'Intended status' indicated for this document; assuming Proposed Standard == The page length should not exceed 58 lines per page, but there was 1 longer page, the longest (page 1) being 59 lines Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** The document seems to lack an IANA Considerations section. (See Section 2.2 of https://www.ietf.org/id-info/checklist for how to handle the case when there are no actions for IANA.) ** The document seems to lack separate sections for Informative/Normative References. All references will be assumed normative when checking for downward references. ** There are 638 instances of too long lines in the document, the longest one being 19 characters in excess of 72. ** The abstract seems to contain references ([5], [6], [7]), which it shouldn't. Please replace those with straight textual mentions of the documents in question. == There are 4 instances of lines with non-RFC6890-compliant IPv4 addresses in the document. If these are example addresses, they should be changed. ** The document seems to lack a both a reference to RFC 2119 and the recommended RFC 2119 boilerplate, even if it appears to use RFC 2119 keywords. RFC 2119 keyword, line 144: '...ng translated MIB MUST be semantically...' RFC 2119 keyword, line 347: '... The ifStackTable [17] MUST be implemented to identify relationships among...' RFC 2119 keyword, line 1499: '...alues from 64..128 MUST be non-prime."...' RFC 2119 keyword, line 1692: '... MUST NOT be changed w...' RFC 2119 keyword, line 1706: '... MUST NOT be changed w...' (11 more instances...) Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the RFC 3978 Section 5.4 Copyright Line does not match the current year == Line 495 has weird spacing: '...astPkts inter...' == Line 554 has weird spacing: '...astPkts inte...' == Line 662 has weird spacing: '...astPkts upst...' == Line 762 has weird spacing: '...astPkts inter...' == Line 830 has weird spacing: '...astPkts inte...' == (2 more instances...) -- The document seems to lack a disclaimer for pre-RFC5378 work, but may have content which was first submitted before 10 November 2008. If you have contacted all the original authors and they are all willing to grant the BCP78 rights to the IETF Trust, then this is fine, and you can ignore this comment. If not, you may need to add the pre-RFC5378 disclaimer. (See the Legal Provisions document at https://trustee.ietf.org/license-info for more information.) -- The document date (February 2002) is 8104 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) == Unused Reference: '16' is defined on line 4100, but no explicit reference was found in the text == Unused Reference: '18' is defined on line 4107, but no explicit reference was found in the text == Unused Reference: '23' is defined on line 4126, but no explicit reference was found in the text == Unused Reference: '24' is defined on line 4130, but no explicit reference was found in the text == Unused Reference: '27' is defined on line 4141, but no explicit reference was found in the text ** Obsolete normative reference: RFC 2571 (ref. '1') (Obsoleted by RFC 3411) ** Downref: Normative reference to an Informational RFC: RFC 1215 (ref. '4') ** Downref: Normative reference to an Historic RFC: RFC 1157 (ref. '8') ** Downref: Normative reference to an Historic RFC: RFC 1901 (ref. '9') ** Obsolete normative reference: RFC 1906 (ref. '10') (Obsoleted by RFC 3417) ** Obsolete normative reference: RFC 2572 (ref. '11') (Obsoleted by RFC 3412) ** Obsolete normative reference: RFC 2574 (ref. '12') (Obsoleted by RFC 3414) ** Obsolete normative reference: RFC 1905 (ref. '13') (Obsoleted by RFC 3416) ** Obsolete normative reference: RFC 2573 (ref. '14') (Obsoleted by RFC 3413) ** Obsolete normative reference: RFC 2575 (ref. '15') (Obsoleted by RFC 3415) -- Possible downref: Non-RFC (?) normative reference: ref. '16' ** Obsolete normative reference: RFC 2669 (ref. '18') (Obsoleted by RFC 4639) -- Possible downref: Non-RFC (?) normative reference: ref. '19' -- Possible downref: Non-RFC (?) normative reference: ref. '20' ** Obsolete normative reference: RFC 2570 (ref. '21') (Obsoleted by RFC 3410) ** Obsolete normative reference: RFC 2670 (ref. '22') (Obsoleted by RFC 4546) -- Possible downref: Non-RFC (?) normative reference: ref. '23' -- Possible downref: Non-RFC (?) normative reference: ref. '24' -- Possible downref: Non-RFC (?) normative reference: ref. '25' -- Possible downref: Non-RFC (?) normative reference: ref. '26' ** Downref: Normative reference to an Informational RFC: RFC 3083 (ref. '27') -- Possible downref: Non-RFC (?) normative reference: ref. '28' Summary: 20 errors (**), 0 flaws (~~), 15 warnings (==), 10 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Internet Draft Aviv Goren/David Raftus 3 draft-ietf-ipcdn-docs-rfmibv2-02.txt Terayon/Imedia 4 Expires: August 2002 February 2002 5 Obsoletes: RFC2670 7 Radio Frequency (RF) Interface Management Information Base 8 for DOCSIS 2.0 compliant RF interfaces 10 Status of this Memo 12 This document is an Internet-Draft and is in full conformance with 13 all provisions of Section 10 of RFC2026. 15 Internet-Drafts are working documents of the Internet Engineering 16 Task Force (IETF), its areas, and its working groups. Note that 17 other groups may also distribute working documents as Internet- 18 Drafts. 20 Internet-Drafts are draft documents valid for a maximum of six months 21 and may be updated, replaced, or obsoleted by other documents at any 22 time. It is inappropriate to use Internet-Drafts as reference 23 material or to cite them other than as "work in progress." 25 The list of current Internet-Drafts can be accessed at 26 http://www.ietf.org/ietf/1id-abstracts.txt 28 The list of Internet-Draft Shadow Directories can be accessed at 29 http://www.ietf.org/shadow.html. 31 Copyright Notice 33 Copyright (C) The Internet Society (2002). All Rights Reserved. 35 Abstract 37 This memo is a draft revision of the standards track RFC-2670. 38 Please see "Section 9 Changes from RFC2670" for a description of modifications. 39 This document or its successor will obsolete RFC-2670 when accepted. 41 This memo defines a portion of the Management Information Base (MIB) 42 for use with network management protocols in the Internet community. 43 In particular, it defines a basic set of managed objects for SNMP- 44 based management of DOCSIS compliant Radio Frequency (RF) interfaces. 46 This memo specifies a MIB module in a manner that is compliant to the 47 SNMP SMIv2 [5][6][7]. The set of objects are consistent with the 48 SNMP framework and existing SNMP standards. 50 Table of Contents 52 1 The SNMP Management Framework ................................... 3 53 2 Glossary ........................................................ 4 54 2.1 CATV .......................................................... 4 55 2.2 Channel ....................................................... 4 56 2.3 CM ............................................................ 4 57 2.4 CMTS .......................................................... 4 58 2.5 Codeword ...................................................... 4 59 2.6 Data Packet ................................................... 4 60 2.7 dBmV .......................................................... 4 61 2.8 DOCSIS ........................................................ 5 62 2.9 Downstream .................................................... 5 63 2.10 Head-end ..................................................... 5 64 2.11 MAC Packet ................................................... 5 65 2.12 MCNS ......................................................... 5 66 2.13 Mini-slot .................................................... 5 67 2.14 QPSK ......................................................... 5 68 2.15 QAM .......................................................... 5 69 2.16 RF ........................................................... 5 70 2.17 Symbol-times ................................................. 5 71 2.18 Upstream ..................................................... 6 72 3 Overview ........................................................ 6 73 3.1 Structure of the MIB .......................................... 6 74 3.1.1 docsIfBaseObjects ........................................... 6 75 3.1.2 docsIfCmObjects ............................................. 7 76 3.1.3 docsIfCmtsObjects ........................................... 7 77 3.2 Relationship to the Interfaces MIB ............................ 7 78 3.2.1 Layering Model .............................................. 7 79 3.2.2 Virtual Circuits ............................................ 8 80 3.2.3 ifTestTable ................................................. 9 81 3.2.4 ifRcvAddressTable ........................................... 9 82 3.2.5 ifEntry ..................................................... 9 83 3.2.5.1 ifEntry for Downstream interfaces ......................... 9 84 3.2.5.1.1 ifEntry for Downstream interfaces in Cable Modem 85 Termination Systems .......................................... 9 86 3.2.5.1.2 ifEntry for Downstream interfaces in Cable Modems ...... 11 87 3.2.5.2 ifEntry for Upstream interfaces .......................... 12 88 3.2.5.2.1 ifEntry for Upstream interfaces in Cable Modem 89 Termination Systems ......................................... 13 90 3.2.5.2.2 ifEntry for Upstream interfaces in Cable Modems ........ 15 91 3.2.5.3 ifEntry for the MAC Layer ................................ 18 92 4 Definitions .................................................... 20 93 5 Acknowledgments ................................................ 79 94 6 Revision Descriptions ...........................................79 95 7 References ..................................................... 79 96 8 Security Considerations ........................................ 81 97 9 Changes from RFC2670 ........................................... 82 98 10 Conflict Resolution with docsIfExt MIB ........................ 83 99 11 Intellectual Property ..........................................84 100 12 Author's Address .............................................. 84 101 13 Full Copyright Statement ...................................... 85 103 1. The SNMP Management Framework 105 The SNMP Management Framework presently consists of five major 106 components: 108 o An overall architecture, described in RFC 2571 [1]. 110 o Mechanisms for describing and naming objects and events for the 111 purpose of management. The first version of this Structure of 112 Management Information (SMI) is called SMIv1 and described in STD 113 16, RFC 1155 [2], STD 16, RFC 1212 [3] and RFC 1215 [4]. The 114 second version, called SMIv2, is described in STD 58, RFC 2578 115 [5], STD 58, RFC 2579 [6] and STD 58, RFC 2580 [7]. 117 o Message protocols for transferring management information. The 118 first version of the SNMP message protocol is called SNMPv1 and 119 described in RFC 1157 [8]. A second version of the SNMP message 120 protocol, which is not an Internet standards track protocol, is 121 called SNMPv2c and described in RFC 1901 [9] and RFC 1906 [10]. 122 The third version of the message protocol is called SNMPv3 and 123 described in RFC 1906 [10], RFC 2572 [11] and RFC 2574 [12]. 125 o Protocol operations for accessing management information. The 126 first set of protocol operations and associated PDU formats is 127 described in STD 15, RFC 1157 [8]. A second set of protocol 128 operations and associated PDU formats is described in RFC 1905 129 [13]. 131 o A set of fundamental applications described in RFC 2573 [14] and 132 the view-based access control mechanism described in RFC 2575 133 [15]. 135 A more detailed introduction to the current SNMP Management Framework 136 can be found in RFC 2570 [21]. 138 Managed objects are accessed via a virtual information store, termed 139 the Management Information Base or MIB. Objects in the MIB are 140 defined using the mechanisms defined in the SMI. 142 This memo specifies a MIB module that is compliant to the SMIv2. A 143 MIB conforming to the SMIv1 can be produced through the appropriate 144 translations. The resulting translated MIB MUST be semantically 145 equivalent, except where objects or events are omitted because no 146 translation is possible (use of Counter64). Some machine readable 147 information in SMIv2 will be converted into textual descriptions in 148 SMIv1 during the translation process. However, this loss of machine 149 readable information is not considered to change the semantics of the 150 MIB. 152 2. Glossary 154 The terms in this document are derived either from normal cable 155 system usage, or from the documents associated with the Data Over 156 Cable Service Interface Specification process. 158 2.1. CATV 160 Originally "Community Antenna Television", now used to refer to any 161 cable or hybrid fiber and cable system used to deliver video signals 162 to a community. 164 2.2. Channel 166 A specific frequency allocation with an RF medium, specified by 167 channel width in Hertz (cycles per second) and by center frequency. 168 Within the US Cable Systems, upstream channels are generally 169 allocated from the 5-42MHz range while down stream channels are 170 generally allocated from the 50-750MHz range depending on the 171 capabilities of the given system. The typical broadcast channel 172 width in the US is 6MHz. Upstream channel widths for DOCSIS vary. 174 For European cable systems, upstream channels vary by country. The 175 upper edge of upstream channel allocations vary between 25 MHz to 65 176 MHz, and the lower edge of downstream channel allocations vary 177 between 47 MHz and 87.5 MHz. The typical broadcast channel width in 178 Europe is 8MHz. The actual parameters are of concern to systems 179 deploying EuroDOCSIS technology. 181 2.3. CM Cable Modem. 183 A CM acts as a "slave" station in a DOCSIS compliant cable data 184 system. 186 2.4. CMTS Cable Modem Termination System. 188 A generic term covering a cable bridge or cable router in a head-end. 189 A CMTS acts as the master station in a DOCSIS compliant cable data 190 system. It is the only station that transmits downstream, and it 191 controls the scheduling of upstream transmissions by its associated 192 CMs. 194 2.5. Codeword 196 See [25]. A characteristic of the Forward Error Correction scheme used 197 above the RF media layer. 199 2.6. Data Packet 200 The payload portion of the MAC Packet. 202 2.7. dBmV 204 Decibel relative to one milli-volt. A measure of RF power. 206 2.8. DOCSIS 208 "Data Over Cable Service Interface Specification". A term referring to the 209 ITU-T J.112 Annex B standard for cable modem systems [20]. 211 2.9. Downstream 213 The direction from the head-end towards the subscriber. 215 2.10. Head-end 217 The origination point in most cable systems of the subscriber video 218 signals. 220 2.11. MAC Packet 222 A DOCSIS PDU. 224 2.12. MCNS 226 "Multimedia Cable Network System". Generally replaced in usage by 227 DOCSIS. 229 2.13. Mini-slot 231 See [25]. In general, an interval of time which is allocated by the 232 CMTS to a given CM for that CM to transmit in an upstream direction. 234 2.14. QPSK Quadrature Phase Shift Keying. 236 A particular modulation scheme on an RF medium. See [19]. 238 2.15. QAM Quadrature Amplitude Modulation. 240 A particular modulation scheme on RF medium. Usually expressed 241 with a number indicating the size of the modulation constellation 242 (e.g. 16 QAM). See [19], or any other book on digital communications 243 over RF for a complete explanation of this. 245 2.16. RF 247 Radio Frequency. 249 2.17. Symbol-times 251 See [25]. A characteristic of the RF modulation scheme. 253 2.18. Upstream 255 The direction from the subscriber towards the head-end. 257 3. Overview 259 This MIB provides a set of objects required for the management of 260 MCNS/DOCSIS compliant Cable Modem (CM) and Cable Modem Termination 261 System (CMTS) RF interfaces. The specification is derived in part 262 from the parameters and protocols described in DOCSIS Radio Frequency 263 Interface Specification [25]. 265 3.1. Structure of the MIB 267 This MIB is structured as three groups: 269 o Management information pertinent to both Cable Modems (CM) and 270 Cable Modem Termination Systems (CMTS) (docsIfBaseObjects). 272 o Management information pertinent to Cable Modems only 273 (docsIfCmObjects). 275 o Management information pertinent to Cable Modem Termination 276 Systems only (docsIfCmtsObjects). 278 Tables within each of these groups group objects functionally - e.g. 279 Quality of Service, Channel characteristics, MAC layer management, 280 etc. Rows created automatically (e.g. by the device according to the 281 hardware configuration) may and generally will have a mixture of 282 configuration and status objects within them. Rows that are meant to 283 be created by the management station are generally restricted to 284 configuration (read-create) objects. 286 3.1.1. docsIfBaseObjects 288 docsIfDownstreamChannelTable - This table describes the active 289 downstream channels for a CMTS and the received downstream channel 290 for a CM. 292 docsIfUpstreamChannelTable - This table describes the active upstream 293 channels for a CMTS and the current upstream transmission channel 294 for a CM. 296 docsIfQosProfileTable - This table describes the valid Quality of 297 Service profiles for the cable data system. 299 docsIfSignalQualityTable - This table is used to monitor RF signal 300 quality characteristics of received signals. 302 docsIfDocsisBaseCapability - This object is used to indicate the highest level 303 of DOCSIS version a cable device can support. 305 3.1.2. docsIfCmObjects 307 docsIfCmMacTable - This table is used to monitor the DOCSIS MAC 308 interface and can be considered an extension to the ifEntry. 310 docsIfCmServiceTable - This table describes the upstream service 311 queues available at this CM. There is a comparable table at the 312 CMTS, docsIfCmtsServiceEntry, which describes the service queues from 313 the point of view of the CMTS. 315 3.1.3. docsIfCmtsObjects 317 docsIfCmtsStatusTable - This table provides a set of aggregated 318 counters which roll-up values and events that occur on the underlying 319 sub-interfaces. 321 docsIfCmtsCmStatusTable - This table is used to hold information 322 about known (i.e. ranging, registered, and/or previously online) 323 cable modems on the system serviced by this CMTS. 325 docsIfCmtsServiceEntry - This table provides access to the 326 information related to upstream service queues. 328 docsIfCmtsModulationTable - This table allows control over the 329 modulation profiles for RF channels associated with this CMTS. 331 docsIfCmtsMacToCmTable - This table allows fast access into the 332 docsIfCmtsCmTable via a MAC address (of the CM) interface. 334 3.2. Relationship to the Interfaces MIB 336 This section clarifies the relationship of this MIB to the Interfaces 337 MIB [17]. Several areas of correlation are addressed in the 338 following subsections. The implementer is referred to the Interfaces 339 MIB document in order to understand the general intent of these 340 areas. 342 3.2.1. Layering Model 344 An instance of ifEntry exists for each RF Downstream interface, for 345 each RF Upstream interface, for each Upstream logical Channel and for 346 each RF MAC layer. 347 The ifStackTable [17] MUST be implemented to identify relationships among 348 sub-interfaces. 350 The following example illustrates a CMTS MAC interface with one downstream 351 and two upstream interfaces. 353 | <== to network layer 354 +------------------ --+-------------------------------+ 355 | RF MAC | 356 +--+------------------+------------------------+------+ 357 | | | 358 +-------+-----+ +------+------+ +------+------+ 359 | Downstream1 | | Upstream1 | | Upstream2 | 360 | | | | | | 361 +-------------+ ++-----------++ ++-----------++ 362 | | | | 363 +----+----+ +----+----+ +----+----+ +----+----+ 364 | Ch-1 | | Ch-2 | | Ch-1 | | Ch-2 | 365 |(A/TDMA) | |(S-CDMA) | |(A/TDMA) | |(S-CDMA) | 366 +---------+ +---------+ +---------+ +---------+ 368 As can be seen from this example, the RF MAC interface is layered on 369 top of the downstream and upstream interfaces, and the RF Upstream interface 370 is layered on top of an Upstream Logical Channels. 372 In this example, the assignment of index values could be as follows: 374 ifIndex ifType Description 376 2 docsCableMaclayer(127) CATV MAC Layer 377 3 docsCableDownstream(128) CATV Downstream interface 378 4 docsCableUpstream(129) CATV Upstream interface 379 5 docsCableUpstream(129) CATV Upstream interface 380 6 docsCableUpstreamChannel(205) CATV Upstream Channel 381 7 docsCableUpstreamChannel(205) CATV Upstream Channel 382 8 docsCableUpstreamChannel(205) CATV Upstream Channel 383 9 docsCableUpstreamChannel(205) CATV Upstream Channel 385 The corresponding ifStack entries would then be: 387 | IfStackHigherLayer | ifStackLowerLayer | 388 | 0 | 2 | 389 | 2 | 3 | 390 | 2 | 4 | 391 | 2 | 5 | 392 | 4 | 6 | 393 | 4 | 7 | 394 | 5 | 8 | 395 | 5 | 9 | 396 | 3 | 0 | 397 | 6 | 0 | 398 | 7 | 0 | 399 | 8 | 0 | 400 | 9 | 0 | 402 The same interface model can also be used in Telephony or Telco 403 Return systems. A pure Telco Return system (Cable Modem as well as 404 Cable Modem Termination System) would not have upstream, but only 405 downstream cable channels. Systems supporting both Telco Return and 406 cable upstream channels can use the above model without modification. 408 Telco Return Upstream channel(s) are handled by the appropriate MIBs, 409 such as PPP or Modem MIBs. 411 3.2.2. Virtual Circuits 413 This medium does not support virtual circuits and this area is not 414 applicable to this MIB. 416 3.2.3. ifTestTable 418 The ifTestTable is optional for Docsis CM/CMTS implementations, but is 419 not specifically influenced by the RF mib. 421 3.2.4. ifRcvAddressTable 423 The ifRcvAddressTable is optional for Docsis CM/CMTS implementations, but is 424 not specifically influenced by the RF mib. 426 3.2.5. ifEntry 428 This section documents only the differences from the requirements 429 specified in the Interfaces MIB. See that MIB for columns omitted 430 from the descriptions below. 432 3.2.5.1. ifEntry for Downstream interfaces 434 The ifEntry for Downstream interfaces supports the 435 ifGeneralInformationGroup and the ifPacketGroup of the Interfaces 436 MIB. This is an output only interface at the CMTS and all input 437 status counters - ifIn* - will return zero. This is an input only 438 interface at the CM and all output status counters - ifOut* - will 439 return zero. 441 3.2.5.1.1. ifEntry for Downstream interfaces in Cable Modem Termination 442 Systems 444 ifTable Comments 445 ============== =========================================== 446 ifIndex Each RF Cable Downstream interface is represented 447 by an ifEntry. 449 ifType The IANA value of docsCableDownstream(128). 451 ifSpeed Return the speed of this downstream channel. 452 The returned value is the raw bandwidth in bits/s 453 of this interface. This is the symbol rate 454 multiplied with the number of bits per symbol. 456 ifHighSpeed Return the speed of this downstream channel. 457 The returned value is the raw bandwidth in megabits/s 458 of this interface. This is the symbol rate 459 multiplied with the number of bits per symbol. 461 ifPhysAddress Return an empty string. 463 ifAdminStatus The administrative status of this interface. 465 ifOperStatus The current operational status of this interface. 467 ifMtu The size of the largest frame which can be 468 sent on this interface, specified in octets. 469 The value includes the length of the MAC header. 471 ifInOctets Return zero. 472 ifHCInOctets 474 ifInUcastPkts Return zero. 475 ifHCInUcastPkts 477 ifInMulticastPkts Return zero. 478 ifHCInMulticastPkts 480 ifInBroadcastPkts Return zero. 481 ifHCInBroadcastPkts 483 ifInDiscards Return zero. 485 ifInErrors Return zero. 487 ifInUnknownProtos Return zero. 489 ifOutOctets The total number of octets transmitted on this 490 ifHCOutOctets interface. This includes MAC packets as well as 491 data packets, and includes the length of the MAC 492 header. 494 ifOutUcastPkts The number of Unicast packets transmitted on this 495 ifHCOutUcastPkts interface. This includes MAC packets as well as 496 data packets. 498 ifOutMulticastPkts 499 ifHCOutMulticastPkts 500 Return the number of Multicast packets transmitted 501 on this interface. 502 This includes MAC packets as well as data packets. 504 ifOutBroadcastPkts 505 ifHCOutBroadcastPkts 506 Return the number of broadcast packets transmitted 507 on this interface. 508 This includes MAC packets as well as data packets. 510 ifOutDiscards The total number of outbound packets which 511 were discarded. Possible reasons are: 512 buffer shortage. 514 ifOutErrors The number of packets which could not be 515 transmitted due to errors. 517 ifPromiscuousMode Return false. 519 3.2.5.1.2. ifEntry for Downstream interfaces in Cable Modems 521 ifTable Comments 522 ============== =========================================== 523 ifIndex Each RF Cable Downstream interface is represented 524 by an ifEntry. 526 ifType The IANA value of docsCableDownstream(128). 528 ifSpeed Return the speed of this downstream channel. 529 The returned value the raw bandwidth in bits/s 530 of this interface. This is the symbol rate 531 multiplied with the number of bits per symbol. 533 ifHighSpeed Return the speed of this downstream channel. 534 The returned value the raw bandwidth in megabits/s 535 of this interface. This is the symbol rate 536 multiplied with the number of bits per symbol. 538 ifPhysAddress Return an empty string. 540 ifAdminStatus The administrative status of this interface. 542 ifOperStatus The current operational status of this interface. 544 ifMtu The size of the largest frame which can be 545 received from this interface, specified in octets. 546 The value includes the length of the MAC header. 548 ifInOctets The total number of octets received on this 549 ifHCInOctets interface. This includes data packets as well as 550 MAC layer packets, and includes the length of the 551 MAC header. 553 ifInUcastPkts The number of Unicast packets received on this 554 ifHCInUcastPkts interface. This includes data packets as well as 555 MAC layer packets. 557 ifInMulticastPkts 558 ifHCInMulticastPkts 559 Return the number of Multicast packets received 560 on this interface. This includes data packets as 561 well as MAC layer packets. 563 ifInBroadcastPkts 564 ifHCInBroadcastPkts 565 Return the number of Broadcast packets received 566 on this interface. This includes data packets 567 as well as MAC layer packets. 569 ifInDiscards The total number of received packets that have 570 been discarded. 571 The possible reasons are: buffer shortage. 573 ifInErrors The number of inbound packets that contained 574 errors preventing them from being deliverable 575 to higher layers. 576 Possible reasons are: MAC FCS error. 578 ifInUnknownProtos The number of frames with an unknown packet type. 579 These are MAC frames with an unknown packet type. 581 ifOutOctets Return zero. 582 ifHCOutOctets 584 ifOutUcastPkts Return zero. 585 ifHCOutUcastPkts 587 ifOutMulticastPkts 588 ifHCOutMulticastPkts 589 Return zero. 591 ifOutBroadcastPkts 592 ifHCOutBroadcastPkts 593 Return zero. 595 ifOutDiscards Return zero. 597 ifOutErrors Return zero. 599 ifPromiscuousMode Refer to the Interfaces MIB. 601 3.2.5.2. ifEntry for Upstream interfaces 603 Each supported interface of the type docsCableUpstream(129) must have a 604 corresponding ifEntry. 605 The ifEntry for Upstream interfaces supports the 606 ifGeneralInformationGroup and the ifPacketGroup of the Interfaces 607 MIB. This is an input only interface at the CMTS and all output 608 status counters - ifOut* - will return zero. This is an output only 609 interface at the CM and all input status counters - ifIn* - will 610 return zero. 612 3.2.5.2.1. ifEntry for Upstream interfaces in Cable Modem Termination 613 Systems 615 ifTable Comments 616 ============== =========================================== 617 ifIndex Each RF Cable Upstream interface is represented 618 by an ifEntry. 620 ifType The IANA value of docsCableUpstream (129). 622 ifSpeed Return the maximum channel throughput (not payload 623 throughput) supported by the interface. 624 The maximum throughput is calculated for the case where 625 upstream channels are configured to maximize interface 626 throughput. 628 ifHighSpeed Return the maximum channel throughput (not payload 629 throughput) supported by the interface. 630 The maximum throughput is calculated for the case where 631 upstream channels are configured to maximize interface 632 throughput. Units for this object are (1/1 000 000) * 633 IfSpeed. 635 ifPhysAddress Return an empty string. 637 ifAdminStatus The administrative status of this interface. 638 This reflect the total status of all the channels 639 under this interface. So if at least one channel has a 640 physical connection this interface has connection. 641 Any SNMP SET on this interface will cause a SET to all the 642 channels under this interface. 644 ifOperStatus The current operational status of this interface. 645 This reflects the total status of all the channels 646 under this interface. So if at least one channel has a 647 physical connection this interface has connection. 649 ifMtu The size of the largest frame which can be 650 transmitted on this interface, specified in octets. 651 The value includes the length of the MAC header. 652 This is the maximum of all the ifMtu of all the channels 653 under this interface. 655 ifInOctets The total (sum) number of octets received on all 656 ifHCInOctets the Upstream channels under this 657 interface. This includes data packets as well as 658 MAC layer packets, and includes the length of the 659 MAC header. 661 ifInUcastPkts The total number of Unicast packets received on all the 662 ifHCInUcastPkts upstream channels under this 663 interface. This includes data packets as well as 664 MAC layer packets. 666 ifInMulticastPkts 667 ifHCInMulticastPkts 668 Return the total number of Multicast packets received 669 on all the Upstream channels under this interface. 670 This includes data packets as 671 well as MAC layer packets. 673 ifInBroadcastPkts 674 ifHCInBroadcastPkts 675 Return the total number of Broadcast packets received 676 on all the Upstream channels under this interface. 677 This includes data packets 678 as well as MAC layer packets. 680 ifInDiscards The total number of received packets, which have 681 been discarded on all the Upstream channels under this 682 interface. 683 The possible reasons are: buffer shortage. 685 ifInErrors The total number of inbound packets that contained 686 errors preventing them from being deliverable 687 to higher layers. 688 Possible reasons are: MAC FCS error. 690 ifInUnknownProtos The total number of frames with an unknown packet type. 691 These are MAC frames with an unknown packet type. 693 ifOutOctets Return zero. 694 ifHCOutOctets 696 ifOutUcastPkts Return zero. 697 ifHCOutOctets 699 ifOutMulticastPkts 700 ifHCOutMulticastPkts 701 Return zero. 703 ifOutBroadcastPkts 704 ifHCOutBroadcastPkts 705 Return zero. 707 ifOutDiscards Return zero. 709 ifOutErrors Return zero. 711 3.2.5.2.2. ifEntry for Upstream interfaces in Cable Modems 713 ifTable Comments 714 ============== =========================================== 715 ifIndex Each RF Cable Upstream interface is represented 716 by an ifEntry. 718 ifType The IANA value of docsCableUpstream (129). 720 ifSpeed Return the speed of this upstream interface. 721 The returned value is the raw bandwidth 722 in bits/s of this interface. 724 ifHighSpeed Return the speed of this upstream interface. 725 The returned value is the raw bandwidth 726 in megabits/s of this interface. 728 ifPhysAddress Return an empty string. 730 ifAdminStatus The administrative status of this interface. 732 ifOperStatus The current operational status of this interface. 734 ifMtu The size of the largest frame which can be 735 transmitted on this interface, specified in octets. 736 The value includes the length of the MAC header. 738 ifInOctets Return zero. 739 ifHCInOctets 741 ifInUcastPkts Return zero. 742 ifHCInUcastPkts 744 ifInMulticastPkts Return zero. 745 ifHCInMulticastPkts 747 ifInBroadcastPkts Return zero. 748 ifHCInBroadcastPkts 750 ifInDiscards Return zero. 752 ifInErrors Return zero. 754 ifInUnknownProtos Return zero. 756 ifOutOctets The total number of octets transmitted on this 757 ifHCOutOctets interface. This includes MAC packets as well as 758 data packets, and includes the length of the MAC 759 header. 761 ifOutUcastPkts The number of Unicast packets transmitted on this 762 ifHCOutUcastPkts interface. This includes MAC packets as well as 763 data packets. 765 ifOutMulticastPkts 766 ifHCOutMulticastPkts 767 Return the number of Multicast packets transmitted 768 on this interface. 769 This includes MAC packets as well as data packets. 771 ifOutBroadcastPkts 772 ifHCOutBroadcastPkts 773 Return the number of broadcast packets transmitted 774 on this interface. 775 This includes MAC packets as well as data packets. 777 ifOutDiscards The total number of outbound packets which 778 were discarded. Possible reasons are: 779 buffer shortage. 781 ifOutErrors The number of packets which could not be 782 transmitted due to errors. 784 ifPromiscuousMode Return false. 786 3.2.5.3. ifEntry for Upstream channels 788 Each supported channel of the type docsCableUpstreamChannel(205) must have a 789 corresponding ifEntry. 790 The ifEntry for Upstream channels supports the 791 ifGeneralInformationGroup and the ifPacketGroup of the Interfaces 792 MIB. This is an input only interface at the CMTS and all output 793 status counters - ifOut* - will return zero. At the time of this mib creation, 794 DOCSIS CMs are not required to support logical upstream channels. 796 3.2.5.3.1. ifEntry for Upstream Channels in Cable Modem Termination 797 Systems 799 ifTable Comments 800 ============== =========================================== 801 ifIndex Each RF Cable Upstream channel is represented 802 by an ifEntry. 804 ifType The IANA value of docsCableUpstreamChannel (205). 806 ifSpeed Return the speed of this upstream channel. 807 The returned value is the raw bandwidth 808 in bits/s of this channel. 810 ifHighSpeed Return the speed of this upstream channel. 811 The returned value is the raw bandwidth 812 in megabits/s of this channel. 814 ifPhysAddress Return an empty string. 816 ifAdminStatus The administrative status of this interface. 818 ifOperStatus The current operational status of this interface. 820 ifMtu The size of the largest frame which can be 821 received on this interface, specified in octets. 822 The value includes the length of the MAC header. 824 ifInOctets The total number of octets received on this 825 interface. This includes data packets as well as 826 MAC layer packets, and includes the length of the 827 MAC header. 829 ifInUcastPkts The number of Unicast packets received on this 830 ifHCInUcastPkts interface. This includes data packets as well as 831 MAC layer packets. 833 ifInMulticastPkts 834 ifHCInMulticastPkts 835 Return the number of Multicast packets received 836 on this interface. This includes data packets as 837 well as MAC layer packets. 839 ifInBroadcastPkts 840 ifHCInBroadcastPkts 841 Return the number of Broadcast packets received 842 on this interface. This includes data packets 843 as well as MAC layer packets. 845 ifInDiscards The total number of received packets that have 846 been discarded. 847 The possible reasons are: buffer shortage. 849 ifInErrors The number of inbound packets that contained 850 errors preventing them from being deliverable 851 to higher layers. 852 Possible reasons are: MAC FCS error. 854 ifInUnknownProtos The number of frames with an unknown packet type. 855 These are MAC frames with an unknown packet type. 857 ifOutOctets Return zero. 858 ifHCOutOctets 859 ifOutUcastPkts Return zero. 860 ifHCOutUcastPkts 862 ifOutMulticastPkts 863 ifHCOutMulticastPkts 864 Return zero. 866 ifOutBroadcastPkts 867 ifHCOutBroadcastPkts 868 Return zero. 870 ifOutDiscards Return zero. 872 ifOutErrors Return zero. 874 3.2.5.4. ifEntry for the MAC Layer 876 The ifEntry for the MAC Layer supports the ifGeneralInformationGroup 877 and the ifPacketGroup of the Interfaces MIB. This interface provides 878 an aggregate view of status for the lower level Downstream and 879 Upstream interfaces. 881 ifTable Comments 882 ============== =========================================== 883 ifIndex Each RF Cable MAC layer entity is represented 884 by an ifEntry. 886 ifType The IANA value of docsCableMaclayer(127). 888 ifSpeed Return zero. 890 ifPhysAddress Return the physical address of this interface. 892 ifAdminStatus The administrative status of this interface. 894 ifOperStatus The current operational status of the MAC 895 layer interface. 897 ifHighSpeed Return zero. 899 ifMtu Return 1500. 901 ifInOctets The total number of data octets received on this 902 ifHCInOctets interface, targeted for upper protocol layers. 904 ifInUcastPkts The number of Unicast packets received on this 905 ifHCInUcastPkts interface, targeted for upper protocol layers. 907 ifInMulticastPkts 908 ifHCInMulticastPkts 909 Return the number of Multicast packets received 910 on this interface, targeted for upper protocol 911 layers. 913 ifInBroadcastPkts 914 ifHCInBroadcastPkts 915 Return the number of Broadcast packets received 916 on this interface, targeted for upper protocol 917 layers. 919 ifInDiscards The total number of received packets that have 920 been discarded. 921 The possible reasons are: buffer shortage. 923 ifInErrors The number of inbound packets that contained 924 errors preventing them from being deliverable 925 to higher layers. 926 Possible reasons are: data packet FCS error, 927 invalid MAC header. 929 ifInUnknownProtos The number of frames with an unknown packet type. 930 This is the number of data packets targeted for 931 upper protocol layers with an unknown packet type. 933 ifOutOctets The total number of octets, received from upper 934 ifHCOutOctets protocol layers and transmitted on this interface. 936 ifOutUcastPkts The number of Unicast packets, received from upper 937 ifHCOutUcastPkts protocol layers and transmitted on this interface. 939 ifOutMulticastPkts 940 ifHCOutMulticastPkts 941 Return the number of Multicast packets received 942 from upper protocol layers and transmitted on this 943 interface. 945 ifOutBroadcastPkts 946 ifHCOutBroadcastPkts 947 Return the number of broadcast packets received 948 from upper protocol layers and transmitted on this 949 interface. 951 ifOutDiscards The total number of outbound packets which 952 were discarded. Possible reasons are: 953 buffer shortage. 955 ifOutErrors The number of packets which could not be 956 transmitted due to errors. 958 ifPromiscuousMode Refer to the Interfaces MIB. 960 4. Definitions 962 DOCS-IF-MIB DEFINITIONS ::= BEGIN 964 IMPORTS 965 MODULE-IDENTITY, 966 OBJECT-TYPE, 967 -- do not import BITS, 968 Unsigned32, 969 Integer32, 970 Counter32, 971 Counter64, 972 TimeTicks, 973 IpAddress, 974 transmission 975 FROM SNMPv2-SMI 976 TEXTUAL-CONVENTION, 977 MacAddress, 978 RowStatus, 979 TruthValue, 980 TimeInterval, 981 TimeStamp 982 FROM SNMPv2-TC 983 OBJECT-GROUP, 985 MODULE-COMPLIANCE 986 FROM SNMPv2-CONF 987 ifIndex, InterfaceIndexOrZero 988 FROM IF-MIB 989 InetAddressType, 990 InetAddress 991 FROM INET-ADDRESS-MIB; 993 docsIfMib MODULE-IDENTITY 994 LAST-UPDATED "0202070000Z" -- February 7, 2002 995 ORGANIZATION "IETF IPCDN Working Group" 996 CONTACT-INFO 997 " Aviv Goren 998 Postal: Terayon 999 2952 Bunker Hill Lane 1000 Santa Clara, CA 1001 U.S.A. 1002 Phone: +1 408 727 4400 1003 E-mail: aviv.goren@terayon.com 1005 David Raftus 1006 Postal: Imedia Semiconductor 1007 340 Terry Fox Drive, Suite 202 1008 Ottawa Ontario 1009 Canada 1010 Phone: +1 613 592 1052 1011 E-mail: david.raftus@imedia.com 1013 IETF IPCDN Working Group 1014 General Discussion: ipcdn@ietf.org 1015 Subscribe: http://www.ietf.org/mailman/listinfo/ipcdn 1016 Archive: ftp://ftp.ietf.org/ietf-mail-archive/ipcdn 1017 Co-chairs: Richard Woundy, rwoundy@cisco.com 1018 Andrew Valentine, a.valentine@eu.hns.com" 1019 DESCRIPTION 1020 "This is the MIB Module for DOCSIS 2.0 compliant Radio 1021 Frequency (RF) interfaces in Cable Modems (CM) and 1022 Cable Modem Termination Systems (CMTS)." 1023 REVISION "0202070000Z" 1024 DESCRIPTION 1025 "Modified by David Raftus to add capability to adjust 1026 and verify upstream channel parameters as a group. 1027 Also adjusted syntax and clarified descriptions of 1028 selected objects. " 1029 REVISION "0111200000Z" 1030 DESCRIPTION 1031 "Modified by Aviv Goren and David Raftus to accommodate 1032 Docsis 2.0 Advanced Phy capabilities, as well as to 1033 incorporate objects from the docsIfExt mib. " 1034 REVISION "0102230000Z" 1035 DESCRIPTION 1036 "Modified by Rich Woundy to use IPv6-friendly 1037 address objects, to accommodate EuroDOCSIS, and 1038 to correct the SYNTAX of various objects." 1039 REVISION "9908190000Z" 1040 DESCRIPTION 1041 "Initial Version, published as RFC 2670. 1042 Modified by Mike StJohns to fix problems identified by 1043 the first pass of the MIB doctor. Of special note, 1044 docsIfRangingResp and docsIfCmtsInsertionInterval were 1045 obsoleted and replaced by other objects with the same 1046 functionality, but more appropriate SYNTAX." 1047 ::= { transmission 127 } 1049 -- Textual Conventions 1051 TenthdBmV ::= TEXTUAL-CONVENTION 1052 DISPLAY-HINT "d-1" 1053 STATUS current 1054 DESCRIPTION 1055 "This data type represents power levels that are normally 1056 expressed in dBmV. Units are in tenths of a dBmV; 1057 for example, 5.1 dBmV will be represented as 51." 1058 SYNTAX Integer32 1060 TenthdB ::= TEXTUAL-CONVENTION 1061 DISPLAY-HINT "d-1" 1062 STATUS current 1063 DESCRIPTION 1064 "This data type represents power levels that are normally 1065 expressed in dB. Units are in tenths of a dB; 1066 for example, 5.1 dB will be represented as 51." 1067 SYNTAX Integer32 1069 DocsisVersion ::= TEXTUAL-CONVENTION 1070 STATUS current 1071 DESCRIPTION "Indicates the DOCSIS version number." 1072 SYNTAX INTEGER { 1073 docsis10 (1), 1074 docsis11 (2), 1075 docsis20 (3) 1076 } 1078 DocsisQosVersion ::= TEXTUAL-CONVENTION 1079 STATUS current 1080 DESCRIPTION "Indicates the quality of service level." 1081 SYNTAX INTEGER { 1082 docsis10 (1), 1083 docsis11 (2) 1084 } 1086 DocsisUpstreamType ::= TEXTUAL-CONVENTION 1087 STATUS current 1088 DESCRIPTION "Indicates the DOCSIS Upstream Channel Type." 1089 SYNTAX INTEGER { 1090 tdma (1), 1091 atdma (2), 1092 scdma (3), 1093 tdmaAndAtdma (4) 1094 } 1096 docsIfMibObjects OBJECT IDENTIFIER ::= { docsIfMib 1 } 1097 docsIfBaseObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 1 } 1098 docsIfCmObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 2 } 1099 docsIfCmtsObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 3 } 1101 -- 1102 -- BASE GROUP 1103 -- 1105 -- 1106 -- The following table is implemented on both the Cable Modem (CM) 1107 -- and the Cable Modem Termination System (CMTS). This table is 1108 -- read only for the CM. 1109 -- 1110 docsIfDownstreamChannelTable OBJECT-TYPE 1111 SYNTAX SEQUENCE OF DocsIfDownstreamChannelEntry 1112 MAX-ACCESS not-accessible 1113 STATUS current 1114 DESCRIPTION 1115 "This table describes the attributes of downstream 1116 channels (frequency bands)." 1117 REFERENCE 1118 "Document [25] from References, Table 6-12 and Table 6-13." 1119 ::= { docsIfBaseObjects 1 } 1121 docsIfDownstreamChannelEntry OBJECT-TYPE 1122 SYNTAX DocsIfDownstreamChannelEntry 1123 MAX-ACCESS not-accessible 1124 STATUS current 1125 DESCRIPTION 1126 "An entry provides a list of attributes for a single 1127 Downstream channel. 1128 An entry in this table exists for each ifEntry with an 1129 ifType of docsCableDownstream(128)." 1130 INDEX { ifIndex } 1131 ::= { docsIfDownstreamChannelTable 1 } 1133 DocsIfDownstreamChannelEntry ::= SEQUENCE { 1134 docsIfDownChannelId Integer32, 1135 docsIfDownChannelFrequency Integer32, 1136 docsIfDownChannelWidth Integer32, 1137 docsIfDownChannelModulation INTEGER, 1138 docsIfDownChannelInterleave INTEGER, 1139 docsIfDownChannelPower TenthdBmV, 1140 docsIfDownChannelAnnex INTEGER 1141 } 1143 docsIfDownChannelId OBJECT-TYPE 1144 SYNTAX Integer32 (0..255) 1145 MAX-ACCESS read-only 1146 STATUS current 1147 DESCRIPTION 1148 "The Cable Modem Termination System (CMTS) identification 1149 of the downstream channel within this particular MAC 1150 interface. If the interface is down, the object returns 1151 the most current value. If the downstream channel ID is 1152 unknown, this object returns a value of 0." 1153 ::= { docsIfDownstreamChannelEntry 1 } 1155 docsIfDownChannelFrequency OBJECT-TYPE 1156 SYNTAX Integer32 (0..1000000000) 1157 UNITS "hertz" 1158 MAX-ACCESS read-write 1159 STATUS current 1160 DESCRIPTION 1161 "The center of the downstream frequency associated with 1162 this channel. This object will return the current tuner 1163 frequency. If a CMTS provides IF output, this object 1164 will return 0, unless this CMTS is in control of the 1165 final downstream RF frequency. See the associated 1166 compliance object for a description of valid frequencies 1167 that may be written to this object." 1168 REFERENCE 1169 "Document [25] from References, Tables 4-1, 6-14." 1170 ::= { docsIfDownstreamChannelEntry 2 } 1172 docsIfDownChannelWidth OBJECT-TYPE 1173 SYNTAX Integer32 (0..16000000) 1174 UNITS "hertz" 1175 MAX-ACCESS read-write 1176 STATUS current 1177 DESCRIPTION 1178 "The bandwidth of this downstream channel. Most 1179 implementations are expected to support a channel width 1180 of 6 MHz (North America) and/or 8 MHz (Europe). See the 1181 associated compliance object for a description of the 1182 valid channel widths for this object." 1183 REFERENCE 1184 "Document [25] from References, Table 6-14." 1185 ::= { docsIfDownstreamChannelEntry 3 } 1187 docsIfDownChannelModulation OBJECT-TYPE 1188 SYNTAX INTEGER { 1189 unknown(1), 1190 other(2), 1191 qam64(3), 1192 qam256(4) 1193 } 1194 MAX-ACCESS read-write 1195 STATUS current 1196 DESCRIPTION 1197 "The modulation type associated with this downstream 1198 channel. If the interface is down, this object either 1199 returns the configured value (CMTS), the most current 1200 value (CM), or the value of unknown(1). See the 1201 associated conformance object for write conditions and 1202 limitations. See the reference for specifics on the 1203 modulation profiles implied by qam64 and qam256." 1204 REFERENCE 1205 "Document [25] from References, Table 6-14." 1206 ::= { docsIfDownstreamChannelEntry 4 } 1208 docsIfDownChannelInterleave OBJECT-TYPE 1209 SYNTAX INTEGER { 1210 unknown(1), 1211 other(2), 1212 taps8Increment16(3), 1213 taps16Increment8(4), 1214 taps32Increment4(5), 1215 taps64Increment2(6), 1216 taps128Increment1(7), 1217 taps12increment17(8) 1218 } 1219 MAX-ACCESS read-write 1220 STATUS current 1221 DESCRIPTION 1222 "The Forward Error Correction (FEC) interleaving used 1223 for this downstream channel. 1224 Values are defined as follows: 1225 taps8Increment16(3): protection 5.9/4.1 usec, 1226 latency .22/.15 msec 1227 taps16Increment8(4): protection 12/8.2 usec, 1228 latency .48/.33 msec 1229 taps32Increment4(5): protection 24/16 usec, 1230 latency .98/.68 msec 1231 taps64Increment2(6): protection 47/33 usec, 1232 latency 2/1.4 msec 1233 taps128Increment1(7): protection 95/66 usec, 1234 latency 4/2.8 msec 1235 taps12increment17(8): protection 18/14 usec, 1236 latency 0.43/0.32 msec 1237 taps12increment17 is implemented in 1238 conformance with EuroDOCSIS document 1239 'Adapted MIB-definitions - and a 1240 clarification for MPEG-related issues - for 1241 EuroDOCSIS cable modem systems' by tComLabs 1242 and should only be used for a EuroDOCSIS MAC 1243 interface. 1245 If the interface is down, this object either returns 1246 the configured value (CMTS), the most current value (CM), 1247 or the value of unknown(1). 1248 The value of other(2) is returned if the interleave 1249 is known but not defined in the above list. 1250 See the associated conformance object for write 1251 conditions and limitations. See the reference for the FEC 1252 configuration described by the setting of this object." 1253 REFERENCE 1254 "Document [25] from References, Table 6-13." 1255 ::= { docsIfDownstreamChannelEntry 5 } 1257 docsIfDownChannelPower OBJECT-TYPE 1258 SYNTAX TenthdBmV 1259 UNITS "dBmV" 1260 MAX-ACCESS read-write 1261 STATUS current 1262 DESCRIPTION 1263 "At the CMTS, the operational transmit power. At the CM, 1264 the received power level. May be set to zero at the CM 1265 if power level measurement is not supported. 1266 If the interface is down, this object either returns 1267 the configured value (CMTS), the most current value (CM) 1268 or the value of 0. See the associated conformance object 1269 for write conditions and limitations. See the reference 1270 for recommended and required power levels." 1271 REFERENCE 1272 "Document [25] from References,Table 6-15." 1273 ::= { docsIfDownstreamChannelEntry 6 } 1275 docsIfDownChannelAnnex OBJECT-TYPE 1276 SYNTAX INTEGER { 1277 unknown(1), 1278 other(2), 1279 annexA(3), 1280 annexB(4), 1281 annexC(5) 1282 } 1283 MAX-ACCESS read-only 1284 STATUS current 1285 DESCRIPTION 1286 "The value of this object indicates the conformance of 1287 the implementation to important regional cable standards. 1288 annexA : Annex A from ITU-J83 is used. 1289 annexB : Annex B from ITU-J83 is used. 1290 annexC : Annex C from ITU-J83 is used. 1291 AnnexB is used for DOCSIS implementations" 1292 REFERENCE 1293 "Document [28] from References, Section 2.2" 1294 ::= { docsIfDownstreamChannelEntry 7 } 1296 -- 1297 -- The following table is implemented on both the CM and the CMTS. 1298 -- For the CM, only attached channels appear in the table. For the 1299 -- CM, this table is read only as well. 1300 -- 1302 docsIfUpstreamChannelTable OBJECT-TYPE 1303 SYNTAX SEQUENCE OF DocsIfUpstreamChannelEntry 1304 MAX-ACCESS not-accessible 1305 STATUS current 1306 DESCRIPTION 1307 "This table describes the attributes of attached upstream 1308 channels." 1309 ::= { docsIfBaseObjects 2 } 1311 docsIfUpstreamChannelEntry OBJECT-TYPE 1312 SYNTAX DocsIfUpstreamChannelEntry 1313 MAX-ACCESS not-accessible 1314 STATUS current 1315 DESCRIPTION 1316 "List of attributes for a single upstream channel. For 1317 Docsis 2.0 CMTSs, an entry in this table exists for 1318 each ifEntry with an ifType of docsCableUpstreamChannel (205). 1319 For Docsis 1.x CM/CMTSs and Docsis 2.0 CMs, an entry in this table exists 1320 for each ifEntry with an ifType of docsCableUpstreamInterface (129)." 1321 INDEX { ifIndex } 1322 ::= { docsIfUpstreamChannelTable 1 } 1324 DocsIfUpstreamChannelEntry ::= SEQUENCE { 1325 docsIfUpChannelId Integer32, 1326 docsIfUpChannelFrequency Integer32, 1327 docsIfUpChannelWidth Integer32, 1328 docsIfUpChannelModulationProfile Unsigned32, 1329 docsIfUpChannelSlotSize Unsigned32, 1330 docsIfUpChannelTxTimingOffset Unsigned32, 1331 docsIfUpChannelRangingBackoffStart Integer32, 1332 docsIfUpChannelRangingBackoffEnd Integer32, 1333 docsIfUpChannelTxBackoffStart Integer32, 1334 docsIfUpChannelTxBackoffEnd Integer32, 1335 docsIfUpChannelScdmaActiveCodes Unsigned32, 1336 docsIfUpChannelScdmaCodesPerSlot Integer32, 1337 docsIfUpChannelScdmaFrameSize Unsigned32, 1338 docsIfUpChannelScdmaHoppingSeed Unsigned32, 1339 docsIfUpChannelType DocsisUpstreamType, 1340 docsIfUpChannelCloneFrom InterfaceIndexOrZero, 1341 docsIfUpChannelUpdate TruthValue, 1342 docsIfUpChannelStatus RowStatus 1343 } 1345 docsIfUpChannelId OBJECT-TYPE 1346 SYNTAX Integer32 (0..255) 1347 MAX-ACCESS read-only 1348 STATUS current 1349 DESCRIPTION 1350 "The CMTS identification of the upstream channel." 1351 ::= { docsIfUpstreamChannelEntry 1 } 1353 docsIfUpChannelFrequency OBJECT-TYPE 1354 SYNTAX Integer32 (0..1000000000) 1355 UNITS "hertz" 1356 MAX-ACCESS read-create 1357 STATUS current 1358 DESCRIPTION 1359 "The center of the frequency band associated with this 1360 upstream interface. This object returns 0 if the frequency 1361 is undefined or unknown. Minimum permitted upstream 1362 frequency is 5,000,000 Hz for current technology. See 1363 the associated conformance object for write conditions 1364 and limitations." 1365 REFERENCE 1366 "Document [25] from References, Table 4-2." 1367 ::= { docsIfUpstreamChannelEntry 2 } 1369 docsIfUpChannelWidth OBJECT-TYPE 1370 SYNTAX Integer32 (0..64000000) 1371 UNITS "hertz" 1372 MAX-ACCESS read-create 1373 STATUS current 1374 DESCRIPTION 1375 "The bandwidth of this upstream interface. This object 1376 returns 0 if the interface width is undefined or unknown. 1377 Minimum permitted interface width is 200,000 Hz currently. 1378 See the associated conformance object for write conditions 1379 and limitations." 1380 REFERENCE 1381 "Document [25] from References, Table 6-12." 1382 ::= { docsIfUpstreamChannelEntry 3 } 1384 docsIfUpChannelModulationProfile OBJECT-TYPE 1385 SYNTAX Unsigned32 1386 MAX-ACCESS read-create 1387 STATUS current 1388 DESCRIPTION 1389 "An entry identical to the docsIfModIndex in the 1390 docsIfCmtsModulationTable that describes this channel. 1391 This channel is further instantiated there by a grouping 1392 of interval usage codes which together fully describe the 1393 channel modulation. This object returns 0 if the 1394 docsIfCmtsModulationTable entry does not exist or 1395 docsIfCmtsModulationTable is empty. See 1396 the associated conformance object for write conditions 1397 and limitations." 1398 REFERENCE 1399 "Document [25] from References, Table 8-19." 1400 ::= { docsIfUpstreamChannelEntry 4 } 1402 docsIfUpChannelSlotSize OBJECT-TYPE 1403 SYNTAX Unsigned32 1404 MAX-ACCESS read-create 1405 STATUS current 1406 DESCRIPTION 1407 "Applicable to TDMA and ATDMA channel types only. 1408 The number of 6.25 microsecond ticks in each upstream mini- 1409 slot. Returns zero if the value is undefined, unknown or in 1410 case of an SCDMA channel. 1411 See the associated conformance object for write 1412 conditions and limitations. " 1413 REFERENCE 1414 "Document [25] from References, Section 8.1.2.4." 1415 ::= { docsIfUpstreamChannelEntry 5 } 1417 docsIfUpChannelTxTimingOffset OBJECT-TYPE 1418 SYNTAX Unsigned32 1419 MAX-ACCESS read-only 1420 STATUS current 1421 DESCRIPTION 1422 "At the CM, a measure of the current round trip time obtained from the 1423 ranging offset (initial ranging offset + ranging offset adjustments). 1424 At the CMTS, the maximum of timing offset, among all the CMs that 1425 are/were present on the channel, taking into account all ( initial + 1426 periodic )timing offset corrections that were sent for each of the CMs. 1427 Generally, these measurements are positive, but if the 1428 measurements are negative, the value of this object is zero. Used for 1429 timing of CM upstream transmissions to ensure synchronized arrivals at 1430 the CMTS. Units are in terms of (6.25 microseconds/64)." 1431 REFERENCE 1432 "Document [25] from References, Section 6.2.18." 1433 ::= { docsIfUpstreamChannelEntry 6 } 1435 docsIfUpChannelRangingBackoffStart OBJECT-TYPE 1436 SYNTAX Integer32 (0..16) 1437 MAX-ACCESS read-create 1438 STATUS current 1439 DESCRIPTION 1440 "The initial random backoff window to use when retrying 1441 Ranging Requests. Expressed as a power of 2. A value of 16 1442 at the CMTS indicates that a proprietary adaptive retry 1443 mechanism is to be used. See the associated conformance 1444 object for write conditions and limitations." 1445 REFERENCE 1446 "Document [25] from References, Section 8.3.4." 1447 ::= { docsIfUpstreamChannelEntry 7 } 1449 docsIfUpChannelRangingBackoffEnd OBJECT-TYPE 1450 SYNTAX Integer32 (0..16) 1451 MAX-ACCESS read-create 1452 STATUS current 1453 DESCRIPTION 1454 "The final random backoff window to use when retrying 1455 Ranging Requests. Expressed as a power of 2. A value of 16 1456 at the CMTS indicates that a proprietary adaptive retry 1457 mechanism is to be used. See the associated conformance 1458 object for write conditions and limitations." 1459 REFERENCE 1460 "Document [25] from References, Section 8.3.4." 1461 ::= { docsIfUpstreamChannelEntry 8 } 1463 docsIfUpChannelTxBackoffStart OBJECT-TYPE 1464 SYNTAX Integer32 (0..16) 1465 MAX-ACCESS read-create 1466 STATUS current 1467 DESCRIPTION 1468 "The initial random backoff window to use when retrying 1469 transmissions. Expressed as a power of 2. A value of 16 1470 at the CMTS indicates that a proprietary adaptive retry 1471 mechanism is to be used. See the associated conformance 1472 object for write conditions and limitations." 1473 REFERENCE 1474 "Document [25] from References, Section 8.3.4." 1475 ::= { docsIfUpstreamChannelEntry 9 } 1477 docsIfUpChannelTxBackoffEnd OBJECT-TYPE 1478 SYNTAX Integer32 (0..16) 1479 MAX-ACCESS read-create 1480 STATUS current 1481 DESCRIPTION 1482 "The final random backoff window to use when retrying 1483 transmissions. Expressed as a power of 2. A value of 16 1484 at the CMTS indicates that a proprietary adaptive retry 1485 mechanism is to be used. See the associated conformance 1486 object for write conditions and limitations." 1487 REFERENCE 1488 "Document [25] from References, Section 8.3.4." 1489 ::= { docsIfUpstreamChannelEntry 10 } 1491 docsIfUpChannelScdmaActiveCodes OBJECT-TYPE 1492 SYNTAX Unsigned32 (0 | 64..128) 1493 MAX-ACCESS read-create 1494 STATUS current 1495 DESCRIPTION 1496 "Applicable for SCDMA channel types only. 1497 Number of active codes. Returns zero for 1498 Non-SCDMA channel types. Note that legal 1499 values from 64..128 MUST be non-prime." 1500 REFERENCE 1501 "Document [25] from References, Section 6.2.11.2.1." 1502 ::= { docsIfUpstreamChannelEntry 11 } 1504 docsIfUpChannelScdmaCodesPerSlot OBJECT-TYPE 1505 SYNTAX Integer32(0 | 2..32) 1506 MAX-ACCESS read-create 1507 STATUS current 1508 DESCRIPTION 1509 "Applicable for SCDMA channel types only. 1510 The number of SCDMA codes per mini-slot. 1511 Returns zero if the value is undefined, unknown or in 1512 case of a TDMA or ATDMA channel." 1513 REFERENCE 1514 "Document [25] from References, Section 6.2.11.2.1." 1515 ::= { docsIfUpstreamChannelEntry 12 } 1517 docsIfUpChannelScdmaFrameSize OBJECT-TYPE 1518 SYNTAX Unsigned32 (0..32) 1519 MAX-ACCESS read-create 1520 STATUS current 1521 DESCRIPTION 1522 "Applicable for SCDMA channel types only. 1523 SCDMA Frame size in units of spreading intervals. 1525 This value returns zero for non SCDMA Profiles." 1526 REFERENCE 1527 " Document [25] from References, Section 6.2.12." 1528 ::= { docsIfUpstreamChannelEntry 13 } 1530 docsIfUpChannelScdmaHoppingSeed OBJECT-TYPE 1531 SYNTAX Unsigned32 (0..32767) 1532 MAX-ACCESS read-create 1533 STATUS current 1534 DESCRIPTION 1535 "Applicable for SCDMA channel types only. 1536 15 bit seed used for code hopping sequence initialization. 1537 Returns zero for non-SCDMA channel types." 1538 REFERENCE 1539 "Document [25] from References, Section 6.2.14.1." 1540 ::= { docsIfUpstreamChannelEntry 14 } 1542 docsIfUpChannelType OBJECT-TYPE 1543 SYNTAX DocsisUpstreamType 1544 MAX-ACCESS read-create 1545 STATUS current 1546 DESCRIPTION 1547 "Defines the Upstream channel type. 1548 Given the channel type, other channel attributes can be checked 1549 for value validity at the time of entry creation and update." 1550 REFERENCE 1551 "Document [25] from References, Section 6.2.1." 1552 ::= { docsIfUpstreamChannelEntry 15 } 1554 docsIfUpChannelCloneFrom OBJECT-TYPE 1555 SYNTAX InterfaceIndexOrZero 1556 MAX-ACCESS read-create 1557 STATUS current 1558 DESCRIPTION 1559 "Intended for use when a temporary inactive upstream table row is 1560 created for the purpose of manipulating SCDMA parameters for an 1561 active row. Refer to the descriptions of docsIfUpChannelStatus 1562 and docsIfUpChannelUpdate for details of this procedure. 1563 This object contains the ifIndex value of the active upstream 1564 row whose SCDMA parameters are to be adjusted. 1565 This object must contain a value of zero for active upstream rows." 1566 ::= { docsIfUpstreamChannelEntry 16 } 1568 docsIfUpChannelUpdate OBJECT-TYPE 1569 SYNTAX TruthValue 1570 MAX-ACCESS read-create 1571 STATUS current 1572 DESCRIPTION 1573 "Used to perform the transfer of adjusted SCDMA parameters from the 1574 temporary upstream row to the active upstream row indicated by the 1575 docsIfUpChannelCloneFrom object. The transfer is initiated through 1576 an SNMP SET of TRUE to this object. The SNMP SET will fail with a 1577 GEN_ERROR (snmpv1) or COMMIT_FAILED_ERROR (snmpv2c/v3) if the adjusted 1578 SCDMA parameter values are not compatible with each other. 1579 An SNMP GET of this object always returns FALSE." 1580 ::= { docsIfUpstreamChannelEntry 17 } 1582 docsIfUpChannelStatus OBJECT-TYPE 1583 SYNTAX RowStatus 1584 MAX-ACCESS read-create 1585 STATUS current 1586 DESCRIPTION 1587 "This object is generally intended to be used for the creation of 1588 a temporary inactive upstream row for the purpose of adjusting 1589 the SCDMA channel parameters of an active upstream row. 1590 The recommended procedure is: 1591 1) Create an inactive row through an SNMP SET using CREATEandWAIT. 1592 Use an ifIndex value outside the operational range of the system. 1593 2) Set the docsIfUpChannelCloneFrom field to the ifIndex value of 1594 the active row whose SCDMA parameters require adjustment. 1595 3) Adjust the SCDMA parameter values using the new temporary inactive 1596 row. 1597 4) Update the active row by setting object docsIfUpChannelUpdate to 1598 TRUE. This SET will fail if the adjusted SCDMA parameters are not 1599 compatible with each other. 1600 5) Delete the temporary row through an SNMP SET using DELETE. 1602 The following restrictions apply to this object: 1603 1) This object must contain a value of ACTIVE for active rows. 1604 2) Temporary inactive rows must be created using CREATEandWAIT. 1605 3) The only possible status change of a row created using 1606 CREATEandWAIT (ie NotInService) is to DELETE. These temporary 1607 rows must never become active." 1608 ::= { docsIfUpstreamChannelEntry 18 } 1610 -- The following table describes the attributes of each class of 1611 -- service. The entries in this table are referenced from the 1612 -- docsIfServiceEntries. They exist as a separate table in order to 1613 -- reduce redundant information in docsIfServiceTable. 1614 -- 1615 -- This table is implemented at both the CM and the CMTS. 1616 -- The CM need only maintain entries for the classes of service 1617 -- referenced by its docsIfServiceTable. 1618 -- 1620 docsIfQosProfileTable OBJECT-TYPE 1621 SYNTAX SEQUENCE OF DocsIfQosProfileEntry 1622 MAX-ACCESS not-accessible 1623 STATUS current 1624 DESCRIPTION 1625 "Describes the attributes for each class of service." 1626 ::= { docsIfBaseObjects 3 } 1628 docsIfQosProfileEntry OBJECT-TYPE 1629 SYNTAX DocsIfQosProfileEntry 1630 MAX-ACCESS not-accessible 1631 STATUS current 1632 DESCRIPTION 1633 "Describes the attributes for a single class of service. 1635 If implemented as read-create in the Cable Modem 1636 Termination System, creation of entries in this table is 1637 controlled by the value of docsIfCmtsQosProfilePermissions. 1639 If implemented as read-only, entries are created based 1640 on information in REG-REQ MAC messages received from 1641 Cable Modems (Cable Modem Termination System 1642 implementation), or based on information extracted from 1643 the TFTP option file (Cable Modem implementation). 1644 In the Cable Modem Termination system, read-only entries 1645 are removed if no longer referenced by 1646 docsIfCmtsServiceTable. 1648 An entry in this table must not be removed while it is 1649 referenced by an entry in docsIfCmServiceTable (Cable Modem) 1650 or docsIfCmtsServiceTable (Cable Modem Termination System). 1652 An entry in this table should not be changeable while 1653 it is referenced by an entry in docsIfCmtsServiceTable. 1655 If this table is created automatically, there should only 1656 be a single entry for each Class of Service. Multiple 1657 entries with the same Class of Service parameters are not 1658 recommended." 1659 INDEX { docsIfQosProfIndex } 1660 ::= { docsIfQosProfileTable 1 } 1662 DocsIfQosProfileEntry ::= SEQUENCE { 1663 docsIfQosProfIndex Integer32, 1664 docsIfQosProfPriority Integer32, 1665 docsIfQosProfMaxUpBandwidth Integer32, 1666 docsIfQosProfGuarUpBandwidth Integer32, 1667 docsIfQosProfMaxDownBandwidth Integer32, 1668 docsIfQosProfMaxTxBurst Integer32, -- Deprecated 1669 docsIfQosProfBaselinePrivacy TruthValue, 1670 docsIfQosProfStatus RowStatus, 1671 docsIfQosProfMaxTransmitBurst Integer32 1672 } 1674 docsIfQosProfIndex OBJECT-TYPE 1675 SYNTAX Integer32 (1..16383) 1676 MAX-ACCESS not-accessible 1677 STATUS current 1678 DESCRIPTION 1679 "The index value that uniquely identifies an entry 1680 in the docsIfQosProfileTable." 1681 ::= { docsIfQosProfileEntry 1 } 1683 docsIfQosProfPriority OBJECT-TYPE 1684 SYNTAX Integer32 (0..7) 1685 MAX-ACCESS read-create 1686 STATUS current 1687 DESCRIPTION 1688 "A relative priority assigned to this service when 1689 allocating bandwidth. Zero indicates lowest priority 1690 and seven indicates highest priority. 1691 Interpretation of priority is device-specific. 1692 MUST NOT be changed while this row is active." 1693 REFERENCE 1694 "Document [25] from References, Appendix C.1.1.4." 1695 DEFVAL { 0 } 1696 ::= { docsIfQosProfileEntry 2 } 1698 docsIfQosProfMaxUpBandwidth OBJECT-TYPE 1699 SYNTAX Integer32 (0..100000000) 1700 MAX-ACCESS read-create 1701 STATUS current 1702 DESCRIPTION 1703 "The maximum upstream bandwidth, in bits per second, 1704 allowed for a service with this service class. 1705 Zero if there is no restriction of upstream bandwidth. 1706 MUST NOT be changed while this row is active." 1707 REFERENCE 1708 "Document [25] from References, Appendix C.1.1.4." 1710 DEFVAL { 0 } 1711 ::= { docsIfQosProfileEntry 3 } 1713 docsIfQosProfGuarUpBandwidth OBJECT-TYPE 1714 SYNTAX Integer32 (0..100000000) 1715 MAX-ACCESS read-create 1716 STATUS current 1717 DESCRIPTION 1718 "Minimum guaranteed upstream bandwidth, in bits per second, 1719 allowed for a service with this service class. 1720 MUST NOT be changed while this row is active." 1721 REFERENCE 1722 "Document [25] from References, Appendix C.1.1.4." 1723 DEFVAL { 0 } 1724 ::= { docsIfQosProfileEntry 4 } 1726 docsIfQosProfMaxDownBandwidth OBJECT-TYPE 1727 SYNTAX Integer32 (0..100000000) 1728 MAX-ACCESS read-create 1729 STATUS current 1730 DESCRIPTION 1731 "The maximum downstream bandwidth, in bits per second, 1732 allowed for a service with this service class. 1733 Zero if there is no restriction of downstream bandwidth. 1734 MUST NOT be changed while this row is active." 1735 REFERENCE 1736 "Document [25] from References, Appendix C.1.1.4." 1738 DEFVAL { 0 } 1739 ::= { docsIfQosProfileEntry 5 } 1741 docsIfQosProfMaxTxBurst OBJECT-TYPE 1742 SYNTAX Integer32 (0..255) 1743 MAX-ACCESS read-create 1744 STATUS deprecated 1745 DESCRIPTION 1746 "The maximum number of mini-slots that may be requested 1747 for a single upstream transmission. 1748 A value of zero means there is no limit. 1749 MUST NOT be changed while this row is active. 1750 This object has been deprecated and replaced by 1751 docsIfQosProfMaxTransmitBurst, to fix a mismatch 1752 of the units and value range with respect to the DOCSIS 1753 Maximum Upstream Channel Transmit Burst Configuration 1754 Setting." 1755 REFERENCE 1756 "Document [25] from References, C.1.1.4." 1757 DEFVAL { 0 } 1758 ::= { docsIfQosProfileEntry 6 } 1760 docsIfQosProfBaselinePrivacy OBJECT-TYPE 1761 SYNTAX TruthValue 1762 MAX-ACCESS read-create 1763 STATUS current 1764 DESCRIPTION 1765 "Indicates whether Baseline Privacy is enabled for this 1766 service class. 1767 MUST NOT be changed while this row is active." 1768 DEFVAL { false } 1769 ::= { docsIfQosProfileEntry 7 } 1771 docsIfQosProfStatus OBJECT-TYPE 1772 SYNTAX RowStatus 1773 MAX-ACCESS read-create 1774 STATUS current 1775 DESCRIPTION 1776 "This is object is to used to create or delete rows in 1777 this table. This object MUST NOT be changed from active 1778 while the row is referenced by the any entry in either 1779 docsIfCmServiceTable (on the CM), or the 1780 docsIfCmtsServiceTable (on the CMTS)." 1781 ::= { docsIfQosProfileEntry 8 } 1783 docsIfQosProfMaxTransmitBurst OBJECT-TYPE 1784 SYNTAX Integer32 (0..1522) 1785 MAX-ACCESS read-create 1786 STATUS current 1787 DESCRIPTION 1788 "The maximum number of bytes that may be requested for a 1789 single upstream transmission. A value of zero means there 1790 is no limit. Note: This value does not include any 1791 physical layer overhead. 1792 MUST NOT be changed while this row is active." 1793 REFERENCE 1794 "Document [25] from References, Appendix C.1.1.4." 1795 DEFVAL { 0 } 1796 ::= { docsIfQosProfileEntry 9 } 1798 docsIfSignalQualityTable OBJECT-TYPE 1799 SYNTAX SEQUENCE OF DocsIfSignalQualityEntry 1800 MAX-ACCESS not-accessible 1801 STATUS current 1802 DESCRIPTION 1803 "At the CM, describes the PHY signal quality of downstream 1804 channels. At the CMTS, describes the PHY signal quality of 1805 upstream channels. At the CMTS, this table may exclude 1806 contention intervals." 1807 ::= { docsIfBaseObjects 4 } 1809 docsIfSignalQualityEntry OBJECT-TYPE 1810 SYNTAX DocsIfSignalQualityEntry 1811 MAX-ACCESS not-accessible 1812 STATUS current 1813 DESCRIPTION 1814 "At the CM, describes the PHY characteristics of a 1815 downstream channel. At the CMTS, describes the PHY signal 1816 quality of an upstream channel. 1817 An entry in this table exists for each ifEntry with an 1818 ifType of docsCableUpstream(129) for Cable Modem Termination 1819 Systems and docsCableDownstream(128) for Cable Modems." 1820 INDEX { ifIndex } 1821 ::= { docsIfSignalQualityTable 1 } 1823 DocsIfSignalQualityEntry ::= SEQUENCE { 1824 docsIfSigQIncludesContention TruthValue, 1825 docsIfSigQUnerroreds Counter32, 1826 docsIfSigQCorrecteds Counter32, 1827 docsIfSigQUncorrectables Counter32, 1828 docsIfSigQSignalNoise TenthdB, 1829 docsIfSigQMicroreflections Integer32, 1830 docsIfSigQEqualizationData OCTET STRING 1831 } 1833 docsIfSigQIncludesContention OBJECT-TYPE 1834 SYNTAX TruthValue 1835 MAX-ACCESS read-only 1836 STATUS current 1837 DESCRIPTION 1838 "true(1) if this CMTS includes contention intervals in 1839 the counters in this table. Always false(2) for CMs." 1840 REFERENCE 1841 "Document [25] from References, 1842 Section 9.4.1" 1843 ::= { docsIfSignalQualityEntry 1 } 1845 docsIfSigQUnerroreds OBJECT-TYPE 1846 SYNTAX Counter32 1847 MAX-ACCESS read-only 1848 STATUS current 1849 DESCRIPTION 1850 "Codewords received on this channel without error. 1851 This includes all codewords, whether or not they 1852 were part of frames destined for this device." 1853 REFERENCE 1854 "Document [25] from References, Section 6.2.5." 1855 ::= { docsIfSignalQualityEntry 2 } 1857 docsIfSigQCorrecteds OBJECT-TYPE 1858 SYNTAX Counter32 1859 MAX-ACCESS read-only 1860 STATUS current 1861 DESCRIPTION 1862 "Codewords received on this channel with correctable 1863 errors. This includes all codewords, whether or not 1864 they were part of frames destined for this device." 1865 REFERENCE 1866 "Document [25] from References, Section 6.2.5." 1867 ::= { docsIfSignalQualityEntry 3 } 1869 docsIfSigQUncorrectables OBJECT-TYPE 1870 SYNTAX Counter32 1871 MAX-ACCESS read-only 1872 STATUS current 1873 DESCRIPTION 1874 "Codewords received on this channel with uncorrectable 1875 errors. This includes all codewords, whether or not 1876 they were part of frames destined for this device." 1877 REFERENCE 1878 "Document [25] from References, Section 6.2.5." 1879 ::= { docsIfSignalQualityEntry 4 } 1881 docsIfSigQSignalNoise OBJECT-TYPE 1882 SYNTAX TenthdB 1883 UNITS "dB" 1884 MAX-ACCESS read-only 1885 STATUS current 1886 DESCRIPTION 1887 "Signal/Noise ratio as perceived for this channel. 1889 At the CM, describes the Signal/Noise of the downstream 1890 channel. At the CMTS, describes the average Signal/Noise 1891 of the upstream channel." 1892 REFERENCE 1893 "Document [25] from References, Tables 4-1 and 4-2" 1894 ::= { docsIfSignalQualityEntry 5 } 1896 docsIfSigQMicroreflections OBJECT-TYPE 1897 SYNTAX Integer32 (0..255) 1898 UNITS "dBc" 1899 MAX-ACCESS read-only 1900 STATUS current 1901 DESCRIPTION 1902 "Total microreflections including in-channel response 1903 as perceived on this interface, measured in dBc below 1904 the signal level. 1905 This object is not assumed to return an absolutely 1906 accurate value, but should give a rough indication 1907 of microreflections received on this interface. 1908 It is up to the implementer to provide information 1909 as accurate as possible." 1910 REFERENCE 1911 "Document [25] from References, Tables 4-1 and 4-2" 1912 ::= { docsIfSignalQualityEntry 6 } 1914 docsIfSigQEqualizationData OBJECT-TYPE 1915 SYNTAX OCTET STRING 1916 MAX-ACCESS read-only 1917 STATUS current 1918 DESCRIPTION 1919 "At the CM, returns the equalization data for the downstream 1920 channel. At the CMTS, returns the average equalization 1921 data for the upstream channel. Returns an empty string 1922 if the value is unknown or if there is no equalization 1923 data available or defined." 1924 REFERENCE 1925 "Document [25] from References, Table 8-21." 1926 ::= { docsIfSignalQualityEntry 7 } 1928 -- 1929 -- DOCSIS Version of the device 1930 -- 1932 docsIfDocsisBaseCapability OBJECT-TYPE 1933 SYNTAX DocsisVersion 1934 MAX-ACCESS read-only 1935 STATUS current 1936 DESCRIPTION 1937 "Indication of the DOCSIS capability of the device. 1938 This object mirrors docsIfDocsisCapability from the 1939 DocsIfExt mib." 1941 REFERENCE 1942 "Document [25] from References, Annex G." 1943 ::= { docsIfBaseObjects 5 } 1945 -- 1946 -- CABLE MODEM GROUP 1947 -- 1949 -- ####### 1951 -- 1952 -- The CM MAC Table 1953 -- 1955 docsIfCmMacTable OBJECT-TYPE 1956 SYNTAX SEQUENCE OF DocsIfCmMacEntry 1957 MAX-ACCESS not-accessible 1958 STATUS current 1959 DESCRIPTION 1960 "Describes the attributes of each CM MAC interface, 1961 extending the information available from ifEntry." 1962 ::= { docsIfCmObjects 1 } 1964 docsIfCmMacEntry OBJECT-TYPE 1965 SYNTAX DocsIfCmMacEntry 1966 MAX-ACCESS not-accessible 1967 STATUS current 1968 DESCRIPTION 1969 "An entry containing objects describing attributes of 1970 each MAC entry, extending the information in ifEntry. 1971 An entry in this table exists for each ifEntry with an 1972 ifType of docsCableMaclayer(127)." 1973 INDEX { ifIndex } 1974 ::= { docsIfCmMacTable 1 } 1976 DocsIfCmMacEntry ::= SEQUENCE { 1977 docsIfCmCmtsAddress MacAddress, 1978 docsIfCmCapabilities BITS, 1979 docsIfCmRangingRespTimeout TimeTicks, 1980 docsIfCmRangingTimeout TimeInterval 1981 } 1983 docsIfCmCmtsAddress OBJECT-TYPE 1984 SYNTAX MacAddress 1985 MAX-ACCESS read-only 1986 STATUS current 1987 DESCRIPTION 1988 "Identifies the CMTS that is believed to control this MAC 1989 domain. At the CM, this will be the source address from 1990 SYNC, MAP, and other MAC-layer messages. If the CMTS is 1991 unknown, returns 00-00-00-00-00-00." 1992 REFERENCE 1993 "Document [25] from References, Section 8.2.2." 1994 ::= { docsIfCmMacEntry 1 } 1996 docsIfCmCapabilities OBJECT-TYPE 1997 SYNTAX BITS { 1998 atmCells(0), 1999 concatenation(1) 2000 } 2001 MAX-ACCESS read-only 2002 STATUS current 2003 DESCRIPTION 2004 "Identifies the capabilities of the MAC implementation 2005 at this interface. Note that packet transmission is 2006 always supported. Therefore, there is no specific bit 2007 required to explicitly indicate this capability. 2008 Note that BITS objects are encoded most significant bit 2009 first. For example, if bit 1 is set, the value of this 2010 object is the octet string '40'H." 2011 ::= { docsIfCmMacEntry 2 } 2013 -- This object has been obsoleted and replaced by 2014 -- docsIfCmRangingTimeout to correct the typing to TimeInterval. New 2015 -- implementations of the MIB should use docsIfCmRangingTimeout instead. 2017 docsIfCmRangingRespTimeout OBJECT-TYPE 2018 SYNTAX TimeTicks 2019 MAX-ACCESS read-write 2020 STATUS obsolete 2021 DESCRIPTION 2022 "Waiting time for a Ranging Response packet." 2023 REFERENCE 2024 "Document [25] from References, Section 9.1.6." 2025 DEFVAL { 20 } 2026 ::= { docsIfCmMacEntry 3 } 2028 docsIfCmRangingTimeout OBJECT-TYPE 2029 SYNTAX TimeInterval 2030 MAX-ACCESS read-write 2031 STATUS current 2032 DESCRIPTION 2033 "Waiting time for a Ranging Response packet." 2034 REFERENCE 2035 "Document [25] from References, 2036 Section 9.1.6, timer T3." 2037 DEFVAL { 20 } 2038 ::= { docsIfCmMacEntry 4 } 2040 -- 2041 -- CM status table. 2043 -- This table is implemented only at the CM. 2044 -- 2046 docsIfCmStatusTable OBJECT-TYPE 2047 SYNTAX SEQUENCE OF DocsIfCmStatusEntry 2048 MAX-ACCESS not-accessible 2049 STATUS current 2050 DESCRIPTION 2051 "This table maintains a number of status objects 2052 and counters for Cable Modems." 2053 ::= { docsIfCmObjects 2 } 2055 docsIfCmStatusEntry OBJECT-TYPE 2056 SYNTAX DocsIfCmStatusEntry 2057 MAX-ACCESS not-accessible 2058 STATUS current 2059 DESCRIPTION 2060 "A set of status objects and counters for a single MAC 2061 layer instance in a Cable Modem. 2062 An entry in this table exists for each ifEntry with an 2063 ifType of docsCableMaclayer(127)." 2064 INDEX { ifIndex } 2065 ::= { docsIfCmStatusTable 1 } 2067 DocsIfCmStatusEntry ::= SEQUENCE { 2068 docsIfCmStatusValue INTEGER, 2069 docsIfCmStatusCode OCTET STRING, 2070 docsIfCmStatusTxPower TenthdBmV, 2071 docsIfCmStatusResets Counter32, 2072 docsIfCmStatusLostSyncs Counter32, 2073 docsIfCmStatusInvalidMaps Counter32, 2074 docsIfCmStatusInvalidUcds Counter32, 2075 docsIfCmStatusInvalidRangingResponses Counter32, 2076 docsIfCmStatusInvalidRegistrationResponses Counter32, 2077 docsIfCmStatusT1Timeouts Counter32, 2078 docsIfCmStatusT2Timeouts Counter32, 2079 docsIfCmStatusT3Timeouts Counter32, 2080 docsIfCmStatusT4Timeouts Counter32, 2081 docsIfCmStatusRangingAborteds Counter32, 2082 docsIfCmStatusDocsisOperMode DocsisQosVersion, 2083 docsIfCmStatusModulationType DocsisUpstreamType 2084 } 2086 docsIfCmStatusValue OBJECT-TYPE 2087 SYNTAX INTEGER { 2088 other(1), 2089 notReady(2), 2090 notSynchronized(3), 2091 phySynchronized(4), 2092 usParametersAcquired(5), 2093 rangingComplete(6), 2094 ipComplete(7), 2095 todEstablished(8), 2096 securityEstablished(9), 2097 paramTransferComplete(10), 2098 registrationComplete(11), 2099 operational(12), 2100 accessDenied(13) 2101 } 2102 MAX-ACCESS read-only 2103 STATUS current 2104 DESCRIPTION 2105 "Current Cable Modem connectivity state, as specified 2106 in the RF Interface Specification." 2107 REFERENCE 2108 "Document [25] from References, Section 11.2." 2109 ::= { docsIfCmStatusEntry 1 } 2111 docsIfCmStatusCode OBJECT-TYPE 2112 SYNTAX OCTET STRING 2113 MAX-ACCESS read-only 2114 STATUS current 2115 DESCRIPTION 2116 "Status code for this Cable Modem as defined in the 2117 RF Interface Specification. The status code consists 2118 of a single character indicating error groups, followed 2119 by a two- or three-digit number indicating the status 2120 condition." 2121 REFERENCE 2122 "Document [26] from References, Appendix F." 2123 ::= { docsIfCmStatusEntry 2 } 2125 docsIfCmStatusTxPower OBJECT-TYPE 2126 SYNTAX TenthdBmV 2127 UNITS "dBmV" 2128 MAX-ACCESS read-only 2129 STATUS current 2130 DESCRIPTION 2131 "The operational transmit power for the attached upstream 2132 channel." 2133 REFERENCE 2134 "Document [25] from References, Section 6.2.18." 2135 ::= { docsIfCmStatusEntry 3 } 2137 docsIfCmStatusResets OBJECT-TYPE 2138 SYNTAX Counter32 2139 MAX-ACCESS read-only 2140 STATUS current 2141 DESCRIPTION 2142 "Number of times the CM reset or initialized this interface." 2143 ::= { docsIfCmStatusEntry 4 } 2145 docsIfCmStatusLostSyncs OBJECT-TYPE 2146 SYNTAX Counter32 2147 MAX-ACCESS read-only 2148 STATUS current 2149 DESCRIPTION 2150 "Number of times the CM lost synchronization with 2151 the downstream channel." 2152 REFERENCE 2153 "Document [25] from References, Section 8.3.2." 2154 ::= { docsIfCmStatusEntry 5 } 2156 docsIfCmStatusInvalidMaps OBJECT-TYPE 2157 SYNTAX Counter32 2158 MAX-ACCESS read-only 2159 STATUS current 2160 DESCRIPTION 2161 "Number of times the CM received invalid MAP messages." 2162 REFERENCE 2163 "Document [25] from References, Section 8.3.4." 2164 ::= { docsIfCmStatusEntry 6 } 2166 docsIfCmStatusInvalidUcds OBJECT-TYPE 2167 SYNTAX Counter32 2168 MAX-ACCESS read-only 2169 STATUS current 2170 DESCRIPTION 2171 "Number of times the CM received invalid UCD messages." 2172 REFERENCE 2173 "Document [25] from References, Section 8.3.3." 2174 ::= { docsIfCmStatusEntry 7 } 2176 docsIfCmStatusInvalidRangingResponses OBJECT-TYPE 2177 SYNTAX Counter32 2178 MAX-ACCESS read-only 2179 STATUS current 2180 DESCRIPTION 2181 "Number of times the CM received invalid ranging response 2182 messages." 2183 REFERENCE 2184 "Document [25] from References, Section 8.3.6." 2185 ::= { docsIfCmStatusEntry 8 } 2187 docsIfCmStatusInvalidRegistrationResponses OBJECT-TYPE 2188 SYNTAX Counter32 2189 MAX-ACCESS read-only 2190 STATUS current 2191 DESCRIPTION 2192 "Number of times the CM received invalid registration 2193 response messages." 2194 REFERENCE 2195 "Document [25] from References, Section 8.3.8." 2196 ::= { docsIfCmStatusEntry 9 } 2198 docsIfCmStatusT1Timeouts OBJECT-TYPE 2199 SYNTAX Counter32 2200 MAX-ACCESS read-only 2201 STATUS current 2202 DESCRIPTION 2203 "Number of times counter T1 expired in the CM." 2204 REFERENCE 2205 "Document [25] from References, Figure 9-2." 2206 ::= { docsIfCmStatusEntry 10 } 2208 docsIfCmStatusT2Timeouts OBJECT-TYPE 2209 SYNTAX Counter32 2210 MAX-ACCESS read-only 2211 STATUS current 2212 DESCRIPTION 2213 "Number of times counter T2 expired in the CM." 2214 REFERENCE 2215 "Document [25] from References, Figure 9-2." 2216 ::= { docsIfCmStatusEntry 11 } 2218 docsIfCmStatusT3Timeouts OBJECT-TYPE 2219 SYNTAX Counter32 2220 MAX-ACCESS read-only 2221 STATUS current 2222 DESCRIPTION 2223 "Number of times counter T3 expired in the CM." 2224 REFERENCE 2225 "Document [25] from References, Figure 9-2." 2226 ::= { docsIfCmStatusEntry 12 } 2228 docsIfCmStatusT4Timeouts OBJECT-TYPE 2229 SYNTAX Counter32 2230 MAX-ACCESS read-only 2231 STATUS current 2232 DESCRIPTION 2233 "Number of times counter T4 expired in the CM." 2234 REFERENCE 2235 "Document [25] from References, Figure 9-2." 2236 ::= { docsIfCmStatusEntry 13 } 2238 docsIfCmStatusRangingAborteds OBJECT-TYPE 2239 SYNTAX Counter32 2240 MAX-ACCESS read-only 2241 STATUS current 2242 DESCRIPTION 2243 "Number of times the ranging process was aborted 2244 by the CMTS." 2245 REFERENCE 2246 "Document [25] from References, Section 9.3.3." 2247 ::= { docsIfCmStatusEntry 14 } 2249 docsIfCmStatusDocsisOperMode OBJECT-TYPE 2250 SYNTAX DocsisQosVersion 2251 MAX-ACCESS read-only 2252 STATUS current 2253 DESCRIPTION 2254 "Indication whether the device has registered using 1.0 Class of 2255 Service or 1.1 Quality of Service. 2256 An unregistered CM should indicate 1.1 QOS for a 2257 docsIfDocsisBaseCapability value of Docsis 1.1/2.0. An unregistered 2258 CM should indicate 1.0 COS for a docsIfDocsisBaseCapability value 2259 of Docsis 1.0. 2260 This object mirrors docsIfCmDocsisOperMode from the docsIfExt mib." 2261 REFERENCE 2262 "Document [25] from References, Annex G." 2263 ::= { docsIfCmStatusEntry 15 } 2265 docsIfCmStatusModulationType OBJECT-TYPE 2266 SYNTAX DocsisUpstreamType 2267 MAX-ACCESS read-only 2268 STATUS current 2269 DESCRIPTION 2270 "Indicates modulation type currently used by the CM." 2271 REFERENCE 2272 "Document [25] from References, Section 6.2.1." 2274 ::= { docsIfCmStatusEntry 16 } 2276 -- 2277 -- The Cable Modem Service Table 2278 -- 2280 docsIfCmServiceTable OBJECT-TYPE 2281 SYNTAX SEQUENCE OF DocsIfCmServiceEntry 2282 MAX-ACCESS not-accessible 2283 STATUS current 2284 DESCRIPTION 2285 "Describes the attributes of each upstream service queue 2286 on a CM." 2287 ::= { docsIfCmObjects 3 } 2289 docsIfCmServiceEntry OBJECT-TYPE 2290 SYNTAX DocsIfCmServiceEntry 2291 MAX-ACCESS not-accessible 2292 STATUS current 2293 DESCRIPTION 2294 "Describes the attributes of an upstream bandwidth service 2295 queue. 2296 An entry in this table exists for each Service ID. 2297 The primary index is an ifIndex with an ifType of 2298 docsCableMaclayer(127)." 2299 INDEX { ifIndex, docsIfCmServiceId } 2300 ::= { docsIfCmServiceTable 1 } 2302 DocsIfCmServiceEntry ::= SEQUENCE { 2303 docsIfCmServiceId Integer32, 2304 docsIfCmServiceQosProfile Integer32, 2305 docsIfCmServiceTxSlotsImmed Counter32, 2306 docsIfCmServiceTxSlotsDed Counter32, 2307 docsIfCmServiceTxRetries Counter32, 2308 docsIfCmServiceTxExceededs Counter32, 2309 docsIfCmServiceRqRetries Counter32, 2310 docsIfCmServiceRqExceededs Counter32, 2311 docsIfCmServiceExtTxSlotsImmed Counter64, 2312 docsIfCmServiceExtTxSlotsDed Counter64 2313 } 2315 docsIfCmServiceId OBJECT-TYPE 2316 SYNTAX Integer32 (1..16383) 2317 MAX-ACCESS not-accessible 2318 STATUS current 2319 DESCRIPTION 2320 "Identifies a service queue for upstream bandwidth. The 2321 attributes of this service queue are shared between the 2322 CM and the CMTS. The CMTS allocates upstream bandwidth 2323 to this service queue based on requests from the CM and 2324 on the class of service associated with this queue." 2325 ::= { docsIfCmServiceEntry 1 } 2327 docsIfCmServiceQosProfile OBJECT-TYPE 2328 SYNTAX Integer32 (0..16383) 2329 MAX-ACCESS read-only 2330 STATUS current 2331 DESCRIPTION 2332 "The index in docsIfQosProfileTable describing the quality 2333 of service attributes associated with this particular 2334 service. If no associated entry in docsIfQosProfileTable 2335 exists, this object returns a value of zero." 2336 ::= { docsIfCmServiceEntry 2 } 2338 docsIfCmServiceTxSlotsImmed OBJECT-TYPE 2339 SYNTAX Counter32 2340 MAX-ACCESS read-only 2341 STATUS current 2342 DESCRIPTION 2343 "The number of upstream mini-slots which have been used to 2344 transmit data PDUs in immediate (contention) mode. This 2345 includes only those PDUs that are presumed to have 2346 arrived at the headend (i.e., those which were explicitly 2347 acknowledged.) It does not include retransmission attempts 2348 or mini-slots used by Requests." 2349 REFERENCE 2350 "Document [25] from References, Section 9.4." 2351 ::= { docsIfCmServiceEntry 3 } 2353 docsIfCmServiceTxSlotsDed OBJECT-TYPE 2354 SYNTAX Counter32 2355 MAX-ACCESS read-only 2356 STATUS current 2357 DESCRIPTION 2358 "The number of upstream mini-slots which have been used to 2359 transmit data PDUs in dedicated mode (i.e., as a result 2360 of a unicast Data Grant)." 2361 REFERENCE 2362 "Document [25] from References, Section 9.4." 2363 ::= { docsIfCmServiceEntry 4 } 2365 docsIfCmServiceTxRetries OBJECT-TYPE 2366 SYNTAX Counter32 2367 MAX-ACCESS read-only 2368 STATUS current 2369 DESCRIPTION 2370 "The number of attempts to transmit data PDUs containing 2371 requests for acknowledgment that did not result in 2372 acknowledgment." 2373 REFERENCE 2374 "Document [25] from References, Section 9.4." 2375 ::= { docsIfCmServiceEntry 5 } 2377 docsIfCmServiceTxExceededs OBJECT-TYPE 2378 SYNTAX Counter32 2379 MAX-ACCESS read-only 2380 STATUS current 2381 DESCRIPTION 2382 "The number of data PDUs transmission failures due to 2383 excessive retries without acknowledgment." 2384 REFERENCE 2385 "Document [25] from References, Section 9.4." 2386 ::= { docsIfCmServiceEntry 6 } 2388 docsIfCmServiceRqRetries OBJECT-TYPE 2389 SYNTAX Counter32 2390 MAX-ACCESS read-only 2391 STATUS current 2392 DESCRIPTION 2393 "The number of attempts to transmit bandwidth requests 2394 which did not result in acknowledgment." 2395 REFERENCE 2396 "Document [25] from References, Section 9.4." 2397 ::= { docsIfCmServiceEntry 7 } 2399 docsIfCmServiceRqExceededs OBJECT-TYPE 2400 SYNTAX Counter32 2401 MAX-ACCESS read-only 2402 STATUS current 2403 DESCRIPTION 2404 "The number of requests for bandwidth which failed due to 2405 excessive retries without acknowledgment." 2406 REFERENCE 2407 "Document [25] from References, Section 9.4." 2408 ::= { docsIfCmServiceEntry 8 } 2410 docsIfCmServiceExtTxSlotsImmed OBJECT-TYPE 2411 SYNTAX Counter64 2412 MAX-ACCESS read-only 2413 STATUS current 2414 DESCRIPTION 2415 "The number of upstream mini-slots which have been used to 2416 transmit data PDUs in immediate (contention) mode. This 2417 includes only those PDUs that are presumed to have 2418 arrived at the headend (i.e., those which were explicitly 2419 acknowledged.) It does not include retransmission attempts 2420 or mini-slots used by Requests." 2421 REFERENCE 2422 "Document [25] from References, Section 9.4." 2423 ::= { docsIfCmServiceEntry 9 } 2425 docsIfCmServiceExtTxSlotsDed OBJECT-TYPE 2426 SYNTAX Counter64 2427 MAX-ACCESS read-only 2428 STATUS current 2429 DESCRIPTION 2430 "The number of upstream mini-slots which have been used to 2431 transmit data PDUs in dedicated mode (i.e., as a result 2432 of a unicast Data Grant)." 2433 REFERENCE 2434 "Document [25] from References, Section 9.4." 2435 ::= { docsIfCmServiceEntry 10 } 2437 -- 2438 -- CMTS GROUP 2439 -- 2441 -- 2442 -- The CMTS MAC Table 2443 -- 2445 docsIfCmtsMacTable OBJECT-TYPE 2446 SYNTAX SEQUENCE OF DocsIfCmtsMacEntry 2447 MAX-ACCESS not-accessible 2448 STATUS current 2449 DESCRIPTION 2450 "Describes the attributes of each CMTS MAC interface, 2451 extending the information available from ifEntry. 2452 Mandatory for all CMTS devices." 2453 ::= { docsIfCmtsObjects 1 } 2455 docsIfCmtsMacEntry OBJECT-TYPE 2456 SYNTAX DocsIfCmtsMacEntry 2457 MAX-ACCESS not-accessible 2458 STATUS current 2459 DESCRIPTION 2460 "An entry containing objects describing attributes of each 2461 MAC entry, extending the information in ifEntry. 2462 An entry in this table exists for each ifEntry with an 2463 ifType of docsCableMaclayer(127)." 2464 INDEX { ifIndex } 2465 ::= { docsIfCmtsMacTable 1 } 2467 DocsIfCmtsMacEntry ::= SEQUENCE { 2468 docsIfCmtsCapabilities BITS, 2469 docsIfCmtsSyncInterval Integer32, 2470 docsIfCmtsUcdInterval Integer32, 2471 docsIfCmtsMaxServiceIds Integer32, 2472 docsIfCmtsInsertionInterval TimeTicks, -- Obsolete 2473 docsIfCmtsInvitedRangingAttempts Integer32, 2474 docsIfCmtsInsertInterval TimeInterval 2475 } 2477 docsIfCmtsCapabilities OBJECT-TYPE 2478 SYNTAX BITS { 2479 atmCells(0), 2480 concatenation(1) 2481 } 2482 MAX-ACCESS read-only 2483 STATUS current 2484 DESCRIPTION 2485 "Identifies the capabilities of the CMTS MAC 2486 implementation at this interface. Note that packet 2487 transmission is always supported. Therefore, there 2488 is no specific bit required to explicitly indicate 2489 this capability. 2490 Note that BITS objects are encoded most significant bit 2491 first. For example, if bit 1 is set, the value of this 2492 object is the octet string '40'H." 2493 ::= { docsIfCmtsMacEntry 1 } 2495 docsIfCmtsSyncInterval OBJECT-TYPE 2496 SYNTAX Integer32 (1..200) 2497 UNITS "Milliseconds" 2498 MAX-ACCESS read-write 2499 STATUS current 2500 DESCRIPTION 2501 "The interval between CMTS transmission of successive SYNC 2502 messages at this interface." 2503 REFERENCE 2504 "Document [25] from References, Section 9.3." 2506 ::= { docsIfCmtsMacEntry 2 } 2508 docsIfCmtsUcdInterval OBJECT-TYPE 2509 SYNTAX Integer32 (1..2000) 2510 UNITS "Milliseconds" 2511 MAX-ACCESS read-write 2512 STATUS current 2513 DESCRIPTION 2514 "The interval between CMTS transmission of successive 2515 Upstream Channel Descriptor messages for each upstream 2516 channel at this interface." 2517 REFERENCE 2518 "Document [25] from References, Section 9.3" 2519 ::= { docsIfCmtsMacEntry 3 } 2521 docsIfCmtsMaxServiceIds OBJECT-TYPE 2522 SYNTAX Integer32 (1..16383) 2523 MAX-ACCESS read-only 2524 STATUS current 2525 DESCRIPTION 2526 "The maximum number of service IDs that may be 2527 simultaneously active." 2528 ::= { docsIfCmtsMacEntry 4 } 2530 -- This object has been obsoleted and replaced by 2531 -- docsIfCmtsInsertInterval to fix a SYNTAX typing problem. New 2532 -- implementations of this MIB should use that object instead. 2533 docsIfCmtsInsertionInterval OBJECT-TYPE 2534 SYNTAX TimeTicks 2535 MAX-ACCESS read-write 2536 STATUS obsolete 2537 DESCRIPTION 2538 "The amount of time to elapse between each broadcast 2539 station maintenance grant. Broadcast station maintenance 2540 grants are used to allow new cable modems to join the 2541 network. Zero indicates that a vendor-specific algorithm 2542 is used instead of a fixed time. Maximum amount of time 2543 permitted by the specification is 2 seconds." 2544 REFERENCE 2545 "Document [25] from References, Annex B." 2546 ::= { docsIfCmtsMacEntry 5 } 2548 docsIfCmtsInvitedRangingAttempts OBJECT-TYPE 2549 SYNTAX Integer32 (0..1024) 2550 MAX-ACCESS read-write 2551 STATUS current 2552 DESCRIPTION 2553 "The maximum number of attempts to make on invitations 2554 for ranging requests. A value of zero means the system 2555 should attempt to range forever." 2556 REFERENCE 2557 "Document [25] from References, Section 9.3.3 and Annex B." 2559 ::= { docsIfCmtsMacEntry 6 } 2561 docsIfCmtsInsertInterval OBJECT-TYPE 2562 SYNTAX TimeInterval 2563 MAX-ACCESS read-write 2564 STATUS current 2565 DESCRIPTION 2566 "The amount of time to elapse between each broadcast 2567 station maintenance grant. Broadcast station maintenance 2568 grants are used to allow new cable modems to join the 2569 network. Zero indicates that a vendor-specific algorithm 2570 is used instead of a fixed time. Maximum amount of time 2571 permitted by the specification is 2 seconds." 2572 REFERENCE 2573 "Document [25] from References, Annex B." 2574 ::= { docsIfCmtsMacEntry 7 } 2576 -- 2577 -- 2578 -- CMTS status table. 2579 -- 2581 docsIfCmtsStatusTable OBJECT-TYPE 2582 SYNTAX SEQUENCE OF DocsIfCmtsStatusEntry 2583 MAX-ACCESS not-accessible 2584 STATUS current 2585 DESCRIPTION 2586 "For the MAC layer, this group maintains a number of 2587 status objects and counters." 2588 ::= { docsIfCmtsObjects 2 } 2590 docsIfCmtsStatusEntry OBJECT-TYPE 2591 SYNTAX DocsIfCmtsStatusEntry 2592 MAX-ACCESS not-accessible 2593 STATUS current 2594 DESCRIPTION 2595 "Status entry for a single MAC layer. 2596 An entry in this table exists for each ifEntry with an 2597 ifType of docsCableMaclayer(127)." 2598 INDEX { ifIndex } 2599 ::= { docsIfCmtsStatusTable 1 } 2601 DocsIfCmtsStatusEntry ::= SEQUENCE { 2602 docsIfCmtsStatusInvalidRangeReqs Counter32, 2603 docsIfCmtsStatusRangingAborteds Counter32, 2604 docsIfCmtsStatusInvalidRegReqs Counter32, 2605 docsIfCmtsStatusFailedRegReqs Counter32, 2606 docsIfCmtsStatusInvalidDataReqs Counter32, 2607 docsIfCmtsStatusT5Timeouts Counter32 2608 } 2610 docsIfCmtsStatusInvalidRangeReqs OBJECT-TYPE 2611 SYNTAX Counter32 2612 MAX-ACCESS read-only 2613 STATUS current 2614 DESCRIPTION 2615 "This object counts invalid RNG-REQ messages received on 2616 this interface." 2617 REFERENCE 2618 "Document [25] from References, Section 8.3.5." 2620 ::= { docsIfCmtsStatusEntry 1 } 2622 docsIfCmtsStatusRangingAborteds OBJECT-TYPE 2623 SYNTAX Counter32 2624 MAX-ACCESS read-only 2625 STATUS current 2626 DESCRIPTION 2627 "This object counts ranging attempts that were explicitly 2628 aborted by the CMTS." 2629 REFERENCE 2630 "Document [25] from References, Section 8.3.6." 2631 ::= { docsIfCmtsStatusEntry 2 } 2633 docsIfCmtsStatusInvalidRegReqs OBJECT-TYPE 2634 SYNTAX Counter32 2635 MAX-ACCESS read-only 2636 STATUS current 2637 DESCRIPTION 2638 "This object counts invalid REG-REQ messages received on 2639 this interface. Invalid REG-REQ messages are rejected due 2640 to syntax or authentication errors." 2641 REFERENCE 2642 "Document [25] from References, Section 8.3.7." 2643 ::= { docsIfCmtsStatusEntry 3 } 2645 docsIfCmtsStatusFailedRegReqs OBJECT-TYPE 2646 SYNTAX Counter32 2647 MAX-ACCESS read-only 2648 STATUS current 2649 DESCRIPTION 2650 "This object counts failed registration attempts, i.e., 2651 erroneous confirmation codes or response codes." 2652 REFERENCE 2653 "Document [25] from References, Section 8.3.7." 2654 ::= { docsIfCmtsStatusEntry 4 } 2656 docsIfCmtsStatusInvalidDataReqs OBJECT-TYPE 2657 SYNTAX Counter32 2658 MAX-ACCESS read-only 2659 STATUS current 2660 DESCRIPTION 2661 "This object counts invalid data request messages 2662 received on this interface." 2663 ::= { docsIfCmtsStatusEntry 5 } 2665 docsIfCmtsStatusT5Timeouts OBJECT-TYPE 2666 SYNTAX Counter32 2667 MAX-ACCESS read-only 2668 STATUS current 2669 DESCRIPTION 2670 "This object counts the number of times counter T5 2671 expired on this interface." 2672 REFERENCE 2673 "Document [25] from References, Figure 9-2." 2674 ::= { docsIfCmtsStatusEntry 6 } 2676 -- 2677 -- CM status table (within CMTS). 2678 -- This table is implemented only at the CMTS. 2679 -- It contains per CM status information available in the CMTS. 2680 -- 2682 docsIfCmtsCmStatusTable OBJECT-TYPE 2683 SYNTAX SEQUENCE OF DocsIfCmtsCmStatusEntry 2684 MAX-ACCESS not-accessible 2685 STATUS current 2686 DESCRIPTION 2687 "A set of objects in the CMTS, maintained for each 2688 Cable Modem connected to this CMTS." 2689 ::= { docsIfCmtsObjects 3 } 2691 docsIfCmtsCmStatusEntry OBJECT-TYPE 2692 SYNTAX DocsIfCmtsCmStatusEntry 2693 MAX-ACCESS not-accessible 2694 STATUS current 2695 DESCRIPTION 2696 "Status information for a single Cable Modem. 2697 An entry in this table exists for each Cable Modem 2698 that is connected to the CMTS implementing this table." 2699 INDEX { docsIfCmtsCmStatusIndex } 2700 ::= { docsIfCmtsCmStatusTable 1 } 2702 DocsIfCmtsCmStatusEntry ::= SEQUENCE { 2703 docsIfCmtsCmStatusIndex Integer32, 2704 docsIfCmtsCmStatusMacAddress MacAddress, 2705 docsIfCmtsCmStatusIpAddress IpAddress, -- Deprecated 2706 docsIfCmtsCmStatusDownChannelIfIndex InterfaceIndexOrZero, 2707 docsIfCmtsCmStatusUpChannelIfIndex InterfaceIndexOrZero, 2708 docsIfCmtsCmStatusRxPower TenthdBmV, 2709 docsIfCmtsCmStatusTimingOffset Unsigned32, 2710 docsIfCmtsCmStatusEqualizationData OCTET STRING, 2711 docsIfCmtsCmStatusValue INTEGER, 2712 docsIfCmtsCmStatusUnerroreds Counter32, 2713 docsIfCmtsCmStatusCorrecteds Counter32, 2714 docsIfCmtsCmStatusUncorrectables Counter32, 2715 docsIfCmtsCmStatusSignalNoise TenthdB, 2716 docsIfCmtsCmStatusMicroreflections Integer32, 2717 docsIfCmtsCmStatusExtUnerroreds Counter64, 2718 docsIfCmtsCmStatusExtCorrecteds Counter64, 2719 docsIfCmtsCmStatusExtUncorrectables Counter64, 2720 docsIfCmtsCmStatusDocsisRegMode DocsisQosVersion, 2721 docsIfCmtsCmStatusModulationType DocsisUpstreamType, 2722 docsIfCmtsCmStatusInetAddressType InetAddressType, 2723 docsIfCmtsCmStatusInetAddress InetAddress 2724 } 2726 docsIfCmtsCmStatusIndex OBJECT-TYPE 2727 SYNTAX Integer32 (1..2147483647) 2728 MAX-ACCESS not-accessible 2729 STATUS current 2730 DESCRIPTION 2731 "Index value to uniquely identify an entry in this table. 2732 For an individual Cable Modem, this index value should 2733 not change during CMTS uptime." 2734 ::= { docsIfCmtsCmStatusEntry 1 } 2736 docsIfCmtsCmStatusMacAddress OBJECT-TYPE 2737 SYNTAX MacAddress 2738 MAX-ACCESS read-only 2739 STATUS current 2740 DESCRIPTION 2741 "MAC address of this Cable Modem. If the Cable Modem has 2742 multiple MAC addresses, this is the MAC address associated 2743 with the Cable interface." 2744 REFERENCE 2745 "Document [25] from References, Section 8.2.2." 2746 ::= { docsIfCmtsCmStatusEntry 2 } 2748 docsIfCmtsCmStatusIpAddress OBJECT-TYPE 2749 SYNTAX IpAddress 2750 MAX-ACCESS read-only 2751 STATUS deprecated 2752 DESCRIPTION 2753 "IP address of this Cable Modem. If the Cable Modem has no 2754 IP address assigned, or the IP address is unknown, this 2755 object returns a value of 0.0.0.0. If the Cable Modem has 2756 multiple IP addresses, this object returns the IP address 2757 associated with the Cable interface.n 2758 This object has been deprecated and replaced by 2759 docsIfCmtsCmStatusInetAddressType and 2760 docsIfCmtsCmStatusInetAddress, to enable IPv6 addressing 2761 in the future." 2762 ::= { docsIfCmtsCmStatusEntry 3 } 2764 docsIfCmtsCmStatusDownChannelIfIndex OBJECT-TYPE 2765 SYNTAX InterfaceIndexOrZero 2766 MAX-ACCESS read-only 2767 STATUS current 2768 DESCRIPTION 2769 "IfIndex of the downstream channel this CM is connected 2770 to. If the downstream channel is unknown, this object 2771 returns a value of zero." 2772 ::= { docsIfCmtsCmStatusEntry 4 } 2774 docsIfCmtsCmStatusUpChannelIfIndex OBJECT-TYPE 2775 SYNTAX InterfaceIndexOrZero 2776 MAX-ACCESS read-only 2777 STATUS current 2778 DESCRIPTION 2779 "IfIndex of the upstream channel this CM is connected 2780 to. If the upstream channel is unknown, this object 2781 returns a value of zero." 2782 ::= { docsIfCmtsCmStatusEntry 5 } 2784 docsIfCmtsCmStatusRxPower OBJECT-TYPE 2785 SYNTAX TenthdBmV 2786 UNITS "dBmV" 2787 MAX-ACCESS read-only 2788 STATUS current 2789 DESCRIPTION 2790 "The receive power as perceived for upstream data from 2791 this Cable Modem. 2792 If the receive power is unknown, this object returns 2793 a value of zero." 2794 REFERENCE 2795 "Document [25] from References, Table 6-11." 2796 ::= { docsIfCmtsCmStatusEntry 6 } 2798 docsIfCmtsCmStatusTimingOffset OBJECT-TYPE 2799 SYNTAX Unsigned32 2800 MAX-ACCESS read-only 2801 STATUS current 2802 DESCRIPTION 2803 "A measure of the current round trip time for this CM. 2804 Used for timing of CM upstream transmissions to ensure 2805 synchronized arrivals at the CMTS. Units are in terms 2806 of 6.25 microseconds/(64*256). Returns zero if the value 2807 is unknown." 2808 REFERENCE 2809 "Document [25] from References, Section 6.2.18." 2810 ::= { docsIfCmtsCmStatusEntry 7 } 2812 docsIfCmtsCmStatusEqualizationData OBJECT-TYPE 2813 SYNTAX OCTET STRING 2814 MAX-ACCESS read-only 2815 STATUS current 2816 DESCRIPTION 2817 "Equalization data for this CM. Returns an empty string 2818 if the value is unknown or if there is no equalization 2819 data available or defined." 2820 REFERENCE 2821 "Document [25] from References, Figure 8-23." 2822 ::= { docsIfCmtsCmStatusEntry 8 } 2824 docsIfCmtsCmStatusValue OBJECT-TYPE 2825 SYNTAX INTEGER { 2826 other(1), 2827 ranging(2), 2828 rangingAborted(3), 2829 rangingComplete(4), 2830 ipComplete(5), 2831 registrationComplete(6), 2832 accessDenied(7) 2833 } 2834 MAX-ACCESS read-only 2835 STATUS current 2836 DESCRIPTION 2837 "Current Cable Modem connectivity state, as specified 2838 in the RF Interface Specification. Returned status 2839 information is the CM status as assumed by the CMTS, 2840 and indicates the following events: 2841 other(1) 2842 Any state other than below. 2843 ranging(2) 2844 The CMTS has received an Initial Ranging Request 2845 message from the CM, and the ranging process is not 2846 yet complete. 2847 rangingAborted(3) 2848 The CMTS has sent a Ranging Abort message to the CM. 2849 rangingComplete(4) 2850 The CMTS has sent a Ranging Complete message to the CM. 2851 ipComplete(5) 2852 The CMTS has received a DHCP reply message and forwarded 2853 it to the CM. 2854 registrationComplete(6) 2855 The CMTS has sent a Registration Response message to 2856 the CM. 2857 accessDenied(7) 2858 The CMTS has sent a Registration Aborted message 2859 to the CM. 2860 The CMTS only needs to report states it is able to detect." 2861 REFERENCE 2862 "Document [25] from References, Section 11.2." 2863 ::= { docsIfCmtsCmStatusEntry 9 } 2865 docsIfCmtsCmStatusUnerroreds OBJECT-TYPE 2866 SYNTAX Counter32 2867 MAX-ACCESS read-only 2868 STATUS current 2869 DESCRIPTION 2870 "Codewords received without error from this Cable Modem." 2871 REFERENCE 2872 "Document [25] from References, Section 6.2.5." 2873 ::= { docsIfCmtsCmStatusEntry 10 } 2875 docsIfCmtsCmStatusCorrecteds OBJECT-TYPE 2876 SYNTAX Counter32 2877 MAX-ACCESS read-only 2878 STATUS current 2879 DESCRIPTION 2880 "Codewords received with correctable errors from this 2881 Cable Modem." 2882 REFERENCE 2883 "Document [25] from References, Section 6.2.5." 2884 ::= { docsIfCmtsCmStatusEntry 11 } 2886 docsIfCmtsCmStatusUncorrectables OBJECT-TYPE 2887 SYNTAX Counter32 2888 MAX-ACCESS read-only 2889 STATUS current 2890 DESCRIPTION 2891 "Codewords received with uncorrectable errors from this 2892 Cable Modem." 2893 REFERENCE 2894 "Document [25] from References, Section 6.2.5." 2895 ::= { docsIfCmtsCmStatusEntry 12 } 2897 docsIfCmtsCmStatusSignalNoise OBJECT-TYPE 2898 SYNTAX TenthdB 2899 UNITS "dB" 2900 MAX-ACCESS read-only 2901 STATUS current 2902 DESCRIPTION 2903 "Signal/Noise ratio as perceived for upstream data from 2904 this Cable Modem. 2905 If the Signal/Noise is unknown, this object returns 2906 a value of zero." 2907 REFERENCE 2908 "Document [25] from References, Tables 4-1 and 4-2." 2909 ::= { docsIfCmtsCmStatusEntry 13 } 2911 docsIfCmtsCmStatusMicroreflections OBJECT-TYPE 2912 SYNTAX Integer32 (0..255) 2913 UNITS "dBc" 2914 MAX-ACCESS read-only 2915 STATUS current 2916 DESCRIPTION 2917 "Total microreflections including in-channel response 2918 as perceived on this interface, measured in dBc below 2919 the signal level. 2920 This object is not assumed to return an absolutely 2921 accurate value, but should give a rough indication 2922 of microreflections received on this interface. 2923 It is up to the implementer to provide information 2924 as accurate as possible." 2925 REFERENCE 2926 "Document [25] from References, Tables 4-1 and 4-2" 2927 ::= { docsIfCmtsCmStatusEntry 14 } 2929 docsIfCmtsCmStatusExtUnerroreds OBJECT-TYPE 2930 SYNTAX Counter64 2931 MAX-ACCESS read-only 2932 STATUS current 2933 DESCRIPTION 2934 "Codewords received without error from this Cable Modem." 2935 REFERENCE 2936 "Document [25] from References, Section 6.2.5." 2937 ::= { docsIfCmtsCmStatusEntry 15 } 2939 docsIfCmtsCmStatusExtCorrecteds OBJECT-TYPE 2940 SYNTAX Counter64 2941 MAX-ACCESS read-only 2942 STATUS current 2943 DESCRIPTION 2944 "Codewords received with correctable errors from this 2945 Cable Modem." 2946 REFERENCE 2947 "Document [25] from References, Section 6.2.5." 2948 ::= { docsIfCmtsCmStatusEntry 16 } 2950 docsIfCmtsCmStatusExtUncorrectables OBJECT-TYPE 2951 SYNTAX Counter64 2952 MAX-ACCESS read-only 2953 STATUS current 2954 DESCRIPTION 2955 "Codewords received with uncorrectable errors from this 2956 Cable Modem." 2957 REFERENCE 2958 "Document [25] from References, Section 6.2.5." 2959 ::= { docsIfCmtsCmStatusEntry 17 } 2961 docsIfCmtsCmStatusDocsisRegMode OBJECT-TYPE 2962 SYNTAX DocsisQosVersion 2963 MAX-ACCESS read-only 2964 STATUS current 2965 DESCRIPTION 2966 " Indication whether the CM has registered using 1.0 Class of 2967 Service or 1.1 Quality of Service. 2968 This object mirrors docsIfCmtsCmStatusDocsisMode from the 2969 docsIfExt mib." 2970 REFERENCE 2971 "Document [25] from References, Annex G." 2972 ::= { docsIfCmtsCmStatusEntry 18 } 2974 docsIfCmtsCmStatusModulationType OBJECT-TYPE 2975 SYNTAX DocsisUpstreamType 2976 MAX-ACCESS read-only 2977 STATUS current 2978 DESCRIPTION 2979 "Indicates modulation type currently used by the CM." 2980 REFERENCE 2981 "Document [25] from References, Table 8-19." 2982 ::= { docsIfCmtsCmStatusEntry 19 } 2984 docsIfCmtsCmStatusInetAddressType OBJECT-TYPE 2985 SYNTAX InetAddressType 2986 MAX-ACCESS read-only 2987 STATUS current 2988 DESCRIPTION 2989 "The type of internet address of 2990 docsIfCmtsCmStatusInetAddress. If the cable modem 2991 Internet address is unassigned or unknown, then the 2992 value of this object is unknown(0)." 2993 ::= { docsIfCmtsCmStatusEntry 20 } 2995 docsIfCmtsCmStatusInetAddress OBJECT-TYPE 2996 SYNTAX InetAddress 2997 MAX-ACCESS read-only 2998 STATUS current 2999 DESCRIPTION 3000 "Internet address of this Cable Modem. If the Cable Modem 3001 has no Internet address assigned, or the Internet address 3002 is unknown, the value of this object is the empty string. 3003 If the Cable Modem has multiple Internet addresses, this 3004 object returns the Internet address associated with the 3005 Cable (i.e. RF MAC) interface." 3006 ::= { docsIfCmtsCmStatusEntry 21 } 3008 -- 3009 -- The CMTS Service Table. 3010 -- 3012 docsIfCmtsServiceTable OBJECT-TYPE 3013 SYNTAX SEQUENCE OF DocsIfCmtsServiceEntry 3014 MAX-ACCESS not-accessible 3015 STATUS current 3016 DESCRIPTION 3017 "Describes the attributes of upstream service queues 3018 in a Cable Modem Termination System." 3019 ::= { docsIfCmtsObjects 4 } 3021 docsIfCmtsServiceEntry OBJECT-TYPE 3022 SYNTAX DocsIfCmtsServiceEntry 3023 MAX-ACCESS not-accessible 3024 STATUS current 3025 DESCRIPTION 3026 "Describes the attributes of a single upstream bandwidth 3027 service queue. 3029 Entries in this table exist for each ifEntry with an 3030 ifType of docsCableMaclayer(127), and for each service 3031 queue (Service ID) within this MAC layer. 3032 Entries in this table are created with the creation of 3033 individual Service IDs by the MAC layer and removed 3034 when a Service ID is removed." 3035 INDEX { ifIndex, docsIfCmtsServiceId } 3036 ::= { docsIfCmtsServiceTable 1 } 3038 DocsIfCmtsServiceEntry ::= SEQUENCE { 3039 docsIfCmtsServiceId Integer32, 3040 docsIfCmtsServiceCmStatusIndex Integer32, -- Deprecated 3041 docsIfCmtsServiceAdminStatus INTEGER, 3042 docsIfCmtsServiceQosProfile Integer32, 3043 docsIfCmtsServiceCreateTime TimeStamp, 3044 docsIfCmtsServiceInOctets Counter32, 3045 docsIfCmtsServiceInPackets Counter32, 3046 docsIfCmtsServiceNewCmStatusIndex Integer32 3047 } 3049 docsIfCmtsServiceId OBJECT-TYPE 3050 SYNTAX Integer32 (1..16383) 3051 MAX-ACCESS not-accessible 3052 STATUS current 3053 DESCRIPTION 3054 "Identifies a service queue for upstream bandwidth. The 3055 attributes of this service queue are shared between the 3056 Cable Modem and the Cable Modem Termination System. 3057 The CMTS allocates upstream bandwidth to this service 3058 queue based on requests from the CM and on the class of 3059 service associated with this queue." 3060 ::= { docsIfCmtsServiceEntry 1 } 3062 docsIfCmtsServiceCmStatusIndex OBJECT-TYPE 3063 SYNTAX Integer32 (0..65535) 3064 MAX-ACCESS read-only 3065 STATUS deprecated 3066 DESCRIPTION 3067 "Pointer to an entry in docsIfCmtsCmStatusTable identifying 3068 the Cable Modem using this Service Queue. If multiple 3069 Cable Modems are using this Service Queue, the value of 3070 this object is zero. 3071 This object has been deprecated and replaced by 3072 docsIfCmtsServiceNewCmStatusIndex, to fix a mismatch 3073 of the value range with respect to docsIfCmtsCmStatusIndex 3074 (1..2147483647)." 3075 ::= { docsIfCmtsServiceEntry 2 } 3077 docsIfCmtsServiceAdminStatus OBJECT-TYPE 3078 SYNTAX INTEGER { 3079 enabled(1), 3080 disabled(2), 3081 destroyed(3) } 3082 MAX-ACCESS read-write 3083 STATUS current 3084 DESCRIPTION 3085 "Allows a service class for a particular modem to be 3086 suppressed, (re-)enabled, or deleted altogether." 3087 ::= { docsIfCmtsServiceEntry 3 } 3089 docsIfCmtsServiceQosProfile OBJECT-TYPE 3090 SYNTAX Integer32 (0..16383) 3091 MAX-ACCESS read-only 3092 STATUS current 3093 DESCRIPTION 3094 "The index in docsIfQosProfileTable describing the quality 3095 of service attributes associated with this particular 3096 service. If no associated docsIfQosProfileTable entry 3097 exists, this object returns a value of zero." 3098 ::= { docsIfCmtsServiceEntry 4 } 3100 docsIfCmtsServiceCreateTime OBJECT-TYPE 3102 SYNTAX TimeStamp 3103 MAX-ACCESS read-only 3104 STATUS current 3105 DESCRIPTION 3106 "The value of sysUpTime when this entry was created." 3107 ::= { docsIfCmtsServiceEntry 5 } 3109 docsIfCmtsServiceInOctets OBJECT-TYPE 3110 SYNTAX Counter32 3111 MAX-ACCESS read-only 3112 STATUS current 3113 DESCRIPTION 3114 "The cumulative number of Packet Data octets received 3115 on this Service ID. The count does not include the 3116 size of the Cable MAC header" 3117 ::= { docsIfCmtsServiceEntry 6 } 3119 docsIfCmtsServiceInPackets OBJECT-TYPE 3120 SYNTAX Counter32 3121 MAX-ACCESS read-only 3122 STATUS current 3123 DESCRIPTION 3124 "The cumulative number of Packet Data packets received 3125 on this Service ID." 3126 ::= { docsIfCmtsServiceEntry 7 } 3128 docsIfCmtsServiceNewCmStatusIndex OBJECT-TYPE 3129 SYNTAX Integer32 (0..2147483647) 3130 MAX-ACCESS read-only 3131 STATUS current 3132 DESCRIPTION 3133 "Pointer (via docsIfCmtsCmStatusIndex) to an entry in 3134 docsIfCmtsCmStatusTable identifying the Cable Modem 3135 using this Service Queue. If multiple Cable Modems are 3136 using this Service Queue, the value of this object is 3137 zero." 3138 ::= { docsIfCmtsServiceEntry 8 } 3140 -- 3141 -- The following table provides upstream channel modulation profiles. 3142 -- Entries in this table can be 3143 -- re-used by one or more upstream channels. An upstream channel will 3144 -- have a modulation profile 3145 -- for each value of docsIfModIntervalUsageCode. 3146 -- 3148 docsIfCmtsModulationTable OBJECT-TYPE 3149 SYNTAX SEQUENCE OF DocsIfCmtsModulationEntry 3150 MAX-ACCESS not-accessible 3151 STATUS current 3152 DESCRIPTION 3153 "Describes a modulation profile associated with one or more 3154 upstream channels." 3155 ::= { docsIfCmtsObjects 5 } 3157 docsIfCmtsModulationEntry OBJECT-TYPE 3158 SYNTAX DocsIfCmtsModulationEntry 3159 MAX-ACCESS not-accessible 3160 STATUS current 3161 DESCRIPTION 3162 "Describes a modulation profile for an Interval Usage Code 3163 for one or more upstream channels. 3164 Entries in this table are created by the operator. Initial 3165 default entries may be created at system initialization 3166 time. No individual objects have to be specified in order 3167 to create an entry in this table. 3168 Note that some objects do not have DEFVALs, but do have 3169 calculated defaults and need not be specified during row 3170 creation. 3171 There is no restriction on the changing of values in this 3172 table while their associated rows are active." 3173 INDEX { docsIfCmtsModIndex, docsIfCmtsModIntervalUsageCode} 3174 ::= { docsIfCmtsModulationTable 1 } 3176 DocsIfCmtsModulationEntry ::= SEQUENCE { 3177 docsIfCmtsModIndex Integer32, 3178 docsIfCmtsModIntervalUsageCode INTEGER, 3179 docsIfCmtsModControl RowStatus, 3180 docsIfCmtsModType INTEGER, 3181 docsIfCmtsModPreambleLen Integer32, 3182 docsIfCmtsModDifferentialEncoding TruthValue, 3183 docsIfCmtsModFECErrorCorrection Integer32, 3184 docsIfCmtsModFECCodewordLength Integer32, 3185 docsIfCmtsModScramblerSeed Integer32, 3186 docsIfCmtsModMaxBurstSize Integer32, 3187 docsIfCmtsModGuardTimeSize Unsigned32, 3188 docsIfCmtsModLastCodewordShortened TruthValue, 3189 docsIfCmtsModScrambler TruthValue, 3190 docsIfCmtsModByteInterleaverDepth Unsigned32, 3191 docsIfCmtsModByteInterleaverBlockSize Unsigned32, 3192 docsIfCmtsModPreambleType INTEGER, 3193 docsIfCmtsModTcmErrorCorrectionOn TruthValue, 3194 docsIfCmtsModScdmaInterleaverStepSize Unsigned32, 3195 docsIfCmtsModScdmaSpreaderEnable TruthValue, 3196 docsIfCmtsModScdmaSubframeCodes Unsigned32, 3197 docsIfCmtsModChannelType DocsisUpstreamType 3198 } 3200 docsIfCmtsModIndex OBJECT-TYPE 3201 SYNTAX Integer32 (1..2147483647) 3202 MAX-ACCESS not-accessible 3203 STATUS current 3204 DESCRIPTION 3205 "An index into the Channel Modulation table representing 3206 a group of Interval Usage Codes, all associated with the 3207 same channel." 3208 ::= { docsIfCmtsModulationEntry 1 } 3210 docsIfCmtsModIntervalUsageCode OBJECT-TYPE 3211 SYNTAX INTEGER { 3212 request(1), 3213 requestData(2), 3214 initialRanging(3), 3215 periodicRanging(4), 3216 shortData(5), 3217 longData(6), 3218 advPhyShortData(9), 3219 advPhyLongData(10), 3220 ugs(11) 3221 } 3222 MAX-ACCESS not-accessible 3223 STATUS current 3224 DESCRIPTION 3225 "An index into the Channel Modulation table which, when 3226 grouped with other Interval Usage Codes, fully 3227 instantiate all modulation sets for a given upstream 3228 channel." 3229 REFERENCE 3230 "Document [25] from References, Table 8-20." 3231 ::= { docsIfCmtsModulationEntry 2 } 3233 docsIfCmtsModControl OBJECT-TYPE 3234 SYNTAX RowStatus 3235 MAX-ACCESS read-create 3236 STATUS current 3237 DESCRIPTION 3238 "Controls and reflects the status of rows in this table." 3239 ::= { docsIfCmtsModulationEntry 3 } 3241 docsIfCmtsModType OBJECT-TYPE 3242 SYNTAX INTEGER { 3243 other(1), 3244 qpsk(2), 3245 qam16(3), 3246 qam8(4), 3247 qam32(5), 3248 qam64(6), 3249 qam128(7) 3250 } 3251 MAX-ACCESS read-create 3252 STATUS current 3253 DESCRIPTION 3254 "The modulation type used on this channel. Returns 3255 other(1) if the modulation type is neither 3256 qpsk, qam16, qam8, qam32, qam64 or qam128. 3257 Type qam128 is used for SCDMA channels only. 3258 See the reference for the modulation profiles 3259 implied by different modulation types. 3260 See the conformance object for write conditions and limitations." 3261 REFERENCE 3262 "Document [25] from References, Table 8-19." 3263 DEFVAL { qpsk } 3264 ::= { docsIfCmtsModulationEntry 4 } 3266 docsIfCmtsModPreambleLen OBJECT-TYPE 3267 SYNTAX Integer32 (0..1536) 3268 MAX-ACCESS read-create 3269 STATUS current 3270 DESCRIPTION 3271 "The preamble length for this modulation profile in bits. 3272 Default value is the minimum needed by the implementation 3273 at the CMTS for the given modulation profile." 3274 REFERENCE 3275 "Document [25] from References, Table 8-19." 3277 ::= { docsIfCmtsModulationEntry 5 } 3279 docsIfCmtsModDifferentialEncoding OBJECT-TYPE 3280 SYNTAX TruthValue 3281 MAX-ACCESS read-create 3282 STATUS current 3283 DESCRIPTION 3284 "Specifies whether or not differential encoding is used 3285 on this channel." 3286 REFERENCE 3287 "Document [25] from References, Table 8-19." 3288 DEFVAL { false } 3289 ::= { docsIfCmtsModulationEntry 6 } 3291 docsIfCmtsModFECErrorCorrection OBJECT-TYPE 3292 SYNTAX Integer32 (0..16) 3293 MAX-ACCESS read-create 3294 STATUS current 3295 DESCRIPTION 3296 "The number of correctable errored bytes (t) used in 3297 forward error correction code. The value of 0 indicates 3298 no correction is employed. The number of check bytes 3299 appended will be twice this value." 3300 REFERENCE 3301 "Document [25] from References, Table 8-19." 3302 DEFVAL { 0 } 3303 ::= { docsIfCmtsModulationEntry 7 } 3305 docsIfCmtsModFECCodewordLength OBJECT-TYPE 3306 SYNTAX Integer32 (1..255) 3307 MAX-ACCESS read-create 3308 STATUS current 3309 DESCRIPTION 3310 "The number of data bytes (k) in the forward error 3311 correction codeword. 3312 This object is not used if docsIfCmtsModFECErrorCorrection 3313 is zero." 3314 REFERENCE 3315 "Document [25] from References, Table 8-19." 3316 DEFVAL { 32 } 3317 ::= { docsIfCmtsModulationEntry 8 } 3319 docsIfCmtsModScramblerSeed OBJECT-TYPE 3320 SYNTAX Integer32 (0..32767) 3321 MAX-ACCESS read-create 3322 STATUS current 3323 DESCRIPTION 3324 "The 15 bit seed value for the scrambler polynomial." 3325 REFERENCE 3326 "Document [25] from References, Table 8-19." 3327 DEFVAL { 0 } 3328 ::= { docsIfCmtsModulationEntry 9 } 3330 docsIfCmtsModMaxBurstSize OBJECT-TYPE 3331 SYNTAX Integer32 (0..255) 3332 MAX-ACCESS read-create 3333 STATUS current 3334 DESCRIPTION 3335 "The maximum number of mini-slots that can be transmitted 3336 during this channel's burst time. Returns zero if the 3337 burst length is bounded by the allocation MAP rather than 3338 this profile. 3339 Default value is 0 except for shortData, where it is 8." 3340 REFERENCE 3341 "Document [25] from References, Table 8-19." 3342 ::= { docsIfCmtsModulationEntry 10 } 3344 docsIfCmtsModGuardTimeSize OBJECT-TYPE 3345 SYNTAX Unsigned32 3346 MAX-ACCESS read-only 3347 STATUS current 3348 DESCRIPTION 3349 "The number of symbol-times which must follow the end of 3350 this channel's burst. Default value is the minimum time 3351 needed by the implementation for this modulation profile." 3352 REFERENCE 3353 "Document [25] from References, Table 8-19." 3354 ::= { docsIfCmtsModulationEntry 11 } 3356 docsIfCmtsModLastCodewordShortened OBJECT-TYPE 3357 SYNTAX TruthValue 3358 MAX-ACCESS read-create 3359 STATUS current 3360 DESCRIPTION 3361 "Indicates if the last FEC codeword is truncated." 3362 REFERENCE 3363 "Document [25] from References, Table 8-19." 3364 DEFVAL { true } 3365 ::= { docsIfCmtsModulationEntry 12 } 3367 docsIfCmtsModScrambler OBJECT-TYPE 3368 SYNTAX TruthValue 3369 MAX-ACCESS read-create 3370 STATUS current 3371 DESCRIPTION 3372 "Indicates if the scrambler is employed." 3373 REFERENCE 3374 "Document [25] from References, Table 8-19." 3375 DEFVAL { false } 3376 ::= { docsIfCmtsModulationEntry 13 } 3378 docsIfCmtsModByteInterleaverDepth OBJECT-TYPE 3379 SYNTAX Unsigned32 3380 MAX-ACCESS read-create 3381 STATUS current 3382 DESCRIPTION 3383 " ATDMA Byte Interleaver Depth (Ir). This object returns 1 for 3384 non ATDMA profiles. " 3385 REFERENCE 3386 "Document [25] from References, Table 8-19." 3387 DEFVAL { 1 } 3388 ::= { docsIfCmtsModulationEntry 14 } 3390 docsIfCmtsModByteInterleaverBlockSize OBJECT-TYPE 3391 SYNTAX Unsigned32 3392 MAX-ACCESS read-create 3393 STATUS current 3394 DESCRIPTION 3395 " ATDMA Byte Interleaver Block size (Br). This object returns 3396 zero for non ATDMA profiles " 3397 REFERENCE 3398 "Document [25] from References, Table 8-19." 3399 DEFVAL { 18 } 3400 ::= { docsIfCmtsModulationEntry 15 } 3402 docsIfCmtsModPreambleType OBJECT-TYPE 3403 SYNTAX INTEGER { 3404 qpsk0(1), 3405 qpsk1(2) 3406 } 3407 MAX-ACCESS read-create 3408 STATUS current 3409 DESCRIPTION 3410 "Preamble type for DOCSIS 2.0 bursts" 3411 REFERENCE 3412 "Document [25] from References, Table 8-19." 3413 DEFVAL { qpsk0 } 3414 ::= { docsIfCmtsModulationEntry 16 } 3416 docsIfCmtsModTcmErrorCorrectionOn OBJECT-TYPE 3417 SYNTAX TruthValue 3418 MAX-ACCESS read-create 3419 STATUS current 3420 DESCRIPTION 3421 " Trellis Code Modulation (TCM) On/Off. This value returns false for 3422 non S-CDMA profiles." 3423 REFERENCE 3424 "Document [25] from References, Table 8-19." 3425 DEFVAL { false } 3426 ::= { docsIfCmtsModulationEntry 17 } 3428 docsIfCmtsModScdmaInterleaverStepSize OBJECT-TYPE 3429 SYNTAX Unsigned32 (0 | 1..32) 3430 MAX-ACCESS read-create 3431 STATUS current 3432 DESCRIPTION 3433 " S-CDMA Interleaver step size. This value returns zero 3434 for non S-CDMA profiles." 3435 REFERENCE 3436 "Document [25] from References, Table 8-19." 3438 DEFVAL { 1 } 3439 ::= { docsIfCmtsModulationEntry 18 } 3441 docsIfCmtsModScdmaSpreaderEnable OBJECT-TYPE 3442 SYNTAX TruthValue 3443 MAX-ACCESS read-create 3444 STATUS current 3445 DESCRIPTION 3446 " S-CDMA spreader. This value returns false for non S-CDMA 3447 profiles. Default value for IUC 3 and 4 is OFF, for 3448 all other IUCs it is ON." 3449 REFERENCE 3450 "Document [25] from References, Table 8-19." 3451 ::= { docsIfCmtsModulationEntry 19 } 3453 docsIfCmtsModScdmaSubframeCodes OBJECT-TYPE 3454 SYNTAX Unsigned32 (0 | 1..128) 3455 MAX-ACCESS read-create 3456 STATUS current 3457 DESCRIPTION 3458 " S-CDMA sub-frame size. This value returns zero 3459 for non S-CDMA profiles." 3460 REFERENCE 3461 "Document [25] from References, Table 8-19." 3462 DEFVAL { 1 } 3463 ::= { docsIfCmtsModulationEntry 20 } 3465 docsIfCmtsModChannelType OBJECT-TYPE 3466 SYNTAX DocsisUpstreamType 3467 MAX-ACCESS read-create 3468 STATUS current 3469 DESCRIPTION 3470 "Describes the modulation channel type for this modulation entry." 3471 REFERENCE 3472 "Document [25] from References, Table 8-19." 3473 DEFVAL { tdma } 3474 ::= { docsIfCmtsModulationEntry 21 } 3476 docsIfCmtsQosProfilePermissions OBJECT-TYPE 3477 SYNTAX BITS { 3478 createByManagement(0), 3479 updateByManagement(1), 3480 createByModems(2) 3481 } 3482 MAX-ACCESS read-write 3483 STATUS current 3484 DESCRIPTION 3485 "This object specifies permitted methods of creating 3486 entries in docsIfQosProfileTable. 3487 CreateByManagement(0) is set if entries can be created 3488 using SNMP. UpdateByManagement(1) is set if updating 3489 entries using SNMP is permitted. CreateByModems(2) 3490 is set if entries can be created based on information 3491 in REG-REQ MAC messages received from Cable Modems. 3492 Information in this object is only applicable if 3493 docsIfQosProfileTable is implemented as read-create. 3494 Otherwise, this object is implemented as read-only 3495 and returns CreateByModems(2). 3496 Either CreateByManagement(0) or CreateByModems(1) 3497 must be set when writing to this object. 3498 Note that BITS objects are encoded most significant bit 3499 first. For example, if bit 2 is set, the value of this 3500 object is the octet string '20'H." 3501 ::= { docsIfCmtsObjects 6 } 3503 docsIfCmtsMacToCmTable OBJECT-TYPE 3504 SYNTAX SEQUENCE OF DocsIfCmtsMacToCmEntry 3505 MAX-ACCESS not-accessible 3506 STATUS current 3507 DESCRIPTION 3508 "This is a table to provide a quick access index into the 3509 docsIfCmtsCmStatusTable. There is exactly one row in this 3510 table for each row in the docsIfCmtsCmStatusTable. In 3511 general, the management station should use this table only 3512 to get a pointer into the docsIfCmtsCmStatusTable (which 3513 corresponds to the CM's RF interface MAC address), and 3514 should not iterate (e.g. GetNext through) this table." 3515 ::= { docsIfCmtsObjects 7 } 3517 docsIfCmtsMacToCmEntry OBJECT-TYPE 3518 SYNTAX DocsIfCmtsMacToCmEntry 3519 MAX-ACCESS not-accessible 3520 STATUS current 3521 DESCRIPTION 3522 "A row in the docsIfCmtsMacToCmTable. 3523 An entry in this table exists for each Cable Modem 3524 that is connected to the CMTS implementing this table." 3525 INDEX { docsIfCmtsCmMac } 3526 ::= {docsIfCmtsMacToCmTable 1 } 3528 DocsIfCmtsMacToCmEntry ::= SEQUENCE { 3529 docsIfCmtsCmMac MacAddress, 3530 docsIfCmtsCmPtr Integer32 3531 } 3533 docsIfCmtsCmMac OBJECT-TYPE 3534 SYNTAX MacAddress 3535 MAX-ACCESS not-accessible 3536 STATUS current 3537 DESCRIPTION 3538 "The RF side MAC address for the referenced CM. (E.g. the 3539 interface on the CM that has docsCableMacLayer(127) as 3540 its ifType." 3541 ::= { docsIfCmtsMacToCmEntry 1 } 3543 docsIfCmtsCmPtr OBJECT-TYPE 3544 SYNTAX Integer32 (1..2147483647) 3545 MAX-ACCESS read-only 3546 STATUS current 3547 DESCRIPTION 3548 "An row index into docsIfCmtsCmStatusTable. When queried 3549 with the correct instance value (e.g. a CM's MAC address), 3550 returns the index in docsIfCmtsCmStatusTable which 3551 represents that CM." 3552 ::= { docsIfCmtsMacToCmEntry 2 } 3554 -- 3555 -- notification group is for future extension. 3556 -- 3558 docsIfNotification OBJECT IDENTIFIER ::= { docsIfMib 2 } 3560 docsIfConformance OBJECT IDENTIFIER ::= { docsIfMib 3 } 3561 docsIfCompliances OBJECT IDENTIFIER ::= { docsIfConformance 1 } 3562 docsIfGroups OBJECT IDENTIFIER ::= { docsIfConformance 2 } 3564 -- compliance statements 3566 docsIfBasicCompliance MODULE-COMPLIANCE 3567 STATUS current 3568 DESCRIPTION 3569 "The compliance statement for devices that implement 3570 MCNS/DOCSIS compliant Radio Frequency Interfaces." 3572 MODULE -- docsIfMib 3574 -- unconditionally mandatory groups 3575 MANDATORY-GROUPS { 3576 docsIfBasicGroup 3577 } 3579 -- conditionally mandatory group 3580 GROUP docsIfCmGroup 3581 DESCRIPTION 3582 "This group is implemented only in Cable Modems, not in 3583 Cable Modem Termination Systems." 3584 -- conditionally mandatory group 3585 GROUP docsIfCmtsGroup 3586 DESCRIPTION 3587 "This group is implemented only in Cable Modem Termination 3588 Systems, not in Cable Modems." 3590 OBJECT docsIfDownChannelFrequency 3591 WRITE-SYNTAX Integer32 (47000000..862000000) 3592 MIN-ACCESS read-only 3593 DESCRIPTION 3594 "Read-write in Cable Modem Termination Systems; 3595 read-only in Cable Modems. 3596 A range of 54MHz to 860MHz is appropriate for a cable 3597 plant using a North American Sub-Split channel plan. 3598 The spectrum range has been expanded to accommodate 3599 a lower edge of 47MHz and an upper edge of 862MHz 3600 for some European channel plans. 3601 If DOCSIS is extended to cover other types of channel 3602 plans (and frequency allocations) this object will be 3603 modified accordingly." 3605 OBJECT docsIfDownChannelWidth 3606 WRITE-SYNTAX Integer32 (6000000 | 8000000) 3607 MIN-ACCESS read-only 3608 DESCRIPTION 3609 "It is conformant to implement this object as read-only. 3610 In Cable Modems, this object is always implemented as 3611 read-only. The value of 6 MHz is appropriate for cable 3612 plants running under NTSC (National Television 3613 Standards Committee) standards. The value of 8 MHz is 3614 appropriate for cable plants running under ETSI 3615 standards. For other regional standards, this 3616 object will be modified accordingly." 3618 OBJECT docsIfDownChannelModulation 3619 WRITE-SYNTAX INTEGER { 3620 qam64 (3), 3621 qam256 (4) 3622 } 3623 MIN-ACCESS read-only 3624 DESCRIPTION 3625 "Read-write in Cable Modem Termination Systems; 3626 read-only in Cable Modems." 3628 OBJECT docsIfDownChannelInterleave 3629 WRITE-SYNTAX INTEGER { 3630 taps8Increment16(3), 3631 taps16Increment8(4), 3632 taps32Increment4(5), 3633 taps64Increment2(6), 3634 taps128Increment1(7), 3635 taps12increment17(8) 3636 } 3637 MIN-ACCESS read-only 3638 DESCRIPTION 3639 "Read-write in Cable Modem Termination Systems; 3640 read-only in Cable Modems." 3642 OBJECT docsIfDownChannelPower 3643 MIN-ACCESS read-only 3644 DESCRIPTION 3645 "Read-write in Cable Modem Termination Systems; 3646 read-only in Cable Modems." 3648 OBJECT docsIfUpChannelFrequency 3649 WRITE-SYNTAX Integer32 (5000000..65000000) 3650 MIN-ACCESS read-only 3651 DESCRIPTION 3652 "Read-write in Cable Modem Termination Systems; 3653 read-only in Cable Modems. 3654 A range of 5MHz to 42MHz is appropriate for a cable 3655 plant using a North American Sub-Split channel plan. 3656 The spectrum range has been expanded to accommodate 3657 an upper edge of 65MHz for some European channel plans. 3658 If DOCSIS is extended to cover other types of channel 3659 plans (and frequency allocations) this object will 3660 be modified accordingly." 3662 OBJECT docsIfUpChannelWidth 3663 WRITE-SYNTAX Integer32 (200000..3200000) 3664 MIN-ACCESS read-only 3665 DESCRIPTION 3666 "Read-write in Cable Modem Termination Systems; 3667 read-only in Cable Modems. The above value is appropriate 3668 for cable plants running under NTSC (National Television 3669 Standards Committee) standards. If DOCSIS is extended to 3670 work with other standard (e.g. European standards), this 3671 object will be modified accordingly." 3673 OBJECT docsIfUpChannelModulationProfile 3674 MIN-ACCESS read-only 3675 DESCRIPTION 3676 "Read-write in Cable Modem Termination Systems; 3677 read-only in Cable Modems." 3679 OBJECT docsIfUpChannelSlotSize 3680 MIN-ACCESS read-only 3681 DESCRIPTION 3682 "This object is always read-only in Cable Modems. 3683 It is compliant to implement this object as read-only 3684 in Cable Modem Termination Systems." 3686 OBJECT docsIfUpChannelRangingBackoffStart 3687 MIN-ACCESS read-only 3688 DESCRIPTION 3689 "Read-write in Cable Modem Termination Systems; 3690 read-only in Cable Modems." 3692 OBJECT docsIfUpChannelRangingBackoffEnd 3693 MIN-ACCESS read-only 3694 DESCRIPTION 3695 "Read-write in Cable Modem Termination Systems; 3696 read-only in Cable Modems." 3698 OBJECT docsIfUpChannelTxBackoffStart 3699 MIN-ACCESS read-only 3700 DESCRIPTION 3701 "Read-write in Cable Modem Termination Systems; 3702 read-only in Cable Modems." 3704 OBJECT docsIfUpChannelTxBackoffEnd 3705 MIN-ACCESS read-only 3706 DESCRIPTION 3707 "Read-write in Cable Modem Termination Systems; 3708 read-only in Cable Modems." 3710 OBJECT docsIfUpChannelScdmaActiveCodes 3711 MIN-ACCESS read-only 3712 DESCRIPTION 3713 "This object is always read-only in Cable Modems. The number of active 3714 codes when SCDMA is in use must range from 64 to 128, and must be a non- 3715 Prime value. Providing this range allows for the following features and 3716 capabilities: 3717 1) Power management in S-CDMA spreader-on frames (with a 3 dB spread) 3718 2) Avoidance of code 0 3719 3) Flexible minislot sizes with and without the use of code 0" 3721 OBJECT docsIfUpChannelScdmaCodesPerSlot 3722 MIN-ACCESS read-only 3723 DESCRIPTION 3724 "Read-write in Cable Modem Termination Systems; 3725 read-only in Cable Modems." 3727 OBJECT docsIfUpChannelScdmaFrameSize 3728 MIN-ACCESS read-only 3729 DESCRIPTION 3730 "Read-write in Cable Modem Termination Systems; 3731 read-only in Cable Modems." 3733 OBJECT docsIfUpChannelScdmaHoppingSeed 3734 MIN-ACCESS read-only 3735 DESCRIPTION 3736 "This object is always read-only in Cable Modems." 3738 OBJECT docsIfUpChannelType 3739 MIN-ACCESS read-only 3740 DESCRIPTION 3741 "Read-write in Cable Modem Termination Systems; 3742 read-only in Cable Modems." 3744 OBJECT docsIfUpChannelCloneFrom 3745 MIN-ACCESS read-only 3746 DESCRIPTION 3747 "Read-write in Cable Modem Termination Systems; 3748 read-only in Cable Modems." 3750 OBJECT docsIfUpChannelUpdate 3751 MIN-ACCESS read-only 3752 DESCRIPTION 3753 "Read-write in Cable Modem Termination Systems; 3754 read-only in Cable Modems." 3756 OBJECT docsIfUpChannelStatus 3757 MIN-ACCESS read-only 3758 DESCRIPTION 3759 "Read-write in Cable Modem Termination Systems; 3760 read-only in Cable Modems." 3762 OBJECT docsIfQosProfPriority 3763 MIN-ACCESS read-only 3764 DESCRIPTION 3765 "This object is always read-only in Cable Modems. 3766 It is compliant to implement this object as read-only 3767 in Cable Modem Termination Systems." 3769 OBJECT docsIfQosProfMaxUpBandwidth 3770 MIN-ACCESS read-only 3771 DESCRIPTION 3772 "This object is always read-only in Cable Modems. 3773 It is compliant to implement this object as read-only 3774 in Cable Modem Termination Systems." 3776 OBJECT docsIfQosProfGuarUpBandwidth 3777 MIN-ACCESS read-only 3778 DESCRIPTION 3779 "This object is always read-only in Cable Modems. 3780 It is compliant to implement this object as read-only 3781 in Cable Modem Termination Systems." 3783 OBJECT docsIfQosProfMaxDownBandwidth 3784 MIN-ACCESS read-only 3785 DESCRIPTION 3786 "This object is always read-only in Cable Modems. 3787 It is compliant to implement this object as read-only 3788 in Cable Modem Termination Systems." 3790 OBJECT docsIfQosProfBaselinePrivacy 3791 MIN-ACCESS read-only 3792 DESCRIPTION 3793 "This object is always read-only in Cable Modems. 3794 It is compliant to implement this object as read-only 3795 in Cable Modem Termination Systems." 3797 OBJECT docsIfQosProfStatus 3798 MIN-ACCESS read-only 3799 DESCRIPTION 3800 "This object is always read-only in Cable Modems. 3801 It is compliant to implement this object as read-only 3802 in Cable Modem Termination Systems." 3804 OBJECT docsIfQosProfMaxTransmitBurst 3805 MIN-ACCESS read-only 3806 DESCRIPTION 3807 "This object is always read-only in Cable Modems. 3808 It is compliant to implement this object as read-only 3809 in Cable Modem Termination Systems." 3811 OBJECT docsIfCmtsServiceAdminStatus 3812 MIN-ACCESS read-only 3813 DESCRIPTION 3814 "It is compliant to implement this object as read-only." 3816 OBJECT docsIfCmtsSyncInterval 3817 MIN-ACCESS read-only 3818 DESCRIPTION 3819 "It is compliant to implement this object as read-only." 3821 OBJECT docsIfCmtsUcdInterval 3822 MIN-ACCESS read-only 3823 DESCRIPTION 3824 "It is compliant to implement this object as read-only." 3826 OBJECT docsIfCmtsInsertInterval 3827 MIN-ACCESS read-only 3828 DESCRIPTION 3829 "It is compliant to implement this object as read-only." 3831 OBJECT docsIfCmtsInvitedRangingAttempts 3832 MIN-ACCESS read-only 3833 DESCRIPTION 3834 "It is compliant to implement this object as read-only." 3836 OBJECT docsIfCmtsQosProfilePermissions 3837 MIN-ACCESS read-only 3838 DESCRIPTION 3839 "It is compliant to implement this object as read-only." 3841 ::= { docsIfCompliances 1 } 3843 docsIfBasicGroup OBJECT-GROUP 3844 OBJECTS { 3845 docsIfDownChannelId, 3846 docsIfDownChannelFrequency, 3847 docsIfDownChannelWidth, 3848 docsIfDownChannelModulation, 3849 docsIfDownChannelInterleave, 3850 docsIfDownChannelPower, 3851 docsIfDownChannelAnnex, 3852 docsIfUpChannelId, 3853 docsIfUpChannelFrequency, 3854 docsIfUpChannelWidth, 3855 docsIfUpChannelModulationProfile, 3856 docsIfUpChannelSlotSize, 3857 docsIfUpChannelTxTimingOffset, 3858 docsIfUpChannelRangingBackoffStart, 3859 docsIfUpChannelRangingBackoffEnd, 3860 docsIfUpChannelTxBackoffStart, 3861 docsIfUpChannelTxBackoffEnd, 3862 docsIfUpChannelScdmaActiveCodes, 3863 docsIfUpChannelScdmaCodesPerSlot, 3864 docsIfUpChannelScdmaFrameSize, 3865 docsIfUpChannelScdmaHoppingSeed, 3866 docsIfUpChannelType, 3867 docsIfUpChannelCloneFrom, 3868 docsIfUpChannelUpdate, 3869 docsIfUpChannelStatus, 3870 docsIfQosProfPriority, 3871 docsIfQosProfMaxUpBandwidth, 3872 docsIfQosProfGuarUpBandwidth, 3873 docsIfQosProfMaxDownBandwidth, 3874 docsIfQosProfBaselinePrivacy, 3875 docsIfQosProfStatus, 3876 docsIfQosProfMaxTransmitBurst, 3877 docsIfSigQIncludesContention, 3878 docsIfSigQUnerroreds, 3879 docsIfSigQCorrecteds, 3880 docsIfSigQUncorrectables, 3881 docsIfSigQSignalNoise, 3882 docsIfSigQMicroreflections, 3883 docsIfSigQEqualizationData, 3884 docsIfDocsisBaseCapability 3885 } 3886 STATUS current 3887 DESCRIPTION 3888 "Group of objects implemented in both Cable Modems and 3889 Cable Modem Termination Systems." 3890 ::= { docsIfGroups 1 } 3892 docsIfCmGroup OBJECT-GROUP 3893 OBJECTS { 3894 docsIfCmCmtsAddress, 3895 docsIfCmCapabilities, 3896 docsIfCmRangingTimeout, 3897 -- docsIfCmRangingRespTimeout, 3898 docsIfCmStatusValue, 3899 docsIfCmStatusCode, 3900 docsIfCmStatusTxPower, 3901 docsIfCmStatusResets, 3902 docsIfCmStatusLostSyncs, 3903 docsIfCmStatusInvalidMaps, 3904 docsIfCmStatusInvalidUcds, 3905 docsIfCmStatusInvalidRangingResponses, 3906 docsIfCmStatusInvalidRegistrationResponses, 3907 docsIfCmStatusT1Timeouts, 3908 docsIfCmStatusT2Timeouts, 3909 docsIfCmStatusT3Timeouts, 3910 docsIfCmStatusT4Timeouts, 3911 docsIfCmStatusRangingAborteds, 3912 docsIfCmStatusDocsisOperMode, 3913 docsIfCmStatusModulationType, 3914 docsIfCmServiceQosProfile, 3915 docsIfCmServiceTxSlotsImmed, 3916 docsIfCmServiceTxSlotsDed, 3917 docsIfCmServiceTxRetries, 3918 docsIfCmServiceTxExceededs, 3919 docsIfCmServiceRqRetries, 3920 docsIfCmServiceRqExceededs, 3921 docsIfCmServiceExtTxSlotsImmed, 3922 docsIfCmServiceExtTxSlotsDed 3924 } 3925 STATUS current 3926 DESCRIPTION 3927 "Group of objects implemented in Cable Modems." 3928 ::= { docsIfGroups 2 } 3930 docsIfCmtsGroup OBJECT-GROUP 3931 OBJECTS { 3932 docsIfCmtsCapabilities, 3933 docsIfCmtsSyncInterval, 3934 docsIfCmtsUcdInterval, 3935 docsIfCmtsMaxServiceIds, 3936 -- docsIfCmtsInsertionInterval, 3937 docsIfCmtsInvitedRangingAttempts, 3938 docsIfCmtsInsertInterval, 3939 docsIfCmtsStatusInvalidRangeReqs, 3940 docsIfCmtsStatusRangingAborteds, 3941 docsIfCmtsStatusInvalidRegReqs, 3942 docsIfCmtsStatusFailedRegReqs, 3943 docsIfCmtsStatusInvalidDataReqs, 3944 docsIfCmtsStatusT5Timeouts, 3945 docsIfCmtsCmStatusMacAddress, 3946 docsIfCmtsCmStatusDownChannelIfIndex, 3947 docsIfCmtsCmStatusUpChannelIfIndex, 3948 docsIfCmtsCmStatusRxPower, 3949 docsIfCmtsCmStatusTimingOffset, 3950 docsIfCmtsCmStatusEqualizationData, 3951 docsIfCmtsCmStatusValue, 3952 docsIfCmtsCmStatusUnerroreds, 3953 docsIfCmtsCmStatusCorrecteds, 3954 docsIfCmtsCmStatusUncorrectables, 3955 docsIfCmtsCmStatusSignalNoise, 3956 docsIfCmtsCmStatusMicroreflections, 3957 docsIfCmtsCmStatusExtUnerroreds, 3958 docsIfCmtsCmStatusExtCorrecteds, 3959 docsIfCmtsCmStatusExtUncorrectables, 3960 docsIfCmtsCmStatusDocsisRegMode, 3961 docsIfCmtsCmStatusModulationType, 3962 docsIfCmtsCmStatusInetAddressType, 3963 docsIfCmtsCmStatusInetAddress, 3964 docsIfCmtsServiceAdminStatus, 3965 docsIfCmtsServiceQosProfile, 3966 docsIfCmtsServiceCreateTime, 3967 docsIfCmtsServiceInOctets, 3968 docsIfCmtsServiceInPackets, 3969 docsIfCmtsServiceNewCmStatusIndex, 3970 docsIfCmtsModType, 3971 docsIfCmtsModControl, 3972 docsIfCmtsModPreambleLen, 3973 docsIfCmtsModDifferentialEncoding, 3974 docsIfCmtsModFECErrorCorrection, 3975 docsIfCmtsModFECCodewordLength, 3976 docsIfCmtsModScramblerSeed, 3977 docsIfCmtsModMaxBurstSize, 3978 docsIfCmtsModGuardTimeSize, 3979 docsIfCmtsModLastCodewordShortened, 3980 docsIfCmtsModScrambler, 3981 docsIfCmtsModByteInterleaverDepth, 3982 docsIfCmtsModByteInterleaverBlockSize, 3983 docsIfCmtsModPreambleType, 3984 docsIfCmtsModTcmErrorCorrectionOn, 3985 docsIfCmtsModScdmaInterleaverStepSize, 3986 docsIfCmtsModScdmaSpreaderEnable, 3987 docsIfCmtsModScdmaSubframeCodes, 3988 docsIfCmtsModChannelType, 3989 docsIfCmtsQosProfilePermissions, 3990 docsIfCmtsCmPtr 3991 } 3992 STATUS current 3993 DESCRIPTION 3994 "Group of objects implemented in Cable Modem Termination 3995 Systems." 3996 ::= { docsIfGroups 3 } 3998 docsIfObsoleteGroup OBJECT-GROUP 3999 OBJECTS { 4000 docsIfCmRangingRespTimeout, 4001 docsIfCmtsInsertionInterval 4002 } 4003 STATUS obsolete 4004 DESCRIPTION 4005 "Group of objects obsoleted." 4006 ::= { docsIfGroups 4 } 4008 docsIfDeprecatedGroup OBJECT-GROUP 4009 OBJECTS { 4010 docsIfQosProfMaxTxBurst, 4011 docsIfCmtsCmStatusIpAddress, 4012 docsIfCmtsServiceCmStatusIndex 4013 } 4014 STATUS deprecated 4015 DESCRIPTION 4016 "Group of objects deprecated." 4017 ::= { docsIfGroups 5 } 4019 END 4021 5. Acknowledgments 4022 This document is a production of the Docsis 2.0 OSS Working Group. 4023 It is a revision based on RFC2670, "Radio Frequency (RF) Interface 4024 Management Information Base for DOCSIS compliant RF interfaces" [22]. 4026 The current editors wish to express gratitude to Rich Prodan, Greg 4027 Nakanishi, Rich Woundy, Eduardo Cardona, and Adi Shaliv for their 4028 valued advice and opinions. 4030 6. Revision History 4032 6.1. Scope 4034 This MIB in this document has been developed to accommodate DOCSIS 2.0 devices 4035 and their system capabilities. The MIB is an update to RFC2670 with the 4036 additional incorporation of EuroDocsis specific items and the DOCS_IF_EXT mib. 4038 6.2. Extension 4040 We have maintained the MIB objects as defined in RFC 2670. In some cases new mib 4041 objects have been created with identical functionality but greater capacity (ie 4042 32 to 64 bits). In these situations, both the original 32 bit objects and the new 4043 64 bit objects must be implemented. 4045 7. References 4047 [1] Harrington, D., Presuhn, R. and B. Wijnen, "An Architecture for 4048 Describing SNMP Management Frameworks", RFC 2571, April 1999. 4050 [2] Rose, M. and K. McCloghrie, "Structure and Identification of 4051 Management Information for TCP/IP-based Internets", STD 16, RFC 4052 1155, May 1990. 4054 [3] Rose, M. and K. McCloghrie, "Concise MIB Definitions", STD 16, 4055 RFC 1212, March 1991. 4057 [4] Rose, M., "A Convention for Defining Traps for use with the 4058 SNMP", RFC 1215, March 1991. 4060 [5] McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Structure of 4061 Management Information for Version 2 (SMIv2)", STD 58, RFC 2578, 4062 April 1999. 4064 [6] McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Textual 4065 Conventions for SMIv2", STD 58, RFC 2579, April 1999. 4067 [7] McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Conformance 4068 Statements for SMIv2", STD 58, RFC 2580, April 1999. 4070 [8] Case, J., Fedor, M., Schoffstall, M. and J. Davin, "Simple 4071 Management Protocol", STD 15, RFC 1157, May 1990. 4073 [9] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, 4074 "Introduction to Community-based SNMPv2", RFC 1901, January 4075 1996. 4077 [10] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Transport 4078 Mappings for Version 2 of the Simple Network Management Protocol 4079 (SNMPv2)", RFC 1906, January 1996. 4081 [11] Case, J., Harrington D., Presuhn R. and B. Wijnen, "Message 4082 Processing and Dispatching for the Simple Network Management 4083 Protocol (SNMP)", RFC 2572, April 1999. 4085 [12] Blumenthal, U. and B. Wijnen, "User-based Security Model (USM) 4086 for version 3 of the Simple Network Management Protocol 4087 (SNMPv3)", RFC 2574, April 1999. 4089 [13] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Protocol 4090 Operations for Version 2 of the Simple Network Management 4091 Protocol (SNMPv2)", RFC 1905, January 1996. 4093 [14] Levi, D., Meyer, P. and B. Stewart, "SNMP Applications", RFC 4094 2573, April 1999. 4096 [15] Wijnen, B., Presuhn, R. and K. McCloghrie, "View-based Access 4097 Control Model (VACM) for the Simple Network Management Protocol 4098 (SNMP)", RFC 2575, April 1999. 4100 [16] "Data-Over-Cable Service Interface Specifications: Cable 4101 Modem Radio Frequency Interface Specification SP-RFI-I05-991105", 4102 DOCSIS, November 1999, http://www.cablemodem.com/. 4104 [17] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB 4105 using SMIv2", RFC 2863, June 2000. 4107 [18] StJohns, M. , "Cable Device Management Information Base for 4108 DOCSIS Compliant Cable Modems and Cable Modem Termination 4109 Systems", RFC2669, August 1999. 4111 [19] Proakis, John G., "Digital Communications, 3rd Edition", 4112 McGraw-Hill, New York, New York, 1995, ISBN 0-07-051726-6 4114 [20] "Transmission Systems for Interactive Cable Television Services, 4115 Annex B", J.112, International Telecommunications Union, March 4116 1998. 4118 [21] Case, J., Mundy, R., Partain, D., and B. Stewart, 4119 "Introduction to Version 3 of the Internet-standard Network Management 4120 Framework", RFC 2570, April 1999. 4122 [22] StJohns, M., "Radio Frequency (RF) Interface Management 4123 Information Base for MCNS/DOCSIS compliant RF interfaces", 4124 RFC 2670, August 1999. 4126 [23] "Data-Over-Cable Service Interface Specifications: Cable 4127 Modem Radio Frequency Interface Specification SP-RFIv1.1-I06- 4128 001215", DOCSIS, December 2000, http://www.cablemodem.com/. 4130 [24] "Document for the certification of EuroDOCSIS CMs and CMTSs, 4131 Version 3.3", EuroDOCSIS, February 2000. 4133 [25] "Data-Over-Cable Service Interface Specifications: Radio Frequency 4134 Interface Specification SP-RFIv2.0-W04-011119", DOCSIS 2.0 4135 November 2001. 4137 [26] "Data-Over-Cable Service Interface Specifications: Operations 4138 Support System Interface Specification SP-OSSIv2.0-W01-011119", 4139 DOCSIS 2.0 November 2001. 4141 [27] Woundy, R., "Baseline Privacy Interface Management 4142 Information Base for DOCSIS Compliant Cable Modems 4143 and Cable Modem Termination Systems", RFC3083, March 2001. 4145 [28] "Adapted MIB-definitions and a clarification for MPEG-related 4146 issues for EuroDOCSIS cable modem systems v1.01", tComLabs, 4147 May 2000. 4149 8. Security Considerations 4151 This MIB relates to a system which will provide metropolitan public 4152 internet access. As such, improper manipulation of the objects 4153 represented by this MIB may result in denial of service to a large 4154 number of end-users. In addition, manipulation of the 4155 docsIfCmServiceQosProfile, docsIfCmtsServerQosProfile, and the 4156 elements of docsIfQosProfileTable and docsIfCmtsModulationTable may 4157 allow an end-user to improve their service response or diminish other 4158 subscriber's service response. 4160 There are a number of management objects defined in this MIB that 4161 have a MAX-ACCESS clause of read-write and/or read-create. Such 4162 objects may be considered sensitive or vulnerable in some network 4163 environments. The support for SET operations in a non-secure 4164 environment without proper protection can have a negative effect on 4165 network operations. 4167 SNMPv1 by itself is not a secure environment. Even if the network 4168 itself is secure (for example by using IPSec), even then, there is no 4169 control as to who on the secure network is allowed to access and 4170 GET/SET (read/change/create/delete) the objects in this MIB. 4172 It is recommended that the implementers consider the security 4173 features as provided by the SNMPv3 framework. Specifically, the use 4174 of the User-based Security Model RFC 2574 [12] and the View- based 4175 Access Control Model RFC 2575 [15] is recommended. 4177 It is then a customer/user responsibility to ensure that the SNMP 4178 entity giving access to an instance of this MIB, is properly 4179 configured to give access to the objects only to those principals 4180 (users) that have legitimate rights to indeed GET or SET 4181 (change/create/delete) them. 4183 9. Changes from RFC2670 4185 Upstream now separated into 'physical interfaces' and 'logical channels'. An 4186 instance of the docsIfUpstreamChannelTable exists for each 'logical channel'. 4187 The IANA ifType for 'logical channels' is 205. The IANA ifType for 'physical 4188 interfaces' remains at 129. 4190 Object docsIfDownChannelAnnex added to docsIfDownstreamChannelTable. This object 4191 originated in the EuroDocsis specifications. 4193 Eight new objects added to the docsIfUpstreamChannelTable. One describes the 4194 channel type in use, while four are specific S-CDMA parameters. The remaining 4195 three additions are used in the creation of a temporary inactive upstream row 4196 so the S-CDMA parameters may be manipulated 'offline'. 4198 Object docsIfQosProfMaxTransmitBurst has been added to the docsIfQosProfileTable 4199 to replace deprecated object docsIfQosProfMaxTxBurst. This fixes a range error 4200 caused by switch to recording as bytes instead of minislots. 4202 A new base object docsIfDocsisBaseCapability has been added which mirrors the 4203 functionality of the docsifExt mib object docsIfDocsisCapability, extended to 4204 include Docsis 2.0. 4206 Two new objects added to the docsIfCmStatusTable. One indicates the current 4207 modulation type. The other mirrors the functionality of the docsIfExt object 4208 docsIfDocsisOperMode, while clarifying that it applies to the COS/QOS mode 4209 used by the device. 4211 Two new 64 bit counters added to the docsIfCmServiceTable to extend the capacity 4212 of existing 32 bit counters. 4214 Seven new objects added to the docsIfCmtsCmStatusTable. Three are 64 bit 4215 counters, two add ipv6 capability, and one indicates the CM modulation type 4216 in use. The remaining object mirrors the functionality of the docsIfExt object 4217 docsIfCmtsCmStatusDocsisMode, while clarifying that it applies to the COS/QOS 4218 mode used by the device. 4220 One object added to the docsIfCmtsServiceTable to fix a range error in an 4221 existing object, that has been deprecated. 4223 Eight new objects added to the docsIfCmtsModulationTable. Seven of these 4224 describe ATDMA/S-CDMA channel parameters, while the other describes modulation 4225 attributes common to all modulation types. 4227 Enumerated values for object docsIfDownChannelInterleave have been expanded to 4228 include a EuroDocsis value. 4230 Enumerated values for object docsIfCmtsModIntervalUsageCode have been expanded 4231 to include new Docsis 2.0 values. 4233 Enumerated values for object docsIfCmtsModType have been expanded to include new 4234 Docsis 2.0 values. 4236 Compliance statements have been updated to reflect new objects and to describe 4237 EuroDocsis specific implementation features. 4239 The descriptions of objects docsIfCmtsStatusInvalidRegReqs and 4240 docsIfCmtsStatusFailedRegReqs have been clarified. 4242 10. Conflict Resolution with docsIfExt MIB 4244 The docsIfExt MIB originated as an engineering change notification (ECN) to the 4245 Docsis 1.1 specifications, and consisted of three objects - two for CM 4246 implementation and one for the CMTS. These three objects have been incorporated 4247 into this new version of the RF MIB, and have been assigned new object 4248 identifiers. 4250 It is the intention of the authors to deprecate the docsIfExt MIB. Due to 4251 backward compatibility concerns with Docsis 1.1 implementations, both the new RF 4252 MIB objects and the former docsIfExt MIB objects will be required for Docsis 2.0 4253 designs for the immediate future. An influencing factor in this decision is that 4254 the docsCableDeviceTrap MIB (from the same design update as the docsIfExt MIB) 4255 contains references to docsIfExt MIB objects in various trap definitions. 4257 The following process will be used to accomplish the eventual deprecation of the 4258 docsIfExt MIB: 4260 1) Create a Docsis ECN that will require Docsis 1.1 implementations to 4261 support the new location of the three docsIfExt objects in the RF MIB. 4263 2) The same ECN will update the docsCableDeviceTrap MIB to reference the 4264 new location of the three docsIfExt objects, and deprecate the former 4265 references. 4267 3) The same ECN will deprecate the docsIfExt MIB. 4269 Following these steps, the state of affairs will be: 4270 a) Docsis 1.1 MUST support new RF MIB docsIfExt objects. 4271 b) Docsis 1.1 MAY support remaining RF MIB 2.0 objects. 4272 c) Docsis 1.1 MAY support former docsIfExt MIB objects. 4273 d) Docsis 2.0 MUST support all new RF MIB objects. 4274 e) Docsis 2.0 MAY support former docsIfExt MIB objects. 4276 11. Intellectual Property 4278 The IETF takes no position regarding the validity or scope of any 4279 intellectual property or other rights that might be claimed to 4280 pertain to the implementation or use of the technology described in 4281 this document or the extent to which any license under such rights 4282 might or might not be available; neither does it represent that it 4283 has made any effort to identify any such rights. Information on the 4284 IETF's procedures with respect to rights in standards-track and 4285 standards-related documentation can be found in BCP-11. Copies of 4286 claims of rights made available for publication and any assurances of 4287 licenses to be made available, or the result of an attempt made to 4288 obtain a general license or permission for the use of such 4289 proprietary rights by implementers or users of this specification can 4290 be obtained from the IETF Secretariat. 4292 The IETF invites any interested party to bring to its attention any 4293 copyrights, patents or patent applications, or other proprietary 4294 rights that may cover technology that may be required to practice 4295 this standard. Please address the information to the IETF Executive 4296 Director. 4298 12. Authors' Addresses 4300 Aviv Goren 4301 Terayon 4302 2952 Bunker Hill Lane 4303 Santa Clara, CA 4304 U.S.A. 4305 Phone: +1 408 727 4400 4306 E-mail: aviv.goren@terayon.com 4307 David Raftus 4308 Imedia Semiconductor 4309 340 Terry Fox Drive, Suite 202 4310 Ottawa Ontario 4311 Canada 4312 Phone: +1 613 592 1052 4313 E-mail: david.raftus@imedia.com 4315 13. Full Copyright Statement 4317 Copyright (C) The Internet Society (2001). All Rights Reserved. 4319 This document and translations of it may be copied and furnished to 4320 others, and derivative works that comment on or otherwise explain it 4321 or assist in its implementation may be prepared, copied, published 4322 and distributed, in whole or in part, without restriction of any 4323 kind, provided that the above copyright notice and this paragraph are 4324 included on all such copies and derivative works. However, this 4325 document itself may not be modified in any way, such as by removing 4326 the copyright notice or references to the Internet Society or other 4327 Internet organizations, except as needed for the purpose of 4328 developing Internet standards in which case the procedures for 4329 copyrights defined in the Internet Standards process must be 4330 followed, or as required to translate it into languages other than 4331 English. 4333 The limited permissions granted above are perpetual and will not be 4334 revoked by the Internet Society or its successors or assigns. 4336 This document and the information contained herein is provided on an 4337 "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING 4338 TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING 4339 BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION 4340 HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF 4341 MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 4343 Acknowledgement 4345 Funding for the RFC Editor function is currently provided by the 4346 Internet Society.