PKTC-IETF-MTA-MIB DEFINITIONS ::= BEGIN

IMPORTS

    MODULE-IDENTITY,

    OBJECT-TYPE,

    OBJECT-IDENTITY,

    Unsigned32,

    Counter32,

    NOTIFICATION-TYPE,

    mib-2

          FROM SNMPv2-SMI                    -- [RFC2578]

    TEXTUAL-CONVENTION,

    RowStatus,

    TruthValue

          FROM SNMPv2-TC                     -- [RFC2579]

    OBJECT-GROUP,

    MODULE-COMPLIANCE,

    NOTIFICATION-GROUP

          FROM SNMPv2-CONF                   -- [RFC2580]

    InetAddressType,

    InetAddress

          FROM INET-ADDRESS-MIB              -- [RFC4001]

    sysDescr

          FROM SNMPv2-MIB                    -- [RFC3418]

    SnmpAdminString

          FROM SNMP-FRAMEWORK-MIB            -- [RFC3411]

    docsDevSoftwareGroupV2

          FROM DOCS-CABLE-DEVICE-MIB         -- [RFC4639]

    DocsX509ASN1DEREncodedCertificate,

    docsBpi2CodeDownloadGroup

          FROM DOCS-IETF-BPI2-MIB            -- [RFC4131]

    LongUtf8String

          FROM SYSAPPL-MIB                   -- [RFC2287]

    ifPhysAddress

          FROM IF-MIB;                       -- [RFC2863]

    pktcIetfMtaMib MODULE-IDENTITY

    LAST-UPDATED "200609180000Z" -- September 18, 2006

    ORGANIZATION "IETF IP over Cable Data Network Working Group"

    CONTACT-INFO

        "Eugene Nechamkin

         Broadcom Corporation,

         200-13711 International Place,

         Richmond, BC, V6V 2Z8

         CANADA

         Phone: +1 604 233 8500

         Email: enechamkin@broadcom.com

         Jean-Francois Mule

         Cable Television Laboratories, Inc.

         858 Coal Creek Circle

         Louisville, CO 80027-9750

         U.S.A.

         Phone: +1 303 661 9100

         Email: jf.mule@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-Chair: Jean-Francois Mule, jf.mule@cablelabs.com

         Co-Chair: Richard Woundy, Richard_Woundy@cable.comcast.com"

    DESCRIPTION

       "This MIB module defines the basic management object

        for the Multimedia Terminal Adapter devices compliant

        with PacketCable and IPCablecom requirements.

        Copyright (C) The IETF Trust (2006).  This version of

        this MIB module is part of RFC 4682; see the RFC itself for

        full legal notices."

    REVISION    "200609180000Z"   -- September 18, 2006

    DESCRIPTION

       "Initial version, published as RFC 4682."

::=  { mib-2 140 }

   -- Textual Conventions

PktcMtaDevProvEncryptAlg  ::= TEXTUAL-CONVENTION

    STATUS      current

    DESCRIPTION

        " This textual convention defines various types of the

          encryption algorithms used for the encryption of the MTA

          configuration file.  The description of the encryption

          algorithm for each enumerated value is as follows:

          'none(0)'            no encryption is used,

          'des64CbcMode(1)'    DES 64-bit key in CBC mode,

          't3Des192CbcMode(2)' 3DES 192-bit key in CBC mode,

          'aes128CbcMode(3)'   AES 128-bit key in CBC mode,

          'aes256CbcMode(4)'   AES 256-bit key in CBC mode."

    SYNTAX      INTEGER  {

                none             (0),

                des64CbcMode     (1),

                t3Des192CbcMode  (2),

                aes128CbcMode    (3),

                aes256CbcMode    (4)

    }

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

-- The MTA MIB module only supports a single Provisioning Server.

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

pktcMtaNotification OBJECT IDENTIFIER ::= { pktcIetfMtaMib 0 }

pktcMtaMibObjects  OBJECT IDENTIFIER ::= { pktcIetfMtaMib 1 }

