Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

10.0;vctl (vt100_control), revision 1.0, 88/01/21
vctl (vt100_control) - set/display vt100 terminal characteristics
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]



DESCRIPTION
     vctl allows you to set or display information about how the VT100
     terminal emulator driver handles input from the keyboard (for example,
     whether 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 be run only
     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 mode is on, a program reading from the keyboard in the
               VT100 receives each character as it is typed.  If "raw" mode is
               off, such a program blocks 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, this option 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. You
               may have to enclose some characters in quotation marks 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, 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 CR 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
     Display current settings.

     $ vctl
     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
     $

     Set quit character to hex FE, enable conversion of output newlines to
     carriage returns.

     $ vctl -quit 0FE -cvt_out_cr


SEE ALSO
     More information is available.  Type

     help  vt100    for information on the VT100 terminal emulator.

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