Internet-Draft                                            E. Cardona
   draft-ietf-ipcdn-cable-gateway-tools-mib-00.txt            K. Luehrs
   Expires: December 2003                                     CableLabs

                                                                 D. Mah
                                                                Linksys

                                                               D. Jones
                                                                YAS BBV
                                                              June 2003


              Cable Gateway Tools Management Information Base
               for CableHome compliant Residential Gateways


Status of this Memo

   This document is an Internet-Draft and is subject to 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.


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 of CableHome compliant WAN Gateway Devices and home
   routers.  Specifically, this MIB defines managed objects for both a



Cardona, et. al.       Expires - December 2003               [Page 1]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

   connection speed tool and an ICMP "ping" tool between the Gateway and
   devices on the LAN.

   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.....................2
   2. Glossary.......................................................3
      2.1 CableHome Residential Gateway..............................3
      2.2 Portal Services............................................3
      2.3 LAN IP Device..............................................3
      2.4 WAN Management (WAN-Man) Address...........................3
      2.5 WAN Data (WAN-Data) Address................................3
      2.6 LAN Translated (LAN-Trans) Address.........................4
      2.7 LAN Passthrough (LAN-Pass) Address.........................4
   3. Overview.......................................................4
      3.1 Structure of the MIB.......................................4
   4. MIB Definitions................................................4
   5. Acknowledgements..............................................16
   6. Formal Syntax.................................................16
   7. Security Considerations.......................................16
   8. Normative References..........................................17
   9. Informative References........................................18
   10. Intellectual Property........................................19
   11. Author's Addresses...........................................19
   12. Full Copyright Statement.....................................20


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



Cardona, et. al.       Expires û December 2003               [Page 2]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

   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].

2.1 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) [22], a TFTP
   server (RFC1350) [23], 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.2 Portal Services

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


2.3 LAN IP Device

   A LAN IP Device is representative of a typical IP device expected to
   reside on home networks, and is assumed to contain a TCP/IP stack as
   well as a DHCP client.

2.4 WAN Management (WAN-Man) Address

   WAN Management Addresses are intended for network management traffic
   on the cable network between the network management system and the PS
   element. Typically, these addresses will reside in private IP address
   space.

2.5 WAN Data (WAN-Data) Address

   WAN Data Addresses are intended for subscriber application traffic on
   the cable network and beyond, such as traffic between LAN IP Devices
   and Internet hosts. Typically, these addresses will reside in public
   IP address space.




Cardona, et. al.       Expires û December 2003               [Page 3]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

2.6 LAN Translated (LAN-Trans) Address

   LAN Translated Addresses are intended for subscriber application and
   management traffic on the home network between LAN IP Devices and the
   PS element. Typically, these addresses will reside in private IP
   address space, and can typically be reused across subscribers.

2.7 LAN Passthrough (LAN-Pass) Address

   LAN Passthrough Addresses are intended for subscriber application
   traffic, such as traffic between LAN IP Devices and Internet hosts,
   on the home network, the cable network, and beyond. Typically, these
   addresses will reside in public IP address space.


3. Overview

   This MIB provides a set of security objects required for the
   management of CableHome compliant residential gateway devices.  The
   specification is derived from the CableHome 1.0 specification [21].

3.1 Structure of the MIB

   This MIB is structured into two groups:

   The cabhCtpConnSpeed group contains objects needed to test the
   connection speed between the Gateway and a LAN device.

   The cabhCtpPing Group provides objects allowing the manager to send
   an ICMP ping from the Gateway to a LAN device.



4. MIB Definitions


   CABH-IETF-CTP-MIB DEFINITIONS ::= BEGIN

   IMPORTS
      MODULE-IDENTITY,
      OBJECT-TYPE,
      mib-2                  FROM SNMPv2-SMI

      TimeStamp,
      TruthValue             FROM SNMPv2-TC

      OBJECT-GROUP,
      MODULE-COMPLIANCE      FROM SNMPv2-CONF

      InetAddressType,


