NETWORK WORKING GROUP                                           NIC 5740
Request for Comments #97                                  John T. Melvin
                                                      Richard W. Watson
                                                                SRI-ARC
                                                       15 February 1971


              A FIRST CUT AT A PROPOSED TELNET PROTOCOL

1    Introduction

      This paper describes a first cut at a proposed Telnet protocol.
  _Telnet_ is a process which runs at a _user's_ _site_ and allows him
  to utilize a typewriter-like terminal to gain interactive service
  from a remote _server_ _site over the ARPA Network.  This paper was
  motivated by our need to set specifications for a protocol which
  would allow online access to the Network Information Center (NIC).
  The Online System running at the Network Information Center we will
  refer to as NLS(NIC).  On thinking about the problem of setting
  specifications for access to the NIC, we have tried to generalize our
  ideas so that they would apply to other systems with characteristics
  similar to ours.  We realize that there are other terminal hardware-
  software disciplines which might find it difficult to conform to all
  the requirements stated here and, therefore, the final Telnet
  protocol will differ from the one stated in this NWG/RFC.  One
  conclusion that we may all have to come to is that connection with
  the network may force us toward a more standard way of handling
  terminals and their character streams in our monitors and terminal
  control hardware.  In the meantime, we hope that this paper and
  others on the same subject that may be in process, coupled with a
  survey of hardware-software requirements at each site by a NWG
  subgroup, can result in an initial standard network Telnet protocol
  being agreed upon quickly, as it is important to get users onto the
  network as soon as possible so that interactive network usage can
  indicate further directions for network protocol evolution.  Next we
  outline some design problems, then propose some conventions to solve
  these problems for access to systems such as the NLS(NIC) and
  indicate some problems needing further study.  The proposed
  conventions for access to the NLS(NIC) are summarized in Appendix A.

2    Some Design Problems

  2A.  Basic Assumption

       The function of the Telnet process is to make a terminal at a
  user site appear over the network as logically equivalent to a
  terminal "directly" connected to the server site.  There are a number
  of implications of this basic function.



Melvin & Watson                                                 [Page 1]

RFC 97                  Proposed Telnet Protocol           February 1971


     i) The user should be able to cause generation of all codes which
     a server system terminal can generate.  With respect to the
     Network Information Center and some other sites it would seem a
     reasonable requirement to have keying conventions so that the user
     can generate all 128 ASCII character codes as input to the
     network.  Other sites with different character codes may require a
     Telnet process to provide those codes to the network.

     ii) The user should be able to escape back to his local system or
     escape from the server process to the server system.

     iii) The Telnets  of line-at-a-time systems should be able to work
     with character-at-a-time systems and line-at-a-time systems and
     Telnets  of character-at-a-time systems should be able to work
     with line-at-a-time and character-at-a-time systems.

  2B   Echo Control

       We use the term echo control rather than the terms half duplex
  or full duplex because the Telnet connection is in reality full
  duplex with respect to network transmissions.  Three terminal cases
  need to be considered.

     Case 1 - Character-at-a-time serving site echoed

     Case 2 - Character-at-a-time user site echoed

     Case 3 - Line-at-a-time user site echoed

  Some serving sites may be able to operate with all three cases and
  some convention is required to set the mode.  Strictly speaking, what
  characters are echoed for what keys struck is of no concern to the
  serving site, although one would like to try to minimize differences
  in typescript as it appears to the user.

  2C   Format Control Characters

       The format control characters of horizontal tab (HT), vertical
  tab (VT), form feed (FF), line feed (LF), and carriage return (CR),
  need to be handled in a consistent way for Cases 2 and 3 above.  With
  Case 1 above, the situation is simplified.

  2D   Network Message Boundaries

       The NCP to NCP protocol was specified with the goal of having
  the network message boundaries being invisible to the user processes.
  It would be good if this goal could be maintained, but it may be
  difficult with some line-at-a-time systems.



Melvin & Watson                                                 [Page 2]

