home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / rfc / 3 / rfc1749.txt < prev    next >
Encoding:
Text File  |  2003-06-11  |  17.2 KB  |  564 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                      K. McCloghrie
  8. Request for Comments: 1749                                      F. Baker
  9. Updates: 1748                                                  E. Decker
  10. Category: Standards Track                            cisco Systems, Inc.
  11.                                                            December 1994
  12.  
  13.  
  14.            IEEE 802.5 Station Source Routing MIB using SMIv2
  15.  
  16. Status of this Memo
  17.  
  18.    This document specifies an Internet standards track protocol for the
  19.    Internet community, and requests discussion and suggestions for
  20.    improvements.  Please refer to the current edition of the "Internet
  21.    Official Protocol Standards" (STD 1) for the standardization state
  22.    and status of this protocol.  Distribution of this memo is unlimited.
  23.  
  24. Table of Contents
  25.  
  26.    1. Introduction .............................................    1
  27.    2. The SNMPv2 Network Management Framework ..................    2
  28.    2.1 Object Definitions ......................................    2
  29.    3. Overview .................................................    2
  30.    3.1 Source Routing ..........................................    2
  31.    3.2 Relationship to RFC 1748 ................................    3
  32.    3.3 Relationship to RFC 1525 ................................    3
  33.    3.4 Static Source Routes ....................................    4
  34.    3.5 Destinations on the Local Ring ..........................    4
  35.    4. Definitions ..............................................    4
  36.    5. Acknowledgements .........................................    8
  37.    6. References ...............................................    8
  38.    7. Security Considerations ..................................    9
  39.    8. Authors' Addresses .......................................   10
  40.  
  41. 1.  Introduction
  42.  
  43.    This memo defines a portion of the Management Information Base (MIB)
  44.    for use with network management protocols in the Internet community.
  45.    In particular, it describes managed objects used by IEEE 802.5 end-
  46.    stations for managing source routes on a Token Ring network where
  47.    IEEE source-routing is in use.  IEEE source-routing is described in
  48.    802.5 Token Ring Access Method and Physical Layer Specifications [8]
  49.    and related ISO publications [9, 10, 11].
  50.  
  51.    This memo is an incremental update to RFC 1748 [6].  It is documented
  52.    separately from the RFC 1748 solely due to the latter's maturity
  53.    within the Internet standardization process.
  54.  
  55.  
  56.  
  57.  
  58. McCloghrie, Baker & Decker                                      [Page 1]
  59.  
  60. RFC 1749      802.5 Station Source Routing MIB using SMIv2 December 1994
  61.  
  62.  
  63. 2.  The SNMPv2 Network Management Framework
  64.  
  65.    The SNMPv2 Network Management Framework consists of four major
  66.    components.  They are:
  67.  
  68.       o    RFC 1442 [1] which defines the SMI, the mechanisms used for
  69.            describing and naming objects for the purpose of management.
  70.  
  71.       o    STD 17, RFC 1213 [2] defines MIB-II, the core set of managed
  72.            objects for the Internet suite of protocols.
  73.  
  74.       o    RFC 1445 [3] which defines the administrative and other
  75.            architectural aspects of the framework.
  76.  
  77.       o    RFC 1448 [4] which defines the protocol used for network
  78.            access to managed objects.
  79.  
  80.    The Framework permits new objects to be defined for the purpose of
  81.    experimentation and evaluation.
  82.  
  83. 2.1.  Object Definitions
  84.  
  85.    Managed objects are accessed via a virtual information store, termed
  86.    the Management Information Base or MIB.  Objects in the MIB are
  87.    defined using the subset of Abstract Syntax Notation One (ASN.1)
  88.    defined in the SMI.  In particular, each object type is named by an
  89.    OBJECT IDENTIFIER, an administratively assigned name.  The object
  90.    type together with an object instance serves to uniquely identify a
  91.    specific instantiation of the object.  For human convenience, we
  92.    often use a textual string, termed the descriptor, to refer to the
  93.    object type.
  94.  
  95. 3.  Overview
  96.  
  97.    This memo defines a single table: the 802.5 Station Source Routing
  98.    Table, which contains the source routes known by a end-station on an
  99.    IEEE 802.5 Token Ring network in which IEEE source-routing is in use.
  100.  
  101. 3.1.  Source Routing
  102.  
  103.    Source routing extends the 802.5 protocol [8] by assigning a unique
  104.    ring number to each ring within the extended LAN, and a bridge number
  105.    to each source routing bridge's connection to a ring.  A Routing
  106.    Information Field (RIF) must be included in frames which need to
  107.    traverse multiple rings.  The format of the RIF is:
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. McCloghrie, Baker & Decker                                      [Page 2]
  115.  
  116. RFC 1749      802.5 Station Source Routing MIB using SMIv2 December 1994
  117.  
  118.  
  119.               octets octets octets         octets
  120.                1&2    3&4    5&6            17&18
  121.              +------+------+------+-------+------+
  122.              |  RC  |  RD  |  RD  | ...   |  RD  |
  123.              +------+------+------+-------+------+
  124.                      <---- 0 to 8 RD fields ---->
  125.  
  126.    The format of the Routing Control (RC) field is:
  127.  
  128.                             octet 1         octet 2
  129.                        +---------------+---------------+
  130.                        |b b b l l l l l|d f f f 0 0 0 0|
  131.                        +---------------+---------------+
  132.                           ^       ^     ^   ^
  133.                           |       |     |   |
  134.      Explorer indicator --+       |     |   +-- Max frame length*
  135.             Length of RIF field --+     +-- Direction to use RDs
  136.  
  137.      * Note that the length of the Maximum frame length subfield
  138.        has recently been extended to 6 bits.
  139.  
  140.    The format of each Routing Descriptor (RD) field is:
  141.  
  142.                      octet 1         octet 2
  143.                  +---------------+---------------+
  144.                  |r r r r r r r r r r r r i i i i|
  145.                  +---------------+---------------+
  146.                   <---- ring number ----> <----->
  147.                                              ^
  148.                                              |
  149.                              bridge number --+
  150.  
  151. 3.2.  Relationship to RFC 1748
  152.  
  153.    RFC 1748 [6], the IEEE 802.5 MIB, defines managed objects used for
  154.    interfaces to IEEE 802.5 Token Ring subnetworks.  This memo is an
  155.    incremental update to RFC 1748, and is documented independently
  156.    solely due to the maturity of the definitions contained within RFC
  157.    1748.
  158.  
  159. 3.3.  Relationship to RFC 1525
  160.  
  161.    RFC 1525 [7] defines the MIB objects specific to source-routing for
  162.    source-routing and SRT bridges.  This memo defines the MIB objects
  163.    specific to source-routing for source-routing end-stations.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170. McCloghrie, Baker & Decker                                      [Page 3]
  171.  
  172. RFC 1749      802.5 Station Source Routing MIB using SMIv2 December 1994
  173.  
  174.  
  175. 3.4.  Static Source Routes
  176.  
  177.    It is unclear how many, if any, existing systems allow the creation
  178.    or deletion of "static" 802.5 source routes by network management.
  179.    However, SNMPv2 SMI defines that the MAX-ACCESS clause as specifying
  180.    the maximal level of access which makes "protocol sense".  Thus, this
  181.    memo provides support for static source routes through the
  182.    dot5SrRouteStatus object, but the conformance statements allow for
  183.    stations which do not support static source routes, by requiring that
  184.    compliant agents only need provide read-access to dot5SrRouteStatus.
  185.  
  186. 3.5.  Destinations on the Local Ring
  187.  
  188.    Entries should be included in the dot5SrRouteTable for destination
  189.    MAC addresses which are on the same ring as the instrumented 802.5
  190.    interface.  For such entries, dot5SrRouteDescr has the value of the
  191.    zero-length string, and dot5SrRouteControl has the corresponding
  192.    value.
  193.  
  194. 4.  Definitions
  195.  
  196. TOKENRING-STATION-SR-MIB DEFINITIONS ::= BEGIN
  197.  
  198. IMPORTS
  199.     MODULE-IDENTITY, OBJECT-TYPE
  200.                                          FROM SNMPv2-SMI
  201.     TEXTUAL-CONVENTION, RowStatus, MacAddress
  202.                                          FROM SNMPv2-TC
  203.     MODULE-COMPLIANCE, OBJECT-GROUP      FROM SNMPv2-CONF
  204.     mib-2, ifIndex                       FROM RFC1213-MIB;
  205.  
  206. dot5SrMIB MODULE-IDENTITY
  207.     LAST-UPDATED "9412161000Z"
  208.     ORGANIZATION "IETF Interfaces MIB Working Group"
  209.     CONTACT-INFO
  210.             "       Keith McCloghrie
  211.             Postal: Cisco Systems, Inc.
  212.                     170 West Tasman Drive
  213.                     San Jose, CA  95134-1706
  214.                     US
  215.  
  216.              Phone: +1 408 526 5260
  217.              Email: kzm@cisco.com"
  218.     DESCRIPTION
  219.             "The MIB module for managing source routes in
  220.             end-stations on IEEE 802.5 Token Ring networks."
  221.     ::= { mib-2 42 }
  222.  
  223.  
  224.  
  225.  
  226. McCloghrie, Baker & Decker                                      [Page 4]
  227.  
  228. RFC 1749      802.5 Station Source Routing MIB using SMIv2 December 1994
  229.  
  230.  
  231. dot5SrMIBObjects OBJECT IDENTIFIER ::= { dot5SrMIB 1 }
  232.  
  233. SourceRoute ::= TEXTUAL-CONVENTION
  234.     DISPLAY-HINT "1x:"
  235.     STATUS       current
  236.     DESCRIPTION
  237.                  "Represents a Source Route, containing an
  238.                  embedded sequence of bridge and ring ID's,
  239.                  as used by 802.5 Source Routing."
  240.     REFERENCE    "Annex C of ISO/IEC 10038: 1993,
  241.                  [ANSI/IEEE Std 802.1D, 1993]"
  242.     SYNTAX       OCTET STRING (SIZE(0..30))
  243.  
  244.  
  245. --           The 802.5 Station Source Route Table
  246. --
  247.  
  248. dot5SrRouteTable   OBJECT-TYPE
  249.     SYNTAX      SEQUENCE OF Dot5SrRouteEntry
  250.     MAX-ACCESS  not-accessible
  251.     STATUS      current
  252.     DESCRIPTION
  253.                "The table of source-routing routes.
  254.                This represents the 802.5 RIF database."
  255.     ::= { dot5SrMIBObjects 1 }
  256.  
  257. dot5SrRouteEntry  OBJECT-TYPE
  258.     SYNTAX      Dot5SrRouteEntry
  259.     MAX-ACCESS  not-accessible
  260.     STATUS      current
  261.     DESCRIPTION
  262.                 "Information on a specific route.
  263.  
  264.                 An entry is created whenever a 'Single Path
  265.                 Explorer' or an 'All Paths Explorer' discovers
  266.                 a route to a neighbor not currently in the table,
  267.                 or whenever an 'All Paths Explorer' discovers a
  268.                 better (e.g., shorter) route than the route currently
  269.                 stored in the table.  This is done on behalf of
  270.                 any network layer client.
  271.  
  272.                 The ifIndex value in the INDEX clause refers to
  273.                 the value of MIB-II's ifIndex object for the
  274.                 interface on which the route is in effect."
  275.     INDEX  { ifIndex, dot5SrRouteDestination }
  276.     ::= { dot5SrRouteTable 1 }
  277.  
  278. Dot5SrRouteEntry ::= SEQUENCE {
  279.  
  280.  
  281.  
  282. McCloghrie, Baker & Decker                                      [Page 5]
  283.  
  284. RFC 1749      802.5 Station Source Routing MIB using SMIv2 December 1994
  285.  
  286.  
  287.     dot5SrRouteDestination   MacAddress,
  288.     dot5SrRouteControl       OCTET STRING,
  289.     dot5SrRouteDescr         SourceRoute,
  290.     dot5SrRouteStatus        RowStatus
  291. }
  292.  
  293. dot5SrRouteDestination  OBJECT-TYPE
  294.     SYNTAX      MacAddress
  295.     MAX-ACCESS  not-accessible
  296.     STATUS      current
  297.     DESCRIPTION
  298.                "The destination of this route."
  299.     ::= { dot5SrRouteEntry 2 }
  300.  
  301. dot5SrRouteControl  OBJECT-TYPE
  302.     SYNTAX      OCTET STRING (SIZE(2))
  303.     MAX-ACCESS  read-create
  304.     STATUS      current
  305.     DESCRIPTION
  306.                "The value of Routing Control field for this
  307.                route."
  308.     REFERENCE  "Annex C of ISO/IEC 10038: 1993,
  309.                [ANSI/IEEE Std 802.1D, 1993]"
  310.     ::= { dot5SrRouteEntry 3 }
  311.  
  312. dot5SrRouteDescr  OBJECT-TYPE
  313.     SYNTAX      SourceRoute
  314.     MAX-ACCESS  read-create
  315.     STATUS      current
  316.     DESCRIPTION
  317.                "The embedded sequence of bridge and ring ID's
  318.                for this route.  For destinations on the
  319.                local ring, the value of this object is
  320.                the zero-length string."
  321.     REFERENCE  "Annex C of ISO/IEC 10038: 1993,
  322.                [ANSI/IEEE Std 802.1D, 1993]"
  323.     ::= { dot5SrRouteEntry 4 }
  324.  
  325. dot5SrRouteStatus  OBJECT-TYPE
  326.     SYNTAX      RowStatus
  327.     MAX-ACCESS  read-create
  328.     STATUS      current
  329.     DESCRIPTION
  330.              "The status of this row.  Values of the instances
  331.              of dot5SrRouteControl and dot5SrRouteDescr can be
  332.              modified while the row's status is 'active."
  333.     ::= { dot5SrRouteEntry 5 }
  334.  
  335.  
  336.  
  337.  
  338. McCloghrie, Baker & Decker                                      [Page 6]
  339.  
  340. RFC 1749      802.5 Station Source Routing MIB using SMIv2 December 1994
  341.  
  342.  
  343. -- conformance information
  344.  
  345. dot5SrConformance OBJECT IDENTIFIER ::= { dot5SrMIB 2 }
  346.  
  347. dot5SrGroups      OBJECT IDENTIFIER ::= { dot5SrConformance 1 }
  348. dot5SrCompliances OBJECT IDENTIFIER ::= { dot5SrConformance 2 }
  349.  
  350.  
  351. -- compliance statements
  352.  
  353. dot5SrCompliance MODULE-COMPLIANCE
  354.     STATUS  current
  355.     DESCRIPTION
  356.         "The compliance statement for SNMPv2 entities
  357.         which implement the IEEE 802.5 Station Source Route
  358.         MIB."
  359.  
  360.     MODULE  -- this module
  361.         MANDATORY-GROUPS { dot5SrRouteGroup }
  362.  
  363.         OBJECT      dot5SrRouteStatus
  364.         SYNTAX      INTEGER { active(1) }   -- subset of values
  365.         MIN-ACCESS  read-only
  366.         DESCRIPTION
  367.             "Write access is not required, and only the 'active'
  368.             value need be supported."
  369.  
  370.         OBJECT      dot5SrRouteControl
  371.         MIN-ACCESS  read-only
  372.         DESCRIPTION
  373.             "Write access is not required."
  374.  
  375.         OBJECT      dot5SrRouteDescr
  376.         MIN-ACCESS  read-only
  377.         DESCRIPTION
  378.             "Write access is not required."
  379.  
  380.     ::= { dot5SrCompliances 1 }
  381.  
  382.  
  383. -- units of conformance
  384.  
  385. dot5SrRouteGroup  OBJECT-GROUP
  386.     OBJECTS   { dot5SrRouteControl,
  387.                 dot5SrRouteDescr,
  388.                 dot5SrRouteStatus
  389.               }
  390.     STATUS    current
  391.  
  392.  
  393.  
  394. McCloghrie, Baker & Decker                                      [Page 7]
  395.  
  396. RFC 1749      802.5 Station Source Routing MIB using SMIv2 December 1994
  397.  
  398.  
  399.     DESCRIPTION
  400.         "A collection of objects providing for the management of
  401.         source routes in stations on IEEE 802.5 source-routing
  402.         networks."
  403.     ::= { dot5SrGroups 1 }
  404.  
  405. END
  406.  
  407. 5.  Acknowledgements
  408.  
  409.    The need for this MIB module was agreed upon by the members of the
  410.    IETF Interfaces Working Group, and the definitions were derived from
  411.    experience with enterprise-specific MIBs presented to the Working
  412.    Group.
  413.  
  414. 6.  References
  415.  
  416.    [1] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure
  417.        of Management Information for version 2 of the Simple Network
  418.        Management Protocol (SNMPv2)", RFC 1442, SNMP Research,Inc.,
  419.        Hughes LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon
  420.        University, April 1993.
  421.  
  422.    [2] McCloghrie, K., and M. Rose, Editors, "Management Information
  423.        Base for Network Management of TCP/IP-based internets: MIB- II",
  424.        STD 17, RFC 1213, Hughes LAN Systems, Performance Systems
  425.        International, March 1991.
  426.  
  427.    [3] Galvin, J., and K. McCloghrie, "Administrative Model for version
  428.        2 of the Simple Network Management Protocol (SNMPv2)", RFC 1445,
  429.        Trusted Information Systems, Hughes LAN Systems, April 1993.
  430.  
  431.    [4] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol
  432.        Operations for version 2 of the Simple Network Management
  433.        Protocol (SNMPv2)", RFC 1448, SNMP Research,Inc., Hughes LAN
  434.        Systems, Dover Beach Consulting, Inc., Carnegie Mellon
  435.        University, April 1993.
  436.  
  437.    [5] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Textual
  438.        Conventions for version 2 of the Simple Network Management
  439.        Protocol (SNMPv2)", RFC 1443, SNMP Research Inc., Hughes LAN
  440.        Systems, Dover Beach Consulting, Inc., Carnegie Mellon
  441.        University, April 1993.
  442.  
  443.    [6] McCloghrie, K., and E. Decker, "IEEE 802.5 Token Ring MIB using
  444.        SMIv2", RFC 1748 cisco Systems, Inc., December 1994.
  445.  
  446.  
  447.  
  448.  
  449.  
  450. McCloghrie, Baker & Decker                                      [Page 8]
  451.  
  452. RFC 1749      802.5 Station Source Routing MIB using SMIv2 December 1994
  453.  
  454.  
  455.    [7] McCloghrie, K., Decker, E., Langville, P., and A.  Rijsinghani,
  456.        "Definitions of Managed Objects for Source Routing Bridges", RFC
  457.        1525, Hughes LAN Systems, cisco Systems, Inc., Digital Equipment
  458.        Corporation, September 1993.
  459.  
  460.    [8] "Token Ring Access Method and Physical Layer Specifications",
  461.        IEEE Standard 802.5-1989, 1989.
  462.  
  463.    [9] "Information technology - Local and metropolitan area networks -
  464.        Part 5: Token ring access method and physical layer
  465.        specifications", ISO/IEC 8802-5, 1992.
  466.  
  467.   [10] "Information technology - Telecommunications and information
  468.        exchange between systems - Local area networks - Media access
  469.        control (MAC) bridges", ISO/IEC 10038, 1993 [ANSI/IEEE Std
  470.        802.1D, 1993 Edition].
  471.  
  472.   [11] "Source Routing Operation by End Systems", ISO/IEC 8802-2 PDAM5.3
  473.        (6N7721).
  474.  
  475. 7.  Security Considerations
  476.  
  477.    Security issues are not discussed in this memo.
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506. McCloghrie, Baker & Decker                                      [Page 9]
  507.  
  508. RFC 1749      802.5 Station Source Routing MIB using SMIv2 December 1994
  509.  
  510.  
  511. 8.  Authors' Addresses
  512.  
  513.    Keith McCloghrie
  514.    cisco Systems, Inc.
  515.    170 West Tasman Drive,
  516.    San Jose CA 95134-1706.
  517.  
  518.    Phone: (408) 526-5260
  519.    EMail: kzm@cisco.com
  520.  
  521.  
  522.    Fred Baker
  523.    cisco Systems, Inc.
  524.    519 Lado Drive
  525.    Santa Barbara, CA 93111
  526.  
  527.    Phone: (805) 681-0115
  528.    EMail: fred@cisco.com
  529.  
  530.  
  531.    Eric B. Decker
  532.    cisco Systems, Inc.
  533.    1525 O'Brien Dr.
  534.    Menlo Park, California 94025
  535.  
  536.    Phone: (415) 688-8241
  537.    EMail: cire@cisco.com
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562. McCloghrie, Baker & Decker                                     [Page 10]
  563.  
  564.