Internet-Draft                                            A. Bhagwat
   draft-jones-cable-gateway-qos-mib-00.txt                   CableLabs
   Expires: July 2003
                                                             E. Cardona
                                                              CableLabs

                                                              K. Luehrs
                                                              CableLabs

                                                               D. Jones
                                                                YAS BBV

                                                           January 2003


    Cable Gateway Quality of Service (QoS) Management Information Base
               for CableHome compliant Residential Gateways


Status of this Memo

   This document is an Internet-Draft and is in full conformance with
   all provisions of Section 10 of RFC2026 [1].

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF), its areas, and its working groups.  Note that
   other groups may also distribute working documents as Internet-
   Drafts.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   The list of current Internet-Drafts can be accessed at
        http://www.ietf.org/ietf/1id-abstracts.txt

   The list of Internet-Draft Shadow Directories can be accessed at
        http://www.ietf.org/shadow.html




Copyright Notice

   Copyright (C) The Internet Society (2003).  All Rights Reserved.






Bhagwat/Cardona/Luehrs   Expires - July 2003                 [Page 1]


Internet-Draft        CableHome Gateway QoS MIB          January 2003

Abstract

   This memo defines a portion of the Management Information Base (MIB)
   for use with network management protocols in the Internet community.
   In particular, it defines a basic set of managed objects for SNMP-
   based management for prioritized Quality of Service functionality
   within a LAN, between a CableHome residential gateway device and
   CableHome compliant LAN host devices.

   This memo specifies a MIB module in a manner that is compliant to the
   SNMP SMIv2 [5][6][7].  The set of objects is consistent with the SNMP
   framework and existing SNMP standards.



Conventions used in this document

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED",  "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in RFC-2119 [2].




Table of Contents


   1. The Internet-Standard Management Framework.....................3
   2. Glossary.......................................................3
      2.1 CATV.......................................................3
      2.2 CableHome Residential Gateway..............................3
      2.3 Portal Services............................................3
      2.4 Boundary Point (BP)........................................3
      2.5 Application Identifiers....................................4
   3. Overview.......................................................4
      3.1 Structure of the MIB.......................................4
      3.2 Management Requirements....................................5
   4. MIB Definitions................................................5
   5. Formal Syntax.................................................14
   6. Security Considerations.......................................14
   7. References....................................................15
   8. Intellectual Property.........................................17
   9. AuthorÆs Addresses............................................17
   10. Full Copyright Statement.....................................18








Bhagwat/Cardona/Luehrs   Expires - July 2003                 [Page 2]


Internet-Draft        CableHome Gateway QoS MIB          January 2003

1. The Internet-Standard Management Framework

   For a detailed overview of the documents that describe the current
   Internet-Standard Management Framework, please refer to section 7 of
   RFC 3410 [12].

   Managed objects are accessed via a virtual information store, termed
   the Management Information Base or MIB.  MIB objects are generally
   accessed through the Simple Network Management Protocol (SNMP).
   Objects in the MIB are defined using the mechanisms defined in the
   Structure of Management Information (SMI).  This memo specifies a MIB
   module that is compliant to the SMIv2, which is described in STD 58,
   RFC 2578 [7], STD 58, RFC 2579 [8] and STD 58, RFC 2580 [9].


2. Glossary

   The terms in this document are derived either from normal cable
   system usage, from normal residential gateway operation, or from the
   documents associated with the CableHome Specifications [21] & [22].

2.1 CATV

   Originally "Community Antenna Television", now used to refer to any
   cable or hybrid fiber and cable system used to deliver video signals
   to a community.

2.2 CableHome Residential Gateway

   A CableHome Residential gateway passes data traffic between the cable
   operator's broadband data network (the Wide Area Network, WAN) and
   the Local Area Network (LAN) in the cable data service subscriber's
   residence or business. In addition to passing traffic between the WAN
   and LAN, the CableHome Residential Gateway provides several services
   including a DHCP client and a DHCP server (RFC2131) [23], a TFTP
   server (RFC1350) [24], management services as enabled by
   SNMPv1/v2c/v3 agent compliant with the RFCs listed in Section 1, and
   security services including stateful packet inspection firewall
   functionality and software code image verification using techniques.

