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: XCU5.0
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. [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.
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 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.
Control Modes [Toc] [Back]
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.
[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 status information when the info control
character is entered.
Input Modes [Toc] [Back]
[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 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. [Tru64 UNIX] 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.
Output Modes [Toc] [Back]
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
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. [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 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. [Tru64
UNIX] Specifies the number of lines this display can
hold. [Tru64 UNIX] Specifies the number of characters
per display line.
Local Modes [Toc] [Back]
[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 control 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 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.
Control Assignments [Toc] [Back]
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.
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
character 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 characteristics
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 discipline to the
specified number.
Combination Modes [Toc] [Back]
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.
Asian Line Discipline Setup (I18N) [Toc] [Back]
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.
Modes for Terminal and Application Code (I18N) [Toc] [Back]
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).
Japanese Input Modes (I18N) [Toc] [Back]
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 KanaKanji
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 terminfo 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 characters. Uses one (uses
two) backspaces to erase one Kanji character on the
terminal. Uses (does not use) a single 2-byte
zenkaku space (two ASCII spaces) to blank out one
Kanji character on the terminal. If terminal code
is either jis7 or jis8, changes (does not change)
the terminal state to shift out whenever 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 conversion mode.
Modes for Software On-Demand Loading (I18N) [Toc] [Back]
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.
Modes for the Software Phrase Input Method (I18N) [Toc] [Back]
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.
Miscellaneous Asian Terminal Modes (I18N) [Toc] [Back]
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) [Toc] [Back]
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.
Compatibility Modes [Toc] [Back]
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 controlcharacter
Erase is set to ^?).
(I18N) For the Asian (atty) and Thai (ttty) terminal
interfaces, dec also switches the line discipline
back to the default TTYDISC 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 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.
ENVIRONMENT VARIABLES [Toc] [Back] 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)
stty(1)
[ Back ] |