RFC 97                  Proposed Telnet Protocol           February 1971


  2E   An Implementation Convention

       ConVentions to solve the above problems are most simply
  established if we assume that the character stream received from a
  Telnet process by the server site is entered into that point in the
  server monitor where character input from "direct1y" connected
  terminals is entered and output from the server process is entered
  into the monitor point where normal character output is entered.  The
  server NCP receives its input at the point where normal monitor
  character output is obtained.  In other words, the server process
  would obtain its input from the server monitor character buffers and
  send its output to these buffers rather than obtainIng input directly
  from NCP buffers or outputting to NCP buffers.

       The Telnet process, on the other hand, would obtain and send
  character streams directly from or to its local NCP.

       Other situations exist where the user processes at both ends
  communicate directly with the NCP.  Therefore, we would recommend
  that both modes of connection (user process-monitor-NCP, or user
  process-NCP) be available for communication between the NCP and a
  user process.  These modes would be set under program control by the
  user process.  The initial network convention during the login
  procedure and until changed by the server process would be to obtain
  characters from and send characters to the monitor.  The server NCP
  communicates with the monitor also.  The scheme is illustrated in
  Figure 1.

       The motivation for such flexibility may be clearer from the
  discussion below.

3    Proposed Telnet Conventions

  3A   The server site is to assume initially that echoing is performed
  by a user site process until explict1y commanded otherwise.  If the
  user site can send character-at-a-time, then after connection and
  login have been established, tne user could switch Lo server-site-
  echo by command to the server site and then command (invisible to the
  server site) his local Telnet to change its echo mode also.

  3B   The server process is to assume it will receive the same
  character set which terminals "directly" connected to it can
  generate.  (We recommend at least 128 character ASCII.)  The user's
  Telnet may have to recognize two-character sequences to enable
  generation of both upper and lower-case codes and the control codes.
  We recommend that the user be able to set either upper or lower case
  as the default case for single case terminals and be able to specify
  a case shift character.  The user should also be able to specify a



Melvin & Watson                                                 [Page 3]

RFC 97                  Proposed Telnet Protocol           February 1971


  character to indicate that the next character struck is to be
  converted to the appropriate control character code.  This latter
  convention enables control codes directly generated at the terminal
  to be recognized by the user's system thus enabling escape to the
  user system.  Creating a convention allowing all control codes to
  enter the network and allowing output of the network to feed into the
  server monitor before entering the server process, gives a simple
  mechanism for generating an escape to     many existing systems.
  (The problem is more complicated than this for some systems and we
  discuss it further below.)

  3C   We recommend that network standards be established for the
  meaning of local echoes of HT, VT, and FF or a convention to be
  established for sending the meaning of these characters to the server
  process.  The NLS(NIC), for example, needs to keep track of the
  position of the print head and in the absence of such conventions
  will convert these character codes to spaces and line feeds.  This
  means that the appearance of the page on output may differ from the
  appearance on input.  It would be helpful to the user if his page on
  output could be formatted as it appeared on input.

  3D   LF characters would be handled as if they were generated by
  hitting the line feed key on a terminal "directly" connected to the
  server system.

  3E   The carriage return (CR) character can be the source of
  considerable difficulty.  For example, on input, different systems
  and the same system at different times, can echo and transmit
  different codes to the terminal and the user process.  Some monitor
  systems echo nothing, just a CR, or a CRLF.  Some systems transmit a
  CR, CRLF, or end of line code (EOL) to the user process.  The user
  process may control the echo or add to it.  Given the combinations
  which can exist at each end of the network connection and with
  respect to each other, confusion can exist unless we assume the
  definition of 2A and the implementation convention of 2E.  These
  assumptions imply that when a CR is struck, a CR gets sent over the
  network.  If the user monitor system or terminal control hardware
  converts a CR to a CRLF or EOL, then the Telnet program must convert
  it back to a CR.  When the CR reaches the server monitor it will
  handle it properly for the server process.

       When echoing is handled by the server system, the proper code or
  codes will be echoed.  The user Telnet on receiving a CRLF can pad it
  with the proper nulls to handle carriage movement timing for a
  particular terminal.

       When echoing is handled by the user system it would be ideal if
  the user's Telnet or system used the same echo convention as the



Melvin & Watson                                                 [Page 4]