2.3 Portal Services

   A logical element aggregating the set of CableHome-specified
   functionality in a CableHome compliant cable gateway device.

2.4 Boundary Point (BP)
   A logical element aggregating the set of CableHome-specified
   functionality in a CableHome compliant LAN host device (LAN IP
   Device).



Bhagwat/Cardona/Luehrs   Expires - July 2003                 [Page 3]


Internet-Draft        CableHome Gateway QoS MIB          January 2003

2.5 Application Identifiers
   The port number assigned by the Internet Assigned Numbers Authority
   (IANA) to an application, used by CableHome-specified elements to
   identify an application.



3. Overview

   This MIB entity supports basic traffic prioritization and queuing for
   CableHome compliant devices. The MIB is derived from the CableHome
   1.1 specification [22]. Support for traffic prioritization and
   queuing is provided through four tables. These tables and their use
   is summarized below and described in detail in the CableHome 1.1
   specification [22].

   Applications running on CableHome compliant devices are identified
   with their IANA-assigned UDP/TCP port number. Service providers have
   the ability to configure the priority for any application by
   associating a priority number with the port number in a table
   implemented in the cable gateway device (Application Priority Master
   Table). When CableHome compliant LAN host devices acquire a network
   address lease, they communicate to the cable gateway device the list
   of applications implemented on the LAN host. This information is
   recorded in two other tables in the cable gateway device (BP
   Application Priority Table and Destination Priority Table). Portal
   Services functions refer to the Application Priority Master Table and
   reply to the LAN host device(s) with the priority assigned to their
   applications.

   The cable gateway device maintains a queue for each LAN interface,
   and each interface supports a particular number of priority levels. A
   fourth table, the PS Interface Attributes Table, maintains this
   information.


3.1 Structure of the MIB

   This MIB entity contains one group:

   The cabhPriorityQosGroup group contains the mechanisms needed for
   CableHome compliant cable gateway devices and LAN hosts to identify
   and communicate applications needing prioritized queuing and media
   access. The cabhPriortyQosGroup contains the following tables:

   cabhPriorityQosMasterTable
   Allows the service provider to provision the residential gateway with
   a list of supported applications and a priority value for each. The
   Portal Services refers to this table when acting as a proxy for the



Bhagwat/Cardona/Luehrs   Expires - July 2003                 [Page 4]


Internet-Draft        CableHome Gateway QoS MIB          January 2003

   service provider, to provide application priorities to Boundary Point
   elements.


   cabhPriorityQosBpTable
   Contains the list of application identifiers for each BP element in
   the LAN. These values are acquired by the PS during the BP Discovery
   process as described in [22].

   cabhPriorityQosBpDestTable
   Contains a list of destination IP addresses for each BP, each of
   which can be provisioned for a special priority for a specified
   application. Applications are identified by their IANA-assigned port
   number.

   cabhPriorityQosPsIfAttribTable
   Identifies the number of queues and the number of media access
   priorities for each LAN interface. LAN interfaces are identified by
   their ifIndex.


3.2 Management Requirements

   In addition to the explicit requirements in this specification, the
   Cable Gateway MUST support all applicable CableHome and IETF
   requirements and MIB objects.



4. MIB Definitions


   CABH-QOS-MIB DEFINITIONS ::= BEGIN
   IMPORTS
      MODULE-IDENTITY,
      OBJECT-TYPE,
      Integer32                FROM SNMPv2-SMI

      RowStatus                FROM SNMPv2-TC

      OBJECT-GROUP,
      MODULE-COMPLIANCE        FROM SNMPv2-CONF

      InetPortNumber,
      InetAddressType,
      InetAddress              FROM INET-ADDRESS-MIB

      ifIndex                  FROM IF-MIB

      cabhDevMib               FROM CABH-DEV-MIB;


Bhagwat/Cardona/Luehrs   Expires - July 2003                 [Page 5]