pktcMtaDevBase     OBJECT IDENTIFIER ::= { pktcMtaMibObjects 1 }

pktcMtaDevServer   OBJECT IDENTIFIER ::= { pktcMtaMibObjects 2 }

pktcMtaDevSecurity OBJECT IDENTIFIER ::= { pktcMtaMibObjects 3 }

pktcMtaDevErrors   OBJECT IDENTIFIER ::= { pktcMtaMibObjects 4 }

pktcMtaConformance  OBJECT IDENTIFIER ::= { pktcIetfMtaMib 2 }

--

-- The following pktcMtaDevBase group describes the base MTA objects

--

pktcMtaDevResetNow  OBJECT-TYPE

    SYNTAX      TruthValue

    MAX-ACCESS  read-write

    STATUS      current

    DESCRIPTION

        " This object controls the MTA software reset.

          Reading this object always returns 'false'.  Setting this

          object to 'true' causes the device to reset immediately

          and the following actions to occur:

             1.  All connections (if present) are flushed locally.

             2.  All current actions such as ringing immediately

                 terminate.

             3.  Requests for signaling notifications, such as

                 notification based on digit map recognition, are

                 flushed.

             4.  All endpoints are disabled.

             5.  The provisioning flow is started at step MTA-1.

          If a value is written into an instance of

          pktcMtaDevResetNow, the agent MUST NOT retain the supplied

          value across MTA re-initializations or reboots."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification."

    ::= { pktcMtaDevBase 1 }

pktcMtaDevSerialNumber OBJECT-TYPE

    SYNTAX      SnmpAdminString

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object specifies the manufacturer's serial

          number of this MTA.  The value of this object MUST be

          identical to the value specified in DHCP option 43,

          sub-option 4.  The list of sub-options for DHCP option

          43 are defined in the PacketCable MTA Device

          Provisioning Specification."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification."

    ::= { pktcMtaDevBase 2 }

pktcMtaDevSwCurrentVers OBJECT-TYPE

    SYNTAX      SnmpAdminString

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object identifies the software version currently

          operating in the MTA.

          The MTA MUST return a string descriptive of the current

          software load.  This object should use the syntax

          defined by the individual vendor to identify the software

          version.  The data presented in this object MUST be

          identical to the software version information contained

          in the 'sysDescr' MIB object of the MTA.  The value of

          this object MUST be identical to the value specified in

          DHCP option 43, sub-option 6.  The list of sub-options for

          DHCP option 43 are defined in the PacketCable MTA Device

          Provisioning Specification."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification."

::= { pktcMtaDevBase 3 }

pktcMtaDevFQDN      OBJECT-TYPE

    SYNTAX      SnmpAdminString

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object contains the Fully Qualified Domain Name for

          this MTA.  The MTA FQDN is used to uniquely identify the

          device to the PacketCable back office elements."

    ::= { pktcMtaDevBase 4 }

pktcMtaDevEndPntCount     OBJECT-TYPE

    SYNTAX      Unsigned32 (1..255)

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object contains the number of physical endpoints for

          this MTA."

    ::= { pktcMtaDevBase 5 }

