home *** CD-ROM | disk | FTP | other *** search
/ Unix System Administration Handbook 1997 October / usah_oct97.iso / rfc / 1600s / rfc1660.txt < prev    next >
Text File  |  1994-07-18  |  17KB  |  564 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                         B. Stewart
  8. Request for Comments: 1660                                  Xyplex, Inc.
  9. Obsoletes: 1318                                                July 1994
  10. Category: Standards Track
  11.  
  12.  
  13.         Definitions of Managed Objects for Parallel-printer-like
  14.                       Hardware Devices using SMIv2
  15.  
  16. Status of this Memo
  17.  
  18.    This document specifies an IAB standards track protocol for the
  19.    Internet community, and requests discussion and suggestions for
  20.    improvements.  Please refer to the current edition of the "IAB
  21.    Official Protocol Standards" for the standardization state and status
  22.    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 ....................    1
  28.    2.1 Object Definitions ........................................    2
  29.    3. Overview ...................................................    2
  30.    3.1 Relationship to Interface MIB .............................    2
  31.    4. Definitions ................................................    3
  32.    5. Acknowledgements ...........................................    9
  33.    6. References .................................................    9
  34.    7. Security Considerations ....................................   10
  35.    8. Author's Address ...........................................   10
  36.  
  37. 1.  Introduction
  38.  
  39.    This memo defines an extension to the Management Information Base
  40.    (MIB) for use with network management protocols in the Internet
  41.    community.  In particular, it defines objects for the management of
  42.    Parallel-printer-like devices.
  43.  
  44. 2.  The SNMPv2 Network Management Framework
  45.  
  46.    The SNMPv2 Network Management Framework consists of four major
  47.    components.  They are:
  48.  
  49.       o    RFC 1442 [1] which defines the SMI, the mechanisms used for
  50.            describing and naming objects for the purpose of management.
  51.  
  52.       o    STD 17, RFC 1213 [2] defines MIB-II, the core set of managed
  53.            objects for the Internet suite of protocols.
  54.  
  55.  
  56.  
  57.  
  58. Stewart                                                         [Page 1]
  59.  
  60. RFC 1660               Parallel-printer-like MIB               July 1994
  61.  
  62.  
  63.       o    RFC 1445 [3] which defines the administrative and other
  64.            architectural aspects of the framework.
  65.  
  66.       o    RFC 1448 [4] which defines the protocol used for network
  67.            access to managed objects.
  68.  
  69.    The Framework permits new objects to be defined for the purpose of
  70.    experimentation and evaluation.
  71.  
  72. 2.1.  Object Definitions
  73.  
  74.    Managed objects are accessed via a virtual information store, termed
  75.    the Management Information Base or MIB.  Objects in the MIB are
  76.    defined using the subset of Abstract Syntax Notation One (ASN.1)
  77.    defined in the SMI.  In particular, each object object type is named
  78.    by an OBJECT IDENTIFIER, an administratively assigned name.  The
  79.    object type together with an object instance serves to uniquely
  80.    identify a specific instantiation of the object.  For human
  81.    convenience, we often use a textual string, termed the descriptor, to
  82.    refer to the object type.
  83.  
  84. 3.  Overview
  85.  
  86.    The Parallel-printer-like Hardware Device MIB applies to interface
  87.    ports that would most probably support the Character MIB.  The most
  88.    common example is Centronics-like printer port.
  89.  
  90.    The Parallel-printer-like Hardware Device MIB is mandatory for all
  91.    systems that have such a hardware port supporting services managed
  92.    through some other MIB.
  93.  
  94.    The Parallel-printer-like Hardware Port MIB includes Centronics-like
  95.    and Data-Products-like parallel physical links with a similar set of
  96.    control signals.
  97.  
  98.    The MIB contains objects that relate to physical layer connections.
  99.  
  100.    The MIB comprises one base object and three tables, detailed in the
  101.    following sections.  The tables contain objects for ports and input
  102.    and output control signals.
  103.  
  104. 3.1.  Relationship to Interface MIB
  105.  
  106.    The Parallel-printer-like MIB is one of many MIBs designed for
  107.    layered use as described in the Interface MIB [5].  In most
  108.    implementations where it is present, it will be in the lowest
  109.    interface sublayer, that is, the Parallel-printer-like MIB represents
  110.    the physical layer, providing service to higher layers such as the
  111.  
  112.  
  113.  
  114. Stewart                                                         [Page 2]
  115.  
  116. RFC 1660               Parallel-printer-like MIB               July 1994
  117.  
  118.  
  119.    Character MIB [6].
  120.  
  121.    Although it is unlikely that a parallel printer port will actually be
  122.    used as a network interface, which is the intent of the Interface
  123.    MIB, the Parallel-printer-like MIB is closely connected to the
  124.    Character MIB, which can share hardware interfaces with network
  125.    operation, and relate to the RS-232 MIB [7].
  126.  
  127.    The Interface MIB's ifTestTable and ifRcvAddressTable are not
  128.    relevant to the Parallel-printer-like MIB.
  129.  
  130.    The Parallel-printer-like MIB is relevant for ifType values para(34)
  131.    and perhaps others.
  132.  
  133.    The Parallel-printer-like MIB requires the conformance groups
  134.    ifGeneralGroup, and ifFixedLengthGroup.
  135.  
  136.    Usefulness of error counters in this MIB depends on the octet
  137.    counters in ifFixedLengthGroup.
  138.  
  139. 4.  Definitions
  140.  
  141.    PARALLEL-MIB DEFINITIONS ::= BEGIN
  142.  
  143.    IMPORTS
  144.        MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
  145.        Counter32, Integer32
  146.            FROM SNMPv2-SMI
  147.        InterfaceIndex
  148.            FROM IF-MIB
  149.        transmission
  150.            FROM RFC1213-MIB
  151.        MODULE-COMPLIANCE, OBJECT-GROUP
  152.            FROM SNMPv2-CONF;
  153.  
  154.  
  155.    para MODULE-IDENTITY
  156.         LAST-UPDATED "9405261700Z"
  157.         ORGANIZATION "IETF Character MIB Working Group"
  158.         CONTACT-INFO
  159.                "        Bob Stewart
  160.                 Postal: Xyplex, Inc.
  161.                         295 Foster Street
  162.                         Littleton, MA 01460
  163.  
  164.                    Tel: 508-952-4816
  165.                    Fax: 508-952-4887
  166.                 E-mail: rlstewart@eng.xyplex.com"
  167.  
  168.  
  169.  
  170. Stewart                                                         [Page 3]
  171.  
  172. RFC 1660               Parallel-printer-like MIB               July 1994
  173.  
  174.  
  175.         DESCRIPTION
  176.                "The MIB module for Parallel-printer-like hardware devices."
  177.        ::= { transmission 34 }
  178.  
  179.  
  180.    -- Generic Parallel-printer-like information
  181.  
  182.    paraNumber OBJECT-TYPE
  183.        SYNTAX Integer32
  184.        MAX-ACCESS read-only
  185.        STATUS current
  186.        DESCRIPTION
  187.            "The number of ports (regardless of their current
  188.            state) in the Parallel-printer-like port table."
  189.        ::= { para 1 }
  190.  
  191.  
  192.    -- the Parallel-printer-like Port table
  193.  
  194.    paraPortTable OBJECT-TYPE
  195.        SYNTAX SEQUENCE OF ParaPortEntry
  196.        MAX-ACCESS not-accessible
  197.        STATUS current
  198.        DESCRIPTION
  199.            "A list of port entries.  The number of entries is
  200.            given by the value of paraNumber."
  201.        ::= { para 2 }
  202.  
  203.    paraPortEntry OBJECT-TYPE
  204.        SYNTAX ParaPortEntry
  205.        MAX-ACCESS not-accessible
  206.        STATUS current
  207.        DESCRIPTION
  208.            "Status and parameter values for a port."
  209.        INDEX { paraPortIndex }
  210.        ::= { paraPortTable 1 }
  211.  
  212.    ParaPortEntry ::=
  213.        SEQUENCE {
  214.            paraPortIndex
  215.                InterfaceIndex,
  216.            paraPortType
  217.                INTEGER,
  218.            paraPortInSigNumber
  219.                Integer32,
  220.            paraPortOutSigNumber
  221.                Integer32
  222.        }
  223.  
  224.  
  225.  
  226. Stewart                                                         [Page 4]
  227.  
  228. RFC 1660               Parallel-printer-like MIB               July 1994
  229.  
  230.  
  231.    paraPortIndex OBJECT-TYPE
  232.        SYNTAX InterfaceIndex
  233.        MAX-ACCESS read-only
  234.        STATUS current
  235.        DESCRIPTION
  236.            "The value of ifIndex for the port.  By convention
  237.            and if possible, hardware port numbers map directly
  238.            to external connectors.  The value for each port must
  239.            remain constant at least from one re-initialization
  240.            of the network management agent to the next."
  241.        ::= { paraPortEntry 1 }
  242.  
  243.    paraPortType OBJECT-TYPE
  244.        SYNTAX INTEGER {
  245.            other(1),
  246.            centronics(2),
  247.            dataproducts(3)
  248.        }
  249.        MAX-ACCESS read-only
  250.        STATUS current
  251.        DESCRIPTION
  252.            "The port's hardware type."
  253.        ::= { paraPortEntry 2 }
  254.  
  255.    paraPortInSigNumber OBJECT-TYPE
  256.        SYNTAX Integer32
  257.        MAX-ACCESS read-only
  258.        STATUS current
  259.        DESCRIPTION
  260.            "The number of input signals for the port in the
  261.            input signal table (paraPortInSigTable).  The table
  262.            contains entries only for those signals the software
  263.            can detect and that are useful to observe."
  264.        ::= { paraPortEntry 3 }
  265.  
  266.    paraPortOutSigNumber OBJECT-TYPE
  267.        SYNTAX Integer32
  268.        MAX-ACCESS read-only
  269.        STATUS current
  270.        DESCRIPTION
  271.            "The number of output signals for the port in the
  272.            output signal table (paraPortOutSigTable).  The
  273.            table contains entries only for those signals the
  274.            software can assert and that are useful to observe."
  275.        ::= { paraPortEntry 4 }
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282. Stewart                                                         [Page 5]
  283.  
  284. RFC 1660               Parallel-printer-like MIB               July 1994
  285.  
  286.  
  287.    -- Parallel-printer-like Input Signal Table
  288.  
  289.    paraInSigTable OBJECT-TYPE
  290.        SYNTAX SEQUENCE OF ParaInSigEntry
  291.        MAX-ACCESS not-accessible
  292.        STATUS current
  293.        DESCRIPTION
  294.            "A list of port input control signal entries."
  295.        ::= { para 3 }
  296.  
  297.    paraInSigEntry OBJECT-TYPE
  298.        SYNTAX ParaInSigEntry
  299.        MAX-ACCESS not-accessible
  300.        STATUS current
  301.        DESCRIPTION
  302.            "Input control signal status for a hardware port."
  303.        INDEX { paraInSigPortIndex, paraInSigName }
  304.        ::= { paraInSigTable 1 }
  305.  
  306.    ParaInSigEntry ::=
  307.        SEQUENCE {
  308.            paraInSigPortIndex
  309.                InterfaceIndex,
  310.            paraInSigName
  311.                INTEGER,
  312.            paraInSigState
  313.                INTEGER,
  314.            paraInSigChanges
  315.                Counter32
  316.        }
  317.  
  318.    paraInSigPortIndex OBJECT-TYPE
  319.        SYNTAX InterfaceIndex
  320.        MAX-ACCESS read-only
  321.        STATUS current
  322.        DESCRIPTION
  323.            "The value of paraPortIndex for the port to which
  324.            this entry belongs."
  325.        ::= { paraInSigEntry 1 }
  326.  
  327.    paraInSigName OBJECT-TYPE
  328.        SYNTAX INTEGER { power(1), online(2), busy(3),
  329.                         paperout(4), fault(5) }
  330.        MAX-ACCESS read-only
  331.        STATUS current
  332.        DESCRIPTION
  333.            "Identification of a hardware signal."
  334.        ::= { paraInSigEntry 2 }
  335.  
  336.  
  337.  
  338. Stewart                                                         [Page 6]
  339.  
  340. RFC 1660               Parallel-printer-like MIB               July 1994
  341.  
  342.  
  343.    paraInSigState OBJECT-TYPE
  344.        SYNTAX INTEGER { none(1), on(2), off(3) }
  345.        MAX-ACCESS read-only
  346.        STATUS current
  347.        DESCRIPTION
  348.            "The current signal state."
  349.        ::= { paraInSigEntry 3 }
  350.  
  351.    paraInSigChanges OBJECT-TYPE
  352.        SYNTAX Counter32
  353.        MAX-ACCESS read-only
  354.        STATUS current
  355.        DESCRIPTION
  356.            "The number of times the signal has changed from
  357.            'on' to 'off' or from 'off' to 'on'."
  358.        ::= { paraInSigEntry 4 }
  359.  
  360.  
  361.    -- Output Signal Table
  362.  
  363.    paraOutSigTable OBJECT-TYPE
  364.        SYNTAX SEQUENCE OF ParaOutSigEntry
  365.        MAX-ACCESS not-accessible
  366.        STATUS current
  367.        DESCRIPTION
  368.            "A list of port output control signal entries."
  369.        ::= { para 4 }
  370.  
  371.    paraOutSigEntry OBJECT-TYPE
  372.        SYNTAX ParaOutSigEntry
  373.        MAX-ACCESS not-accessible
  374.        STATUS current
  375.        DESCRIPTION
  376.            "Output control signal status for a hardware port."
  377.        INDEX { paraOutSigPortIndex, paraOutSigName }
  378.        ::= { paraOutSigTable 1 }
  379.  
  380.    ParaOutSigEntry ::=
  381.        SEQUENCE {
  382.            paraOutSigPortIndex
  383.                InterfaceIndex,
  384.            paraOutSigName
  385.                INTEGER,
  386.            paraOutSigState
  387.                INTEGER,
  388.            paraOutSigChanges
  389.                Counter32
  390.        }
  391.  
  392.  
  393.  
  394. Stewart                                                         [Page 7]
  395.  
  396. RFC 1660               Parallel-printer-like MIB               July 1994
  397.  
  398.  
  399.    paraOutSigPortIndex OBJECT-TYPE
  400.        SYNTAX InterfaceIndex
  401.        MAX-ACCESS read-only
  402.        STATUS current
  403.        DESCRIPTION
  404.            "The value of paraPortIndex for the port to which
  405.            this entry belongs."
  406.        ::= { paraOutSigEntry 1 }
  407.  
  408.    paraOutSigName OBJECT-TYPE
  409.        SYNTAX INTEGER { power(1), online(2), busy(3),
  410.                         paperout(4), fault(5) }
  411.        MAX-ACCESS read-only
  412.        STATUS current
  413.        DESCRIPTION
  414.            "Identification of a hardware signal."
  415.        ::= { paraOutSigEntry 2 }
  416.  
  417.    paraOutSigState OBJECT-TYPE
  418.        SYNTAX INTEGER { none(1), on(2), off(3) }
  419.        MAX-ACCESS read-only
  420.        STATUS current
  421.        DESCRIPTION
  422.            "The current signal state."
  423.        ::= { paraOutSigEntry 3 }
  424.  
  425.    paraOutSigChanges OBJECT-TYPE
  426.        SYNTAX Counter32
  427.        MAX-ACCESS read-only
  428.        STATUS current
  429.        DESCRIPTION
  430.            "The number of times the signal has changed from
  431.            'on' to 'off' or from 'off' to 'on'."
  432.        ::= { paraOutSigEntry 4 }
  433.  
  434.  
  435.    -- conformance information
  436.  
  437.    paraConformance OBJECT IDENTIFIER ::= { para 5 }
  438.  
  439.    paraGroups      OBJECT IDENTIFIER ::= { paraConformance 1 }
  440.    paraCompliances OBJECT IDENTIFIER ::= { paraConformance 2 }
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450. Stewart                                                         [Page 8]
  451.  
  452. RFC 1660               Parallel-printer-like MIB               July 1994
  453.  
  454.  
  455.    -- compliance statements
  456.  
  457.    paraCompliance MODULE-COMPLIANCE
  458.        STATUS  current
  459.        DESCRIPTION
  460.                "The compliance statement for SNMPv2 entities
  461.                which have Parallel-printer-like hardware
  462.                interfaces."
  463.  
  464.        MODULE  -- this module
  465.            MANDATORY-GROUPS { paraGroup }
  466.        ::= { paraCompliances 1 }
  467.  
  468.  
  469.    -- units of conformance
  470.  
  471.    paraGroup    OBJECT-GROUP
  472.        OBJECTS { paraNumber, paraPortIndex, paraPortType,
  473.                  paraPortInSigNumber, paraPortOutSigNumber,
  474.                  paraInSigPortIndex, paraInSigName,
  475.                  paraInSigState, paraInSigChanges,
  476.                  paraOutSigPortIndex, paraOutSigName,
  477.                  paraOutSigState, paraOutSigChanges }
  478.        STATUS  current
  479.        DESCRIPTION
  480.                "A collection of objects providing information
  481.                 applicable to all Parallel-printer-like interfaces."
  482.        ::= { paraGroups 1 }
  483.  
  484.    END
  485.  
  486. 5.  Acknowledgements
  487.  
  488.    This memo was produced by the IETF Character MIB Working Group.
  489.  
  490. 6.  References
  491.  
  492.    [1] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure
  493.        of Management Information for version 2 of the Simple Network
  494.        Management Protocol (SNMPv2)", RFC 1442, SNMP Research,Inc.,
  495.        Hughes LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon
  496.        University, April 1993.
  497.  
  498.    [2] McCloghrie, K., and M. Rose, Editors, "Management Information
  499.        Base for Network Management of TCP/IP-based internets: MIB-II",
  500.        STD 17, RFC 1213, Hughes LAN Systems, Performance Systems
  501.        International, March 1991.
  502.  
  503.  
  504.  
  505.  
  506. Stewart                                                         [Page 9]
  507.  
  508. RFC 1660               Parallel-printer-like MIB               July 1994
  509.  
  510.  
  511.    [3] Galvin, J., and K. McCloghrie, "Administrative Model for version
  512.        2 of the Simple Network Management Protocol (SNMPv2)", RFC 1445,
  513.        Trusted Information Systems, Hughes LAN Systems, April 1993.
  514.  
  515.    [4] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol
  516.        Operations for version 2 of the Simple Network Management
  517.        Protocol (SNMPv2)", RFC 1448, SNMP Research,Inc., Hughes LAN
  518.        Systems, Dover Beach Consulting, Inc., Carnegie Mellon
  519.        University, April 1993.
  520.  
  521.    [5] McCloghrie, K., and F. Kastenholz, "Evolution of the Interfaces
  522.        Group of MIB-II", RFC 1573, Hughes LAN Systems, FTP Software,
  523.        January 1994.
  524.  
  525.    [6] Stewart, B., "Definitions of Managed Objects for Character Stream
  526.        Devices using SMIv2", RFC 1658, Xyplex, Inc., July 1994.
  527.  
  528.    [7] Stewart, B., "Definitions of Managed Objects for RS-232-like
  529.        Devices using SMIv2", RFC 1659, Xyplex, Inc., July 1994.
  530.  
  531. 7.  Security Considerations
  532.  
  533.    Security issues are not discussed in this memo.
  534.  
  535. 8.  Author's Address
  536.  
  537.    Bob Stewart
  538.    Xyplex, Inc.
  539.    295 Foster Street
  540.    Littleton, MA 01460
  541.  
  542.    Phone: 508-952-4816
  543.    Fax: 508-952-4887
  544.    EMail: rlstewart@eng.xyplex.com
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562. Stewart                                                        [Page 10]
  563.  
  564.