Internet-Draft        CableHome Gateway QoS MIB          January 2003


   --==============================================================
   --
   --  History:
   --
   --  Date              Reason
   --  01/22/03          -00
   --
   --
   --==============================================================


   cabhQosMib MODULE-IDENTITY
       LAST-UPDATED    "200301220000Z"-- January 22, 2003
       ORGANIZATION    "CableLabs Broadband Access Department"
       CONTACT-INFO
            "Kevin Luehrs
             Postal: Cable Television Laboratories, Inc.
             400 Centennial Parkway
             Louisville, Colorado 80027-1266
             U.S.A.
             Phone:  +1 303-661-9100
             Fax:    +1 303-661-9199
             E-mail: k.luehrs@cablelabs.com"
       DESCRIPTION
               "This MIB module supplies parameters for the
                configuration and monitoring of CableHome
                prioritized QoS capability.

                Acknowledgements:
                Stephen Palm   -  Broadcom
                Diego Mazzola  -  Texas Instruments
                James Hinsey   -  Broadcom"
       REVISION "200301220000Z" -- January 22, 2003
       DESCRIPTION
               "Initial version, published as RFC xxxx."
                -- RFC editor to assign xxxx

        ::=  { cabhDevMib 6 }

   -- Textual conventions

   cabhQosMibObjects         OBJECT IDENTIFIER ::= { cabhQosMib 1}
   cabhPriorityQosMibObjects OBJECT IDENTIFIER ::= { cabhQosMibObjects 1
   }
   cabhPriorityQosBase       OBJECT IDENTIFIER ::= {
   cabhPriorityQosMibObjects 1 }
   cabhPriorityQosBp         OBJECT IDENTIFIER ::= {
   cabhPriorityQosMibObjects 2 }



Bhagwat/Cardona/Luehrs   Expires - July 2003                 [Page 6]


Internet-Draft        CableHome Gateway QoS MIB          January 2003

   cabhPriorityQosPs         OBJECT IDENTIFIER ::= {
   cabhPriorityQosMibObjects 3 }

   -- future parametric QOS
   -- cabhParamQosMibObjects  OBJECT IDENTIFIER ::= { cabhQosMibObjects
   2 }

   --=================================================================
   --
   --  Application Priority Master Table
   --
   --  The cabhPriorityQosMasterTable contains the list of
   --  application priorities provisioned by the cable operator.
   --  Applications are identified by the IANA "well-known" port
   --  numbers  assigned to them.
   --
   --==================================================================
   cabhPriorityQosMasterTable  OBJECT-TYPE
         SYNTAX SEQUENCE OF CabhPriorityQosMasterEntry
         MAX-ACCESS  not-accessible
         STATUS      current
         DESCRIPTION
           "This table contains a list of mappings for Application
            IDs to Default CableHome Priorities."
         ::= { cabhPriorityQosBase 1  }

   cabhPriorityQosMasterEntry OBJECT-TYPE
           SYNTAX CabhPriorityQosMasterEntry
           MAX-ACCESS   not-accessible
           STATUS    current
           DESCRIPTION
             "An entry for mapping Application IDs to
             Default CableHome Priorities."
      INDEX { cabhPriorityQosMasterApplicationId }
      ::= { cabhPriorityQosMasterTable 1 }


   CabhPriorityQosMasterEntry ::= SEQUENCE {
         cabhPriorityQosMasterApplicationId       INTEGER,
         cabhPriorityQosMasterDefaultCHPriority   INTEGER,
         cabhPriorityQosMasterRowStatus           RowStatus
        }

   cabhPriorityQosMasterApplicationId       OBJECT-TYPE
       SYNTAX                  INTEGER (1..65535)
       MAX-ACCESS              not-accessible
       STATUS                  current
       DESCRIPTION
        "The IANA well-known port number identifying an application."
       ::= { cabhPriorityQosMasterEntry 1 }


Bhagwat/Cardona/Luehrs   Expires - July 2003                 [Page 7]