pktcMtaDevEnabled     OBJECT-TYPE

    SYNTAX      TruthValue

    MAX-ACCESS  read-write

    STATUS      current

    DESCRIPTION

         " This object contains the MTA Admin Status of this device.

           If this object is set to 'true', the MTA is

           administratively enabled, and the MTA MUST be able to

           interact with the PacketCable entities, such as CMS,

           Provisioning Server, KDC, and other MTAs and MGs on all

           PacketCable interfaces.

           If this object is set to 'false', the MTA is

           administratively disabled, and the MTA MUST perform the

           following actions for all endpoints:

               - Shut down all media sessions, if present.

               - Shut down Network Control Signaling (NCS)

               signaling by following the Restart in

               Progress procedures in the PacketCable NCS

               specification.

           The MTA must execute all actions required to

           enable or disable the telephony services for all

           endpoints immediately upon receipt of an SNMP SET

           operation.

           Additionally, the MTA MUST maintain the SNMP Interface

           for management and also the SNMP Key management interface.

           Also, the MTA MUST NOT continue Kerberized key management

           with CMSes until this object is set to 'true'.

           Note: MTAs MUST renew the CMS Kerberos tickets according

           to the PacketCable Security or IPCablecom Specification.

           If a value is written into an instance of

           pktcMtaDevEnabled, the agent MUST NOT retain the supplied

           value across MTA re-initializations or reboots."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification;

          PacketCable Security Specification;

          PacketCable Network-Based Call Signaling Protocol

          Specification."

    ::= { pktcMtaDevBase 6 }

pktcMtaDevTypeIdentifier     OBJECT-TYPE

    SYNTAX      SnmpAdminString

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object provides the MTA device type identifier.  The

          value of this object must be a copy of the DHCP option 60

          value exchanged between the MTA and the DHCP server.  The

          DHCP option 60 value contains an ASCII-encoded string

          identifying capabilities of the MTA as defined in the

          PacketCable MTA Device Provisioning Specification."

    REFERENCE

        " RFC 2132, DHCP Options and BOOTP Vendor Extensions;

          PacketCable MTA Device Provisioning Specification."

    ::= { pktcMtaDevBase 7 }

pktcMtaDevProvisioningState     OBJECT-TYPE

    SYNTAX      INTEGER {

                pass                      (1),

                inProgress                (2),

                failConfigFileError       (3),

                passWithWarnings          (4),

                passWithIncompleteParsing (5),

                failureInternalError      (6),

                failureOtherReason        (7)

    }

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object indicates the completion state of the MTA

          device provisioning process.

          pass:

          If the configuration file could be parsed successfully

          and the MTA is able to reflect the same in its

          MIB, the MTA MUST return the value 'pass'.

          inProgress:

          If the MTA is in the process of being provisioned,

          the MTA MUST return the value 'inProgress'.

          failConfigFileError:

          If the configuration file was in error due to incorrect

          values in the mandatory parameters, the MTA MUST reject

          the configuration file, and the MTA MUST return the value

          'failConfigFileError'.

          passWithWarnings:

          If the configuration file had proper values for all the

          mandatory parameters but has errors in any of the optional

          parameters (this includes any vendor-specific Object

          Identifiers (OIDs) that are incorrect or not known

          to the MTA), the MTA MUST return the value

          'passWithWarnings'.

          passWithIncompleteParsing:

          If the configuration file is valid but the MTA cannot

          reflect the same in its configuration (for example, too

          many entries caused memory exhaustion), it must accept

          the CMS configuration entries related, and the MTA MUST

          return the value 'passWithIncompleteParsing'.

          failureInternalError:

          If the configuration file cannot be parsed due to an

          Internal error, the MTA MUST return the value

          'failureInternalError'.

          failureOtherReason:

          If the MTA cannot accept the configuration file for any

          other reason than the ones stated above, the MTA MUST

          return the value 'failureOtherReason'.

          When a final SNMP INFORM is sent as part of Step 25 of the

          MTA Provisioning process, this parameter is also included

          in the final INFORM message."

       REFERENCE

        " PacketCable MTA Device Provisioning Specification."

    ::= { pktcMtaDevBase 8 }

pktcMtaDevHttpAccess  OBJECT-TYPE

    SYNTAX      TruthValue

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object indicates whether the HTTP protocol is

          supported for the MTA configuration file transfer."

    ::= { pktcMtaDevBase 9 }

