Network Working Group                                     Marvin Solomon
Request for Comments: 884                                 Edward Wimmers
                                       University of Wisconsin - Madison
                                                           December 1983

                      TELNET TERMINAL TYPE OPTION


This RFC specifies a standard for the ARPA Internet community.  Hosts on
the ARPA Internet that exchange terminal type information within the
Telnet protocol are expected to adopt and implement this standard.

1. Command Name and Code

   TERMINAL-TYPE    24

2. Command Meanings

   IAC WILL TERMINAL-TYPE

      Sender is willing to send terminal type information in a
      subsequent sub-negotiation

   IAC DO TERMINAL-TYPE

      Sender is willing to receive terminal type information in a
      subsequent sub-negotiation

   IAC DON'T TERMINAL-TYPE

      Sender refuses to accept terminal type information

   IAC WON'T TERMINAL-TYPE

      Sender refuses to send terminal type information

   IAC SB TERMINAL-TYPE SEND IAC SE

      Sender requests receiver to transmit his (the receiver's) terminal
      type. The code for SEND is 1. (See below.)

   IAC SB TERMINAL-TYPE IS ... IAC SE

      Sender is stating the name of his terminal type. The code for IS
      is 0. (See below.)








Solomon & Wimmers                                               [Page 1]



RFC 884                                                    December 1983


3. Default

   DON'T TERMINAL-TYPE

   WON'T TERMINAL-TYPE

   Terminal type information will not be exchanged.

4. Motivation for the Option

   This option allows a telnet server to determine the type of terminal
   connected to a user telnet program.  The transmission of such
   information does not immediately imply any change of processing.
   However, the information may be passed to a process, which may alter
   the data it sends to suit the particular characteristics of the
   terminal. For example, some operating systems have a terminal driver
   that accepts a code indicating the type of terminal being driven.
   Using the TERMINAL TYPE and BINARY options, a telnet server program
   on such a system could arrange to have terminals driven as if they
   were directly connected, including such special functions as cursor
   addressing, multiple colors, etc., not included in the Network
   Virtual Terminal specification.  This option fits into the normal
   structure of TELNET options by deferring the actual transfer of
   status information to the SB command.

5. Description of the Option

   WILL and DO are used only to obtain and grant permission for future
   discussion. The actual exchange of status information occurs within
   option subcommands (IAC SB TERMINAL-TYPE...).

   Once the two hosts have exchanged a WILL and a DO, the sender of the
   WILL TERMINAL-TYPE is free to transmit type information, spontan-
   eously or in response to a request from the sender of the DO.  At
   worst, this may lead to transmitting the information twice. Only the
   sender of the DO may send requests (IAC SB TERMINAL-TYPE SEND IAC SE)
   and only the sender of the WILL may transmit actual type information
   (within an IAC SB TERMINAL-TYPE IS ... IAC SE command).

   The terminal type information is an NVT ASCII string.  Within this
   string, upper and lower case are considered equivalent.  A few
   terminal type names useful in the context of IBM systems are listed
   below.  It is anticipated that additional names will be added in the
   future.  The complete list of valid terminal types will be found in
   the latest "Assigned Numbers" RFC.





Solomon & Wimmers                                               [Page 2]



RFC 884                                                    December 1983


   The following is an example of use of the option:

      Host1: IAC DO TERMINAL-TYPE

      Host2: IAC WILL TERMINAL-TYPE

         (Host2 is now free to send status information at any time.
         Solicitations from Host1 are NOT necessary. This should not
         produce any dangerous race conditions. At worst, two IS's will
         be sent.)

      Host1 (perhaps): IAC SB TERMINAL-TYPE SEND IAC SE

      Host2:

         IAC SB TERMINAL-TYPE IS IBM-3278-2 IAC SE

6.  Implementation Suggestions

   The "terminal type" information may be any NVT ASCII string meaning-
   ful to both ends of the negotiation.  The list of suggestions below
   is intended to minimize confusion caused by alternative "spellings"
   of the terminal type.  For example, confusion would arise if one
   party were to call a terminal "IBM3278-2" while the other called it
   "IBM-3278/2".  There is no negative acknowledgement for a terminal
   type that is not understood, but certain other options (such as
   switching to BINARY mode) may be refused if a valid terminal type
   name has not been specified.  In some cases, a particular terminal
   may be known by more than one name, for example a specific type and a
   more generic type.  In such cases, the sender of the TERMINAL-TYPE IS
   command should reply to successive TERMINAL-TYPE SEND commands with
   the various names, from most to least specific.  In this way, a
   telnet server that does not understand the first response can prompt
   for alternatives.  However, it should cease sending TERMINAL-TYPE
   SEND commands after receiving the same response two consecutive
   times.  Similarly, a sender should indicate it has sent all available
   names by repeating the last one sent.

   Here are a few terminal types useful in the IBM environment:

      IBM-3275-2
      IBM-3276-2
      IBM-3276-3
      IBM-3276-4
      IBM-3277-2
      IBM-3278-2
      IBM-3278-3
      IBM-3278-4


Solomon & Wimmers                                               [Page 3]



RFC 884                                                    December 1983


      IBM-3278-5
      IBM-3279-2
      IBM-3279-3

   Here are a few terminal types useful in the TOPS20 environment:

      ANN-ARBOR-AMBASSADOR
      CONCEPT-100
      DATAMEDIA-2500
      DEC-LA30
      DEC-VT100
      DEC-VT52
      EXECUPORT-4000
      HAZELTINE-1500
      HP-2621
      HP-2640
      HP-2645A
      HP-2649
      NETWORK-VIRTUAL-TERMINAL
      TEKTRONIX-4025
      TELERAY-1061
      TELETYPE-33
      TELETYPE-37
      TELEVIDEO-950
      TERMINET-300
      TI-700
      ZENITH-H19

   Here are a few terminal types used in the Unix environment:

      ADDS-CONSUL-980
      ADDS-REGENT-200
      ANDERSON-JACOBSON-832
      ANN-ARBOR-AMBASSADOR
      BITGRAPH
      CDI-1203
      COMPUCOLOR-II
      CONCEPT-100
      DATA-GENERAL-6053
      DATAGRAPHIX-132A
      DATAMEDIA-3045A
      DATAPOINT-3360
      DEC-DECWRITER-II
      DEC-GT40
      DEC-VT52
      DELTA-DATA-5000
      DIABLO-1620
      EXECUPORT-4000


Solomon & Wimmers                                               [Page 4]



RFC 884                                                    December 1983


      GENERAL-TERMINAL-100A
      HAZELTINE-1500
      HAZELTINE-2000
      HP-2621
      HP-2640A
      HP-2645
      HP-2649A
      IBM-3101
      INFOTON-100
      LSI-ADM-3
      MICROTERM-ACT-V
      MICROTERM-MIME-2
      NETWORK-VIRTUAL-TERMINAL
      PERKIN-ELMER-1100
      PLASMA-PANEL
      SUPERBEE-III-M
      TEKTRONIX-4014
      TELERAY-3700
      TELETYPE-33
      TELETYPE-37
      TELEVIDEO-912
      TERMINET-300
      TI-700
      TI-733
      TI-745
      VISUAL-200
      XEROX-1720
      ZENITH-H19
      ZENTEC-30

   The type "UNKNOWN" should be used if the type of the terminal is
   unknown or unlikely to be recognized by the other party.

   The complete and up-to-date list will be maintained in the "Assigned
   Numbers".















Solomon & Wimmers                                               [Page 5]