2.11BSD/man/cat1/stty.0
STTY(1) UNIX Programmer's Manual STTY(1)
NAME
stty - set terminal options
SYNOPSIS
stty [-a | -e] [-f _f_i_l_e] [operands]
DESCRIPTION
_S_t_t_y sets certain I/O options on the current output termi-
nal, placing its output on the diagnostic output. With no
argument, it reports the speed of the terminal and the set-
tings of the options which are different from their
defaults.
The following options are available:
-a Display everything _s_t_t_y knows. This has the same
effect as using the operand all or everything.
The distinction between all and everything has
been removed.
-e Same a -a above.
-f Open and use the terminal named by _f_i_l_e rather
than using standard output. The file is opened
using the O_NONBLOCK flag of open(), making it
possible to set or display settings on a terminal
that might otherwise block on the open.
The following operands are special:
all Everything _s_t_t_y knows about is printed.
everything Same as all above.
flushout Flush the queues for the device. This is most
useful when an exiting process is stuck waiting
for terminal output to drain.
speed The terminal speed alone is printed on the stan-
dard output.
size The terminal (window) sizes are printed on the
standard output, first rows and then columns.
_O_p_e_r_a_n_d_s are selected from the following:
even allow even parity input
-even disallow even parity input
odd allow odd parity input
-odd disallow odd parity input
Printed 11/24/99 March 27, 1997 1
STTY(1) UNIX Programmer's Manual STTY(1)
raw raw mode input (no input processing (erase, kill,
interrupt, ...); parity bit passed back)
-raw negate raw mode
cooked same as `-raw'
cbreak make each character available to _r_e_a_d(2) as
received; no erase and kill processing, but all
other processing (interrupt, suspend, ...) is per-
formed
-cbreak make characters available to _r_e_a_d only when new-
line is received
-nl allow carriage return for new-line, and output
CR-LF for carriage return or new-line
nl accept only new-line to end lines
echo echo back every character typed
-echo do not echo characters
tandem enable inbound software (xon/xoff) flow control,
so that the system sends out the stop character
when its internal queue is in danger of overflow-
ing on input, and sends the start character when
it is ready to accept further input
-tandem disable inbound software (xon/xoff) flow control
-tabs replace tabs by spaces when printing
tabs preserve tabs
For the following commands which take a character argument
_c, you may also specify _c as ``undef'', to set the value to
be undefined. A value of ``^x'', a 2 character sequence, is
also interpreted as a control character, with ``^?''
representing delete.
erase _c set erase character to _c (default `#', but often
reset to ^H.)
kill _c set kill character to _c (default `@', but often
reset to ^U.)
intr _c set interrupt character to _c (default DEL or ^?
(delete), but often reset to ^C.)
quit _c set quit character to _c (default control \.)
start _c set start character to _c (default control Q.)
stop _c set stop character to _c (default control S.)
eof _c set end of file character to _c (default control
D.)
brk _c set break character to _c (default undefined.) This
character is an additional character causing
wakeup.
dec set all modes suitable for Digital Equipment Corp.
operating systems users; (erase, kill, and
Printed 11/24/99 March 27, 1997 2
STTY(1) UNIX Programmer's Manual STTY(1)
interrupt characters to ^?, ^U, and ^C, decctlq
and ``newcrt''.)
0 hang up phone line immediately
50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb
Set terminal baud rate to the number given, if
possible. (These are the speeds supported by the
DH-11 interface).
rows _n The terminal size is recorded as having _n rows.
columns _n The terminal size is recorded as having _n columns.
cols _n is an alias for _c_o_l_u_m_n_s.
A teletype driver which supports the job control processing
of _c_s_h(1) and more functionality than the basic driver is
fully described in _t_t_y(4). The following options apply only
to it.
new Use new driver (switching flushes typeahead).
crt Set options for a CRT (crtbs, ctlecho and, if >=
1200 baud, crterase and crtkill.)
crtbs Echo backspaces on erase characters.
prterase For printing terminal echo erased characters back-
wards within ``\'' and ``/''.
crterase Wipe out erased characters with ``backspace-
space-backspace.''
-crterase Leave erased characters visible; just backspace.
crtkill Wipe out input on like kill ala crterase.
-crtkill Just echo line kill character and a newline on
line kill.
ctlecho Echo control characters as ``^_x'' (and delete as
``^?''.) Print two backspaces following the EOT
character (control D).
-ctlecho Control characters echo as themselves; in cooked
mode EOT (control-D) is not echoed.
decctlq After output is suspended (normally by ^S), only a
start character (normally ^Q) will restart it.
This is compatible with DEC's vendor supplied sys-
tems.
-decctlq After output is suspended, any character typed
will restart it; the start character will restart
output without providing any input. (This is the
default.)
Printed 11/24/99 March 27, 1997 3
STTY(1) UNIX Programmer's Manual STTY(1)
tostop Background jobs stop if they attempt terminal out-
put.
-tostop Output from background jobs to the terminal is
allowed.
flusho Output is being discarded usually because user hit
control O (internal state bit).
-flusho Output is not being discarded.
pendin Input is pending after a switch from cbreak to
cooked and will be re-input when a read becomes
pending or more input arrives (internal state
bit).
-pendin Input is not pending.
pass8 Passes all 8 bits through on input, in any mode.
-pass8 Strips the 0200 bit on input except in raw mode.
mdmbuf Start/stop output on carrier transitions (not
implemented).
-mdmbuf Return error if write attempted after carrier
drops.
litout Send output characters without any processing.
-litout Do normal output processing, inserting delays,
etc.
nohang Don't send hangup signal if carrier drops.
-nohang Send hangup signal to control process group when
carrier drops.
The following special characters are applicable only to the
new teletype driver and are not normally changed.
susp _c set suspend process character to _c (default con-
trol Z).
dsusp _c set delayed suspend process character to _c
(default control Y).
rprnt _c set reprint line character to _c (default control
R).
flush _c set flush output character to _c (default control
O).
werase _c set word erase character to _c (default control W).
lnext _c set literal next character to _c (default control
V).
Modem Control Status:
These display the current state of modem control. They are
only displayed for actual tty lines and not for pseudo tty
lines (more precisely, it is only displayed for lines which
support the TIOCMGET ioctl. See tty(4).
Printed 11/24/99 March 27, 1997 4
STTY(1) UNIX Programmer's Manual STTY(1)
While it is possible to change the state of the modem con-
trol lines, the hardware or other software may prevent the
change from actually taking place, or may cause the state to
immediately revert to the original state.
dcd (-dcd) State of Data Carrier Detect.
dsr (-dsr) State of Data Set Ready.
dtr (-dtr) State of Data Terminal Ready.
cts (-cts) State of Clear To Send.
rts (-rts) State of Request To Send.
SEE ALSO
ioctl(2), tabs(1), tset(1), tty(4)
Printed 11/24/99 March 27, 1997 5