STTY(1) (Essential Utilities) STTY(1)
NAME
stty - set the options for a terminal
SYNOPSIS
stty [ -a ] [ -g ] [ options ]
DESCRIPTION
The stty command sets certain terminal I/O options for the
device that is the current standard input; without
arguments, it reports the settings of certain options.
In this report, if a character is preceded by a caret (^),
then the value of that option is the corresponding CTRL
character (e.g., ``^h'' is CTRL-h ; in this case, recall
that CTRL-h is the same as the back-space key.) The sequence
``^''' (caret apostrophe) means that an option has a null
value. For example, normally stty -a will report that the
value of swtch is ``^'''; however, if shl (1) or layers (1)
has been invoked, stty -a will have the value ``^z''.
-a reports all of the option settings;
-g reports current settings in a form that can be used as
an argument to another stty command.
Options in the last group are implemented using options in
the previous groups. Note that many combinations of options
make no sense, but no sanity checking is performed. The
options are selected from the following:
Control Modes
parenb (-parenb)
enable (disable) parity generation and detection.
parodd (-parodd)
select odd (even) parity.
cs5 cs6 cs7 cs8
select character size [see termio(7)].
0 hang up phone line immediately.
110 300 600 1200 1800 2400 4800 9600 19200 38400
Set terminal baud rate to the number given, if
Page 1 May 1989
STTY(1) (Essential Utilities) STTY(1)
possible. (All speeds are not supported by all
hardware interfaces.)
hupcl (-hupcl)
hang up (do not hang up) Dataphone connection on
last close.
hup (-hup)
same as hupcl (-hupcl).
cstopb (-cstopb)
use two (one) stop bits per character.
cread (-cread)
enable (disable) the receiver.
clocal (-clocal)
assume a line without (with) modem control.
loblk (-loblk)
block (do not block) output from a non-current
layer.
Input Modes
ignbrk (-ignbrk)
ignore (do not ignore) break on input.
brkint (-brkint)
signal (do not signal) INTR on break.
ignpar (-ignpar)
ignore (do not ignore) parity errors.
parmrk (-parmrk)
mark (do not mark) parity errors [see termio(7)].
inpck (-inpck)
enable (disable) input parity checking.
istrip (-istrip)
strip (do not strip) input characters to seven
bits.
inlcr (-inlcr)
map (do not map) NL to CR on input.
igncr (-igncr)
ignore (do not ignore) CR on input.
icrnl (-icrnl)
map (do not map) CR to NL on input.
iuclc (-iuclc)
map (do not map) upper-case alphabetics to lower
case on input.
Page 2 May 1989
STTY(1) (Essential Utilities) STTY(1)
ixon (-ixon)
enable (disable) START/STOP output control.
Output is stopped by sending an ASCII DC3 and
started by sending an ASCII DC1.
ixany (-ixany)
allow any character (only DC1) to restart output.
ixoff (-ixoff)
request that the system send (not send) START/STOP
characters when the input queue is nearly
empty/full.
Output Modes
opost (-opost)
post-process output (do not post-process output;
ignore all other output modes).
olcuc (-olcuc)
map (do not map) lower-case alphabetics to upper
case on output.
onlcr (-onlcr)
map (do not map) NL to CR-NL on output.
ocrnl (-ocrnl)
map (do not map) CR to NL on output.
onocr (-onocr)
do not (do) output CRs at column zero.
onlret (-onlret)
on the terminal NL performs (does not perform) the
CR function.
ofill (-ofill)
use fill characters (use timing) for delays.
ofdel (-ofdel)
fill characters are DELs (NULs).
cr0 cr1 cr2 cr3
select style of delay for carriage returns [see
termio(7)].
nl0 nl1 select style of delay for line-feeds [see
termio(7)].
tab0 tab1 tab2 tab3
select style of delay for horizontal tabs [see
termio(7)].
bs0 bs1 select style of delay for backspaces [see
Page 3 May 1989
STTY(1) (Essential Utilities) STTY(1)
termio(7)].
ff0 ff1 select style of delay for form-feeds [see
termio(7)].
vt0 vt1 select style of delay for vertical tabs [see
termio(7)].
Local Modes
isig (-isig)
enable (disable) the checking of characters
against the special control characters INTR, QUIT,
and SWTCH.
icanon (-icanon)
enable (disable) canonical input (ERASE and KILL
processing).
xcase (-xcase)
canonical (unprocessed) upper/lower-case
presentation.
echo (-echo)
echo back (do not echo back) every character
typed.
echoe (-echoe)
echo (do not echo) ERASE character as a
backspace-space-backspace string. Note: this mode
will erase the ERASEd character on many CRT
terminals; however, it does not keep track of
column position and, as a result, may be confusing
on escaped characters, tabs, and backspaces.
echok (-echok)
echo (do not echo) NL after KILL character.
lfkc (-lfkc)
the same as echok (-echok); obsolete.
echonl (-echonl)
echo (do not echo) NL.
noflsh (-noflsh)
disable (enable) flush after INTR, QUIT, or SWTCH.
stwrap (-stwrap)
disable (enable) truncation of lines longer than
79 characters on a synchronous line.
stflush (-stflush)
enable (disable) flush on a synchronous line after
Page 4 May 1989
STTY(1) (Essential Utilities) STTY(1)
every write(2).
stappl (-stappl)
use application mode (use line mode) on a
synchronous line.
iexten (-iexten)
enables (disables) non-POSIX control characters
such as SWTCH.
tostop (-tostop)
specifies that background processes will (will
not) be stopped when writing to the controlling
terminal.
Control Assignments
control-character c
set control-character to c, where control-
character is erase, kill, intr, quit, swtch, susp,
ctab, min, or time [ctab is used with -stappl; min
and time are used with -icanon; see termio(7)].
If c is preceded by an (escaped from the shell)
caret (^), then the value used is the
corresponding CTRL character (e.g., ``^d'' is a
CTRL-d); ``^?'' is interpreted as DEL and ``^-''
is interpreted as undefined.
line i set line discipline to i (0 < i < 127 ).
Combination Modes
evenp or parity
enable parenb and cs7.
oddp enable parenb, cs7, and parodd.
-parity, -evenp, or -oddp
disable parenb, and set cs8.
raw (-raw or cooked)
enable (disable) raw input and output (no ERASE,
KILL, INTR, QUIT, SWTCH, EOT, or output post
processing).
nl (-nl) unset (set) icrnl, onlcr. In addition -nl unsets
inlcr, igncr, ocrnl, and onlret.
lcase (-lcase)
set (unset) xcase, iuclc, and olcuc.
LCASE (-LCASE)
Page 5 May 1989
STTY(1) (Essential Utilities) STTY(1)
same as lcase (-lcase).
tabs (-tabs or tab3)
preserve (expand to spaces) tabs when printing.
ek reset ERASE and KILL characters back to normal #
and @.
sane resets all modes to some reasonable values.
term set all modes suitable for the terminal type term,
where term is one of tty33, tty37, vt05, tn300,
ti700, or tek.
SEE ALSO
tabs(1).
ioctl(2) in the Programmer's Reference Manual.
termio(7) in the System Administrator's Reference Manual.
Page 6 May 1989