stty(1)stty(1)NAMEstty - Sets terminal characteristics
SYNOPSISstty [-a | -g] [-f special-device]
stty [-f special-device] [argument...]
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
stty: XCU5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
OPTIONS
Writes to standard output all the current settings for the terminal.
[Tru64 UNIX] Allows you to specify an alternate terminal or teletype
device. Normally, the stty command works on standard input. Writes to
standard output the current settings in an unspecified form that can be
used as arguments to another stty utility on the same system.
DESCRIPTION
The stty utility sets or reports on terminal I/O characteristics for
the device that is its standard input.
The -dsusp switch works only when the terminal settings are set to the
BSD clist options in the sysconfigtab file.
The stty-status command is no longer supported.
Without options or arguments specified, stty reports the settings of
certain characteristics, usually those that differ from implementation-
defined defaults; otherwise, stty modifies the terminal state according
to the specified arguments. Some combinations of arguments are mutu‐
ally exclusive on some terminal types.
Sections marked with (I18N) describe features that are available when:
The Tru64 UNIX optional subsets for Asian country support are installed
on your system. The Asian or Thai terminal interface has been enabled.
Control Modes
The following arguments are available to set the terminal characteris‐
tics: Enables (disables) parity generation and detection. Selects odd
(even) parity. Selects character size, if possible. Sets terminal
baud rate to the number given, if possible. If the baud rate is set to
zero, modem control is no longer asserted. Sets terminal input baud
rate to the number given, if possible. If zero is specified, the input
baud rate is set to be the same as the output baud rate. Sets terminal
output baud rate to the number given, if possible. If the output baud
rate is set to zero, modem control is no longer asserted. Stops
asserting modem control (does not stop asserting modem control) on last
close. Same as hupcl (-hupcl). Uses two (one) stop bits per charac‐
ter. Enables (disables) the receiver. Assumes a line without (with)
modem control. [Tru64 UNIX] Enables (disables) hardware flow control
using the Request to Send (RTS) and Clear to Send (CTS) signals.
[Tru64 UNIX] Disables (enables) the printing of kernel-generated sta‐
tus information when the info control character is entered.
Input Modes
[Tru64 UNIX] Echoes control characters as ^X and <Delete> as ^?.
Prints two backspaces following the End-of-File character. (Special
characters are echoed as themselves.) Ignores (does not ignore) break
on input. Signals (does not signal) INTR on break. Ignores (does not
ignore) parity errors. Marks (does not mark) parity errors. Enables
(disables) input parity checking. Strips (does not strip) input char‐
acters to seven bits. Maps (does not map) newline to carriage-return
on input. Ignores (does not ignore) carriage-return on input. Maps
(does not map) carriage-return to newline on input. [Tru64 UNIX] Does
(does not) ring bell on terminal when input buffer is full. Maps (does
not map) uppercase alphabetic characters to lowercase. Enables (dis‐
ables) Start/Stop output control. Output from the system is stopped
when the system receives Stop and started when the system receives
Start. Allows any character (allows only <Ctrl-q>) to restart output.
Requests that the system send (not send) Start/Stop characters when the
input queue is nearly empty/full.
Output Modes
Post-processes output (does not post-process output; ignores all other
output modes). Maps (does not map) lowercase alphabetic characters to
uppercase on output. [Tru64 UNIX] Discards (keeps) End-of-Text on
output. [Tru64 UNIX] Maps (does not map) newline characters to car‐
riage-return/newline characters. Maps (does not map) carriage-
return/newline characters to newline characters. Does not (does) out‐
put carriage-return characters at column 0 (zero). Causes (does not
cause) newline to perform the carriage-return function on the terminal.
Uses fill characters (uses timing) for delays. Uses Delete (uses Null)
characters for fill characters. [Tru64 UNIX] Maintains (expands to
spaces) any tab characters in the output. Selects style of delay for
carriage-return characters. Selects style of delay for newline charac‐
ters. Selects style of delay for horizontal tabs. Selects style of
delay for backspaces. Selects style of delay for form feeds. Selects
style of delay for vertical tabs. [Tru64 UNIX] Specifies the number
of lines this display can hold. [Tru64 UNIX] Specifies the number of
characters per display line.
Local Modes
[Tru64 UNIX] Uses (does not use) the altwerase mode, which defines a
word as containing only alphanumeric characters and _ (underscore).
Enables (disables) the checking of characters against the special con‐
trol characters INTR, QUIT, and SUSP. Enables (disables) canonical
input (Erase and Kill processing). [Tru64 UNIX] Echoes (does not
echo) the Kill character by erasing the line in place like echoe.
[Tru64 UNIX] Uses (does not use) carrier as a flow control flag rather
than sending a HANGUP signal. [Tru64 UNIX] Prints (does not print)
erased characters backwards within \ (backslash) and / (slash). Stops
(allows) output from background jobs to the terminal. [Tru64
UNIX] Echoes (does not echo) uppercase characters on input, and dis‐
plays uppercase characters on output with a preceding \ (backslash).
Enables (disables) any implementation-defined special control-charac‐
ters not currently controlled by icanon, isig, or ixon. Echoes back
(does not echo back) every character typed. Causes the Erase character
to (to not) visually erase the last character in the current line from
the display, if possible. Echoes (does not echo) newline after the
Kill character. Echoes (does not echo) newline, even if echo is dis‐
abled. Disables (enables) flush after INTR, QUIT, SUSP.
Control Assignments
Sets special-character to string. The special character is set to the
first character in string and subsequent characters are ignored, with
the following exceptions: The strings undef and ^- set the special
character to {_POSIX_VDISABLE} if it is in effect for the device. The
string ^? sets the special character to <Delete>. Any other string
beginning with the character ^ sets the special character to the con‐
trol character corresponding to the second character of string (subse‐
quent characters are ignored). For example, the string ^c sets the
special character to ^C; the string ^zq sets the special character to
^Z.
Note that you can set a special character to a control character
in two ways: by entering the control character itself or by
entering ^ and another character. This allows you to enter a
control characters that is already assigned to a special charac‐
ter without entering that special character; for example, you
can enter ^C, even if it is already assigned to the intr special
character, by entering ^ and then c.
Recognized special-characters include dsusp, eof, eol, eol2,
erase, discard, status, intr, kill, lnext, quit, reprint, start,
stop, susp, and werase. Sets the current terminal characteris‐
tics to the saved settings produced by the -g option. Sets the
value of min or time to number. MIN and TIME are used in Non-
Canonical mode input processing (-icanon). Sets the line disci‐
pline to the specified number.
Combination Modes
Enables parenb and cs7; disables parodd. Enables parenb, cs7, and par‐
odd. Disables parenb, and sets cs8. Enables (disables) raw input and
output (no ERASE, KILL, INTR, QUIT, EOT, or output processing).
Enables (disables) icrnl and onlcr. The -nl mode also unsets inlcr,
igncr ocrnl, and onlret. Sets (unsets) xcase, iuclc, and olcuc. (Used
for terminals with uppercase characters only.) Resets all modes to
some reasonable values.
Asian Line Discipline Setup (I18N)
Sets the current line discipline to Asian and sets up the processing
environment for Asian codesets other than those for Japanese. The
application code is set to the codeset defined in the current locale.
The terminal code may also be set to the same codeset when not defined.
Sets the current line discipline to Asian and sets up the processing
environment for Japanese codesets. Terminal code is always be set to
dec, but the application code depends on the current local setting. If
a valid Japanese codeset is found in the current locale, the applica‐
tion code is set to that codeset. Otherwise, the application code is
set to eucJP.
Do not select the adec or jdec line discipline for a console that is
using the KEBUG driver. Doing so may cause the console to hang.
Modes for Terminal and Application Code (I18N)
Sets the application code to codeset. Sets the terminal code to code‐
set. Sets both the terminal code and the application code to codeset.
Enables (disables) codeset conversion between the internal code and the
application and terminal codes. Codeset conversion must be enabled in
order for Asian terminal features to work. Codeset conversion should
be disabled only under certain circumstances that do not allow modifi‐
cation of data passing through the terminal lines. One such circum‐
stance would be running an 8-bit binary file transfer protocol, such as
kermit and sz (zmodem).
Japanese Input Modes (I18N)
Sets the input mode for 8-bit code or Hankaku Kana code from the termi‐
nal. The following keywords can be used for the mode argument: The
8-bit code from the terminal is treated as a part of the Kanji code
when the terminal code is set to dec. The 8-bit code (when terminal
code is dec) or the Hankaku Kana code from the terminal is converted to
the 16-bit Hiragana code. The 8-bit code (when terminal code is dec)
or the Hankaku Kana code from the terminal is converted to the 16-bit
Katakana code. The 8-bit code (when terminal code is dec) or the Han‐
kaku Kana code from the terminal is converted to the 8-bit Hankaku Kana
code. Enables (disables) the Japanese input method. The Kana-Kanji
conversion daemon, kkcd, is spawned (ikk) or killed (-ikk). The kkseq
key map information is derived from the following (in priority order):
The file specified by the JSYKKSEQ environment variable The ~/.jsykkseq
file
Dictionary names are derived from the following (in priority
order): The files specified by the JSYTANGO, JSYKOJIN, and
JSYLEARN environment variables The /usr/i18n/jsy/jsytango.dic,
~/jsykojin.dic, and ~/.jsylearn files. Sets the character or
sequence of characters that enters Kana-Kanji conversion mode
when using the STREAMS terminal driver. Sets the JIS Kanji
shift-in escape sequence for the JIS terminal. Sets the JIS
Kanji shift-out escape sequence for the JIS terminal. Sets the
character attribute used to mark a clause that is the result of
the Kana-Kanji conversion. The four possible values for mode
are bold, underline, reverse, or none. The sequences that
determine these values are taken from the terminfo database.
The bold sequence is taken from “md” and “me”, reverse is taken
from “mr” and “me”, and underline is taken from “us” and “ue”.
Sets the character attribute used to mark a Henkan region that
is the result of the Kana-Kanji conversion. The four possible
values for mode are bold, underline, reverse, or none. The
sequences that determine these values are taken from the ter‐
minfo database. The old sequence is taken from “md” and “me”,
reverse is taken from “mr” and “me”, and underline is taken from
“us” and “ue”. Sets the Kana-Kanji conversion key map file for
the terminal. Displays the current Kana-Kanji conversion key
map, a traversal tree with a maximum sequence length of 15 char‐
acters. Uses one (uses two) backspaces to erase one Kanji char‐
acter on the terminal. Uses (does not use) a single 2-byte
zenkaku space (two ASCII spaces) to blank out one Kanji charac‐
ter on the terminal. If terminal code is either jis7 or jis8,
changes (does not change) the terminal state to shift out when‐
ever a newline code is output. Enables (disables) the extended
Kana-Kanji conversion mode. The char value sets or resets the
character that toggles in and out of extended Kana-Kanji conver‐
sion mode.
Modes for Software On-Demand Loading (I18N)
Enables (disables) the Software On-Demand Loading (SoftODL) service.
Sets the maximum size, in characters, of the ODL buffer. This size
should be the same as the terminal's font cache size. The default size
is 256. Sets the type of the ODL buffer replacement strategy. The
type arguments can be either fifo (First-In-First-Out) or lru (Least-
Recently-Used). Sets the path to the ODL database files. If this path
is not specified, the default path is the one for the user's private
database (if private databases are allowed on the system) or to the
systemwide ODL database. Resets the ODL service and clears the inter‐
nal ODL buffers. Displays the current ODL service attributes.
Modes for the Software Phrase Input Method (I18N)
Enables (disables) the Software Phrase Input Method (SIM) service.
Specifies the key that toggles in and out of phrase input mode. Sets
the current class name for locating the appropriate phrase in the
phrase database. Sets the path of the phrase database. Sets the dis‐
play mode of the SIM service. The two supported mode values are
offspot (default) and onspot. In offspot mode, the input phrase name
is displayed at the 26th line of your terminal, if supported. In
onspot mode, the phrase name is displayed at the current cursor posi‐
tion. With DECterm, xterm, or other terminal emulators that do not
support the 26th display line, specify the onspot mode value. Displays
the current SIM service attributes.
Miscellaneous Asian Terminal Modes (I18N)
Enables (disables) the history mechanism. The key value sets or resets
the key used to toggle in and out of history mode. Note that command
lines that are fewer than three characters long are not recorded in the
history list.
Thai Terminal Modes (I18N)
Sets the current line discipline to Thai. Sets the WTT Input Sequence
Check (ISC) mode. Valid mode values are 0, 1, or 2, which stand for
pass-through, basic check, or strict mode, respectively. Enables or
disables input reordering. Enables (disables) the history mechanism.
The key value sets or resets the key used to toggle in and out of his‐
tory mode. Note that command lines that are fewer than three characters
long are not recorded in the history list.
Compatibility Modes
Resets Erase and Kill characters back to the system defaults. Same as
echok. Same as ixon (-ixon). Same as ixoff (-ixoff). Same as ixany
(-ixany). Sets all modes suitable for terminals developed by Digital
Equipment Corporation (now Hewlett-Packard Company). (The control-
character Erase is set to ^?).
(I18N) For the Asian (atty) and Thai (ttty) terminal interfaces,
dec also switches the line discipline back to the default TTY‐
DISC line discipline. Same as echoe (-echoe). Same as echoctl
(-echoctl). Sets (clears) echoe, echoke, and echoctl. Sends
output characters with no (with) output processing. Expands
(does not expand) tabs to spaces. Same as ofill (-ofill). Same
as -a. Does not (does) send HANGUP signal if carrier drops.
Does character fill and uses Null character. Does character
fill and uses Delete character. Sets modes suitable for the
Teletype Corporation Model 33 terminal. Sets modes suitable for
the Teletype Corporation Model 37 terminal. Sets modes suitable
for the Digital Equipment Corporation Model VT05 terminal. Sets
modes suitable for the General Electric TermiNet 300. Sets
modes suitable for the Texas Instruments 700 series. Sets modes
suitable for the Tektronix 4014 terminal. Prints only the line
speed and a trailing semicolon (;). Prints only the terminal
size.
If no options are specified, an unspecified subset of the information
displayed for the -a option is displayed.
If the terminal input speed and output speed are the same, the speed
information is displayed as follows: speed speed baud
Otherwise, speeds are displayed as follows: ispeed ispeed baud;
ospeed ospeed baud;
Control-characters are displayed as follows: control-character = value
In this display, value is either the character, some visual representa‐
tion of the character if it is nonprinting, or the string undef if the
character is disabled.
EXIT STATUS
The stty utility exits with one of the following values: The terminal
options were read or set successfully. An error occurred.
ENVIRONMENT VARIABLES
The following environment variables affect the execution of stty: Pro‐
vides a default value for the internationalization variables that are
unset or null. If LANG is unset or null, the corresponding value from
the default locale is used. If any of the internationalization vari‐
ables contain an invalid setting, the utility behaves as if none of the
variables had been defined. If set to a non-empty string value, over‐
rides the values of all the other internationalization variables.
Determines the locale for the interpretation of sequences of bytes of
text data as characters (for example, single-byte as opposed to multi‐
byte characters in arguments). Determines the locale for the format
and contents of diagnostic messages written to standard error. Deter‐
mines the location of message catalogues for the processing of LC_MES‐
SAGES.
SEE ALSO
Commands: tty(1)
Functions: ioctl(2)
Routines: curses(3), tcgetattr(3), tcsetattr(3), ttyname(3)
Files: termios(4), atty(7), tty(7), ttty(7)
Standards: standards(5)
Others: Chinese(5), i18n_intro(5), iconv_intro(5), Japanese(5),
Korean(5), Thai(5)stty(1)
