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