Cardona, et. al.       Expires û December 2003               [Page 4]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

      InetAddress            FROM INET-ADDRESS-MIB;


   cabhCtpMib MODULE-IDENTITY
       LAST-UPDATED    "200306210000Z" -- Jun 21, 2003
       ORGANIZATION    "IETF IPCDN Working Group"
       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; mibs@cablelabs.com

               IETF IPCDN Working Group
               General Discussion: ipcdn@ietf.org
               Subscribe: http://www.ietf.org/mailman/listinfo/ipcdn
               Archive: ftp://ftp.ietf.org/ietf-mail-archive/ipcdn
               Co-chairs: Richard Woundy,
                          Richard_Woundy@cable.comcast.com
                          Jean-Francois Mule, jf.mule@cablelabs.com"
       DESCRIPTION
               "This MIB module defines the diagnostic controls offered
               by the CableHome Test Portal (CTP).

               Copyright (C) The Internet Society (2003). This version
               of this MIB module is part of RFC xxxx; see the RFC
               itself for full legal notices."
       REVISION         "200306210000Z" -- Jun 21, 2003
       DESCRIPTION
               "Initial version, published as RFC xxxx."
               -- RFC editor to assign xxxx
       ::= { mib-2 xx }
       -- xx to be assigned by IANA

   -- Textual conventions


   cabhCtpObjects      OBJECT IDENTIFIER ::= { cabhCtpMib 1 }
   cabhCtpBase         OBJECT IDENTIFIER ::= { cabhCtpObjects 1 }
   cabhCtpConnSpeed    OBJECT IDENTIFIER ::= { cabhCtpObjects 2 }
   cabhCtpPing         OBJECT IDENTIFIER ::= { cabhCtpObjects 3 }

   --
   --  The following group describes the base objects in the CableHome
   --  Management Portal.
   --



Cardona, et. al.       Expires û December 2003               [Page 5]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

   cabhCtpSetToFactory    OBJECT-TYPE
       SYNTAX        TruthValue
       MAX-ACCESS    read-write
       STATUS        current
       DESCRIPTION
               "Setting this object to true(1) causes all the tables in
               the CTP MIB to be cleared, and all CTP MIB objects with
               default values set back to those default values.
               Reading this object always returns false(2)."
       ::={cabhCtpBase 1}

   cabhCtpLastSetToFactory    OBJECT-TYPE
       SYNTAX      TimeStamp
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "The value of sysUpTime when cabhCtpSetToFactory was
               last set to true. Zero if never reset."
       ::={cabhCtpBase 2}

   --
   --    Parameter and results from Connection Speed Command
   --

   cabhCtpConnSrcIpType    OBJECT-TYPE
       SYNTAX        InetAddressType
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "The IP Address type used as the source address for the
               Connection Speed Test."
       DEFVAL { ipv4 }
   ::= { cabhCtpConnSpeed 1 }

   cabhCtpConnSrcIp    OBJECT-TYPE
       SYNTAX      InetAddress
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "The IP Address used as the source address for the
               Connection Speed Test. The type of this address is
               specified by cabhCtpConnSrcIpType. The default value is
               the value of cabhCdpServerRouter (192.168.0.1)."
       REFERENCE
           "CableHome Specification Section 6.4.4"
       DEFVAL { 'c0a80001'h }    -- 192.168.0.1
       ::= { cabhCtpConnSpeed 2 }

   cabhCtpConnDestIpType    OBJECT-TYPE
       SYNTAX        InetAddressType


Cardona, et. al.       Expires û December 2003               [Page 6]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

       MAX-ACCESS    read-write
       STATUS        current
       DESCRIPTION
               "The IP Address Type for the CTP Connection Speed Tool
               destination address. "
       DEFVAL { ipv4 }
       ::={ cabhCtpConnSpeed 3 }

   cabhCtpConnDestIp    OBJECT-TYPE
       SYNTAX      InetAddress
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "The IP Address used as the destination address for the
               Connection Speed Test. The type of this address is
               specified by cabhCtpConnDestIpType"
       ::= { cabhCtpConnSpeed 4 }

   cabhCtpConnProto    OBJECT-TYPE
       SYNTAX      INTEGER {
                     udp(1),
                     tcp(2)
                   }
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "The protocol used in the Connection Speed Test.
               TCP testing is optional."
       DEFVAL { udp }
       ::= { cabhCtpConnSpeed 5 }

   cabhCtpConnNumPkts    OBJECT-TYPE
       SYNTAX      INTEGER (1..65535)
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "The number of packets the CTP is to send when triggered
               to execute the Connection Speed Tool."
       DEFVAL { 100 }
       ::= { cabhCtpConnSpeed 6 }

   cabhCtpConnPktSize    OBJECT-TYPE
       SYNTAX      INTEGER (64..1518)
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "The size of the test frames."
       REFERENCE
           ""
       DEFVAL { 1518 }