pktcMtaDevProvisioningTimer  OBJECT-TYPE

    SYNTAX      Unsigned32 (0..30)

    UNITS       "minutes"

    MAX-ACCESS  read-write

    STATUS      current

    DESCRIPTION

        " This object defines the time interval for the provisioning

          flow to complete.  The MTA MUST finish all provisioning

          operations starting from the moment when an MTA receives

          its DHCP ACK and ending at the moment when the MTA

          downloads its configuration file (e.g., MTA5 to MTA23)

          within the period of time set by this object.

          Failure to comply with this condition constitutes

          a provisioning flow failure.  If the object is set to 0,

          the MTA MUST ignore the provisioning timer condition.

          If a value is written into an instance of

          pktcMtaDevProvisioningTimer, the agent MUST NOT retain the

          supplied value across MTA re-initializations or reboots."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification."

    DEFVAL {10}

    ::=  {pktcMtaDevBase 10}

pktcMtaDevProvisioningCounter  OBJECT-TYPE

      SYNTAX      Counter32

      MAX-ACCESS  read-only

      STATUS      current

      DESCRIPTION

            "This object counts the number of times the

            provisioning cycle has looped through step MTA-1."

      ::= {pktcMtaDevBase 11}

 pktcMtaDevErrorOidsTable  OBJECT-TYPE

    SYNTAX SEQUENCE OF PktcMtaDevErrorOidsEntry

    MAX-ACCESS not-accessible

    STATUS current

    DESCRIPTION

        " This table contains the list of configuration errors or

          warnings the MTA encountered when parsing the

          configuration file it received from the Provisioning

          Server.

          For each error, an entry is created in this table,

          containing the configuration parameters the MTA rejected

          and the associated reason (e.g., wrong or unknown OID,

          inappropriate object values).  If the MTA

          did not report a provisioning state of 'pass(1)' in

          the pktcMtaDevProvisioningState object, this table MUST be

          populated for each error or warning instance.  Even if

          different parameters share the same error type (e.g., all

          realm name configuration parameters are invalid), all

          observed errors or warnings must be reported as

          different instances.  Errors are placed into the table in

          no particular order.  The table MUST be cleared each time

          the MTA reboots."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification."

    ::= {pktcMtaDevBase 12 }

pktcMtaDevErrorOidsEntry  OBJECT-TYPE

    SYNTAX PktcMtaDevErrorOidsEntry

    MAX-ACCESS not-accessible

    STATUS current

    DESCRIPTION

        " This entry contains the necessary information the MTA MUST

          attempt to provide in case of configuration file errors or

          warnings."

    INDEX { pktcMtaDevErrorOidIndex }

             ::= {pktcMtaDevErrorOidsTable 1}

PktcMtaDevErrorOidsEntry ::= SEQUENCE {

    pktcMtaDevErrorOidIndex Unsigned32,

    pktcMtaDevErrorOid      SnmpAdminString,

    pktcMtaDevErrorValue    SnmpAdminString,

    pktcMtaDevErrorReason   SnmpAdminString

    }

pktcMtaDevErrorOidIndex  OBJECT-TYPE

    SYNTAX      Unsigned32 (1..1024)

    MAX-ACCESS  not-accessible

    STATUS      current

    DESCRIPTION

        " This object is the index of the MTA configuration error

          table.  It is an integer value that starts at value '1'

          and is incremented for each encountered configuration

          file error or warning.

          The maximum number of errors or warnings that can be

          recorded in the pktcMtaDevErrorOidsTable is set to 1024 as

          a configuration file is usually validated by operators

          before deployment.  Given the possible number of

          configuration parameter assignments in the MTA

          configuration file, 1024 is perceived as a sufficient

          limit even with future extensions.

          If the number of the errors in the configuration file

          exceeds 1024, all errors beyond the 1024th one MUST

          be ignored and not be reflected in the

          pktcMtaDevErrorOidsTable."

    ::= {pktcMtaDevErrorOidsEntry 1}