RFC 97                  Proposed Telnet Protocol           February 1971


  server system would.  This means that either the Telnet must have a
  table of echo conventions for the various systems to which it can
  connect, or that it can obtain this information from the server
  system or process, or vice versa.

       For an initial Telnet protocol this is probably not necessary.
  The user system can default and echo a CRLF on each CR received.
  This default should be satisfactory for all the situations we are
  familiar with and for the NIC.

  3F   For communication from character- and line-at-a-time systems,
  the Telnet process may need to recognize a character (user
  assignable) which we call end of stream (EOS).  This character is to
  have the function defined in the following discussion.  The important
  point is to distinguish end-of-stream as a network function and end-
  of-line as a user or server system function.  Consider line-at-a-time
  systems first.  We have not had much experience with line-at-a-time
  systems, so what follows will need further study and clarification.
  As we understand it, line-at-a-time systems recognize a character
  such as CR or a break signal as the code to wake up the user process
  and cause transmission to it of the line of text.  From the point of
  view of NLS(NIC) it is important that the user be able to enter lines
  of text each terminated by a CR where appropriate and at other times
  to be able to enter text not terminated with a CR.  (A statement for
  NLS(NIC) is a string of text of "arbitrary" length and need not have
  CRs in it; on output the line is folded for the user at his (user
  definable) page boundary.)

       As an example of what is required, consider the case where the
  user's system recognizes CR as end-of-line.  In this case the Telnet
  would be awakened when a CR is received.  We would recommend that in
  this case the CR code be literally entered into the Telnet output
  buffer.  If a CR is preceded by an EOS character, then the CR should
  not be placed in the Telnet output buffer.  Transmission through the
  network can take place either when an EOS is received or
  automatically when the Telnet output buffer fills.  Transmission to
  character-at-a-time systems from line-at-a-time systems could require
  the awkward striking of three keys to get one character through the
  network.

       Now consider transmission for a character-at-a-time system to a
  server line-at-a-time system.  A similar problem to the one to be
  described also exists between line-at-a-time systems.  Given the
  definition of an EOS character different from CR, a line can be
  buffered up until the EOS is received and then sent without the EOS.
  How is the serving system to know that a line has been sent?  One way
  would be for the serving NCP to recognize message boundaries.  This
  convention would violate a design goal.  Another way would be for the



Melvin & Watson                                                 [Page 5]

RFC 97                  Proposed Telnet Protocol           February 1971


  user Telnet to request its NCI to send an INS command.  The sending
  of INS type of control commands might introduce race conditions in
  the network and should be investigated before their use with a Telnet
  process is established.  Since some of the line-at-a-time systems we
  know have special hardware that recognizes the end-of-line signal, we
  need some way to be compatible with this hardware using software
  control signals.  We leave this problem for further NWG subgroup
  study.

  3G   We now come back to the problem of interrupting or escaping in
  the remote server system.  In systems which do not lock out the input
  keyboard when output is going on, the mechanisms and conventions
  outlined above would seem adequate unless a special break signal is
  the escape signal.  This latter case requires more study.  In systems
  which allow no input while output is occurring, one may have to live
  with the consequences of such a terminal discipline and be prepared
  to wait until output stops before an escape code can be sent.  If the
  keyboard is locked and an escape break signal can be sent to the
  user's system, it can prevent output from going to the terminal, but
  must be prepared to continue receiving it from the server site until
  the user can inform his Telnet process to send an interrupt or escape
  signal to the server site.  Again this is a problem for further
  study.

       The Online System of the Network Information Center operates on
  a character-at-a-time monitor system and the conventions established
  in this paper are adequate for access to it.  These conventions are
  summarized in Appendix A.























Melvin & Watson                                                 [Page 6]

RFC 97                  Proposed Telnet Protocol           February 1971


APPENDIX A

  NETWORK CONNECTION PROTOCOL TO SRI-NETWORK INFORMATION CENTER

  1    Initial Connection Protocol

      Connection establishment to NIC is identical to that presented in
  Section II of NWG/RFC 80 NIC (5608,); it is reproduced here:

  Telnet contacts NIC

  NIC <- user site

       RTS <us> <l> <p>

            NIC logger is socket 1

  user site <- NIC

       STR <l> <us> CLS <l> <us>

            if accepted

       CLS <l> <us>

            if rejected

  assuming NIC accepts

  user site <- NIC

       STR <ss+l> <us>

       RTS <ss> <us+l> <q>

            NIC receives text thru local socket ss from remote
            socket us+l via link q

  assuming user site accepts

       NIC <- user site

            STR <us> <ss+l>

            RTS <us+l> <ss> <r>

                 NIC sends text to remote socket us thru local socket
                 ss+l via link r



Melvin & Watson                                                 [Page 7]

RFC 97                  Proposed Telnet Protocol           February 1971


                   .
                   .
                   .

       user site <- NIC

            ALL <q> <space>

                   .
                   .
                   .

       NIC <- user site

            ALL <r> <space>

  2    Connection Breaking Protocol

       A CLS trade is made between the NCPs for each of the two
  connections as per Document #1 NIC (5143,).

          We may decide to put a time-out into the NIC connections such
     that no interaction for some (as yet unspecified) "reasonable"
     length of time will result in a CLS-out of the connections being
     initiated by NIC.

  3    Third Level Protocol

       The first 8 bits received by NIC thru socket ss should be the
  message data type designating that an 8-bit ASCII stream follows, as
  per NWG/RFC #63, NIC (4963,).

        I.e., the first 8 bits are 00000001

       The first 8 bits received by Telnet thru socket us will also
  indicate a message data type of l.  Each network message should have
  an integral multiple of 8 bits.  If a network standard is established
  different from the suggestion of NWG/RFC #63, NIC (4963,), then we
  would change this protocol to conform.

        NIC will have NCP-generated interrupts disabled, i.e.,

           INR will be ignored

           INS will not be sent to the remote host






