idnits 2.17.1 draft-ietf-ipcdn-rf-interface-mib-07.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: ---------------------------------------------------------------------------- ** Missing expiration date. The document expiration date should appear on the first and last page. ** The document seems to lack a 1id_guidelines paragraph about Internet-Drafts being working documents. ** The document seems to lack a 1id_guidelines paragraph about the list of current Internet-Drafts. ** The document seems to lack a 1id_guidelines paragraph about the list of Shadow Directories. == No 'Intended status' indicated for this document; assuming Proposed Standard 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 7 instances of too long lines in the document, the longest one being 7 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. ** 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 136: '...ng translated MIB MUST be semantically...' RFC 2119 keyword, line 1273: '... MUST NOT be changed while...' RFC 2119 keyword, line 1285: '... MUST NOT be changed while...' RFC 2119 keyword, line 1296: '... MUST NOT be changed while...' RFC 2119 keyword, line 1308: '... MUST NOT be changed while...' (3 more instances...) Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the RFC 3978 Section 5.4 Copyright Line does not match the current year == Line 84 has weird spacing: '...ifEntry for ...' == Line 88 has weird spacing: '...ifEntry for ...' == Line 3102 has weird spacing: '...llowing table...' -- 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 1999) is 9203 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) ** Obsolete normative reference: RFC 2271 (ref. '1') (Obsoleted by RFC 2571) ** Downref: Normative reference to an Informational RFC: RFC 1215 (ref. '4') ** Obsolete normative reference: RFC 1902 (ref. '5') (Obsoleted by RFC 2578) ** Obsolete normative reference: RFC 1903 (ref. '6') (Obsoleted by RFC 2579) ** Obsolete normative reference: RFC 1904 (ref. '7') (Obsoleted by RFC 2580) ** 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 2272 (ref. '11') (Obsoleted by RFC 2572) ** Obsolete normative reference: RFC 2274 (ref. '12') (Obsoleted by RFC 2574) ** Obsolete normative reference: RFC 1905 (ref. '13') (Obsoleted by RFC 3416) ** Obsolete normative reference: RFC 2273 (ref. '14') (Obsoleted by RFC 2573) ** Obsolete normative reference: RFC 2275 (ref. '15') (Obsoleted by RFC 2575) -- Possible downref: Non-RFC (?) normative reference: ref. '16' ** Obsolete normative reference: RFC 2233 (ref. '17') (Obsoleted by RFC 2863) == Outdated reference: A later version (-08) exists of draft-ietf-ipcdn-cable-device-mib-05 -- Possible downref: Non-RFC (?) normative reference: ref. '19' -- Possible downref: Non-RFC (?) normative reference: ref. '20' Summary: 24 errors (**), 0 flaws (~~), 6 warnings (==), 5 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 1 INTERNET-DRAFT DOCSIS RF Interface MIB February 1999 3 Radio Frequency (RF) Interface Management Information Base 4 for MCNS/DOCSIS compliant RF interfaces 5 draft-ietf-ipcdn-rf-interface-mib-07.txt 7 Wed Feb 17 11:20:28 PST 1999 9 Mike StJohns (editor) 10 @Home Network 11 stjohns@corp.home.net 13 Status of this Memo 15 This document is an Internet-Draft and is in full conformance with all 16 the provisions of Section 10 of RFC2026. Internet-Drafts are working 17 documents of the Internet Engineering Task Force (IETF), its areas, and 18 its working groups. Note that other groups may also distribute working 19 documents as Internet-Drafts. 21 Internet-Drafts are draft documents valid for a maximum of six months 22 and may be updated, replaced, or obsoleted by other documents at any 23 time. It is inappropriate to use Internet-Drafts as reference material 24 or to cite them other than as "work in progress". 26 To view the entire list of current Internet-Drafts, please check the 27 "1id-abstracts.txt" listing contained in the Internet-Drafts Shadow 28 Directories on ftp.is.co.za (Africa), ftp.nordu.net (Europe), 29 munnari.oz.au (Pacific Rim), ftp.ietf.org (US East Coast), or 30 ftp.isi.edu (US West Coast). 32 Copyright (C) The Internet Society (1997). All Rights Reserved. 34 Abstract 36 This memo defines a portion of the Management Information Base (MIB) 37 for use with network management protocols in the Internet community. In 38 particular, it defines a basic set of managed objects for SNMP-based 39 management of MCNS/DOCSIS compliant Radio Frequency (RF) interfaces. 41 This memo specifies a MIB module in a manner that is compliant to the 42 SNMP SMIv2 [5][6][7]. The set of objects are consistent with the SNMP 43 framework and existing SNMP standards. 45 This memo is a product of the IPCDN working group within the Internet 46 Engineering Task Force. Comments are solicited and should be addressed 47 to the working group's mailing list at ipcdn@terayon.com and/or the 48 author. 50 Table of Contents 52 1 The SNMP Management Framework ................................... 3 53 2 Glossary ........................................................ 3 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 ........................................................ 4 62 2.9 Downstream .................................................... 4 63 2.10 Head-end ..................................................... 4 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 ..................................................... 5 72 3 Overview ........................................................ 6 73 3.1 Structure of the MIB .......................................... 6 74 3.1.1 docsIfBaseObjects ........................................... 6 75 3.1.2 docsIfCmObjects ............................................. 6 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 ................................................. 8 81 3.2.4 ifRcvAddressTable ........................................... 8 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 ....... 10 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 .......................................... 12 90 3.2.5.2.2 ifEntry for Upstream interfaces in Cable Modems ......... 13 91 3.2.5.3 ifEntry for the MAC Layer ................................. 15 92 4 Definitions ..................................................... 16 93 5 Acknowledgments ................................................. 64 94 6 References ...................................................... 64 95 7 Security Considerations ......................................... 66 96 8 Intellectual Property ........................................... 66 97 9 Author's Address ................................................ 67 98 10 Copyright Section .............................................. 67 99 1. The SNMP Management Framework 101 The SNMP Management Framework presently consists of five major 102 components: 104 o An overall architecture, described in RFC 2271 [1]. 106 o Mechanisms for describing and naming objects and events for the 107 purpose of management. The first version of this Structure of 108 Management Information (SMI) is called SMIv1 and described in 109 RFC 1155 [2], RFC 1212 [3] and RFC 1215 [4]. The second version, 110 called SMIv2, is described in RFC 1902 [5], RFC 1903 [6] and RFC 111 1904 [7]. 113 o Message protocols for transferring management information. The 114 first version of the SNMP message protocol is called SNMPv1 and 115 described in RFC 1157 [8]. A second version of the SNMP message 116 protocol, which is not an Internet standards track protocol, is 117 called SNMPv2c and described in RFC 1901 [9] and RFC 1906 [10]. 118 The third version of the message protocol is called SNMPv3 and 119 described in RFC 1906 [10], RFC 2272 [11] and RFC 2274 [12]. 121 o Protocol operations for accessing management information. The 122 first set of protocol operations and associated PDU formats is 123 described in RFC 1157 [8]. A second set of protocol operations 124 and associated PDU formats is described in RFC 1905 [13]. 126 o A set of fundamental applications described in RFC 2273 [14] and 127 the view-based access control mechanism described in RFC 2275 128 [15]. 130 Managed objects are accessed via a virtual information store, termed the 131 Management Information Base or MIB. Objects in the MIB are defined 132 using the mechanisms defined in the SMI. 134 This memo specifies a MIB module that is compliant to the SMIv2. A MIB 135 conforming to the SMIv1 can be produced through the appropriate 136 translations. The resulting translated MIB MUST be semantically 137 equivalent, except where objects or events are omitted because no 138 translation is possible (use of Counter64). Some machine readable 139 information in SMIv2 will be converted into textual descriptions in 140 SMIv1 during the translation process. However, this loss of machine 141 readable information is not considered to change the semantics of the 142 MIB. 144 2. Glossary 146 The terms in this document are derived either from normal cable system 147 usage, or from the documents associated with the Data Over Cable Service 148 Interface Specification process. 150 2.1. CATV 152 Originally "Community Antenna Television", now used to refer to any 153 cable or hybrid fiber and cable system used to deliver video signals to 154 a community. 156 2.2. Channel 158 A specific frequency allocation with an RF medium, specified by channel 159 width in Hertz (cycles per second) and by center frequency. Within the 160 US Cable Systems, upstream channels are generally allocated from the 5- 161 42MHz range while down stream channels are generally allocated from the 162 50-750MHz range depending on the capabilities of the given system. The 163 typical broadcast channel width in the US is 6MHz. Upstream channel 164 widths for DOCSIS vary. 166 2.3. CM Cable Modem. A CM acts as a "slave" station in a DOCSIS 167 compliant cable data system. 169 2.4. CMTS Cable Modem Termination System. A generic term covering a 170 cable bridge or cable router in a head-end. A CMTS acts as the master 171 station in a DOCSIS compliant cable data system. It is the only station 172 that transmits downstream, and it controls the scheduling of upstream 173 transmissions by its associated CMs. 175 2.5. Codeword 177 See [16]. A characteristic of the Foward Error Correction scheme used 178 above the RF media layer. 180 2.6. Data Packet 182 The payload portion of the MAC Packet. 184 2.7. dBmV 186 Decibel relative to one milli-volt. A measure of RF power. 188 2.8. DOCSIS 190 "Data Over Cable Interface Specification". A term referring to the 191 ITU-T J.112 Annex B standard for cable modem systems. [20] 193 2.9. Downstream 195 The direction from the head-end towards the subscriber. 197 2.10. Head-end 199 The origination point in most cable systems of the subscriber video 200 signals. 202 2.11. MAC Packet 204 A DOCSIS PDU. 206 2.12. MCNS 208 "Multimedia Cable Network System". Generally replaced in usage by 209 DOCSIS. 211 2.13. Mini-slot 213 See [16]. In general, an interval of time which is allocated by the 214 CMTS to a given CM for that CM to transmit in an upstream direction. 216 2.14. QPSK Quadrature Phase Shift Keying. A particular modulation 217 scheme on an RF medium. See [19] 219 2.15. QAM Quadrature Amplitude Modulation. A particular modulation 220 scheme on on RF medium. Usually expressed with a number indicating the 221 size of the modulation constellation (e.g. 16 QAM). See [19], or any 222 other book on digital communications over RF for a complete explanation 223 of this. 225 2.16. RF 227 Radio Frequency. 229 2.17. Symbol-times 231 See [16]. A characteristic of the RF modulation scheme. 233 2.18. Upstream 235 The direction from the subscriber towards the head-end. 237 3. Overview 239 This MIB provides a set of objects required for the management of 240 MCNS/DOCSIS compliant Cable Modem (CM) and Cable Modem Termination 241 System (CMTS) RF interfaces. The specification is derived in part from 242 the parameters and protocols described in DOCSIS Radio Frequency 243 Interface Specification [16]. 245 3.1. Structure of the MIB 247 This MIB is structured as three groups: 249 o Management information pertinent to both Cable Modems (CM) and 250 Cable Modem Termination Systems (CMTS) (docsIfBaseObjects). 252 o Management information pertinent to Cable Modems only 253 (docsIfCmObjects). 255 o Management information pertinent to Cable Modem Termination Systems 256 only (docsIfCmtsObjects). 258 Tables within each of these groups group objects functionally - e.g. 259 Quality of Service, Channel characteristics, MAC layer management, etc. 260 Rows created automatically (e.g. by the device according to the hardware 261 configuration) may and generally will have a mixture of configuration 262 and status objects within them. Rows that are meant to be created by 263 the management station are generally restricted to configuration (read- 264 create) objects. 266 3.1.1. docsIfBaseObjects 268 docsIfDownstreamChannelTable - This table describes the active 269 downstream channels for a CMTS and the received downstream channel for a 270 CM. 272 docsIfUpstreamChannelTable - This table describes the active upstream 273 channels for a a CMTS and the current upstream transmission channel for 274 a CM. 276 docsIfQosProfileTable - This table describes the valid Quality of 277 Service service profiles for the cable data system. 279 docsIfSignalQualityTable - This table is used to monitor RF signal 280 quality characteristics of received signals. 282 3.1.2. docsIfCmObjects 284 docsIfCmMacTable - This table is used to monitor the DOCSIS MAC 285 interface and can be considered an extension to the ifEntry. 287 docsIfCmServiceTable - This table describes the upstream service queues 288 available at this CM. There is a comparable table at the CMTS, 289 docsIfCmtsServiceEntry, which describes the service queues from the 290 point of view of the CMTS. 292 3.1.3. docsIfCmtsObjects 294 docsIfCmtsStatusTable - This table provides a set of aggregated counters 295 which roll-up values and events that occur on the underlying sub- 296 interfaces. 298 docsIfCmtsCmStatusTable - This table is used to hold information about 299 known (e.g. registered) cable modems on the system serviced by this 300 CMTS. 302 docsIfCmtsServiceEntry - This table provides access to the information 303 related to upstream service queues. 305 docsIfCmtsModulationTable - This table allows control over the 306 modulation profiles for RF channels associated with this CMTS. 308 docsIfCmtsMacToCmTable - This table allows fast access into the 309 docsIfCmtsCmTable via a MAC address (of the CM) interface. 311 3.2. Relationship to the Interfaces MIB 313 This section clarifies the relationship of this MIB to the Interfaces 314 MIB [17]. Several areas of correlation are addressed in the following 315 subsections. The implementor is referred to the Interfaces MIB document 316 in order to understand the general intent of these areas. 318 3.2.1. Layering Model 320 An instance of ifEntry exists for each RF Downstream interface, for each 321 RF Upstream interface, and for each RF MAC layer. The ifStackTable [17] 322 MUST be implemented to identify relationships among sub-interfaces. 324 The following example illustrates a MAC interface with one downstream 325 and two upstream channels. 327 | <== to network layer 328 +-------------+--------------+ 329 | RF MAC | 330 +----+---------+-----------+-+ 331 | | | 332 +---------+---+ +---+-------+ +-+---------+ 333 | Downstream1 | | Upstream1 | | Upstream2 | 334 +-------------+ +-----------+ +-----------+ 336 As can be seen from this example, the RF MAC interface is layered on top 337 of the downstream and upstream interfaces. 339 In this example, the assignment of index values could be as follows: 341 ifIndex ifType Description 343 1 docsCableMaclayer(127) CATV MAC Layer 344 2 docsCableDownstream(128) CATV Downstream interface 345 3 docsCableUpstream(129) CATV Upstream interface 346 4 docsCableUpstream(129) CATV Upstream interface 348 The corresponding ifStack entries would then be: 350 | IfStackHigherLayer | ifStackLowerLayer | 351 | 0 | 1 | 352 | 1 | 2 | 353 | 1 | 3 | 354 | 1 | 4 | 355 | 2 | 0 | 356 | 3 | 0 | 357 | 4 | 0 | 359 The same interface model can also be used in Telephony or Telco Return 360 systems. A pure Telco Return system (Cable Modem as well as Cable Modem 361 Termination System) would not have upstream, but only downstream cable 362 channels. Systems supporting both Telco Return and cable upstream 363 channels can use the above model without modification. 365 Telco Return Upstream channel(s) are handled by the appropriate MIBs, 366 such as PPP or Modem MIBs. 368 3.2.2. Virtual Circuits 370 This medium does not support virtual circuits and this area is not 371 applicable to this MIB. 373 3.2.3. ifTestTable 375 The ifTestTable is not supported by this MIB. 377 3.2.4. ifRcvAddressTable 379 The ifRcvAddressTable is not supported by this MIB. 381 3.2.5. ifEntry 383 This section documents only the differences from the requirements 384 specified in the Interfaces MIB. See that MIB for columns omitted from 385 the descriptions below. 387 3.2.5.1. ifEntry for Downstream interfaces 389 The ifEntry for Downstream interfaces supports the 390 ifGeneralInformationGroup and the ifPacketGroup of the Interfaces MIB. 391 This is an output only interface at the CMTS and all input status 392 counters - ifIn* - will return zero. This is an input only interface at 393 the CM and all output status counters - ifOut* - will return zero. 395 3.2.5.1.1. ifEntry for Downstream interfaces in Cable Modem Termination 396 Systems 398 ifTable Comments 399 ============== =========================================== 400 ifIndex Each RF Cable Downstream interface is represented 401 by an ifEntry. 403 ifType The IANA value of docsCableDownstream(128). 405 ifSpeed Return the speed of this downstream channel. 406 The returned value the raw bandwidth in bits/s 407 of this interface. This is the symbol rate 408 multiplied with the number of bits per symbol. 410 ifPhysAddress Return an empty string. 412 ifAdminStatus The administrative status of this interface. 414 ifOperStatus The current operational status of this interface. 416 ifMtu The size of the largest frame which can be 417 sent on this interface, specified in octets. 418 The value includes the length of the MAC header. 420 ifInOctets Return zero. 422 ifInUcastPkts Return zero. 424 ifInMulticastPkts Return zero. 426 ifInBroadcastPkts Return zero. 428 ifInDiscards Return zero. 430 ifInErrors Return zero. 432 ifInUnknownProtos Return zero. 434 ifOutOctets The total number of octets transmitted on this 435 interface. This includes MAC packets as well as 436 data packets, and includes the length of the MAC 437 header. 439 ifOutUcastPkts The number of Unicast packets transmitted on this 440 interface. This includes MAC packets as well as 441 data packets. 443 ifOutMulticastPkts 444 Return the number of Multicast packets transmitted 445 on this interface. 446 This includes MAC packets as well as data packets. 448 ifOutBroadcastPkts 449 Return the number of broadcast packets transmitted 450 on this interface. 451 This includes MAC packets as well as data packets. 453 ifOutDiscards The total number of outbound packets which 454 were discarded. Possible reasons are: 455 buffer shortage. 457 ifOutErrors The number of packets which could not be 458 transmitted due to errors. 460 ifPromiscuousMode Return false. 462 3.2.5.1.2. ifEntry for Downstream interfaces in Cable Modems 464 ifTable Comments 465 ============== =========================================== 466 ifIndex Each RF Cable Downstream interface is represented 467 by an ifEntry. 469 ifType The IANA value of docsCableDownstream(128). 471 ifSpeed Return the speed of this downstream channel. 472 The returned value the raw bandwidth in bits/s 473 of this interface. This is the symbol rate 474 multiplied with the number of bits per symbol. 476 ifPhysAddress Return an empty string. 478 ifAdminStatus The administrative status of this interface. 480 ifOperStatus The current operational status of this interface. 482 ifMtu The size of the largest frame which can be 483 received from this interface, specified in octets. 484 The value includes the length of the MAC header. 486 ifInOctets The total number of octets received on this 487 interface. This includes data packets as well as 488 MAC layer packets, and includes the length of the 489 MAC header. 491 ifInUcastPkts The number of Unicast packets received on this 492 interface. This includes data packets as well as 493 MAC layer packets. 495 ifInMulticastPkts Return the number of Multicast packets received 496 on this interface. This includes data packets as 497 well as MAC layer packets. 499 ifInBroadcastPkts Return the number of Broadcast packets received 500 on this interface. This includes data packets 501 as well as MAC layer packets. 503 ifInDiscards The total number of received packets which have been 504 discarded. 505 The possible reasons are: buffer shortage. 507 ifInErrors The number of inbound packets that contained 508 errors preventing them from being deliverable 509 to higher layers. 510 Possible reasons are: MAC FCS error. 512 ifInUnknownProtos The number of frames with an unknown packet type. 513 These are MAC frames with an unknown packet type. 515 ifOutOctets Return zero. 517 ifOutUcastPkts Return zero. 519 ifOutMulticastPkts 520 Return zero. 522 ifOutBroadcastPkts 523 Return zero. 525 ifOutDiscards Return zero. 527 ifOutErrors Return zero. 529 ifPromiscuousMode Refer to the Interfaces MIB. 531 3.2.5.2. ifEntry for Upstream interfaces 533 The ifEntry for Upstream interfaces supports the 534 ifGeneralInformationGroup and the ifPacketGroup of the Interfaces MIB. 535 This is an input only interface at the CMTS and all output status 536 counters - ifOut* - will return zero. This is an output only interface 537 at the CM and all input status counters - ifIn* - will return zero. 539 3.2.5.2.1. ifEntry for Upstream interfaces in Cable Modem Termination 540 Systems 542 ifTable Comments 543 ============== =========================================== 544 ifIndex Each RF Cable Upstream interface is represented 545 by an ifEntry. 547 ifType The IANA value of docsCableUpstream(129). 549 ifSpeed Return the speed of this upstream channel. 550 The returned value is the raw bandwidth 551 in bits/s of this interface, regarding the 552 highest speed modulation profile that is 553 defined. This is the symbol rate multiplied 554 with the number of bits per symbol for this 555 modulation profile. 557 ifPhysAddress Return an empty string. 559 ifAdminStatus The administrative status of this interface. 561 ifOperStatus The current operational status of this interface. 563 ifMtu The size of the largest frame which can be 564 received on this interface, specified in octets. 565 The value includes the length of the MAC header. 567 ifInOctets The total number of octets received on this 568 interface. This includes data packets as well as 569 MAC layer packets, and includes the length of the 570 MAC header. 572 ifInUcastPkts The number of Unicast packets received on this 573 interface. This includes data packets as well as 574 MAC layer packets. 576 ifInMulticastPkts Return the number of Multicast packets received 577 on this interface. This includes data packets as 578 well as MAC layer packets. 580 ifInBroadcastPkts Return the number of Broadcast packets received 581 on this interface. This includes data packets 582 as well as MAC layer packets. 584 ifInDiscards The total number of received packets which have been 585 discarded. 586 The possible reasons are: buffer shortage. 588 ifInErrors The number of inbound packets that contained 589 errors preventing them from being deliverable 590 to higher layers. 591 Possible reasons are: MAC FCS error. 593 ifInUnknownProtos The number of frames with an unknown packet type. 594 This are MAC frames with an unknown packet type. 596 ifOutOctets Return zero. 598 ifOutUcastPkts Return zero. 600 ifOutMulticastPkts 601 Return zero. 603 ifOutBroadcastPkts 604 Return zero. 606 ifOutDiscards Return zero. 608 ifOutErrors Return zero. 610 3.2.5.2.2. ifEntry for Upstream interfaces in Cable Modems 612 ifTable Comments 613 ============== =========================================== 614 ifIndex Each RF Cable Upstream interface is represented 615 by an ifEntry. 617 ifType The IANA value of docsCableUpstream(129). 619 ifSpeed Return the speed of this upstream channel. 620 The returned value is the raw bandwidth 621 in bits/s of this interface, regarding the 622 highest speed modulation profile that is 623 defined. This is the symbol rate multiplied 624 with the number of bits per symbol for this 625 modulation profile. 627 ifPhysAddress Return an empty string. 629 ifAdminStatus The administrative status of this interface. 631 ifOperStatus The current operational status of this interface. 633 ifMtu The size of the largest frame which can be 634 transmitted on this interface, specified in octets. 636 The value includes the length of the MAC header. 638 ifInOctets Return zero. 640 ifInUcastPkts Return zero. 642 ifInMulticastPkts Return zero. 644 ifInBroadcastPkts Return zero. 646 ifInDiscards Return zero. 648 ifInErrors Return zero. 650 ifInUnknownProtos Return zero. 652 ifOutOctets The total number of octets transmitted on this 653 interface. This includes MAC packets as well as 654 data packets, and includes the length of the MAC 655 header. 657 ifOutUcastPkts The number of Unicast packets transmitted on this 658 interface. This includes MAC packets as well as 659 data packets. 661 ifOutMulticastPkts 662 Return the number of Multicast packets transmitted 663 on this interface. 664 This includes MAC packets as well as data packets. 666 ifOutBroadcastPkts 667 Return the number of broadcast packets transmitted 668 on this interface. 669 This includes MAC packets as well as data packets. 671 ifOutDiscards The total number of outbound packets which 672 were discarded. Possible reasons are: 673 buffer shortage. 675 ifOutErrors The number of packets which could not be 676 transmitted due to errors. 678 ifPromiscuousMode Return false. 680 3.2.5.3. ifEntry for the MAC Layer 682 The ifEntry for the MAC Layer supports the ifGeneralInformationGroup and 683 the ifPacketGroup of the Interfaces MIB. This interface provides an 684 aggregate view of status for the lower level Downstream and Upstream 685 interfaces. 687 ifTable Comments 688 ============== =========================================== 689 ifIndex Each RF Cable MAC layer entity is represented 690 by an ifEntry. 692 ifType The IANA value of docsCableMaclayer(127). 694 ifSpeed Return zero. 696 ifPhysAddress Return the physical address of this interface. 698 ifAdminStatus The administrative status of this interface. 700 ifOperStatus The current operational status of the MAC 701 layer interface. 703 ifHighSpeed Return zero. 705 ifMtu Return 1500. 707 ifInOctets The total number of data octets received on this 708 interface, targeted for upper protocol layers. 710 ifInUcastPkts The number of Unicast packets received on this 711 interface, targeted for upper protocol layers. 713 ifInMulticastPkts Return the number of Multicast packets received 714 on this interface, targeted for upper protocol 715 layers. 717 ifInBroadcastPkts Return the number of Broadcast packets received 718 on this interface, targeted for upper protocol 719 layers. 721 ifInDiscards The total number of received packets which have been 722 discarded. 723 The possible reasons are: buffer shortage. 725 ifInErrors The number of inbound packets that contained 726 errors preventing them from being deliverable 727 to higher layers. 728 Possible reasons are: data packet FCS error, 729 invalid MAC header. 731 ifInUnknownProtos The number of frames with an unknown packet type. 733 This is the number of data packets targeted for upper 734 protocol layers with an unknown packet type. 736 ifOutOctets The total number of octets, received from upper 737 protocol layers and transmitted on this interface. 739 ifOutUcastPkts The number of Unicast packets, received from upper 740 protocol layers and transmitted on this interface. 742 ifOutMulticastPkts 743 Return the number of Multicast packets received 744 from upper protocol layers and transmitted on this 745 interface. 747 ifOutBroadcastPkts 748 Return the number of broadcast packets received 749 from upper protocol layers and transmitted on this 750 interface. 752 ifOutDiscards The total number of outbound packets which 753 were discarded. Possible reasons are: 754 buffer shortage. 756 ifOutErrors The number of packets which could not be 757 transmitted due to errors. 759 ifPromiscuousMode Refer to the Interfaces MIB. 761 4. Definitions 763 DOCS-IF-MIB DEFINITIONS ::= BEGIN 765 IMPORTS 766 MODULE-IDENTITY, 767 OBJECT-TYPE, 768 -- do not import BITS, 769 Unsigned32, 770 Integer32, 771 Counter32, 772 TimeTicks, 773 IpAddress 774 FROM SNMPv2-SMI 775 TEXTUAL-CONVENTION, 776 MacAddress, 777 RowStatus, 778 TruthValue, 779 TimeInterval, 780 TimeStamp 781 FROM SNMPv2-TC 782 OBJECT-GROUP, 783 MODULE-COMPLIANCE 784 FROM SNMPv2-CONF 785 ifIndex, InterfaceIndexOrZero 786 FROM IF-MIB 787 transmission 788 FROM RFC1213-MIB; 790 docsIfMib MODULE-IDENTITY 791 LAST-UPDATED "9902171132Z" -- Feb 17, 1999 792 ORGANIZATION "IETF IPCDN Working Group" 793 CONTACT-INFO 794 " Michael StJohns 795 Postal: @Home Network 796 425 Broadway 797 Redwood City, CA 798 U.S.A. 799 Phone: +1 650 569 5368 800 E-mail: stjohns@corp.home.net" 801 DESCRIPTION 802 "This is the MIB Module for MCNS/DOCSIS compliant Radio 803 Frequency (RF) interfaces in Cable Modems (CM) and 804 Cable Modem Termination Systems (CMTS)." 805 REVISION "9810061512Z" 806 DESCRIPTION 807 "Modified by Mike StJohns to fix problems identified by 808 the first pass of the MIB doctor. Of special note, 809 docsIfRangingResp and docsIfCmtsInsertionInterval were 810 obsoleted and replaced by other objects with the same 811 functionality, but more appropriate SYNTAX." 812 ::= { transmission 127 } 814 -- Textual Conventions 816 TenthdBmV ::= TEXTUAL-CONVENTION 817 DISPLAY-HINT "d-1" 818 STATUS current 819 DESCRIPTION 820 "This data type represents power levels that are normally 821 expressed in dBmV. Units are in tenths of a dBmV; 822 for example, 5.1 dBmV will be represented as 51." 823 SYNTAX Integer32 825 TenthdB ::= TEXTUAL-CONVENTION 826 DISPLAY-HINT "d-1" 827 STATUS current 828 DESCRIPTION 829 "This data type represents power levels that are normally 830 expressed in dB. Units are in tenths of a dB; 831 for example, 5.1 dB will be represented as 51." 832 SYNTAX Integer32 834 docsIfMibObjects OBJECT IDENTIFIER ::= { docsIfMib 1 } 835 docsIfBaseObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 1 } 836 docsIfCmObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 2 } 837 docsIfCmtsObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 3 } 839 -- 840 -- BASE GROUP 841 -- 843 -- 844 -- The following table is implemented on both the Cable Modem (CM) 845 -- and the Cable Modem Termination System (CMTS). 846 -- 848 docsIfDownstreamChannelTable OBJECT-TYPE 849 SYNTAX SEQUENCE OF DocsIfDownstreamChannelEntry 850 MAX-ACCESS not-accessible 851 STATUS current 852 DESCRIPTION 853 "This table describes the attributes of downstream 854 channels (frequency bands)." 855 REFERENCE 856 "DOCSIS Radio Frequency Interface Specification, 857 Table 4-12 and Table 4-13." 858 ::= { docsIfBaseObjects 1 } 860 docsIfDownstreamChannelEntry OBJECT-TYPE 861 SYNTAX DocsIfDownstreamChannelEntry 862 MAX-ACCESS not-accessible 863 STATUS current 864 DESCRIPTION 865 "An entry provides a list of attributes for a single 866 Downstream channel. 867 An entry in this table exists for each ifEntry with an 868 ifType of docsCableDownstream(128)." 869 INDEX { ifIndex } 870 ::= { docsIfDownstreamChannelTable 1 } 872 DocsIfDownstreamChannelEntry ::= SEQUENCE { 873 docsIfDownChannelId Integer32, 874 docsIfDownChannelFrequency Integer32, 875 docsIfDownChannelWidth Integer32, 876 docsIfDownChannelModulation INTEGER, 877 docsIfDownChannelInterleave INTEGER, 878 docsIfDownChannelPower TenthdBmV 879 } 881 docsIfDownChannelId OBJECT-TYPE 882 SYNTAX Integer32 (0..255) 883 MAX-ACCESS read-only 884 STATUS current 885 DESCRIPTION 886 "The Cable Modem Termination System (CMTS) identification 887 of the downstream channel within this particular MAC 888 interface. If the interface is down, the object returns 889 the most current value. If the downstream channel ID is 890 unknown, this object returns a value of 0." 891 ::= { docsIfDownstreamChannelEntry 1 } 893 docsIfDownChannelFrequency OBJECT-TYPE 894 SYNTAX Integer32 (0..1000000000) 895 UNITS "hertz" 896 MAX-ACCESS read-write 897 STATUS current 898 DESCRIPTION 899 "The center of the downstream frequency associated with 900 this channel. This object will return the current tuner 901 frequency. If a CMTS provides IF output, this object 902 will return 0, unless this CMTS is in control of the 903 final downstream RF frequency. See the associated 904 compliance object for a description of valid frequencies 905 that may be written to this object." 906 REFERENCE 907 "DOCSIS Radio Frequency Interface Specification, 908 Section 4.3.3." 909 ::= { docsIfDownstreamChannelEntry 2 } 911 docsIfDownChannelWidth OBJECT-TYPE 912 SYNTAX Integer32 (0..16000000) 913 UNITS "hertz" 914 MAX-ACCESS read-write 915 STATUS current 916 DESCRIPTION 917 "The bandwidth of this downstream channel. Most 918 implementations are expected to support a channel width 919 of 6 MHz (North America) and/or 8 MHz (Europe). See the 920 associated compliance object for a description of the 921 valid channel widths for this object." 922 REFERENCE 923 "DOCSIS Radio Frequency Interface Specification, 924 Table 4-12 and Table 4-13." 925 ::= { docsIfDownstreamChannelEntry 3 } 927 docsIfDownChannelModulation OBJECT-TYPE 928 SYNTAX INTEGER { 929 unknown(1), 930 other(2), 931 qam64(3), 932 qam256(4) 933 } 934 MAX-ACCESS read-write 935 STATUS current 936 DESCRIPTION 937 "The modulation type associated with this downstream 938 channel. If the interface is down, this object either 939 returns the configured value (CMTS), the most current 940 value (CM), or the value of unknown(1). See the 941 associated conformance object for write conditions and 942 limitations. See the reference for specifics on the 943 modulation profiles implied by qam64 and qam256." 944 REFERENCE 945 "DOCSIS Radio Frequency Interface Specification, 946 Section 3.6.2." 947 ::= { docsIfDownstreamChannelEntry 4 } 949 docsIfDownChannelInterleave OBJECT-TYPE 950 SYNTAX INTEGER { 951 unknown(1), 952 other(2), 953 taps8Increment16(3), 954 taps16Increment8(4), 955 taps32Increment4(5), 956 taps64Increment2(6), 957 taps128Increment1(7) 958 } 959 MAX-ACCESS read-write 960 STATUS current 961 DESCRIPTION 962 "The Forward Error Correction (FEC) interleaving used 963 for this downstream channel. 964 Values are defined as follows: 965 taps8Increment16(3): protection 5.9/4.1 usec, 966 latency .22/.15 msec 967 taps16Increment8(4): protection 12/8.2 usec, 968 latency .48/.33 msec 969 taps32Increment4(5): protection 24/16 usec, 970 latency .98/.68 msec 971 taps64Increment2(6): protection 47/33 usec, 972 latency 2/1.4 msec 973 taps128Increment1(7): protection 95/66 usec, 974 latency 4/2.8 msec 975 If the interface is down, this object either returns 976 the configured value (CMTS), the most current value (CM), 977 or the value of unknown(1). 978 The value of other(2) is returned if the interleave 979 is known but not defined in the above list. 980 See the associated conformance object for write 981 conditions and limitations. See the reference for the FEC 982 configuration described by the setting of this object." 983 REFERENCE 984 "DOCSIS Radio Frequency Interface Specification, 985 Section 4.3.2." 986 ::= { docsIfDownstreamChannelEntry 5 } 988 docsIfDownChannelPower OBJECT-TYPE 989 SYNTAX TenthdBmV 990 UNITS "dBmV" 991 MAX-ACCESS read-write 992 STATUS current 993 DESCRIPTION 994 "At the CMTS, the operational transmit power. At the CM, 995 the received power level. May be set to zero at the CM 996 if power level measurement is not supported. 997 If the interface is down, this object either returns 998 the configured value (CMTS), the most current value (CM) 999 or the value of 0. See the associated conformance object 1000 for write conditions and limitations. See the reference 1001 for recommended and required power levels." 1002 REFERENCE 1003 "DOCSIS Radio Frequency Interface Specification, 1004 Table 4-12 and Table 4-13." 1005 ::= { docsIfDownstreamChannelEntry 6 } 1007 -- 1008 -- The following table is implemented on both the CM and the CMTS. 1009 -- For the CM, only attached channels appear in the table. For the 1010 -- CM, this table is read only as well. 1011 -- 1013 docsIfUpstreamChannelTable OBJECT-TYPE 1014 SYNTAX SEQUENCE OF DocsIfUpstreamChannelEntry 1015 MAX-ACCESS not-accessible 1016 STATUS current 1017 DESCRIPTION 1018 "This table describes the attributes of attached upstream channels 1019 (frequency bands)." 1020 ::= { docsIfBaseObjects 2 } 1022 docsIfUpstreamChannelEntry OBJECT-TYPE 1023 SYNTAX DocsIfUpstreamChannelEntry 1024 MAX-ACCESS not-accessible 1025 STATUS current 1026 DESCRIPTION 1027 "List of attributes for a single upstream channel. 1028 An entry in this table exists for each ifEntry with an 1029 ifType of docsCableUpstream(129)." 1030 INDEX { ifIndex } 1031 ::= { docsIfUpstreamChannelTable 1 } 1033 DocsIfUpstreamChannelEntry ::= SEQUENCE { 1034 docsIfUpChannelId Integer32, 1035 docsIfUpChannelFrequency Integer32, 1036 docsIfUpChannelWidth Integer32, 1037 docsIfUpChannelModulationProfile Unsigned32, 1038 docsIfUpChannelSlotSize Unsigned32, 1039 docsIfUpChannelTxTimingOffset Unsigned32, 1040 docsIfUpChannelRangingBackoffStart Integer32, 1041 docsIfUpChannelRangingBackoffEnd Integer32, 1042 docsIfUpChannelTxBackoffStart Integer32, 1043 docsIfUpChannelTxBackoffEnd Integer32 1044 } 1046 docsIfUpChannelId OBJECT-TYPE 1047 SYNTAX Integer32 (0..255) 1048 MAX-ACCESS read-only 1049 STATUS current 1050 DESCRIPTION 1051 "The CMTS identification of the upstream channel." 1052 ::= { docsIfUpstreamChannelEntry 1 } 1054 docsIfUpChannelFrequency OBJECT-TYPE 1055 SYNTAX Integer32 (0..1000000000) 1056 UNITS "hertz" 1057 MAX-ACCESS read-write 1058 STATUS current 1059 DESCRIPTION 1060 "The center of the frequency band associated with this 1061 upstream channel. This object returns 0 if the frequency 1062 is undefined or unknown. Minimum permitted upstream 1063 frequency is 5,000,000 Hz for current technology. See 1064 the associated conformance object for write conditions 1065 and limitations." 1066 REFERENCE 1067 "DOCSIS Radio Frequency Interface Specification, 1068 Table 2-2." 1069 ::= { docsIfUpstreamChannelEntry 2 } 1071 docsIfUpChannelWidth OBJECT-TYPE 1072 SYNTAX Integer32 (0..20000000) 1073 UNITS "hertz" 1074 MAX-ACCESS read-write 1075 STATUS current 1076 DESCRIPTION 1077 "The bandwidth of this upstream channel. This object 1078 returns 0 if the channel width is undefined or unknown. 1079 Minimum permitted channel width is 200,000 Hz currently. See the 1080 associated conformance object for write conditions and 1081 limitations." 1082 REFERENCE 1083 "DOCSIS Radio Frequency Interface Specification, 1084 Table 4-3." 1085 ::= { docsIfUpstreamChannelEntry 3 } 1087 docsIfUpChannelModulationProfile OBJECT-TYPE 1088 SYNTAX Unsigned32 1089 MAX-ACCESS read-write 1090 STATUS current 1091 DESCRIPTION 1092 "An entry identical to the docsIfModIndex in the 1093 docsIfCmtsModulationTable that describes this channel. 1094 This channel is further instantiated there by a grouping 1095 of interval usage codes which together fully describe the 1096 channel modulation. This object returns 0 if the 1097 docsIfCmtsModulationTable entry does not exist or 1098 docsIfCmtsModulationTable is empty. See 1099 the associated conformance object for write conditions 1100 and limitations." 1101 ::= { docsIfUpstreamChannelEntry 4 } 1103 docsIfUpChannelSlotSize OBJECT-TYPE 1104 SYNTAX Unsigned32 1105 MAX-ACCESS read-write 1106 STATUS current 1107 DESCRIPTION 1108 "The number of 6.25 microsecond ticks in each upstream mini- 1109 slot. Returns zero if the value is undefined or unknown. 1110 See the associated conformance object for write 1111 conditions and limitations." 1112 REFERENCE 1113 "DOCSIS Radio Frequency Interface Specification, 1114 Section 6.1.2.4." 1115 ::= { docsIfUpstreamChannelEntry 5 } 1117 docsIfUpChannelTxTimingOffset OBJECT-TYPE 1118 SYNTAX Unsigned32 1119 MAX-ACCESS read-only 1120 STATUS current 1121 DESCRIPTION 1122 "A measure of the current round trip time at the CM, or the 1123 maximum round trip time seen by the CMTS. Used for timing 1124 of CM upstream transmissions to ensure synchronized 1125 arrivals at the CMTS. Units are in terms of 1126 (6.25 microseconds/64)." 1127 REFERENCE 1128 "DOCSIS Radio Frequency Interface Specification, 1129 Section 6.5." 1130 ::= { docsIfUpstreamChannelEntry 6 } 1132 docsIfUpChannelRangingBackoffStart OBJECT-TYPE 1133 SYNTAX Integer32 (0..16) 1134 MAX-ACCESS read-write 1135 STATUS current 1136 DESCRIPTION 1137 "The initial random backoff window to use when retrying 1138 Ranging Requests. Expressed as a power of 2. A value of 16 1139 at the CMTS indicates that a proprietary adaptive retry 1140 mechanism is to be used. See the associated conformance 1141 object for write conditions and limitations." 1142 REFERENCE 1143 "DOCSIS Radio Frequency Interface Specification, 1144 Section 6.4.4." 1145 ::= { docsIfUpstreamChannelEntry 7 } 1147 docsIfUpChannelRangingBackoffEnd OBJECT-TYPE 1148 SYNTAX Integer32 (0..16) 1149 MAX-ACCESS read-write 1150 STATUS current 1151 DESCRIPTION 1152 "The final random backoff window to use when retrying 1153 Ranging Requests. Expressed as a power of 2. A value of 16 1154 at the CMTS indicates that a proprietary adaptive retry 1155 mechanism is to be used. See the associated conformance 1156 object for write conditions and limitations." 1157 REFERENCE 1158 "DOCSIS Radio Frequency Interface Specification, 1159 Section 6.4.4." 1160 ::= { docsIfUpstreamChannelEntry 8 } 1162 docsIfUpChannelTxBackoffStart OBJECT-TYPE 1163 SYNTAX Integer32 (0..16) 1164 MAX-ACCESS read-write 1165 STATUS current 1166 DESCRIPTION 1167 "The initial random backoff window to use when retrying 1168 transmissions. Expressed as a power of 2. A value of 16 1169 at the CMTS indicates that a proprietary adaptive retry 1170 mechanism is to be used. See the associated conformance 1171 object for write conditions and limitations." 1172 REFERENCE 1173 "DOCSIS Radio Frequency Interface Specification, 1174 Section 6.4.4." 1175 ::= { docsIfUpstreamChannelEntry 9 } 1177 docsIfUpChannelTxBackoffEnd OBJECT-TYPE 1178 SYNTAX Integer32 (0..16) 1179 MAX-ACCESS read-write 1180 STATUS current 1181 DESCRIPTION 1182 "The final random backoff window to use when retrying 1183 transmissions. Expressed as a power of 2. A value of 16 1184 at the CMTS indicates that a proprietary adaptive retry 1185 mechanism is to be used. See the associated conformance 1186 object for write conditions and limitations." 1187 REFERENCE 1188 "DOCSIS Radio Frequency Interface Specification, 1189 Section 6.4.4." 1190 ::= { docsIfUpstreamChannelEntry 10 } 1192 -- The following table describes the attributes of each class of 1193 -- service. The entries in this table are referenced from the 1194 -- docsIfServiceEntries. They exist as a separate table in order to 1195 -- reduce redundant information in docsIfServiceTable. 1196 -- 1197 -- This table is implemented at both the CM and the CMTS. 1198 -- The CM need only maintain entries for the classes of service 1199 -- referenced by its docsIfServiceTable. 1200 -- 1202 docsIfQosProfileTable OBJECT-TYPE 1203 SYNTAX SEQUENCE OF DocsIfQosProfileEntry 1204 MAX-ACCESS not-accessible 1205 STATUS current 1206 DESCRIPTION 1207 "Describes the attributes for each class of service." 1208 ::= { docsIfBaseObjects 3 } 1210 docsIfQosProfileEntry OBJECT-TYPE 1211 SYNTAX DocsIfQosProfileEntry 1212 MAX-ACCESS not-accessible 1213 STATUS current 1214 DESCRIPTION 1215 "Describes the attributes for a single class of service. 1217 If implemented as read-create in the Cable Modem 1218 Termination System, creation of entries in this table is 1219 controlled by the value of docsIfCmtsQosProfilePermissions. 1221 If implemented as read-only, entries are created based 1222 on information in REG-REQ MAC messages received from 1223 Cable Modems (Cable Modem Termination System 1224 implementation), or based on information extracted from 1225 the TFTP option file (Cable Modem implementation). 1226 In the Cable Modem Termination system, read-only entries 1227 are removed if no longer referenced by 1228 docsIfCmtsServiceTable. 1230 An entry in this table must not be removed while it is 1231 referenced by an entry in docsIfCmServiceTable (Cable Modem) 1232 or docsIfCmtsServiceTable (Cable Modem Termination System). 1234 An entry in this table should not be changeable while 1235 it is referenced by an entry in docsIfCmtsServiceTable. 1237 If this table is created automatically, there should only 1238 be a single entry for each Class of Service. Multiple 1239 entries with the same Class of Service parameters are not 1240 recommended." 1241 INDEX { docsIfQosProfIndex } 1242 ::= { docsIfQosProfileTable 1 } 1244 DocsIfQosProfileEntry ::= SEQUENCE { 1245 docsIfQosProfIndex Integer32, 1246 docsIfQosProfPriority Integer32, 1247 docsIfQosProfMaxUpBandwidth Integer32, 1248 docsIfQosProfGuarUpBandwidth Integer32, 1249 docsIfQosProfMaxDownBandwidth Integer32, 1250 docsIfQosProfMaxTxBurst Integer32, 1251 docsIfQosProfBaselinePrivacy TruthValue, 1252 docsIfQosProfStatus RowStatus 1253 } 1255 docsIfQosProfIndex OBJECT-TYPE 1256 SYNTAX Integer32 (1..16383) 1257 MAX-ACCESS not-accessible 1258 STATUS current 1259 DESCRIPTION 1260 "The index value which uniquely identifies an entry 1261 in the docsIfQosProfileTable." 1262 ::= { docsIfQosProfileEntry 1 } 1264 docsIfQosProfPriority OBJECT-TYPE 1265 SYNTAX Integer32 (0..7) 1266 MAX-ACCESS read-create 1267 STATUS current 1268 DESCRIPTION 1269 "A relative priority assigned to this service when 1270 allocating bandwidth. Zero indicates lowest priority; 1271 and seven indicates highest priority. 1272 Interpretation of priority is device-specific. 1273 MUST NOT be changed while this row is active." 1274 DEFVAL { 0 } 1275 ::= { docsIfQosProfileEntry 2 } 1277 docsIfQosProfMaxUpBandwidth OBJECT-TYPE 1278 SYNTAX Integer32 (0..100000000) 1279 MAX-ACCESS read-create 1280 STATUS current 1281 DESCRIPTION 1282 "The maximum upstream bandwidth, in bits per second, 1283 allowed for a service with this service class. 1284 Zero if there is no restriction of upstream bandwidth. 1285 MUST NOT be changed while this row is active." 1286 DEFVAL { 0 } 1287 ::= { docsIfQosProfileEntry 3 } 1289 docsIfQosProfGuarUpBandwidth OBJECT-TYPE 1290 SYNTAX Integer32 (0..100000000) 1291 MAX-ACCESS read-create 1292 STATUS current 1293 DESCRIPTION 1294 "Minimum guaranteed upstream bandwidth, in bits per second, 1295 allowed for a service with this service class. 1296 MUST NOT be changed while this row is active." 1297 DEFVAL { 0 } 1298 ::= { docsIfQosProfileEntry 4 } 1300 docsIfQosProfMaxDownBandwidth OBJECT-TYPE 1301 SYNTAX Integer32 (0..100000000) 1302 MAX-ACCESS read-create 1303 STATUS current 1304 DESCRIPTION 1305 "The maximum downstream bandwidth, in bits per second, 1306 allowed for a service with this service class. 1307 Zero if there is no restriction of downstream bandwidth. 1308 MUST NOT be changed while this row is active." 1309 DEFVAL { 0 } 1310 ::= { docsIfQosProfileEntry 5 } 1312 docsIfQosProfMaxTxBurst OBJECT-TYPE 1313 SYNTAX Integer32 (0..255) 1314 MAX-ACCESS read-create 1315 STATUS current 1316 DESCRIPTION 1317 "The maximum number of mini-slots that may be requested 1318 for a single upstream transmission. 1319 A value of zero means there is no limit. 1320 MUST NOT be changed while this row is active." 1321 DEFVAL { 0 } 1322 ::= { docsIfQosProfileEntry 6 } 1324 docsIfQosProfBaselinePrivacy OBJECT-TYPE 1325 SYNTAX TruthValue 1326 MAX-ACCESS read-create 1327 STATUS current 1328 DESCRIPTION 1329 "Indicates whether Baseline Privacy is enabled for this 1330 service class. 1331 MUST NOT be changed while this row is active." 1332 DEFVAL { false } 1333 ::= { docsIfQosProfileEntry 7 } 1335 docsIfQosProfStatus OBJECT-TYPE 1336 SYNTAX RowStatus 1337 MAX-ACCESS read-create 1338 STATUS current 1339 DESCRIPTION 1340 "This is object is to used to create or delete rows in 1341 this table. This object MUST NOT be changed from active while 1342 the row is referenced by the any entry in either 1343 docsIfCmServiceTable (on the CM), or the 1344 docsIfCmtsServiceTable (on the CMTS)." 1345 ::= { docsIfQosProfileEntry 8 } 1347 docsIfSignalQualityTable OBJECT-TYPE 1348 SYNTAX SEQUENCE OF DocsIfSignalQualityEntry 1349 MAX-ACCESS not-accessible 1350 STATUS current 1351 DESCRIPTION 1352 "At the CM, describes the PHY signal quality of downstream 1353 channels. At the CMTS, describes the PHY signal quality of 1354 upstream channels. At the CMTS, this table may exclude 1355 contention intervals." 1356 ::= { docsIfBaseObjects 4 } 1358 docsIfSignalQualityEntry OBJECT-TYPE 1359 SYNTAX DocsIfSignalQualityEntry 1360 MAX-ACCESS not-accessible 1361 STATUS current 1362 DESCRIPTION 1363 "At the CM, describes the PHY characteristics of a 1364 downstream channel. At the CMTS, describes the PHY signal 1365 quality of an upstream channel. 1366 An entry in this table exists for each ifEntry with an 1367 ifType of docsCableUpstream(129) for Cable Modem Termination 1368 Systems and docsCableDownstream(128) for Cable Modems." 1369 INDEX { ifIndex } 1370 ::= { docsIfSignalQualityTable 1 } 1372 DocsIfSignalQualityEntry ::= SEQUENCE { 1373 docsIfSigQIncludesContention TruthValue, 1374 docsIfSigQUnerroreds Counter32, 1375 docsIfSigQCorrecteds Counter32, 1376 docsIfSigQUncorrectables Counter32, 1377 docsIfSigQSignalNoise TenthdB, 1378 docsIfSigQMicroreflections Integer32, 1379 docsIfSigQEqualizationData OCTET STRING 1380 } 1382 docsIfSigQIncludesContention OBJECT-TYPE 1383 SYNTAX TruthValue 1384 MAX-ACCESS read-only 1385 STATUS current 1386 DESCRIPTION 1387 "true(1) if this CMTS includes contention intervals in 1388 the counters in this table. Always false(2) for CMs." 1389 REFERENCE 1390 "DOCSIS Radio Frequency Interface specification, 1391 Section 6.4.4" 1392 ::= { docsIfSignalQualityEntry 1 } 1394 docsIfSigQUnerroreds OBJECT-TYPE 1395 SYNTAX Counter32 1396 MAX-ACCESS read-only 1397 STATUS current 1398 DESCRIPTION 1399 "Codewords received on this channel without error. 1400 This includes all codewords, whether or not they 1401 were part of frames destined for this device." 1402 REFERENCE 1403 "DOCSIS Radio Frequency Interface specification, 1404 Section 4.2.3 and 4.3.6" 1405 ::= { docsIfSignalQualityEntry 2 } 1407 docsIfSigQCorrecteds OBJECT-TYPE 1408 SYNTAX Counter32 1409 MAX-ACCESS read-only 1410 STATUS current 1411 DESCRIPTION 1412 "Codewords received on this channel with correctable 1413 errors. This includes all codewords, whether or not 1414 they were part of frames destined for this device." 1415 REFERENCE 1416 "DOCSIS Radio Frequency Interface specification, 1417 Section 4.2.3 and 4.3.6" 1418 ::= { docsIfSignalQualityEntry 3 } 1420 docsIfSigQUncorrectables OBJECT-TYPE 1421 SYNTAX Counter32 1422 MAX-ACCESS read-only 1423 STATUS current 1424 DESCRIPTION 1425 "Codewords received on this channel with uncorrectable 1426 errors. This includes all codewords, whether or not 1427 they were part of frames destined for this device." 1428 REFERENCE 1429 "DOCSIS Radio Frequency Interface specification, 1430 Section 4.2.3 and 4.3.6" 1431 ::= { docsIfSignalQualityEntry 4 } 1433 docsIfSigQSignalNoise OBJECT-TYPE 1434 SYNTAX TenthdB 1435 UNITS "dB" 1436 MAX-ACCESS read-only 1437 STATUS current 1438 DESCRIPTION 1439 "Signal/Noise ratio as perceived for this channel. 1440 At the CM, describes the Signal/Noise of the downstream 1441 channel. At the CMTS, describes the average Signal/Noise 1442 of the upstream channel." 1443 REFERENCE 1444 "DOCSIS Radio Frequency Interface specification, 1445 Table 2-1 and 2-2" 1446 ::= { docsIfSignalQualityEntry 5 } 1448 docsIfSigQMicroreflections OBJECT-TYPE 1449 SYNTAX Integer32 (0..255) 1450 UNITS "dBc" 1451 MAX-ACCESS read-only 1452 STATUS current 1453 DESCRIPTION 1454 "Total microreflections including in-channel response 1455 as perceived on this interface, measured in dBc below 1456 the signal level. 1457 This object is not assumed to return an absolutely 1458 accurate value, but should give a rough indication 1459 of microreflections received on this interface. 1460 It is up to the implementor to provide information 1461 as accurate as possible." 1462 REFERENCE 1463 "DOCSIS Radio Frequency Interface specification, 1464 Table 2-1 and 2-2" 1465 ::= { docsIfSignalQualityEntry 6 } 1467 docsIfSigQEqualizationData OBJECT-TYPE 1468 SYNTAX OCTET STRING 1469 MAX-ACCESS read-only 1470 STATUS current 1471 DESCRIPTION 1472 "At the CM, returns the equalization data for the downstream 1473 channel. At the CMTS, returns the average equalization 1474 data for the upstream channel. Returns an empty string 1475 if the value is unknown or if there is no equalization 1476 data available or defined." 1477 REFERENCE 1478 "DOCSIS Radio Frequency Interface Specification, 1479 Figure 6-23." 1480 ::= { docsIfSignalQualityEntry 7 } 1482 -- 1483 -- CABLE MODEM GROUP 1484 -- 1486 -- ####### 1488 -- 1489 -- The CM MAC Table 1490 -- 1492 docsIfCmMacTable OBJECT-TYPE 1493 SYNTAX SEQUENCE OF DocsIfCmMacEntry 1494 MAX-ACCESS not-accessible 1495 STATUS current 1496 DESCRIPTION 1497 "Describes the attributes of each CM MAC interface, 1498 extending the information available from ifEntry." 1499 ::= { docsIfCmObjects 1 } 1501 docsIfCmMacEntry OBJECT-TYPE 1502 SYNTAX DocsIfCmMacEntry 1503 MAX-ACCESS not-accessible 1504 STATUS current 1505 DESCRIPTION 1506 "An entry containing objects describing attributes of 1507 each MAC entry, extending the information in ifEntry. 1508 An entry in this table exists for each ifEntry with an 1509 ifType of docsCableMaclayer(127)." 1510 INDEX { ifIndex } 1511 ::= { docsIfCmMacTable 1 } 1513 DocsIfCmMacEntry ::= SEQUENCE { 1514 docsIfCmCmtsAddress MacAddress, 1515 docsIfCmCapabilities BITS, 1516 docsIfCmRangingRespTimeout TimeTicks, 1517 docsIfCmRangingTimeout TimeInterval 1518 } 1520 docsIfCmCmtsAddress OBJECT-TYPE 1521 SYNTAX MacAddress 1522 MAX-ACCESS read-only 1523 STATUS current 1524 DESCRIPTION 1525 "Identifies the CMTS that is believed to control this MAC 1526 domain. At the CM, this will be the source address from 1527 SYNC, MAP, and other MAC-layer messages. If the CMTS is 1528 unknown, returns 00-00-00-00-00-00." 1529 ::= { docsIfCmMacEntry 1 } 1531 docsIfCmCapabilities OBJECT-TYPE 1532 SYNTAX BITS { 1533 atmCells(0), 1534 concatenation(1) 1535 } 1536 MAX-ACCESS read-only 1537 STATUS current 1538 DESCRIPTION 1539 "Identifies the capabilities of the MAC implementation 1540 at this interface. Note that packet transmission is 1541 always supported. Therefore, there is no specific bit 1542 required to explicitely indicate this capability." 1543 ::= { docsIfCmMacEntry 2 } 1545 -- This object has been obsoleted and replaced by 1546 -- docsIfCmRangingTimeout to correct the typing to TimeInterval. New 1547 -- implementations of the MIB should use docsIfCmRangingTimeout instead. 1549 docsIfCmRangingRespTimeout OBJECT-TYPE 1550 SYNTAX TimeTicks 1551 MAX-ACCESS read-write 1552 STATUS obsolete 1553 DESCRIPTION 1554 "Waiting time for a Ranging Response packet." 1555 REFERENCE 1556 "DOCSIS Radio Frequency Interface specification, 1557 Figure 7-6 and 7-7, timer T3." 1558 DEFVAL { 20 } 1559 ::= { docsIfCmMacEntry 3 } 1561 docsIfCmRangingTimeout OBJECT-TYPE 1562 SYNTAX TimeInterval 1563 MAX-ACCESS read-write 1564 STATUS current 1565 DESCRIPTION 1566 "Waiting time for a Ranging Response packet." 1567 REFERENCE 1568 "DOCSIS Radio Frequency Interface specification, 1569 Figure 7-6 and 7-7, timer T3." 1570 DEFVAL { 20 } 1571 ::= { docsIfCmMacEntry 4 } 1573 -- 1574 -- CM status table. 1575 -- This table is implemented only at the CM. 1576 -- 1578 docsIfCmStatusTable OBJECT-TYPE 1579 SYNTAX SEQUENCE OF DocsIfCmStatusEntry 1580 MAX-ACCESS not-accessible 1581 STATUS current 1582 DESCRIPTION 1583 "This table maintains a number of status objects 1584 and counters for Cable Modems." 1585 ::= { docsIfCmObjects 2 } 1587 docsIfCmStatusEntry OBJECT-TYPE 1588 SYNTAX DocsIfCmStatusEntry 1589 MAX-ACCESS not-accessible 1590 STATUS current 1591 DESCRIPTION 1592 "A set of status objects and counters for a single MAC 1593 layer instance in a Cable Modem. 1594 An entry in this table exists for each ifEntry with an 1595 ifType of docsCableMaclayer(127)." 1596 INDEX { ifIndex } 1597 ::= { docsIfCmStatusTable 1 } 1599 DocsIfCmStatusEntry ::= SEQUENCE { 1600 docsIfCmStatusValue INTEGER, 1601 docsIfCmStatusCode OCTET STRING, 1602 docsIfCmStatusTxPower TenthdBmV, 1603 docsIfCmStatusResets Counter32, 1604 docsIfCmStatusLostSyncs Counter32, 1605 docsIfCmStatusInvalidMaps Counter32, 1606 docsIfCmStatusInvalidUcds Counter32, 1607 -- docsIfCmStatusInvalidRangingResp Counter32, 1608 docsIfCmStatusInvalidRangingResponses Counter32, 1609 -- docsIfCmStatusInvalidRegistrationResp Counter32, 1610 docsIfCmStatusInvalidRegistrationResponses Counter32, 1611 docsIfCmStatusT1Timeouts Counter32, 1612 docsIfCmStatusT2Timeouts Counter32, 1613 docsIfCmStatusT3Timeouts Counter32, 1614 docsIfCmStatusT4Timeouts Counter32, 1615 docsIfCmStatusRangingAborteds Counter32 1616 } 1618 docsIfCmStatusValue OBJECT-TYPE 1619 SYNTAX INTEGER { 1620 other(1), 1621 notReady(2), 1622 notSynchronized(3), 1623 phySynchronized(4), 1624 usParametersAcquired(5), 1625 rangingComplete(6), 1626 ipComplete(7), 1627 todEstablished(8), 1628 securityEstablished(9), 1629 paramTransferComplete(10), 1630 registrationComplete(11), 1631 operational(12), 1632 accessDenied(13) 1633 } 1634 MAX-ACCESS read-only 1635 STATUS current 1636 DESCRIPTION 1637 "Current Cable Modem connectivity state, as specified 1638 in the RF Interface Specification." 1639 REFERENCE 1640 "DOCSIS Radio Frequency Interface Specification, 1641 Chapter 7.2." 1642 ::= { docsIfCmStatusEntry 1 } 1644 docsIfCmStatusCode OBJECT-TYPE 1645 SYNTAX OCTET STRING 1646 MAX-ACCESS read-only 1647 STATUS current 1648 DESCRIPTION 1649 "Status code for this Cable Modem as defined in the 1650 RF Interface Specification. The status code consists 1651 of a single character indicating error groups, followed 1652 by a two- or three-digit number indicating the status 1653 condition." 1654 REFERENCE 1655 "DOCSIS Radio Frequency Interface Specification, 1656 Cable Modem status codes." 1657 ::= { docsIfCmStatusEntry 2 } 1659 docsIfCmStatusTxPower OBJECT-TYPE 1660 SYNTAX TenthdBmV 1661 UNITS "dBmV" 1662 MAX-ACCESS read-only 1663 STATUS current 1664 DESCRIPTION 1665 "The operational transmit power for the attached upstream 1666 channel." 1667 REFERENCE 1668 "DOCSIS Radio Frequency Interface specification, 1669 Section 4.2.8." 1670 ::= { docsIfCmStatusEntry 3 } 1672 docsIfCmStatusResets OBJECT-TYPE 1673 SYNTAX Counter32 1674 MAX-ACCESS read-only 1675 STATUS current 1676 DESCRIPTION 1677 "Number of times the CM reset or initialized 1678 this interface." 1679 ::= { docsIfCmStatusEntry 4 } 1681 docsIfCmStatusLostSyncs OBJECT-TYPE 1682 SYNTAX Counter32 1683 MAX-ACCESS read-only 1684 STATUS current 1685 DESCRIPTION 1686 "Number of times the CM lost synchronization with 1687 the downstream channel." 1688 REFERENCE 1689 "DOCSIS Radio Frequency Interface specification, 1690 Section 6.5." 1691 ::= { docsIfCmStatusEntry 5 } 1693 docsIfCmStatusInvalidMaps OBJECT-TYPE 1694 SYNTAX Counter32 1695 MAX-ACCESS read-only 1696 STATUS current 1697 DESCRIPTION 1698 "Number of times the CM received invalid MAP messages." 1699 REFERENCE 1700 "DOCSIS Radio Frequency Interface specification, 1701 Section 6.3.2.3 and 6.4.2." 1702 ::= { docsIfCmStatusEntry 6 } 1704 docsIfCmStatusInvalidUcds OBJECT-TYPE 1705 SYNTAX Counter32 1706 MAX-ACCESS read-only 1707 STATUS current 1708 DESCRIPTION 1709 "Number of times the CM received invalid UCD messages." 1710 REFERENCE 1711 "DOCSIS Radio Frequency Interface specification, 1712 Section 6.3.2.2." 1713 ::= { docsIfCmStatusEntry 7 } 1715 -- docsIfCmStatusInvalidRangingResp replaced for Counter32 1716 -- naming requirements 1717 docsIfCmStatusInvalidRangingResponses OBJECT-TYPE 1718 SYNTAX Counter32 1719 MAX-ACCESS read-only 1720 STATUS current 1721 DESCRIPTION 1722 "Number of times the CM received invalid ranging response 1723 messages." 1724 ::= { docsIfCmStatusEntry 8 } 1726 -- docsIfCmStatusInvalidRegistrationResp replaced for 1727 -- Counter32 naming requirements 1728 docsIfCmStatusInvalidRegistrationResponses OBJECT-TYPE 1729 SYNTAX Counter32 1730 MAX-ACCESS read-only 1731 STATUS current 1732 DESCRIPTION 1733 "Number of times the CM received invalid registration 1734 response messages." 1735 ::= { docsIfCmStatusEntry 9 } 1737 docsIfCmStatusT1Timeouts OBJECT-TYPE 1738 SYNTAX Counter32 1739 MAX-ACCESS read-only 1740 STATUS current 1741 DESCRIPTION 1742 "Number of times counter T1 expired in the CM." 1743 REFERENCE 1744 "DOCSIS Radio Frequency Interface specification, 1745 Figure 7-3." 1746 ::= { docsIfCmStatusEntry 10 } 1748 docsIfCmStatusT2Timeouts OBJECT-TYPE 1749 SYNTAX Counter32 1750 MAX-ACCESS read-only 1751 STATUS current 1752 DESCRIPTION 1753 "Number of times counter T2 expired in the CM." 1754 REFERENCE 1755 "DOCSIS Radio Frequency Interface specification, 1756 Figure 7-6." 1757 ::= { docsIfCmStatusEntry 11 } 1759 docsIfCmStatusT3Timeouts OBJECT-TYPE 1760 SYNTAX Counter32 1761 MAX-ACCESS read-only 1762 STATUS current 1763 DESCRIPTION 1764 "Number of times counter T3 expired in the CM." 1765 REFERENCE 1766 "DOCSIS Radio Frequency Interface specification, 1767 Figure 7-6 and 7-7." 1768 ::= { docsIfCmStatusEntry 12 } 1770 docsIfCmStatusT4Timeouts OBJECT-TYPE 1771 SYNTAX Counter32 1772 MAX-ACCESS read-only 1773 STATUS current 1774 DESCRIPTION 1775 "Number of times counter T4 expired in the CM." 1776 REFERENCE 1777 "DOCSIS Radio Frequency Interface specification, 1778 Figure 7-7." 1779 ::= { docsIfCmStatusEntry 13 } 1781 docsIfCmStatusRangingAborteds OBJECT-TYPE 1782 SYNTAX Counter32 1783 MAX-ACCESS read-only 1784 STATUS current 1785 DESCRIPTION 1786 "Number of times the ranging process was aborted 1787 by the CMTS." 1788 ::= { docsIfCmStatusEntry 14 } 1790 -- 1791 -- The Cable Modem Service Table 1792 -- 1794 docsIfCmServiceTable OBJECT-TYPE 1795 SYNTAX SEQUENCE OF DocsIfCmServiceEntry 1796 MAX-ACCESS not-accessible 1797 STATUS current 1798 DESCRIPTION 1799 "Describes the attributes of each upstream service queue 1800 on a CM." 1801 ::= { docsIfCmObjects 3 } 1803 docsIfCmServiceEntry OBJECT-TYPE 1804 SYNTAX DocsIfCmServiceEntry 1805 MAX-ACCESS not-accessible 1806 STATUS current 1807 DESCRIPTION 1808 "Describes the attributes of an upstream bandwidth service 1809 queue. 1810 An entry in this table exists for each Service ID. 1811 The primary index is an ifIndex with an ifType of 1812 docsCableMaclayer(127)." 1813 INDEX { ifIndex, docsIfCmServiceId } 1814 ::= { docsIfCmServiceTable 1 } 1816 DocsIfCmServiceEntry ::= SEQUENCE { 1817 docsIfCmServiceId Integer32, 1818 docsIfCmServiceQosProfile Integer32, 1819 docsIfCmServiceTxSlotsImmed Counter32, 1820 docsIfCmServiceTxSlotsDed Counter32, 1821 docsIfCmServiceTxRetries Counter32, 1823 -- docsIfCmServiceTxExceeded Counter32, 1824 docsIfCmServiceTxExceededs Counter32, 1825 docsIfCmServiceRqRetries Counter32, 1826 -- docsIfCmServiceRqExceeded Counter32 1827 docsIfCmServiceRqExceededs Counter32 1828 } 1830 docsIfCmServiceId OBJECT-TYPE 1831 SYNTAX Integer32 (1..16383) 1832 MAX-ACCESS not-accessible 1833 STATUS current 1834 DESCRIPTION 1835 "Identifies a service queue for upstream bandwidth. The 1836 attributes of this service queue are shared between the 1837 CM and the CMTS. The CMTS allocates upstream bandwidth 1838 to this service queue based on requests from the CM and 1839 on the class of service associated with this queue." 1840 ::= { docsIfCmServiceEntry 1 } 1842 docsIfCmServiceQosProfile OBJECT-TYPE 1843 SYNTAX Integer32 (0..16383) 1844 MAX-ACCESS read-only 1845 STATUS current 1846 DESCRIPTION 1847 "The index in docsIfQosProfileTable describing the quality 1848 of service attributes associated with this particular 1849 service. If no associated entry in docsIfQosProfileTable 1850 exists, this object returns a value of zero." 1851 ::= { docsIfCmServiceEntry 2 } 1853 docsIfCmServiceTxSlotsImmed OBJECT-TYPE 1854 SYNTAX Counter32 1855 MAX-ACCESS read-only 1856 STATUS current 1857 DESCRIPTION 1858 "The number of upstream mini-slots which have been used to 1859 transmit data PDUs in immediate (contention) mode. This 1860 includes only those PDUs which are presumed to have 1861 arrived at the headend (i.e., those which were explicitly 1862 acknowledged.) It does not include retransmission attempts 1863 or mini-slots used by Requests." 1864 REFERENCE 1865 "DOCSIS Radio Frequency Interface specification, 1866 Section 6.4." 1867 ::= { docsIfCmServiceEntry 3 } 1869 docsIfCmServiceTxSlotsDed OBJECT-TYPE 1870 SYNTAX Counter32 1871 MAX-ACCESS read-only 1872 STATUS current 1873 DESCRIPTION 1874 "The number of upstream mini-slots which have been used to 1875 transmit data PDUs in dedicated mode (i.e., as a result 1876 of a unicast Data Grant)." 1877 REFERENCE 1878 "DOCSIS Radio Frequency Interface specification, 1879 Section 6.4." 1880 ::= { docsIfCmServiceEntry 4 } 1882 docsIfCmServiceTxRetries OBJECT-TYPE 1883 SYNTAX Counter32 1884 MAX-ACCESS read-only 1885 STATUS current 1886 DESCRIPTION 1887 "The number of attempts to transmit data PDUs containing 1888 requests for acknowledgment which did not result in 1889 acknowledgment." 1890 REFERENCE 1891 "DOCSIS Radio Frequency Interface specification, 1892 Section 6.4." 1893 ::= { docsIfCmServiceEntry 5 } 1895 -- docsIfCmServiceTxExceeded renamed for Counter32 naming requirements 1896 docsIfCmServiceTxExceededs OBJECT-TYPE 1897 SYNTAX Counter32 1898 MAX-ACCESS read-only 1899 STATUS current 1900 DESCRIPTION 1901 "The number of data PDUs transmission failures due to 1902 excessive retries without acknowledgment." 1903 REFERENCE 1904 "DOCSIS Radio Frequency Interface specification, 1905 Section 6.4." 1906 ::= { docsIfCmServiceEntry 6 } 1908 docsIfCmServiceRqRetries OBJECT-TYPE 1909 SYNTAX Counter32 1910 MAX-ACCESS read-only 1911 STATUS current 1912 DESCRIPTION 1913 "The number of attempts to transmit bandwidth requests 1914 which did not result in acknowledgment." 1915 REFERENCE 1916 "DOCSIS Radio Frequency Interface specification, 1917 Section 6.4." 1918 ::= { docsIfCmServiceEntry 7 } 1920 -- docsIfCmServiceRqExceeded renamed for Counter 32 naming 1921 -- requirements 1922 docsIfCmServiceRqExceededs OBJECT-TYPE 1923 SYNTAX Counter32 1924 MAX-ACCESS read-only 1925 STATUS current 1926 DESCRIPTION 1927 "The number of requests for bandwidth which failed due to 1928 excessive retries without acknowledgment." 1929 REFERENCE 1930 "DOCSIS Radio Frequency Interface specification, 1931 Section 6.4." 1932 ::= { docsIfCmServiceEntry 8 } 1934 -- 1935 -- CMTS GROUP 1936 -- 1938 -- 1939 -- The CMTS MAC Table 1940 -- 1942 docsIfCmtsMacTable OBJECT-TYPE 1943 SYNTAX SEQUENCE OF DocsIfCmtsMacEntry 1944 MAX-ACCESS not-accessible 1945 STATUS current 1946 DESCRIPTION 1947 "Describes the attributes of each CMTS MAC interface, 1948 extending the information available from ifEntry. 1949 Mandatory for all CMTS devices." 1950 ::= { docsIfCmtsObjects 1 } 1952 docsIfCmtsMacEntry OBJECT-TYPE 1953 SYNTAX DocsIfCmtsMacEntry 1954 MAX-ACCESS not-accessible 1955 STATUS current 1956 DESCRIPTION 1957 "An entry containing objects describing attributes of each 1958 MAC entry, extending the information in ifEntry. 1959 An entry in this table exists for each ifEntry with an 1960 ifType of docsCableMaclayer(127)." 1961 INDEX { ifIndex } 1962 ::= { docsIfCmtsMacTable 1 } 1964 DocsIfCmtsMacEntry ::= SEQUENCE { 1965 docsIfCmtsCapabilities BITS, 1966 docsIfCmtsSyncInterval Integer32, 1967 docsIfCmtsUcdInterval Integer32, 1968 docsIfCmtsMaxServiceIds Integer32, 1969 docsIfCmtsInsertionInterval TimeTicks, -- Obsolete 1970 docsIfCmtsInvitedRangingAttempts Integer32, 1971 docsIfCmtsInsertInterval TimeInterval 1972 } 1974 docsIfCmtsCapabilities OBJECT-TYPE 1975 SYNTAX BITS { 1976 atmCells(0), 1977 concatenation(1) 1979 } 1980 MAX-ACCESS read-only 1981 STATUS current 1982 DESCRIPTION 1983 "Identifies the capabilities of the CMTS MAC 1984 implementation at this interface. Note that packet 1985 transmission is always supported. Therefore, there 1986 is no specific bit required to explicitely indicate 1987 this capability." 1988 REFERENCE 1989 "DOCSIS Radio Frequency Interface specification, 1990 Chapter 6." 1991 ::= { docsIfCmtsMacEntry 1 } 1993 docsIfCmtsSyncInterval OBJECT-TYPE 1994 SYNTAX Integer32 (1..200) 1995 UNITS "Milliseconds" 1996 MAX-ACCESS read-write 1997 STATUS current 1998 DESCRIPTION 1999 "The interval between CMTS transmission of successive SYNC 2000 messages at this interface." 2001 REFERENCE 2002 "DOCSIS Radio Frequency Interface Specification, 2003 Section 6.5 and Appendix B." 2004 ::= { docsIfCmtsMacEntry 2 } 2006 docsIfCmtsUcdInterval OBJECT-TYPE 2007 SYNTAX Integer32 (1..2000) 2008 UNITS "Milliseconds" 2009 MAX-ACCESS read-write 2010 STATUS current 2011 DESCRIPTION 2012 "The interval between CMTS transmission of successive 2013 Upstream Channel Descriptor messages for each upstream 2014 channel at this interface." 2015 REFERENCE 2016 "DOCSIS Radio Frequency Interface Specification, 2017 Section 6.5 and Appendix B." 2018 ::= { docsIfCmtsMacEntry 3 } 2020 docsIfCmtsMaxServiceIds OBJECT-TYPE 2021 SYNTAX Integer32 (1..16383) 2022 MAX-ACCESS read-only 2023 STATUS current 2024 DESCRIPTION 2025 "The maximum number of service IDs that may be 2026 simultaneously active." 2027 ::= { docsIfCmtsMacEntry 4 } 2029 -- This object has been obsoleted and replaced by 2030 -- docsIfCmtsInsertInterval to fix a SYNTAX typing problem. New 2031 -- implementations of this MIB should use that object instead. 2032 docsIfCmtsInsertionInterval OBJECT-TYPE 2033 SYNTAX TimeTicks 2034 MAX-ACCESS read-write 2035 STATUS obsolete 2036 DESCRIPTION 2037 "The amount of time to elapse between each broadcast 2038 station maintenance grant. Broadcast station maintenance 2039 grants are used to allow new cable modems to join the 2040 network. Zero indicates that a vendor-specific algorithm 2041 is used instead of a fixed time. Maximum amount of time 2042 permitted by the specification is 2 seconds." 2043 REFERENCE 2044 "DOCSIS Radio Frequency Interface Specification, 2045 Appendix B, Ranging Interval." 2046 ::= { docsIfCmtsMacEntry 5 } 2048 docsIfCmtsInvitedRangingAttempts OBJECT-TYPE 2049 SYNTAX Integer32 (0..1024) 2050 MAX-ACCESS read-write 2051 STATUS current 2052 DESCRIPTION 2053 "The maximum number of attempts to make on invitations 2054 for ranging requests. A value of zero means the system 2055 should attempt to range forever." 2056 REFERENCE 2057 "DOCSIS Radio Frequency Interface specification, 2058 Section 7.2.5 and Appendix B." 2059 ::= { docsIfCmtsMacEntry 6 } 2061 docsIfCmtsInsertInterval OBJECT-TYPE 2062 SYNTAX TimeInterval 2063 MAX-ACCESS read-write 2064 STATUS current 2065 DESCRIPTION 2066 "The amount of time to elapse between each broadcast 2067 station maintenance grant. Broadcast station maintenance 2068 grants are used to allow new cable modems to join the 2069 network. Zero indicates that a vendor-specific algorithm 2070 is used instead of a fixed time. Maximum amount of time 2071 permitted by the specification is 2 seconds." 2072 REFERENCE 2073 "DOCSIS Radio Frequency Interface Specification, 2074 Appendix B." 2075 ::= { docsIfCmtsMacEntry 7 } 2077 -- 2078 -- 2079 -- CMTS status table. 2080 -- 2081 docsIfCmtsStatusTable OBJECT-TYPE 2082 SYNTAX SEQUENCE OF DocsIfCmtsStatusEntry 2083 MAX-ACCESS not-accessible 2084 STATUS current 2085 DESCRIPTION 2086 "For the MAC layer, this group maintains a number of 2087 status objects and counters." 2088 ::= { docsIfCmtsObjects 2 } 2090 docsIfCmtsStatusEntry OBJECT-TYPE 2091 SYNTAX DocsIfCmtsStatusEntry 2092 MAX-ACCESS not-accessible 2093 STATUS current 2094 DESCRIPTION 2095 "Status entry for a single MAC layer. 2096 An entry in this table exists for each ifEntry with an 2097 ifType of docsCableMaclayer(127)." 2098 INDEX { ifIndex } 2099 ::= { docsIfCmtsStatusTable 1 } 2101 DocsIfCmtsStatusEntry ::= SEQUENCE { 2102 docsIfCmtsStatusInvalidRangeReqs Counter32, 2103 docsIfCmtsStatusRangingAborteds Counter32, 2104 docsIfCmtsStatusInvalidRegReqs Counter32, 2105 docsIfCmtsStatusFailedRegReqs Counter32, 2106 docsIfCmtsStatusInvalidDataReqs Counter32, 2107 docsIfCmtsStatusT5Timeouts Counter32 2108 } 2110 docsIfCmtsStatusInvalidRangeReqs OBJECT-TYPE 2111 SYNTAX Counter32 2112 MAX-ACCESS read-only 2113 STATUS current 2114 DESCRIPTION 2115 "This object counts invalid RNG-REQ messages received on 2116 this interface." 2117 ::= { docsIfCmtsStatusEntry 1 } 2119 docsIfCmtsStatusRangingAborteds OBJECT-TYPE 2120 SYNTAX Counter32 2121 MAX-ACCESS read-only 2122 STATUS current 2123 DESCRIPTION 2124 "This object counts ranging attempts that were explicitely 2125 aborted by the CMTS." 2126 ::= { docsIfCmtsStatusEntry 2 } 2128 docsIfCmtsStatusInvalidRegReqs OBJECT-TYPE 2129 SYNTAX Counter32 2130 MAX-ACCESS read-only 2131 STATUS current 2132 DESCRIPTION 2133 "This object counts invalid REG-REQ messages received on 2134 this interface." 2135 ::= { docsIfCmtsStatusEntry 3 } 2137 docsIfCmtsStatusFailedRegReqs OBJECT-TYPE 2138 SYNTAX Counter32 2139 MAX-ACCESS read-only 2140 STATUS current 2141 DESCRIPTION 2142 "This object counts failed registration attempts, i.e., 2143 authentication failures and class of service failures, 2144 on this interface." 2145 ::= { docsIfCmtsStatusEntry 4 } 2147 docsIfCmtsStatusInvalidDataReqs OBJECT-TYPE 2148 SYNTAX Counter32 2149 MAX-ACCESS read-only 2150 STATUS current 2151 DESCRIPTION 2152 "This object counts invalid data request messages 2153 received on this interface." 2154 ::= { docsIfCmtsStatusEntry 5 } 2156 docsIfCmtsStatusT5Timeouts OBJECT-TYPE 2157 SYNTAX Counter32 2158 MAX-ACCESS read-only 2159 STATUS current 2160 DESCRIPTION 2161 "This object counts the number of times counter T5 2162 expired on this interface." 2163 ::= { docsIfCmtsStatusEntry 6 } 2165 -- 2166 -- CM status table (within CMTS). 2167 -- This table is implemented only at the CMTS. 2168 -- It contains per CM status information available in the CMTS. 2169 -- 2171 docsIfCmtsCmStatusTable OBJECT-TYPE 2172 SYNTAX SEQUENCE OF DocsIfCmtsCmStatusEntry 2173 MAX-ACCESS not-accessible 2174 STATUS current 2175 DESCRIPTION 2176 "A set of objects in the CMTS, maintained for each 2177 Cable Modem connected to this CMTS." 2178 ::= { docsIfCmtsObjects 3 } 2180 docsIfCmtsCmStatusEntry OBJECT-TYPE 2181 SYNTAX DocsIfCmtsCmStatusEntry 2182 MAX-ACCESS not-accessible 2183 STATUS current 2184 DESCRIPTION 2185 "Status information for a single Cable Modem. 2186 An entry in this table exists for each Cable Modem 2187 that is connected to the CMTS implementing this table." 2188 INDEX { docsIfCmtsCmStatusIndex } 2189 ::= { docsIfCmtsCmStatusTable 1 } 2191 DocsIfCmtsCmStatusEntry ::= SEQUENCE { 2192 docsIfCmtsCmStatusIndex Integer32, 2193 docsIfCmtsCmStatusMacAddress MacAddress, 2194 docsIfCmtsCmStatusIpAddress IpAddress, 2195 docsIfCmtsCmStatusDownChannelIfIndex InterfaceIndexOrZero, 2196 docsIfCmtsCmStatusUpChannelIfIndex InterfaceIndexOrZero, 2197 docsIfCmtsCmStatusRxPower TenthdBmV, 2198 docsIfCmtsCmStatusTimingOffset Unsigned32, 2199 docsIfCmtsCmStatusEqualizationData OCTET STRING, 2200 docsIfCmtsCmStatusValue INTEGER, 2201 docsIfCmtsCmStatusUnerroreds Counter32, 2202 docsIfCmtsCmStatusCorrecteds Counter32, 2203 docsIfCmtsCmStatusUncorrectables Counter32, 2204 docsIfCmtsCmStatusSignalNoise TenthdB, 2205 docsIfCmtsCmStatusMicroreflections Integer32 2206 } 2208 docsIfCmtsCmStatusIndex OBJECT-TYPE 2209 SYNTAX Integer32 (1..2147483647) 2210 MAX-ACCESS not-accessible 2211 STATUS current 2212 DESCRIPTION 2213 "Index value to uniquely identify an entry in this table. 2214 For an individual Cable Modem, this index value should 2215 not change during CMTS uptime." 2216 ::= { docsIfCmtsCmStatusEntry 1 } 2218 docsIfCmtsCmStatusMacAddress OBJECT-TYPE 2219 SYNTAX MacAddress 2220 MAX-ACCESS read-only 2221 STATUS current 2222 DESCRIPTION 2223 "MAC address of this Cable Modem. If the Cable Modem has 2224 multiple MAC addresses, this is the MAC address associated 2225 with the Cable interface." 2226 ::= { docsIfCmtsCmStatusEntry 2 } 2228 docsIfCmtsCmStatusIpAddress OBJECT-TYPE 2229 SYNTAX IpAddress 2230 MAX-ACCESS read-only 2231 STATUS current 2232 DESCRIPTION 2233 "IP address of this Cable Modem. If the Cable Modem has no 2234 IP address assigned, or the IP address is unknown, this 2235 object returns a value of 0.0.0.0. If the Cable Modem has 2236 multiple IP addresses, this object returns the IP address 2237 associated with the Cable interface." 2238 ::= { docsIfCmtsCmStatusEntry 3 } 2240 docsIfCmtsCmStatusDownChannelIfIndex OBJECT-TYPE 2241 SYNTAX InterfaceIndexOrZero 2242 MAX-ACCESS read-only 2243 STATUS current 2244 DESCRIPTION 2245 "IfIndex of the downstream channel this CM is connected 2246 to. If the downstream channel is unknown, this object 2247 returns a value of zero." 2248 ::= { docsIfCmtsCmStatusEntry 4 } 2250 docsIfCmtsCmStatusUpChannelIfIndex OBJECT-TYPE 2251 SYNTAX InterfaceIndexOrZero 2252 MAX-ACCESS read-only 2253 STATUS current 2254 DESCRIPTION 2255 "IfIndex of the upstream channel this CM is connected 2256 to. If the upstream channel is unknown, this object 2257 returns a value of zero." 2258 ::= { docsIfCmtsCmStatusEntry 5 } 2260 docsIfCmtsCmStatusRxPower OBJECT-TYPE 2261 SYNTAX TenthdBmV 2262 UNITS "dBmV" 2263 MAX-ACCESS read-only 2264 STATUS current 2265 DESCRIPTION 2266 "The receive power as percieved for upstream data from 2267 this Cable Modem. 2268 If the receive power is unknown, this object returns 2269 a value of zero." 2270 REFERENCE 2271 "DOCSIS Radio Frequency Interface Specification, 2272 Table 4-13." 2273 ::= { docsIfCmtsCmStatusEntry 6 } 2275 docsIfCmtsCmStatusTimingOffset OBJECT-TYPE 2276 SYNTAX Unsigned32 2277 MAX-ACCESS read-only 2278 STATUS current 2279 DESCRIPTION 2280 "A measure of the current round trip time for this CM. 2281 Used for timing of CM upstream transmissions to ensure 2282 synchronized arrivals at the CMTS. Units are in terms 2283 of (6.25 microseconds/64). Returns zero if the value 2284 is unknown." 2285 REFERENCE 2286 "DOCSIS Radio Frequency Interface Specification, 2287 Section 6.5." 2288 ::= { docsIfCmtsCmStatusEntry 7 } 2290 docsIfCmtsCmStatusEqualizationData OBJECT-TYPE 2291 SYNTAX OCTET STRING 2292 MAX-ACCESS read-only 2293 STATUS current 2294 DESCRIPTION 2295 "Equalization data for this CM. Returns an empty string 2296 if the value is unknown or if there is no equalization 2297 data available or defined." 2298 REFERENCE 2299 "DOCSIS Radio Frequency Interface Specification, 2300 Figure 6-23." 2301 ::= { docsIfCmtsCmStatusEntry 8 } 2303 docsIfCmtsCmStatusValue OBJECT-TYPE 2304 SYNTAX INTEGER { 2305 other(1), 2306 ranging(2), 2307 rangingAborted(3), 2308 rangingComplete(4), 2309 ipComplete(5), 2310 registrationComplete(6), 2311 accessDenied(7) 2312 } 2313 MAX-ACCESS read-only 2314 STATUS current 2315 DESCRIPTION 2316 "Current Cable Modem connectivity state, as specified 2317 in the RF Interface Specification. Returned status 2318 information is the CM status as assumed by the CMTS, 2319 and indicates the following events: 2320 other(1) 2321 Any state other than below. 2322 ranging(2) 2323 The CMTS has received an Initial Ranging Request 2324 message from the CM, and the ranging process is not 2325 yet complete. 2326 rangingAborted(3) 2327 The CMTS has sent a Ranging Abort message to the CM. 2328 rangingComplete(4) 2329 The CMTS has sent a Ranging Complete message to the CM. 2330 ipComplete(5) 2331 The CMTS has received a DHCP reply message and forwarded 2332 it to the CM. 2333 registrationComplete(6) 2334 The CMTS has sent a Registration Response mesage to 2335 the CM. 2336 accessDenied(7) 2337 The CMTS has sent a Registration Aborted message 2338 to the CM. 2339 The CMTS only needs to report states it is able to detect." 2340 REFERENCE 2341 "DOCSIS Radio Frequency Interface Specification, 2342 Chapter 7.2." 2343 ::= { docsIfCmtsCmStatusEntry 9 } 2345 docsIfCmtsCmStatusUnerroreds OBJECT-TYPE 2346 SYNTAX Counter32 2347 MAX-ACCESS read-only 2348 STATUS current 2349 DESCRIPTION 2350 "Codewords received without error from this Cable Modem." 2351 REFERENCE 2352 "DOCSIS Radio Frequency Interface specification, 2353 Section 4.2.3" 2354 ::= { docsIfCmtsCmStatusEntry 10 } 2356 docsIfCmtsCmStatusCorrecteds OBJECT-TYPE 2357 SYNTAX Counter32 2358 MAX-ACCESS read-only 2359 STATUS current 2360 DESCRIPTION 2361 "Codewords received with correctable errors from this 2362 Cable Modem." 2363 REFERENCE 2364 "DOCSIS Radio Frequency Interface specification, 2365 Section 4.2.3" 2366 ::= { docsIfCmtsCmStatusEntry 11 } 2368 docsIfCmtsCmStatusUncorrectables OBJECT-TYPE 2369 SYNTAX Counter32 2370 MAX-ACCESS read-only 2371 STATUS current 2372 DESCRIPTION 2373 "Codewords received with uncorrectable errors from this 2374 Cable Modem." 2375 REFERENCE 2376 "DOCSIS Radio Frequency Interface specification, 2377 Section 4.2.3" 2378 ::= { docsIfCmtsCmStatusEntry 12 } 2380 docsIfCmtsCmStatusSignalNoise OBJECT-TYPE 2381 SYNTAX TenthdB 2382 UNITS "dB" 2383 MAX-ACCESS read-only 2384 STATUS current 2385 DESCRIPTION 2386 "Signal/Noise ratio as perceived for upstream data from 2387 this Cable Modem. 2388 If the Signal/Noise is unknown, this object returns 2389 a value of zero." 2390 ::= { docsIfCmtsCmStatusEntry 13 } 2392 docsIfCmtsCmStatusMicroreflections OBJECT-TYPE 2393 SYNTAX Integer32 (0..255) 2394 UNITS "dBc" 2395 MAX-ACCESS read-only 2396 STATUS current 2397 DESCRIPTION 2398 "Total microreflections including in-channel response 2399 as perceived on this interface, measured in dBc below 2400 the signal level. 2401 This object is not assumed to return an absolutely 2402 accurate value, but should give a rough indication 2403 of microreflections received on this interface. 2404 It is up to the implementor to provide information 2405 as accurate as possible." 2406 REFERENCE 2407 "DOCSIS Radio Frequency Interface specification, 2408 Table 2-1 and 2-2" 2409 ::= { docsIfCmtsCmStatusEntry 14 } 2411 -- 2412 -- The CMTS Service Table. 2413 -- 2415 docsIfCmtsServiceTable OBJECT-TYPE 2416 SYNTAX SEQUENCE OF DocsIfCmtsServiceEntry 2417 MAX-ACCESS not-accessible 2418 STATUS current 2419 DESCRIPTION 2420 "Describes the attributes of upstream service queues 2421 in a Cable Modem Termination System." 2422 ::= { docsIfCmtsObjects 4 } 2424 docsIfCmtsServiceEntry OBJECT-TYPE 2425 SYNTAX DocsIfCmtsServiceEntry 2426 MAX-ACCESS not-accessible 2427 STATUS current 2428 DESCRIPTION 2429 "Describes the attributes of a single upstream bandwidth 2430 service queue. 2431 Entries in this table exist for each ifEntry with an 2432 ifType of docsCableMaclayer(127), and for each service 2433 queue (Service ID) within this MAC layer. 2434 Entries in this table are created with the creation of 2435 individual Service IDs by the MAC layer and removed 2436 when a Service ID is removed." 2437 INDEX { ifIndex, docsIfCmtsServiceId } 2438 ::= { docsIfCmtsServiceTable 1 } 2440 DocsIfCmtsServiceEntry ::= SEQUENCE { 2441 docsIfCmtsServiceId Integer32, 2442 docsIfCmtsServiceCmStatusIndex Integer32, 2443 docsIfCmtsServiceAdminStatus INTEGER, 2444 docsIfCmtsServiceQosProfile Integer32, 2445 docsIfCmtsServiceCreateTime TimeStamp, 2446 docsIfCmtsServiceInOctets Counter32, 2447 docsIfCmtsServiceInPackets Counter32 2448 } 2450 docsIfCmtsServiceId OBJECT-TYPE 2451 SYNTAX Integer32 (1..16383) 2452 MAX-ACCESS not-accessible 2453 STATUS current 2454 DESCRIPTION 2455 "Identifies a service queue for upstream bandwidth. The 2456 attributes of this service queue are shared between the 2457 Cable Modem and the Cable Modem Termination System. 2458 The CMTS allocates upstream bandwidth to this service 2459 queue based on requests from the CM and on the class of 2460 service associated with this queue." 2461 ::= { docsIfCmtsServiceEntry 1 } 2463 docsIfCmtsServiceCmStatusIndex OBJECT-TYPE 2464 SYNTAX Integer32 (0..65535) 2465 MAX-ACCESS read-only 2466 STATUS current 2467 DESCRIPTION 2468 "Pointer to an entry in docsIfCmtsCmStatusTable identifying 2469 the Cable Modem using this Service Queue. If multiple 2470 Cable Modems are using this Service Queue, the value of 2471 this object is zero." 2472 ::= { docsIfCmtsServiceEntry 2 } 2474 docsIfCmtsServiceAdminStatus OBJECT-TYPE 2475 SYNTAX INTEGER { 2476 enabled(1), 2477 disabled(2), 2478 destroyed(3) } 2479 MAX-ACCESS read-write 2480 STATUS current 2481 DESCRIPTION 2482 "Allows a service class for a particular modem to be 2483 suppressed, (re-)enabled, or deleted altogether." 2484 ::= { docsIfCmtsServiceEntry 3 } 2486 docsIfCmtsServiceQosProfile OBJECT-TYPE 2487 SYNTAX Integer32 (0..16383) 2488 MAX-ACCESS read-only 2489 STATUS current 2490 DESCRIPTION 2491 "The index in docsIfQosProfileTable describing the quality 2492 of service attributes associated with this particular 2493 service. If no associated docsIfQosProfileTable entry 2494 exists, this object returns a value of zero." 2495 ::= { docsIfCmtsServiceEntry 4 } 2497 docsIfCmtsServiceCreateTime OBJECT-TYPE 2498 -- SYNTAX TimeTicks 2499 SYNTAX TimeStamp 2500 MAX-ACCESS read-only 2501 STATUS current 2502 DESCRIPTION 2503 "The value of sysUpTime when this entry was created." 2504 ::= { docsIfCmtsServiceEntry 5 } 2506 docsIfCmtsServiceInOctets OBJECT-TYPE 2507 SYNTAX Counter32 2508 MAX-ACCESS read-only 2509 STATUS current 2510 DESCRIPTION 2511 "The cumulative number of Packet Data octets received 2512 on this Service ID. The count does not include the 2513 size of the Cable MAC header" 2514 ::= { docsIfCmtsServiceEntry 6 } 2516 docsIfCmtsServiceInPackets OBJECT-TYPE 2517 SYNTAX Counter32 2518 MAX-ACCESS read-only 2519 STATUS current 2520 DESCRIPTION 2521 "The cumulative number of Packet Data packets received 2522 on this Service ID." 2523 ::= { docsIfCmtsServiceEntry 7 } 2525 -- 2526 -- The following table provides upstream channel modulation profiles. 2527 -- Entries in this table can be 2528 -- re-used by one or more upstream channels. An upstream channel will 2529 -- have a modulation profile 2530 -- for each value of docsIfModIntervalUsageCode. 2531 -- 2533 docsIfCmtsModulationTable OBJECT-TYPE 2534 SYNTAX SEQUENCE OF DocsIfCmtsModulationEntry 2535 MAX-ACCESS not-accessible 2536 STATUS current 2537 DESCRIPTION 2538 "Describes a modulation profile associated with one or more 2539 upstream channels." 2540 ::= { docsIfCmtsObjects 5 } 2542 docsIfCmtsModulationEntry OBJECT-TYPE 2543 SYNTAX DocsIfCmtsModulationEntry 2544 MAX-ACCESS not-accessible 2545 STATUS current 2546 DESCRIPTION 2547 "Describes a modulation profile for an Interval Usage Code 2548 for one or more upstream channels. 2549 Entries in this table are created by the operator. Initial 2550 default entries may be created at system initialization 2551 time. No individual objects have to be specified in order 2552 to create an entry in this table. 2553 Note that some objects do not have DEFVALs, but do have 2554 calculated defaults and need not be specified during row 2555 creation. 2556 There is no restriction on the changing of values in this 2557 table while their associated rows are active." 2558 INDEX { docsIfCmtsModIndex, docsIfCmtsModIntervalUsageCode } 2559 ::= { docsIfCmtsModulationTable 1 } 2561 DocsIfCmtsModulationEntry ::= SEQUENCE { 2562 docsIfCmtsModIndex Integer32, 2563 docsIfCmtsModIntervalUsageCode INTEGER, 2564 docsIfCmtsModControl RowStatus, 2565 docsIfCmtsModType INTEGER, 2566 docsIfCmtsModPreambleLen Integer32, 2567 docsIfCmtsModDifferentialEncoding TruthValue, 2568 docsIfCmtsModFECErrorCorrection Integer32, 2569 docsIfCmtsModFECCodewordLength Integer32, 2570 docsIfCmtsModScramblerSeed Integer32, 2571 docsIfCmtsModMaxBurstSize Integer32, 2572 docsIfCmtsModGuardTimeSize Unsigned32, 2573 docsIfCmtsModLastCodewordShortened TruthValue, 2574 docsIfCmtsModScrambler TruthValue 2575 } 2577 docsIfCmtsModIndex OBJECT-TYPE 2578 SYNTAX Integer32 (1..2147483647) 2579 MAX-ACCESS not-accessible 2580 STATUS current 2581 DESCRIPTION 2582 "An index into the Channel Modulation table representing 2583 a group of Interval Usage Codes, all associated with the 2584 same channel." 2585 ::= { docsIfCmtsModulationEntry 1 } 2587 docsIfCmtsModIntervalUsageCode OBJECT-TYPE 2588 SYNTAX INTEGER { 2589 request(1), 2590 requestData(2), 2591 initialRanging(3), 2592 periodicRanging(4), 2593 shortData(5), 2594 longData(6) 2595 } 2596 MAX-ACCESS not-accessible 2597 STATUS current 2598 DESCRIPTION 2599 "An index into the Channel Modulation table which, when 2600 grouped with other Interval Usage Codes, fully 2601 instantiate all modulation sets for a given upstream 2602 channel." 2603 REFERENCE 2604 "DOCSIS Radio Frequency Interface specification, 2605 Table 6-16." 2606 ::= { docsIfCmtsModulationEntry 2 } 2608 docsIfCmtsModControl OBJECT-TYPE 2609 SYNTAX RowStatus 2610 MAX-ACCESS read-create 2611 STATUS current 2612 DESCRIPTION 2613 "Controls and reflects the status of rows in this table." 2614 ::= { docsIfCmtsModulationEntry 3 } 2616 docsIfCmtsModType OBJECT-TYPE 2617 SYNTAX INTEGER { 2618 other(1), 2619 qpsk(2), 2620 qam16(3) 2621 } 2622 MAX-ACCESS read-create 2623 STATUS current 2624 DESCRIPTION 2625 "The modulation type used on this channel. Returns 2626 other(1) if the modulation type is neither qpsk or 2627 qam16. See the reference for the modulation profiles 2628 implied by qpsk or qam16. See the conformance object for 2629 write conditions and limitations." 2630 REFERENCE 2631 "DOCSIS Radio Frequency Interface specification, 2632 Section 4.2.2." 2633 DEFVAL { qpsk } 2634 ::= { docsIfCmtsModulationEntry 4 } 2636 docsIfCmtsModPreambleLen OBJECT-TYPE 2637 SYNTAX Integer32 (0..1024) 2638 MAX-ACCESS read-create 2639 STATUS current 2640 DESCRIPTION 2641 "The preamble length for this modulation profile in bits. 2642 Default value is the minimum needed by the implementation 2643 at the CMTS for the given modulation profile." 2644 REFERENCE 2645 "DOCSIS Radio Frequency Interface specification, 2646 Section 4.2.5." 2647 ::= { docsIfCmtsModulationEntry 5 } 2649 docsIfCmtsModDifferentialEncoding OBJECT-TYPE 2650 SYNTAX TruthValue 2651 MAX-ACCESS read-create 2652 STATUS current 2653 DESCRIPTION 2654 "Specifies whether or not differential encoding is used 2655 on this channel." 2656 DEFVAL { false } 2657 ::= { docsIfCmtsModulationEntry 6 } 2659 docsIfCmtsModFECErrorCorrection OBJECT-TYPE 2660 SYNTAX Integer32 (0..10) 2661 MAX-ACCESS read-create 2662 STATUS current 2663 DESCRIPTION 2664 "The number of correctable errored bytes (t) used in 2665 forward error correction code. The value of 0 indicates 2666 no correction is employed. The number of check bytes 2667 appended will be twice this value." 2668 REFERENCE 2669 "DOCSIS Radio Frequency Interface specification, 2670 Section 4.2.3." 2671 DEFVAL { 0 } 2672 ::= { docsIfCmtsModulationEntry 7 } 2674 docsIfCmtsModFECCodewordLength OBJECT-TYPE 2675 SYNTAX Integer32 (1..255) 2676 MAX-ACCESS read-create 2677 STATUS current 2678 DESCRIPTION 2679 "The number of data bytes (k) in the forward error 2680 correction codeword. 2681 This object is not used if docsIfCmtsModFECErrorCorrection 2682 is zero." 2683 REFERENCE 2684 "DOCSIS Radio Frequency Interface specification, 2685 Section 4.2.3." 2686 DEFVAL { 32 } 2687 ::= { docsIfCmtsModulationEntry 8 } 2689 docsIfCmtsModScramblerSeed OBJECT-TYPE 2690 SYNTAX Integer32 (0..32767) 2691 MAX-ACCESS read-create 2692 STATUS current 2693 DESCRIPTION 2694 "The 15 bit seed value for the scrambler polynomial." 2695 REFERENCE 2696 "DOCSIS Radio Frequency Interface specification, 2697 Section 4.2.4." 2698 DEFVAL { 0 } 2699 ::= { docsIfCmtsModulationEntry 9 } 2701 docsIfCmtsModMaxBurstSize OBJECT-TYPE 2702 SYNTAX Integer32 (0..255) 2703 MAX-ACCESS read-create 2704 STATUS current 2705 DESCRIPTION 2706 "The maximum number of mini-slots that can be transmitted 2707 during this channel's burst time. Returns zero if the 2708 burst length is bounded by the allocation MAP rather than 2709 this profile. 2710 Default value is 0 except for shortData, where it is 8." 2711 ::= { docsIfCmtsModulationEntry 10 } 2713 docsIfCmtsModGuardTimeSize OBJECT-TYPE 2714 SYNTAX Unsigned32 2715 MAX-ACCESS read-only 2716 STATUS current 2717 DESCRIPTION 2718 "The number of symbol-times which must follow the end of 2719 this channel's burst. Default value is the minimum time 2720 needed by the implementation for this modulation profile." 2721 REFERENCE 2722 "DOCSIS Radio Frequency Interface specification, 2723 Section 4.2.7." 2724 ::= { docsIfCmtsModulationEntry 11 } 2726 docsIfCmtsModLastCodewordShortened OBJECT-TYPE 2727 SYNTAX TruthValue 2728 MAX-ACCESS read-create 2729 STATUS current 2730 DESCRIPTION 2731 "Indicates if the last FEC codeword is truncated." 2732 REFERENCE 2733 "DOCSIS Radio Frequency Interface specification, 2734 Section 4.2.10." 2735 DEFVAL { true } 2736 ::= { docsIfCmtsModulationEntry 12 } 2738 docsIfCmtsModScrambler OBJECT-TYPE 2739 SYNTAX TruthValue 2740 MAX-ACCESS read-create 2741 STATUS current 2742 DESCRIPTION 2743 "Indicates if the scrambler is employed." 2744 REFERENCE 2745 "DOCSIS Radio Frequency Interface specification, 2746 Section 4.2.4." 2747 DEFVAL { false } 2748 ::= { docsIfCmtsModulationEntry 13 } 2750 docsIfCmtsQosProfilePermissions OBJECT-TYPE 2751 SYNTAX BITS { 2752 createByManagement(0), 2753 updateByManagement(1), 2754 createByModems(2) 2755 } 2756 MAX-ACCESS read-write 2757 STATUS current 2758 DESCRIPTION 2759 "This object specifies permitted methods of creating 2760 entries in docsIfQosProfileTable. 2761 CreateByManagement(0) is set if entries can be created 2762 using SNMP. UpdateByManagement(1) is set if updating 2763 entries using SNMP is permitted. CreateByModems(2) 2764 is set if entries can be created based on information 2765 in REG-REQ MAC messages received from Cable Modems. 2766 Information in this object is only applicable if 2767 docsIfQosProfileTable is implemented as read-create. 2768 Otherwise, this object is implemented as read-only 2769 and returns CreateByModems(2). 2770 Either CreateByManagement(0) or CreateByModems(1) 2771 must be set when writing to this object." 2772 ::= { docsIfCmtsObjects 6 } 2774 docsIfCmtsMacToCmTable OBJECT-TYPE 2775 SYNTAX SEQUENCE OF DocsIfCmtsMacToCmEntry 2776 MAX-ACCESS not-accessible 2777 STATUS current 2778 DESCRIPTION 2779 "This is a table to provide a quick access index into the 2780 docsIfCmtsCmStatusTable. There is exactly one row in this 2781 table for each row in the docsIfCmtsCmStatusTable. In 2782 general, the management station should use this table only 2783 to get a pointer into the docsIfCmtsCmStatusTable (which 2784 corresponds to the CM's RF interface MAC address), and 2785 should not iterate (e.g. GetNext through) this table." 2786 ::= { docsIfCmtsObjects 7 } 2788 docsIfCmtsMacToCmEntry OBJECT-TYPE 2789 SYNTAX DocsIfCmtsMacToCmEntry 2790 MAX-ACCESS not-accessible 2791 STATUS current 2792 DESCRIPTION 2793 "A row in the docsIfCmtsMacToCmTable. 2794 An entry in this table exists for each Cable Modem 2795 that is connected to the CMTS implementing this table." 2796 INDEX { docsIfCmtsCmMac } 2797 ::= {docsIfCmtsMacToCmTable 1 } 2799 DocsIfCmtsMacToCmEntry ::= SEQUENCE { 2800 docsIfCmtsCmMac MacAddress, 2801 docsIfCmtsCmPtr Integer32 2802 } 2804 docsIfCmtsCmMac OBJECT-TYPE 2805 SYNTAX MacAddress 2806 MAX-ACCESS not-accessible 2807 STATUS current 2808 DESCRIPTION 2809 "The RF side MAC address for the referenced CM. (E.g. the 2810 interface on the CM that has docsCableMacLayer(127) as 2811 its ifType." 2812 ::= { docsIfCmtsMacToCmEntry 1 } 2814 docsIfCmtsCmPtr OBJECT-TYPE 2815 SYNTAX Integer32 (1..2147483647) 2816 MAX-ACCESS read-only 2817 STATUS current 2818 DESCRIPTION 2819 "An row index into docsIfCmtsCmStatusTable. When queried 2820 with the correct instance value (e.g. a CM's MAC address), 2821 returns the index in docsIfCmtsCmStatusTable which 2822 represents that CM." 2823 ::= { docsIfCmtsMacToCmEntry 2 } 2825 -- 2826 -- notification group is for future extension. 2827 -- 2828 docsIfNotification OBJECT IDENTIFIER ::= { docsIfMib 2 } 2830 docsIfConformance OBJECT IDENTIFIER ::= { docsIfMib 3 } 2831 docsIfCompliances OBJECT IDENTIFIER ::= { docsIfConformance 1 } 2832 docsIfGroups OBJECT IDENTIFIER ::= { docsIfConformance 2 } 2834 -- compliance statements 2836 docsIfBasicCompliance MODULE-COMPLIANCE 2837 STATUS current 2838 DESCRIPTION 2839 "The compliance statement for devices that implement 2840 MCNS/DOCSIS compliant Radio Frequency Interfaces." 2842 MODULE -- docsIfMib 2844 -- unconditionally mandatory groups 2845 MANDATORY-GROUPS { 2846 docsIfBasicGroup 2847 } 2849 -- conditionally mandatory group 2850 GROUP docsIfCmGroup 2851 DESCRIPTION 2852 "This group is implemented only in Cable Modems, not in 2853 Cable Modem Termination Systems." 2855 -- conditionally mandatory group 2856 GROUP docsIfCmtsGroup 2857 DESCRIPTION 2858 "This group is implemented only in Cable Modem Termination 2859 Systems, not in Cable Modems." 2861 OBJECT docsIfDownChannelFrequency 2862 WRITE-SYNTAX Integer32 (54000000..860000000) 2863 MIN-ACCESS read-only 2864 DESCRIPTION 2865 "Read-write in Cable Modem Termination Systems; 2866 read-only in Cable Modems. The values above are 2867 appropriate for a cable plant using a Sub-Split channel 2868 plan. If DOCSIS is extended to cover other types of 2869 channel plans (and frequency allocations) this object 2870 will be modified accordingly." 2872 OBJECT docsIfDownChannelWidth 2873 WRITE-SYNTAX Integer32 (6000000) 2874 MIN-ACCESS read-only 2875 DESCRIPTION 2876 "It is conformant to implement this object as read-only. 2877 In Cable Modems, this object is always implemented as 2878 read-only. The above value is appropriate for cable 2879 plants running under NTSC (National Television 2880 Standards Committee) standards. If DOCSIS is extended to 2881 work with other standard (e.g. European standards), this 2882 object will be modified accordingly." 2884 OBJECT docsIfDownChannelModulation 2885 WRITE-SYNTAX INTEGER { 2886 qam64 (3), 2887 qam256 (4) 2888 } 2889 MIN-ACCESS read-only 2890 DESCRIPTION 2891 "Read-write in Cable Modem Termination Systems; 2892 read-only in Cable Modems." 2894 OBJECT docsIfDownChannelInterleave 2895 WRITE-SYNTAX INTEGER { 2896 taps8Increment16(3), 2897 taps16Increment8(4), 2898 taps32Increment4(5), 2899 taps64Increment2(6), 2900 taps128Increment1(7) 2901 } 2902 MIN-ACCESS read-only 2903 DESCRIPTION 2904 "Read-write in Cable Modem Termination Systems; 2905 read-only in Cable Modems." 2907 OBJECT docsIfDownChannelPower 2908 MIN-ACCESS read-only 2909 DESCRIPTION 2910 "Read-write in Cable Modem Termination Systems; 2911 read-only in Cable Modems." 2913 OBJECT docsIfUpChannelFrequency 2914 WRITE-SYNTAX Integer32 (5000000..42000000) 2915 MIN-ACCESS read-only 2916 DESCRIPTION 2917 "Read-write in Cable Modem Termination Systems; 2918 read-only in Cable Modems.The values above are 2919 appropriate for a cable plant using a Sub-Split channel 2920 plan. If DOCSIS is extended to cover other types of 2921 channel plans (and frequency allocations) this object 2922 will be modified accordingly." 2924 OBJECT docsIfUpChannelWidth 2925 WRITE-SYNTAX Integer32 (200000..3200000) 2926 MIN-ACCESS read-only 2927 DESCRIPTION 2928 "Read-write in Cable Modem Termination Systems; 2929 read-only in Cable Modems.The above value is appropriate for cable 2930 plants running under NTSC (National Television 2931 Standards Committee) standards. If DOCSIS is extended to 2932 work with other standard (e.g. European standards), this 2933 object will be modified accordingly." 2935 OBJECT docsIfUpChannelModulationProfile 2936 MIN-ACCESS read-only 2937 DESCRIPTION 2938 "Read-write in Cable Modem Termination Systems; 2939 read-only in Cable Modems." 2941 OBJECT docsIfUpChannelSlotSize 2942 MIN-ACCESS read-only 2943 DESCRIPTION 2944 "This object is always read-only in Cable Modems. 2945 It is compliant to implement this object as read-only 2946 in Cable Modem Termination Systems." 2948 OBJECT docsIfUpChannelRangingBackoffStart 2949 MIN-ACCESS read-only 2950 DESCRIPTION 2951 "Read-write in Cable Modem Termination Systems; 2952 read-only in Cable Modems." 2954 OBJECT docsIfUpChannelRangingBackoffEnd 2955 MIN-ACCESS read-only 2956 DESCRIPTION 2957 "Read-write in Cable Modem Termination Systems; 2958 read-only in Cable Modems." 2960 OBJECT docsIfUpChannelTxBackoffStart 2961 MIN-ACCESS read-only 2962 DESCRIPTION 2963 "Read-write in Cable Modem Termination Systems; 2964 read-only in Cable Modems." 2966 OBJECT docsIfUpChannelTxBackoffEnd 2967 MIN-ACCESS read-only 2968 DESCRIPTION 2969 "Read-write in Cable Modem Termination Systems; 2970 read-only in Cable Modems." 2972 OBJECT docsIfQosProfPriority 2973 MIN-ACCESS read-only 2974 DESCRIPTION 2975 "This object is always read-only in Cable Modems. 2976 It is compliant to implement this object as read-only 2977 in Cable Modem Termination Systems." 2979 OBJECT docsIfQosProfMaxUpBandwidth 2980 MIN-ACCESS read-only 2981 DESCRIPTION 2982 "This object is always read-only in Cable Modems. 2983 It is compliant to implement this object as read-only 2984 in Cable Modem Termination Systems." 2986 OBJECT docsIfQosProfGuarUpBandwidth 2987 MIN-ACCESS read-only 2988 DESCRIPTION 2989 "This object is always read-only in Cable Modems. 2990 It is compliant to implement this object as read-only 2991 in Cable Modem Termination Systems." 2993 OBJECT docsIfQosProfMaxDownBandwidth 2994 MIN-ACCESS read-only 2995 DESCRIPTION 2996 "This object is always read-only in Cable Modems. 2997 It is compliant to implement this object as read-only 2998 in Cable Modem Termination Systems." 3000 OBJECT docsIfQosProfMaxTxBurst 3001 MIN-ACCESS read-only 3002 DESCRIPTION 3003 "This object is always read-only in Cable Modems. 3004 It is compliant to implement this object as read-only 3005 in Cable Modem Termination Systems." 3007 OBJECT docsIfQosProfBaselinePrivacy 3008 MIN-ACCESS read-only 3009 DESCRIPTION 3010 "This object is always read-only in Cable Modems. 3011 It is compliant to implement this object as read-only 3012 in Cable Modem Termination Systems." 3014 OBJECT docsIfQosProfStatus 3015 MIN-ACCESS read-only 3016 DESCRIPTION 3017 "This object is always read-only in Cable Modems. 3019 It is compliant to implement this object as read-only 3020 in Cable Modem Termination Systems." 3022 OBJECT docsIfCmtsServiceAdminStatus 3023 MIN-ACCESS read-only 3024 DESCRIPTION 3025 "It is compliant to implement this object as read-only." 3027 OBJECT docsIfCmtsSyncInterval 3028 MIN-ACCESS read-only 3029 DESCRIPTION 3030 "It is compliant to implement this object as read-only." 3032 OBJECT docsIfCmtsUcdInterval 3033 MIN-ACCESS read-only 3034 DESCRIPTION 3035 "It is compliant to implement this object as read-only." 3037 OBJECT docsIfCmtsInsertInterval 3038 MIN-ACCESS read-only 3039 DESCRIPTION 3040 "It is compliant to implement this object as read-only." 3042 OBJECT docsIfCmtsInvitedRangingAttempts 3043 MIN-ACCESS read-only 3044 DESCRIPTION 3045 "It is compliant to implement this object as read-only." 3047 OBJECT docsIfCmtsQosProfilePermissions 3048 MIN-ACCESS read-only 3049 DESCRIPTION 3050 "It is compliant to implement this object as read-only." 3052 OBJECT docsIfCmtsModType 3053 WRITE-SYNTAX INTEGER { 3054 qpsk (2), 3055 qam16 (3) 3056 } 3057 DESCRIPTION 3058 "Management station may only set 16QAM or QPSK modulation, 3059 but others might be possible based on device configuration." 3061 ::= { docsIfCompliances 1 } 3063 docsIfBasicGroup OBJECT-GROUP 3064 OBJECTS { 3065 docsIfDownChannelId, 3066 docsIfDownChannelFrequency, 3067 docsIfDownChannelWidth, 3068 docsIfDownChannelModulation, 3069 docsIfDownChannelInterleave, 3070 docsIfDownChannelPower, 3071 docsIfUpChannelId, 3072 docsIfUpChannelFrequency, 3073 docsIfUpChannelWidth, 3074 docsIfUpChannelModulationProfile, 3075 docsIfUpChannelSlotSize, 3076 docsIfUpChannelTxTimingOffset, 3077 docsIfUpChannelRangingBackoffStart, 3078 docsIfUpChannelRangingBackoffEnd, 3079 docsIfUpChannelTxBackoffStart, 3080 docsIfUpChannelTxBackoffEnd, 3081 docsIfQosProfPriority, 3082 docsIfQosProfMaxUpBandwidth, 3083 docsIfQosProfGuarUpBandwidth, 3084 docsIfQosProfMaxDownBandwidth, 3085 docsIfQosProfMaxTxBurst, 3086 docsIfQosProfBaselinePrivacy, 3087 docsIfQosProfStatus, 3088 docsIfSigQIncludesContention, 3089 docsIfSigQUnerroreds, 3090 docsIfSigQCorrecteds, 3091 docsIfSigQUncorrectables, 3092 docsIfSigQSignalNoise, 3093 docsIfSigQMicroreflections, 3094 docsIfSigQEqualizationData 3095 } 3096 STATUS current 3097 DESCRIPTION 3098 "Group of objects implemented in both Cable Modems and 3099 Cable Modem Termination Systems." 3100 ::= { docsIfGroups 1 } 3102 -- The following table was modified to correct naming conventions for 3103 -- Counter32 variables. 3104 docsIfCmGroup OBJECT-GROUP 3105 OBJECTS { 3106 docsIfCmCmtsAddress, 3107 docsIfCmCapabilities, 3108 -- docsIfCmRangingRespTimeout, 3109 docsIfCmRangingTimeout, 3110 docsIfCmStatusValue, 3111 docsIfCmStatusCode, 3112 docsIfCmStatusTxPower, 3113 docsIfCmStatusResets, 3114 docsIfCmStatusLostSyncs, 3115 docsIfCmStatusInvalidMaps, 3116 docsIfCmStatusInvalidUcds, 3117 -- docsIfCmStatusInvalidRangingResp, 3118 docsIfCmStatusInvalidRangingResponses, 3119 -- docsIfCmStatusInvalidRegistrationResp, 3120 docsIfCmStatusInvalidRegistrationResponses, 3121 docsIfCmStatusT1Timeouts, 3122 docsIfCmStatusT2Timeouts, 3123 docsIfCmStatusT3Timeouts, 3124 docsIfCmStatusT4Timeouts, 3125 docsIfCmStatusRangingAborteds, 3126 docsIfCmServiceQosProfile, 3127 docsIfCmServiceTxSlotsImmed, 3128 docsIfCmServiceTxSlotsDed, 3129 docsIfCmServiceTxRetries, 3130 -- docsIfCmServiceTxExceeded, 3131 docsIfCmServiceTxExceededs, 3132 docsIfCmServiceRqRetries, 3133 -- docsIfCmServiceRqExceeded 3134 docsIfCmServiceRqExceededs 3135 } 3136 STATUS current 3137 DESCRIPTION 3138 "Group of objects implemented in Cable Modems." 3139 ::= { docsIfGroups 2 } 3141 docsIfCmtsGroup OBJECT-GROUP 3142 OBJECTS { 3143 docsIfCmtsCapabilities, 3144 docsIfCmtsSyncInterval, 3145 docsIfCmtsUcdInterval, 3146 docsIfCmtsMaxServiceIds, 3147 -- docsIfCmtsInsertionInterval, 3148 docsIfCmtsInvitedRangingAttempts, 3149 docsIfCmtsInsertInterval, 3150 docsIfCmtsStatusInvalidRangeReqs, 3151 docsIfCmtsStatusRangingAborteds, 3152 docsIfCmtsStatusInvalidRegReqs, 3153 docsIfCmtsStatusFailedRegReqs, 3154 docsIfCmtsStatusInvalidDataReqs, 3155 docsIfCmtsStatusT5Timeouts, 3156 docsIfCmtsCmStatusMacAddress, 3157 docsIfCmtsCmStatusIpAddress, 3158 docsIfCmtsCmStatusDownChannelIfIndex, 3159 docsIfCmtsCmStatusUpChannelIfIndex, 3160 docsIfCmtsCmStatusRxPower, 3161 docsIfCmtsCmStatusTimingOffset, 3162 docsIfCmtsCmStatusEqualizationData, 3163 docsIfCmtsCmStatusValue, 3164 docsIfCmtsCmStatusUnerroreds, 3165 docsIfCmtsCmStatusCorrecteds, 3166 docsIfCmtsCmStatusUncorrectables, 3167 docsIfCmtsCmStatusSignalNoise, 3168 docsIfCmtsCmStatusMicroreflections, 3169 docsIfCmtsServiceCmStatusIndex, 3170 docsIfCmtsServiceAdminStatus, 3171 docsIfCmtsServiceQosProfile, 3172 docsIfCmtsServiceCreateTime, 3173 docsIfCmtsServiceInOctets, 3174 docsIfCmtsServiceInPackets, 3175 docsIfCmtsModType, 3176 docsIfCmtsModControl, 3177 docsIfCmtsModPreambleLen, 3178 docsIfCmtsModDifferentialEncoding, 3179 docsIfCmtsModFECErrorCorrection, 3180 docsIfCmtsModFECCodewordLength, 3181 docsIfCmtsModScramblerSeed, 3182 docsIfCmtsModMaxBurstSize, 3183 docsIfCmtsModGuardTimeSize, 3184 docsIfCmtsModLastCodewordShortened, 3185 docsIfCmtsModScrambler, 3186 docsIfCmtsQosProfilePermissions, 3187 docsIfCmtsCmPtr 3188 } 3189 STATUS current 3190 DESCRIPTION 3191 "Group of objects implemented in Cable Modem Termination 3192 Systems." 3193 ::= { docsIfGroups 3 } 3195 docsIfObsoleteGroup OBJECT-GROUP 3196 OBJECTS { 3197 docsIfCmRangingRespTimeout, 3198 docsIfCmtsInsertionInterval 3199 } 3200 STATUS obsolete 3201 DESCRIPTION 3202 "Group of objects obsoleted." 3203 ::= { docsIfGroups 4 } 3205 END 3206 5. Acknowledgments 3208 This document was produced by the IPCDN Working Group. It is based on a 3209 document written by Pam Anderson from CableLabs, Wilson Sawyer from 3210 BayNetworks, and Rich Woundy from Continental Cablevision. The original 3211 working group editor, Guenter Roeck of cisco Systems, did much of the 3212 grunt work of putting the document into its current form. 3214 Special thanks is also due to Azlina Palmer, who helped a lot reviewing 3215 the document. 3217 6. References 3219 [1] Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture for 3220 Describing SNMP Management Frameworks", RFC 2271, Cabletron 3221 Systems, Inc., BMC Software, Inc., IBM T. J. Watson Research, 3222 January 1998 3224 [2] Rose, M., and K. McCloghrie, "Structure and Identification of 3225 Management Information for TCP/IP-based Internets", RFC 1155, 3226 Performance Systems International, Hughes LAN Systems, May 1990 3228 [3] Rose, M., and K. McCloghrie, "Concise MIB Definitions", RFC 1212, 3229 Performance Systems International, Hughes LAN Systems, March 1991 3231 [4] M. Rose, "A Convention for Defining Traps for use with the SNMP", 3232 RFC 1215, Performance Systems International, March 1991 3234 [5] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure 3235 of Management Information for Version 2 of the Simple Network 3236 Management Protocol (SNMPv2)", RFC 1902, SNMP Research,Inc., Cisco 3237 Systems, Inc., Dover Beach Consulting, Inc., International Network 3238 Services, January 1996. 3240 [6] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Textual 3241 Conventions for Version 2 of the Simple Network Management Protocol 3242 (SNMPv2)", RFC 1903, SNMP Research, Inc., Cisco Systems, Inc., 3243 Dover Beach Consulting, Inc., International Network Services, 3244 January 1996. 3246 [7] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Conformance 3247 Statements for Version 2 of the Simple Network Management Protocol 3248 (SNMPv2)", RFC 1904, SNMP Research, Inc., Cisco Systems, Inc., 3249 Dover Beach Consulting, Inc., International Network Services, 3250 January 1996. 3252 [8] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network 3253 Management Protocol", RFC 1157, SNMP Research, Performance Systems 3254 International, Performance Systems International, MIT Laboratory 3255 for Computer Science, May 1990. 3257 [9] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, 3258 "Introduction to Community-based SNMPv2", RFC 1901, SNMP Research, 3259 Inc., Cisco Systems, Inc., Dover Beach Consulting, Inc., 3260 International Network Services, January 1996. 3262 [10] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Transport 3263 Mappings for Version 2 of the Simple Network Management Protocol 3264 (SNMPv2)", RFC 1906, SNMP Research, Inc., Cisco Systems, Inc., 3265 Dover Beach Consulting, Inc., International Network Services, 3266 January 1996. 3268 [11] Case, J., Harrington D., Presuhn R., and B. Wijnen, "Message 3269 Processing and Dispatching for the Simple Network Management 3270 Protocol (SNMP)", RFC 2272, SNMP Research, Inc., Cabletron Systems, 3271 Inc., BMC Software, Inc., IBM T. J. Watson Research, January 1998. 3273 [12] Blumenthal, U., and B. Wijnen, "User-based Security Model (USM) for 3274 version 3 of the Simple Network Management Protocol (SNMPv3)", RFC 3275 2274, IBM T. J. Watson Research, January 1998. 3277 [13] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol 3278 Operations for Version 2 of the Simple Network Management Protocol 3279 (SNMPv2)", RFC 1905, SNMP Research, Inc., Cisco Systems, Inc., 3280 Dover Beach Consulting, Inc., International Network Services, 3281 January 1996. 3283 [14] Levi, D., Meyer, P., and B. Stewart, "SNMPv3 Applications", RFC 3284 2273, SNMP Research, Inc., Secure Computing Corporation, Cisco 3285 Systems, January 1998 3287 [15] Wijnen, B., Presuhn, R., and K. McCloghrie, "View-based Access 3288 Control Model (VACM) for the Simple Network Management Protocol 3289 (SNMP)", RFC 2275, IBM T. J. Watson Research, BMC Software, Inc., 3290 Cisco Systems, Inc., January 1998 3292 [16] " Data-Over-Cable Service Interface Specifications: Cable Modem 3293 Radio Frequency Interface Specification SP-RFI-I04-980724", DOCSIS, 3294 July 1998, http://www.cablemodem.com/public/pubtechspec/SP-RFI- 3295 I04-980724.pdf. 3297 [17] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB using 3298 SMIv2", RFC2233, Cisco Systems, Inc., FTP Software, November 1997 3300 [18] Roeck, G. "Cable Device Management Information Base for MCNS/DOCSIS 3301 compliant Cable Modems and Cable Modem Termination Systems", 3302 draft-ietf-ipcdn-cable-device-mib-05.txt, Cisco Systems, Inc., 3303 October 1998 3305 [19] Proakis, John G., "Digital Communications, 3rd Edition",McGraw- 3306 Hill, New York, New York, 1995, ISBN 0-07-051726-6 3308 [20] "Transmission Systems for Interactive Cable Television Services, 3309 Annex B", J.112, International Telecommunications Union, March 1998 3311 7. Security Considerations 3313 This MIB relates to a system which will provide metropolitan public 3314 internet access. As such, improper manipulation of the objects 3315 represented by this MIB may result in denial of service to a large 3316 number of end-users. In addition, manipulation of the 3317 docsIfCmServiceQosProfile, docsIfCmtsServerQosProfile, and the elements 3318 of docsIfQosProfileTable may allow an end-user to improve their service 3319 response or decrease other subscriber service response. 3321 This MIB does not affect confidentiality, authentication or 3322 authorization of services on a cable modem system. For authentication 3323 and authorization, please see the related document "Cable Device 3324 Management Information Base for MCNS/DOCSIS compliant Cable Modems and 3325 Cable Modem Termination Systems" currently an Internet Draft [18] but to 3326 be published as an RFC simultaneously with this document. For 3327 confidentiality, the working group expects to issue a MIB which 3328 describes the management of the DOCSIS Baseline Privacy mechanism. 3330 8. Intellectual Property 3332 The IETF takes no position regarding the validity or scope of any 3333 intellectual property or other rights that might be claimed to pertain 3334 to the implementation or use of the technology described in this 3335 document or the extent to which any license under such rights might or 3336 might not be available; neither does it represent that it has made any 3337 effort to identify any such rights. Information on the IETF's 3338 procedures with respect to rights in standards-track and standards- 3339 related documentation can be found in BCP-11. Copies of claims of 3340 rights made available for publication and any assurances of licenses to 3341 be made available, or the result of an attempt made to obtain a general 3342 license or permission for the use of such proprietary rights by 3343 implementors or users of this specification can be obtained from the 3344 IETF Secretariat. 3346 The IETF invites any interested party to bring to its attention any 3347 copyrights, patents or patent applications, or other proprietary rights 3348 which may cover technology that may be required to practice this 3349 standard. Please address the information to the IETF Executive 3350 Director. 3352 9. Author's Address 3354 Michael StJohns 3355 @Home Network 3356 425 Broadway 3357 Redwood City, CA 94063 3359 Phone: +1 650 569 5368 3360 Email: stjohns@corp.home.net 3362 10. Copyright Section 3364 Copyright (C) The Internet Society (1998). All Rights Reserved. 3366 This document and translations of it may be copied and furnished to 3367 others, and derivative works that comment on or otherwise explain it or 3368 assist in its implmentation may be prepared, copied, published and 3369 distributed, in whole or in part, without restriction of any kind, 3370 provided that the above copyright notice and this paragraph are included 3371 on all such copies and derivative works. However, this document itself 3372 may not be modified in any way, such as by removing the copyright notice 3373 or references to the Internet Society or other Internet organizations, 3374 except as needed for the purpose of developing Internet standards in 3375 which case the procedures for copyrights defined in the Internet 3376 Standards process must be followed, or as required to translate it into 3377 languages other than English. 3379 The limited permissions granted above are perpetual and will not be 3380 revoked by the Internet Society or its successors or assigns. 3382 This document and the information contained herein is provided on an "AS 3383 IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK 3384 FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT 3385 LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT 3386 INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR 3387 FITNESS FOR A PARTICULAR PURPOSE.