Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

VT100

1.0;vctl (vt100_control), revision 1.0, 87/03/20
VCTL (VT100_CONTROL) -- Set/display VT100 terminal characteristics.
usage:  usage: VCTL [-[NO]CVT_IN_NL] [-[NO]CVT_IN_CR] [-[NO]CVT_OUT_NL]
                                        [-[NO]CVT_OUT_CR] [-[NO]ECHO]
                                        [-[NO]ECHO_CTL] [-[NO]ECHO_ERASE]
                                        [-[NO]ECHO_KILL] [-EOF char]
                                        [-ERASE char] [-INTR char] [-KILL char]
                                        [-QUIT char] [-DEFAULT]


FORMAT

  VCTL [options]


  VCTL  allows  you  to  set or display information about how the VT100 terminal
  emulator driver handles input from the keyboard (for example, whether  or  not
  it  echoes  characters,  or  how  it  interprets  key  sequences  typed at the
  keyboard).

  This command is valid only if you have the VT100 terminal  emulation  software
  package  running  on your node.  In addition, VCTL can only be run in a window
  where the VT100 emulator is already running.


OPTIONS

  If no options are specified, the current VT100 settings are displayed.

  -DEFAULT           Set all options to their default values.  This  allows  you
                     to quickly reset values to known states.

  -[NO]CVT_IN_NL
                     Convert a newline (linefeed) to a carriage return on input.
                     The initial setting is -NOCVT_IN_LINE.

  -[NO]CVT_IN_CR
                     Convert a carriage return to  a  newline  on  input.    The
                     initial setting is -CVT_IN_CR.

  -[NO]CVT_OUT_NL
                     Convert a newline to carriage return,  newline  on  output.
                     The initial setting is -CVT_OUT_NL.

  -[NO]CVT_OUT_CR
                     Convert a carriage return to a  newline  on  output.    The
                     initial setting is -NOCVT_OUT_CR.

  -[NO]ECHO           Turn  the  echoing  of  input  characters  on or off.  The
                     initial setting is ECHO.

  -[NO]ECHO_CTL
                     Turn  the echoing of control characters (such as CTRL/Z) on
                     or off.  The initial setting is NOECHO_CTL.

  -[NO]ECHO_ERASE
                     If  ECHO  is  on,  controls  whether characters are visibly
                     erased from the screen when the erase character  is  typed.
                     The  combination  of ECHO and NOECHO_ERASE causes the erase
                     character to be echoed until all characters on a  line  are
                     erased.  The initial setting is -ECHO_ERASE.

  -[NO]RAW

                     If  RAW  is  on, a program reading from the keyboard in the
                     VT100 will receive each character as it is typed.   If  RAW
                     is  off,  such  a  program will block until a full line has
                     been typed.  A full line is a sequence of characters ending
                     in a newline character.  In other words, in non-raw mode, a
                     program blocks until a carriage  return  or  line  feed  is
                     typed.

  -[NO]ECHO_KILL
                     If ECHO is on, controls whether a line  is  visibly  erased
                     from the screen when the line kill character is typed.  The
                     combination  of  ECHO  and  NOECHO_KILL  causes  the   kill
                     character to be echoed and a new line to be displayed.  The
                     initial setting is -ECHO_KILL.

  -EOF char          Set the  end-of-file  character.    The  EOF  character  is
                     initially set to CTRL/Z.

  -ERASE char         Set  the  erase character.  This option is valid only when
                     data is being passed to the terminal emulator  in  "cooked"
                     mode.    The  'char'  can  be  any  character  or  one-byte
                     hexadecimal value.  Some characters may require quoting  in
                     the  Shell.    The  erase  character  is  initially  set to
                     BACKSPACE (08 hex).

  -INTR char         Set the interrupt character, which sends an interrupt fault
                     to  the  process  group  of  the  terminal  emulator.   The
                     interrupt character is initially set to CTRL/C.

  -KILL char         Set the kill character.  This option  is  valid  only  when
                     data is being passed to the emulator in "cooked mode".  The
                     kill character is initially set to CTRL/X.

  -QUIT char         Set the quit character.  The quit  character  is  initially
                     set to CTRL/Q.

  -SUSP char          Set  the  suspend  character.    The  suspend character is
                     initially set to hex FF, which is equivalent to  its  being
                     disabled.

  -[NO]ENABLE_SIGS
                     If ENABLE_SIGS is on then the  fault-generating  characters
                     (interrupt,  quit, suspend) have their special meaning.  If
                     ENABLE_SIGS is off then these characters  are  not  treated
                     specially.

  EOL char            Set  the  extra  break  character.    The EOL character is
                     initially set to hex FF, which is equivalent to  its  being
                     disabled.  If it is enabled, the EOL character behaves like
                     <return> in that any program reading from the keyboard will
                     immediately  wake  up  and  read whatever has been typed so
                     far, including the EOL character itself.


EXAMPLES

  1. $ vctl                               Display current settings.
     Erase (character delete) character: "^H" (08 hex)
     Kill (line delete) character: "^U" (15 hex)
     End of file character: "^Z" (1A hex)
     Interrupt character: "^C" (03 hex)
     Quit character: "^Q" (11 hex)
     Extra break character: FF (hex)
     Suspend character: FF (hex)
     Raw: FALSE,             Echo: TRUE,             Echo_Erase: TRUE
     Echo_Kill: TRUE,        Echo_Ctl: FALSE,        Cvt_In_CR: TRUE
     Cvt_In_NL: FALSE,       Cvt_Out_NL: TRUE,       Cvt_Out_CR: FALSE
     Enable_Sigs: TRUE
     $

  2. $ vctl -quit 0FE -cvt_out_cr         Set quit character to hex FE,
                                          enable conversion of output
                                          newlines to carriage returns.


RELATED TOPICS

  More information is available.  Type:

  - HELP VT100
   for information on the VT100 terminal emulator.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026