home *** CD-ROM | disk | FTP | other *** search
/ Internet Access: To the Information Highway / InternetAccessToTheInformationHighway1994.disc1of1.iso / internet / rfc4 / rfc1316.txt < prev    next >
Text File  |  1994-06-03  |  36KB  |  955 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                 B. Stewart, Editor
  8. Request for Comments: 1316                                  Xyplex, Inc.
  9.                                                               April 1992
  10.  
  11.  
  12.                      Definitions of Managed Objects
  13.                       for Character Stream Devices
  14.  
  15. Status of this Memo
  16.  
  17.    This RFC specifies an IAB standards track protocol for the Internet
  18.    community, and requests discussion and suggestions for improvements.
  19.    Please refer to the current edition of the "IAB Official Protocol
  20.    Standards" for the standardization state and status of this protocol.
  21.    Distribution of this memo is unlimited.
  22.  
  23. 1.  Abstract
  24.  
  25.    This memo defines a portion of the Management Information Base (MIB)
  26.    for use with network management protocols in TCP/IP based internets.
  27.    In particular it defines objects for the management of character
  28.    stream devices.
  29.  
  30. 2.  The Network Management Framework
  31.  
  32.    The Internet-standard Network Management Framework consists of three
  33.    components.  They are:
  34.  
  35.    RFC 1155 which defines the SMI, the mechanisms used for describing
  36.    and naming objects for the purpose of management. RFC 1212 defines a
  37.    more concise description mechanism, which is wholly consistent with
  38.    the SMI.
  39.  
  40.    RFC 1156 which defines MIB-I, the core set of managed objects for the
  41.    Internet suite of protocols.  RFC 1213, defines MIB-II, an evolution
  42.    of MIB-I based on implementation experience and new operational
  43.    requirements.
  44.  
  45.    RFC 1157 which defines the SNMP, the protocol used for network access
  46.    to managed objects.
  47.  
  48.    The Framework permits new objects to be defined for the purpose of
  49.    experimentation and evaluation.
  50.  
  51. 3.  Objects
  52.  
  53.    Managed objects are accessed via a virtual information store, termed
  54.    the Management Information Base or MIB. Objects in the MIB are
  55.  
  56.  
  57.  
  58. Character MIB Working Group                                     [Page 1]
  59.  
  60. RFC 1316                     Character MIB                    April 1992
  61.  
  62.  
  63.    defined using the subset of Abstract Syntax Notation One (ASN.1) [7]
  64.    defined in the SMI.  In particular, each object has a name, a syntax,
  65.    and an encoding.  The name is an object identifier, an
  66.    administratively assigned name, which specifies an object type.
  67.  
  68.    The object type together with an object instance serves to uniquely
  69.    identify a specific instantiation of the object. For human
  70.    convenience, we often use a textual string, termed the OBJECT
  71.    DESCRIPTOR, to also refer to the object type.
  72.  
  73.    The syntax of an object type defines the abstract data structure
  74.    corresponding to that object type.  The ASN.1 language is used for
  75.    this purpose.  However, the SMI [3] purposely restricts the ASN.1
  76.    constructs which may be used. These restrictions are explicitly made
  77.    for simplicity.
  78.  
  79.    The encoding of an object type is simply how that object type is
  80.    represented using the object type's syntax. Implicitly tied to the
  81.    notion of an object type's syntax and encoding is how the object type
  82.    is represented when being transmitted on the network.
  83.  
  84.    The SMI specifies the use of the basic encoding rules of ASN.1 [8],
  85.    subject to the additional requirements imposed by the SNMP.
  86.  
  87. 3.1.  Format of Definitions
  88.  
  89.    Section 5 contains the specification of all object types contained in
  90.    this MIB module.  The object types are defined using the conventions
  91.    defined in the SMI, as amended by the extensions specified in [9,10].
  92.  
  93. 4.  Overview
  94.  
  95.    The Character MIB applies to interface ports that carry a character
  96.    stream, whether physical or virtual, serial or parallel, synchronous
  97.    or asynchronous.  The most common example of a character port is a
  98.    hardware terminal port with an RS-232 interface.  Another common
  99.    hardware example is a parallel printer port, say with a Centronics
  100.    interface.  The concept also includes virtual terminal ports, such as
  101.    a software connection point for a remote console.
  102.  
  103.    The Character MIB is one of a set of MIBs designed for complementary
  104.    use.  At this writing, the set comprises:
  105.  
  106.         Character MIB
  107.         PPP MIB
  108.         RS-232-like MIB
  109.         Parallel-printer-like MIB
  110.  
  111.  
  112.  
  113.  
  114. Character MIB Working Group                                     [Page 2]
  115.  
  116. RFC 1316                     Character MIB                    April 1992
  117.  
  118.  
  119.    The RS-232-like MIB and the Parallel-printer-like MIB represent the
  120.    physical layer, providing service to higher layers such as the
  121.    Character MIB or PPP MIB.  Further MIBs may appear above these.
  122.  
  123.    The following diagram shows two possible "MIB stacks", each using the
  124.    RS-232-like MIB.
  125.  
  126.                                                .-----------------.
  127.                     .-----------------.        |  Standard MIB   |
  128.                     |   Telnet MIB    |        | Interface Group |
  129.                     |-----------------|        |-----------------|
  130.                     |  Character MIB  |        |     PPP MIB     |
  131.                     |-----------------|        |-----------------|
  132.                     | RS-232-like MIB |        | RS-232-like MIB |
  133.                     `-----------------'        `-----------------'
  134.  
  135.    The intent of the model is for the physical-level MIBs to represent
  136.    the lowest level, regardless of the higher level that may be using
  137.    it.  In turn, separate higher level MIBs represent specific
  138.    applications, such as a terminal (the Character MIB) or a network
  139.    connection (the PPP MIB).
  140.  
  141.    For the most part, character ports are distinct from network
  142.    interfaces (which are already covered by the Interface group).  In
  143.    general, they are attachment points for non-network devices.  The
  144.    exception is a character port that can support a network protocol,
  145.    such as SLIP or PPP.  This implies the existence of a corresponding
  146.    entry in the Interfaces table, with ifOperStatus of 'off' while the
  147.    port is not running a network protocol and 'on' if it is.  The intent
  148.    is that such usage is exclusive of non-network character stream
  149.    usage.  That is, while switched to network use, charPortOperStatus
  150.    would be 'down' and Character MIB operational values such as
  151.    charPortInFlowState and charPortInCharacters would be inactive.
  152.  
  153.    The Character MIB is mandatory for all systems that offer character
  154.    ports.  This includes, for example, terminal servers, general-purpose
  155.    time-sharing hosts, and even such systems as a bridge with a
  156.    (virtual) console port.  It may or may not include character ports
  157.    that do not support network sessions, depending on the system's
  158.    needs.
  159.  
  160.    The Character MIB's central abstraction is a port.  Physical ports
  161.    have a one-to-one correspondence with hardware ports. Virtual ports
  162.    are software entities analogous to physical ports, but with no
  163.    hardware connector.
  164.  
  165.    Each port supports one or more sessions.  A session represents a
  166.    virtual connection that carries characters between the port and some
  167.  
  168.  
  169.  
  170. Character MIB Working Group                                     [Page 3]
  171.  
  172. RFC 1316                     Character MIB                    April 1992
  173.  
  174.  
  175.    partner.  Sessions typically operate over a stack of network
  176.    protocols.  A typical session, for example, uses Telnet over TCP.
  177.  
  178.    The MIB comprises one base object and two tables, detailed in the
  179.    following sections.  The tables contain objects for ports and
  180.    sessions.
  181.  
  182.    The MIB intentionally contains no distinction between what is often
  183.    called permanent and operational or volatile data bases.  For the
  184.    purposes of this MIB, handling of such distinctions is implementation
  185.    specific.
  186.  
  187. 5.  Definitions
  188.  
  189.                     RFC1316-MIB DEFINITIONS ::= BEGIN
  190.  
  191.                     IMPORTS
  192.                             Counter, TimeTicks, Gauge
  193.                                     FROM RFC1155-SMI
  194.                             DisplayString
  195.                                     FROM RFC1213-MIB
  196.                             OBJECT-TYPE
  197.                                     FROM RFC-1212;
  198.  
  199.             -- this is the MIB module for character stream devices
  200.  
  201.             char    OBJECT IDENTIFIER ::= { mib-2 19 }
  202.  
  203.             -- Textual Conventions
  204.  
  205.                 AutonomousType    ::= OBJECT IDENTIFIER
  206.  
  207.             -- The object identifier is an independently extensible type
  208.             -- identification value.  It may, for example indicate a
  209.             -- particular sub-tree with further MIB definitions, or
  210.             -- define something like a protocol type or type of
  211.             -- hardware.
  212.  
  213.                 InstancePointer   ::= OBJECT IDENTIFIER
  214.  
  215.             -- The object identifier is a pointer to a specific instance
  216.             -- of a MIB object in this agent's implemented MIB.  By
  217.             -- convention, it is the first object in the conceptual row
  218.             -- for the instance.
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226. Character MIB Working Group                                     [Page 4]
  227.  
  228. RFC 1316                     Character MIB                    April 1992
  229.  
  230.  
  231.             -- the generic Character group
  232.  
  233.             -- Implementation of this group is mandatory for all
  234.             -- systems that offer character ports
  235.  
  236.             charNumber OBJECT-TYPE
  237.                 SYNTAX INTEGER
  238.                 ACCESS read-only
  239.                 STATUS mandatory
  240.                 DESCRIPTION
  241.                     "The number of entries in charPortTable, regardless
  242.                     of their current state."
  243.                 ::= { char 1 }
  244.  
  245.  
  246.             -- the Character Port table
  247.  
  248.             charPortTable OBJECT-TYPE
  249.                 SYNTAX SEQUENCE OF CharPortEntry
  250.                 ACCESS not-accessible
  251.                 STATUS mandatory
  252.                 DESCRIPTION
  253.                     "A list of port entries.  The number of entries is
  254.                     given by the value of charNumber."
  255.                 ::= { char 2 }
  256.  
  257.             charPortEntry OBJECT-TYPE
  258.                 SYNTAX CharPortEntry
  259.                 ACCESS not-accessible
  260.                 STATUS mandatory
  261.                 DESCRIPTION
  262.                     "Status and parameter values for a character port."
  263.                 INDEX { charPortIndex }
  264.                 ::= { charPortTable 1 }
  265.  
  266.             CharPortEntry ::=
  267.                 SEQUENCE {
  268.                     charPortIndex
  269.                         INTEGER,
  270.                     charPortName
  271.                         DisplayString,
  272.                     charPortType
  273.                         INTEGER,
  274.                     charPortHardware
  275.                         AutonomousType,
  276.                     charPortReset
  277.                         INTEGER,
  278.                     charPortAdminStatus
  279.  
  280.  
  281.  
  282. Character MIB Working Group                                     [Page 5]
  283.  
  284. RFC 1316                     Character MIB                    April 1992
  285.  
  286.  
  287.                         INTEGER,
  288.                     charPortOperStatus
  289.                         INTEGER,
  290.                     charPortLastChange
  291.                         TimeTicks,
  292.                     charPortInFlowType
  293.                         INTEGER,
  294.                     charPortOutFlowType
  295.                         INTEGER,
  296.                     charPortInFlowState
  297.                         INTEGER,
  298.                     charPortOutFlowState
  299.                         INTEGER,
  300.                     charPortInCharacters
  301.                         Counter,
  302.                     charPortOutCharacters
  303.                         Counter,
  304.                     charPortAdminOrigin
  305.                         INTEGER,
  306.                     charPortSessionMaximum
  307.                         INTEGER,
  308.                     charPortSessionNumber
  309.                         Gauge,
  310.                     charPortSessionIndex
  311.                         INTEGER
  312.                 }
  313.  
  314.             charPortIndex OBJECT-TYPE
  315.                 SYNTAX INTEGER
  316.                 ACCESS read-only
  317.                 STATUS mandatory
  318.                 DESCRIPTION
  319.                     "A unique value for each character port.  Its value
  320.                     ranges between 1 and the value of charNumber.  By
  321.                     convention and if possible, hardware port numbers
  322.                     come first, with a simple, direct mapping.  The
  323.                     value for each port must remain constant at least
  324.                     from one re-initialization of the network management
  325.                     agent to the next."
  326.                 ::= { charPortEntry 1 }
  327.  
  328.             charPortName OBJECT-TYPE
  329.                 SYNTAX DisplayString (SIZE (0..32))
  330.                 ACCESS read-write
  331.                 STATUS mandatory
  332.                 DESCRIPTION
  333.                     "An administratively assigned name for the port,
  334.                     typically with some local significance."
  335.  
  336.  
  337.  
  338. Character MIB Working Group                                     [Page 6]
  339.  
  340. RFC 1316                     Character MIB                    April 1992
  341.  
  342.  
  343.                 ::= { charPortEntry 2 }
  344.  
  345.             charPortType OBJECT-TYPE
  346.                 SYNTAX INTEGER { physical(1), virtual(2) }
  347.                 ACCESS read-only
  348.                 STATUS mandatory
  349.                 DESCRIPTION
  350.                     "The port's type, 'physical' if the port represents
  351.                     an external hardware connector, 'virtual' if it does
  352.                     not."
  353.                 ::= { charPortEntry 3 }
  354.  
  355.             charPortHardware OBJECT-TYPE
  356.                 SYNTAX AutonomousType
  357.                 ACCESS read-only
  358.                 STATUS mandatory
  359.                 DESCRIPTION
  360.                     "A reference to hardware MIB definitions specific to
  361.                     a physical port's external connector.  For example,
  362.                     if the connector is RS-232, then the value of this
  363.                     object refers to a MIB sub-tree defining objects
  364.                     specific to RS-232.  If an agent is not configured
  365.                     to have such values, the agent returns the object
  366.                     identifier:
  367.  
  368.                         nullHardware OBJECT IDENTIFIER ::= { 0 0 }
  369.                     "
  370.                 ::= { charPortEntry 4 }
  371.  
  372.             charPortReset OBJECT-TYPE
  373.                 SYNTAX INTEGER { ready(1), execute(2) }
  374.                 ACCESS read-write
  375.                 STATUS mandatory
  376.                 DESCRIPTION
  377.                     "A control to force the port into a clean, initial
  378.                     state, both hardware and software, disconnecting all
  379.                     the port's existing sessions.  In response to a
  380.                     get-request or get-next-request, the agent always
  381.                     returns 'ready' as the value.  Setting the value to
  382.                     'execute' causes a reset."
  383.                 ::= { charPortEntry 5 }
  384.  
  385.             charPortAdminStatus OBJECT-TYPE
  386.                 SYNTAX INTEGER { enabled(1), disabled(2), off(3),
  387.                                  maintenance(4) }
  388.                 ACCESS read-write
  389.                 STATUS mandatory
  390.                 DESCRIPTION
  391.  
  392.  
  393.  
  394. Character MIB Working Group                                     [Page 7]
  395.  
  396. RFC 1316                     Character MIB                    April 1992
  397.  
  398.  
  399.                     "The port's desired state, independent of flow
  400.                     control.  'enabled' indicates that the port is
  401.                     allowed to pass characters and form new sessions.
  402.                     'disabled' indicates that the port is allowed to
  403.                     pass characters but not form new sessions.  'off'
  404.                     indicates that the port is not allowed to pass
  405.                     characters or have any sessions. 'maintenance'
  406.                     indicates a maintenance mode, exclusive of normal
  407.                     operation, such as running a test."
  408.                 ::= { charPortEntry 6 }
  409.  
  410.             charPortOperStatus OBJECT-TYPE
  411.                 SYNTAX INTEGER { up(1), down(2),
  412.                                  maintenance(3), absent(4), active(5) }
  413.                 ACCESS read-only
  414.                 STATUS mandatory
  415.                 DESCRIPTION
  416.                     "The port's actual, operational state, independent
  417.                     of flow control.  'up' indicates able to function
  418.                     normally.  'down' indicates inability to function
  419.                     for administrative or operational reasons.
  420.                     'maintenance' indicates a maintenance mode,
  421.                     exclusive of normal operation, such as running a
  422.                     test.  'absent' indicates that port hardware is not
  423.                     present.  'active' indicates up with a user present
  424.                     (e.g. logged in)."
  425.                 ::= { charPortEntry 7 }
  426.  
  427.             charPortLastChange OBJECT-TYPE
  428.                 SYNTAX TimeTicks
  429.                 ACCESS read-only
  430.                 STATUS mandatory
  431.                 DESCRIPTION
  432.                     "The value of sysUpTime at the time the port entered
  433.                     its current operational state.  If the current state
  434.                     was entered prior to the last reinitialization of
  435.                     the local network management subsystem, then this
  436.                     object contains a zero value."
  437.                 ::= { charPortEntry 8 }
  438.  
  439.             charPortInFlowType OBJECT-TYPE
  440.                 SYNTAX INTEGER { none(1), xonXoff(2), hardware(3),
  441.                                  ctsRts(4), dsrDtr(5) }
  442.                 ACCESS read-write
  443.                 STATUS mandatory
  444.                 DESCRIPTION
  445.                     "The port's type of input flow control.  'none'
  446.                     indicates no flow control at this level or below.
  447.  
  448.  
  449.  
  450. Character MIB Working Group                                     [Page 8]
  451.  
  452. RFC 1316                     Character MIB                    April 1992
  453.  
  454.  
  455.                     'xonXoff' indicates software flow control by
  456.                     recognizing XON and XOFF characters.  'hardware'
  457.                     indicates flow control delegated to the lower level,
  458.                     for example a parallel port.
  459.  
  460.                     'ctsRts' and 'dsrDtr' are specific to RS-232-like
  461.                     ports.  Although not architecturally pure, they are
  462.                     included here for simplicity's sake."
  463.                 ::= { charPortEntry 9 }
  464.  
  465.             charPortOutFlowType OBJECT-TYPE
  466.                 SYNTAX INTEGER { none(1), xonXoff(2), hardware(3),
  467.                                  ctsRts(4), dsrDtr(5) }
  468.                 ACCESS read-write
  469.                 STATUS mandatory
  470.                 DESCRIPTION
  471.                     "The port's type of output flow control.  'none'
  472.                     indicates no flow control at this level or below.
  473.                     'xonXoff' indicates software flow control by
  474.                     recognizing XON and XOFF characters.  'hardware'
  475.                     indicates flow control delegated to the lower level,
  476.                     for example a parallel port.
  477.  
  478.                     'ctsRts' and 'dsrDtr' are specific to RS-232-like
  479.                     ports.  Although not architecturally pure, they are
  480.                     included here for simplicy's sake."
  481.                 ::= { charPortEntry 10 }
  482.  
  483.             charPortInFlowState OBJECT-TYPE
  484.                 SYNTAX INTEGER { none(1), unknown(2), stop(3), go(4) }
  485.                 ACCESS read-only
  486.                 STATUS mandatory
  487.                 DESCRIPTION
  488.                     "The current operational state of input flow control
  489.                     on the port.  'none' indicates not applicable.
  490.                     'unknown' indicates this level does not know.
  491.                     'stop' indicates flow not allowed.  'go' indicates
  492.                     flow allowed."
  493.                 ::= { charPortEntry 11 }
  494.  
  495.             charPortOutFlowState OBJECT-TYPE
  496.                 SYNTAX INTEGER { none(1), unknown(2), stop(3), go(4) }
  497.                 ACCESS read-only
  498.                 STATUS mandatory
  499.                 DESCRIPTION
  500.                     "The current operational state of output flow
  501.                     control on the port.  'none' indicates not
  502.                     applicable.  'unknown' indicates this level does not
  503.  
  504.  
  505.  
  506. Character MIB Working Group                                     [Page 9]
  507.  
  508. RFC 1316                     Character MIB                    April 1992
  509.  
  510.  
  511.                     know.  'stop' indicates flow not allowed.  'go'
  512.                     indicates flow allowed."
  513.                 ::= { charPortEntry 12 }
  514.  
  515.             charPortInCharacters OBJECT-TYPE
  516.                 SYNTAX Counter
  517.                 ACCESS read-only
  518.                 STATUS mandatory
  519.                 DESCRIPTION
  520.                     "Total number of characters detected as input from
  521.                     the port since system re-initialization and while
  522.                     the port operational state was 'up', 'active', or
  523.                     'maintenance', including, for example, framing, flow
  524.                     control (i.e. XON and XOFF), each occurrence of a
  525.                     BREAK condition, locally-processed input, and input
  526.                     sent to all sessions."
  527.                 ::= { charPortEntry 13 }
  528.  
  529.             charPortOutCharacters OBJECT-TYPE
  530.                 SYNTAX Counter
  531.                 ACCESS read-only
  532.                 STATUS mandatory
  533.                 DESCRIPTION
  534.                     "Total number of characters detected as output to
  535.                     the port since system re-initialization and while
  536.                     the port operational state was 'up', 'active', or
  537.                     'maintenance', including, for example, framing, flow
  538.                     control (i.e. XON and XOFF), each occurrence of a
  539.                     BREAK condition, locally-created output, and output
  540.                     received from all sessions."
  541.                 ::= { charPortEntry 14 }
  542.  
  543.             charPortAdminOrigin OBJECT-TYPE
  544.                 SYNTAX INTEGER { dynamic(1), network(2), local(3),
  545.                                  none(4) }
  546.                 ACCESS read-write
  547.                 STATUS mandatory
  548.                 DESCRIPTION
  549.                     "The administratively allowed origin for
  550.                     establishing session on the port.  'dynamic' allows
  551.                     'network' or 'local' session establishment. 'none'
  552.                     disallows session establishment."
  553.                 ::= { charPortEntry 15 }
  554.  
  555.             charPortSessionMaximum OBJECT-TYPE
  556.                 SYNTAX INTEGER
  557.                 ACCESS read-write
  558.                 STATUS mandatory
  559.  
  560.  
  561.  
  562. Character MIB Working Group                                    [Page 10]
  563.  
  564. RFC 1316                     Character MIB                    April 1992
  565.  
  566.  
  567.                 DESCRIPTION
  568.                     "The maximum number of concurrent sessions allowed
  569.                     on the port.  A value of -1 indicates no maximum.
  570.                     Setting the maximum to less than the current number
  571.                     of sessions has unspecified results."
  572.                 ::= { charPortEntry 16 }
  573.  
  574.             charPortSessionNumber OBJECT-TYPE
  575.                 SYNTAX Gauge
  576.                 ACCESS read-only
  577.                 STATUS mandatory
  578.                 DESCRIPTION
  579.                     "The number of open sessions on the port that are in
  580.                     the connecting, connected, or disconnecting state."
  581.                 ::= { charPortEntry 17 }
  582.  
  583.             charPortSessionIndex OBJECT-TYPE
  584.                 SYNTAX INTEGER
  585.                 ACCESS read-only
  586.                 STATUS mandatory
  587.                 DESCRIPTION
  588.                     "The value of charSessIndex for the port's first or
  589.                     only active session.  If the port has no active
  590.                     session, the agent returns the value zero."
  591.                 ::= { charPortEntry 18 }
  592.  
  593.  
  594.             -- the Character Session table
  595.  
  596.             charSessTable OBJECT-TYPE
  597.                 SYNTAX SEQUENCE OF CharSessEntry
  598.                 ACCESS not-accessible
  599.                 STATUS mandatory
  600.                 DESCRIPTION
  601.                     "A list of port session entries."
  602.                 ::= { char 3 }
  603.  
  604.             charSessEntry OBJECT-TYPE
  605.                 SYNTAX CharSessEntry
  606.                 ACCESS not-accessible
  607.                 STATUS mandatory
  608.                 DESCRIPTION
  609.                     "Status and parameter values for a character port
  610.                     session."
  611.                 INDEX { charSessPortIndex, charSessIndex }
  612.                 ::= { charSessTable 1 }
  613.  
  614.  
  615.  
  616.  
  617.  
  618. Character MIB Working Group                                    [Page 11]
  619.  
  620. RFC 1316                     Character MIB                    April 1992
  621.  
  622.  
  623.             CharSessEntry ::=
  624.                 SEQUENCE {
  625.                     charSessPortIndex
  626.                         INTEGER,
  627.                     charSessIndex
  628.                         INTEGER,
  629.                     charSessKill
  630.                         INTEGER,
  631.                     charSessState
  632.                         INTEGER,
  633.                     charSessProtocol
  634.                         AutonomousType,
  635.                     charSessOperOrigin
  636.                         INTEGER,
  637.                     charSessInCharacters
  638.                         Counter,
  639.                     charSessOutCharacters
  640.                         Counter,
  641.                     charSessConnectionId
  642.                         InstancePointer,
  643.                     charSessStartTime
  644.                         TimeTicks
  645.                 }
  646.  
  647.             charSessPortIndex OBJECT-TYPE
  648.                 SYNTAX INTEGER
  649.                 ACCESS read-only
  650.                 STATUS mandatory
  651.                 DESCRIPTION
  652.                     "The value of charPortIndex for the port to which
  653.                     this session belongs."
  654.                 ::= { charSessEntry 1 }
  655.  
  656.             charSessIndex OBJECT-TYPE
  657.                 SYNTAX INTEGER
  658.                 ACCESS read-only
  659.                 STATUS mandatory
  660.                 DESCRIPTION
  661.                     "The session index in the context of the port, a
  662.                     non-zero positive integer.  Session indexes within a
  663.                     port need not be sequential.  Session indexes may be
  664.                     reused for different ports.  For example, port 1 and
  665.                     port 3 may both have a session 2 at the same time.
  666.                     Session indexes may have any valid integer value,
  667.                     with any meaning convenient to the agent
  668.                     implementation."
  669.                 ::= { charSessEntry 2 }
  670.  
  671.  
  672.  
  673.  
  674. Character MIB Working Group                                    [Page 12]
  675.  
  676. RFC 1316                     Character MIB                    April 1992
  677.  
  678.  
  679.             charSessKill OBJECT-TYPE
  680.                 SYNTAX INTEGER { ready(1), execute(2) }
  681.                 ACCESS read-write
  682.                 STATUS mandatory
  683.                 DESCRIPTION
  684.                     "A control to terminate the session.  In response to
  685.                     a get-request or get-next-request, the agent always
  686.                     returns 'ready' as the value.  Setting the value to
  687.                     'execute' causes termination."
  688.                 ::= { charSessEntry 3 }
  689.  
  690.             charSessState OBJECT-TYPE
  691.                 SYNTAX INTEGER { connecting(1), connected(2),
  692.                                  disconnecting(3) }
  693.                 ACCESS read-only
  694.                 STATUS mandatory
  695.                 DESCRIPTION
  696.                     "The current operational state of the session,
  697.                     disregarding flow control.  'connected' indicates
  698.                     that character data could flow on the network side
  699.                     of session.  'connecting' indicates moving from
  700.                     nonexistent toward 'connected'.  'disconnecting'
  701.                     indicates moving from 'connected' or 'connecting' to
  702.                     nonexistent."
  703.                 ::= { charSessEntry 4 }
  704.  
  705.             charSessProtocol OBJECT-TYPE
  706.                 SYNTAX AutonomousType
  707.                 ACCESS read-only
  708.                 STATUS mandatory
  709.                 DESCRIPTION
  710.                     "The network protocol over which the session is
  711.                     running.  Other OBJECT IDENTIFIER values may be
  712.                     defined elsewhere, in association with specific
  713.                     protocols.  However, this document assigns those of
  714.                     known interest as of this writing."
  715.                 ::= { charSessEntry 5 }
  716.  
  717.             wellKnownProtocols OBJECT IDENTIFIER ::= { char 4 }
  718.  
  719.             protocolOther  OBJECT IDENTIFIER ::= {wellKnownProtocols 1}
  720.             protocolTelnet OBJECT IDENTIFIER ::= {wellKnownProtocols 2}
  721.             protocolRlogin OBJECT IDENTIFIER ::= {wellKnownProtocols 3}
  722.             protocolLat    OBJECT IDENTIFIER ::= {wellKnownProtocols 4}
  723.             protocolX29    OBJECT IDENTIFIER ::= {wellKnownProtocols 5}
  724.             protocolVtp    OBJECT IDENTIFIER ::= {wellKnownProtocols 6}
  725.  
  726.  
  727.  
  728.  
  729.  
  730. Character MIB Working Group                                    [Page 13]
  731.  
  732. RFC 1316                     Character MIB                    April 1992
  733.  
  734.  
  735.             charSessOperOrigin OBJECT-TYPE
  736.                 SYNTAX INTEGER { unknown(1), network(2), local(3) }
  737.                 ACCESS read-only
  738.                 STATUS mandatory
  739.                 DESCRIPTION
  740.                     "The session's source of establishment."
  741.                 ::= { charSessEntry 6 }
  742.  
  743.             charSessInCharacters OBJECT-TYPE
  744.                 SYNTAX Counter
  745.                 ACCESS read-only
  746.                 STATUS mandatory
  747.                 DESCRIPTION
  748.                     "This session's subset of charPortInCharacters."
  749.                 ::= { charSessEntry 7 }
  750.  
  751.             charSessOutCharacters OBJECT-TYPE
  752.                 SYNTAX Counter
  753.                 ACCESS read-only
  754.                 STATUS mandatory
  755.                 DESCRIPTION
  756.                     "This session's subset of charPortOutCharacters."
  757.                 ::= { charSessEntry 8 }
  758.  
  759.             charSessConnectionId OBJECT-TYPE
  760.                 SYNTAX InstancePointer
  761.                 ACCESS read-only
  762.                 STATUS mandatory
  763.                 DESCRIPTION
  764.                     "A reference to additional local MIB information.
  765.                     This should be the highest available related MIB,
  766.                     corresponding to charSessProtocol, such as Telnet.
  767.                     For example, the value for a TCP connection (in the
  768.                     absence of a Telnet MIB) is the object identifier of
  769.                     tcpConnState.  If an agent is not configured to have
  770.                     such values, the agent returns the object
  771.                     identifier:
  772.  
  773.                         nullConnectionId OBJECT IDENTIFIER ::= { 0 0 }
  774.                     "
  775.                 ::= { charSessEntry 9 }
  776.  
  777.             charSessStartTime OBJECT-TYPE
  778.                 SYNTAX TimeTicks
  779.                 ACCESS read-only
  780.                 STATUS mandatory
  781.                 DESCRIPTION
  782.                     "The value of sysUpTime in MIB-2 when the session
  783.  
  784.  
  785.  
  786. Character MIB Working Group                                    [Page 14]
  787.  
  788. RFC 1316                     Character MIB                    April 1992
  789.  
  790.  
  791.                     entered connecting state."
  792.                 ::= { charSessEntry 10 }
  793.  
  794.             END
  795.  
  796. 6.  Acknowledgements
  797.  
  798.    Based on several private MIBs, this document was produced by the
  799.    Character MIB Working Group:
  800.  
  801.                 Anne Ambler, Spider
  802.                 Charles Bazaar, Emulex
  803.                 Christopher Bucci, Datability
  804.                 Anthony Chung, Hughes LAN Systems
  805.                 George Conant, Xyplex
  806.                 John Cook, Chipcom
  807.                 James Davin, MIT-LCS
  808.                 Shawn Gallagher, DEC
  809.                 Tom Grant, Xylogics
  810.                 Frank Huang, Emulex
  811.                 David Jordan, Emulex
  812.                 Satish Joshi, SynOptics
  813.                 Frank Kastenholz, Clearpoint
  814.                 Ken Key, University of Tennessee
  815.                 Jim Kinder, Fibercom
  816.                 Rajeev Kochhar, 3Com
  817.                 John LoVerso, Xylogics
  818.                 Keith McCloghrie, Hughes LAN Systems
  819.                 Donald Merritt, BRL
  820.                 David Perkins, 3Com
  821.                 Jim Reinstedler, Ungerman-Bass
  822.                 Marshall Rose, PSI
  823.                 Ron Strich, SSDS
  824.                 Dean Throop, DG
  825.                 Bill Townsend, Xylogics
  826.                 Jesse Walker, DEC
  827.                 David Waitzman, BBN
  828.                 Bill Westfield, cisco
  829.  
  830. 7.  References
  831.  
  832.    [1] Cerf, V., "IAB Recommendations for the Development of
  833.        Internet  Network Management Standards", RFC 1052, NRI,
  834.        April 1988.
  835.  
  836.    [2] Cerf, V., "Report of the Second Ad Hoc Network
  837.        Management Review  Group", RFC 1109, NRI, August 1989.
  838.  
  839.  
  840.  
  841.  
  842. Character MIB Working Group                                    [Page 15]
  843.  
  844. RFC 1316                     Character MIB                    April 1992
  845.  
  846.  
  847.    [3] Rose M., and K. McCloghrie, "Structure and
  848.        Identification of  Management Information for TCP/IP-based
  849.        internets", RFC 1155,  Performance Systems International,
  850.        Hughes LAN Systems, May 1990.
  851.  
  852.    [4] McCloghrie K., and M. Rose, "Management Information Base
  853.        for  Network Management of TCP/IP-based internets", RFC
  854.        1156, Hughes  LAN Systems, Performance Systems
  855.        International, May 1990.
  856.  
  857.    [5] Case, J., Fedor, M., Schoffstall, M., and J. Davin,
  858.        "Simple  Network Management Protocol", RFC 1157, SNMP
  859.        Research,  Performance Systems International, Performance
  860.        Systems  International, MIT Laboratory for Computer Science,
  861.        May 1990.
  862.  
  863.    [6] McCloghrie K., and M. Rose, Editors, "Management
  864.        Information Base  for Network Management of TCP/IP-based
  865.        internets", RFC 1213,  Performance Systems International,
  866.        March 1991.
  867.  
  868.    [7] Information processing systems - Open Systems
  869.        Interconnection -  Specification of Abstract Syntax Notation
  870.        One (ASN.1),  International Organization for
  871.        Standardization, International  Standard 8824, December
  872.        1987.
  873.  
  874.    [8] Information processing systems - Open Systems
  875.        Interconnection -  Specification of Basic Encoding Rules for
  876.        Abstract Notation One  (ASN.1), International Organization
  877.        for Standardization,  International Standard 8825, December
  878.        1987.
  879.  
  880.    [9] Rose, M., and K. McCloghrie, Editors, "Concise MIB
  881.        Definitions",  RFC 1212, Performance Systems International,
  882.        Hughes LAN Systems,  March 1991.
  883.  
  884.   [10] Rose, M., Editor, "A Convention for Defining Traps for
  885.        use with  the SNMP", RFC 1215, Performance Systems
  886.        International, March 1991.
  887.  
  888. 8.  Security Considerations
  889.  
  890.    Security issues are not discussed in this memo.
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898. Character MIB Working Group                                    [Page 16]
  899.  
  900. RFC 1316                     Character MIB                    April 1992
  901.  
  902.  
  903. 9.  Author's Address
  904.  
  905.    Bob Stewart
  906.    Xyplex, Inc.
  907.    330 Codman Hill Road
  908.    Boxborough, MA 01719
  909.  
  910.    Phone: (508) 264-9900
  911.    EMail: rlstewart@eng.xyplex.com
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954. Character MIB Working Group                                    [Page 17]
  955.