stty

set terminal attributes

display or change terminal characteristics.

Many of these settings only apply to legacy terminals using low speed modems with dial-up connections and do not apply to ssh or telnet connections over a network.

Without arguments, displays baud rate, line discipline, and deviations from stty sane.
For example:

speed 9600 baud;
lflags: echoe echoke echoctl pendin
iflags: iutf8
oflags: -oxtabs
cflags: cs8 -parenb
Linux
> stty -a
speed 9600 baud; rows 33; columns 132; line = 0;
intr = ^C; quit = ^\; erase = ^?; kill = ^U; eof = ^D; eol = ; eol2 = ; swtch = ; start = ^Q; stop = ^S;
susp = ^Z; rprnt = ^R; werase = ^W; lnext = ^V; flush = ^O; min = 1; time = 0;
-parenb -parodd cs8 -hupcl -cstopb cread -clocal -crtscts -cdtrdsr
-ignbrk -brkint -ignpar -parmrk -inpck -istrip -inlcr -igncr icrnl ixon -ixoff -iuclc ixany imaxbel -iutf8
opost -olcuc -ocrnl onlcr -onocr -onlret -ofill -ofdel nl0 cr0 tab0 bs0 vt0 ff0
isig icanon iexten echo echoe -echok -echonl -noflsh -xcase -tostop -echoprt echoctl echoke

> stty --h
Usage: stty [-F device] [--file=device] [setting]...
  or:  stty [-F device] [--file=device] [-a|--all]
  or:  stty [-F device] [--file=device] [-g|--save]

  -a, --all          Display all current settings in human-readable form
  -g, --save         Display all current settings in a stty-readable form
  -F, --file=device  Open and use the specified DEVICE instead of stdin
      --help    Display this help and exit
      --version  Output version information and exit
- before SETTING indicates negation.

non-POSIX are in this font/color

The underlying system defines which settings are available.

