stty(1) 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 the input and output of stty, if a character is preceded by
a caret (^), then the value of that option is the
corresponding control character (for example, ``^h'' is CTRL-
h; in this case, recall that CTRL-h is the same as the
``backspace'' key.) The sequence ``^''' means that an option
has a null value.
-a Report all option settings.
-g Report current settings in a form that can be used as an
argument to another stty command.
For detailed information about the modes listed in sections
``Control Modes'' through ``Local Modes''. see termio(7).
For detailed information about the modes listed in sections
``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
sanity checking is performed. Hardware flow control and clock
modes options may not be supported by all hardware interfaces.
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.
Copyright 1994 Novell, Inc. Page 1
stty(1) stty(1)
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 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)
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.
Copyright 1994 Novell, Inc. Page 2
stty(1) stty(1)
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. Output
is stopped by sending STOP control character and
started by sending the START control character.
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.
imaxbel (-imaxbel)
Echo (do not echo) BEL when the input line is too
long.
Copyright 1994 Novell, Inc. Page 3
stty(1) stty(1)
KB_ENABLE Perform a TIOCKBON, which allows extended characters
to be transmitted to the user's program. Extended
characters are transmitted as a null byte followed
by a second byte containing the character's extended
code. [See keyboard(7).]
KB_DISABLE
Perform a TIOCKBOF, which disables the transmission
of extended characters. This is the default. [See
keyboard(7).]
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).
The following options set the delays for the output control
characters. Selecting the 0 type option, such as cr0, causes
no delay. stty -a does not report the 0 type options. For
more information, see termio(7).
Copyright 1994 Novell, Inc. Page 4
stty(1) stty(1)
cr0 cr1 cr2 cr3
Select style of delay for carriage returns.
nl0 nl1 Select style of delay for line-feeds.
tab0 tab1 tab2 tab3
Select style of delay for horizontal tabs.
bs0 bs1 Select style of delay for backspaces.
ff0 ff1 Select style of delay for form-feeds.
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. This mode erases the
ERASEed character on many 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.
Copyright 1994 Novell, Inc. Page 5
stty(1) stty(1)
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.
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
synchronous line.
Copyright 1994 Novell, Inc. Page 6
stty(1) 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
output.
dtrxoff (-dtrxoff)
Enable (disable) DTR hardware flow control on input.
cdxon (-cdxon)
Enable (disable) CD hardware flow control on output.
isxoff (-isxoff)
Enable (disable) isochronous hardware flow control
on input.
Clock Modes
xcibrg Get transmit clock from internal baud rate
generator.
xctset Get transmit clock from transmitter signal element
timing (DCE source) lead, CCITT V.24 circuit 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 generator.
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 is not
provided.
tsetcrbrg Output receive baud rate generator on transmitter
signal element timing (DTE source) lead, CCITT V.24
circuit 113, EIA-232-D pin 24.
Copyright 1994 Novell, Inc. Page 7
stty(1) stty(1)
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 transmitter 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 is not
provided.
rsetcrbrg Output receive baud rate generator on receiver
signal element timing (DTE source) lead, CCITT 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
In the following assignments, if c is preceded by a caret (^)
indicating an escape from the shell, then the value used is
the corresponding control character (for example, ``^d'' is a
CTRL-d). ``^?'' is interpreted as DEL and ``^-'' is
interpreted as undefined.
In the POSIX locale, the caret (circumflex) control characters
listed in the table below are set to the values shown:
Copyright 1994 Novell, Inc. Page 8
stty(1) stty(1)
^a, ^A <SOH> ^l, ^L <FF> ^w, ^W <ETB>
^b, ^B <STX> ^m, ^M <CR> ^x, ^X <CAN>
^c, ^C <ETC> ^n, ^N <SO> ^y, ^Y <EM>
^d, ^D <EOT> ^o, ^O <SI> ^z, ^Z <SUB>
^e, ^E <ENQ> ^p, ^P <DLE> ^[ <ESC>
^f, ^F <ACK> ^q, ^Q <DC1> ^\ <FS>
^g, ^G <BEL> ^r, ^R <DC2> ^] <GS>
^h, ^H <BS> ^s, ^S <DC3> ^^ <RS>
^i, ^I <HT> ^t, ^T <DC4> ^_ <US>
^j, ^J <LF> ^u, ^U <NAK> ^? <DEL>
^k, ^K <VT> ^v, ^V <SYN>
For more information on these special characters, see
termio(7).
ctab c Set synchronous terminal tab character to c. Use
with the
-stappl option.
discard c Set discard character to c.
dsusp c Set to c character that suspends foreground process
when process attempts to read c.
eof c Set end-of-file character to c.
eol c Set end-of-line character to c.
eol2 c Set secondary end-of-line character to c.
erase c Set ERASE character to c (default is now BACKSPACE
or ^H)
intr c Set interrupt character to c.
kill c Set KILL character to c (default is now ^U)
lnext c Set to c character that causes the special meaning
of next character to be ignored.
quit c Set quit character to c.
reprint c Set reprint character to c.
Copyright 1994 Novell, Inc. Page 9
stty(1) stty(1)
start c Set start character to c.
stop c Set stop character to c.
susp c Set suspend character to c.
swtch c Set switch character to c.
werase c Set word-erase character to c.
min n Set the minimum number of characters that satisfy a
read in non-canonical mode input processing
(-icanon) to n.
time n Set the intercharacter timer in non-canonical mode
input processing (-icanon) to n ticks.
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
processing).
nl (-nl) Unset (set) icrnl, onlcr. In addition -nl unset
inlcr, igncr, ocrnl, and onlret.
Copyright 1994 Novell, Inc. Page 10
stty(1) stty(1)
lcase (-lcase)
Set (unset) xcase, iuclc, and olcuc.
LCASE (-LCASE)
Same as lcase (-lcase).
tabs (-tabs or tab3)
Preserve (expand to spaces) tabs when printing.
ek Reset ERASE and KILL characters back to defaults of
BACKSPACE (or ^H) and ^U.
sane Reset 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 rsetcoff.
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.
Control Modes for the Video Monitor
mono Select the monochrome display as the output device
for the console screen. This mode is valid if a
standard monochrome adapter is present or if a
standard enhanced graphics adapter (EGA) is present
and the EGA is currently in one of the monochrome
display modes.
color Select a standard regular color display as the
output device for the console screen. This mode is
valid if a color graphics adapter is present or if a
standard EGA is present and is currently in one of
the color graphics compatibility modes.
Copyright 1994 Novell, Inc. Page 11
stty(1) stty(1)
enhanced Select the enhanced color display as the output
device for the console screen. This mode is valid
if an EGA is present and is currently in a non-
monochrome display mode.
pro Select the professional graphics adapter as the
output device for the system console. This mode is
valid if a VGA is present.
Control Modes for the Attached Display Devices
The stty command supports mode changes for the monochrome
display adapter (MDA), color graphics adapter (CGA), enhanced
graphics adapter (EGA), and video graphics array (VGA).
MCAMODE Reinitialize the monochrome graphics adapter.
ENH_CGA Select CGA hardware emulation, when an AT&T Super-Vu
video controller is attached.
The following keyboard and display control modes are valid for
the following configurations: standard color graphics adapter
(CGA) attached to a standard regular color display; standard
enhanced graphics adapter (EGA) (modes 0-6) attached to a
standard regular color display or standard enhanced color
display.
B40x25 Select 40x25 (40 columns x 25 rows) black and white
text display mode.
C40x25 Select 40x25 color text display mode.
B80x25 Select 80x25 black and white text display mode.
C80x25 Select 80x25 color display text mode.
BG320 Select 320x200 black and white graphics display
mode.
CG320 Select 320x200 color graphics display mode.
BG640 Select 640x200 black and white graphics display
mode.
The following options are valid only when an EGA is attached
to a standard regular color display or an enhanced color
display.
Copyright 1994 Novell, Inc. Page 12
stty(1) stty(1)
CG320_D Select EGA support for 320x200 graphics display mode
(EGA mode D).
CG640_E Select EGA support for 640x200 graphics display mode
(EGA mode E).
The following options are valid only when a standard EGA is
attached to an IBM monochrome display.
EGAMONO80x25
Select EGA Mode 7 as the display mode. Emulates the
support provided by the standard monochrome display
adapter.
EGAMONOAPA
Select EGA support for 640x350 graphics display mode
(EGA mode F).
ENHMONOAPA2
Select EGA mode F*.
The following options are valid only when a standard EGA is
attached to a standard enhanced color display.
ENH_B40x25
Select enhanced EGA support for 40x25 black and
white text display mode (EGA mode 0*).
ENH_C40x25
Select enhanced EGA support for 40x25 color text
display mode (EGA mode 1*).
ENH_B80x25
Select enhanced EGA support for 80x25 black and
white text display mode (EGA mode 2*).
ENH_C80x25
Select enhanced EGA support for 80x25 color text
display mode (EGA mode 3*).
ENH_B80x43
Select enhanced EGA support for 80x43 black and
white text display mode.
Copyright 1994 Novell, Inc. Page 13
stty(1) stty(1)
ENH_C80x43
Select enhanced EGA support for 80x43 color text
display mode.
CG640x350 Select EGA support for 640x350 graphics display mode
(EGA mode 10).
ENH_CG640 Select EGA mode 10*.
The following options are valid only when a standard VGA is
attached to a color display.
VGAMONO80x25
Select VGA Mode 7 as the display mode. Emulates the
support provided by the standard monochrome display
adapter.
VGA_C40x25
Select VGA 40x25 color text display mode.
VGA_C80x25
Select VGA 80x25 color text display mode.
FILES
/usr/lib/locale/locale/LC_MESSAGES/uxcore.abi
language-specific message file [see LANG on environ(5)].
REFERENCES
ioctl(2), tabs(1), termio(7), termiox(7)
NOTES
In UnixWare 2.0, the defaults for the ERASE and line KILL
characters have been updated to the industry standard values
of BACKSPACE (or ^H) and ^U, respectively.
Copyright 1994 Novell, Inc. Page 14