Internet-Draft        CableHome Gateway QoS MIB          January 2003



   cabhPriorityQosMasterDefaultCHPriority       OBJECT-TYPE
       SYNTAX                  INTEGER (1..8)
       MAX-ACCESS              read-create
       STATUS                  current
       DESCRIPTION
        "The PriorityQos priority assigned to the application."
       ::= { cabhPriorityQosMasterEntry 2 }

   cabhPriorityQosMasterRowStatus  OBJECT-TYPE
       SYNTAX                  RowStatus
       MAX-ACCESS              read-create
       STATUS                  current
       DESCRIPTION
         "The Row Status interlock for creation and deletion
          of row entries. The PS MUST NOT allow the NMS to
          set RowStatus to notInService(2). The PS MUST assign a
          RowStatus of notReady(?) to any new row created
          without a valid value for both entries. The PS will
          prevent modification of this table's columns and return
          an inconsistentValue error if the NMS attempts to make
          such modifications while RowStatus is active(1)."
       ::= { cabhPriorityQosMasterEntry 3 }

   --===============================================================
   --
   --  BP Application Priority Table
   --
   --  The cabhPriorityQosBpTable contains the list of
   --  BPs, the applications implemented on each, and the priority
   --  assigned to each application.
   --
   --===============================================================

   cabhPriorityQosBpTable OBJECT-TYPE
      SYNTAX SEQUENCE OF CabhPriorityQosBpEntry
      MAX-ACCESS not-accessible
      STATUS current
      DESCRIPTION
         "This table contains the priorities for each of the
          discovered CableHome Host (BP) applications
          and related data."
            ::= {cabhPriorityQosBp 1}

   cabhPriorityQosBpEntry OBJECT-TYPE
      SYNTAX      CabhPriorityQosBpEntry
      MAX-ACCESS     not-accessible
      STATUS      current
      DESCRIPTION


Bhagwat/Cardona/Luehrs   Expires - July 2003                 [Page 8]


Internet-Draft        CableHome Gateway QoS MIB          January 2003

         "List of applications entries."
      INDEX { cabhPriorityQosMasterApplicationId,
              cabhPriorityQosBpIpAddrType, cabhPriorityQosBpIpAddr }
      ::= { cabhPriorityQosBpTable 1 }

   CabhPriorityQosBpEntry ::= SEQUENCE {
         cabhPriorityQosBpIpAddrType         InetAddressType,
         cabhPriorityQosBpIpAddr             InetAddress,
         cabhPriorityQosBpApplicationId      Integer32,
         cabhPriorityQosBpDefaultCHPriority  INTEGER,
         cabhPriorityQosBpIndex              Integer32
         }

   cabhPriorityQosBpIpAddrTypeOBJECT-TYPE
      SYNTAX      InetAddressType
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
         "The type of the IP address assigned to a particular
          BP element."
      ::= { cabhPriorityQosBpEntry 1 }


   cabhPriorityQosBpIpAddr    OBJECT-TYPE
      SYNTAX      InetAddress
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
         "The IP address assigned to a particular BP element."
      ::= { cabhPriorityQosBpEntry 2 }

   cabhPriorityQosBpApplicationId   OBJECT-TYPE
      SYNTAX      Integer32 (1..65535)
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
         "The IANA well-known port number assigned to a
          particular application implemented on the
          CableHome Host device in which this BP resides."
      ::= { cabhPriorityQosBpEntry 3 }


   cabhPriorityQosBpDefaultCHPriority  OBJECT-TYPE
      SYNTAX      INTEGER (1..8)
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
         "The PriorityQos priority assigned to a particular
          application implemented on CableHome Host device in
          which this BP resides. The PS populates this entry


Bhagwat/Cardona/Luehrs   Expires - July 2003                 [Page 9]