pktcMtaDevErrorOid  OBJECT-TYPE

    SYNTAX      SnmpAdminString

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object contains a human readable representation

          (character string) of the OID corresponding to the

          configuration file parameter that caused the particular

          error.

          For example, if the value of the pktcMtaDevEnabled object

          in the configuration file caused an error, then this

          object instance will contain the human-readable string of

          '1.3.6.1.2.1.140.1.1.6.0'.

          If the MTA generated an error because it was not able

          to recognize a particular OID, then this object

          instance would contain an empty value (zero-length

          string).

          For example, if the value of an OID in the configuration

          file was interpreted by the MTA as being 1.2.3.4.5, and if

          the MTA was not able to recognize this OID as a valid one,

          this object instance will contain a zero-length string.

          If the number of errors in the configuration file exceeds

          1024, then for all subsequent errors, the

          pktcMtaDevErrorOid of the table's 1024th entry MUST

          contain a human-readable representation of the

          pktcMtaDevErrorsTooManyErrors object; i.e., the string

          '1.3.6.1.2.1.140.1.1.4.1.0'.

          Note that the syntax of this object is SnmpAdminString

          instead of OBJECT IDENTIFIER because the object value may

          not be a valid OID due to human or configuration tool

          encoding errors."

    ::= {pktcMtaDevErrorOidsEntry 2}

pktcMtaDevErrorValue  OBJECT-TYPE

    SYNTAX      SnmpAdminString

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object contains the value of the OID corresponding to

          the configuration file parameter that caused the error.

          If the MTA cannot recognize the OID of the

          configuration parameter causing the error, then this

          object instance contains the OID itself as interpreted

          by the MTA in human-readable representation.

          If the MTA can recognize the OID but generate an error due

          to a wrong value of the parameter, then the object

          instance contains the erroneous value of the parameter as

          read from the configuration file.

          In both cases, the value of this object must be

          represented in human-readable form as a character string.

          For example, if the value of the pktcMtaDevEnabled object

          in the configuration file was 3 (invalid value), then the

          pktcMtaDevErrorValue object instance will contain the

          human-readable (string) representation of value '3'.

          Similarly, if the OID in the configuration file has been

          interpreted by the MTA as being 1.2.3.4.5 and the MTA

          cannot recognize this OID as a valid one, then this

          pktcMtaDevErrorValue object instance will contain human

          readable (string) representation of value '1.2.3.4.5'.

          If the number of errors in the configuration file exceeds

          1024, then for all subsequent errors, the

          pktcMtaDevErrorValue of the table's 1024th entry MUST

          contain a human-readable representation of the

          pktcMtaDevErrorsTooManyErrors object; i.e., the string

          '1.3.6.1.2.1.140.1.1.4.1.0'."

    ::= {pktcMtaDevErrorOidsEntry 3}

pktcMtaDevErrorReason  OBJECT-TYPE

    SYNTAX      SnmpAdminString

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object indicates the reason for the error or warning,

          as per the MTA's interpretation, in human-readable form.

          For example:

          'VALUE NOT IN RANGE', 'VALUE DOES NOT MATCH TYPE',

          'UNSUPPORTED VALUE', 'LAST 4 BITS MUST BE SET TO ZERO',

          'OUT OF MEMORY - CANNOT STORE'.

          This object may also contain vendor specific errors for

          private vendor OIDs and any proprietary error codes or

          messages that can help diagnose configuration errors.

          If the number of errors in the configuration file exceeds

          1024, then for all subsequent errors, the

          pktcMtaDevErrorReason of the table's 1024th entry MUST

          contain a human-readable string indicating the reason

          for an error; for example,

          'Too many errors in the configuration file'."

    ::= {pktcMtaDevErrorOidsEntry 4}

--

-- The following group describes server access and parameters used

-- for the initial MTA provisioning and bootstrapping phases.

--

pktcMtaDevDhcpServerAddressType  OBJECT-TYPE

    SYNTAX      InetAddressType

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object contains the Internet address type for the

          PacketCable DHCP servers specified in MTA MIB."

    DEFVAL { ipv4 }

    ::= { pktcMtaDevServer 1}