Melvin & Watson                                                 [Page 8]

RFC 97                  Proposed Telnet Protocol           February 1971


  4    NLS(NIC) Character Conventions of Interest to Telnet

       Echoing can either be under control of NIS(NIC) or under control
  of the user site.  When we refer to echoing below, we mean under
  control of NLS(NIC).  When echoing is handled by the user site we
  would expect the user to set the NLS(NIC) output conventions to
  conform to the echoing conventions at his site.  NLS(NIC) assumes
  echoing is handled by the user site unless explicitly commanded
  otherwise.

     Format affecting control characters

        horizontal tab

                spaces to next (user definable) stop on both echoing
           and output.

                if during literal input, enters file as ASCII '11.

        form feed

                carriage return and (user definable) appropriate number
           of line feeds on echo and output.

                If during literal input, enters file as ASCII '14

        vertical tab

                carriage return and (user definable) appropriate number
           of line feeds on echo and output

                if during literal input, enters file as ASCII '13

        carriage return

                carriage return followed by line feed on echo and
           output

                if during literal input, enters file as EOL (see below)

        line feed

                line feed on echo and output

                enters file as ASCII '12 on literal input

        EOL (end of line)




Melvin & Watson                                                 [Page 9]

RFC 97                  Proposed Telnet Protocol           February 1971


                presently ASCII code '37

                carriage return followed by line feed on echo and
           output

                if during literal input, enters file as ASCII '37

                If the user's system automatically appends a LF to a CR
           before sending it to Telnet or converts CR to some EOL code
           not ASCII '37, we would expect Telnet to send NLS(NIC) just
           a CR or ASCII '37.  If we receive CRLF, then on output we
           will send CRLFLF.

  5 NLS(NIC) Interrupt Attention Convention

      A (user definable) ASCII code in the text input stream is used to
  abort the executing process and return control to the main NLS(NIC)
  command processor.

        This code is presently DEL (ASCII '177).

          Escape to the NIC monitor:  No escape is required as all
     operations needed for use of the NIC can be performed within
     NLS(NIC).

          Character Set:  We strongly recommend that the Telnet process
     be able to generate by some set of keying conventions all 128
     ASCII codes.  Use of NLS(NIC) will probably feel most comfortable
     from a device with upper and lower case graphics, although we can
     provide service to single case devices.  We can provide a useful
     service if the full ASCII set cannot be sent, but would like to
     minimize the special cases we have to handle.  Sites which cannot
     provide the full ASCII set should contact us.

        +----+                      |
        |    |        Server        |
        |    |        Program       |
        |    |                      |
        +----+                      |
         ^ |                        |
         | v                        |
        +----+        Terminal      |
        |    |        control       |
        |    |        software      |    SERVER
        |    |        and           |     SITE
        +----+        possibly      |
         ^ |          hardware      |
         | v                        |



Melvin & Watson                                                [Page 10]

RFC 97                  Proposed Telnet Protocol           February 1971


        +----+                      |
        |    |                      |
        |    |        NCP           |
        |    |                      |
        +----+                      |
         ^ |                        |
         | v                        |

         . .
         . .                                            Figure 1 -
         . .
         . .                                        Telnet Connection

         ^ |
         | v
        +----+                      |
        |    |                      |
        |    |        NCP           |
        |    |                      |
        +----+                      |
         ^ |                        |
         | v                        |
        +----+                      |
        |    |                      |
        |    |        Telnet        |
        |    |                      |
        +----+                      |
         ^ |                        |    USER
         | v                        |    SITE
        +----+        Terminal      |
        |    |        control       |
        |    |        hardware-     |
        |    |        software      |
        +----+                      |
         ^ |                        |
         | v                        |
        +----+                      |
        |    |        User          |
         \   |        terminal      |
          \--+                      |


      [ This RFC was put into machine readable form for entry ]
      [   into the online RFC archives by Tony Hansen 08/08   ]







Melvin & Watson                                                [Page 11]