home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / rfc / rfc2213 < prev    next >
Text File  |  1997-10-01  |  36KB  |  1,180 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                        F. Baker
  8. Request for Comments: 2213                              Cisco Systems
  9. Category: Standards Track                                 J. Krawczyk
  10.                                             ArrowPoint Communications
  11.                                                             A. Sastry
  12.                                                        Cisco Systems
  13.                                                       September 1997
  14.  
  15.  
  16.  
  17.       Integrated Services Management Information Base using SMIv2
  18.  
  19.  
  20. Status of this Memo
  21.  
  22.    This document specifies an Internet standards track protocol for the
  23.    Internet community, and requests discussion and suggestions for
  24.    improvements.  Please refer to the current edition of the "Internet
  25.    Official Protocol Standards" (STD 1) for the standardization state
  26.    and status of this protocol.  Distribution of this memo is unlimited.
  27.  
  28. Abstract
  29.  
  30.    This memo defines a portion of the Management Information Base (MIB)
  31.    for use with network management protocols in TCP/IP-based internets.
  32.    In particular, it defines objects for managing the the interface
  33.    attributes defined in the Integrated Services Model.  Comments should
  34.    be made to the Integrated Services Working Group, int-serv@isi.edu.
  35.  
  36. Table of Contents
  37.  
  38. 1 The SNMPv2 Network Management Framework ...............    2
  39. 1.1 Object Definitions ..................................    2
  40. 2 Overview ..............................................    2
  41. 2.1 Textual Conventions .................................    2
  42. 2.2 Structure of MIB ....................................    3
  43. 3 Definitions ...........................................    3
  44. 3.2 Interface Attributes Database .......................    6
  45. 3.3 Integrated Services Interface Flows Database ........    8
  46. 4 Security Considerations ...............................   19
  47. 5 Authors' Addresses ....................................   20
  48. 6 Acknowledgements ......................................   20
  49. 7 References ............................................   20
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Baker, et. al.              Standards Track                     [Page 1]
  59.  
  60. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  61.  
  62.  
  63. 1.  The SNMPv2 Network Management Framework
  64.  
  65.    The SNMPv2 Network Management Framework consists of four major
  66.    components.  They are:
  67.  
  68.    o    RFC 1441 which defines the SMI, the mechanisms used for
  69.         describing and naming objects for the purpose of
  70.         management.
  71.  
  72.    o    STD 17, RFC 1213 defines MIB-II, the core set of managed
  73.         objects for the Internet suite of protocols.
  74.  
  75.    o    RFC 1445 which defines the administrative and other
  76.         architectural aspects of the framework.
  77.  
  78.    o    RFC 1448 which defines the protocol used for network
  79.         access to managed objects.
  80.  
  81.    The Framework permits new objects to be defined for the purpose of
  82.    experimentation and evaluation.
  83.  
  84. 1.1.  Object Definitions
  85.  
  86.    Managed objects are accessed via a virtual information store, termed
  87.    the Management Information Base or MIB.  Objects in the MIB are
  88.    defined using the subset of Abstract Syntax Notation One (ASN.1)
  89.    defined in the SMI.  In particular, each object type is named by an
  90.    OBJECT IDENTIFIER, an administratively assigned name.  The object
  91.    type together with an object instance serves to uniquely identify a
  92.    specific instantiation of the object.  For human convenience, we
  93.    often use a textual string, termed the descriptor, to refer to the
  94.    object type.
  95.  
  96. 2.  Overview
  97.  
  98. 2.1.  Textual Conventions
  99.  
  100.    Several new data types are introduced as a textual convention in this
  101.    MIB document.  These textual conventions enhance the readability of
  102.    the specification and can ease comparison with other specifications
  103.    if appropriate.  It should be noted that the introduction of the
  104.    these textual conventions has no effect on either the syntax nor the
  105.    semantics of any managed objects.  The use of these is merely an
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Baker, et. al.              Standards Track                     [Page 2]
  115.  
  116. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  117.  
  118.  
  119.    artifact of the explanatory method used.  Objects defined in terms of
  120.    one of these methods are always encoded by means of the rules that
  121.    define the primitive type.  Hence, no changes to the SMI or the SNMP
  122.    are necessary to accommodate these textual conventions which are
  123.    adopted merely for the convenience of readers and writers in pursuit
  124.    of the elusive goal of clear, concise, and unambiguous MIB documents.
  125.  
  126. 2.2.  Structure of MIB
  127.  
  128.    The MIB is composed of the following sections:
  129.         Integrated Services
  130.              Interface Attributes Table
  131.              Interface Flow Table
  132.  
  133. 3.  Definitions
  134.  
  135. INTEGRATED-SERVICES-MIB DEFINITIONS ::= BEGIN
  136.  
  137.     IMPORTS
  138.             MODULE-IDENTITY, OBJECT-TYPE, Counter32,
  139.             Gauge32, Integer32, mib-2                FROM SNMPv2-SMI
  140.             TimeInterval, TEXTUAL-CONVENTION, RowStatus,
  141.             TruthValue                               FROM SNMPv2-TC
  142.             MODULE-COMPLIANCE, OBJECT-GROUP          FROM SNMPv2-CONF
  143.             ifIndex, InterfaceIndex                  FROM IF-MIB;
  144.  
  145. --  This MIB module uses the extended OBJECT-TYPE macro as
  146. --  defined in [9].
  147.  
  148. intSrv MODULE-IDENTITY
  149.         LAST-UPDATED "9511030500Z" -- Thu Aug 28 09:04:13 PDT 1997
  150.         ORGANIZATION "IETF Integrated Services Working Group"
  151.         CONTACT-INFO
  152.        "       Fred Baker
  153.        Postal: Cisco Systems
  154.                519 Lado Drive
  155.                Santa Barbara, California 93111
  156.        Tel:    +1 805 681 0115
  157.        E-Mail: fred@cisco.com
  158.  
  159.                John Krawczyk
  160.        Postal: ArrowPoint Communications
  161.                235 Littleton Road
  162.                Westford, Massachusetts 01886
  163.        Tel:    +1 508 692 5875
  164.        E-Mail: jjk@tiac.net"
  165.     DESCRIPTION
  166.        "The MIB module to describe the Integrated Services
  167.  
  168.  
  169.  
  170. Baker, et. al.              Standards Track                     [Page 3]
  171.  
  172. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  173.  
  174.  
  175.        Protocol"
  176.     ::= { mib-2 52 }
  177.  
  178. intSrvObjects          OBJECT IDENTIFIER ::= { intSrv 1 }
  179. intSrvGenObjects       OBJECT IDENTIFIER ::= { intSrv 2 }
  180. intSrvNotifications    OBJECT IDENTIFIER ::= { intSrv 3 }
  181. intSrvConformance      OBJECT IDENTIFIER ::= { intSrv 4 }
  182.  
  183. -- Textual Conventions
  184. --
  185.  
  186.     SessionNumber ::= TEXTUAL-CONVENTION
  187.         STATUS   current
  188.         DESCRIPTION
  189.            "The Session  Number  convention  is  used  for
  190.            numbers  identifying  sessions or saved PATH or
  191.            RESV information. It is a number in  the  range
  192.            returned  by  a TestAndIncr variable, having no
  193.            protocol meaning whatsoever but serving instead
  194.            as simple identifier.
  195.  
  196.            The alternative was a very complex instance  or
  197.            instance object that became unwieldy."
  198.        SYNTAX   INTEGER (0..2147483647)
  199.  
  200.  
  201.     Protocol ::= TEXTUAL-CONVENTION
  202.         DISPLAY-HINT "d"
  203.         STATUS   current
  204.         DESCRIPTION
  205.            "The value of the IP Protocol field  of  an  IP
  206.            Datagram  Header.  This identifies the protocol
  207.            layer above IP.  For example, the  value  6  is
  208.            used  for TCP and the value 17 is used for UDP.
  209.            The values of this field are defined in the As-
  210.            signed Numbers RFC."
  211.        SYNTAX   INTEGER (1..255)
  212.  
  213.  
  214.     SessionType ::= TEXTUAL-CONVENTION
  215.         STATUS   current
  216.         DESCRIPTION
  217.            "The value of the C-Type field of a Session ob-
  218.            ject,  as  defined  in  the RSVP specification.
  219.            This value  determines  the  lengths  of  octet
  220.            strings  and use of certain objects such as the
  221.            'port' variables. If the C-Type  calls  for  an
  222.            IP6  address, one would expect all source, des-
  223.  
  224.  
  225.  
  226. Baker, et. al.              Standards Track                     [Page 4]
  227.  
  228. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  229.  
  230.  
  231.            tination, and next/previous hop addresses to be
  232.            16  bytes long, and for the ports to be UDP/TCP
  233.            port numbers, for example."
  234.        SYNTAX   INTEGER (1..255)
  235.  
  236.     Port ::= TEXTUAL-CONVENTION
  237.         DISPLAY-HINT "d"
  238.         STATUS   current
  239.         DESCRIPTION
  240.            "The value of the UDP or TCP Source or Destina-
  241.            tion  Port field, a virtual destination port or
  242.            generalized port identifier used with the IPSEC
  243.            Authentication Header or Encapsulating Security
  244.            Payload, or other session discriminator.  If it
  245.            is  not  used, the value should be of length 0.
  246.            This pair, when coupled with the  IP  Addresses
  247.            of the source and destination system and the IP
  248.            protocol  field,  uniquely  identifies  a  data
  249.            stream."
  250.        SYNTAX   OCTET STRING (SIZE(2..4))
  251.  
  252.  
  253.     MessageSize ::= TEXTUAL-CONVENTION
  254.         DISPLAY-HINT "d"
  255.         STATUS   current
  256.         DESCRIPTION
  257.            "The size of a message in bytes. This  is  used
  258.            to  specify  the  minimum and maximum size of a
  259.            message along an integrated services route."
  260.        SYNTAX   INTEGER (0..'7FFFFFFF'h)
  261.  
  262.  
  263.     BitRate ::= TEXTUAL-CONVENTION
  264.         DISPLAY-HINT "d"
  265.         STATUS   current
  266.         DESCRIPTION
  267.            "The rate, in bits/second, that data  may  move
  268.            in  the context.  Applicable contexts minimally
  269.            include the speed of an  interface  or  virtual
  270.            circuit, the data rate of a (potentially aggre-
  271.            gated) data flow, or the data rate to be  allo-
  272.            cated for use by a flow."
  273.        SYNTAX   INTEGER (0..'7FFFFFFF'h)
  274.  
  275.     BurstSize ::= TEXTUAL-CONVENTION
  276.          DISPLAY-HINT "d"
  277.          STATUS   current
  278.          DESCRIPTION
  279.  
  280.  
  281.  
  282. Baker, et. al.              Standards Track                     [Page 5]
  283.  
  284. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  285.  
  286.  
  287.            "The number of octets of IP Data, including  IP
  288.            Headers, that a stream may send without concern
  289.            for policing."
  290.         SYNTAX   INTEGER (0..'7FFFFFFF'h)
  291.  
  292.  
  293.     QosService ::= TEXTUAL-CONVENTION
  294.          STATUS   current
  295.          DESCRIPTION
  296.            "The class of service in use by a flow."
  297.         SYNTAX   INTEGER {
  298.                    bestEffort (1),         -- Best Effort Service
  299.                    guaranteedDelay (2),    -- Guaranteed Delay
  300.                    controlledLoad (5)      -- Controlled Load
  301.                  }
  302.  
  303. --      The Integrated Services Interface Attributes Database contains
  304. --      information about resources allocated by resource reservation
  305. --      protocols, such as RSVP and ST-II.
  306.  
  307.  
  308.     intSrvIfAttribTable OBJECT-TYPE
  309.         SYNTAX      SEQUENCE OF IntSrvIfAttribEntry
  310.         MAX-ACCESS  not-accessible
  311.         STATUS      current
  312.         DESCRIPTION
  313.            "The reservable attributes of the system's  in-
  314.            terfaces."
  315.        ::= { intSrvObjects 1 }
  316.  
  317.  
  318.     intSrvIfAttribEntry OBJECT-TYPE
  319.         SYNTAX      IntSrvIfAttribEntry
  320.         MAX-ACCESS  not-accessible
  321.         STATUS      current
  322.         DESCRIPTION
  323.            "The reservable attributes of  a  given  inter-
  324.            face."
  325.        INDEX { ifIndex }
  326.        ::= { intSrvIfAttribTable 1 }
  327.  
  328. IntSrvIfAttribEntry ::=
  329.     SEQUENCE {
  330.         intSrvIfAttribAllocatedBits     BitRate,
  331.         intSrvIfAttribMaxAllocatedBits  BitRate,
  332.         intSrvIfAttribAllocatedBuffer   BurstSize,
  333.         intSrvIfAttribFlows             Gauge32,
  334.         intSrvIfAttribPropagationDelay  Integer32,
  335.  
  336.  
  337.  
  338. Baker, et. al.              Standards Track                     [Page 6]
  339.  
  340. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  341.  
  342.  
  343.         intSrvIfAttribStatus            RowStatus
  344.     }
  345.  
  346.     intSrvIfAttribAllocatedBits OBJECT-TYPE
  347.         SYNTAX      BitRate
  348.         UNITS       "Bits per second"
  349.         MAX-ACCESS  read-only
  350.         STATUS      current
  351.         DESCRIPTION
  352.            "The number of bits/second currently  allocated
  353.            to reserved sessions on the interface."
  354.        ::= { intSrvIfAttribEntry 1 }
  355.  
  356.     intSrvIfAttribMaxAllocatedBits OBJECT-TYPE
  357.         SYNTAX      BitRate
  358.         UNITS       "Bits per second"
  359.         MAX-ACCESS  read-create
  360.         STATUS      current
  361.         DESCRIPTION
  362.            "The maximum number of bits/second that may  be
  363.            allocated  to  reserved  sessions on the inter-
  364.            face."
  365.        ::= { intSrvIfAttribEntry 2 }
  366.  
  367.  
  368.     intSrvIfAttribAllocatedBuffer OBJECT-TYPE
  369.         SYNTAX      BurstSize
  370.         UNITS       "Bytes"
  371.         MAX-ACCESS  read-only
  372.         STATUS      current
  373.         DESCRIPTION
  374.            "The amount of buffer space  required  to  hold
  375.            the simultaneous burst of all reserved flows on
  376.            the interface."
  377.        ::= { intSrvIfAttribEntry 3 }
  378.  
  379.  
  380.     intSrvIfAttribFlows OBJECT-TYPE
  381.         SYNTAX      Gauge32
  382.         MAX-ACCESS  read-only
  383.         STATUS      current
  384.         DESCRIPTION
  385.            "The number of reserved flows currently  active
  386.            on  this  interface.  A flow can be created ei-
  387.            ther from a reservation protocol (such as  RSVP
  388.            or ST-II) or via configuration information."
  389.        ::= { intSrvIfAttribEntry 4 }
  390.  
  391.  
  392.  
  393.  
  394. Baker, et. al.              Standards Track                     [Page 7]
  395.  
  396. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  397.  
  398.  
  399.     intSrvIfAttribPropagationDelay OBJECT-TYPE
  400.         SYNTAX      Integer32
  401.         UNITS       "microseconds"
  402.         MAX-ACCESS  read-create
  403.         STATUS      current
  404.         DESCRIPTION
  405.            "The amount of propagation delay that this  in-
  406.            terface  introduces  in addition to that intro-
  407.            diced by bit propagation delays."
  408.        DEFVAL { 0 }-- by default, interfaces are presumed to add
  409.                    -- no extra delays
  410.        ::= { intSrvIfAttribEntry 5 }
  411.  
  412.  
  413.     intSrvIfAttribStatus OBJECT-TYPE
  414.         SYNTAX      RowStatus
  415.         MAX-ACCESS  read-create
  416.         STATUS      current
  417.         DESCRIPTION
  418.            "'active' on interfaces that are configured for
  419.            RSVP."
  420.        ::= { intSrvIfAttribEntry 6 }
  421.  
  422.  
  423. --      The Integrated Services Active Flows Database
  424. --      lists all flows active on an outgoing interface, including
  425. --      relevant attributes.
  426.  
  427.  
  428.     intSrvFlowTable OBJECT-TYPE
  429.         SYNTAX      SEQUENCE OF IntSrvFlowEntry
  430.         MAX-ACCESS  not-accessible
  431.         STATUS      current
  432.         DESCRIPTION
  433.            "Information describing the reserved flows  us-
  434.            ing the system's interfaces."
  435.        ::= { intSrvObjects 2 }
  436.  
  437.  
  438.     intSrvFlowEntry OBJECT-TYPE
  439.         SYNTAX      IntSrvFlowEntry
  440.         MAX-ACCESS  not-accessible
  441.         STATUS      current
  442.         DESCRIPTION
  443.            "Information describing the use of a given  in-
  444.            terface   by   a   given   flow.   The  counter
  445.            intSrvFlowPoliced starts counting  at  the  in-
  446.            stallation of the flow."
  447.  
  448.  
  449.  
  450. Baker, et. al.              Standards Track                     [Page 8]
  451.  
  452. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  453.  
  454.  
  455.        INDEX { intSrvFlowNumber }
  456.        ::= { intSrvFlowTable 1 }
  457.  
  458.  
  459.     IntSrvFlowEntry ::=
  460.         SEQUENCE {
  461.             intSrvFlowNumber                  SessionNumber,
  462.             intSrvFlowType                    SessionType,
  463.             intSrvFlowOwner                   INTEGER,
  464.             intSrvFlowDestAddr                OCTET STRING,
  465.             intSrvFlowSenderAddr              OCTET STRING,
  466.             intSrvFlowDestAddrLength          INTEGER,
  467.             intSrvFlowSenderAddrLength        INTEGER,
  468.             intSrvFlowProtocol                Protocol,
  469.             intSrvFlowDestPort                Port,
  470.             intSrvFlowPort                    Port,
  471.             intSrvFlowFlowId                  INTEGER,
  472.             intSrvFlowInterface               InterfaceIndex,
  473.             intSrvFlowIfAddr                  OCTET STRING,
  474.             intSrvFlowRate                    BitRate,
  475.             intSrvFlowBurst                   BurstSize,
  476.             intSrvFlowWeight                  Integer32,
  477.             intSrvFlowQueue                   Integer32,
  478.             intSrvFlowMinTU                   MessageSize,
  479.             intSrvFlowMaxTU                   MessageSize,
  480.             intSrvFlowBestEffort              Counter32,
  481.             intSrvFlowPoliced                 Counter32,
  482.             intSrvFlowDiscard                 TruthValue,
  483.             intSrvFlowService                 QosService,
  484.             intSrvFlowOrder                   INTEGER,
  485.             intSrvFlowStatus                  RowStatus
  486.         }
  487.  
  488.  
  489.     intSrvFlowNumber OBJECT-TYPE
  490.         SYNTAX      SessionNumber
  491.         MAX-ACCESS  not-accessible
  492.         STATUS      current
  493.         DESCRIPTION
  494.            "The number of this flow.  This is for SNMP In-
  495.            dexing purposes only and has no relation to any
  496.            protocol value."
  497.        ::= { intSrvFlowEntry 1 }
  498.  
  499.  
  500.     intSrvFlowType OBJECT-TYPE
  501.         SYNTAX      SessionType
  502.         MAX-ACCESS  read-create
  503.  
  504.  
  505.  
  506. Baker, et. al.              Standards Track                     [Page 9]
  507.  
  508. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  509.  
  510.  
  511.         STATUS      current
  512.         DESCRIPTION
  513.            "The type of session (IP4, IP6, IP6  with  flow
  514.            information, etc)."
  515.        ::= { intSrvFlowEntry 2 }
  516.  
  517.  
  518.     intSrvFlowOwner OBJECT-TYPE
  519.         SYNTAX      INTEGER {
  520.                          other(1),
  521.                          rsvp(2),
  522.                          management(3)
  523.                     }
  524.         MAX-ACCESS  read-create
  525.         STATUS      current
  526.         DESCRIPTION
  527.            "The process that installed this  flow  in  the
  528.            queue policy database."
  529.        ::= { intSrvFlowEntry 3 }
  530.  
  531.  
  532.     intSrvFlowDestAddr OBJECT-TYPE
  533.         SYNTAX      OCTET STRING (SIZE(4..16))
  534.         MAX-ACCESS  read-create
  535.         STATUS      current
  536.         DESCRIPTION
  537.            "The destination address used by all senders in
  538.            this  session.   This object may not be changed
  539.            when the value of the RowStatus object is  'ac-
  540.            tive'."
  541.        ::= { intSrvFlowEntry 4 }
  542.  
  543.  
  544.     intSrvFlowSenderAddr OBJECT-TYPE
  545.         SYNTAX      OCTET STRING (SIZE(4..16))
  546.         MAX-ACCESS  read-create
  547.         STATUS      current
  548.         DESCRIPTION
  549.            "The source address of the sender  selected  by
  550.            this  reservation.  The value of all zeroes in-
  551.            dicates 'all senders'.  This object may not  be
  552.            changed  when the value of the RowStatus object
  553.            is 'active'."
  554.        ::= { intSrvFlowEntry 5 }
  555.  
  556.  
  557.     intSrvFlowDestAddrLength OBJECT-TYPE
  558.         SYNTAX      INTEGER(0..128)
  559.  
  560.  
  561.  
  562. Baker, et. al.              Standards Track                    [Page 10]
  563.  
  564. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  565.  
  566.  
  567.         MAX-ACCESS  read-create
  568.         STATUS      current
  569.         DESCRIPTION
  570.            "The length of the destination address in bits.
  571.            This  is  the CIDR Prefix Length, which for IP4
  572.            hosts and multicast addresses is 32 bits.  This
  573.            object may not be changed when the value of the
  574.            RowStatus object is 'active'."
  575.        ::= { intSrvFlowEntry 6 }
  576.  
  577.  
  578.     intSrvFlowSenderAddrLength OBJECT-TYPE
  579.         SYNTAX      INTEGER(0..128)
  580.         MAX-ACCESS  read-create
  581.         STATUS      current
  582.         DESCRIPTION
  583.            "The length of the sender's  address  in  bits.
  584.            This  is  the CIDR Prefix Length, which for IP4
  585.            hosts and multicast addresses is 32 bits.  This
  586.            object may not be changed when the value of the
  587.            RowStatus object is 'active'."
  588.                ::= { intSrvFlowEntry 7 }
  589.  
  590.  
  591.     intSrvFlowProtocol OBJECT-TYPE
  592.         SYNTAX      Protocol
  593.         MAX-ACCESS  read-create
  594.         STATUS      current
  595.         DESCRIPTION
  596.            "The IP Protocol used by a session.   This  ob-
  597.            ject  may  not be changed when the value of the
  598.            RowStatus object is 'active'."
  599.        ::= { intSrvFlowEntry 8 }
  600.  
  601.  
  602.     intSrvFlowDestPort OBJECT-TYPE
  603.         SYNTAX      Port
  604.         MAX-ACCESS  read-create
  605.         STATUS      current
  606.         DESCRIPTION
  607.            "The UDP or TCP port number used as a  destina-
  608.            tion  port for all senders in this session.  If
  609.            the  IP   protocol   in   use,   specified   by
  610.            intSrvResvFwdProtocol,  is 50 (ESP) or 51 (AH),
  611.            this  represents  a  virtual  destination  port
  612.            number.   A value of zero indicates that the IP
  613.            protocol in use does not have ports.  This  ob-
  614.            ject  may  not be changed when the value of the
  615.  
  616.  
  617.  
  618. Baker, et. al.              Standards Track                    [Page 11]
  619.  
  620. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  621.  
  622.  
  623.            RowStatus object is 'active'."
  624.        ::= { intSrvFlowEntry 9 }
  625.  
  626.  
  627.     intSrvFlowPort OBJECT-TYPE
  628.         SYNTAX      Port
  629.         MAX-ACCESS  read-create
  630.         STATUS      current
  631.         DESCRIPTION
  632.            "The UDP or TCP port number used  as  a  source
  633.            port  for  this sender in this session.  If the
  634.            IP    protocol    in    use,    specified    by
  635.            intSrvResvFwdProtocol  is  50 (ESP) or 51 (AH),
  636.            this represents a generalized  port  identifier
  637.            (GPI).   A  value of zero indicates that the IP
  638.            protocol in use does not have ports.  This  ob-
  639.            ject  may  not be changed when the value of the
  640.            RowStatus object is 'active'."
  641.        ::= { intSrvFlowEntry 10 }
  642.  
  643.  
  644.     intSrvFlowFlowId OBJECT-TYPE
  645.         SYNTAX      INTEGER (0..16777215)
  646.         MAX-ACCESS  read-only
  647.         STATUS      current
  648.         DESCRIPTION
  649.            "The flow ID that  this  sender  is  using,  if
  650.            this  is  an IPv6 session."
  651.        ::= { intSrvFlowEntry 11 }
  652.  
  653.  
  654.     intSrvFlowInterface OBJECT-TYPE
  655.         SYNTAX      InterfaceIndex
  656.         MAX-ACCESS  read-create
  657.         STATUS      current
  658.         DESCRIPTION
  659.            "The ifIndex value of the  interface  on  which
  660.            this reservation exists."
  661.        ::= { intSrvFlowEntry 12 }
  662.  
  663.  
  664.     intSrvFlowIfAddr OBJECT-TYPE
  665.         SYNTAX      OCTET STRING (SIZE(4..16))
  666.         MAX-ACCESS  read-create
  667.         STATUS      current
  668.         DESCRIPTION
  669.            "The IP Address on the ifEntry  on  which  this
  670.            reservation  exists.  This is present primarily
  671.  
  672.  
  673.  
  674. Baker, et. al.              Standards Track                    [Page 12]
  675.  
  676. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  677.  
  678.  
  679.            to support those interfaces which layer  multi-
  680.            ple IP Addresses on the interface."
  681.        ::= { intSrvFlowEntry 13 }
  682.  
  683.  
  684.     intSrvFlowRate OBJECT-TYPE
  685.         SYNTAX      BitRate
  686.         UNITS       "bits per second"
  687.         MAX-ACCESS  read-create
  688.         STATUS      current
  689.         DESCRIPTION
  690.            "The Reserved Rate of the sender's data stream.
  691.            If this is a Controlled Load service flow, this
  692.            rate is derived from the Tspec  rate  parameter
  693.            (r).   If  this  is  a Guaranteed service flow,
  694.            this rate is derived from  the  Rspec  clearing
  695.            rate parameter (R)."
  696.        ::= { intSrvFlowEntry 14 }
  697.  
  698.  
  699.     intSrvFlowBurst OBJECT-TYPE
  700.         SYNTAX      BurstSize
  701.         UNITS       "bytes"
  702.         MAX-ACCESS  read-create
  703.         STATUS      current
  704.         DESCRIPTION
  705.            "The size of the largest  burst  expected  from
  706.            the sender at a time.
  707.  
  708.            If this is less than  the  sender's  advertised
  709.            burst  size, the receiver is asking the network
  710.            to provide flow pacing  beyond  what  would  be
  711.            provided  under normal circumstances. Such pac-
  712.            ing is at the network's option."
  713.        ::= { intSrvFlowEntry 15 }
  714.  
  715.  
  716.     intSrvFlowWeight OBJECT-TYPE
  717.         SYNTAX      Integer32
  718.         MAX-ACCESS  read-create
  719.         STATUS      current
  720.         DESCRIPTION
  721.            "The weight used  to  prioritize  the  traffic.
  722.            Note  that the interpretation of this object is
  723.            implementation-specific,   as   implementations
  724.            vary in their use of weighting procedures."
  725.        ::= { intSrvFlowEntry 16 }
  726.  
  727.  
  728.  
  729.  
  730. Baker, et. al.              Standards Track                    [Page 13]
  731.  
  732. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  733.  
  734.  
  735.     intSrvFlowQueue OBJECT-TYPE
  736.         SYNTAX      Integer32
  737.         MAX-ACCESS  read-create
  738.         STATUS      current
  739.         DESCRIPTION
  740.            "The number of the queue used by this  traffic.
  741.            Note  that the interpretation of this object is
  742.            implementation-specific,   as   implementations
  743.            vary in their use of queue identifiers."
  744.        ::= { intSrvFlowEntry 17 }
  745.  
  746.  
  747.     intSrvFlowMinTU OBJECT-TYPE
  748.         SYNTAX      MessageSize
  749.         MAX-ACCESS  read-create
  750.         STATUS      current
  751.         DESCRIPTION
  752.            "The minimum message size for  this  flow.  The
  753.            policing  algorithm will treat smaller messages
  754.            as though they are this size."
  755.        ::= { intSrvFlowEntry 18 }
  756.  
  757.  
  758.     intSrvFlowMaxTU OBJECT-TYPE
  759.         SYNTAX      MessageSize
  760.         MAX-ACCESS  read-create
  761.         STATUS      current
  762.         DESCRIPTION
  763.            "The maximum datagram size for this  flow  that
  764.            will conform to the traffic specification. This
  765.            value cannot exceed the MTU of the interface."
  766.        ::= { intSrvFlowEntry 19 }
  767.  
  768.  
  769.     intSrvFlowBestEffort OBJECT-TYPE
  770.         SYNTAX      Counter32
  771.         MAX-ACCESS  read-only
  772.         STATUS      current
  773.         DESCRIPTION
  774.            "The number of packets that  were  remanded  to
  775.            best effort service."
  776.        ::= { intSrvFlowEntry 20 }
  777.  
  778.  
  779.     intSrvFlowPoliced OBJECT-TYPE
  780.         SYNTAX      Counter32
  781.         MAX-ACCESS  read-only
  782.         STATUS      current
  783.  
  784.  
  785.  
  786. Baker, et. al.              Standards Track                    [Page 14]
  787.  
  788. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  789.  
  790.  
  791.         DESCRIPTION
  792.            "The number of packets policed since the incep-
  793.            tion of the flow's service."
  794.        ::= { intSrvFlowEntry 21 }
  795.  
  796.  
  797.     intSrvFlowDiscard OBJECT-TYPE
  798.         SYNTAX      TruthValue
  799.         MAX-ACCESS  read-create
  800.         STATUS      current
  801.         DESCRIPTION
  802.            "If 'true', the flow  is  to  incur  loss  when
  803.            traffic is policed.  If 'false', policed traff-
  804.            ic is treated as best effort traffic."
  805.        DEFVAL { false } -- traffic is, by default, treated as best
  806.                         -- effort
  807.        ::= { intSrvFlowEntry 22 }
  808.  
  809.  
  810.     intSrvFlowService OBJECT-TYPE
  811.         SYNTAX      QosService
  812.         MAX-ACCESS  read-only
  813.         STATUS      current
  814.         DESCRIPTION
  815.            "The QoS service being applied to this flow."
  816.        ::= { intSrvFlowEntry 23 }
  817.  
  818.  
  819.     intSrvFlowOrder OBJECT-TYPE
  820.         SYNTAX      INTEGER (0..65535)
  821.         MAX-ACCESS  read-create
  822.         STATUS      current
  823.         DESCRIPTION
  824.            "In the event of ambiguity, the order in  which
  825.            the  classifier  should  make  its comparisons.
  826.            The row with intSrvFlowOrder=0 is tried  first,
  827.            and  comparisons  proceed  in  the order of in-
  828.            creasing value.  Non-serial implementations  of
  829.            the classifier should emulate this behavior."
  830.        ::= { intSrvFlowEntry 24 }
  831.  
  832.  
  833.     intSrvFlowStatus OBJECT-TYPE
  834.         SYNTAX      RowStatus
  835.         MAX-ACCESS  read-create
  836.         STATUS      current
  837.         DESCRIPTION
  838.            "'active' for all active  flows.   This  object
  839.  
  840.  
  841.  
  842. Baker, et. al.              Standards Track                    [Page 15]
  843.  
  844. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  845.  
  846.  
  847.            may be used to install static classifier infor-
  848.            mation, delete classifier information,  or  au-
  849.            thorize such."
  850.        ::= { intSrvFlowEntry 25 }
  851.  
  852.  
  853.     intSrvFlowNewIndex OBJECT-TYPE
  854.         SYNTAX      TestAndIncr
  855.         MAX-ACCESS  read-write
  856.         STATUS      current
  857.         DESCRIPTION
  858.            "This  object  is  used  to  assign  values  to
  859.            intSrvFlowNumber  as described in 'Textual Con-
  860.            ventions  for  SNMPv2'.   The  network  manager
  861.            reads  the  object,  and  then writes the value
  862.            back in the SET that creates a new instance  of
  863.            intSrvFlowEntry.   If  the  SET  fails with the
  864.            code 'inconsistentValue', then the process must
  865.            be  repeated; If the SET succeeds, then the ob-
  866.            ject is incremented, and the  new  instance  is
  867.            created according to the manager's directions."
  868.        ::= { intSrvGenObjects 1 }
  869.  
  870.  
  871. -- conformance information
  872.  
  873.  
  874. intSrvGroups      OBJECT IDENTIFIER ::= { intSrvConformance 1 }
  875. intSrvCompliances OBJECT IDENTIFIER ::= { intSrvConformance 2 }
  876.  
  877. -- compliance statements
  878.  
  879.  
  880.     intSrvCompliance MODULE-COMPLIANCE
  881.         STATUS  current
  882.         DESCRIPTION
  883.            "The compliance statement "
  884.        MODULE  -- this module
  885.        MANDATORY-GROUPS { intSrvIfAttribGroup, intSrvFlowsGroup }
  886.  
  887.        OBJECT       intSrvFlowType
  888.          MIN-ACCESS read-only
  889.          DESCRIPTION
  890.           "read-create access is not required. This may be
  891.           read-only."
  892.  
  893.       OBJECT       intSrvFlowOwner
  894.         MIN-ACCESS read-only
  895.  
  896.  
  897.  
  898. Baker, et. al.              Standards Track                    [Page 16]
  899.  
  900. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  901.  
  902.  
  903.         DESCRIPTION
  904.          "read-create access is not required. This may  be
  905.          read-only."
  906.  
  907.      OBJECT       intSrvFlowDestAddr
  908.        MIN-ACCESS read-only
  909.        DESCRIPTION
  910.         "read-create access is not required. This  may  be
  911.         read-only."
  912.  
  913.     OBJECT       intSrvFlowSenderAddr
  914.       MIN-ACCESS read-only
  915.       DESCRIPTION
  916.        "read-create access is not required.  This  may  be
  917.        read-only."
  918.  
  919.     OBJECT       intSrvFlowDestAddrLength
  920.       MIN-ACCESS read-only
  921.       DESCRIPTION
  922.        "read-create access is not required.  This  may  be
  923.        read-only."
  924.  
  925.     OBJECT       intSrvFlowSenderAddrLength
  926.       MIN-ACCESS read-only
  927.       DESCRIPTION
  928.        "read-create access is not required.  This  may  be
  929.        read-only."
  930.  
  931.     OBJECT       intSrvFlowProtocol
  932.       MIN-ACCESS read-only
  933.       DESCRIPTION
  934.        "read-create access is not required.  This  may  be
  935.        read-only."
  936.  
  937.     OBJECT       intSrvFlowDestPort
  938.       MIN-ACCESS read-only
  939.       DESCRIPTION
  940.        "read-create access is not required.  This  may  be
  941.        read-only."
  942.  
  943.     OBJECT       intSrvFlowPort
  944.       MIN-ACCESS read-only
  945.       DESCRIPTION
  946.        "read-create access is not required.  This  may  be
  947.        read-only."
  948.  
  949.     OBJECT       intSrvFlowFlowId
  950.       MIN-ACCESS not-accessible
  951.  
  952.  
  953.  
  954. Baker, et. al.              Standards Track                    [Page 17]
  955.  
  956. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  957.  
  958.  
  959.       DESCRIPTION
  960.        "This object is needed only in a system that imple-
  961.        ments IPv6."
  962.  
  963.     OBJECT       intSrvFlowInterface
  964.       MIN-ACCESS read-only
  965.       DESCRIPTION
  966.        "read-create access is not required.  This  may  be
  967.        read-only."
  968.  
  969.     OBJECT       intSrvFlowRate
  970.       MIN-ACCESS read-only
  971.       DESCRIPTION
  972.        "read-create access is not required.  This  may  be
  973.        read-only."
  974.  
  975.     OBJECT       intSrvFlowBurst
  976.       MIN-ACCESS read-only
  977.       DESCRIPTION
  978.        "read-create access is not required.  This  may  be
  979.        read-only."
  980.  
  981.     OBJECT       intSrvFlowWeight
  982.       MIN-ACCESS read-only
  983.       DESCRIPTION
  984.        "read-create access is not required.  This  may  be
  985.        read-only."
  986.  
  987.     OBJECT       intSrvFlowQueue
  988.       MIN-ACCESS read-only
  989.       DESCRIPTION
  990.        "read-create access is not required.  This  may  be
  991.        read-only."
  992.  
  993.     OBJECT       intSrvFlowMinTU
  994.       MIN-ACCESS read-only
  995.       DESCRIPTION
  996.        "read-create access is not required.  This  may  be
  997.        read-only."
  998.  
  999.     OBJECT       intSrvFlowMaxTU
  1000.       MIN-ACCESS read-only
  1001.       DESCRIPTION
  1002.        "read-create access is not required.  This  may  be
  1003.        read-only."
  1004.  
  1005.     OBJECT       intSrvFlowStatus
  1006.       MIN-ACCESS read-only
  1007.  
  1008.  
  1009.  
  1010. Baker, et. al.              Standards Track                    [Page 18]
  1011.  
  1012. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  1013.  
  1014.  
  1015.       DESCRIPTION
  1016.        "read-create access is not required.  This  may  be
  1017.        read-only."
  1018.  
  1019.     ::= { intSrvCompliances 1 }
  1020.  
  1021.  
  1022.     intSrvIfAttribGroup OBJECT-GROUP
  1023.          OBJECTS {
  1024.             intSrvIfAttribAllocatedBits, intSrvIfAttribMaxAllocatedBits,
  1025.             intSrvIfAttribAllocatedBuffer, intSrvIfAttribFlows,
  1026.             intSrvIfAttribPropagationDelay, intSrvIfAttribStatus
  1027.         }
  1028.         STATUS  current
  1029.         DESCRIPTION
  1030.            "These objects are required  for  Systems  sup-
  1031.            porting the Integrated Services Architecture."
  1032.        ::= { intSrvGroups 1 }
  1033.  
  1034.     intSrvFlowsGroup OBJECT-GROUP
  1035.          OBJECTS {
  1036.             intSrvFlowType, intSrvFlowOwner, intSrvFlowDestAddr,
  1037.             intSrvFlowSenderAddr, intSrvFlowDestAddrLength,
  1038.             intSrvFlowSenderAddrLength, intSrvFlowProtocol,
  1039.             intSrvFlowDestPort, intSrvFlowPort, intSrvFlowInterface,
  1040.             intSrvFlowBestEffort, intSrvFlowRate, intSrvFlowBurst,
  1041.             intSrvFlowWeight, intSrvFlowQueue, intSrvFlowMinTU,
  1042.             intSrvFlowDiscard, intSrvFlowPoliced, intSrvFlowService,
  1043.             intSrvFlowIfAddr, intSrvFlowOrder, intSrvFlowStatus
  1044.         }
  1045.         STATUS  current
  1046.         DESCRIPTION
  1047.            "These objects are required  for  Systems  sup-
  1048.            porting the Integrated Services Architecture."
  1049.        ::= { intSrvGroups 2 }
  1050.  
  1051. END
  1052.  
  1053. 4.  Security Considerations
  1054.  
  1055.    The use of an SNMP SET results in an RSVP or Integrated Services
  1056.    reservation under rules that are different compared to if the
  1057.    reservation was negotiated using RSVP. However, no other security
  1058.    considerations exist other than those imposed by SNMP itself.
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066. Baker, et. al.              Standards Track                    [Page 19]
  1067.  
  1068. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  1069.  
  1070.  
  1071. 5.  Authors' Addresses
  1072.  
  1073.             Fred Baker
  1074.     Postal: Cisco Systems
  1075.             519 Lado Drive
  1076.             Santa Barbara, California 93111
  1077.  
  1078.     Phone:  +1 805 681 0115
  1079.     EMail:  fred@cisco.com
  1080.  
  1081.  
  1082.             John Krawczyk
  1083.     Postal: ArrowPoint Communications
  1084.             235 Littleton Road
  1085.             Westford, Massachusetts 01886
  1086.  
  1087.     Phone:  +1 508 692 5875
  1088.     EMail:  jjk@tiac.net
  1089.  
  1090.  
  1091.             Arun Sastry
  1092.     Postal: Cisco Systems
  1093.             210 W. Tasman Drive
  1094.             San Jose, California 95314
  1095.     Phone:  +1 408 526 7685
  1096.     EMail:  arun@cisco.com
  1097.  
  1098. 6.  Acknowledgements
  1099.  
  1100.    This document was produced by the Integrated Services Working Group.
  1101.  
  1102.    The authors would like to thank the following people for providing
  1103.    feedback on this document:
  1104.  
  1105.    Lou Berger, Fore Systems
  1106.    Bob Braden, ISI
  1107.    Viswanatha Rao, Compaq
  1108.    John Wroclawski, MIT
  1109.  
  1110. 7.  References
  1111.  
  1112.    [1]  Rose, M., Editor, "Management Information Base for Network
  1113.    Management of TCP/IP-based internets", STD 17, RFC 1213, May 1990.
  1114.  
  1115.    [2]  Information processing systems - Open Systems
  1116.    Interconnection - Specification of Abstract Syntax
  1117.    Notation One (ASN.1), International Organization for
  1118.    Standardization.  International Standard 8824, (December,
  1119.  
  1120.  
  1121.  
  1122. Baker, et. al.              Standards Track                    [Page 20]
  1123.  
  1124. RFC 2213          Integrated Services MIB using SMIv2     September 1997
  1125.  
  1126.  
  1127.    1987).
  1128.  
  1129.    [3]  Information processing systems - Open Systems
  1130.    Interconnection - Specification of Basic Encoding Rules
  1131.    for Abstract Notation One (ASN.1), International
  1132.    Organization for Standardization.  International Standard
  1133.    8825, (December, 1987).
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178. Baker, et. al.              Standards Track                    [Page 21]
  1179.  
  1180.