Cardona, et. al.       Expires û December 2003               [Page 7]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

       ::= { cabhCtpConnSpeed 7 }

   cabhCtpConnTimeOut    OBJECT-TYPE
       SYNTAX      INTEGER (0..600000) -- Max 10 minutes
       UNITS        "milliseconds"
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "The timeout value for the response.  A value of zero
               indicates no time out and can be used for TCP only."
       DEFVAL {30000}  -- 30 seconds
       ::= { cabhCtpConnSpeed 8 }

   cabhCtpConnControl    OBJECT-TYPE
       SYNTAX      INTEGER {
                       start(1),
                       abort(2)
                    }
       MAX-ACCESS    read-write
       STATUS        current
       DESCRIPTION
               "The control for the Connection Speed Tool. Setting this
               object to start(1)  causes the Connection Speed Tool to
               execute. Setting this object to abort(2) causes the
               Connection Speed Tool to stop running.
               This parameter should only be set via SNMP."
       DEFVAL  {abort }
       ::={ cabhCtpConnSpeed 9 }

   cabhCtpConnStatus    OBJECT-TYPE
       SYNTAX      INTEGER {
                       notRun(1),
                       running(2),
                       complete(3),
                       aborted(4),
                       timedOut(5)
                   }
       MAX-ACCESS    read-only
       STATUS        current
       DESCRIPTION
               "The status of the Connection Speed Tool."
       DEFVAL   { notRun }
       ::={ cabhCtpConnSpeed 10 }

   cabhCtpConnPktsSent    OBJECT-TYPE
       SYNTAX      INTEGER (0..65535)
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "The number of packets the CTP sent after it was


Cardona, et. al.       Expires û December 2003               [Page 8]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

               triggered to execute the Connection Speed Tool."
       ::= { cabhCtpConnSpeed 11 }

   cabhCtpConnPktsRecv    OBJECT-TYPE
       SYNTAX      INTEGER (0..65535)
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "The number of packets the CTP received after it
               executed the Connection Speed Tool."
       ::= { cabhCtpConnSpeed 12 }

   cabhCtpConnRTT    OBJECT-TYPE
       SYNTAX      INTEGER (0..600000)
       UNITS       "millisec"
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "The resulting round trip time for the set of packets
               sent to and received from the target LAN IP Device."
       ::= { cabhCtpConnSpeed 13 }

   cabhCtpConnThroughput    OBJECT-TYPE
       SYNTAX      INTEGER (0..65535)
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "The average round-trip throughput measured in kilobits
               per second."
       ::= { cabhCtpConnSpeed 14 }

   --
   --    Parameters and Results for Ping Command
   --

   cabhCtpPingSrcIpType    OBJECT-TYPE
       SYNTAX        InetAddressType
       MAX-ACCESS    read-write
       STATUS        current
       DESCRIPTION
               "The IP Address Type for CTP Ping Tool source address."
       DEFVAL { ipv4 }
       ::={ cabhCtpPing 1 }

   cabhCtpPingSrcIp    OBJECT-TYPE
       SYNTAX      InetAddress
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "The IP Address used as the source address for the Ping


Cardona, et. al.       Expires û December 2003               [Page 9]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

               Test.  The type of this address is  specified by
               cabhCtpPingSrcIpType. The default value is the value of
               CabhCdpServerRouter (192.168.0.1)."
       REFERENCE
               "CableHome 1.0 Specification Section 6.4.4"
       DEFVAL { 'c0a80001'h }
       ::= { cabhCtpPing 2 }

   cabhCtpPingDestIpType    OBJECT-TYPE
       SYNTAX        InetAddressType
       MAX-ACCESS    read-write
       STATUS        current
       DESCRIPTION
               "The IP Address Type for the CTP Ping Tool destination
               address."
       DEFVAL { ipv4 }
       ::={ cabhCtpPing 3 }

   cabhCtpPingDestIp    OBJECT-TYPE
       SYNTAX      InetAddress
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "The Destination IP Address used as the destination
               address for the Ping Test."
       ::= { cabhCtpPing 4 }

   cabhCtpPingNumPkts    OBJECT-TYPE
       SYNTAX        INTEGER (1..4)
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "The number of packets to send to each host."
       DEFVAL {1}
       ::= { cabhCtpPing 5 }

   cabhCtpPingPktSize    OBJECT-TYPE
       SYNTAX      INTEGER (64..1518)
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "The size of the test frames."
       DEFVAL {64}
       ::= { cabhCtpPing 6 }

   cabhCtpPingTimeBetween    OBJECT-TYPE
       SYNTAX      INTEGER (0..600000)
       UNITS       "milliseconds"
       MAX-ACCESS  read-write
       STATUS      current


