home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / rfc / rfc1473 < prev    next >
Text File  |  1993-06-04  |  20KB  |  562 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                      F. Kastenholz
  8. Request for Comments: 1473                            FTP Software, Inc.
  9.                                                                June 1993
  10.  
  11.  
  12.                  The Definitions of Managed Objects for
  13.                    the IP Network Control Protocol of
  14.                       the Point-to-Point Protocol
  15.  
  16. Status of this Memo
  17.  
  18.    This RFC specifies an IAB standards track protocol for the Internet
  19.    community, and requests discussion and suggestions for improvements.
  20.    Please refer to the current edition of the "IAB Official Protocol
  21.    Standards" for the standardization state and status of this protocol.
  22.    Distribution of this memo is unlimited.
  23.  
  24. Abstract
  25.  
  26.    This memo defines a portion of the Management Information Base (MIB)
  27.    for use with network management protocols in TCP/IP-based internets.
  28.    In particular, it describes managed objects used for managing the IP
  29.    Network Control Protocol on subnetwork interfaces using the family of
  30.    Point-to-Point Protocols [8, 9, 10, 11, & 12].
  31.  
  32. Table of Contents
  33.  
  34.    1. The Network Management Framework ......................    1
  35.    2. Objects ...............................................    2
  36.    2.1 Format of Definitions ................................    2
  37.    3. Overview ..............................................    2
  38.    3.1 Object Selection Criteria ............................    2
  39.    3.2 Structure of the PPP .................................    2
  40.    3.3 MIB Groups ...........................................    3
  41.    4. Definitions ...........................................    4
  42.    5. Acknowledgements ......................................    8
  43.    6. Security Considerations ...............................    8
  44.    7. References ............................................    8
  45.    8. Author's Address ......................................    9
  46.  
  47. 1.  The Network Management Framework
  48.  
  49.    The Internet-standard Network Management Framework consists of three
  50.    components.  They are:
  51.  
  52.       STD 16/RFC 1155 which defines the SMI, the mechanisms used for
  53.       describing and naming objects for the purpose of management.  STD
  54.       16/RFC 1212 defines a more concise description mechanism, which is
  55.       wholly consistent with the SMI.
  56.  
  57.       STD 17/RFC 1213 which defines MIB-II, the core set of managed
  58.       objects for the Internet suite of protocols.
  59.  
  60.  
  61.  
  62.  
  63.  
  64. Kastenholz                                                      [Page 1]
  65.  
  66. RFC 1473                       PPP/IP MIB                      June 1993
  67.  
  68.  
  69.       STD 15/RFC 1157 which defines the SNMP, the protocol used for
  70.       network access to managed objects.
  71.  
  72.    The Framework permits new objects to be defined for the purpose of
  73.    experimentation and evaluation.
  74.  
  75. 2.  Objects
  76.  
  77.    Managed objects are accessed via a virtual information store, termed
  78.    the Management Information Base or MIB.  Objects in the MIB are
  79.    defined using the subset of Abstract Syntax Notation One (ASN.1) [3]
  80.    defined in the SMI.  In particular, each object type is named by an
  81.    OBJECT IDENTIFIER, an administratively assigned name.  The object
  82.    type together with an object instance serves to uniquely identify a
  83.    specific instantiation of the object.  For human convenience, we
  84.    often use a textual string, termed the descriptor, to refer to the
  85.    object type.
  86.  
  87. 2.1.  Format of Definitions
  88.  
  89.    Section 4 contains the specification of all object types contained in
  90.    this MIB module.  The object types are defined using the conventions
  91.    defined in the SMI, as amended by the extensions specified in [5,6].
  92.  
  93. 3.  Overview
  94.  
  95. 3.1.  Object Selection Criteria
  96.  
  97.    To be consistent with IAB directives and good engineering practice,
  98.    an explicit attempt was made to keep this MIB as simple as possible.
  99.    This was accomplished by applying the following criteria to objects
  100.    proposed for inclusion:
  101.  
  102.       (1)  Require objects be essential for either fault or
  103.            configuration management.  In particular, objects for
  104.            which the sole purpose was to debug implementations were
  105.            explicitly excluded from the MIB.
  106.  
  107.       (2)  Consider evidence of current use and/or utility.
  108.  
  109.       (3)  Limit the total number of objects.
  110.  
  111.       (4)  Exclude objects which are simply derivable from others in
  112.            this or other MIBs.
  113.  
  114. 3.2.  Structure of the PPP
  115.  
  116.    This section describes the basic model of PPP used in developing the
  117.    PPP MIB. This information should be useful to the implementor in
  118.    understanding some of the basic design decisions of the MIB.
  119.  
  120.    The PPP is not one single protocol but a large family of protocols.
  121.    Each of these is, in itself, a fairly complex protocol.  The PPP
  122.    protocols may be divided into three rough categories:
  123.  
  124.  
  125.  
  126. Kastenholz                                                      [Page 2]
  127.  
  128. RFC 1473                       PPP/IP MIB                      June 1993
  129.  
  130.  
  131.    Control Protocols
  132.       The Control Protocols are used to control the operation of the
  133.       PPP. The Control Protocols include the Link Control Protocol
  134.       (LCP), the Password Authentication Protocol (PAP), the Link
  135.       Quality Report (LQR), and the Challenge Handshake Authentication
  136.       Protocol (CHAP).
  137.  
  138.    Network Protocols
  139.       The Network Protocols are used to move the network traffic over
  140.       the PPP interface.  A Network Protocol encapsulates the datagrams
  141.       of a specific higher-layer protocol that is using the PPP as a
  142.       data link.  Note that within the context of PPP, the term "Network
  143.       Protocol" does not imply an OSI Layer-3 protocol; for instance,
  144.       there is a Bridging network protocol.
  145.  
  146.    Network Control Protocols (NCPs)
  147.       The NCPs are used to control the operation of the Network
  148.       Protocols. Generally, each Network Protocol has its own Network
  149.       Control Protocol; thus, the IP Network Protocol has its IP Control
  150.       Protocol, the Bridging Network Protocol has its Bridging Network
  151.       Control Protocol and so on.
  152.  
  153.    This document specifies the objects used in managing one of these
  154.    protocols, namely the IP Network Control Protocol.
  155.  
  156. 3.3.  MIB Groups
  157.  
  158.    Objects in this MIB are arranged into several MIB groups.  Each group
  159.    is organized as a set of related objects.
  160.  
  161.    These groups are the basic unit of conformance: if the semantics of a
  162.    group are applicable to an implementation then all objects in the
  163.    group must be implemented.
  164.  
  165.    The PPP MIB is organized into several MIB Groups, including, but not
  166.    limited to, the following groups:
  167.  
  168.           o The PPP Link Group
  169.           o The PPP LQR Group
  170.           o The PPP LQR Extensions Group
  171.           o The PPP IP Group
  172.           o The PPP Bridge Group
  173.           o The PPP Security Group
  174.  
  175.    This document specifies the following group:
  176.  
  177.    The PPP IP Group
  178.       The PPP IP Group contains configuration, status, and control
  179.       variables that apply to the operation of IP over PPP.
  180.  
  181.       Implementation of this group is mandatory for all implementations
  182.       of PPP that support IP over PPP.
  183.  
  184.  
  185.  
  186.  
  187.  
  188. Kastenholz                                                      [Page 3]
  189.  
  190. RFC 1473                       PPP/IP MIB                      June 1993
  191.  
  192.  
  193. 4.  Definitions
  194.  
  195.           PPP-IP-NCP-MIB DEFINITIONS ::= BEGIN
  196.  
  197.           IMPORTS
  198.                Counter
  199.                     FROM RFC1155-SMI
  200.                ifIndex
  201.                     FROM RFC1213-MIB
  202.                OBJECT-TYPE
  203.                     FROM RFC-1212
  204.                ppp
  205.                     FROM PPP-LCP-MIB;
  206.  
  207.                -- The PPP IP Group.
  208.                -- Implementation of this group is mandatory for all
  209.                -- PPP implementations that support operating IP over PPP.
  210.  
  211.                pppIp OBJECT IDENTIFIER ::= { ppp 3 }
  212.  
  213.  
  214.           pppIpTable   OBJECT-TYPE
  215.                SYNTAX    SEQUENCE OF PppIpEntry
  216.                ACCESS    not-accessible
  217.                STATUS    mandatory
  218.                DESCRIPTION
  219.                          "Table containing the IP parameters and
  220.                          statistics for the local PPP entity."
  221.                ::= { pppIp 1 }
  222.  
  223.  
  224.           pppIpEntry   OBJECT-TYPE
  225.                SYNTAX    PppIpEntry
  226.                ACCESS    not-accessible
  227.                STATUS    mandatory
  228.                DESCRIPTION
  229.                          "IPCP status information for a particular PPP
  230.                          link."
  231.                INDEX     { ifIndex }
  232.                ::= { pppIpTable 1 }
  233.  
  234.  
  235.           PppIpEntry ::= SEQUENCE {
  236.                pppIpOperStatus
  237.                     INTEGER,
  238.                pppIpLocalToRemoteCompressionProtocol
  239.                     INTEGER,
  240.                pppIpRemoteToLocalCompressionProtocol
  241.                     INTEGER,
  242.                pppIpRemoteMaxSlotId
  243.                     INTEGER,
  244.                pppIpLocalMaxSlotId
  245.                     INTEGER
  246.           }
  247.  
  248.  
  249.  
  250. Kastenholz                                                      [Page 4]
  251.  
  252. RFC 1473                       PPP/IP MIB                      June 1993
  253.  
  254.  
  255.           -- The following object reflect the values of the option
  256.           -- parameters used in the PPP IP Control Protocol
  257.           --   pppIpLocalToRemoteCompressionProtocol
  258.           --   pppIpRemoteToLocalCompressionProtocol
  259.           --   pppIpRemoteMaxSlotId
  260.           --   pppIpLocalMaxSlotId
  261.           -- These values are not available until after the PPP Option
  262.           -- negotiation has completed, which is indicated by the link
  263.           -- reaching the open state (i.e., pppIpOperStatus is set to
  264.           -- opened).
  265.           --
  266.           -- Therefore, when pppIpOperStatus is not opened
  267.           -- the contents of these objects is undefined. The value
  268.           -- returned when accessing the objects is an implementation
  269.           -- dependent issue.
  270.  
  271.  
  272.           pppIpOperStatus   OBJECT-TYPE
  273.                SYNTAX    INTEGER {opened(1), not-opened(2)}
  274.                ACCESS    read-only
  275.                STATUS    mandatory
  276.                DESCRIPTION
  277.                          "The operational status of the IP network
  278.                          protocol. If the value of this object is up
  279.                          then the finite state machine for the IP
  280.                          network protocol has reached the Opened state."
  281.                ::= { pppIpEntry 1 }
  282.  
  283.  
  284.           pppIpLocalToRemoteCompressionProtocol   OBJECT-TYPE
  285.                SYNTAX    INTEGER {
  286.                          none(1),
  287.                          vj-tcp(2)
  288.                     }
  289.                ACCESS    read-only
  290.                STATUS    mandatory
  291.                DESCRIPTION
  292.                          "The IP compression protocol that the local
  293.                          PPP-IP entity uses when sending packets to the
  294.                          remote PPP-IP entity. The value of this object
  295.                          is meaningful only when the link has reached
  296.                          the open state (pppIpOperStatus is opened)."
  297.                ::= { pppIpEntry 2 }
  298.  
  299.  
  300.           pppIpRemoteToLocalCompressionProtocol   OBJECT-TYPE
  301.                SYNTAX    INTEGER {
  302.                          none(1),
  303.                          vj-tcp(2)
  304.                     }
  305.                ACCESS    read-only
  306.                STATUS    mandatory
  307.                DESCRIPTION
  308.                          "The IP compression protocol that the remote
  309.  
  310.  
  311.  
  312. Kastenholz                                                      [Page 5]
  313.  
  314. RFC 1473                       PPP/IP MIB                      June 1993
  315.  
  316.  
  317.                          PPP-IP entity uses when sending packets to the
  318.                          local PPP-IP entity. The value of this object
  319.                          is meaningful only when the link has reached
  320.                          the open state (pppIpOperStatus is opened)."
  321.                ::= { pppIpEntry 3 }
  322.  
  323.  
  324.           pppIpRemoteMaxSlotId   OBJECT-TYPE
  325.                SYNTAX    INTEGER(0..255)
  326.                ACCESS    read-only
  327.                STATUS    mandatory
  328.                DESCRIPTION
  329.                          "The Max-Slot-Id parameter that the remote node
  330.                          has advertised and that is in use on the link.
  331.                          If vj-tcp header compression is not in use on
  332.                          the link then the value of this object shall be
  333.                          0. The value of this object is meaningful only
  334.                          when the link has reached the open state
  335.                          (pppIpOperStatus is opened)."
  336.                ::= { pppIpEntry 4 }
  337.  
  338.  
  339.           pppIpLocalMaxSlotId   OBJECT-TYPE
  340.                SYNTAX    INTEGER(0..255)
  341.                ACCESS    read-only
  342.                STATUS    mandatory
  343.                DESCRIPTION
  344.                          "The Max-Slot-Id parameter that the local node
  345.                          has advertised and that is in use on the link.
  346.                          If vj-tcp header compression is not in use on
  347.                          the link then the value of this object shall be
  348.                          0. The value of this object is meaningful only
  349.                          when the link has reached the open state
  350.                          (pppIpOperStatus is opened)."
  351.                ::= { pppIpEntry 5 }
  352.  
  353.  
  354.           --
  355.           -- The PPP IP Configuration table.
  356.           -- This is a separate table in order to facilitate
  357.           -- placing these variables in a separate MIB view.
  358.           --
  359.  
  360.           pppIpConfigTable   OBJECT-TYPE
  361.                SYNTAX    SEQUENCE OF PppIpConfigEntry
  362.                ACCESS    not-accessible
  363.                STATUS    mandatory
  364.                DESCRIPTION
  365.                          "Table containing configuration variables for
  366.                          the IPCP for the local PPP entity."
  367.                ::= { pppIp 2 }
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374. Kastenholz                                                      [Page 6]
  375.  
  376. RFC 1473                       PPP/IP MIB                      June 1993
  377.  
  378.  
  379.           pppIpConfigEntry   OBJECT-TYPE
  380.                SYNTAX    PppIpConfigEntry
  381.                ACCESS    not-accessible
  382.                STATUS    mandatory
  383.                DESCRIPTION
  384.                          "IPCP information for a particular PPP link."
  385.                INDEX     { ifIndex }
  386.                ::= { pppIpConfigTable 1 }
  387.  
  388.  
  389.           PppIpConfigEntry ::= SEQUENCE {
  390.                pppIpConfigAdminStatus
  391.                     INTEGER,
  392.                pppIpConfigCompression
  393.                     INTEGER
  394.           }
  395.  
  396.           pppIpConfigAdminStatus   OBJECT-TYPE
  397.                SYNTAX    INTEGER {open(1), close(2)}
  398.                ACCESS    read-write
  399.                STATUS    mandatory
  400.                DESCRIPTION
  401.                          "The immediate desired status of the IP network
  402.                          protocol. Setting this object to open will
  403.                          inject an administrative open event into the IP
  404.                          network protocol's finite state machine.
  405.                          Setting this object to close will inject an
  406.                          administrative close event into the IP network
  407.                          protocol's finite state machine."
  408.                ::= { pppIpConfigEntry 1 }
  409.  
  410.  
  411.           pppIpConfigCompression   OBJECT-TYPE
  412.                SYNTAX    INTEGER {
  413.                          none(1),
  414.                          vj-tcp(2)
  415.                     }
  416.                ACCESS    read-write
  417.                STATUS    mandatory
  418.                DESCRIPTION
  419.                          "If none(1) then the local node will not
  420.                          attempt to negotiate any IP Compression option.
  421.                          Otherwise, the local node will attempt to
  422.                          negotiate compression mode indicated by the
  423.                          enumerated value. Changing this object will
  424.                          have effect when the link is next restarted."
  425.                REFERENCE
  426.                          "Section 4.0, Van Jacobson TCP/IP Header
  427.                          Compression of RFC1332."
  428.                DEFVAL    { none }
  429.                ::= { pppIpConfigEntry 2 }
  430.  
  431.  
  432.           END
  433.  
  434.  
  435.  
  436. Kastenholz                                                      [Page 7]
  437.  
  438. RFC 1473                       PPP/IP MIB                      June 1993
  439.  
  440.  
  441. 5.  Acknowledgements
  442.  
  443.    This document was produced by the PPP working group.  In addition to
  444.    the working group, the author wishes to thank the following
  445.    individuals for their comments and contributions:
  446.  
  447.           Bill Simpson -- Daydreamer
  448.           Glenn McGregor -- Merit
  449.           Jesse Walker -- DEC
  450.           Chris Gunner -- DEC
  451.  
  452. 6.  Security Considerations
  453.  
  454.    The PPP MIB affords the network operator the ability to configure and
  455.    control the PPP links of a particular system, including the PPP
  456.    authentication protocols. This represents a security risk.
  457.  
  458.    These risks are addressed in the following manners:
  459.  
  460.       (1)  All variables which represent a significant security risk
  461.            are placed in separate, optional, MIB Groups. As the MIB
  462.            Group is the quantum of implementation within a MIB, the
  463.            implementor of the MIB may elect not to implement these
  464.            groups.
  465.  
  466.       (2)  The implementor may choose to implement the variables
  467.            which present a security risk so that they may not be
  468.            written, i.e., the variables are READ-ONLY. This method
  469.            still presents a security risk, and is not recommended,
  470.            in that the variables, specifically the PPP
  471.            Authentication Protocols' variables, may be easily read.
  472.  
  473.       (3)  Using SNMPv2, the operator can place the variables into
  474.            MIB views which are protected in that the parties which
  475.            have access to those MIB views use authentication and
  476.            privacy protocols, or the operator may elect to make
  477.            these views not accessible to any party.  In order to
  478.            facilitate this placement, all security-related variables
  479.            are placed in separate MIB Tables. This eases the
  480.            identification of the necessary MIB View Subtree.
  481.  
  482. 7.  References
  483.  
  484.    [1] Rose M., and K. McCloghrie, "Structure and Identification of
  485.        Management Information for TCP/IP-based internets", STD 16, RFC
  486.        1155, Performance Systems International, Hughes LAN Systems, May
  487.        1990.
  488.  
  489.    [2] McCloghrie K., and M. Rose, Editors, "Management Information Base
  490.        for Network Management of TCP/IP-based internets", STD 17, RFC
  491.        1213, Performance Systems International, March 1991.
  492.  
  493.    [3] Information processing systems - Open Systems Interconnection -
  494.        Specification of Abstract Syntax Notation One (ASN.1),
  495.  
  496.  
  497.  
  498. Kastenholz                                                      [Page 8]
  499.  
  500. RFC 1473                       PPP/IP MIB                      June 1993
  501.  
  502.  
  503.        International Organization for Standardization, International
  504.        Standard 8824, December 1987.
  505.  
  506.    [4] Information processing systems - Open Systems Interconnection -
  507.        Specification of Basic Encoding Rules for Abstract Notation One
  508.        (ASN.1), International Organization for Standardization,
  509.        International Standard 8825, December 1987.
  510.  
  511.    [5] Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  512.        STD 16, RFC 1212, Performance Systems International, Hughes LAN
  513.        Systems, March 1991.
  514.  
  515.    [6] Rose, M., Editor, "A Convention for Defining Traps for use with
  516.        the SNMP", RFC 1215, Performance Systems International, March
  517.        1991.
  518.  
  519.    [7] McCloghrie, K., "Extensions to the Generic-Interface MIB", RFC
  520.        1229, Hughes LAN Systems, Inc., May 1991.
  521.  
  522.    [8] Simpson, W., "The Point-to-Point Protocol for the Transmission of
  523.        Multi-protocol Datagrams over Point-to-Point Links, RFC 1331,
  524.        Daydreamer, May 1992.
  525.  
  526.    [9] McGregor, G., "The PPP Internet Protocol Control Protocol", RFC
  527.        1332, Merit, May 1992.
  528.  
  529.   [10] Baker, F., "Point-to-Point Protocol Extensions for Bridging", RFC
  530.        1220, ACC, April 1991.
  531.  
  532.   [11] Lloyd, B., and W. Simpson, "PPP Authentication Protocols", RFC
  533.        1334, L&A, Daydreamer, October 1992.
  534.  
  535.   [12] Simpson, W., "PPP Link Quality Monitoring", RFC 1333, Daydreamer,
  536.        May 1992.
  537.  
  538. 8.  Author's Address
  539.  
  540.    Frank Kastenholz
  541.    FTP Software, Inc.
  542.    2 High Street
  543.    North Andover, Mass 01845 USA
  544.  
  545.    Phone: (508) 685-4000
  546.    EMail: kasten@ftp.com
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560. Kastenholz                                                      [Page 9]
  561.  
  562.