pktcMtaDevServerDhcp1   OBJECT-TYPE

    SYNTAX      InetAddress

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object contains the Internet Address of the primary

          DHCP server the MTA uses during provisioning.

          The type of this address is determined by the value of

          the pktcMtaDevDhcpServerAddressType object.

          When the latter has the value 'ipv4(1)', this object

          contains the IP address of the primary DHCP

          server.  It is provided by the CM to the MTA via the DHCP

          option code 122, sub-option 1, as defined in RFC 3495.

          The behavior of this object when the value of

          pktcMtaDevDhcpServerAddressType is other than 'ipv4(1)'

          is not presently specified, but it may be specified

          in future versions of this MIB module.

          If this object is of value

          0.0.0.0, the MTA MUST stop all provisioning

          attempts, as well as all other activities.

          If this object is of value 255.255.255.255, it means

          that there was no preference given for the primary

          DHCP server, and, the MTA must follow the logic of

          RFC2131, and the value of DHCP option 122,

          sub-option 2, must be ignored."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification;

          RFC 2131, Dynamic Host Configuration Protocol;

          RFC 3495, DHCP Option for CableLabs Client Configuration."

    ::= { pktcMtaDevServer 2 }

pktcMtaDevServerDhcp2  OBJECT-TYPE

    SYNTAX      InetAddress

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object contains the Internet Address of the secondary

          DHCP server the MTA uses during provisioning.

          The type of this address is determined by the value of

          the pktcMtaDevDhcpServerAddressType object.

          When the latter has the value 'ipv4(1)', this object

          contains the IP address of the secondary DHCP

          server.  It is provided by the CM to the MTA via the DHCP

          option code 122, sub-option 2, as defined in RFC 3495.

          The behavior of this object when the value of

          pktcMtaDevDhcpServerAddressType is other than 'ipv4(1)'

          is not presently specified, but it may be specified

          in future versions of this MIB module.

          If there was no secondary DHCP server provided in DHCP

          Option 122, sub-option 2, this object must return the value

          0.0.0.0."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification;

          RFC 3495, DHCP Option for CableLabs Client Configuration."

          ::= { pktcMtaDevServer 3 }

pktcMtaDevDnsServerAddressType  OBJECT-TYPE

    SYNTAX      InetAddressType

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object contains the Internet address type for the

          PacketCable DNS servers specified in MTA MIB."

    DEFVAL { ipv4 }

    ::= { pktcMtaDevServer 4}

pktcMtaDevServerDns1  OBJECT-TYPE

    SYNTAX      InetAddress

    MAX-ACCESS  read-write

    STATUS      current

    DESCRIPTION

        " This object contains the IP Address of the primary

          DNS server to be used by the MTA.  The type of this address

          is determined by the value of the

          pktcMtaDevDnsServerAddressType object.

          When the latter has the value 'ipv4(1)', this object

          contains the IP address of the primary DNS server.

          As defined in RFC 2132, PacketCable-compliant MTAs receive

          the IP addresses of the DNS Servers in DHCP option 6.

          The behavior of this object when the value of

          pktcMtaDevDnsServerAddressType is other than 'ipv4(1)'

          is not presently specified, but it may be specified

          in future versions of this MIB module.

          If a value is written into an instance of

          pktcMtaDevServerDns1, the agent MUST NOT retain the

          supplied value across MTA re-initializations or reboots."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification;

          RFC 2132, DHCP Options and BOOTP Vendor Extensions."

    ::= { pktcMtaDevServer 5 }

