home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / rfc / 3 / rfc1659.txt < prev    next >
Encoding:
Text File  |  2003-06-11  |  35.6 KB  |  1,180 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                         B. Stewart
  8. Request for Comments: 1659                                  Xyplex, Inc.
  9. Obsoletes: 1317                                                July 1994
  10. Category: Standards Track
  11.  
  12.  
  13.     Definitions of Managed Objects for RS-232-like Hardware Devices
  14.                               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 .....................    1
  28.    2.1 Object Definitions .........................................    2
  29.    3. Overview ....................................................    2
  30.    3.1 Relationship to Interface MIB ..............................    3
  31.    4. Definitions .................................................    3
  32.    5. Acknowledgements ............................................   20
  33.    6. References ..................................................   20
  34.    7. Security Considerations .....................................   21
  35.    8. Author's Address ............................................   21
  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.    RS-232-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 1659                    RS-232-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 RS-232-like Hardware Device MIB applies to interface ports that
  87.    might logically support the Interface MIB, a Transmission MIB, or the
  88.    Character MIB.  The most common example is an RS-232 port with modem
  89.    signals.
  90.  
  91.    The RS-232-like Hardware Device MIB is mandatory for all systems that
  92.    have such a hardware port supporting services managed through some
  93.    other MIB.
  94.  
  95.    The MIB includes multiple similar types of hardware, and as a result
  96.    contains objects not applicable to all of those types.  The
  97.    compliance definitions herein thus have a general group for all
  98.    implementations, and separate groups for the different types of
  99.    ports, such as asynchronous and synchronous.
  100.  
  101.    The RS-232-like Hardware Port MIB includes RS-232, RS-422, RS-423,
  102.    V.35, and other asynchronous or synchronous, serial physical links
  103.    with a similar set of control signals.
  104.  
  105.    The MIB contains objects that relate to physical layer connections.
  106.    Such connections may provide interesting hardware signals (other than
  107.    for basic data transfer), such as RNG and DCD.  Hardware ports also
  108.    have such attributes as speed and bits per character.
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Stewart                                                         [Page 2]
  115.  
  116. RFC 1659                    RS-232-like MIB                    July 1994
  117.  
  118.  
  119.    The MIB comprises one base object and four tables, detailed in the
  120.    following sections.  The tables contain objects for all ports,
  121.    asynchronous ports, and input and output control signals.
  122.  
  123. 3.1.  Relationship to Interface MIB
  124.  
  125.    The RS-232-like MIB is one of many MIBs designed for layered use as
  126.    described in the Interface MIB [5].  In most implementations where it
  127.    is present, it will be in the lowest interface sublayer, that is, the
  128.    RS-232-like MIB represents the physical layer, providing service to
  129.    higher layers such as the Character MIB [6] or PPP MIB [7].
  130.  
  131.    The Interface MIB's ifTestTable and ifRcvAddressTable are not
  132.    relevant to the RS-232-like MIB.
  133.  
  134.    The RS-232-like MIB is relevant for ifType values rs232(33), v35(45),
  135.    and perhaps others.
  136.  
  137.    The RS-232-like MIB requires the conformance groups ifGeneralGroup,
  138.    and ifFixedLengthGroup.
  139.  
  140.    The value of ifSpeed is the same as rs232PortOutSpeed.
  141.  
  142.    Usefulness of error counters in this MIB depends on the octet
  143.    counters in ifFixedLengthGroup.
  144.  
  145. 4.  Definitions
  146.  
  147.    RS-232-MIB DEFINITIONS ::= BEGIN
  148.  
  149.    IMPORTS
  150.        MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
  151.        Counter32, Integer32
  152.            FROM SNMPv2-SMI
  153.        InterfaceIndex
  154.            FROM IF-MIB
  155.        transmission
  156.            FROM RFC1213-MIB
  157.        MODULE-COMPLIANCE, OBJECT-GROUP
  158.            FROM SNMPv2-CONF;
  159.  
  160.  
  161.    rs232 MODULE-IDENTITY
  162.        LAST-UPDATED "9405261700Z"
  163.        ORGANIZATION "IETF Character MIB Working Group"
  164.        CONTACT-INFO
  165.                "        Bob Stewart
  166.                 Postal: Xyplex, Inc.
  167.  
  168.  
  169.  
  170. Stewart                                                         [Page 3]
  171.  
  172. RFC 1659                    RS-232-like MIB                    July 1994
  173.  
  174.  
  175.                         295 Foster Street
  176.                         Littleton, MA 01460
  177.  
  178.                    Tel: 508-952-4816
  179.                    Fax: 508-952-4887
  180.                 E-mail: rlstewart@eng.xyplex.com"
  181.        DESCRIPTION
  182.                "The MIB module for RS-232-like hardware devices."
  183.        ::= { transmission 33 }
  184.  
  185.  
  186.    -- Generic RS-232-like information
  187.  
  188.    rs232Number OBJECT-TYPE
  189.        SYNTAX Integer32
  190.        MAX-ACCESS read-only
  191.        STATUS current
  192.        DESCRIPTION
  193.            "The number of ports (regardless of their current
  194.            state) in the RS-232-like general port table."
  195.        ::= { rs232 1 }
  196.  
  197.  
  198.    -- RS-232-like General Port Table
  199.  
  200.    rs232PortTable OBJECT-TYPE
  201.        SYNTAX SEQUENCE OF Rs232PortEntry
  202.        MAX-ACCESS not-accessible
  203.        STATUS current
  204.        DESCRIPTION
  205.            "A list of port entries.  The number of entries is
  206.            given by the value of rs232Number."
  207.        ::= { rs232 2 }
  208.  
  209.    rs232PortEntry OBJECT-TYPE
  210.        SYNTAX Rs232PortEntry
  211.        MAX-ACCESS not-accessible
  212.        STATUS current
  213.        DESCRIPTION
  214.            "Status and parameter values for a port."
  215.        INDEX { rs232PortIndex }
  216.        ::= { rs232PortTable 1 }
  217.  
  218.    Rs232PortEntry ::=
  219.        SEQUENCE {
  220.            rs232PortIndex
  221.                InterfaceIndex,
  222.            rs232PortType
  223.  
  224.  
  225.  
  226. Stewart                                                         [Page 4]
  227.  
  228. RFC 1659                    RS-232-like MIB                    July 1994
  229.  
  230.  
  231.                INTEGER,
  232.            rs232PortInSigNumber
  233.                Integer32,
  234.            rs232PortOutSigNumber
  235.                Integer32,
  236.            rs232PortInSpeed
  237.                Integer32,
  238.            rs232PortOutSpeed
  239.                Integer32,
  240.            rs232PortInFlowType
  241.                INTEGER,
  242.            rs232PortOutFlowType
  243.                INTEGER
  244.        }
  245.  
  246.    rs232PortIndex OBJECT-TYPE
  247.        SYNTAX InterfaceIndex
  248.        MAX-ACCESS read-only
  249.        STATUS current
  250.        DESCRIPTION
  251.            "The value of ifIndex for the port.  By convention
  252.            and if possible, hardware port numbers map directly
  253.            to external connectors.  The value for each port must
  254.            remain constant at least from one re-initialization
  255.            of the network management agent to the next."
  256.        ::= { rs232PortEntry 1 }
  257.  
  258.    rs232PortType OBJECT-TYPE
  259.        SYNTAX INTEGER { other(1), rs232(2), rs422(3),
  260.                         rs423(4), v35(5), x21(6) }
  261.        MAX-ACCESS read-only
  262.        STATUS current
  263.        DESCRIPTION
  264.            "The port's hardware type."
  265.        ::= { rs232PortEntry 2 }
  266.  
  267.    rs232PortInSigNumber OBJECT-TYPE
  268.        SYNTAX Integer32
  269.        MAX-ACCESS read-only
  270.        STATUS current
  271.        DESCRIPTION
  272.            "The number of input signals for the port in the
  273.            input signal table (rs232PortInSigTable).  The table
  274.            contains entries only for those signals the software
  275.            can detect and that are useful to observe."
  276.        ::= { rs232PortEntry 3 }
  277.  
  278.  
  279.  
  280.  
  281.  
  282. Stewart                                                         [Page 5]
  283.  
  284. RFC 1659                    RS-232-like MIB                    July 1994
  285.  
  286.  
  287.    rs232PortOutSigNumber OBJECT-TYPE
  288.        SYNTAX Integer32
  289.        MAX-ACCESS read-only
  290.        STATUS current
  291.        DESCRIPTION
  292.            "The number of output signals for the port in the
  293.            output signal table (rs232PortOutSigTable).  The
  294.            table contains entries only for those signals the
  295.            software can assert and that are useful to observe."
  296.        ::= { rs232PortEntry 4 }
  297.  
  298.    rs232PortInSpeed OBJECT-TYPE
  299.        SYNTAX Integer32
  300.        MAX-ACCESS read-write
  301.        STATUS current
  302.        DESCRIPTION
  303.            "The port's input speed in bits per second.  Note that
  304.            non-standard values, such as 9612, are probably not allowed
  305.            on most implementations."
  306.        ::= { rs232PortEntry 5 }
  307.  
  308.    rs232PortOutSpeed OBJECT-TYPE
  309.        SYNTAX Integer32
  310.        MAX-ACCESS read-write
  311.        STATUS current
  312.        DESCRIPTION
  313.            "The port's output speed in bits per second.  Note that
  314.            non-standard values, such as 9612, are probably not allowed
  315.            on most implementations."
  316.        ::= { rs232PortEntry 6 }
  317.  
  318.    rs232PortInFlowType OBJECT-TYPE
  319.        SYNTAX INTEGER { none(1), ctsRts(2), dsrDtr(3) }
  320.        MAX-ACCESS read-write
  321.        STATUS current
  322.        DESCRIPTION
  323.            "The port's type of input flow control.  'none'
  324.            indicates no flow control at this level.
  325.            'ctsRts' and 'dsrDtr' indicate use of the indicated
  326.            hardware signals."
  327.        ::= { rs232PortEntry 7 }
  328.  
  329.    rs232PortOutFlowType OBJECT-TYPE
  330.        SYNTAX INTEGER { none(1), ctsRts(2), dsrDtr(3) }
  331.        MAX-ACCESS read-write
  332.        STATUS current
  333.        DESCRIPTION
  334.            "The port's type of output flow control.  'none'
  335.  
  336.  
  337.  
  338. Stewart                                                         [Page 6]
  339.  
  340. RFC 1659                    RS-232-like MIB                    July 1994
  341.  
  342.  
  343.            indicates no flow control at this level.
  344.            'ctsRts' and 'dsrDtr' indicate use of the indicated
  345.            hardware signals."
  346.        ::= { rs232PortEntry 8 }
  347.  
  348.  
  349.    -- RS-232-like Asynchronous Port Table
  350.  
  351.    rs232AsyncPortTable OBJECT-TYPE
  352.        SYNTAX SEQUENCE OF Rs232AsyncPortEntry
  353.        MAX-ACCESS not-accessible
  354.        STATUS current
  355.        DESCRIPTION
  356.            "A list of asynchronous port entries.  Entries need
  357.            not exist for synchronous ports."
  358.        ::= { rs232 3 }
  359.  
  360.    rs232AsyncPortEntry OBJECT-TYPE
  361.        SYNTAX Rs232AsyncPortEntry
  362.        MAX-ACCESS not-accessible
  363.        STATUS current
  364.        DESCRIPTION
  365.            "Status and parameter values for an asynchronous
  366.            port."
  367.        INDEX { rs232AsyncPortIndex }
  368.        ::= { rs232AsyncPortTable 1 }
  369.  
  370.    Rs232AsyncPortEntry ::=
  371.        SEQUENCE {
  372.            rs232AsyncPortIndex
  373.                InterfaceIndex,
  374.            rs232AsyncPortBits
  375.                INTEGER,
  376.            rs232AsyncPortStopBits
  377.                INTEGER,
  378.            rs232AsyncPortParity
  379.                INTEGER,
  380.            rs232AsyncPortAutobaud
  381.                INTEGER,
  382.            rs232AsyncPortParityErrs
  383.                Counter32,
  384.            rs232AsyncPortFramingErrs
  385.                Counter32,
  386.            rs232AsyncPortOverrunErrs
  387.                Counter32
  388.  
  389.        }
  390.  
  391.  
  392.  
  393.  
  394. Stewart                                                         [Page 7]
  395.  
  396. RFC 1659                    RS-232-like MIB                    July 1994
  397.  
  398.  
  399.    rs232AsyncPortIndex OBJECT-TYPE
  400.        SYNTAX InterfaceIndex
  401.        MAX-ACCESS read-only
  402.        STATUS current
  403.        DESCRIPTION
  404.            "A unique value for each port.  Its value is the
  405.            same as rs232PortIndex for the port."
  406.        ::= { rs232AsyncPortEntry 1 }
  407.  
  408.    rs232AsyncPortBits OBJECT-TYPE
  409.        SYNTAX INTEGER (5..8)
  410.        MAX-ACCESS read-write
  411.        STATUS current
  412.        DESCRIPTION
  413.            "The port's number of bits in a character."
  414.        ::= { rs232AsyncPortEntry 2 }
  415.  
  416.    rs232AsyncPortStopBits OBJECT-TYPE
  417.        SYNTAX INTEGER { one(1), two(2),
  418.                         oneAndHalf(3), dynamic(4) }
  419.        MAX-ACCESS read-write
  420.        STATUS current
  421.        DESCRIPTION
  422.            "The port's number of stop bits."
  423.        ::= { rs232AsyncPortEntry 3 }
  424.  
  425.    rs232AsyncPortParity OBJECT-TYPE
  426.        SYNTAX INTEGER { none(1), odd(2), even(3),
  427.                         mark(4), space(5) }
  428.        MAX-ACCESS read-write
  429.        STATUS current
  430.        DESCRIPTION
  431.            "The port's sense of a character parity bit."
  432.        ::= { rs232AsyncPortEntry 4 }
  433.  
  434.    rs232AsyncPortAutobaud OBJECT-TYPE
  435.        SYNTAX INTEGER { enabled(1), disabled(2) }
  436.        MAX-ACCESS read-write
  437.        STATUS current
  438.        DESCRIPTION
  439.            "A control for the port's ability to automatically
  440.            sense input speed.
  441.  
  442.            When rs232PortAutoBaud is 'enabled', a port may
  443.            autobaud to values different from the set values for
  444.            speed, parity, and character size.  As a result a
  445.            network management system may temporarily observe
  446.            values different from what was previously set."
  447.  
  448.  
  449.  
  450. Stewart                                                         [Page 8]
  451.  
  452. RFC 1659                    RS-232-like MIB                    July 1994
  453.  
  454.  
  455.        ::= { rs232AsyncPortEntry 5 }
  456.  
  457.    rs232AsyncPortParityErrs OBJECT-TYPE
  458.        SYNTAX Counter32
  459.        MAX-ACCESS read-only
  460.        STATUS current
  461.        DESCRIPTION
  462.            "Total number of characters with a parity error,
  463.            input from the port since system re-initialization
  464.            and while the port state was 'up' or 'test'."
  465.        ::= { rs232AsyncPortEntry 6 }
  466.  
  467.    rs232AsyncPortFramingErrs OBJECT-TYPE
  468.        SYNTAX Counter32
  469.        MAX-ACCESS read-only
  470.        STATUS current
  471.        DESCRIPTION
  472.            "Total number of characters with a framing error,
  473.            input from the port since system re-initialization
  474.            and while the port state was 'up' or 'test'."
  475.        ::= { rs232AsyncPortEntry 7 }
  476.  
  477.    rs232AsyncPortOverrunErrs OBJECT-TYPE
  478.        SYNTAX Counter32
  479.        MAX-ACCESS read-only
  480.        STATUS current
  481.        DESCRIPTION
  482.            "Total number of characters with an overrun error,
  483.            input from the port since system re-initialization
  484.            and while the port state was 'up' or 'test'."
  485.        ::= { rs232AsyncPortEntry 8 }
  486.  
  487.  
  488.    -- RS-232-like Synchronous Port Table
  489.  
  490.    rs232SyncPortTable OBJECT-TYPE
  491.        SYNTAX SEQUENCE OF Rs232SyncPortEntry
  492.        MAX-ACCESS not-accessible
  493.        STATUS current
  494.        DESCRIPTION
  495.            "A list of asynchronous port entries.  Entries need
  496.            not exist for synchronous ports."
  497.        ::= { rs232 4 }
  498.  
  499.    rs232SyncPortEntry OBJECT-TYPE
  500.        SYNTAX Rs232SyncPortEntry
  501.        MAX-ACCESS not-accessible
  502.        STATUS current
  503.  
  504.  
  505.  
  506. Stewart                                                         [Page 9]
  507.  
  508. RFC 1659                    RS-232-like MIB                    July 1994
  509.  
  510.  
  511.        DESCRIPTION
  512.            "Status and parameter values for a synchronous
  513.            port."
  514.        INDEX { rs232SyncPortIndex }
  515.        ::= { rs232SyncPortTable 1 }
  516.  
  517.    Rs232SyncPortEntry ::=
  518.        SEQUENCE {
  519.            rs232SyncPortIndex
  520.                InterfaceIndex,
  521.            rs232SyncPortClockSource
  522.                INTEGER,
  523.            rs232SyncPortFrameCheckErrs
  524.                Counter32,
  525.            rs232SyncPortTransmitUnderrunErrs
  526.                Counter32,
  527.            rs232SyncPortReceiveOverrunErrs
  528.                Counter32,
  529.            rs232SyncPortInterruptedFrames
  530.                Counter32,
  531.            rs232SyncPortAbortedFrames
  532.                Counter32,
  533.            rs232SyncPortRole
  534.                INTEGER,
  535.            rs232SyncPortEncoding
  536.                INTEGER,
  537.            rs232SyncPortRTSControl
  538.                INTEGER,
  539.            rs232SyncPortRTSCTSDelay
  540.                Integer32,
  541.            rs232SyncPortMode
  542.                INTEGER,
  543.            rs232SyncPortIdlePattern
  544.                INTEGER,
  545.            rs232SyncPortMinFlags
  546.                Integer32
  547.        }
  548.  
  549.    rs232SyncPortIndex OBJECT-TYPE
  550.        SYNTAX InterfaceIndex
  551.        MAX-ACCESS read-only
  552.        STATUS current
  553.        DESCRIPTION
  554.            "A unique value for each port.  Its value is the
  555.            same as rs232PortIndex for the port."
  556.        ::= { rs232SyncPortEntry 1 }
  557.  
  558.  
  559.  
  560.  
  561.  
  562. Stewart                                                        [Page 10]
  563.  
  564. RFC 1659                    RS-232-like MIB                    July 1994
  565.  
  566.  
  567.    rs232SyncPortClockSource OBJECT-TYPE
  568.        SYNTAX INTEGER { internal(1), external(2), split(3) }
  569.        MAX-ACCESS read-write
  570.        STATUS current
  571.        DESCRIPTION
  572.            "Source of the port's bit rate clock. 'split' means
  573.            the tranmit clock is internal and the receive clock
  574.            is external."
  575.        ::= { rs232SyncPortEntry 2 }
  576.  
  577.    rs232SyncPortFrameCheckErrs OBJECT-TYPE
  578.        SYNTAX Counter32
  579.        MAX-ACCESS read-only
  580.        STATUS current
  581.        DESCRIPTION
  582.            "Total number of frames with an invalid frame check
  583.            sequence, input from the port since system
  584.            re-initialization and while the port state was 'up'
  585.            or 'test'."
  586.        ::= { rs232SyncPortEntry 3 }
  587.  
  588.    rs232SyncPortTransmitUnderrunErrs OBJECT-TYPE
  589.        SYNTAX Counter32
  590.        MAX-ACCESS read-only
  591.        STATUS current
  592.        DESCRIPTION
  593.            "Total number of frames that failed to be
  594.            transmitted on the port since system
  595.            re-initialization and while the port state was 'up'
  596.            or 'test' because data was not available to the
  597.            transmitter in time."
  598.        ::= { rs232SyncPortEntry 4 }
  599.  
  600.    rs232SyncPortReceiveOverrunErrs OBJECT-TYPE
  601.        SYNTAX Counter32
  602.        MAX-ACCESS read-only
  603.        STATUS current
  604.        DESCRIPTION
  605.            "Total number of frames that failed to be received
  606.            on the port since system re-initialization and while
  607.            the port state was 'up' or 'test' because the
  608.            receiver did not accept the data in time."
  609.        ::= { rs232SyncPortEntry 5 }
  610.  
  611.    rs232SyncPortInterruptedFrames OBJECT-TYPE
  612.        SYNTAX Counter32
  613.        MAX-ACCESS read-only
  614.        STATUS current
  615.  
  616.  
  617.  
  618. Stewart                                                        [Page 11]
  619.  
  620. RFC 1659                    RS-232-like MIB                    July 1994
  621.  
  622.  
  623.        DESCRIPTION
  624.            "Total number of frames that failed to be received
  625.            or transmitted on the port due to loss of modem
  626.            signals since system re-initialization and while the
  627.            port state was 'up' or 'test'."
  628.        ::= { rs232SyncPortEntry 6 }
  629.  
  630.    rs232SyncPortAbortedFrames OBJECT-TYPE
  631.        SYNTAX Counter32
  632.        MAX-ACCESS read-only
  633.        STATUS current
  634.        DESCRIPTION
  635.            "Number of frames aborted on the port due to
  636.            receiving an abort sequence since system
  637.            re-initialization and while the port state was 'up'
  638.            or 'test'."
  639.        ::= { rs232SyncPortEntry 7 }
  640.  
  641.    rs232SyncPortRole OBJECT-TYPE
  642.        SYNTAX INTEGER  { dte(1), dce(2) }
  643.        MAX-ACCESS read-write
  644.        STATUS current
  645.        DESCRIPTION
  646.            "The role the device is playing that is using this port.
  647.               dte    means the device is performing the role of
  648.                      data terminal equipment
  649.               dce    means the device is performing the role of
  650.                      data circuit-terminating equipment."
  651.        DEFVAL { dce }
  652.        ::= { rs232SyncPortEntry 8 }
  653.  
  654.    rs232SyncPortEncoding OBJECT-TYPE
  655.        SYNTAX INTEGER  { nrz(1), nrzi(2) }
  656.        MAX-ACCESS read-write
  657.        STATUS current
  658.        DESCRIPTION
  659.            "The bit stream encoding technique that is in effect
  660.             for this port.
  661.               nrz    for Non-Return to Zero encoding
  662.               nrzi   for Non-Return to Zero Inverted encoding."
  663.        DEFVAL { nrz }
  664.        ::= { rs232SyncPortEntry 9 }
  665.  
  666.    rs232SyncPortRTSControl OBJECT-TYPE
  667.        SYNTAX INTEGER  { controlled(1), constant(2) }
  668.        MAX-ACCESS read-write
  669.        STATUS current
  670.        DESCRIPTION
  671.  
  672.  
  673.  
  674. Stewart                                                        [Page 12]
  675.  
  676. RFC 1659                    RS-232-like MIB                    July 1994
  677.  
  678.  
  679.            "The method used to control the Request To Send (RTS)
  680.             signal.
  681.  
  682.               controlled  when the DTE is asserts RTS each time
  683.                           data needs to be transmitted and drops
  684.                           RTS at some point after data
  685.                           transmission begins.
  686.  
  687.                           If rs232SyncPortRole is 'dte', the
  688.                           RTS is an output signal. The device
  689.                           will issue a RTS and wait for a CTS
  690.                           from the DCE before starting to
  691.                           transmit.
  692.  
  693.                           If rs232SyncPortRole is 'dce', the
  694.                           RTS is an input signal. The device
  695.                           will issue a CTS only after having
  696.                           received RTS and waiting the
  697.                           rs232SyncPortRTSCTSDelay interval.
  698.  
  699.               constant    when the DTE constantly asserts RTS."
  700.        DEFVAL { constant }
  701.        ::= { rs232SyncPortEntry 10 }
  702.  
  703.    rs232SyncPortRTSCTSDelay OBJECT-TYPE
  704.        SYNTAX Integer32
  705.        MAX-ACCESS read-write
  706.        STATUS current
  707.        DESCRIPTION
  708.            "The interval (in milliseconds) that the DCE must wait
  709.             after it sees RTS asserted before asserting CTS.  This
  710.             object exists in support of older synchronous devices
  711.             that cannot recognize CTS within a certain interval
  712.             after it asserts RTS."
  713.        DEFVAL { 0 }
  714.        ::= { rs232SyncPortEntry 11 }
  715.  
  716.    rs232SyncPortMode OBJECT-TYPE
  717.        SYNTAX INTEGER  { fdx(1), hdx(2), simplex-receive(3),
  718.                          simplex-send(4) }
  719.        MAX-ACCESS read-write
  720.        STATUS current
  721.        DESCRIPTION
  722.            "The mode of operation of the port with respect to the
  723.             direction and simultaneity of data transfer.
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. Stewart                                                        [Page 13]
  731.  
  732. RFC 1659                    RS-232-like MIB                    July 1994
  733.  
  734.  
  735.               fdx              when frames on the data link can be
  736.                                transmitted and received at the same
  737.                                time
  738.  
  739.               hdx              when frames can either be received
  740.                                from the data link or transmitted
  741.                                onto the data link but not at the
  742.                                same time.
  743.  
  744.               simplex-receive  when frames can only be received on
  745.                                this data link.
  746.  
  747.               simplex-send     when frames can only be sent on this
  748.                                data link."
  749.        DEFVAL { fdx }
  750.        ::= { rs232SyncPortEntry 12 }
  751.  
  752.    rs232SyncPortIdlePattern OBJECT-TYPE
  753.        SYNTAX INTEGER  { mark(1), space(2) }
  754.        MAX-ACCESS read-write
  755.        STATUS current
  756.        DESCRIPTION
  757.            "The bit pattern used to indicate an idle line."
  758.        DEFVAL { space }
  759.        ::= { rs232SyncPortEntry 13 }
  760.  
  761.    rs232SyncPortMinFlags OBJECT-TYPE
  762.        SYNTAX Integer32
  763.        MAX-ACCESS read-write
  764.        STATUS current
  765.        DESCRIPTION
  766.            "The minimum number of flag patterns this port needs in
  767.             order to recognize the end of one frame and the start
  768.             of the next.  Plausible values are 1 and 2."
  769.        DEFVAL { 2 }
  770.        ::= { rs232SyncPortEntry 14 }
  771.  
  772.  
  773.    -- Input Signal Table
  774.  
  775.    rs232InSigTable OBJECT-TYPE
  776.        SYNTAX SEQUENCE OF Rs232InSigEntry
  777.        MAX-ACCESS not-accessible
  778.        STATUS current
  779.        DESCRIPTION
  780.            "A list of port input control signal entries
  781.            implemented and visible to the software on the port,
  782.            and useful to monitor."
  783.  
  784.  
  785.  
  786. Stewart                                                        [Page 14]
  787.  
  788. RFC 1659                    RS-232-like MIB                    July 1994
  789.  
  790.  
  791.        ::= { rs232 5 }
  792.  
  793.    rs232InSigEntry OBJECT-TYPE
  794.        SYNTAX Rs232InSigEntry
  795.        MAX-ACCESS not-accessible
  796.        STATUS current
  797.        DESCRIPTION
  798.            "Input control signal status for a hardware port."
  799.        INDEX { rs232InSigPortIndex, rs232InSigName }
  800.        ::= { rs232InSigTable 1 }
  801.  
  802.    Rs232InSigEntry ::=
  803.        SEQUENCE {
  804.            rs232InSigPortIndex
  805.                InterfaceIndex,
  806.            rs232InSigName
  807.                INTEGER,
  808.            rs232InSigState
  809.                INTEGER,
  810.            rs232InSigChanges
  811.                Counter32
  812.        }
  813.  
  814.    rs232InSigPortIndex OBJECT-TYPE
  815.        SYNTAX InterfaceIndex
  816.        MAX-ACCESS read-only
  817.        STATUS current
  818.        DESCRIPTION
  819.            "The value of rs232PortIndex for the port to which
  820.            this entry belongs."
  821.        ::= { rs232InSigEntry 1 }
  822.  
  823.    rs232InSigName OBJECT-TYPE
  824.        SYNTAX INTEGER { rts(1), cts(2), dsr(3), dtr(4), ri(5),
  825.                         dcd(6), sq(7), srs(8), srts(9),
  826.                         scts(10), sdcd(11) }
  827.        MAX-ACCESS read-only
  828.        STATUS current
  829.        DESCRIPTION
  830.            "Identification of a hardware signal, as follows:
  831.  
  832.                rts    Request to Send
  833.                cts    Clear to Send
  834.                dsr    Data Set Ready
  835.                dtr    Data Terminal Ready
  836.                ri     Ring Indicator
  837.                dcd    Received Line Signal Detector
  838.                sq     Signal Quality Detector
  839.  
  840.  
  841.  
  842. Stewart                                                        [Page 15]
  843.  
  844. RFC 1659                    RS-232-like MIB                    July 1994
  845.  
  846.  
  847.                srs    Data Signaling Rate Selector
  848.                srts   Secondary Request to Send
  849.                scts   Secondary Clear to Send
  850.                sdcd   Secondary Received Line Signal Detector
  851.            "
  852.        REFERENCE
  853.            "EIA Standard RS-232-C, August 1969."
  854.        ::= { rs232InSigEntry 2 }
  855.  
  856.    rs232InSigState OBJECT-TYPE
  857.        SYNTAX INTEGER { none(1), on(2), off(3) }
  858.        MAX-ACCESS read-only
  859.        STATUS current
  860.        DESCRIPTION
  861.            "The current signal state."
  862.        ::= { rs232InSigEntry 3 }
  863.  
  864.    rs232InSigChanges OBJECT-TYPE
  865.        SYNTAX Counter32
  866.        MAX-ACCESS read-only
  867.        STATUS current
  868.        DESCRIPTION
  869.            "The number of times the signal has changed from
  870.            'on' to 'off' or from 'off' to 'on'."
  871.        ::= { rs232InSigEntry 4 }
  872.  
  873.  
  874.    -- Output Signal Table
  875.  
  876.    rs232OutSigTable OBJECT-TYPE
  877.        SYNTAX SEQUENCE OF Rs232OutSigEntry
  878.        MAX-ACCESS not-accessible
  879.        STATUS current
  880.        DESCRIPTION
  881.            "A list of port output control signal entries
  882.            implemented and visible to the software on the port,
  883.            and useful to monitor."
  884.        ::= { rs232 6 }
  885.  
  886.    rs232OutSigEntry OBJECT-TYPE
  887.        SYNTAX Rs232OutSigEntry
  888.        MAX-ACCESS not-accessible
  889.        STATUS current
  890.        DESCRIPTION
  891.            "Output control signal status for a hardware port."
  892.        INDEX { rs232OutSigPortIndex, rs232OutSigName }
  893.        ::= { rs232OutSigTable 1 }
  894.  
  895.  
  896.  
  897.  
  898. Stewart                                                        [Page 16]
  899.  
  900. RFC 1659                    RS-232-like MIB                    July 1994
  901.  
  902.  
  903.    Rs232OutSigEntry ::=
  904.        SEQUENCE {
  905.            rs232OutSigPortIndex
  906.                InterfaceIndex,
  907.            rs232OutSigName
  908.                INTEGER,
  909.            rs232OutSigState
  910.                INTEGER,
  911.            rs232OutSigChanges
  912.                Counter32
  913.        }
  914.  
  915.    rs232OutSigPortIndex OBJECT-TYPE
  916.        SYNTAX InterfaceIndex
  917.        MAX-ACCESS read-only
  918.        STATUS current
  919.        DESCRIPTION
  920.            "The value of rs232PortIndex for the port to which
  921.            this entry belongs."
  922.        ::= { rs232OutSigEntry 1 }
  923.  
  924.    rs232OutSigName OBJECT-TYPE
  925.        SYNTAX INTEGER { rts(1), cts(2), dsr(3), dtr(4), ri(5),
  926.                         dcd(6), sq(7), srs(8), srts(9),
  927.                         scts(10), sdcd(11) }
  928.        MAX-ACCESS read-only
  929.        STATUS current
  930.        DESCRIPTION
  931.            "Identification of a hardware signal, as follows:
  932.  
  933.                rts    Request to Send
  934.                cts    Clear to Send
  935.                dsr    Data Set Ready
  936.                dtr    Data Terminal Ready
  937.                ri     Ring Indicator
  938.                dcd    Received Line Signal Detector
  939.                sq     Signal Quality Detector
  940.                srs    Data Signaling Rate Selector
  941.                srts   Secondary Request to Send
  942.                scts   Secondary Clear to Send
  943.                sdcd   Secondary Received Line Signal Detector
  944.            "
  945.        REFERENCE
  946.            "EIA Standard RS-232-C, August 1969."
  947.        ::= { rs232OutSigEntry 2 }
  948.  
  949.    rs232OutSigState OBJECT-TYPE
  950.        SYNTAX INTEGER { none(1), on(2), off(3) }
  951.  
  952.  
  953.  
  954. Stewart                                                        [Page 17]
  955.  
  956. RFC 1659                    RS-232-like MIB                    July 1994
  957.  
  958.  
  959.        MAX-ACCESS read-only
  960.        STATUS current
  961.        DESCRIPTION
  962.            "The current signal state."
  963.        ::= { rs232OutSigEntry 3 }
  964.  
  965.    rs232OutSigChanges OBJECT-TYPE
  966.        SYNTAX Counter32
  967.        MAX-ACCESS read-only
  968.        STATUS current
  969.        DESCRIPTION
  970.            "The number of times the signal has changed from
  971.            'on' to 'off' or from 'off' to 'on'."
  972.        ::= { rs232OutSigEntry 4 }
  973.  
  974.  
  975.    -- conformance information
  976.  
  977.    rs232Conformance OBJECT IDENTIFIER ::= { rs232 7 }
  978.  
  979.    rs232Groups      OBJECT IDENTIFIER ::= { rs232Conformance 1 }
  980.    rs232Compliances OBJECT IDENTIFIER ::= { rs232Conformance 2 }
  981.  
  982.  
  983.    -- compliance statements
  984.  
  985.    rs232Compliance MODULE-COMPLIANCE
  986.        STATUS  current
  987.        DESCRIPTION
  988.                "The compliance statement for SNMPv2 entities
  989.                which have RS-232-like hardware interfaces."
  990.  
  991.        MODULE  -- this module
  992.            MANDATORY-GROUPS { rs232Group }
  993.  
  994.            GROUP   rs232AsyncGroup
  995.            DESCRIPTION
  996.                "The Asynch group is mandatory only for those
  997.                 SNMPv2 entities which have asynchronous
  998.                 interfaces Rs-232-like."
  999.  
  1000.            GROUP   rs232SyncGroup
  1001.            DESCRIPTION
  1002.                "The Synch group is mandatory only for those
  1003.                 SNMPv2 entities which have synchronous
  1004.                 interfaces Rs-232-like."
  1005.        ::= { rs232Compliances 1 }
  1006.  
  1007.  
  1008.  
  1009.  
  1010. Stewart                                                        [Page 18]
  1011.  
  1012. RFC 1659                    RS-232-like MIB                    July 1994
  1013.  
  1014.  
  1015.    -- units of conformance
  1016.  
  1017.    rs232Group    OBJECT-GROUP
  1018.        OBJECTS { rs232Number, rs232PortIndex, rs232PortType,
  1019.                  rs232PortInSigNumber, rs232PortOutSigNumber,
  1020.                  rs232PortInSpeed, rs232PortOutSpeed,
  1021.                  rs232PortInFlowType, rs232PortOutFlowType,
  1022.                  rs232InSigPortIndex, rs232InSigName,
  1023.                  rs232InSigState, rs232InSigChanges,
  1024.                  rs232OutSigPortIndex, rs232OutSigName,
  1025.                  rs232OutSigState, rs232OutSigChanges }
  1026.        STATUS  current
  1027.        DESCRIPTION
  1028.                "A collection of objects providing information
  1029.                 applicable to all RS-232-like interfaces."
  1030.        ::= { rs232Groups 1 }
  1031.  
  1032.    rs232AsyncGroup OBJECT-GROUP
  1033.        OBJECTS { rs232AsyncPortIndex, rs232AsyncPortBits,
  1034.                  rs232AsyncPortStopBits, rs232AsyncPortParity,
  1035.                  rs232AsyncPortAutobaud, rs232AsyncPortParityErrs,
  1036.                  rs232AsyncPortFramingErrs, rs232AsyncPortOverrunErrs }
  1037.        STATUS  current
  1038.        DESCRIPTION
  1039.                "A collection of objects providing information
  1040.                 applicable to asynchronous RS-232-like interfaces."
  1041.        ::= { rs232Groups 2 }
  1042.  
  1043.    rs232SyncGroup OBJECT-GROUP
  1044.        OBJECTS { rs232SyncPortIndex, rs232SyncPortClockSource,
  1045.                  rs232SyncPortFrameCheckErrs,
  1046.                  rs232SyncPortTransmitUnderrunErrs,
  1047.                  rs232SyncPortReceiveOverrunErrs,
  1048.                  rs232SyncPortInterruptedFrames,
  1049.                  rs232SyncPortAbortedFrames }
  1050.        STATUS  current
  1051.        DESCRIPTION
  1052.                "A collection of objects providing information
  1053.                 applicable to synchronous RS-232-like interfaces."
  1054.        ::= { rs232Groups 3 }
  1055.  
  1056.    rs232SyncSDLCGroup OBJECT-GROUP
  1057.        OBJECTS { rs232SyncPortRole,
  1058.                  rs232SyncPortEncoding,
  1059.                  rs232SyncPortRTSControl,
  1060.                  rs232SyncPortRTSCTSDelay,
  1061.                  rs232SyncPortMode,
  1062.                  rs232SyncPortIdlePattern,
  1063.  
  1064.  
  1065.  
  1066. Stewart                                                        [Page 19]
  1067.  
  1068. RFC 1659                    RS-232-like MIB                    July 1994
  1069.  
  1070.  
  1071.                  rs232SyncPortMinFlags }
  1072.        STATUS  current
  1073.        DESCRIPTION
  1074.                "A collection of objects providing information
  1075.                 applicable to synchronous RS-232-like interfaces
  1076.                 running SDLC."
  1077.        ::= { rs232Groups 4 }
  1078.  
  1079.    END
  1080.  
  1081. 5.  Acknowledgements
  1082.  
  1083.    This memo was produced by the IETF Character MIB Working Group.
  1084.  
  1085. 6.  References
  1086.  
  1087.    [1] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure
  1088.        of Management Information for version 2 of the Simple Network
  1089.        Management Protocol (SNMPv2)", RFC 1442, SNMP Research,Inc.,
  1090.        Hughes LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon
  1091.        University, April 1993.
  1092.  
  1093.    [2] McCloghrie, K., and M. Rose, Editors, "Management Information
  1094.        Base for Network Management of TCP/IP-based internets: MIB-II",
  1095.        STD 17, RFC 1213, Hughes LAN Systems, Performance Systems
  1096.        International, March 1991.
  1097.  
  1098.    [3] Galvin, J., and K. McCloghrie, "Administrative Model for version
  1099.        2 of the Simple Network Management Protocol (SNMPv2)", RFC 1445,
  1100.        Trusted Information Systems, Hughes LAN Systems, April 1993.
  1101.  
  1102.    [4] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol
  1103.        Operations for version 2 of the Simple Network Management
  1104.        Protocol (SNMPv2)", RFC 1448, SNMP Research,Inc., Hughes LAN
  1105.        Systems, Dover Beach Consulting, Inc., Carnegie Mellon
  1106.        University, April 1993.
  1107.  
  1108.    [5] McCloghrie, K., and F. Kastenholz, "Evolution of the Interfaces
  1109.        Group of MIB-II", RFC 1573, Hughes LAN Systems, FTP Software,
  1110.        January 1994.
  1111.  
  1112.    [6] Stewart, B., "Definitions of Managed Objects for Character Stream
  1113.        Devices using SMIv2", RFC 1658, Xyplex, Inc., July 1994.
  1114.  
  1115.    [7] Kastenholz, F., "The Definitions of Managed Objects for the Link
  1116.        Control Protocol of the Point-to-Point Protocol", RFC 1471, FTP
  1117.        Software, Inc., June 1993.
  1118.  
  1119.  
  1120.  
  1121.  
  1122. Stewart                                                        [Page 20]
  1123.  
  1124. RFC 1659                    RS-232-like MIB                    July 1994
  1125.  
  1126.  
  1127. 7.  Security Considerations
  1128.  
  1129.    Security issues are not discussed in this memo.
  1130.  
  1131. 8.  Author's Address
  1132.  
  1133.    Bob Stewart
  1134.    Xyplex, Inc.
  1135.    295 Foster Street
  1136.    Littleton, MA 01460
  1137.  
  1138.    Phone: 508-952-4816
  1139.    Fax: 508-952-4887
  1140.    EMail: rlstewart@eng.xyplex.com
  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. Stewart                                                        [Page 21]
  1179.  
  1180.