stty(1) USER COMMANDS stty(1)
NAME
stty - set the options for a terminal
SYNOPSIS
stty [-a] [-g] [options]
DESCRIPTION
stty 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 control
character (e.g., ``^h'' is CTRL-h; in this case, recall that
CTRL-h is the same as the ``back-space'' key.) The sequence
``^''' means that an option has a null value.
-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.
For detailed information about the modes listed from Control
Modes through Local Modes, below, see termio(7). For
detailed information about the modes listed under Hardware
Flow Control Modes and Clock Modes, below, see termiox(7).
Options described in the Combination Modes section are
implemented using options in the earlier sections. Note
that many combinations of options make no sense, but no san-
ity checking is performed. Hardware flow control and clock
modes options may not be supported by all hardware inter-
faces. The options are selected from the following:
Control Modes
parenb (-parenb)
enable (disable) parity generation and detection.
parext (-parext)
enable (disable) extended parity generation and
detection for mark and space parity.
parodd (-parodd)
select odd (even) parity, or mark (space) parity
if parext is enabled.
cs5 cs6 cs7 cs8
select character size [see termio(7)].
0 hang up line immediately.
110 300 600 1200 1800 2400 4800 9600 19200 38400
Set terminal baud rate to the number given, if
possible. (All speeds are not supported by all
hardware interfaces.)
ispeed 0 110 300 600 1200 1800 2400 4800 9600 19200 38400
Set terminal input baud rate to the number given,
if possible. (Not all hardware supports split
1
stty(1) USER COMMANDS stty(1)
baud rates.) If the input baud rate is set to
zero, the input baud rate will be specified by the
value of the output baud rate.
ospeed 0 110 300 600 1200 1800 2400 4800 9600 19200 38400
Set terminal output baud rate to the number given,
if possible. (Not all hardware supports split
baud rates.) If the output baud rate is set to
zero, the line will be hung up immediately.
hupcl (-hupcl)
hang up (do not hang up) 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)
n 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.
ixon (-ixon)
enable (disable) START/STOP output control. Out-
put is stopped by sending STOP control character
and started by sending the START control charac-
ter.
ixany (-ixany)
allow any character (only DC1) to restart output.
2
stty(1) USER COMMANDS stty(1)
ixoff (-ixoff)
request that the system send (not send) START/STOP
characters when the input queue is nearly
empty/full.
imaxbel (-imaxbel)
echo (do not echo) BEL when the input line is too
long.
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 ter-
mio(7)].
tab0 tab1 tab2 tab3
select style of delay for horizontal tabs [see
termio(7)].
bs0 bs1 select style of delay for backspaces [see ter-
mio(7)].
ff0 ff1 select style of delay for form-feeds [see ter-
mio(7)].
vt0 vt1 select style of delay for vertical tabs [see ter-
mio(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)
3
stty(1) USER COMMANDS stty(1)
canonical (unprocessed) upper/lower-case presenta-
tion.
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 ERASEed character on many CRT ter-
minals; 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. (Does not
apply to the 3B2.)
tostop (-tostop)
send (do not send) SIGTTOU when background
processes write to the terminal.
echoctl (-echoctl)
echo (do not echo) control characters as ^char,
delete as ^?
echoprt (-echoprt)
echo (do not echo) erase character as character is
``erased''.
echoke (-echoke)
BS-SP-BS erase (do not BS-SP-BS erase) entire line
on line kill.
flusho (-flusho)
output is (is not) being flushed.
pendin (-pendin)
retype (do not retype) pending input at next read
or input character.
iexten (-iexten)
enable (disable) extended (implementation-defined)
functions for input data.
stflush (-stflush)
enable (disable) flush on a synchronous line after
every write(2).
stappl (-stappl)
use application mode (use line mode) on a synchro-
nous line.
4
stty(1) USER COMMANDS stty(1)
Hardware Flow Control Modes
rtsxoff (-rtsxoff)
enable (disable) RTS hardware flow control on
input.
ctsxon (-ctsxon)
enable (disable) CTS hardware flow control on out-
put.
dtrxoff (-dtrxoff)
enable (disable) DTR hardware flow control on
input.
cdxon (-cdxon)
enable (disable) CD hardware flow control on out-
put.
isxoff (-isxoff)
enable (disable) isochronous hardware flow control
on input.
Clock Modes
xcibrg get transmit clock from internal baud rate genera-
tor.
xctset get the transmit clock from transmitter signal
element timing (DCE source) lead, CCITT V.24 cir-
cuit 114, EIA-232-D pin 15.
xcrset get transmit clock from receiver signal element
timing (DCE source) lead, CCITT V.24 circuit 115,
EIA-232-D pin 17.
rcibrg get receive clock from internal baud rate genera-
tor.
rctset get receive clock from transmitter signal element
timing (DCE source) lead, CCITT V.24 circuit 114,
EIA-232-D pin 15.
rcrset get receive clock from receiver signal element
timing (DCE source) lead, CCITT V.24 circuit 115,
EIA-232-D pin 17.
tsetcoff transmitter signal element timing clock not pro-
vided.
tsetcrbrg output receive baud rate generator on transmitter
signal element timing (DTE source) lead, CCITT
V.24 circuit 113, EIA-232-D pin 24.
tsetctbrg output transmit baud rate generator on transmitter
signal element timing (DTE source) lead, CCITT
V.24 circuit 113, EIA-232-D pin 24.
tsetctset output tranmitter signal element timing (DCE
source) on transmitter signal element timing (DTE
source) lead, CCITT V.24 circuit 113, EIA-232-D
pin 24.
tsetcrset output receiver signal element timing (DCE source)
on transmitter signal element timing (DTE source)
lead, CCITT V.24 circuit 113, EIA-232-D pin 24.
rsetcoff receiver signal element timing clock not provided.
rsetcrbrg output receive baud rate generator on receiver
signal element timing (DTE source) lead, CCITT
5
stty(1) USER COMMANDS stty(1)
V.24 circuit 128, no EIA-232-D pin.
rsetctbrg output transmit baud rate generator on receiver
signal element timing (DTE source) lead, CCITT
V.24 circuit 128, no EIA-232-D pin.
rsetctset output transmitter signal element timing (DCE
source) on receiver signal element timing (DTE
source) lead, CCITT V.24 circuit 128, no EIA-232-D
pin.
rsetcrset output receiver signal element timing (DCE source)
on receiver signal element timing (DTE source)
lead, CCITT V.24 circuit 128, no EIA-232-D pin.
Control Assignments
control-character c
set control-character to c, where control-
character is ctab, discard, dsusp, eof, eol, eol2,
erase, intr, kill, lnext, quit, reprint, start,
stop, susp, swtch, or werase. [ctab is used with
-stappl [see termio(7)]. If c is preceded by a
caret (^) indicating an escape from the shell,
then the value used is the corresponding control
character (e.g., ``^d'' is a CTRL-d). ``^?'' is
interpreted as DEL and ``^-'' is interpreted as
undefined.
min, time number
Set the value of min or time to number. MIN and
TIME are used in Non-Canonical mode input process-
ing (-icanon).
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.
spacep enable parenb, cs7, and parext.
markp enable parenb, cs7, parodd, and parext.
-parity, or -evenp
disable parenb, and set cs8.
-oddp disable parenb and parodd, and set cs8.
-spacep disable parenb and parext, and set cs8.
-markp disable parenb, parodd, and parext, and set cs8.
raw (-raw or cooked)
enable (disable) raw input and output (no ERASE,
KILL, INTR, QUIT, SWTCH, EOT, or output post pro-
cessing).
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)
same as lcase (-lcase).
tabs (-tabs or tab3)
6
stty(1) USER COMMANDS stty(1)
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.
async set normal asynchronous communications where clock
settings are xcibrg, rcibrg, tsetcoff and rsetc-
off.
Window Size
rows n set window size to n rows.
columns n set window size to n columns.
ypixels n set vertical window size to n pixels.
xpixels n set horizontal window size to n pixels.
SEE ALSO
tabs(1) in the User's Reference Manual.
ioctl(2).
termio(7), termiox(7) in the System Administrator's Refer-
ence Manual.
7