STTY(1B) BSD Compatibility Package Commands STTY(1B)
NAME
stty - set the options for a terminal
SYNOPSIS
/usr/ucb/stty [
-a] [
-g] [
-h] [
modes]
DESCRIPTION
stty sets certain terminal I/O options for the device that is the
current standard output. Without arguments,
stty reports the settings
of certain options.
OPTIONS
In this report, if a character is preceded by a caret (
^), then the
value of that option is the corresponding CTRL 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 Reports all of the option settings.
-g Reports current settings in a form that can be used as an
argument to another
stty command.
-h Reports all the option settings with the control characters in
an easy to read column format.
Options in the last group are implemented using options in the
previous groups. Many combinations of options make no sense, but no
sanity checking is performed. Hardware flow control and clock modes
options might not be supported by all hardware interfaces. The
options are selected from the following:
Special Requests
all Reports the same option settings as
stty without
arguments, but with the control characters in column
format.
everything Everything
stty knows about is printed. Same as
-h option.
speed The terminal speed alone is reported on the standard
output.
size The terminal (window) sizes are printed on the standard
output, first rows and then columns. This option is
only appropriate if currently running a window system.
size and
speed always report on the settings of
/dev/tty, and always report the settings to the
standard output.
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(4I)).
0 Hang up line immediately.
110 300 600 1200 1800 2400 4800 9600 19200 exta 38400 extb 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 exta 38400 extb 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 is specified by the
value of the output baud rate.
ospeed 0 110 300 600 1200 1800 2400 4800 9600 19200 exta 38400 extb Set terminal output baud rate to the number given, if possible.
(Not all hardware supports split baud rates.) If the baud rate
is set to zero, the line is 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.
crtscts (
-crtscts)
Enable hardware flow control. Raise the RTS (Request to Send)
modem control line. Suspends output until the
CTS (Clear to
Send) line is raised.
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(4I)).
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 an STOP and
started by sending an START.
ixany (
-ixany)
Allow any character (only START) to restart
output.
decctlq (
-decctlq)
Same as
-ixany.
ixoff (
-ixoff)
Request that the system send (not send)
START/STOP characters when the input queue is
nearly empty/full.
tandem (
-tandem) Same as
ixoff.
imaxbel (
-imaxbel) Echo (do not echo)
BEL when the input line is
too long.
iexten (
-iexten) Enable (disable) extended (implementation-
defined) functions for input data.
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(4I)).
nl0 nl1 Select style of delay for line-feeds (see
termio(4I)).
tab0 tab1 tab2 tab3 Select style of delay for horizontal tabs (see
termio(4I)).
bs0 bs1 Select style of delay for backspaces (see
termio(4I)).
ff0 ff1 Select style of delay for form-feeds (see
termio(4I)).
vt0 vt1 Select style of delay for vertical tabs (see
termio(4I)).
Local Modes
isig (
-isig)
Enable (disable) the checking of characters
against the special control characters INTR,
QUIT, and SWTCH. For information on
SWTCH,
see
NOTES.
icanon (
-icanon)
Enable (disable) canonical input (ERASE and
KILL processing). Does not set MIN or TIME.
cbreak (
-cbreak)
Equivalent to
-icanon min 1 time 0.
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 erases the ERASEed character on many CRT
terminals; however, it does
not keep track of
column position and, as a result, can be
confusing on escaped characters, tabs, and
backspaces.
crterase (
-crterase)
Same as
echoe.
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. For information on
SWTCH, see
NOTES.
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 for background
processes.
echoctl (
-echoctl) Echo (do not echo) control characters as
^
char, delete as ^?
ctlecho (
-ctlecho) Same as
echoctl.
echoprt (
-echoprt) Echo (do not echo) erase character as
character is ``erased''.
prterase (
-prterase)
Same as
echoprt.
echoke (
-echoke) BS-SP-BS erase (do not BS-SP-BS erase) entire
line on line kill.
crtkill (
-crtkill)
Same as
echoke.
flusho (
-flusho) Output is (is not) being flushed.
pendin (
-pendin) Retype (do not retype) pending input at next
read or input character.
stflush (
-stflush)
Enable (disable) flush on a synchronous line
after every
write(2). (Does not apply to the
3B2.)
stappl (
-stappl)
Use application mode (use line mode) on a
synchronous line. (Does not apply to the
3B2.)
Hardware Flow Control Modes
rtsxoff (
-rtsxoff)
Enable (disable) RTS hardware flow control on
input.
ctsxon (
-ctsxon)
Enable (disable) CTS hardware flow control on
output.
dterxoff (
-dterxoff)
Enable (disable) DTER hardware flow control
on input.
rlsdxon (
-rlsdxon)
Enable (disable) RLSD 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 the 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 not provided.
tsetcrc Output receive clock on transmitter signal element timing
(DTE source) lead, CCITT V.24 circuit 113, EIA-232-D pin
24, clock source.
tsetcxc Output transmit clock on transmitter signal element
timing (DTE source) lead, CCITT V.24 circuit 113,
EIA-232-D pin 24, clock source.
rsetcoff Receiver signal element timing clock not provided.
rsetcrc Output receive clock on receiver signal element timing
(DTE source) lead, CCITT V.24 circuit 128, no EIA-232-D
pin, clock source.
rsetcxc Output transmit clock on receiver signal element timing
(DTE source) lead, CCITT V.24 circuit 128, no EIA-232-D
pin, clock source.
Control Assignments
control-character c Set
control-character to
c, where
control- character is
intr,
quit,
erase,
kill,
eof,
eol,
eol2,
swtch,
start,
stop,
susp,
dsusp,
rprnt,
flush,
werase,
lnext min,
ctab,
time,
or
brk) (
ctab is used with
-stappl;
min and
time are used with
-icanon; see
termio(4I)).
If
c is preceded by an (escaped from the
shell) caret (
^), then the value used is the
corresponding CTRL character (for example,
``^d'' is a Control-d). ``^?'' is interpreted
as DEL and ``
^-'' is interpreted as undefined.
For information on
SWTCH, see
NOTES.
line i Set line discipline to
i (0 <
i < 127).
Combination Modes
evenp or
parity Enable
parenb and
cs7.
-evenp, or
-parity Disable
parenb, and set
cs8.
even (
-even)
Same as
evenp (
-evenp).
oddp Enable
parenb,
cs7, and
parodd.
-oddp Disable
parenb and
parodd, and set
cs8.
odd (
-odd)
Same as
oddp (
-oddp).
spacep Enable
parenb,
cs7, and
parext.
-spacep Disable
parenb and
parext, and set
cs8.
markp Enable
parenb,
cs7,
parodd, and
parext.
-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). For information on
SWTCH, see
NOTES.
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)
Preserve (expand to spaces) tabs when
printing.
ek Reset ERASE and KILL characters back to
normal DEL and CTRL-u, respectively.
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.
litout (-litout) Disable (enable)
parenb,
istrip, and
opost,
and set
cs8 (
cs7).
pass8 (-pass8) Disable (enable)
parenb and
istrip, and set
cs8 (
cs7).
crt Set options for a
CRT (
echoe,
echoctl, and,
if >= 1200 baud,
echoke.)
dec Set all modes suitable for Digital Equipment
Corp. operating systems users ERASE, KILL,
and INTR characters to
^?,
^U, and
^C,
decctlq, and
crt.)
Window Size
rowsn Set window size to
n rows.
columnsn Set window size to
n columns.
colsn An alias for
columns n.
ypixelsn Set vertical window size to
n pixels.
xpixelsn Set horizontal window size to
n pixels.
SEE ALSO
tabs(1),
ioctl(2),
termio(4I),
termiox(4I),
attributes(7)NOTES
Solaris does not support any of the actions implied by
swtch, which
was used by the
sxt driver on System V release 4. Solaris allows the
swtch value to be set, and prints it out if set, but it does not
perform the
swtch action.
The job switch functionality on Solaris is actually handled by job
control.
susp is the correct setting for this.
February 17, 2023 STTY(1B)
