|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
User Commands stty(1)
NAME
stty - set the options for a terminal
SYNOPSIS
/usr/bin/stty [-a] [-g]
/usr/bin/stty [modes]
/usr/xpg4/bin/stty [-a | -g]
/usr/xpg4/bin/stty [modes]
/usr/xpg6/bin/stty [-a | -g]
/usr/xpg6/bin/stty [modes]
DESCRIPTION
The stty utility sets certain terminal I/O options for the
device that is the current standard input. Without argu-
ments, stty reports the settings of certain options.
In this report, if a character is preceded by a caret (^),
then the value of that option is the corresponding control
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.
See termio(7I) for detailed information about the modes
listed from Control Modes through Local Modes. For detailed
information about the modes listed under Hardware Flow Con-
trol Modes and Clock Modes, see termiox(7I).
Operands described in the Combination Modes section are
implemented using options in the earlier sections. Notice
that many combinations of options make no sense, but no san-
ity checking is performed. Hardware flow control and clock
modes options might not be supported by all hardware inter-
faces.
OPTIONS
The following options are supported:
-a Writes to standard output all of the option set-
tings for the terminal.
-g Reports current settings in a form that can be used
as an argument to another stty command. Emits
termios-type output if the underlying driver sup-
ports it. Otherwise, it emits termio-type output.
SunOS 5.10 Last change: 14 Feb 2005 1
User Commands stty(1)
OPERANDS
The following mode operands are supported:
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(7I)).
0 Hang up line 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 charac-
ter.
cread (-cread) Enable (disable) the receiver.
crtscts (-crtscts) Enable output hardware flow control.
Raise the RTS (Request to Send)
modem control line. Suspends output
until the CTS (Clear to Send) line
is raised.
SunOS 5.10 Last change: 14 Feb 2005 2
User Commands stty(1)
crtsxoff (-crtsxoff) Enable input hardware flow control.
Raise the RTS (Request to Send)
modem control line to receive data.
Suspends input when RTS is low.
clocal (-clocal) Assume a line without (with) modem
control.
defeucw Set the widths of multibyte charac-
ters to the values defined in the
current locale specified by
LC_CTYPE. Internally, width is
expressed in terms of bytes per
character, and screen or display
columns per character.
110 300 600 1200 1800 Set terminal baud rate to
2400 4800 9600 19200 the number given, if possi-
38400 357600 76800 115200 ble. (All speeds are not
153600 230400 307200 460800 supported by all hardware
interfaces.)
ispeed 0 110 300 600 1200 Set terminal input baud rate
1800 2400 4800 9600 19200 to the number given, if pos-
38400 57600 76800 115200 sible. (Not all hardware
153600 230400 307200 460800 supports split baud rates.)
If the input baud rate is
set to 0, 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
38400 57600 76800 115200
153600 230400 307200 460800
SunOS 5.10 Last change: 14 Feb 2005 3
User Commands stty(1)
Set terminal output baud
rate to the number given, if
possible. (Not all hardware
supports split baud rates.)
If the output baud rate is
set to 0, the line is hung
up immediately.
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(7I)).
inpck (-inpck) Enable (disable) input parity check-
ing.
istrip (-istrip) Strip (do not strip) input charac-
ters to seven bits.
inlcr (-inlcr) Map (do not map) NL to CR on input.
igncr (-igncr) Ignore (do not ignore) CR on input.
SunOS 5.10 Last change: 14 Feb 2005 4
User Commands stty(1)
icrnl (-icrnl) Map (do not map) CR to NL on input.
iuclc (-iuclc) Map (do not map) upper-case alpha-
betics to lower case on input.
ixon (-ixon) Enable (disable) START/STOP output
control. Output is stopped by send-
ing STOP control character and
started by sending the START control
character.
ixany (-ixany) Allow any character (only DC1) to
restart output.
ixoff (-ixoff) Request that the system send (not
send) START/STOP characters when the
input queue is nearly empty/full.
imaxbel (-imaxbel) Echo (do not echo) BEL when the
input line is too long. If imaxbel
is set, the ASCII BEL character (07
hex) is echoed if the input stream
overflows. Further input is not
stored, but any input already
present is not disturbed. If -imax-
bel is set, no BEL character is
echoed, and all unread input present
in the input queue is discarded if
the input stream overflows.
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 alpha-
betics to upper case on output.
SunOS 5.10 Last change: 14 Feb 2005 5
User Commands stty(1)
onlcr (-onlcr) Map (do not map) NL to CR-NL on out-
put.
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(7I)).
nl0 nl1 Select style of delay for line-feeds
(see termio(7I)).
tab0 tab1 tab2 tab3 Select style of delay for horizontal
tabs (see termio(7I)).
bs0 bs1 Select style of delay for backspaces
(see termio(7I)).
ff0 ff1 Select style of delay for form-feeds
(see termio(7I)).
SunOS 5.10 Last change: 14 Feb 2005 6
User Commands stty(1)
vt0 vt1 Select style of delay for vertical
tabs (see termio(7I)).
Local Modes
isig(-isig) Enable (disable) the checking of
characters against the special con-
trol characters INTR, QUIT, SWTCH,
and SUSP. For information on SWTCH,
see NOTES.
icanon (-icanon) Enable (disable) canonical input
(ERASE and KILL processing). Does
not set MIN or TIME.
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. This mode erases the ERASEed
character on many CRT terminals;
however, it does not keep track of
column position and, as a result, it
might be confusing for escaped char-
acters, tabs, and backspaces.
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.
SunOS 5.10 Last change: 14 Feb 2005 7
User Commands stty(1)
noflsh (-noflsh) Disable (enable) flush after INTR,
QUIT, or SUSP.
stwrap (-stwrap) Disable (enable) truncation of lines
longer than 79 characters on a syn-
chronous line.
tostop (-tostop) Send (do not send) SIGTTOU when
background processes write to the
terminal.
echoctl (-echoctl) Echo (do not echo) control charac-
ters as ^char, delete as ^?.
echoprt (-echoprt) Echo (do not echo) erase character
as character is ``erased''.
echoke (-echoke) BS-SP-BS erase (do not BS-SP-BS
erase) entire line on line kill.
flusho (-flusho) Output is (is not) being flushed.
pendin (-pendin) Retype (do not retype) pending input
at next read or input character.
iexten (-iexten) Enable (disable) special control
characters not currently controlled
by icanon, isig, ixon, or ixoff:
VEOL, VSWTCH, VREPRINT, VDISCARD,
VDSUSP, VWERASE, and VLNEXT.
stflush (-stflush) Enable (disable) flush on a synchro-
nous line after every write(2).
SunOS 5.10 Last change: 14 Feb 2005 8
User Commands stty(1)
stappl (-stappl) Use application mode (use line mode)
on a synchronous line.
Hardware Flow Control Modes
rtsxoff (-rtsxoff) Enable (disable) RTS hardware flow
control on input.
ctsxon (-ctsxon) Enable (disable) CTS hardware flow
control on output.
dtrxoff (-dtrxoff) Enable (disable) DTR hardware flow
control on input.
cdxon (-cdxon) Enable (disable) CD 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 sig-
nal element timing (DCE source) lead, CCITT
V.24 circuit 114, EIA-232-D pin 15.
xcrset Get transmit clock from receiver signal ele-
ment timing (DCE source) lead, CCITT V.24
circuit 115, EIA-232-D pin 17.
rcibrg Get receive clock from internal baud rate
generator.
SunOS 5.10 Last change: 14 Feb 2005 9
User Commands stty(1)
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 ele-
ment timing (DCE source) lead, CCITT V.24
circuit 115, EIA-232-D pin 17.
tsetcoff Transmitter signal element timing clock not
provided.
tsetcrbrg Output receive baud rate generator on
transmitter signal element timing (DTE
source) lead, CCITT V.24 circuit 113, EIA-
232-D pin 24.
tsetctbrg Output transmit baud rate generator on
transmitter signal element timing (DTE
source) lead, CCITT V.24 circuit 113, EIA-
232-D pin 24.
tsetctset Output transmitter signal element timing
(DCE source) on transmitter signal element
timing (DTE source) lead, CCITT V.24 circuit
113, EIA-232-D pin 24.
tsetcrset Output receiver signal element timing (DCE
source) on transmitter signal element timing
(DTE source) lead, CCITT V.24 circuit 113,
EIA-232-D pin 24.
rsetcoff Receiver signal element timing clock not
provided.
rsetcrbrg Output receive baud rate generator on
receiver signal element timing (DTE source)
SunOS 5.10 Last change: 14 Feb 2005 10
User Commands stty(1)
lead, CCITT V.24 circuit 128, no EIA-232-D
pin.
rsetctbrg Output transmit baud rate generator on
receiver signal element timing (DTE source)
lead, CCITT V.24 circuit 128, no EIA-232-D
pin.
rsetctset Output transmitter signal element timing
(DCE source) on receiver signal element tim-
ing (DTE source) lead, CCITT V.24 circuit
128, no EIA-232-D pin.
rsetcrset Output receiver signal element timing (DCE
source) on receiver signal element timing
(DTE source) lead, CCITT V.24 circuit 128,
no EIA-232-D pin.
Control Assignments
control-character c Set control-character to c, where:
control-character
is ctab, discard, dsusp, eof,
eol, eol2, erase, intr, kill,
lnext, quit, reprint, start,
stop, susp, swtch, or werase
(ctab is used with -stappl, see
termio(7I)). For information on
swtch, see NOTES.
c
If c is a single character, the
control character is set to that
character.
In the POSIX locale, if c is
preceded by a caret (^) indicat-
ing an escape from the shell and
is one of those listed in the ^c
SunOS 5.10 Last change: 14 Feb 2005 11
User Commands stty(1)
column of the following table,
then its value used (in the
Value column) is the correspond-
ing control character (for exam-
ple, ``^d'' is a <CTRL-d>).
``^?'' is interpreted as <DEL>
and ``^-'' is interpreted as
undefined.
________________________________________________________________________
| ^c Value | ^c Value | ^c Value |
| a, A <SOH> | l, L <FF> | w, W <ETB> |
| b, B <STX> | m, M <CR> | x, X <CAN> |
| c, C <ETX> | n, N <SO> | y, Y <EM> |
| d, D <EOT> | o, O <SI> | z, Z <SUB> |
| e, E <ENQ> | p, P <DLE> | [ <ESC> |
| f, F <ACK> | q, Q <DC1> | \ <FS> |
| g, G <BEL> | r, R <DC2> | ] <GS> |
| h, H <BS> | s, S <DC3> | ^ <RS> |
| i, I <HT> | t, T <DC4> | _ <US> |
| j, J <LF> | u, U <NAK> | ? <DEL> |
| k, K <VT> | v, V <SYN> | |
|_______________________|_______________________|_______________________|
min number Set the value of min or time to
time number number. MIN and TIME are used in
Non-Canonical mode input processing
(-icanon).
line i Set line discipline to i ( 0< i
<127).
Combination Modes
saved settings Set the current terminal charac-
teristics to the saved settings pro-
duced by the -g option.
evenp or parity Enable parenb and cs7, or disable
parodd.
SunOS 5.10 Last change: 14 Feb 2005 12
User Commands stty(1)
oddp Enable parenb, cs7, and parodd.
spacep Enable parenb, cs7, and parext.
markp Enable parenb, cs7, parodd, and
parext.
-parity, or -evenp Disable parenb, and set cs8.
-oddp Disable parenb and parodd, and set
cs8.
-spacep Disable parenb and parext, and set
cs8.
-markp Disable parenb, parodd, and parext,
and set cs8.
raw (-raw or cooked) Enable (disable) raw input and out-
put. Raw mode is equivalent to set-
ting:
stty cs8 -icanon min 1 time 0 -isig -xcase \
-inpck -opost
/usr/bin/stty, /usr/xpg6/bin/stty
nl (-nl) Unset (set) icrnl, onlcr. In addi-
tion -nl unsets inlcr, igncr, ocrnl,
and onlret.
/usr/xpg4/bin/stty
nl (-nl) Set (unset) icrnl. In addition, -nl
unsets inlcr, igncr, ocrnl, and
SunOS 5.10 Last change: 14 Feb 2005 13
User Commands stty(1)
onlret; -nl sets onlcr, and nl
unsets onlcr.
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 ter-
minal type term, where term is one
of tty33, tty37, vt05, tn300, ti700,
or tek.
async Set normal asynchronous communica-
tions where clock settings are
xcibrg, rcibrg, tsetcoff and rsetc-
off.
Window Size
rows n Set window size to n rows.
columns n Set window size to n columns.
SunOS 5.10 Last change: 14 Feb 2005 14
User Commands stty(1)
cols n Set window size to n columns. cols is a
shorthand alias for columns.
ypixels n Set vertical window size to n pixels.
xpixels n Set horizontal window size to n pixels.
USAGE
The -g flag is designed to facilitate the saving and restor-
ing of terminal state from the shell level. For example, a
program can:
saveterm="$(stty -g)" # save terminal state
stty (new settings) # set new state
... # ...
stty $saveterm # restore terminal state
Since the -a format is so loosely specified, scripts that
save and restore terminal settings should use the -g option.
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment
variables that affect the execution of stty: LANG, LC_ALL,
LC_CTYPE, LC_MESSAGES, and NLSPATH.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
/usr/bin/stty
SunOS 5.10 Last change: 14 Feb 2005 15
User Commands stty(1)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
/usr/xpg4/bin/stty
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWxcu4 |
|_____________________________|_____________________________|
| Interface Stability | Standard |
|_____________________________|_____________________________|
/usr/xpg6/bin/stty
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWxcu6 |
|_____________________________|_____________________________|
| Interface Stability | Standard |
|_____________________________|_____________________________|
SEE ALSO
tabs(1), ioctl(2), write(2), getwidth(3C), attributes(5),
environ(5), standards(5), ldterm(7M), termio(7I),
termiox(7I)
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.
SunOS 5.10 Last change: 14 Feb 2005 16
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:25:30 GMT 2007
|
Your favourite pages:
No pages logged yet.
Trying to save cookie... Top 10 most popular pages:
CPAN man page (4196 hits)
(Suse Linux 10.1)
ssh man page (4111 hits)
(Suse Linux 10.1)
svn man page (2354 hits)
(FreeBSD 6.2)
startproc man page (1695 hits)
(Suse Linux 10.1)
adv_cap_autoneg man page (1445 hits)
(Solaris 10 11_06)
signal man page (1357 hits)
(Suse Linux 10.1)
sqlite3 man page (1329 hits)
(openSUSE 10.2)
netcat man page (1188 hits)
(Suse Linux 10.1)
pprosetup man page (1177 hits)
(Solaris 10 11_06)
lwptut man page (1105 hits)
(Suse Linux 10.1)
|
Man Pages 