Special characters:

   eof   send an end of file (terminate the input)
   eol   end the line
   eol2  alternate  for ending the line
   erase erase the last character typed
   intr  send an interrupt signal (see trap
   kill  erase the current line
   lnext  enter the next character quoted(literly)
   quit  send a quit signal
   rprnt  redraw the current line
   start restart the output after stopping it
   stop  stop the output
   susp  send a terminal stop signal
   dsusp  send a terminal stop signal once input flushed
   swtch  switch to a different shell layer
   werase erase the last word typed
Notice that there is no status key

Special settings:

N set the input and output speeds to N baud
ispeed N set the input speed to N
ospeed N set the output speed to N
speed display the terminal speed
cols N tell the kernel that the terminal has N columns
columns N same as cols N
rows N tell the kernel that the terminal has N rows
size display the number of rows and columns according to the kernel
line N use line discipline N
time N with -icanon, set read timeout of N tenths of a second
min N with -icanon, set N characters minimum for a completed read

Control settings:

   [-]clocal  disable modem control signals
   [-]cread   allow input to be received
   [-]crtscts    enable RTS/CTS handshaking (disables DTR/DSR)
   [-]cdtrdsr    enable DTR/DSR handshaking (disables RTS/CTS), no stty
                 readable form available, has to be supported by device
   csN           set character size to N bits, N in [5..8]
   [-]cstopb     use two stop bits per character (one with `-')
   [-]parenb     generate parity bit in output and expect parity bit in input
   [-]parodd     set odd parity (even with `-')

   [-]hup        send a hangup signal when the last process closes the tty
   [-]hupcl      same as [-]hup

Input settings:
   [-]brkint     breaks cause an interrupt signal
   [-]icrnl      translate carriage return to newline
   [-]ignbrk     ignore break characters
   [-]igncr      ignore carriage return
   [-]ignpar     ignore characters with parity errors
   [-]imaxbel    beep and do not flush a full input buffer on a character
   [-]inlcr      translate newline to carriage return
   [-]inpck      enable input parity checking
   [-]istrip     clear high (8th) bit of input characters
   [-]iutf8      assume input characters are UTF-8 encoded
   [-]iuclc      translate uppercase characters to lowercase
   [-]ixany      let any character restart output, not only start character
   [-]ixoff      enable sending of start/stop characters
   [-]ixon       enable XON/XOFF flow control
   [-]parmrk     mark parity errors (with a 255-0-character sequence)
   [-]tandem     same as [-]ixoff

Output settings:  (the delays  are for printing terminals without a buffer)
   bsN       backspace delay style, N in [0..1]
   crN       carriage return delay style, N in [0..3]
   ffN       form feed delay style, N in [0..1]
   nlN       newline delay style, N in [0..1]
   tabN      horizontal tab delay style, N in [0..3]
   tabs      same as tab0
   -tabs     same as tab3
   vtN       vertical tab delay style, N in [0..1]
   [-]ocrnl  translate carriage return to newline
   [-]ofdel  use delete characters for fill instead of null characters
   [-]ofill  use fill (padding) characters instead of timing for delays
   [-]olcuc  translate lowercase characters to uppercase
   [-]onlcr  translate newline to carriage return-newline
   [-]onlret newline performs a carriage return
   [-]onocr  do not display carriage returns in the first column
   [-]opost      postprocess output

Local settings:
[-]crterase echo erase characters as backspace-space-backspace
crtkill kill all line by obeying the echoprt and echoe settings
-crtkill kill echoctl and echok
[-]ctlecho echo control characters in hat notation (^c)
[-]echo echo input characters
[-]echoctl [-]ctlecho
[-]echoe [-]crterase
[-]echok echo a newline after a kill character
[-]echoke [-]crtkill
[-]echonl echo newline even if not echoing other characters
[-]echoprt echo erased characters backward, between `\' and '/'
[-]icanon enable erase, kill, werase, and rprnt special characters
[-]iexten enable non-POSIX special characters
[-]isig enable interrupt, quit, and suspend special characters
[-]noflsh disable flushing after interrupt and quit special characters
[-]prterase [-]echoprt
[-]tostop stop background jobs that try to write to the terminal
[-]xcase with icanon, escape with \' for uppercase characters

Combination settings:

[-]LCASE      [-]lcase
   cbreak    -icanon
  -cbreak     icanon
   crt        echoe echoctl echoke
   dec        echoe echoctl echoke -ixany intr ^c erase 0177
              kill ^u
[-]decctlq    [-]ixany
   ek       erase and kill characters to their default values
   evenp    parenb -parodd cs7
  -evenp    -parenb cs8
[-]lcase      xcase iuclc olcuc
   litout   -parenb -istrip -opost cs8
  -litout   parenb istrip opost cs7
   nl       -icrnl -onlcr
  -nl       icrnl -inlcr -igncr onlcr -ocrnl -onlret
   oddp     parenb parodd cs7
  -oddp     -parenb cs8
   [-]parity [-]evenp
   pass8     -parenb -istrip cs8
  -pass8     parenb istrip cs7
   cooked    brkint ignpar istrip icrnl ixon opost isig
             icanon, eof and eol characters to their default values
  -cooked    raw
   raw       -ignbrk -brkint -ignpar -parmrk -inpck -istrip
             -inlcr -igncr -icrnl  -ixon  -ixoff  -iuclc  -ixany
             -imaxbel -opost -isig -icanon -xcase min 1 time 0
  -raw       cooked

   sane      cread -ignbrk brkint -inlcr -igncr icrnl -iutf8
             -ixoff -iuclc -ixany imaxbel opost -olcuc -ocrnl onlcr
             -onocr -onlret -ofill -ofdel nl0 cr0 tab0 bs0 vt0 ff0
             isig icanon iexten echo echoe echok -echonl -noflsh
             -xcase -tostop -echoprt echoctl echoke, all special
             characters to their default values.

Handle the tty line connected to standard input.
In settings, CHAR is taken literally, or coded as in ^c, 0x37, 0177 or
127; special values ^- or undef used to disable special characters.


BSD solaris

stty -- set the options for a terminal device interface

stty [-a | -e | -g] [-f file] [operands ]

Sets or displays on terminal characteristics for the device that is its standard input.

Editor note: Many of these apply to terminals remotely connected serial communication lines and are not applicatable to console.
Most interesting operatnds which do apply to CONSOLE are:

isig, noflsh, size, rows, cols
isig
-isig
Enable (disable generating signals if input contains special control characters
INTR (^? , QUIT (^U , and SUSP (^C.
noflsh
-noflsh
Disable (enable flush of pending output after INTR, QUIT, or SUSP.
tostop
-tostop
(do not send SIGTTOU for background output, causes background jobs to stop if they attempt terminal output.
oxtabs
-oxtabs
(do not expand tabs to spaces on output.

If no options or operands are specified, it reports the settings of a subset of characteristics as well as additional ones if they differ from their default values.

speed 9600 baud;
lflags: echoe echoke echoctl pendin
oflags: -oxtabs
cflags: cs8 -parenb
-a Display all the current settings for the terminal to standard output as per IEEE Std 1003.2 (POSIX.2).

stty all|everything Reports all the terminal modes as with stty -a, except that the control characters are displayed in a columnar format.
 speed 9600 baud; 30 rows; 110 columns;
lflags: icanon isig iexten echo echoe -echok echoke -echonl echoctl
        -echoprt -altwerase -noflsh -tostop -flusho pendin -nokerninfo
        -extproc
iflags: -istrip icrnl -inlcr -igncr ixon -ixoff ixany imaxbel -iutf8
        -ignbrk brkint -inpck -ignpar -parmrk
oflags: opost onlcr -oxtabs -onocr -onlret
cflags: cread cs8 -parenb -parodd hupcl -clocal -cstopb -crtscts -dsrflow
        -dtrflow -mdmbuf
cchars: discard = ^O; dsusp = ^Y; eof = ^D; eol = ;
        eol2 = ; erase = ^?; intr = ^C; kill = ^U; lnext = ^V;
        min = 1; quit = ^\; redisplay = ^R; start = ^Q; status = ^T;
        stop = ^S; susp = ^Z; time = 0; werase = ^W; 
-e Display all the current settings for the terminal to standard output in traditional BSD all format.
speed 9600 baud; 30 rows; 110 columns;
lflags: icanon isig iexten echo echoe -echok echoke -echonl echoctl
        -echoprt -altwerase -noflsh -tostop -flusho pendin -nokerninfo
        -extproc
iflags: -istrip icrnl -inlcr -igncr ixon -ixoff ixany imaxbel -iutf8
        -ignbrk brkint -inpck -ignpar -parmrk
oflags: opost onlcr -oxtabs -onocr -onlret
cflags: cread cs8 -parenb -parodd hupcl -clocal -cstopb -crtscts -dsrflow
        -dtrflow -mdmbuf
discard dsusp   eof     eol     eol2    erase   intr    kill    lnext   
^O      ^Y      ^D        ^?      ^C      ^U      ^V      
min     quit    redisplay start   status  stop    susp    time    werase  
1       ^\      ^R      ^Q      ^T      ^S      ^Z      0       ^W     
-f Open and use the terminal named by file rather than using standard input. The file is opened using the O_NONBLOCK flag of open(, making it possible to set or display settings on a terminal that might otherwise block on the open.

-g Display all the current settings for the terminal to standard output in a form that may be used as an argument to a subsequent invocation of stty to restore the current terminal state as per IEEE Std 1003.2 (``POSIX.2''.

gfmt1:cflag=4b00:iflag=2b02:lflag=200005cb:oflag=3:discard=f:dsusp=19:eof=4:eol=ff:
eol2=ff:erase=7f:intr=3:kill=15:lnext=16:min=1:quit=1c:redisplay=12:start=11:status=14:stop=13:
susp=1a:time=0:werase=17:ispeed=9600:ospeed=9600i
Control Modes:
Affect hardware characteristics associated with the terminal, corresponds to the c_cflag in the termios structure.
nnnn Set terminal baud rate to nnnn. If zero, modem control is no longer asserted.
clocal
-clocal
a communications line without (with modem control.
cread
-cread
Enable (disable the receiver.
crtscts
-crtscts
Enable (disable RTS/CTS flow control. (CRTs are fast enough to not need flow control).
cs5 cs6 cs7 cs8 Select character size in bits (cs7 most common.
cstopb
-cstopb
Use two (one stop bits per character.
hupcl
-hupcl,
Stop asserting modem control (do not stop) asserting modem control on last close.
hup
-hup
speed nnnn sets both ispeed and ospeed to nnnn.(examples 1200, 2400,4800 and 9600
ispeed nnnn Set terminal input baud rate . If zero, the input baud rate is set to the value of the output baud rate.
ospeed nnnn Set terminal output baud rate. If zero, modem control is no longer asserted.
parenb
-parenb
Enable (disable) parity generation and detection.
parodd
-parodd
Select odd (even parity.
-evenp -oddp and -parity.
evenp Enable parenb and cs7; disable parodd.
-oddp Same as -evenp and -parity.
oddp Enable parenb, cs7, and parodd.
-parity Disable parenb; set cs8.
parity Same as evenp.
pass8 The converse of parity.
Input Modes: This corresponds to the c_iflag in the termios structure.
inpck
-inpck
Enable (disable input parity checking.
parmrk
-parmrk
Mark (do not mark characters with parity errors.
ignpar
-ignpar
Ignore (do not ignore characters with parity errors.
ignbrk
-ignbrk
Ignore (do not ignore break on input.
brkint
-brkint
Signal (do not signal INTR when system receives a break signal.
icrnl
-icrnl
Map (do not map CR to NL on input.
nl
-nl
Enable (disable icrnl. , -nl unsets inlcr and igncr.
inlcr
-inlcr
Map (do not map NL to CR on input.
igncr
-igncr
Ignore (do not ignore CR on input.
imaxbel
-imaxbel
If imaxbel is set and the input queue limit has been reached, subsequent input causes the system to send an ASCII BEL character to the output queue (the terminal beeps .
If imaxbel is unset and the input queue is full, the next input character causes the entire input and output queues to be discarded!
istrip
-istrip
Strip (do not strip input characters to seven bits.
iutf8
-iutf8
input characters are UTF-8 encoded.
ixoff
-ixoff
system sends (not send START/STOP characters (ASCII X-on/X-off when the input queue is nearly empty/full.
ixon
-ixon
Output from the system is stopped when the system receives STOP and started when the system receives START( -ixon disables this
ixany
-ixany
Allow any character to restart output.
Output Modes:
Corresponds to c_oflag of the termios structure.
( some mechanical terminals, without buffering cannot perform movements fast enough
bs0 bs1 style of delay for backspaces (e.g., set BSDLY to BS0.
cr0 cr1 cr2 cr3 style of delay for carriage returns (e.g., set CRDLY to CR0.
ff0 ff1 style of delay for form feeds (e.g., set FFDLY to FF0.
nl0 nl1 style of delay for newlines (e.g., set NLDLY to NL0.
tab0 tab1 tab2 tab3 style of delay for horizontal tabs (e.g., set TABDLY to TAB0.
tabs
-tabs
Same as tab0 (tab3.
vt0 vt1 style of delay for vertical tabs (e.g., set VTDLY to VT0.
ofill
-ofill
Use fill (x'00') characters (use timing for delays.
ofdel
-odell
Use DELs (NULs) as fill characters.
ocrnl
-ocrnl
Map (do not map CR to nl on output.
onlcr
-onlcr
Map (do not map NL to CR-NL output.
onlret
-onlret
On the terminal, NL performs (does not perform the CR function.
onocr
-onocr
Do not (do output CRs at column zero.
opost
-opost
Post-process output (do not post-process output; ignore all other output modes.
oxtabs
-oxtabs
Expand (do not expand tabs to spaces on output. Local Modes: Local mode flags (lflags affect various characteristics of terminal processing. interpretation of the 'l' in lflag is ``line discipline flag'', which corresponds to the c_lflag of the termios structure.
-echo
echo
do not echo back (do echo every character typed. Terminals in local mode have displayed the characters themselves..
echok
-echok
Echo (do not echo NL after KILL character.
echonl
-echonl
Echo (do not echo NL, even if echo is disabled. Some terminals position the "carriage" at position zero after a RETURN, but do not advance to the next line.
echoctl
-echoctl
If set, echo control characters as ^X. Otherwise, control characters echo as themselves.
ctlecho
-ctlecho
Same as echoctl.
echoe
-echoe
The ERASE character shall (shall not visually erase the last character
crtbs
-crtbs
Same as echoe.
crterase
-crterase
Same as echoe.
echoke
-echoke
The KILL character shall (shall not visually erase the current line
crtkill
-crtkill
Same as echoke.
echoprt
-echoprt
For displaying terminals. echo erased characters backwards within ``\'' and ``/''. Otherwise, disable this feature.
flusho
-flusho
Indicates output is (is not being discarded.
icanon
-icanon
Enable (disable canonical input (ERASE and KILL processing.
iexten
-iexten
Enable (disable any implementation-defined special control characters that are not currently controlled by icanon, isig, ixoff, or ixon.
isig
-isig
Enable (disable the checking of input for the special control characters INTR, QUIT, and SUSP.
noflsh
-noflsh
Disable (enable flush after INTR, QUIT, or SUSP.
tostop
-tostop
Send (do not send SIGTTOU for background output. This causes background jobs to stop if they attempt terminal output.
altwerase
-altwerase
Use (do not use an alternate word erase algorithm when processing WERASE characters. which considers sequences of alphanumeric/underscores as words. It also skips the first preceding character in its classification (as a convenience, since the one preceding character could have been erased with simply an ERASE character.
mdmbuf
-mdmbuf
set: flow control output is based on Carrier Detect.
reset: writes return an error if Carrier Detect is low (and Carrier is not being ignored with CLOCAL .
Loss of CarrierDetect usually disconnects the connection.
pendin
-pendin
Indicates input is (is not ) pending after a switch from non-canonical to canonical mode and will be re-input when a read becomes pending or more input arrives.
Control Characters:
control-character string Set control-character<.code> to string. If string is a single character, the control character is set to that character.
If string is the two character sequence ^- or undef the control character is disabled (i.e. set to {_POSIX_VDISABLE}.
Editor's note: Although these are traditionaly shown as uppercase characters and in fact stty -a displays them as uppercase, they are usually entered in lower case.
Example: >stty status ^t

 These effect terminal I/O

control- usually character set to Subscript eof ^d VEOF EndOfFile eol ?? VEOL EndOfLine eol2 ?? VEOL2 EOL2 erase ^? ^h VERASE aka backspace ERASE erase2 VERASE2 ERASE2 werase ^w VWERASE blank a window WERASE kill ^u VKILL input not read KILL discard ^o output that is already buffered stop ^s aka x-off VSTOP STOP (pause)terminal from sending start ^q aka x-on VSTART START terminal can (continue) dsusp ^y VDSUSP DSUSP lnext ^v VLNEXT LNEXT redisplay ^r VREPRINT REPRINT These generate signals status ^t VSTATUS STATUS (INFO) intr ^c VINTR INTRupt quit ^\ VQUIT QUIT susp ^z VSUSP SUSPend reports '[1]+ Stopped and the command and causes a job to be created

min n minimum number of bytes that should be received when the read() function returns successfully
time tenthSecs Tenths of seconds to timeout short term transmissinos.
MIN and TIME are used in Non-Canonical mode input processing
-icanon.
Combination Modes: saved settings Set the current terminal characteristics to the saved settings produced by -g .
columns n
cols n
The terminal size is recorded as having number columns.
crt
-crt
Set (disable all modes suitable for a CRT display device.
newcrt
-newcrt
Same as crt.
dec Set modes suitable for users of Digital Equipment Corporation systems (ERASE, KILL, and INTR are set to ^?, ^U, and ^C; ixany is disabled, and crt is enabled.
ek Reset ERASE, ERASE2, and KILL back to system defaults.
extproc
-extproc
terminal processing is being performed by either the terminal hardware or by the remote side connected to a pty.
kerninfo
-kerninfo
Enable (disable the system generated status line associated with processing a STATUS character (usually set to ^T. The status line consists of the system load average, the current command name, its process ID, the event the process is waiting on (or the status of the process, the user and system times, percent cpu, and current memory usage.
load: 3.64 cmd: bash 12892 waiting 0.00u 0.01s
waiting or running or uninterruptible
raw
-raw
no input or output processing is performed. If unset, change the modes of the terminal to some reasonable state that performs input and output processing. unsetting raw may not put back all the setting that were previously in effect. To set the terminal into a raw state and then restore it
                 save_state=$(stty -g
                 stty raw
                 ...
                 stty "$save_state"

rows number The terminal size is recorded as having number rows.
sane sets all modes to reasonable values
cooked Same as sane.
size window size is displayed rows columns.
tty Set the line discipline to the standard terminal line discipline TTYDISC.
new Same as tty.
old Same as tty.
brk value Same as the control character eol.
cbreak If set, enables brkint, ixon, imaxbel, opost, isig, iexten, and -icanon. If unset, same as sane.
decctlq
-decctlq
The converse of ixany.
flush value Same as the control character discard.
litout
-litout
The converse of opost.
prterase
-prterase
Same as echoprt.
rprnt value Same as the control character redisplay.
tabs
-tabs
The converse of oxtabs.
tandem
-tandem
Same as ixoff.

DIAGNOSTICS

exits 0 on success, and > 0 if an error occurs.

LEGACY DESCRIPTION

In legacy operation, the bs[01], cr[0-3], ff[01], nl[01], tab[0-3], and vt[01] control modes are not accepted,
nor are ocrnl -ocrnl, ofdel (-ofdel, ofill (-ofill, onlret (-onlret, and onocr
-onocr

.

SEE ALSO

termios(4, compat(5