1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.3.
2 .TH STTY "1" "January 2016" "GNU coreutils 8.25" "User Commands"
4 stty \- change and print terminal line settings
7 [\fI\,-F DEVICE | --file=DEVICE\/\fR] [\fI\,SETTING\/\fR]...
10 [\fI\,-F DEVICE | --file=DEVICE\/\fR] [\fI\,-a|--all\/\fR]
13 [\fI\,-F DEVICE | --file=DEVICE\/\fR] [\fI\,-g|--save\/\fR]
15 .\" Add any additional description here
17 Print or change terminal characteristics.
19 Mandatory arguments to long options are mandatory for short options too.
21 \fB\-a\fR, \fB\-\-all\fR
22 print all current settings in human\-readable form
24 \fB\-g\fR, \fB\-\-save\fR
25 print all current settings in a stty\-readable form
27 \fB\-F\fR, \fB\-\-file\fR=\fI\,DEVICE\/\fR
28 open and use the specified DEVICE instead of stdin
31 display this help and exit
34 output version information and exit
36 Optional \- before SETTING indicates negation. An * marks non\-POSIX
37 settings. The underlying system defines which settings are available.
38 .SS "Special characters:"
41 CHAR will toggle discarding of output
44 CHAR will send an end of file (terminate the input)
47 CHAR will end the line
50 alternate CHAR for ending the line
53 CHAR will erase the last character typed
56 CHAR will send an interrupt signal
59 CHAR will erase the current line
62 CHAR will enter the next character quoted
65 CHAR will send a quit signal
68 CHAR will redraw the current line
71 CHAR will restart the output after stopping it
74 CHAR will stop the output
77 CHAR will send a terminal stop signal
80 CHAR will switch to a different shell layer
83 CHAR will erase the last word typed
84 .SS "Special settings:"
87 set the input and output speeds to N bauds
90 tell the kernel that the terminal has N columns
96 wait for transmission before applying settings (on by default)
99 set the input speed to N
102 use line discipline N
105 with \fB\-icanon\fR, set N characters minimum for a completed read
108 set the output speed to N
111 tell the kernel that the terminal has N rows
114 print the number of rows and columns according to the kernel
117 print the terminal speed
120 with \fB\-icanon\fR, set read timeout of N tenths of a second
121 .SS "Control settings:"
124 disable modem control signals
127 allow input to be received
130 enable RTS/CTS handshaking
133 set character size to N bits, N in [5..8]
136 use two stop bits per character (one with '\-')
139 send a hangup signal when the last process closes the tty
145 generate parity bit in output and expect parity bit in input
148 set odd parity (or even parity with '\-')
151 use "stick" (mark/space) parity
152 .SS "Input settings:"
155 breaks cause an interrupt signal
158 translate carriage return to newline
161 ignore break characters
164 ignore carriage return
167 ignore characters with parity errors
170 beep and do not flush a full input buffer on a character
173 translate newline to carriage return
176 enable input parity checking
179 clear high (8th) bit of input characters
182 assume input characters are UTF\-8 encoded
185 translate uppercase characters to lowercase
188 let any character restart output, not only start character
191 enable sending of start/stop characters
194 enable XON/XOFF flow control
197 mark parity errors (with a 255\-0\-character sequence)
201 .SS "Output settings:"
204 backspace delay style, N in [0..1]
207 carriage return delay style, N in [0..3]
210 form feed delay style, N in [0..1]
213 newline delay style, N in [0..1]
216 translate carriage return to newline
219 use delete characters for fill instead of NUL characters
222 use fill (padding) characters instead of timing for delays
225 translate lowercase characters to uppercase
228 translate newline to carriage return\-newline
231 newline performs a carriage return
234 do not print carriage returns in the first column
240 horizontal tab delay style, N in [0..3]
249 vertical tab delay style, N in [0..1]
250 .SS "Local settings:"
253 echo erase characters as backspace\-space\-backspace
256 kill all line by obeying the echoprt and echoe settings
259 kill all line by obeying the echoctl and echok settings
262 echo control characters in hat notation ('^c')
265 echo input characters
274 echo a newline after a kill character
280 echo newline even if not echoing other characters
283 echo erased characters backward, between '\e' and '/'
286 enable "LINEMODE"; useful with high latency links
292 enable special characters: erase, kill, werase, rprnt
295 enable non\-POSIX special characters
298 enable interrupt, quit, and suspend special characters
301 disable flushing after interrupt and quit special characters
307 stop background jobs that try to write to the terminal
310 with icanon, escape with '\e' for uppercase characters
311 .SS "Combination settings:"
317 same as \fB\-icanon\fR
323 same as brkint ignpar istrip icrnl ixon opost isig
324 icanon, eof and eol characters to their default values
330 same as echoe echoctl echoke
333 same as echoe echoctl echoke \fB\-ixany\fR intr ^c erase 0177
340 erase and kill characters to their default values
343 same as parenb \fB\-parodd\fR cs7
346 same as \fB\-parenb\fR cs8
349 same as xcase iuclc olcuc
352 same as \fB\-parenb\fR \fB\-istrip\fR \fB\-opost\fR cs8
355 same as parenb istrip opost cs7
358 same as \fB\-icrnl\fR \fB\-onlcr\fR
361 same as icrnl \fB\-inlcr\fR \fB\-igncr\fR onlcr \fB\-ocrnl\fR \fB\-onlret\fR
364 same as parenb parodd cs7
367 same as \fB\-parenb\fR cs8
373 same as \fB\-parenb\fR \fB\-istrip\fR cs8
376 same as parenb istrip cs7
379 same as \fB\-ignbrk\fR \fB\-brkint\fR \fB\-ignpar\fR \fB\-parmrk\fR \fB\-inpck\fR \fB\-istrip\fR
380 \fB\-inlcr\fR \fB\-igncr\fR \fB\-icrnl\fR \fB\-ixon\fR \fB\-ixoff\fR \fB\-icanon\fR \fB\-opost\fR
381 \fB\-isig\fR \fB\-iuclc\fR \fB\-ixany\fR \fB\-imaxbel\fR \fB\-xcase\fR min 1 time 0
387 same as cread \fB\-ignbrk\fR brkint \fB\-inlcr\fR \fB\-igncr\fR icrnl
388 icanon iexten echo echoe echok \fB\-echonl\fR \fB\-noflsh\fR
389 \fB\-ixoff\fR \fB\-iutf8\fR \fB\-iuclc\fR \fB\-ixany\fR imaxbel \fB\-xcase\fR \fB\-olcuc\fR \fB\-ocrnl\fR
390 opost \fB\-ofill\fR onlcr \fB\-onocr\fR \fB\-onlret\fR nl0 cr0 tab0 bs0 vt0 ff0
391 isig \fB\-tostop\fR \fB\-ofdel\fR \fB\-echoprt\fR echoctl echoke \fB\-extproc\fR \fB\-flusho\fR,
392 all special characters to their default values
394 Handle the tty line connected to standard input. Without arguments,
395 prints baud rate, line discipline, and deviations from stty sane. In
396 settings, CHAR is taken literally, or coded as in ^c, 0x37, 0177 or
397 127; special values ^\- or undef used to disable special characters.
399 Written by David MacKenzie.
401 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
403 Report stty translation bugs to <http://translationproject.org/team/>
405 Copyright \(co 2016 Free Software Foundation, Inc.
406 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
408 This is free software: you are free to change and redistribute it.
409 There is NO WARRANTY, to the extent permitted by law.
411 Full documentation at: <http://www.gnu.org/software/coreutils/stty>
413 or available locally via: info \(aq(coreutils) stty invocation\(aq