home *** CD-ROM | disk | FTP | other *** search
/ Unix System Administration Handbook 1997 October / usah_oct97.iso / rfc / 1300s / rfc1318.txt < prev    next >
Text File  |  1992-04-14  |  20KB  |  619 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                 B. Stewart, Editor
  8. Request for Comments: 1318                                  Xyplex, Inc.
  9.                                                               April 1992
  10.  
  11.  
  12.                      Definitions of Managed Objects
  13.                for Parallel-printer-like Hardware Devices
  14.  
  15. Status of this Memo
  16.  
  17.    This document specifies an IAB standards track protocol for the
  18.    Internet community, and requests discussion and suggestions for
  19.    improvements.  Please refer to the current edition of the "IAB
  20.    Official Protocol Standards" for the standardization state and status
  21.    of this protocol.  Distribution of this memo is unlimited.
  22.  
  23. 1.  Abstract
  24.  
  25.    This memo defines a portion of the Management Information Base (MIB)
  26.    for use with network management protocols in TCP/IP based internets.
  27.    In particular, it defines objects for the management of
  28.    parallel-printer-like devices.
  29.  
  30. 2.  The Network Management Framework
  31.  
  32.    The Internet-standard Network Management Framework consists
  33.    of three components.  They are:
  34.  
  35.    RFC 1155 which defines the SMI, the mechanisms used for
  36.    describing and naming objects for the purpose of management.
  37.    RFC 1212 defines a more concise description mechanism, which
  38.    is wholly consistent with the SMI.
  39.  
  40.    RFC 1156 which defines MIB-I, the core set of managed
  41.    objects for the Internet suite of protocols.  RFC 1213,
  42.    defines MIB-II, an evolution of MIB-I based on
  43.    implementation experience and new operational requirements.
  44.  
  45.    RFC 1157 which defines the SNMP, the protocol used for
  46.    network access to managed objects.
  47.  
  48.    The Framework permits new objects to be defined for the
  49.    purpose of experimentation and evaluation.
  50.  
  51. 3.  Objects
  52.  
  53.    Managed objects are accessed via a virtual information
  54.    store, termed the Management Information Base or MIB.
  55.  
  56.  
  57.  
  58. Character MIB Working Group                                     [Page 1]
  59.  
  60. RFC 1318               PARALLEL-PRINTER-LIKE-MIB              April 1992
  61.  
  62.  
  63.    Objects in the MIB are defined using the subset of Abstract
  64.    Syntax Notation One (ASN.1) [7] defined in the SMI.  In
  65.    particular, each object has a name, a syntax, and an
  66.    encoding.  The name is an object identifier, an
  67.    administratively assigned name, which specifies an object
  68.    type.
  69.  
  70.    The object type together with an object instance serves to
  71.    uniquely identify a specific instantiation of the object.
  72.    For human convenience, we often use a textual string, termed
  73.    the OBJECT DESCRIPTOR, to also refer to the object type.
  74.  
  75.    The syntax of an object type defines the abstract data
  76.    structure corresponding to that object type.  The ASN.1
  77.    language is used for this purpose.  However, the SMI [3]
  78.    purposely restricts the ASN.1 constructs which may be used.
  79.    These restrictions are explicitly made for simplicity.
  80.  
  81.    The encoding of an object type is simply how that object
  82.    type is represented using the object type's syntax.
  83.    Implicitly tied to the notion of an object type's syntax and
  84.    encoding is how the object type is represented when being
  85.    transmitted on the network.
  86.  
  87.    The SMI specifies the use of the basic encoding rules of
  88.    ASN.1 [8], subject to the additional requirements imposed by
  89.    the SNMP.
  90.  
  91. 3.1.  Format of Definitions
  92.  
  93.    Section 5 contains the specification of all object types
  94.    contained in this MIB module.  The object types are defined
  95.    using the conventions defined in the SMI, as amended by the
  96.    extensions specified in [9,10].
  97.  
  98. 4.  Overview
  99.  
  100.    The Parallel-printer-like Hardware Device MIB applies to
  101.    interface ports that might logically support the Interface
  102.    MIB, a Transmission MIB, or the Character MIB (most likely
  103.    the latter).  The most common example is a Centronics or
  104.    Data Products type parallel printer port.
  105.  
  106.    The Parallel-printer-like MIB is one of a set of MIBs
  107.    designed for complementary use.  At this writing, the set
  108.    comprises:
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Character MIB Working Group                                     [Page 2]
  115.  
  116. RFC 1318               PARALLEL-PRINTER-LIKE-MIB              April 1992
  117.  
  118.  
  119.         Character MIB
  120.         PPP MIB
  121.         RS-232-like MIB
  122.         Parallel-printer-like MIB
  123.  
  124.    The RS-232-like MIB and the Parallel-printer-like MIB
  125.    represent the physical layer, providing service to higher
  126.    layers such as the Character MIB or PPP MIB.  Further MIBs
  127.    may appear above these.
  128.  
  129.    The following diagram shows two possible "MIB stacks", each
  130.    using the RS-232-like MIB.
  131.  
  132.                                     .-----------------.
  133.          .-----------------.        |  Standard MIB   |
  134.          |   Telnet MIB    |        | Interface Group |
  135.          |-----------------|        |-----------------|
  136.          |  Character MIB  |        |     PPP MIB     |
  137.          |-----------------|        |-----------------|
  138.          | RS-232-like MIB |        | RS-232-like MIB |
  139.          `-----------------'        `-----------------'
  140.  
  141.    The intent of the model is for the physical-level MIBs to
  142.    represent the lowest level, regardless of the higher level
  143.    that may be using it.  In turn, separate higher level MIBs
  144.    represent specific applications, such as a terminal (the
  145.    Character MIB) or a network connection (the PPP MIB).
  146.  
  147.    The Parallel-printer-like MIB is mandatory for all systems
  148.    that have such a hardware port supporting services managed
  149.    through some other MIB, for example, the Character MIB.
  150.  
  151.    The Parallel-printer-like MIB includes multiple similar
  152.    types of hardware, and as a result contains objects not
  153.    applicable to all of those types.  Such objects are in a
  154.    separate branch of the MIB, which is required when
  155.    applicable and otherwise absent.
  156.  
  157.    The Parallel-printer-like MIB includes Centronics, Data
  158.    Products, and other parallel physical links with a similar
  159.    set of control signals.
  160.  
  161.    The MIB contains objects that relate to physical layer
  162.    connections.  Such connections may provide interesting
  163.    hardware signals (other than for basic data transfer), such
  164.    as Power and PaperOut.
  165.  
  166.    The MIB comprises one base object and three tables, detailed
  167.  
  168.  
  169.  
  170. Character MIB Working Group                                     [Page 3]
  171.  
  172. RFC 1318               PARALLEL-PRINTER-LIKE-MIB              April 1992
  173.  
  174.  
  175.    in the following sections.  The tables contain objects for
  176.    ports and input and output control signals.
  177.  
  178. 5.  Definitions
  179.  
  180.                     RFC1318-MIB DEFINITIONS ::= BEGIN
  181.  
  182.                     IMPORTS
  183.                             Counter
  184.                                     FROM RFC1155-SMI
  185.                             transmission
  186.                                     FROM RFC1213-MIB
  187.                             OBJECT-TYPE
  188.                                     FROM RFC-1212;
  189.  
  190.             -- this is the MIB module for Parallel-printer-like
  191.             -- hardware devices
  192.  
  193.             para    OBJECT IDENTIFIER ::= { transmission 34 }
  194.  
  195.             -- the generic Parallel-printer-like group
  196.  
  197.             -- Implementation of this group is mandatory for all
  198.             -- systems that have Parallel-printer-like hardware
  199.             -- ports supporting higher level services such as
  200.             -- character streams
  201.  
  202.             paraNumber OBJECT-TYPE
  203.                 SYNTAX INTEGER
  204.                 ACCESS read-only
  205.                 STATUS mandatory
  206.                 DESCRIPTION
  207.                     "The number of ports (regardless of their current
  208.                     state) in the Parallel-printer-like port table."
  209.                 ::= { para 1 }
  210.  
  211.  
  212.             -- the Parallel-printer-like Port table
  213.  
  214.             paraPortTable OBJECT-TYPE
  215.                 SYNTAX SEQUENCE OF ParaPortEntry
  216.                 ACCESS not-accessible
  217.                 STATUS mandatory
  218.                 DESCRIPTION
  219.                     "A list of port entries.  The number of entries is
  220.                     given by the value of paraNumber."
  221.                 ::= { para 2 }
  222.  
  223.  
  224.  
  225.  
  226. Character MIB Working Group                                     [Page 4]
  227.  
  228. RFC 1318               PARALLEL-PRINTER-LIKE-MIB              April 1992
  229.  
  230.  
  231.             paraPortEntry OBJECT-TYPE
  232.                 SYNTAX ParaPortEntry
  233.                 ACCESS not-accessible
  234.                 STATUS mandatory
  235.                 DESCRIPTION
  236.                     "Status and parameter values for a port."
  237.                 INDEX { paraPortIndex }
  238.                 ::= { paraPortTable 1 }
  239.  
  240.             ParaPortEntry ::=
  241.                 SEQUENCE {
  242.                     paraPortIndex
  243.                         INTEGER,
  244.                     paraPortType
  245.                         INTEGER,
  246.                     paraPortInSigNumber
  247.                         INTEGER,
  248.                     paraPortOutSigNumber
  249.                         INTEGER
  250.                 }
  251.  
  252.             paraPortIndex OBJECT-TYPE
  253.                 SYNTAX INTEGER
  254.                 ACCESS read-only
  255.                 STATUS mandatory
  256.                 DESCRIPTION
  257.                     "A unique value for each port.  Its value ranges
  258.                     between 1 and the value of paraNumber.  By
  259.                     convention and if possible, hardware port numbers
  260.                     map directly to external connectors.  The value for
  261.                     each port must remain constant at least from one
  262.                     re-initialization of the network management agent to
  263.                     the next."
  264.                 ::= { paraPortEntry 1 }
  265.  
  266.             paraPortType OBJECT-TYPE
  267.                 SYNTAX INTEGER {
  268.                     other(1),
  269.                     centronics(2),
  270.                     dataproducts(3)
  271.                 }
  272.                 ACCESS read-only
  273.                 STATUS mandatory
  274.                 DESCRIPTION
  275.                     "The port's hardware type."
  276.                 ::= { paraPortEntry 2 }
  277.  
  278.             paraPortInSigNumber OBJECT-TYPE
  279.  
  280.  
  281.  
  282. Character MIB Working Group                                     [Page 5]
  283.  
  284. RFC 1318               PARALLEL-PRINTER-LIKE-MIB              April 1992
  285.  
  286.  
  287.                 SYNTAX INTEGER
  288.                 ACCESS read-only
  289.                 STATUS mandatory
  290.                 DESCRIPTION
  291.                     "The number of input signals for the port in the
  292.                     input signal table (paraPortInSigTable).  The table
  293.                     contains entries only for those signals the software
  294.                     can detect."
  295.                 ::= { paraPortEntry 3 }
  296.  
  297.             paraPortOutSigNumber OBJECT-TYPE
  298.                 SYNTAX INTEGER
  299.                 ACCESS read-only
  300.                 STATUS mandatory
  301.                 DESCRIPTION
  302.                     "The number of output signals for the port in the
  303.                     output signal table (paraPortOutSigTable).  The
  304.                     table contains entries only for those signals the
  305.                     software can assert."
  306.                 ::= { paraPortEntry 4 }
  307.  
  308.  
  309.             -- the Input Signal table
  310.  
  311.             paraInSigTable OBJECT-TYPE
  312.                 SYNTAX SEQUENCE OF ParaInSigEntry
  313.                 ACCESS not-accessible
  314.                 STATUS mandatory
  315.                 DESCRIPTION
  316.                     "A list of port input control signal entries."
  317.                 ::= { para 3 }
  318.  
  319.             paraInSigEntry OBJECT-TYPE
  320.                 SYNTAX ParaInSigEntry
  321.                 ACCESS not-accessible
  322.                 STATUS mandatory
  323.                 DESCRIPTION
  324.                     "Input control signal status for a hardware port."
  325.                 INDEX { paraInSigPortIndex, paraInSigName }
  326.                 ::= { paraInSigTable 1 }
  327.  
  328.             ParaInSigEntry ::=
  329.                 SEQUENCE {
  330.                     paraInSigPortIndex
  331.                         INTEGER,
  332.                     paraInSigName
  333.                         INTEGER,
  334.                     paraInSigState
  335.  
  336.  
  337.  
  338. Character MIB Working Group                                     [Page 6]
  339.  
  340. RFC 1318               PARALLEL-PRINTER-LIKE-MIB              April 1992
  341.  
  342.  
  343.                         INTEGER,
  344.                     paraInSigChanges
  345.                         Counter
  346.                 }
  347.  
  348.             paraInSigPortIndex OBJECT-TYPE
  349.                 SYNTAX INTEGER
  350.                 ACCESS read-only
  351.                 STATUS mandatory
  352.                 DESCRIPTION
  353.                     "The value of paraPortIndex for the port to which
  354.                     this entry belongs."
  355.                 ::= { paraInSigEntry 1 }
  356.  
  357.             paraInSigName OBJECT-TYPE
  358.                 SYNTAX INTEGER { power(1), online(2), busy(3),
  359.                                  paperout(4), fault(5) }
  360.                 ACCESS read-only
  361.                 STATUS mandatory
  362.                 DESCRIPTION
  363.                     "Identification of a hardware signal."
  364.                 ::= { paraInSigEntry 2 }
  365.  
  366.             paraInSigState OBJECT-TYPE
  367.                 SYNTAX INTEGER { none(1), on(2), off(3) }
  368.                 ACCESS read-only
  369.                 STATUS mandatory
  370.                 DESCRIPTION
  371.                     "The current signal state."
  372.                 ::= { paraInSigEntry 3 }
  373.  
  374.             paraInSigChanges OBJECT-TYPE
  375.                 SYNTAX Counter
  376.                 ACCESS read-only
  377.                 STATUS mandatory
  378.                 DESCRIPTION
  379.                     "The number of times the signal has changed from
  380.                     'on' to 'off' or from 'off' to 'on'."
  381.                 ::= { paraInSigEntry 4 }
  382.  
  383.  
  384.             -- the Output Signal table
  385.  
  386.             paraOutSigTable OBJECT-TYPE
  387.                 SYNTAX SEQUENCE OF ParaOutSigEntry
  388.                 ACCESS not-accessible
  389.                 STATUS mandatory
  390.                 DESCRIPTION
  391.  
  392.  
  393.  
  394. Character MIB Working Group                                     [Page 7]
  395.  
  396. RFC 1318               PARALLEL-PRINTER-LIKE-MIB              April 1992
  397.  
  398.  
  399.                     "A list of port output control signal entries."
  400.                 ::= { para 4 }
  401.  
  402.             paraOutSigEntry OBJECT-TYPE
  403.                 SYNTAX ParaOutSigEntry
  404.                 ACCESS not-accessible
  405.                 STATUS mandatory
  406.                 DESCRIPTION
  407.                     "Output control signal status for a hardware port."
  408.                 INDEX { paraOutSigPortIndex, paraOutSigName }
  409.                 ::= { paraOutSigTable 1 }
  410.  
  411.             ParaOutSigEntry ::=
  412.                 SEQUENCE {
  413.                     paraOutSigPortIndex
  414.                         INTEGER,
  415.                     paraOutSigName
  416.                         INTEGER,
  417.                     paraOutSigState
  418.                         INTEGER,
  419.                     paraOutSigChanges
  420.                         Counter
  421.                 }
  422.  
  423.             paraOutSigPortIndex OBJECT-TYPE
  424.                 SYNTAX INTEGER
  425.                 ACCESS read-only
  426.                 STATUS mandatory
  427.                 DESCRIPTION
  428.                     "The value of paraPortIndex for the port to which
  429.                     this entry belongs."
  430.                 ::= { paraOutSigEntry 1 }
  431.  
  432.             paraOutSigName OBJECT-TYPE
  433.                 SYNTAX INTEGER { power(1), online(2), busy(3),
  434.                                  paperout(4), fault(5) }
  435.                 ACCESS read-only
  436.                 STATUS mandatory
  437.                 DESCRIPTION
  438.                     "Identification of a hardware signal."
  439.                 ::= { paraOutSigEntry 2 }
  440.  
  441.             paraOutSigState OBJECT-TYPE
  442.                 SYNTAX INTEGER { none(1), on(2), off(3) }
  443.                 ACCESS read-only
  444.                 STATUS mandatory
  445.                 DESCRIPTION
  446.                     "The current signal state."
  447.  
  448.  
  449.  
  450. Character MIB Working Group                                     [Page 8]
  451.  
  452. RFC 1318               PARALLEL-PRINTER-LIKE-MIB              April 1992
  453.  
  454.  
  455.                 ::= { paraOutSigEntry 3 }
  456.  
  457.             paraOutSigChanges OBJECT-TYPE
  458.                 SYNTAX Counter
  459.                 ACCESS read-only
  460.                 STATUS mandatory
  461.                 DESCRIPTION
  462.                     "The number of times the signal has changed from
  463.                     'on' to 'off' or from 'off' to 'on'."
  464.                 ::= { paraOutSigEntry 4 }
  465.  
  466.             END
  467.  
  468. 6.  Acknowledgements
  469.  
  470.    Based on several private MIBs, this document was produced by the
  471.    Character MIB Working Group:
  472.  
  473.       Anne Ambler, Spider
  474.       Charles Bazaar, Emulex
  475.       Christopher Bucci, Datability
  476.       Anthony Chung, Hughes LAN Systems
  477.       George Conant, Xyplex
  478.       John Cook, Chipcom
  479.       James Davin, MIT-LCS
  480.       Shawn Gallagher, DEC
  481.       Tom Grant, Xylogics
  482.       Frank Huang, Emulex
  483.       David Jordan, Emulex
  484.       Satish Joshi, SynOptics
  485.       Frank Kastenholz, Clearpoint
  486.       Ken Key, University of Tennessee
  487.       Jim Kinder, Fibercom
  488.       Rajeev Kochhar, 3Com
  489.       John LoVerso, Xylogics
  490.       Keith McCloghrie, Hughes LAN Systems
  491.       Donald Merritt, BRL
  492.       David Perkins, 3Com
  493.       Jim Reinstedler, Ungerman-Bass
  494.       Marshall Rose, PSI
  495.       Ron Strich, SSDS
  496.       Dean Throop, DG
  497.       Bill Townsend, Xylogics
  498.       Jesse Walker, DEC
  499.       David Waitzman, BBN
  500.       Bill Westfield, cisco
  501.  
  502.  
  503.  
  504.  
  505.  
  506. Character MIB Working Group                                     [Page 9]
  507.  
  508. RFC 1318               PARALLEL-PRINTER-LIKE-MIB              April 1992
  509.  
  510.  
  511. 7.  References
  512.  
  513.    [1] Cerf, V., "IAB Recommendations for the Development of Internet
  514.        Network Management Standards", RFC 1052, NRI, April 1988.
  515.  
  516.    [2] Cerf, V., "Report of the Second Ad Hoc Network Management Review
  517.        Group", RFC 1109, NRI, August 1989.
  518.  
  519.    [3] Rose M., and K. McCloghrie, "Structure and Identification of
  520.        Management Information for TCP/IP-based internets", RFC 1155,
  521.        Performance Systems International, Hughes LAN Systems, May 1990.
  522.  
  523.    [4] McCloghrie K., and M. Rose, "Management Information Base for
  524.        Network Management of TCP/IP-based internets", RFC 1156, Hughes
  525.        LAN Systems, Performance Systems International, May 1990.
  526.  
  527.    [5] Case, J., Fedor, M., Schoffstall, M., and J. Davin, Simple
  528.        Network Management Protocol", RFC 1157, SNMP Research,
  529.        Performance Systems International, Performance Systems
  530.        International, MIT Laboratory for Computer Science, May 1990.
  531.  
  532.    [6] McCloghrie K., and M. Rose, Editors, "Management Information Base
  533.        for Network Management of TCP/IP-based internets", RFC 1213,
  534.        Performance Systems International, March 1991.
  535.  
  536.    [7] Information processing systems - Open Systems Interconnection -
  537.        Specification of Abstract Syntax Notation One (ASN.1),
  538.        International Organization for Standardization, International
  539.        Standard 8824, December 1987.
  540.  
  541.    [8] Information processing systems - Open Systems Interconnection -
  542.        Specification of Basic Encoding Rules for Abstract Notation One
  543.        (ASN.1), International Organization for Standardization,
  544.        International Standard 8825, December 1987.
  545.  
  546.    [9] Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  547.        RFC 1212, Performance Systems International, Hughes LAN Systems,
  548.        March 1991.
  549.  
  550.   [10] Rose, M., Editor, "A Convention for Defining Traps for use with
  551.        the SNMP", RFC 1215, Performance Systems International, March
  552.        1991.
  553.  
  554. 8.  Security Considerations
  555.  
  556.    Security issues are not discussed in this memo.
  557.  
  558.  
  559.  
  560.  
  561.  
  562. Character MIB Working Group                                    [Page 10]
  563.  
  564. RFC 1318               PARALLEL-PRINTER-LIKE-MIB              April 1992
  565.  
  566.  
  567. 9.  Author's Address
  568.  
  569.    Bob Stewart
  570.    Xyplex, Inc.
  571.    330 Codman Hill Road
  572.    Boxborough, MA 01719
  573.  
  574.    Phone: (508) 264-9900
  575.    EMail: rlstewart@eng.xyplex.com
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618. Character MIB Working Group                                    [Page 11]
  619.