pktcMtaDevServerDns2  OBJECT-TYPE

    SYNTAX      InetAddress

    MAX-ACCESS  read-write

    STATUS      current

    DESCRIPTION

        " This object contains the IP Address of the secondary

          DNS server to be used by the MTA.  The type of this address

          is determined by the value of the

          pktcMtaDevDnsServerAddressType object.

          When the latter has the value 'ipv4(1)', this object

          contains the IP address of the secondary DNS

          server.  As defined in RFC 2132, PacketCable-compliant MTAs

          receive the IP addresses of the DNS Servers in DHCP

          option 6.

          The behavior of this object when the value of

          pktcMtaDevDnsServerAddressType is other than 'ipv4(1)'

          is not presently specified, but it may be specified

          in future versions of this MIB module.

          If a value is written into an instance of

          pktcMtaDevServerDns2, the agent MUST NOT retain the

          supplied value across MTA re-initializations or reboots."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification;

          RFC 2132, DHCP Options and BOOTP Vendor Extensions."

    ::= { pktcMtaDevServer 6 }

pktcMtaDevTimeServerAddressType  OBJECT-TYPE

    SYNTAX      InetAddressType

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object contains the Internet address type for the

          PacketCable Time servers specified in MTA MIB."

    DEFVAL { ipv4 }

    ::= { pktcMtaDevServer 7}

pktcMtaDevTimeServer   OBJECT-TYPE

    SYNTAX      InetAddress

    MAX-ACCESS  read-write

    STATUS      current

    DESCRIPTION

        " This object contains the Internet Address of the Time

          Server used by an S-MTA for Time Synchronization.  The type

          of this address is determined by the value of the

          pktcMtaDevTimeServerAddressType object.

          When the latter has the value 'ipv4(1)', this object

          contains the IP address of the Time Server used for Time

          Synchronization.

          In the case of an S-MTA, this object must be

          populated with a value other than 0.0.0.0 as obtained

          from DHCP option 4.  The protocol by which the time of day

          MUST be retrieved is defined in RFC 868.

          In the case of an E-MTA, this object must contain a

          value of 0.0.0.0 if the address type is 'ipv4(1)' since

          an E-MTA does not use the Time Protocol for time

          synchronization (an E-MTA uses the time retrieved by the

          DOCSIS cable modem).

          The behavior of this object when the value of

          pktcMtaDevTimeServerAddressType is other than 'ipv4(1)'

          is not presently specified, but it may be specified in

          future versions of this MIB module.

          If a value is written into an instance of

          pktcMtaDevTimeServer, the agent MUST NOT retain the

          supplied value across MTA re-initializations or reboots."

    REFERENCE

        " RFC 868, Time Protocol;

          RFC 2131, Dynamic Host Configuration Protocol;

          RFC 2132, DHCP Options and BOOTP Vendor Extensions."

    ::= { pktcMtaDevServer 8}

pktcMtaDevConfigFile  OBJECT-TYPE

    SYNTAX      SnmpAdminString

    MAX-ACCESS  read-write

    STATUS      current

    DESCRIPTION

        " This object specifies the MTA device configuration file

          information, including the access method, the server name,

          and the configuration file name.  The value of this object

          is the Uniform Resource Locator (URL) of the configuration

          file for TFTP or HTTP download.

          If this object value is a TFTP URL, it must be formatted

          as defined in RFC 3617.

          If this object value is an HTTP URL, it must be formatted

          as defined in RFC 2616.

          If the MTA SNMP Enrollment mechanism is used, then the MTA

          must download the file provided by the Provisioning Server

          during provisioning via an SNMP SET on this object.

          If the MTA SNMP Enrollment mechanism is not used, this

          object MUST contain the URL value corresponding to the

          'siaddr' and 'file' fields received in the DHCP ACK to

          locate the configuration file: the 'siaddr' and 'file'

          fields represent the host and file of the TFTP URL,

          respectively.  In this case, the MTA MUST return an

          'inconsistentValue' error in response to SNMP SET

          operations.

          The MTA MUST return a zero-length string if the server

          address (host part of the URL) is unknown.

          If a value is written into an instance of

          pktcMtaDevConfigFile, the agent MUST NOT retain the

          supplied value across MTA re-initializations or reboots."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification;

          RFC 3617, URI Scheme for TFTP; RFC 2616, HTTP 1.1"

    ::= { pktcMtaDevServer 9 }