Cardona, et. al.       Expires û December 2003              [Page 10]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

       DESCRIPTION
               "The time between sending one ping and the next."
       DEFVAL { 1000 }
       ::= { cabhCtpPing 7 }

   cabhCtpPingTimeOut        OBJECT-TYPE
       SYNTAX       INTEGER (1..600000)
       UNITS        "milliseconds"
       MAX-ACCESS   read-write
       STATUS       current
       DESCRIPTION
               "The time out for ping response (ICMP reply) for a
               single transmitted ping message (ICMP request)."
       DEFVAL  { 1000 } -- 1 second
       ::={ cabhCtpPing 8 }



   cabhCtpPingControl    OBJECT-TYPE
       SYNTAX      INTEGER {
                       start(1),
                       abort(2)
                   }
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "The control for the Ping Tool. Setting this object to
               start(1) causes the Ping Tool to execute. Setting this
               object to abort(2) causes the Ping Tool to stop running.
               This parameter should only be set via SNMP."
       DEFVAL  {abort }
       ::={ cabhCtpPing 9 }


   cabhCtpPingStatus    OBJECT-TYPE
       SYNTAX      INTEGER {
                       notRun(1),
                       running(2),
                       complete(3),
                       aborted(4),
                       timedOut(5)
                    }
       MAX-ACCESS    read-only
       STATUS        current
       DESCRIPTION
               "The status of the Ping Tool."
       DEFVAL   { notRun }
       ::={ cabhCtpPing 10 }




Cardona, et. al.       Expires û December 2003              [Page 11]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

   cabhCtpPingNumSent     OBJECT-TYPE
       SYNTAX      INTEGER (0..4)
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "The number of Pings sent"
       ::={ cabhCtpPing 11 }

   cabhCtpPingNumRecv    OBJECT-TYPE
       SYNTAX      INTEGER (0..255)
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "The number of pings received."
       ::= { cabhCtpPing 12 }

   cabhCtpPingAvgRTT    OBJECT-TYPE
       SYNTAX        INTEGER (0..600000)
       UNITS         "millisec"
       MAX-ACCESS    read-only
       STATUS        current
       DESCRIPTION
               "The resulting average of round trip times for
               acknowledged packets."
       ::= { cabhCtpPing 13 }

   cabhCtpPingMaxRTT    OBJECT-TYPE
       SYNTAX        INTEGER (0..600000)
       UNITS            "millisec"
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "The resulting maximum of round trip times for
               acknowledged packets."
       ::= { cabhCtpPing 14 }

   cabhCtpPingMinRTT    OBJECT-TYPE
       SYNTAX      INTEGER (0..600000)
       UNITS       "millisec"
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "The resulting minimum of round trip times for
               acknowledged packets."
       ::= { cabhCtpPing 15 }

   cabhCtpPingNumIcmpError    OBJECT-TYPE
       SYNTAX        INTEGER (0..255)
       MAX-ACCESS  read-only
       STATUS      current


Cardona, et. al.       Expires û December 2003              [Page 12]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

       DESCRIPTION
               "Number of ICMP errors."
       ::= { cabhCtpPing 16 }

   cabhCtpPingIcmpError    OBJECT-TYPE
       SYNTAX      INTEGER (0..255)
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "The last ICMP error."
       ::= { cabhCtpPing 17 }

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

   --
   -- notification group is for future extension.
   --

   cabhCtpNotification   OBJECT IDENTIFIER ::= { cabhCtpMib 2  }
   cabhCtpNotifications  OBJECT IDENTIFIER ::= { cabhCtpNotification 0 }
   cabhCtpConformance    OBJECT IDENTIFIER ::= { cabhCtpMib 3 }
   cabhCtpCompliances    OBJECT IDENTIFIER ::= { cabhCtpConformance 1 }
   cabhCtpGroups         OBJECT IDENTIFIER ::= { cabhCtpConformance 2 }

   --
   --  Notification Group
   --
   --
   -- compliance statements

   cabhCtpBasicCompliance MODULE-COMPLIANCE
       STATUS     current
       DESCRIPTION
               "The compliance statement for devices that implement
               Portal Service feature."
       MODULE   --cabhCtpMib



   -- unconditionally mandatory groups

       MANDATORY-GROUPS {
           cabhCtpGroup
       }

       OBJECT cabhCtpConnSrcIpType
          SYNTAX InetAddressType { ipv4(1) }
          DESCRIPTION
              "An implementation is only required to support IPv4
               addresses."


Cardona, et. al.       Expires û December 2003              [Page 13]


