STTY(1-BSD) RISC/os Reference Manual STTY(1-BSD)
NAME
stty - set terminal options
SYNOPSIS
stty [ option ... ]
DESCRIPTION
stty 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. Use of one of the following options modifies the
output as described:
all All normally used option settings are reported.
everything
Everything stty knows about is printed.
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.
The option strings are selected from the following
set:
even allow even parity input
-even disallow even parity input
odd allow odd parity input
-odd disallow odd parity input
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 read(2) as
received; no erase and kill processing, but all
other processing (interrupt, suspend, ...) is per-
formed
-cbreak make characters available to read 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
lcase map upper case to lower case
-lcase do not map case
tandem enable flow control, so that the system sends out
the stop character when its internal queue is in
danger of overflowing on input, and sends the
Printed 11/19/92 Page 1
STTY(1-BSD) RISC/os Reference Manual STTY(1-BSD)
start character when it is ready to accept further
input
-tandem disable flow control
-tabs replace tabs by spaces when printing
tabs preserve tabs
ek set erase and kill characters to # and @
For the following commands which take a character argument
c, you may also specify c as the ``u'' or ``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.
cr0 cr1 cr2 cr3
select style of delay for carriage return (see
ioctl(2))
nl0 nl1 nl2 nl3
select style of delay for linefeed
tab0 tab1 tab2 tab3
select style of delay for tab
ff0 ff1 select style of delay for form feed
bs0 bs1 select style of delay for backspace
tty33 set all modes suitable for the Teletype Corpora-
tion Model 33 terminal.
tty37 set all modes suitable for the Teletype Corpora-
tion Model 37 terminal.
vt05 set all modes suitable for Digital Equipment Corp.
VT05 terminal
dec set all modes suitable for Digital Equipment Corp.
operating systems users; (erase, kill, and inter-
rupt characters to ^?, ^U, and ^C, decctlq and
``newcrt''.)
tn300 set all modes suitable for a General Electric Ter-
miNet 300
ti700 set all modes suitable for Texas Instruments 700
series terminal
tek set all modes suitable for Tektronix 4014 terminal
Page 2 Printed 11/19/92
STTY(1-BSD) RISC/os Reference Manual STTY(1-BSD)
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. On RISC/os, exta is generally 19200
baud and extb is generally 38400 baud, when the
particular line supports it.
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 columns.
A teletype driver which supports the job control processing
of csh(1) and more functionality than the basic driver is
fully described in tty(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.)
tostop Background jobs stop if they attempt terminal out-
put.
-tostop Output from background jobs to the terminal is
allowed.
tilde Convert ``~'' to ```'' on output (for Hazeltine
terminals).
-tilde Leave poor ``~'' alone.
Printed 11/19/92 Page 3
STTY(1-BSD) RISC/os Reference Manual STTY(1-BSD)
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. Note that, unlike
4.3 BSD, RISC/os strips the 0200 bit even 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.
etxack Diablo style etx/ack handshaking (not imple-
mented).
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).
LIMITATIONS
In RISC/os, 4.3 BSD-compatible terminal attributes are emu-
lated using the termio interface (see termio(7)). The full
set of underlying termio attributes are accessible via
/bin/stty (see stty(1). Many of the above attributes map
directly onto the corresponding termio attributes. Some,
however map onto sets of underlying attributes. The follow-
ing are those which have such mappings, expressed in terms
of /bin/stty options:
crtera echoe
Page 4 Printed 11/19/92
STTY(1-BSD) RISC/os Reference Manual STTY(1-BSD)
nohang -hupcl
crtkil echok
litout -opost
decctlq -ixany
cbreak -opost, -icanon, -igncr, -icrnl, and -inlcr. Also,
when cbreak is set, the old values of the flags
are saved in the settings of saved-opost, saved-
icanon, saved-igncr, saved-icrnl, and saved-inlcr,
respectively. Also, the settings of eol and eof
are saved in saved-eol and saved-eof, respec-
tively. One limitation is that if first cbreak
and then raw is set, and then -raw is set, -cbreak
is set. In general, avoid setting both raw and
cbreak.
raw -isig, -iuclc, -ixon, -opost, -icanon, -igncr, -
icrnl, and -inlcr. Also, when raw is set, the old
values of the flags are saved in the settings of
saved-isig, saved-iuclc, saved-ixon, saved-opost,
saved-icanon, saved-igncr, saved-icrnl, and
saved-inlcr, respectively. Also, the settings of
eol and eof are saved in saved-eol and saved-eof,
respectively.
lcase iuclc, olcuc, and xcase. When lcase is set the
previous values of iuclc and olcuc are saved in
saved-iuclc and saved-olcuc, respectively.
crmod icrnl and onlcr. When crmod is set the previous
values of icrnl and onlcr are saved in saved-icrnl
and saved-onlcr, respectively.
anyp parenb, -inpck, and parodd.
oddp parenb, inpck, and parodd.
evenp parenb, inpck, and -parodd.
tandem ixoff
new line 2
old line 0
There are also a few options, little used in 4.3 BSD, which
are not implemented at all, and are ignored when supplied
are arguments to stty:
Printed 11/19/92 Page 5
STTY(1-BSD) RISC/os Reference Manual STTY(1-BSD)
tilde
nl0, nl1, nl2, nl3
ff0, ff1
ispeed, ospeed
These are allowed, but only if the speeds are the
same. That is, split baud rates are not sup-
ported.
SEE ALSO
ioctl(2), stty(1), tabs(1), tset(1).
tty(4) in the Programmer's Reference Manual. tty(7), ter-
mio(7) in the System Administrator's Reference Manual.
Page 6 Printed 11/19/92