home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_a_c / draft-ietf-charmib-mib-02.txt < prev    next >
Text File  |  1994-05-27  |  32KB  |  1,474 lines
  1.  
  2.  
  3. draft                        Character MIB                   26 May 1994
  4.  
  5.  
  6.                              Character MIB
  7.  
  8.                               26 May 1994
  9.  
  10.  
  11.                               Bob Stewart
  12.                               Xyplex, Inc.
  13.                         rlstewart@eng.xyplex.com
  14.  
  15.  
  16.                      <draft-ietf-charmib-mib-02.txt>
  17.  
  18.  
  19.                           Status of this Memo
  20.  
  21. This document is an Internet Draft.  Internet Drafts are working
  22. documents of the Internet Engineering Task Force (IETF), its Areas, and
  23. its Working Groups.  Note that other groups may also distribute working
  24. documents as Internet Drafts.
  25.  
  26. Internet Drafts are valid for a maximum of six months and may be
  27. updated, replaced, or obsoleted by other documents at any time.  It is
  28. inappropriate to use Internet Drafts as reference material or to cite
  29. them other than as a "work in progress".
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56. Expires 26 November 1994                                        [Page 1]
  57.  
  58.  
  59.  
  60.  
  61.  
  62. draft                        Character MIB                   26 May 1994
  63.  
  64.  
  65. 1.  Introduction
  66.  
  67. This memo defines an extension to the Management Information Base (MIB)
  68. for use with network management protocols in the Internet community.  In
  69. particular, it defines objects for the management of character stream
  70. devices.
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115. Expires 26 November 1994                                        [Page 2]
  116.  
  117.  
  118.  
  119.  
  120.  
  121. draft                        Character MIB                   26 May 1994
  122.  
  123.  
  124. 2.  The SNMPv2 Network Management Framework
  125.  
  126. The SNMPv2 Network Management Framework consists of four major
  127. components.  They are:
  128.  
  129. o    RFC 1442 [1] which defines the SMI, the mechanisms used for
  130.      describing and naming objects for the purpose of management.
  131.  
  132. o    STD 17, RFC 1213 [2] defines MIB-II, the core set of managed
  133.      objects for the Internet suite of protocols.
  134.  
  135. o    RFC 1445 [3] which defines the administrative and other
  136.      architectural aspects of the framework.
  137.  
  138. o    RFC 1448 [4] which defines the protocol used for network access to
  139.      managed objects.
  140.  
  141. The Framework permits new objects to be defined for the purpose of
  142. experimentation and evaluation.
  143.  
  144.  
  145. 2.1.  Object Definitions
  146.  
  147. Managed objects are accessed via a virtual information store, termed the
  148. Management Information Base or MIB.  Objects in the MIB are defined
  149. using the subset of Abstract Syntax Notation One (ASN.1) defined in the
  150. SMI.  In particular, each object object type is named by an OBJECT
  151. IDENTIFIER, an administratively assigned name.  The object type together
  152. with an object instance serves to uniquely identify a specific
  153. instantiation of the object.  For human convenience, we often use a
  154. textual string, termed the descriptor, to refer to the object type.
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174. Expires 26 November 1994                                        [Page 3]
  175.  
  176.  
  177.  
  178.  
  179.  
  180. draft                        Character MIB                   26 May 1994
  181.  
  182.  
  183. 3.  Overview
  184.  
  185. The Character MIB applies to ports that carry a character stream,
  186. whether physical or virtual, serial or parallel, synchronous or
  187. asynchronous.  The most common example of a character stream device is a
  188. hardware terminal port with an RS-232 interface.  Another common
  189. hardware example is a parallel printer port, say with a Centronics
  190. interface.  The concept also includes virtual terminal ports, such as a
  191. software connection point for a remote console.
  192.  
  193. The Character MIB is mandatory for all systems that offer character
  194. stream ports.  This includes, for example, terminal servers, general-
  195. purpose time-sharing hosts, and even such systems as a bridge with a
  196. (virtual) console port.  It may or may not include character ports that
  197. do not support network sessions, depending on the system's needs.
  198.  
  199. The Character MIB's central abstraction is a port.  Physical ports have
  200. a one-to-one correspondence with hardware ports. Virtual ports are
  201. software entities analogous to physical ports, but with no hardware
  202. connector.
  203.  
  204. Each port supports one or more sessions.  A session represents a virtual
  205. connection that carries characters between the port and some partner.
  206. Sessions typically operate over a stack of network protocols.  A typical
  207. session, for example, uses Telnet over TCP.
  208.  
  209. The MIB comprises one base object and two tables, detailed in the
  210. following sections.  The tables contain objects for ports and sessions.
  211.  
  212. The MIB intentionally contains no distinction between what is often
  213. called permanent and operational or volatile data bases.  For the
  214. purposes of this MIB, handling of such distinctions is implementation
  215. specific.
  216.  
  217.  
  218. 3.1.  Relationship to Interface MIB
  219.  
  220. The Character MIB does not relate directly to the Interface MIB [1],
  221. since it is not intrinsically a network interface.  On the other hand,
  222. in most implementations where it is present, it will be above a physical
  223. sublayer interface, such as the RS-232-like [2] or Parallel-printer-like
  224. [3] MIBs.  Such physical interfaces typically are represented by a row
  225. in the interface table (ifTable), identified by a value of ifIndex.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233. Expires 26 November 1994                                        [Page 4]
  234.  
  235.  
  236.  
  237.  
  238.  
  239. draft                        Character MIB                   26 May 1994
  240.  
  241.  
  242. 4.  Definitions
  243.  
  244. CHARACTER-MIB DEFINITIONS ::= BEGIN
  245.  
  246. IMPORTS
  247.     MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
  248.     Counter32, Integer32, Gauge32, TimeTicks
  249.         FROM SNMPv2-SMI
  250.     AutonomousType, InstancePointer
  251.         FROM SNMPv2-TC
  252.     InterfaceIndex
  253.         FROM IF-MIB
  254.     transmission, mib-2
  255.         FROM RFC1213-MIB
  256.     MODULE-COMPLIANCE, OBJECT-GROUP
  257.         FROM SNMPv2-CONF;
  258.  
  259.  
  260. char MODULE-IDENTITY
  261.     LAST-UPDATED "9405261700Z"
  262.     ORGANIZATION "IETF Character MIB Working Group"
  263.     CONTACT-INFO
  264.             "        Bob Stewart
  265.              Postal: Xyplex, Inc.
  266.                      295 Foster Street
  267.                      Littleton, MA 01460
  268.  
  269.                 Tel: 508-952-4816
  270.                 Fax: 508-952-4887
  271.              E-mail: rlstewart@eng.xyplex.com"
  272.     DESCRIPTION
  273.             "The MIB module for character stream devices."
  274.     ::= { mib-2 19 }
  275.  
  276. PortIndex ::= TEXTUAL-CONVENTION
  277.     DISPLAY-HINT "d"
  278.     STATUS current
  279.     DESCRIPTION
  280.             "A unique value, greater than zero, for each
  281.             character port in the managed system.  It is
  282.             recommended that values are assigned contiguously
  283.             starting from 1.  The value for each interface sub-
  284.             layer must remain constant at least from one re-
  285.             initialization of the entity's network management
  286.             system to the next re-initialization.
  287.  
  288.  
  289.  
  290.  
  291.  
  292. Expires 26 November 1994                                        [Page 5]
  293.  
  294.  
  295.  
  296.  
  297.  
  298. draft                        Character MIB                   26 May 1994
  299.  
  300.  
  301.             In a system where the character ports are attached
  302.             to hardware represented by an ifIndex, it is
  303.             conventional, but not required, to make the
  304.             character port index equal to the corresponding
  305.             ifIndex."
  306.     SYNTAX Integer32
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351. Expires 26 November 1994                                        [Page 6]
  352.  
  353.  
  354.  
  355.  
  356.  
  357. draft                        Character MIB                   26 May 1994
  358.  
  359.  
  360. -- Generic Character information
  361.  
  362. charNumber OBJECT-TYPE
  363.     SYNTAX Integer32
  364.     MAX-ACCESS read-only
  365.     STATUS current
  366.     DESCRIPTION
  367.         "The number of entries in charPortTable, regardless
  368.         of their current state."
  369.     ::= { char 1 }
  370.  
  371.  
  372. -- the Character Port table
  373.  
  374. charPortTable OBJECT-TYPE
  375.     SYNTAX SEQUENCE OF CharPortEntry
  376.     MAX-ACCESS not-accessible
  377.     STATUS current
  378.     DESCRIPTION
  379.         "A list of port entries.  The number of entries is
  380.         given by the value of charNumber."
  381.     ::= { char 2 }
  382.  
  383. charPortEntry OBJECT-TYPE
  384.     SYNTAX CharPortEntry
  385.     MAX-ACCESS not-accessible
  386.     STATUS current
  387.     DESCRIPTION
  388.         "Status and parameter values for a character port."
  389.     INDEX { charPortIndex }
  390.     ::= { charPortTable 1 }
  391.  
  392. CharPortEntry ::=
  393.     SEQUENCE {
  394.         charPortIndex
  395.             PortIndex,
  396.         charPortName
  397.             DisplayString,
  398.         charPortType
  399.             INTEGER,
  400.         charPortHardware
  401.             AutonomousType,
  402.         charPortReset
  403.             INTEGER,
  404.         charPortAdminStatus
  405.  
  406.  
  407.  
  408.  
  409.  
  410. Expires 26 November 1994                                        [Page 7]
  411.  
  412.  
  413.  
  414.  
  415.  
  416. draft                        Character MIB                   26 May 1994
  417.  
  418.  
  419.             INTEGER,
  420.         charPortOperStatus
  421.             INTEGER,
  422.         charPortLastChange
  423.             TimeTicks,
  424.         charPortInFlowType
  425.             INTEGER,
  426.         charPortOutFlowType
  427.             INTEGER,
  428.         charPortInFlowState
  429.             INTEGER,
  430.         charPortOutFlowState
  431.             INTEGER,
  432.         charPortInCharacters
  433.             Counter32,
  434.         charPortOutCharacters
  435.             Counter32,
  436.         charPortAdminOrigin
  437.             INTEGER,
  438.         charPortSessionMaximum
  439.             INTEGER,
  440.         charPortSessionNumber
  441.             Gauge32,
  442.         charPortSessionIndex
  443.             INTEGER,
  444.         charPortInFlowTypes
  445.             OCTET STRING,
  446.         charPortOutFlowTypes
  447.             OCTET STRING,
  448.         charPortLowerIfIndex
  449.             InterfaceIndex
  450.     }
  451.  
  452. charPortIndex OBJECT-TYPE
  453.     SYNTAX PortIndex
  454.     MAX-ACCESS read-only
  455.     STATUS current
  456.     DESCRIPTION
  457.         "A unique value for each character port, perhaps
  458.         corresponding to the same value of ifIndex when the
  459.         character port is associated with a hardware port
  460.         represented by an ifIndex."
  461.     ::= { charPortEntry 1 }
  462.  
  463. charPortName OBJECT-TYPE
  464.  
  465.  
  466.  
  467.  
  468.  
  469. Expires 26 November 1994                                        [Page 8]
  470.  
  471.  
  472.  
  473.  
  474.  
  475. draft                        Character MIB                   26 May 1994
  476.  
  477.  
  478.     SYNTAX DisplayString (SIZE (0..32))
  479.     MAX-ACCESS read-write
  480.     STATUS current
  481.     DESCRIPTION
  482.         "An administratively assigned name for the port,
  483.         typically with some local significance."
  484.     ::= { charPortEntry 2 }
  485.  
  486. charPortType OBJECT-TYPE
  487.     SYNTAX INTEGER { physical(1), virtual(2) }
  488.     MAX-ACCESS read-only
  489.     STATUS current
  490.     DESCRIPTION
  491.         "The port's type, 'physical' if the port represents
  492.         an external hardware connector, 'virtual' if it does
  493.         not."
  494.     ::= { charPortEntry 3 }
  495.  
  496. charPortHardware OBJECT-TYPE
  497.     SYNTAX AutonomousType
  498.     MAX-ACCESS read-only
  499.     STATUS current
  500.     DESCRIPTION
  501.         "A reference to hardware MIB definitions specific to
  502.         a physical port's external connector.  For example,
  503.         if the connector is RS-232, then the value of this
  504.         object refers to a MIB sub-tree defining objects
  505.         specific to RS-232.  If an agent is not configured
  506.         to have such values, the agent returns the object
  507.         identifier:
  508.  
  509.             nullHardware OBJECT IDENTIFIER ::= { 0 0 }
  510.         "
  511.     ::= { charPortEntry 4 }
  512.  
  513. charPortReset OBJECT-TYPE
  514.     SYNTAX INTEGER { ready(1), execute(2) }
  515.     MAX-ACCESS read-write
  516.     STATUS current
  517.     DESCRIPTION
  518.         "A control to force the port into a clean, initial
  519.         state, both hardware and software, disconnecting all
  520.         the port's existing sessions.  In response to a
  521.         get-request or get-next-request, the agent always
  522.         returns 'ready' as the value.  Setting the value to
  523.  
  524.  
  525.  
  526.  
  527.  
  528. Expires 26 November 1994                                        [Page 9]
  529.  
  530.  
  531.  
  532.  
  533.  
  534. draft                        Character MIB                   26 May 1994
  535.  
  536.  
  537.         'execute' causes a reset."
  538.     ::= { charPortEntry 5 }
  539.  
  540. charPortAdminStatus OBJECT-TYPE
  541.     SYNTAX INTEGER { enabled(1), disabled(2), off(3),
  542.                      maintenance(4) }
  543.     MAX-ACCESS read-write
  544.     STATUS current
  545.     DESCRIPTION
  546.         "The port's desired state, independent of flow
  547.         control.  'enabled' indicates that the port is
  548.         allowed to pass characters and form new sessions.
  549.         'disabled' indicates that the port is allowed to
  550.         pass characters but not form new sessions.  'off'
  551.         indicates that the port is not allowed to pass
  552.         characters or have any sessions. 'maintenance'
  553.         indicates a maintenance mode, exclusive of normal
  554.         operation, such as running a test.
  555.  
  556.         'enabled' corresponds to ifAdminStatus 'up'.
  557.         'disabled' and 'off' correspond to ifAdminStatus
  558.         'down'.  'maintenance' corresponds to ifAdminStatus
  559.         'test'."
  560.     ::= { charPortEntry 6 }
  561.  
  562. charPortOperStatus OBJECT-TYPE
  563.     SYNTAX INTEGER { up(1), down(2),
  564.                      maintenance(3), absent(4), active(5) }
  565.     MAX-ACCESS read-only
  566.     STATUS current
  567.     DESCRIPTION
  568.         "The port's actual, operational state, independent
  569.         of flow control.  'up' indicates able to function
  570.         normally.  'down' indicates inability to function
  571.         for administrative or operational reasons.
  572.         'maintenance' indicates a maintenance mode,
  573.         exclusive of normal operation, such as running a
  574.         test.  'absent' indicates that port hardware is not
  575.         present.  'active' indicates up with a user present
  576.         (e.g. logged in).
  577.  
  578.         'up' and 'active' correspond to ifOperStatus 'up'.
  579.         'down' and 'absent' correspond to ifOperStatus
  580.         'down'.  'maintenance' corresponds to ifOperStatus
  581.         'test'."
  582.  
  583.  
  584.  
  585.  
  586.  
  587. Expires 26 November 1994                                       [Page 10]
  588.  
  589.  
  590.  
  591.  
  592.  
  593. draft                        Character MIB                   26 May 1994
  594.  
  595.  
  596.     ::= { charPortEntry 7 }
  597.  
  598. charPortLastChange OBJECT-TYPE
  599.     SYNTAX TimeTicks
  600.     MAX-ACCESS read-only
  601.     STATUS current
  602.     DESCRIPTION
  603.         "The value of sysUpTime at the time the port entered
  604.         its current operational state.  If the current state
  605.         was entered prior to the last reinitialization of
  606.         the local network management subsystem, then this
  607.         object contains a zero value."
  608.     ::= { charPortEntry 8 }
  609.  
  610. -- charPortInFlowType is deprecated in favor of
  611. -- charPortInFlowTypes
  612.  
  613. charPortInFlowType OBJECT-TYPE
  614.     SYNTAX INTEGER { none(1), xonXoff(2), hardware(3),
  615.                      ctsRts(4), dsrDtr(5) }
  616.     MAX-ACCESS read-write
  617.     STATUS deprecated
  618.     DESCRIPTION
  619.         "The port's type of input flow control.  'none'
  620.         indicates no flow control at this level or below.
  621.         'xonXoff' indicates software flow control by
  622.         recognizing XON and XOFF characters.  'hardware'
  623.         indicates flow control delegated to the lower level,
  624.         for example a parallel port.
  625.  
  626.         'ctsRts' and 'dsrDtr' are specific to RS-232-like
  627.         ports.  Although not architecturally pure, they are
  628.         included here for simplicity's sake."
  629.     ::= { charPortEntry 9 }
  630.  
  631. -- charPortOutFlowType is deprecated in favor of
  632. -- charPortOutFlowTypes
  633.  
  634. charPortOutFlowType OBJECT-TYPE
  635.     SYNTAX INTEGER { none(1), xonXoff(2), hardware(3),
  636.                      ctsRts(4), dsrDtr(5) }
  637.     MAX-ACCESS read-write
  638.     STATUS deprecated
  639.     DESCRIPTION
  640.         "The port's type of output flow control.  'none'
  641.  
  642.  
  643.  
  644.  
  645.  
  646. Expires 26 November 1994                                       [Page 11]
  647.  
  648.  
  649.  
  650.  
  651.  
  652. draft                        Character MIB                   26 May 1994
  653.  
  654.  
  655.         indicates no flow control at this level or below.
  656.         'xonXoff' indicates software flow control by
  657.         recognizing XON and XOFF characters.  'hardware'
  658.         indicates flow control delegated to the lower level,
  659.         for example a parallel port.
  660.  
  661.         'ctsRts' and 'dsrDtr' are specific to RS-232-like
  662.         ports.  Although not architecturally pure, they are
  663.         included here for simplicy's sake."
  664.     ::= { charPortEntry 10 }
  665.  
  666. charPortInFlowState OBJECT-TYPE
  667.     SYNTAX INTEGER { none(1), unknown(2), stop(3), go(4) }
  668.     MAX-ACCESS read-only
  669.     STATUS current
  670.     DESCRIPTION
  671.         "The current operational state of input flow control
  672.         on the port.  'none' indicates not applicable.
  673.         'unknown' indicates this level does not know.
  674.         'stop' indicates flow not allowed.  'go' indicates
  675.         flow allowed."
  676.     ::= { charPortEntry 11 }
  677.  
  678. charPortOutFlowState OBJECT-TYPE
  679.     SYNTAX INTEGER { none(1), unknown(2), stop(3), go(4) }
  680.     MAX-ACCESS read-only
  681.     STATUS current
  682.     DESCRIPTION
  683.         "The current operational state of output flow
  684.         control on the port.  'none' indicates not
  685.         applicable.  'unknown' indicates this level does not
  686.         know.  'stop' indicates flow not allowed.  'go'
  687.         indicates flow allowed."
  688.     ::= { charPortEntry 12 }
  689.  
  690. charPortInCharacters OBJECT-TYPE
  691.     SYNTAX Counter32
  692.     MAX-ACCESS read-only
  693.     STATUS current
  694.     DESCRIPTION
  695.         "Total number of characters detected as input from
  696.         the port since system re-initialization and while
  697.         the port operational state was 'up', 'active', or
  698.         'maintenance', including, for example, framing, flow
  699.         control (i.e. XON and XOFF), each occurrence of a
  700.  
  701.  
  702.  
  703.  
  704.  
  705. Expires 26 November 1994                                       [Page 12]
  706.  
  707.  
  708.  
  709.  
  710.  
  711. draft                        Character MIB                   26 May 1994
  712.  
  713.  
  714.         BREAK condition, locally-processed input, and input
  715.         sent to all sessions."
  716.     ::= { charPortEntry 13 }
  717.  
  718. charPortOutCharacters OBJECT-TYPE
  719.     SYNTAX Counter32
  720.     MAX-ACCESS read-only
  721.     STATUS current
  722.     DESCRIPTION
  723.         "Total number of characters detected as output to
  724.         the port since system re-initialization and while
  725.         the port operational state was 'up', 'active', or
  726.         'maintenance', including, for example, framing, flow
  727.         control (i.e. XON and XOFF), each occurrence of a
  728.         BREAK condition, locally-created output, and output
  729.         received from all sessions."
  730.     ::= { charPortEntry 14 }
  731.  
  732. charPortAdminOrigin OBJECT-TYPE
  733.     SYNTAX INTEGER { dynamic(1), network(2), local(3),
  734.                      none(4) }
  735.     MAX-ACCESS read-write
  736.     STATUS current
  737.     DESCRIPTION
  738.         "The administratively allowed origin for
  739.         establishing session on the port.  'dynamic' allows
  740.         'network' or 'local' session establishment. 'none'
  741.         disallows session establishment."
  742.     ::= { charPortEntry 15 }
  743.  
  744. charPortSessionMaximum OBJECT-TYPE
  745.     SYNTAX INTEGER (-1..2147483647)
  746.     MAX-ACCESS read-write
  747.     STATUS current
  748.     DESCRIPTION
  749.         "The maximum number of concurrent sessions allowed
  750.         on the port.  A value of -1 indicates no maximum.
  751.         Setting the maximum to less than the current number
  752.         of sessions has unspecified results."
  753.     ::= { charPortEntry 16 }
  754.  
  755. charPortSessionNumber OBJECT-TYPE
  756.     SYNTAX Gauge32
  757.     MAX-ACCESS read-only
  758.     STATUS current
  759.  
  760.  
  761.  
  762.  
  763.  
  764. Expires 26 November 1994                                       [Page 13]
  765.  
  766.  
  767.  
  768.  
  769.  
  770. draft                        Character MIB                   26 May 1994
  771.  
  772.  
  773.     DESCRIPTION
  774.         "The number of open sessions on the port that are in
  775.         the connecting, connected, or disconnecting state."
  776.     ::= { charPortEntry 17 }
  777.  
  778. charPortSessionIndex OBJECT-TYPE
  779.     SYNTAX INTEGER (0..2147483647)
  780.     MAX-ACCESS read-only
  781.     STATUS current
  782.     DESCRIPTION
  783.         "The value of charSessIndex for the port's first or
  784.         only active session.  If the port has no active
  785.         session, the agent returns the value zero."
  786.     ::= { charPortEntry 18 }
  787.  
  788. charPortInFlowTypes OBJECT-TYPE
  789.     SYNTAX OCTET STRING (SIZE (1))
  790.     MAX-ACCESS read-write
  791.     STATUS current
  792.     DESCRIPTION
  793.         "The port's types of input flow control at the
  794.         software level.  Hardware-level flow control is
  795.         independently controlled by the appropriate
  796.         hardware-level MIB.
  797.  
  798.         A value of zero indicates no flow control.
  799.         Depending on the specific implementation, any or
  800.         all combinations of flow control may be chosen by
  801.         adding the values:
  802.  
  803.         128  xonXoff, recognizing XON and XOFF characters
  804.         64   enqHost, ENQ/ACK to allow input to host
  805.         32   enqTerm, ACK to allow output to port
  806.         "
  807.     ::= { charPortEntry 19 }
  808.  
  809. charPortOutFlowTypes OBJECT-TYPE
  810.     SYNTAX OCTET STRING (SIZE (1))
  811.     MAX-ACCESS read-write
  812.     STATUS current
  813.     DESCRIPTION
  814.         "The port's types of output flow control at the
  815.         software level.  Hardware-level flow control is
  816.         independently controlled by the appropriate
  817.         hardware-level MIB.
  818.  
  819.  
  820.  
  821.  
  822.  
  823. Expires 26 November 1994                                       [Page 14]
  824.  
  825.  
  826.  
  827.  
  828.  
  829. draft                        Character MIB                   26 May 1994
  830.  
  831.  
  832.         A value of zero indicates no flow control.
  833.         Depending on the specific implementation, any or
  834.         all combinations of flow control may be chosen by
  835.         adding the values:
  836.  
  837.         128  xonXoff, recognizing XON and XOFF characters
  838.         64   enqHost, ENQ/ACK to allow input to host
  839.         32   enqTerm, ACK to allow output to port
  840.         "
  841.     ::= { charPortEntry 20 }
  842.  
  843. charPortLowerIfIndex OBJECT-TYPE
  844.     SYNTAX InterfaceIndex
  845.     MAX-ACCESS read-only
  846.     STATUS current
  847.     DESCRIPTION
  848.         "The ifIndex value of the lower level hardware supporting
  849.         this character port, zero if none."
  850.     ::= { charPortEntry 21 }
  851.  
  852.  
  853. -- the Character Session table
  854.  
  855. charSessTable OBJECT-TYPE
  856.     SYNTAX SEQUENCE OF CharSessEntry
  857.     MAX-ACCESS not-accessible
  858.     STATUS current
  859.     DESCRIPTION
  860.         "A list of port session entries."
  861.     ::= { char 3 }
  862.  
  863. charSessEntry OBJECT-TYPE
  864.     SYNTAX CharSessEntry
  865.     MAX-ACCESS not-accessible
  866.     STATUS current
  867.     DESCRIPTION
  868.         "Status and parameter values for a character port
  869.         session."
  870.     INDEX { charSessPortIndex, charSessIndex }
  871.     ::= { charSessTable 1 }
  872.  
  873. CharSessEntry ::=
  874.     SEQUENCE {
  875.         charSessPortIndex
  876.             PortIndex,
  877.  
  878.  
  879.  
  880.  
  881.  
  882. Expires 26 November 1994                                       [Page 15]
  883.  
  884.  
  885.  
  886.  
  887.  
  888. draft                        Character MIB                   26 May 1994
  889.  
  890.  
  891.         charSessIndex
  892.             INTEGER,
  893.         charSessKill
  894.             INTEGER,
  895.         charSessState
  896.             INTEGER,
  897.         charSessProtocol
  898.             AutonomousType,
  899.         charSessOperOrigin
  900.             INTEGER,
  901.         charSessInCharacters
  902.             Counter32,
  903.         charSessOutCharacters
  904.             Counter32,
  905.         charSessConnectionId
  906.             InstancePointer,
  907.         charSessStartTime
  908.             TimeTicks
  909.     }
  910.  
  911. charSessPortIndex OBJECT-TYPE
  912.     SYNTAX PortIndex
  913.     MAX-ACCESS read-only
  914.     STATUS current
  915.     DESCRIPTION
  916.         "The value of charPortIndex for the port to which
  917.         this session belongs."
  918.     ::= { charSessEntry 1 }
  919.  
  920. charSessIndex OBJECT-TYPE
  921.     SYNTAX INTEGER (1..2147483647)
  922.     MAX-ACCESS read-only
  923.     STATUS current
  924.     DESCRIPTION
  925.         "The session index in the context of the port, a
  926.         non-zero positive integer.  Session indexes within a
  927.         port need not be sequential.  Session indexes may be
  928.         reused for different ports.  For example, port 1 and
  929.         port 3 may both have a session 2 at the same time.
  930.         Session indexes may have any valid integer value,
  931.         with any meaning convenient to the agent
  932.         implementation."
  933.     ::= { charSessEntry 2 }
  934.  
  935. charSessKill OBJECT-TYPE
  936.  
  937.  
  938.  
  939.  
  940.  
  941. Expires 26 November 1994                                       [Page 16]
  942.  
  943.  
  944.  
  945.  
  946.  
  947. draft                        Character MIB                   26 May 1994
  948.  
  949.  
  950.     SYNTAX INTEGER { ready(1), execute(2) }
  951.     MAX-ACCESS read-write
  952.     STATUS current
  953.     DESCRIPTION
  954.         "A control to terminate the session.  In response to
  955.         a get-request or get-next-request, the agent always
  956.         returns 'ready' as the value.  Setting the value to
  957.         'execute' causes termination."
  958.     ::= { charSessEntry 3 }
  959.  
  960. charSessState OBJECT-TYPE
  961.     SYNTAX INTEGER { connecting(1), connected(2),
  962.                      disconnecting(3) }
  963.     MAX-ACCESS read-only
  964.     STATUS current
  965.     DESCRIPTION
  966.         "The current operational state of the session,
  967.         disregarding flow control.  'connected' indicates
  968.         that character data could flow on the network side
  969.         of session.  'connecting' indicates moving from
  970.         nonexistent toward 'connected'.  'disconnecting'
  971.         indicates moving from 'connected' or 'connecting' to
  972.         nonexistent."
  973.     ::= { charSessEntry 4 }
  974.  
  975. charSessProtocol OBJECT-TYPE
  976.     SYNTAX AutonomousType
  977.     MAX-ACCESS read-only
  978.     STATUS current
  979.     DESCRIPTION
  980.         "The network protocol over which the session is
  981.         running.  Other OBJECT IDENTIFIER values may be
  982.         defined elsewhere, in association with specific
  983.         protocols.  However, this document assigns those of
  984.         known interest as of this writing."
  985.     ::= { charSessEntry 5 }
  986.  
  987. wellKnownProtocols OBJECT IDENTIFIER ::= { char 4 }
  988.  
  989. protocolOther  OBJECT IDENTIFIER ::= { wellKnownProtocols 1 }
  990. protocolTelnet OBJECT IDENTIFIER ::= { wellKnownProtocols 2 }
  991. protocolRlogin OBJECT IDENTIFIER ::= { wellKnownProtocols 3 }
  992. protocolLat    OBJECT IDENTIFIER ::= { wellKnownProtocols 4 }
  993. protocolX29    OBJECT IDENTIFIER ::= { wellKnownProtocols 5 }
  994. protocolVtp    OBJECT IDENTIFIER ::= { wellKnownProtocols 6 }
  995.  
  996.  
  997.  
  998.  
  999.  
  1000. Expires 26 November 1994                                       [Page 17]
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006. draft                        Character MIB                   26 May 1994
  1007.  
  1008.  
  1009. charSessOperOrigin OBJECT-TYPE
  1010.     SYNTAX INTEGER { unknown(1), network(2), local(3) }
  1011.     MAX-ACCESS read-only
  1012.     STATUS current
  1013.     DESCRIPTION
  1014.         "The session's source of establishment."
  1015.     ::= { charSessEntry 6 }
  1016.  
  1017. charSessInCharacters OBJECT-TYPE
  1018.     SYNTAX Counter32
  1019.     MAX-ACCESS read-only
  1020.     STATUS current
  1021.     DESCRIPTION
  1022.         "This session's subset of charPortInCharacters."
  1023.     ::= { charSessEntry 7 }
  1024.  
  1025. charSessOutCharacters OBJECT-TYPE
  1026.     SYNTAX Counter32
  1027.     MAX-ACCESS read-only
  1028.     STATUS current
  1029.     DESCRIPTION
  1030.         "This session's subset of charPortOutCharacters."
  1031.     ::= { charSessEntry 8 }
  1032.  
  1033. charSessConnectionId OBJECT-TYPE
  1034.     SYNTAX InstancePointer
  1035.     MAX-ACCESS read-only
  1036.     STATUS current
  1037.     DESCRIPTION
  1038.         "A reference to additional local MIB information.
  1039.         This should be the highest available related MIB,
  1040.         corresponding to charSessProtocol, such as Telnet.
  1041.         For example, the value for a TCP connection (in the
  1042.         absence of a Telnet MIB) is the object identifier of
  1043.         tcpConnState.  If an agent is not configured to have
  1044.         such values, the agent returns the object
  1045.         identifier:
  1046.  
  1047.             nullConnectionId OBJECT IDENTIFIER ::= { 0 0 }
  1048.         "
  1049.     ::= { charSessEntry 9 }
  1050.  
  1051. charSessStartTime OBJECT-TYPE
  1052.     SYNTAX TimeTicks
  1053.     MAX-ACCESS read-only
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059. Expires 26 November 1994                                       [Page 18]
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065. draft                        Character MIB                   26 May 1994
  1066.  
  1067.  
  1068.     STATUS current
  1069.     DESCRIPTION
  1070.         "The value of sysUpTime in MIB-2 when the session
  1071.         entered connecting state."
  1072.     ::= { charSessEntry 10 }
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118. Expires 26 November 1994                                       [Page 19]
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124. draft                        Character MIB                   26 May 1994
  1125.  
  1126.  
  1127. -- conformance information
  1128.  
  1129. charConformance OBJECT IDENTIFIER ::= { char 5 }
  1130.  
  1131. charGroups      OBJECT IDENTIFIER ::= { charConformance 1 }
  1132. charCompliances OBJECT IDENTIFIER ::= { charConformance 2 }
  1133.  
  1134.  
  1135. -- compliance statements
  1136.  
  1137. charCompliance MODULE-COMPLIANCE
  1138.     STATUS  current
  1139.     DESCRIPTION
  1140.             "The compliance statement for SNMPv2 entities
  1141.             which have Character hardware interfaces."
  1142.  
  1143.     MODULE  -- this module
  1144.         MANDATORY-GROUPS { charGroup }
  1145.     ::= { charCompliances 1 }
  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. Expires 26 November 1994                                       [Page 20]
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183. draft                        Character MIB                   26 May 1994
  1184.  
  1185.  
  1186. -- units of conformance
  1187.  
  1188. charGroup    OBJECT-GROUP
  1189.     OBJECTS { charNumber, charPortIndex, charPortName,
  1190.               charPortType, charPortHardware, charPortReset,
  1191.               charPortAdminStatus, charPortOperStatus,
  1192.               charPortLastChange,
  1193.               charPortInFlowState, charPortOutFlowState,
  1194.               charPortAdminOrigin, charPortSessionMaximum,
  1195.               charPortInFlowTypes, charPortOutFlowTypes,
  1196.               charPortInCharacters, charPortOutCharacters,
  1197.               charPortSessionNumber, charPortSessionIndex,
  1198.               charPortLowerIfIndex,
  1199.               charSessPortIndex, charSessIndex,
  1200.               charSessKill, charSessState,
  1201.               charSessProtocol, charSessOperOrigin,
  1202.               charSessInCharacters, charSessOutCharacters,
  1203.               charSessConnectionId, charSessStartTime }
  1204.     STATUS  current
  1205.     DESCRIPTION
  1206.             "A collection of objects providing information
  1207.              applicable to all Character interfaces."
  1208.     ::= { charGroups 1 }
  1209.  
  1210. END
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236. Expires 26 November 1994                                       [Page 21]
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242. draft                        Character MIB                   26 May 1994
  1243.  
  1244.  
  1245. 5.  Acknowledgements
  1246.  
  1247. This memo was produced by the IETF Character MIB Working Group.
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295. Expires 26 November 1994                                       [Page 22]
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301. draft                        Character MIB                   26 May 1994
  1302.  
  1303.  
  1304. 6.  References
  1305.  
  1306. [1]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure
  1307.      of Management Information for version 2 of the Simple Network
  1308.      Management Protocol (SNMPv2)", RFC 1442, SNMP Research,Inc., Hughes
  1309.      LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon
  1310.      University, April 1993.
  1311.  
  1312. [2]  McCloghrie, K., and M. Rose, Editors, "Management Information Base
  1313.      for Network Management of TCP/IP-based internets: MIB-II", STD 17,
  1314.      RFC 1213, Hughes LAN Systems, Performance Systems International,
  1315.      March 1991.
  1316.  
  1317. [3]  Galvin, J., and K. McCloghrie, "Administrative Model for version 2
  1318.      of the Simple Network Management Protocol (SNMPv2)", RFC 1445,
  1319.      Trusted Information Systems, Hughes LAN Systems, April 1993.
  1320.  
  1321. [4]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol
  1322.      Operations for version 2 of the Simple Network Management Protocol
  1323.      (SNMPv2)", RFC 1448, SNMP Research,Inc., Hughes LAN Systems, Dover
  1324.      Beach Consulting, Inc., Carnegie Mellon University, April 1993.
  1325.  
  1326. [5]  McCloghrie, K., and F.J. Kastenholz, "Evolution of the Interfaces
  1327.      Group of MIB-II", RFC 1573, Hughes LAN Systems, FTP Software,
  1328.      January 1994.
  1329.  
  1330.  
  1331. [6]  Stewart, B., "Definitions of Managed Objects for RS-232-like
  1332.      Hardware Devices", RFC ????, Xyplex, Inc., ?Mon?, 1994.
  1333.  
  1334.  
  1335. [7]  Stewart, B., "Definitions of Managed Objects for Parallel-printer-
  1336.      like Hardware Devices", RFC ????, Xyplex, Inc., ?Mon?, 1994.
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354. Expires 26 November 1994                                       [Page 23]
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360. draft                        Character MIB                   26 May 1994
  1361.  
  1362.  
  1363. 7.  Security Considerations
  1364.  
  1365. Security issues are not discussed in this memo.
  1366.  
  1367.  
  1368. 8.  Author's Address
  1369.  
  1370.      Bob Stewart
  1371.      Xyplex, Inc.
  1372.      295 Foster Street
  1373.      Littleton, MA 01460
  1374.  
  1375.                      Tel: 508-952-4816
  1376.                      Fax: 508-952-4887
  1377.                   E-mail: rlstewart@eng.xyplex.com
  1378.  
  1379.      Phone: 508-952-4816
  1380.      Email: rlstewart@eng.xyplex.com
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413. Expires 26 November 1994                                       [Page 24]
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419. draft                        Character MIB                   26 May 1994
  1420.  
  1421.  
  1422. Table of Contents
  1423.  
  1424.  
  1425. 1 Introduction ....................................................    2
  1426. 2 The SNMPv2 Network Management Framework .........................    3
  1427. 2.1 Object Definitions ............................................    3
  1428. 3 Overview ........................................................    4
  1429. 3.1 Relationship to Interface MIB .................................    4
  1430. 4 Definitions .....................................................    5
  1431. 5 Acknowledgements ................................................   22
  1432. 6 References ......................................................   23
  1433. 7 Security Considerations .........................................   24
  1434. 8 Author's Address ................................................   24
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472. Expires 26 November 1994                                       [Page 25]
  1473.  
  1474.