pktcMtaDevSnmpEntity  OBJECT-TYPE

    SYNTAX      SnmpAdminString

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        " This object contains the FQDN of the SNMP entity of the

          Provisioning Server.  When the MTA SNMP Enrollment

          Mechanism is used, this object represents the server that

          the MTA communicates with, that it receives the

          configuration file URL from, and that it sends the

          enrollment notification to.  The SNMP entity is also the

          destination entity for all the provisioning

          notifications.  It may be used for post-provisioning

          SNMP operations.  During the provisioning phase, this

          SNMP entity FQDN is supplied to the MTA via DHCP option

          122, sub-option 3, as defined in RFC 3495.  The MTA must

          resolve the FQDN value before its very first network

          interaction with the SNMP entity during the provisioning

          phase."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification;

          RFC 3495, DHCP Option for CableLabs Client Configuration."

    ::= { pktcMtaDevServer 10 }

pktcMtaDevProvConfigHash  OBJECT-TYPE

    SYNTAX      OCTET STRING (SIZE(20))

    MAX-ACCESS  read-write

    STATUS      current

    DESCRIPTION

        " This object contains the hash value of the contents of the

          configuration file.

          The authentication algorithm is Secure Hashing Algorithm

          1 (SHA-1), and the length is 160 bits.  The hash

          calculation MUST follow the requirements defined in the

          PacketCable Security Specification.  When the MTA SNMP

          Enrollment mechanism is used, this hash value is

          calculated and sent to the MTA prior to sending the

          config file.  This object value is then provided by the

          Provisioning server via an SNMP SET operation.

          When the MTA SNMP Enrollment mechanism is not in use, the

          hash value is provided in the configuration file itself,

          and it is also calculated by the MTA.  This object value

          MUST represent the hash value calculated by the MTA.

          When the MTA SNMP Enrollment mechanism is not in use, the

          MTA must reject all SNMP SET operations on this object and

          return an 'inconsistentValue' error.

          If a value is written into an instance of

          pktcMtaDevProvConfigHash, the agent MUST NOT retain the

          supplied value across MTA re-initializations or reboots."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification;

          PacketCable Security Specification."

    ::= { pktcMtaDevServer 11 }

pktcMtaDevProvConfigKey  OBJECT-TYPE

    SYNTAX      OCTET STRING (SIZE(32))

    MAX-ACCESS  read-write

    STATUS      current

    DESCRIPTION

        " This object contains the key used to encrypt/decrypt

          the configuration file when secure SNMPv3 provisioning

          is used.

          The value of this object is provided along with the

          configuration file information (pktcMtaDevConfigFile)

          and hash (pktcMtaDevProvConfigHash) by the Provisioning

          Server via SNMP SET once the configuration file has been

          created, as defined by the PacketCable Security

          specification.

          The privacy algorithm is defined by the

          pktcMtaDevProvConfigEncryptAlg MIB object.  The

          MTA requirements related to the privacy algorithm are

          defined in the PacketCable Security Specification.

          If this object is set at any other provisioning step than

          that allowed by the PacketCable MTA Device

          Provisioning Specification, the MTA SHOULD return

          an 'inconsistentValue' error.

          This object must not be used in non secure provisioning

          mode.  In non-secure provisioning modes, the MTA SHOULD

          return an 'inconsistentValue' in response to SNMP SET

          operations, and the MTA SHOULD return a zero-length

          string in response to SNMP GET operations.

          If a value is written into an instance of

          pktcMtaDevProvConfigKey, the agent MUST NOT retain the

          supplied value across MTA re-initializations or reboots."

    REFERENCE

        " PacketCable MTA Device Provisioning Specification;

          PacketCable Security Specification."

    ::= { pktcMtaDevServer 12 }

pktcMtaDevProvConfigEncryptAlg   OBJECT-TYPE

    SYNTAX      PktcMtaDevProvEncryptAlg

    MAX-ACCESS  read-write