Internet-Draft       CableHome Gateway Tools MIB            June 2003


       OBJECT cabhCtpConnSrcIp
          SYNTAX  InetAddress (SIZE(4))
          DESCRIPTION
              "An implementation is only required to support IPv4
               addresses."

       OBJECT cabhCtpConnDestIpType
          SYNTAX InetAddressType { ipv4(1) }
          DESCRIPTION
              "An implementation is only required to support IPv4
               addresses."

       OBJECT cabhCtpConnDestIp
          SYNTAX  InetAddress (SIZE(4))
          DESCRIPTION
              "An implementation is only required to support IPv4
               addresses."

       OBJECT cabhCtpPingSrcIpType
          SYNTAX InetAddressType { ipv4(1) }
          DESCRIPTION
              "An implementation is only required to support IPv4
               addresses."

       OBJECT cabhCtpPingSrcIp
          SYNTAX  InetAddress (SIZE(4))
          DESCRIPTION
              "An implementation is only required to support IPv4
               addresses."

       OBJECT cabhCtpPingDestIpType
          SYNTAX InetAddressType { ipv4(1) }
          DESCRIPTION
              "An implementation is only required to support IPv4
               addresses."

       OBJECT cabhCtpPingDestIp
          SYNTAX  InetAddress (SIZE(4))
          DESCRIPTION
              "An implementation is only required to support IPv4
               addresses."

   ::= { cabhCtpCompliances 3 }


   cabhCtpGroup OBJECT-GROUP
       OBJECTS {

           cabhCtpSetToFactory,


Cardona, et. al.       Expires û December 2003              [Page 14]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

           cabhCtpLastSetToFactory,
           cabhCtpConnSrcIpType,
           cabhCtpConnSrcIp,
           cabhCtpConnDestIpType,
           cabhCtpConnDestIp,
           cabhCtpConnProto,
           cabhCtpConnNumPkts,
           cabhCtpConnPktSize,
           cabhCtpConnTimeOut,
           cabhCtpConnControl,
           cabhCtpConnStatus,
           cabhCtpConnPktsSent,
           cabhCtpConnPktsRecv,
           cabhCtpConnRTT,
           cabhCtpConnThroughput,

           cabhCtpPingSrcIpType,
           cabhCtpPingSrcIp,
           cabhCtpPingDestIpType,
           cabhCtpPingDestIp,
           cabhCtpPingNumPkts,
           cabhCtpPingPktSize,
           cabhCtpPingTimeBetween,
           cabhCtpPingTimeOut,
           cabhCtpPingControl,
           cabhCtpPingStatus,
           cabhCtpPingNumSent,
           cabhCtpPingNumRecv,
           cabhCtpPingAvgRTT,
           cabhCtpPingMinRTT,
           cabhCtpPingMaxRTT,
           cabhCtpPingNumIcmpError,
           cabhCtpPingIcmpError
       }
       STATUS    current
       DESCRIPTION
               "Group of objects for CableHome CTP MIB."
       ::= { cabhCtpGroups 1 }
   END













Cardona, et. al.       Expires û December 2003              [Page 15]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

5. Acknowledgements

    Roy Spitzer        -  Consultant
    Mike Mannette      -  Consultant
    Randy Dunton       -  Intel
    Dmitrii Loukianov  -  Intel
    Wes Peters         -  DoBox
    Chris Zacker       -  Broadcom


   Funding for the RFC Editor function is currently provided by the
   Internet Society.



6. Formal Syntax


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


7. 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.

   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


Cardona, et. al.       Expires û December 2003              [Page 16]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

   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.



8. Normative 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.

   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.




Cardona, et. al.       Expires û December 2003              [Page 17]


Internet-Draft       CableHome Gateway Tools MIB            June 2003


   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.


9. Informative References

   22 Drums, R., ôDynamic Host Configuration Protocolö, RFC 2131, March
      1997.

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

   24 Harrington, R., Presuhn, R., and B. Wijnen, ôAn Architecture for
     Describing SNMP Management Frameworksö, RFC 2571, April 1999.





Cardona, et. al.       Expires û December 2003              [Page 18]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

   25 Daniele, M., Haberman, B., Routhier, S., and J. Schoenwaelder,
     ôTextual Contentions for Internet Network Addressesö, May 2002.



10. 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.


11. Author's Addresses

   Eduardo Cardona
   Cable Television Laboratories
   400 Centennial Parkway
   Louisville, CO  80027
   Phone: +1 303.661.9100
   Email: e.cardona@cablelabs.com

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

   Donald Mah
   Linksys
   Phone: +1 949.784.1833
   Email: donald.mah@linksys.com




Cardona, et. al.       Expires û December 2003              [Page 19]


Internet-Draft       CableHome Gateway Tools MIB            June 2003

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


12. 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."

















Cardona, et. al.       Expires û December 2003              [Page 20]