 |
Index for
Section 1 |
|
 |
Alphabetical
listing for S |
|
 |
Bottom of
page |
|
stty(1)
NAME
stty - Sets terminal characteristics
SYNOPSIS
stty [-a | -g] [-f special-device]
stty [-f special-device] [argument...]
STANDARDS
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.
OPTIONS
-a Writes to standard output all the current settings for the terminal.
-f special-device
[Tru64 UNIX] Allows you to specify an alternate terminal or teletype
device. Normally, the stty command works on standard input.
-g 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 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
The following arguments are available to set the terminal characteristics:
parenb (-parenb)
Enables (disables) parity generation and detection.
parodd (-parodd)
Selects odd (even) parity.
cs5 cs6 cs7 cs8
Selects character size, if possible.
number
Sets terminal baud rate to the number given, if possible. If the baud
rate is set to zero, modem control is no longer asserted.
ispeed number
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.
ospeed number
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.
hupcl (-hupcl)
Stops asserting modem control (does not stop asserting modem control)
on last close.
hup (-hup)
Same as hupcl (-hupcl).
cstopb (-cstopb)
Uses two (one) stop bits per character.
cread (-cread)
Enables (disables) the receiver.
clocal (-clocal)
Assumes a line without (with) modem control.
crtscts (-crtscts)
[Tru64 UNIX] Enables (disables) hardware flow control using the
Request to Send (RTS) and Clear to Send (CTS) signals.
nokerninfo (-nokerninfo)
[Tru64 UNIX] Disables (enables) the printing of kernel-generated
status information when the info control character is entered.
Input Modes
echoctl (-echoctl)
[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.)
ignbrk (-ignbrk)
Ignores (does not ignore) break on input.
brkint (-brkint)
Signals (does not signal) INTR on break.
ignpar (-ignpar)
Ignores (does not ignore) parity errors.
parmrk (-parmrk)
Marks (does not mark) parity errors.
inpck (-inpck)
Enables (disables) input parity checking.
istrip (-istrip)
Strips (does not strip) input characters to seven bits.
inlcr (-inlcr)
Maps (does not map) newline to carriage-return on input.
igncr (-igncr)
Ignores (does not ignore) carriage-return on input.
icrnl (-icrnl)
Maps (does not map) carriage-return to newline on input.
imaxbel (-imaxbel)
[Tru64 UNIX] Does (does not) ring bell on terminal when input buffer
is full.
iuclc (-iuclc)
Maps (does not map) uppercase alphabetic characters to lowercase.
ixon (-ixon)
Enables (disables) Start/Stop output control. Output from the system
is stopped when the system receives Stop and started when the system
receives Start.
ixany (-ixany)
Allows any character (allows only <Ctrl-q>) to restart output.
ixoff (-ixoff)
Requests that the system send (not send) Start/Stop characters when the
input queue is nearly empty/full.
Output Modes
opost (-opost)
Post-processes output (does not post-process output; ignores all other
output modes).
olcuc (-olcuc)
Maps (does not map) lowercase alphabetic characters to uppercase on
output.
onoeot (-onoeot)
[Tru64 UNIX] Discards (keeps) End-of-Text on output.
onlcr (-onlcr)
[Tru64 UNIX] Maps (does not map) newline characters to carriage-
return/newline characters.
ocrnl (-ocrnl)
Maps (does not map) carriage-return/newline characters to newline
characters.
onocr (-onocr)
Does not (does) output carriage-return characters at column 0 (zero).
onlret (-onlret)
Causes (does not cause) newline to perform the carriage-return function
on the terminal.
ofill (-ofill)
Uses fill characters (uses timing) for delays.
ofdel (-ofdel)
Uses Delete (uses Null) characters for fill characters.
tabs (-tabs)
[Tru64 UNIX] Maintains (expands to spaces) any tab characters in the
output.
cr0 cr1 cr2 cr3
Selects style of delay for carriage-return characters.
nl0 nl1 nl2 nl32
Selects style of delay for newline characters.
tab0 tab1 tab2 tab3
Selects style of delay for horizontal tabs.
bs0 bs1
Selects style of delay for backspaces.
ff0 ff1
Selects style of delay for form feeds.
vt0 vt1
Selects style of delay for vertical tabs.
rows number
[Tru64 UNIX] Specifies the number of lines this display can hold.
columns number (or cols number)
[Tru64 UNIX] Specifies the number of characters per display line.
Local Modes
altwerase (-altwerase)
[Tru64 UNIX] Uses (does not use) the altwerase mode, which defines a
word as containing only alphanumeric characters and _ (underscore).
isig (-isig)
Enables (disables) the checking of characters against the special
control characters INTR, QUIT, and SUSP.
icanon (-icanon)
Enables (disables) canonical input (Erase and Kill processing).
crtkill (-crtkill)
[Tru64 UNIX] Echoes (does not echo) the Kill character by erasing the
line in place like echoe.
mdmbuf (-mdmbuf)
[Tru64 UNIX] Uses (does not use) carrier as a flow control flag rather
than sending a HANGUP signal.
prterase (-prterase)
[Tru64 UNIX] Prints (does not print) erased characters backwards
within \ (backslash) and / (slash).
tostop (-tostop)
Stops (allows) output from background jobs to the terminal.
xcase (-xcase)
[Tru64 UNIX] Echoes (does not echo) uppercase characters on input, and
displays uppercase characters on output with a preceding \ (backslash).
iexten (-iexten)
Enables (disables) any implementation-defined special control-
characters not currently controlled by icanon, isig, or ixon.
echo (-echo)
Echoes back (does not echo back) every character typed.
echoe (-echoe)
Causes the Erase character to (to not) visually erase the last
character in the current line from the display, if possible.
echok (-echok)
Echoes (does not echo) newline after the Kill character.
echonl (-echonl)
Echoes (does not echo) newline, even if echo is disabled.
noflsh (-noflsh)
Disables (enables) flush after INTR, QUIT, SUSP.
Control Assignments
special-character string
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.
saved settings
Sets the current terminal characteristics to the saved settings
produced by the -g option.
min number
time number
Sets the value of min or time to number. MIN and TIME are used in
Non-Canonical mode input processing (-icanon).
line number
Sets the line discipline to the specified number.
Combination Modes
evenp or parity
Enables parenb and cs7; disables parodd.
oddp
Enables parenb, cs7, and parodd.
parity, evenp, oddp
Disables parenb, and sets cs8.
raw (-raw | cooked)
Enables (disables) raw input and output (no ERASE, KILL, INTR, QUIT,
EOT, or output processing).
nl (-nl)
Enables (disables) icrnl and onlcr. The -nl mode also unsets inlcr,
igncr ocrnl, and onlret.
lcase (-lcase)
LCASE (-LCASE)
Sets (unsets) xcase, iuclc, and olcuc. (Used for terminals with
uppercase characters only.)
sane
Resets all modes to some reasonable values.
Asian Line Discipline Setup (I18N)
adec
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.
jdec
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)
acode codeset
Sets the application code to codeset.
tcode codeset
Sets the terminal code to codeset.
code codeset
Sets both the terminal code and the application code to codeset.
conv (-conv)
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)
imode mode
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:
kanji
The 8-bit code from the terminal is treated as a part of the Kanji
code when the terminal code is set to dec.
hiragana
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.
katakana
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.
hankaku
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.
ikk (-ikk)
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):
1. The file specified by the JSYKKSEQ environment variable
2. The ~/.jsykkseq file
Dictionary names are derived from the following (in priority order):
1. The files specified by the JSYTANGO, JSYKOJIN, and JSYLEARN
environment variables
2. The /usr/i18n/jsy/jsytango.dic, ~/jsykojin.dic, and ~/.jsylearn
files.
jinkey char-sequence
Sets the character or sequence of characters that enters Kana-Kanji
conversion mode when using the STREAMS terminal driver.
kin esc-seq
Sets the JIS Kanji shift-in escape sequence for the JIS terminal.
kout esc-seq
Sets the JIS Kanji shift-out escape sequence for the JIS terminal.
clause mode
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".
henkan mode
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".
kkseq file
Sets the Kana-Kanji conversion key map file for the terminal.
kkmap
Displays the current Kana-Kanji conversion key map, a traversal tree
with a maximum sequence length of 15 characters.
knj.bs1 (-knj.bs1)
Uses one (uses two) backspaces to erase one Kanji character on the
terminal.
knj.sp (-knj.sp)
Uses (does not use) a single 2-byte zenkaku space (two ASCII spaces) to
blank out one Kanji character on the terminal.
esc.alw (-esc.alw)
If terminal code is either jis7 or jis8, changes (does not change) the
terminal state to shift out whenever a newline code is output.
jx char (-jx)
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)
odl (-odl)
Enables (disables) the Software On-Demand Loading (SoftODL) service.
odlsize size
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.
odltype type
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).
odldb path
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.
odlreset
Resets the ODL service and clears the internal ODL buffers.
odlall
Displays the current ODL service attributes.
Modes for the Software Phrase Input Method (I18N)
sim (-sim)
Enables (disables) the Software Phrase Input Method (SIM) service.
simkey key
Specifies the key that toggles in and out of phrase input mode.
simclass class
Sets the current class name for locating the appropriate phrase in the
phrase database.
simdb path
Sets the path of the phrase database.
simmode dmode
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.
simall
Displays the current SIM service attributes.
Miscellaneous Asian Terminal Modes (I18N)
history key (-history)
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)
tdec
Sets the current line discipline to Thai.
isc mode
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.
reorder (-reorder)
Enables or disables input reordering.
thistory key (-thistory)
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
ek Resets Erase and Kill characters back to the system defaults.
lfkc (-lfkc)
Same as echok.
flow (-flow)
Same as ixon (-ixon).
tandem (-tandem)
Same as ixoff (-ixoff).
decctlq (-decctlq)
Same as ixany (-ixany).
dec 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 TTYDISC line
discipline.
crterase (-crterase)
crtbs (-crtbs)
Same as echoe (-echoe).
ctlecho (-ctlecho)
Same as echoctl (-echoctl).
crt (-crt)
newcrt (-newcrt)
Sets (clears) echoe, echoke, and echoctl.
litout (-litout)
Sends output characters with no (with) output processing.
xtabs (-xtabs)
oxtabs (-oxtabs)
Expands (does not expand) tabs to spaces.
fill (-fill)
Same as ofill (-ofill).
all
everything
Same as -a.
echoke (-echoke)
nohang (-nohang)
Does not (does) send HANGUP signal if carrier drops.
nul-fill
Does character fill and uses Null character.
del-fill
Does character fill and uses Delete character.
tty33
Sets modes suitable for the Teletype Corporation Model 33 terminal.
tty37
Sets modes suitable for the Teletype Corporation Model 37 terminal.
vt05
Sets modes suitable for the Digital Equipment Corporation Model VT05
terminal.
tn300
Sets modes suitable for the General Electric TermiNet 300.
ti700
Sets modes suitable for the Texas Instruments 700 series.
tek Sets modes suitable for the Tektronix 4014 terminal.
speed
Prints only the line speed and a trailing semicolon (;).
size
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.
EXIT STATUS
The stty utility exits with one of the following values:
0 The terminal options were read or set successfully.
>0 An error occurred.
ENVIRONMENT VARIABLES
The following environment variables affect the execution of stty:
LANG
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.
LC_ALL
If set to a non-empty string value, overrides the values of all the
other internationalization variables.
LC_CTYPE
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).
LC_MESSAGES
Determines the locale for the format and contents of diagnostic
messages written to standard error.
NLSPATH
Determines the location of message catalogues for the processing of
LC_MESSAGES.
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)
|
Index for
Section 1 |
|
|
Alphabetical
listing for S |
|
 |
Top of
page |
|