Internet-Draft        CableHome Gateway QoS MIB          January 2003

          according to the Application Priority Master Table."
      ::= { cabhPriorityQosBpEntry 4 }

   cabhPriorityQosBpIndex  OBJECT-TYPE
      SYNTAX      Integer32 (1..2147483647)
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
        "The unique identifier for a particular row in the
         BP Application Priority Table. This identifier is
         used as an index into the 'nested' Destination
         Priority Table."
           ::= { cabhPriorityQosBpEntry 5 }


   --===============================================================
   --
   --  Destination Priority Table
   --
   --  The cabhPriorityQosDestListTable contains the list of
   --  provisioned destinations (IP address and port number) to
   --  which a BP can send traffic with a special PriorityQos
   --  priority. Any application listed in the BP Application
   --  Priority Table can be provisioned with a Destination
   --  Priority Table.
   --
   --===============================================================

   cabhPriorityQosBpDestTable OBJECT-TYPE
      SYNTAX SEQUENCE OF CabhPriorityQosBpDestEntry
      MAX-ACCESS     not-accessible
      STATUS      current
      DESCRIPTION
         "This table contains the priorities based on destination
          IP address and port number. It is indexed with a unique
          identifier for rows in the BP Application Priority Table."
          ::= {cabhPriorityQosBp 2}

   cabhPriorityQosBpDestEntry OBJECT-TYPE
      SYNTAX      CabhPriorityQosBpDestEntry
      MAX-ACCESS  not-accessible
      STATUS      current
      DESCRIPTION
         "List of Destination IP addresses and port numbers
          for an application to which special PriorityQos
          priority is provisioned."
      INDEX { cabhPriorityQosBpIndex, cabhPriorityQosBpDestIndex }
      ::= { cabhPriorityQosBpDestTable 1 }

   CabhPriorityQosBpDestEntry ::= SEQUENCE {


Bhagwat/Cardona/Luehrs   Expires - July 2003                [Page 10]


Internet-Draft        CableHome Gateway QoS MIB          January 2003

       cabhPriorityQosBpDestIndex            Integer32,
       cabhPriorityQosBpDestIpAddrType       InetAddressType,
       cabhPriorityQosBpDestIpAddr           InetAddress,
       cabhPriorityQosBpDestPort             InetPortNumber,
       cabhPriorityQosBpDestIpPortPriority   INTEGER
         }


   cabhPriorityQosBpDestIndex OBJECT-TYPE
      SYNTAX      Integer32 (1..2147483647)
      MAX-ACCESS  not-accessible
      STATUS      current
      DESCRIPTION
        "The locally unique index into the Destination
         Priority Table."
      ::= { cabhPriorityQosBpDestEntry 1 }

   cabhPriorityQosBpDestIpAddrType     OBJECT-TYPE
      SYNTAX      InetAddressType
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
         "The type of the Destination IP Address."
      DEFVAL  { ipv4 }
      ::= { cabhPriorityQosBpDestEntry 2 }

   cabhPriorityQosBpDestIpAddr   OBJECT-TYPE
      SYNTAX      InetAddress
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
        "The Destination IP address of the LAN IP Device
         of an application to which special PriorityQos
         priority is assigned."
      ::= { cabhPriorityQosBpDestEntry 3 }

   cabhPriorityQosBpDestPort     OBJECT-TYPE
      SYNTAX      InetPortNumber
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION
        "The port number of an application to which special
         PriorityQos priority is assigned."
      ::= { cabhPriorityQosBpDestEntry 4 }

   cabhPriorityQosBpDestIpPortPriority    OBJECT-TYPE
      SYNTAX      INTEGER (1..8)
      MAX-ACCESS  read-only
      STATUS      current
      DESCRIPTION


Bhagwat/Cardona/Luehrs   Expires - July 2003                [Page 11]


