Content-type: text/html
stty - Sets terminal characteristics
stty [-a|-g] [-f special-device]
stty [-f special-device] [argument...]
Interfaces documented on this reference page conform to industry standards as follows:
stty: XPG4, XPG4-UNIX
Refer to the
standards(5)
reference page for more information
about industry standards and associated tags.
Writes to standard output all the current settings for the
terminal.
[Compaq] 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.
The stty utility sets or reports on terminal I/O characteristics for the device that is its standard input.
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 mutually 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.
The following arguments are available to set the terminal characteristics:
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 character.
Enables (disables) the receiver.
Assumes a line without (with) modem control.
[Compaq] Enables (disables) hardware flow control using the
Request to Send (RTS) and Clear to Send (CTS) signals.
[Compaq] Disables (enables) the printing of kernel-generated
status information when the
info
control character is entered.
[Compaq] 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 characters 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.
[Compaq] Does (does not) ring bell on terminal when input
buffer is full.
Maps (does not map) uppercase alphabetic characters to lowercase.
Enables (disables) 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.
Post-processes output (does not post-process output; ignores
all other output modes).
Maps (does not map) lowercase alphabetic characters to uppercase
on output.
[Compaq] Discards (keeps) End-of-Text on output.
[Compaq] Maps (does not map) newline characters to carriage-return/newline
characters.
Maps (does not map) carriage-return/newline characters to
newline characters.
Does not (does) output 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.
[Compaq] Maintains (expands to spaces) any tab characters
in the output.
Selects style of delay for carriage-return characters.
Selects style of delay for newline characters.
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.
[Compaq] Specifies the number of lines this display can hold.
[Compaq] Specifies the number of characters per display line.
[Compaq] 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 control characters
INTR,
QUIT,
and
SUSP.
Enables (disables) canonical input (Erase and Kill processing).
[Compaq] Echoes (does not echo) the Kill character by erasing
the line in place like
echoe.
[Compaq] Uses (does not use) carrier as a flow control flag
rather than sending a
HANGUP
signal.
[Compaq] Prints (does not print) erased characters backwards
within \ (backslash) and / (slash).
Stops (allows) output from background jobs to the terminal.
[Compaq] Echoes (does not echo) uppercase characters on input,
and displays uppercase characters on output with a preceding \ (backslash).
Enables (disables) any implementation-defined special control-characters
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 disabled.
Disables (enables) flush after
INTR,
QUIT,
SUSP.
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 control character corresponding to the second character of string (subsequent characters are ignored). For example, the string ^c sets the special character to ^C; the string ^zq sets the special character to ^Z.
Enables
parenb
and
cs7;
disables
parodd.
Enables
parenb,
cs7,
and
parodd.
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.
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 application 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.
Sets the application code to
codeset.
Sets the terminal code to
codeset.
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 modification of
data passing through the terminal lines. One such circumstance would be running
an 8-bit binary file transfer protocol, such as kermit and sz (zmodem).
Sets the input mode for 8-bit code or Hankaku Kana code from the terminal. 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 Hankaku 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
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 internal ODL buffers.
Displays the current ODL service attributes.
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 display 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 position. 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.
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.
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
history mode. Note that command lines that are fewer than three characters
long are not recorded in the history list.
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 supplied by Digital Equipment Corporation. (The control-character Erase is set to ^?).
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 representation of the character if it is nonprinting, or the string
undef
if the character is disabled.
The
stty
utility exits with one of the following
values:
The terminal options were read or set successfully.
An error occurred.
The following environment variables affect the execution of
stty:
Provides 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 variables contain an invalid setting, the
utility behaves as if none of the variables had been defined.
If set to a non-empty string value, overrides 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
multibyte characters in arguments).
Determines the locale for the format and contents of diagnostic
messages written to standard error.
Determines the location of message catalogues for the processing
of
LC_MESSAGES.
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)