stty consulting › our future

Information about the Linux / UNIX stty command.

The stty command.

The stty command sets terminal I/O options for the device that is the current standard input. If used without arguments, the stty command reports the current settings and options.

Note: : If a character is preceded by a caret(^), then the value of that option is the corresponding control character (for example, "^h" is Control-H; in this case, recall that Control-H is the same as the "back-space" key). The sequence "^" means that an option has a null value.


QUICK LINKS

  Syntax  ::  Examples  ::  Related Commands




EXAMPLES

No Arguments:

stty - typing stty alone on a dialup connection would list the information about the connection. Below is an example of what may be displayed:

speed 38400 baud; -parity

rows = 49; columns = 132; ypixels = 0; xpixels = 0;

erase = ^h; swtch = ;

brkint -inpck -istrip icrnl -ixany imaxbel onlcr tab3

echo echoe echok echoctl echoke iexten


Setting the Erase Key:

stty erase ^h - sets the erase key to backspace.



SYNTAX

stty [-a] [-g] [modes]


Standard Arguments

-a             Write 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.



Modes - The following mode operands are supported:

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.
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 character.
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.
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.
loblk (-loblk) Block (do not block) output from a non-current layer.




defeucw Set the widths of multibyte Extended Unix Code (EUC) characters in struct eucioc to default values for the current locale specified by LC_CTYPE; width is expressed in terms of bytes per character, and screen or display columns per character.
110 300 600 1200 1800 2400 4800 9600 19200 38400 357600 76800 115200 153600 230400 307200 460800 Set terminal baud rate to the number given, if possible. (All speeds are not supported by all hardware interfaces.)
ispeed 0 110 300 600 1200 1800 2400 4800 9600 19200 38400 57600 76800 115200 153600 230400 307200 460800 Set terminal input baud rate to the number given, if possible. (Not all hardware supports split baud rates.) If the input baud rate is set to 0, the input baud rate will be 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 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 will be hung up immediately.


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.
inpck (-inpck) Enable (disable) input parity checking.
istrip (-istrip) Strip (do not strip) input characters to seven bits.
inlcr (-inlcr) Map (do not map) NL to CR on input.
igncr (-igncr) Ignore (do not ignore) CR on input.
icrnl (-icrnl) Map (do not map) CR to NL on input.
iuclc (-iuclc) Map (do not map) upper-case alphabetics to lower case on input.
ixon (-ixon) Enable (disable) START/STOP output control. Out put is stopped by sending 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.




opost (-opost) Post-process output (do not post-process output; ignore all other output modes).
olcuc (-olcuc) Map (do not map) lower-case alphabetics to upper case on output.
onlcr (-onlcr) Map (do not map) NL to CR-NL on output.
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.
nl0 nl1 Select style of delay for line-feeds.
tab0 tab1 tab2 tab3 Select style of delay for horizontal tabs.
bs0 bs1 Select style of delay for backspaces.
ff0 ff1 Select style of delay for form-feeds.
vt0 vt1 Select style of delay for vertical tabs.
isig(-isig) Enable (disable) the checking of characters against the special control characters INTR, QUIT, SWTCH, and SUSP.




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. Note: This mode will erase the ERASEed character on many CRT terminals; however, it does not keep track of column position and, as a result, it may be confusing for escaped characters, 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.
noflsh (-noflsh) Disable (enable) flush after INTR, QUIT, or SUSP.
stwrap (-stwrap) Disable (enable) truncation of lines longer than 79 characters on a synchronous line.
tostop (-tostop) Send (do not send) SIGTTOU when background processes write to the terminal.
echoctl (-echoctl) Echo (do not echo) control characters 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: VEOLZ, VSWTCH, VREPRINT, VDISCARD, VDSUSP, VWERASE, and VLNEXT.
stflush (-stflush) Enable (disable) flush on a synchronous line after every write.
stappl (-stappl) Use application mode (use line mode) on a synchro nous line.


rtsxoff (-rtsxoff) Enable (disable) RTS hardware flow control on input.
ctsxon (-ctsxon) Enable (disable) CTS hardware flow control on out put.
dtrxoff (-dtrxoff) Enable (disable) DTR hardware flow control on input.
cdxon (-cdxon) Enable (disable) CD hardware flow control on out put.
isxoff (-isxoff) Enable (disable) isochronous hardware flow control on input.
xcibrg Get transmit clock from internal baud rate generator.
xctset Get the transmit clock from transmitter signal element timing (DCE source) lead, CCITT V.24 cir cuit 114, EIA-232-D pin 15.
xcrset Get transmit clock from receiver signal element timing (DCE source) lead, CCITT V.24 circuit 115, EIA-232-D pin 17.
rcibrg Get receive clock from internal baud rate generator.
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 element timing (DCE source) lead, CCITT V.24 circuit 115, EIA-232-D pin 17.
tsetcoff Transmitter signal element timing clock not pro vided.
tsetcrbrg Output receive 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) 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 timing (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.