Internet-Draft        CableHome Gateway QoS MIB          January 2003

        "The PriorityQos priority assigned to a particular
          application in another LAN IP Device."
      ::= { cabhPriorityQosBpDestEntry 5 }


   --===============================================================
   --
   --  PS Interface Attributes Table
   --
   --  The cabhPriorityQosPsIfAttribTable contains the number of
   --  media access priorities and number of queues associated with
   --  each LAN interface in the Residential Gateway.
   --
   --===============================================================

   cabhPriorityQosPsIfAttribTable   OBJECT-TYPE
           SYNTAX SEQUENCE OF CabhPriorityQosPsIfAttribEntry
           MAX-ACCESS   not-accessible
           STATUS    current
           DESCRIPTION
            "This table contains the number of media
             access priorities and number of queues associated
             with each LAN interface in the Residential Gateway."
            ::= { cabhPriorityQosPs 1  }

   cabhPriorityQosPsIfAttribEntry      OBJECT-TYPE
           SYNTAX    CabhPriorityQosPsIfAttribEntry
           MAX-ACCESS   not-accessible
           STATUS    current
           DESCRIPTION
             "Number of media access priorities and number
              of queues for each LAN interface in the
              Residential Gateway. This table applies only
              to interfaces through which data flows."
           INDEX { ifIndex }
           ::= { cabhPriorityQosPsIfAttribTable 1 }

   CabhPriorityQosPsIfAttribEntry ::= SEQUENCE {
      cabhPriorityQosPsIfAttribIfNumPriorities   INTEGER,
           cabhPriorityQosPsIfAttribIfNumQueues   INTEGER
   }

   cabhPriorityQosPsIfAttribIfNumPriorities OBJECT-TYPE
          SYNTAX     INTEGER (1..8)
          MAX-ACCESS read-only
          STATUS     current
          DESCRIPTION
           "The number of media access priorities supported
            by this LAN interface."
   ::= { cabhPriorityQosPsIfAttribEntry 1 }


Bhagwat/Cardona/Luehrs   Expires - July 2003                [Page 12]


Internet-Draft        CableHome Gateway QoS MIB          January 2003


   cabhPriorityQosPsIfAttribIfNumQueues OBJECT-TYPE
          SYNTAX     INTEGER (1..8)
          MAX-ACCESS read-only
          STATUS     current
          DESCRIPTION
           "The number of queues associated with this LAN
            interface."
   ::= { cabhPriorityQosPsIfAttribEntry 2 }


   -- Placeholder for notifications/traps.
   --

   cabhQosNotification         OBJECT IDENTIFIER  ::= { cabhQosMib 2 }
   cabhPriorityQosNotification OBJECT IDENTIFIER  ::= {
   cabhQosNotification 1 }



   --
   -- Conformance definitions
   --
   cabhQosConformance          OBJECT IDENTIFIER  ::= { cabhQosMib 3 }
   cabhPriorityQosConformance  OBJECT IDENTIFIER  ::= {
   cabhQosConformance 1 }
   cabhPriorityQosGroups       OBJECT IDENTIFIER  ::= {
   cabhPriorityQosConformance 1 }
   cabhPriorityQosCompliances  OBJECT IDENTIFIER  ::= {
   cabhPriorityQosConformance 2 }


   -- ==================

   -- compliance statements

   cabhPriorityQosCompliance MODULE-COMPLIANCE
       STATUS     current
       DESCRIPTION
         "The compliance statement for devices that implement
          CableHome 1.1 PriorityQos capability."

       MODULE   --cabhPriorityQosMib



   -- unconditionally mandatory groups

       MANDATORY-GROUPS {
               cabhPriorityQosGroup


Bhagwat/Cardona/Luehrs   Expires - July 2003                [Page 13]


Internet-Draft        CableHome Gateway QoS MIB          January 2003

       }

   ::= { cabhPriorityQosCompliances 1}


   cabhPriorityQosGroup OBJECT-GROUP
       OBJECTS {
       cabhPriorityQosMasterDefaultCHPriority,
       cabhPriorityQosMasterRowStatus,
       cabhPriorityQosBpIpAddrType,
       cabhPriorityQosBpIpAddr,
       cabhPriorityQosBpApplicationId,
       cabhPriorityQosBpDefaultCHPriority,
       cabhPriorityQosBpIndex,
       cabhPriorityQosBpDestIpAddrType,
       cabhPriorityQosBpDestIpAddr,
       cabhPriorityQosBpDestPort,
       cabhPriorityQosBpDestIpPortPriority,
       cabhPriorityQosPsIfAttribIfNumPriorities,
       cabhPriorityQosPsIfAttribIfNumQueues
       }
       STATUS    current
       DESCRIPTION
           "Group of objects for CableHome Application
            Priority MIB."
       ::= { cabhPriorityQosGroups 1 }

   END



5. Formal Syntax

   The following syntax specification uses the augmented Backus-Naur
   Form (BNF) as described in RFC-2234 [3].

6. Security Considerations

   There are a number of management objects defined in this MIB that
   have a MAX-ACCESS clause of read-write and/or read-create.  Such
   objects may be considered sensitive or vulnerable in some network
   environments.  The support for SET operations in a non-secure
   environment without proper protection can have a negative effect on
   network operations.

   It is thus important to control even GET access to these objects and
   possibly to even encrypt the values of these objects when sending
   them over the network via SNMP.  Not all versions of SNMP provide
   features for such a secure environment.



Bhagwat/Cardona/Luehrs   Expires - July 2003                [Page 14]


Internet-Draft        CableHome Gateway QoS MIB          January 2003

   SNMP versions prior to SNMPv3 did not include adequate security.
   Even if the network itself is secure (for example by using IPSec),
   even then, there is no control as to who on the secure network is
   allowed to access and GET/SET (read/change/create/delete) the objects
   in this MIB module.

   It is RECOMMENDED that implementers consider the security features as
   provided by the SNMPv3 framework (see [RFC3410], section 8),
   including full support for the SNMPv3 cryptographic mechanisms (for
   authentication and privacy).

   Further, deployment of SNMP versions prior to SNMPv3 is NOT
   RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to
   enable cryptographic security.  It is then a customer/operator
   responsibility to ensure that the SNMP entity giving access to an
   instance of this MIB module, is properly configured to give access to
   the objects only to those principals (users) that have legitimate
   rights to indeed GET or SET (change/create/delete) them.



7. References

   1  Bradner, S., "The Internet Standards Process -- Revision 3", BCP
      9, RFC 2026, October 1996.

   2  Bradner, S., "Key words for use in RFCs to Indicate Requirement
      Levels", BCP 14, RFC 2119, March 1997

   3  Crocker, D. and Overell, P.(Editors), "Augmented BNF for Syntax
      Specifications: ABNF", RFC 2234, Internet Mail Consortium and
      Demon Internet Ltd., November 1997

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

   5  Rose, M. and K. McCloghrie, "Concise MIB Definitions", STD 16, RFC
      1212, March 1991.

   6  Rose, M., "A Convention for Defining Traps for use with the SNMP",
      RFC 1215, March 1991.

   7  McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Structure of
      Management Information for Version 2 (SMIv2)", STD 58, RFC 2578,
      April 1999.

   8  McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Textual
      Conventions for SMIv2", STD 58, RFC 2579, April 1999.



Bhagwat/Cardona/Luehrs   Expires - July 2003                [Page 15]


Internet-Draft        CableHome Gateway QoS MIB          January 2003



   9 McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Conformance
      Statements for SMIv2", STD 58, RFC 2580, April 1999.

   10 Case, J., Fedor, M., Schoffstall, M. and J. Davin, "Simple Network
      Management Protocol", STD 15, RFC 1157, May 1990.

   11 Case, J., McCloghrie, K., Rose, M. and S. Waldbusser,
      "Introduction to Community-based SNMPv2", RFC 1901, January 1996.

   12 Case, J., Mundy, R., Partain, D, and B. Stewart, "Introduction and
      Applicability Statements for Internet Standard Management
      Framework", RFC 3410, December 2002.

   13 Harrington D., Presuhn R. and B. Wijnen, "An Architecture for
      Describing Simple Network Management Protocol (SNMP) Management
      Frameworks", RFC 3411, December 2002.

   14 Case, J., Harrington D., Presuhn R. and B. Wijnen, "Message
      Processing and Dispatching for the Simple Network Management
      Protocol (SNMP)", RFC 3412, December 2002.

   15 Levi, D., Meyer, P., and B. Stewart, ôSimple Network Management
      Protocol (SNMP) Applications", RFC 3413, December 2002.

   16 Blumenthal, U. and B. Wijnen, "User-based Security Model (USM) for
      version 3 of the Simple Network Management Protocol (SNMPv3)", RFC
      3414, December 2002.

   17 Wijnen, B., Presuhn, R. and K. McCloghrie, "View-based Access
      Control Model (VACM) for the Simple Network Management Protocol
      (SNMP)", RFC 3415, December 2002.

   18 Presuhn, R., Case, J., McCloghrie, K., Rose, M. and S. Waldbusser,
      "Version 2 of the Protocol Operations for the Simple Network
      Management Protocol (SNMPv2)", RFC 3416, Decemeber 2002.

   19 Presuhn, R., Case, J., McCloghrie, K., Rose, M. and S. Waldbusser,
      "Transport Mappings for the Simple Network Management Protocol
      (SNMPv2)", RFC 3417, December 2002.

   20 Presuhn, R., Case, J., McCloghrie, K., Rose, M. and S. Waldbusser,
      "Management Information Base (MIB) for the Simple Network
      Management Protocol (SNMP)", RFC 3418, December 2002.

   21 Cable Television Laboratories, ôCableHome 1.0 Specificationö, CH-
      SP-I02-020920, September 2002,
      http://www.cablelabs.com/projects/cablehome/specifications.



Bhagwat/Cardona/Luehrs   Expires - July 2003                [Page 16]


Internet-Draft        CableHome Gateway QoS MIB          January 2003


   22 Cable Television Laboratories, ôCableHome 1.1 Specificationö, CH-
      SP-D01-03xxxx, March 2003.

   23 Droms, R., ôDynamic Host Configuration Protocolö, RFC 2131, March
      1997.

   24 Sollins, K., ô The TFTP Protocol (Revision 2)ö, RFC 1350, July
      1992.


8. Intellectual Property

   The IETF takes no position regarding the validity or scope of any
   intellectual property or other rights that might be claimed to
   pertain to the implementation or use of the technology described in
   this document or the extent to which any license under such rights
   might or might not be available; neither does it represent that it
   has made any effort to identify any such rights.  Information on the
   IETF's procedures with respect to rights in standards-track and
   standards-related documentation can be found in BCP-11.  Copies of
   claims of rights made available for publication and any assurances of
   licenses to be made available, or the result of an attempt made to
   obtain a general license or permission for the use of such
   proprietary rights by implementers or users of this specification can
   be obtained from the IETF Secretariat.

   The IETF invites any interested party to bring to its attention any
   copyrights, patents or patent applications, or other proprietary
   rights which may cover technology that may be required to practice
   this standard.  Please address the information to the IETF Executive
   Director.






9. AuthorÆs Addresses

   Amol Bhagwat
   Cable Television Laboratories
   400 Centennial Parkway
   Louisville, CO  80027
   Phone: +1 303.661.9100
   Email: a.bhagwat@cablelabs.com

   Eduardo Cardona
   Cable Television Laboratories
   400 Centennial Parkway


Bhagwat/Cardona/Luehrs   Expires - July 2003                [Page 17]


Internet-Draft        CableHome Gateway QoS MIB          January 2003

   Louisville, CO  80027
   Phone: +1 303.661.9100
   Email: e.cardona@cablelabs.com

   Kevin Luehrs
   Cable Television Laboratories
   Louisville, CO 80027
   Phone: +1 303.661.9100
   Email: k.luehrs@cablelabs.com

   Doug Jones
   YAS Broadband Ventures
   300 Brickstone Square
   Andover, MA  01810
   Phone: +1 303.661.3823
   Email: doug@yas.com





10. Full Copyright Statement

   Copyright (C) The Internet Society (2003). All Rights Reserved.

   This document and translations of it may be copied and furnished to
   others, and derivative works that comment on or otherwise explain it
   or assist in its implementation may be prepared, copied, published
   and distributed, in whole or in part, without restriction of any
   kind, provided that the above copyright notice and this paragraph are
   included on all such copies and derivative works.  However, this
   document itself may not be modified in any way, such as by removing
   the copyright notice or references to the Internet Society or other
   Internet organizations, except as needed for the purpose of
   developing Internet standards in which case the procedures for
   copyrights defined in the Internet Standards process must be
   followed, or as required to translate it into languages other than
   English.

   The limited permissions granted above are perpetual and will not be
   revoked by the Internet Society or its successors or assigns.

   This document and the information contained herein is provided on an
   "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
   TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
   BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
   HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.




Bhagwat/Cardona/Luehrs   Expires - July 2003                [Page 18]