1STTY(1) User Commands STTY(1)
2
6 stty - change and print terminal line settings
7
9 stty [-F DEVICE | --file=DEVICE] [SETTING]...
10 stty [-F DEVICE | --file=DEVICE] [-a|--all]
11 stty [-F DEVICE | --file=DEVICE] [-g|--save]
12
14 Print or change terminal characteristics.
15 -a, --all
17 print all current settings in human-readable form
18 -g, --save
20 print all current settings in a stty-readable form
21 -F, --file=DEVICE
23 open and use the specified DEVICE instead of stdin
24 --help display this help and exit
26 --version
28 output version information and exit
29 Optional - before SETTING indicates negation. An * marks non-POSIX
31 settings. The underlying system defines which settings are available.
32 Special characters:
34 * dsusp CHAR
35 CHAR will send a terminal stop signal once input flushed
36 eof CHAR
38 CHAR will send an end of file (terminate the input)
39 eol CHAR
41 CHAR will end the line
42 * eol2 CHAR
44 alternate CHAR for ending the line
45 erase CHAR
47 CHAR will erase the last character typed
48 intr CHAR
50 CHAR will send an interrupt signal
51 kill CHAR
53 CHAR will erase the current line
54 * lnext CHAR
56 CHAR will enter the next character quoted
57 quit CHAR
59 CHAR will send a quit signal
60 * rprnt CHAR
62 CHAR will redraw the current line
63 start CHAR
65 CHAR will restart the output after stopping it
66 stop CHAR
68 CHAR will stop the output
69 susp CHAR
71 CHAR will send a terminal stop signal
72 * swtch CHAR
74 CHAR will switch to a different shell layer
75 * werase CHAR
77 CHAR will erase the last word typed
78 Special settings:
80 N set the input and output speeds to N bauds
81 * cols N
83 tell the kernel that the terminal has N columns
84 * columns N
86 same as cols N
87 ispeed N
89 set the input speed to N
90 * line N
92 use line discipline N
93 min N with -icanon, set N characters minimum for a completed read
95 ospeed N
97 set the output speed to N
98 * rows N
100 tell the kernel that the terminal has N rows
101 * size print the number of rows and columns according to the kernel
103 speed print the terminal speed
105 time N with -icanon, set read timeout of N tenths of a second
107 Control settings:
109 [-]clocal
110 disable modem control signals
111 [-]cread
113 allow input to be received
114 * [-]crtscts
116 enable RTS/CTS handshaking
117 * [-]cdtrdsr
119 enable DTR/DSR handshaking
120 csN set character size to N bits, N in [5..8]
122 [-]cstopb
124 use two stop bits per character (one with `-')
125 [-]hup send a hangup signal when the last process closes the tty
127 [-]hupcl
129 same as [-]hup
130 [-]parenb
132 generate parity bit in output and expect parity bit in input
133 [-]parodd
135 set odd parity (even with `-')
136 Input settings:
138 [-]brkint
139 breaks cause an interrupt signal
140 [-]icrnl
142 translate carriage return to newline
143 [-]ignbrk
145 ignore break characters
146 [-]igncr
148 ignore carriage return
149 [-]ignpar
151 ignore characters with parity errors
152 * [-]imaxbel
154 beep and do not flush a full input buffer on a character
155 [-]inlcr
157 translate newline to carriage return
158 [-]inpck
160 enable input parity checking
161 [-]istrip
163 clear high (8th) bit of input characters
164 * [-]iutf8
166 assume input characters are UTF-8 encoded
167 * [-]iuclc
169 translate uppercase characters to lowercase
170 * [-]ixany
172 let any character restart output, not only start character
173 [-]ixoff
175 enable sending of start/stop characters
176 [-]ixon
178 enable XON/XOFF flow control
179 [-]parmrk
181 mark parity errors (with a 255-0-character sequence)
182 [-]tandem
184 same as [-]ixoff
185 Output settings:
187 * bsN backspace delay style, N in [0..1]
188 * crN carriage return delay style, N in [0..3]
190 * ffN form feed delay style, N in [0..1]
192 * nlN newline delay style, N in [0..1]
194 * [-]ocrnl
196 translate carriage return to newline
197 * [-]ofdel
199 use delete characters for fill instead of null characters
200 * [-]ofill
202 use fill (padding) characters instead of timing for delays
203 * [-]olcuc
205 translate lowercase characters to uppercase
206 * [-]onlcr
208 translate newline to carriage return-newline
209 * [-]onlret
211 newline performs a carriage return
212 * [-]onocr
214 do not print carriage returns in the first column
215 [-]opost
217 postprocess output
218 * tabN horizontal tab delay style, N in [0..3]
220 * tabs same as tab0
222 * -tabs
224 same as tab3
225 * vtN vertical tab delay style, N in [0..1]
227 Local settings:
229 [-]crterase
230 echo erase characters as backspace-space-backspace
231 * crtkill
233 kill all line by obeying the echoprt and echoe settings
234 * -crtkill
236 kill all line by obeying the echoctl and echok settings
237 * [-]ctlecho
239 echo control characters in hat notation (`^c')
240 [-]echo
242 echo input characters
243 * [-]echoctl
245 same as [-]ctlecho
246 [-]echoe
248 same as [-]crterase
249 [-]echok
251 echo a newline after a kill character
252 * [-]echoke
254 same as [-]crtkill
255 [-]echonl
257 echo newline even if not echoing other characters
258 * [-]echoprt
260 echo erased characters backward, between `\' and '/'
261 [-]icanon
263 enable erase, kill, werase, and rprnt special characters
264 [-]iexten
266 enable non-POSIX special characters
267 [-]isig
269 enable interrupt, quit, and suspend special characters
270 [-]noflsh
272 disable flushing after interrupt and quit special characters
273 * [-]prterase
275 same as [-]echoprt
276 * [-]tostop
278 stop background jobs that try to write to the terminal
279 * [-]xcase
281 with icanon, escape with `\' for uppercase characters
282 Combination settings:
284 * [-]LCASE
285 same as [-]lcase
286 cbreak same as -icanon
288 -cbreak
290 same as icanon
291 cooked same as brkint ignpar istrip icrnl ixon opost isig icanon, eof
293 and eol characters to their default values
294 -cooked
296 same as raw
297 crt same as echoe echoctl echoke
299 dec same as echoe echoctl echoke -ixany intr ^c erase 0177 kill ^u
301 * [-]decctlq
303 same as [-]ixany
304 ek erase and kill characters to their default values
306 evenp same as parenb -parodd cs7
308 -evenp same as -parenb cs8
310 * [-]lcase
312 same as xcase iuclc olcuc
313 litout same as -parenb -istrip -opost cs8
315 -litout
317 same as parenb istrip opost cs7
318 nl same as -icrnl -onlcr
320 -nl same as icrnl -inlcr -igncr onlcr -ocrnl -onlret
322 oddp same as parenb parodd cs7
324 -oddp same as -parenb cs8
326 [-]parity
328 same as [-]evenp
329 pass8 same as -parenb -istrip cs8
331 -pass8 same as parenb istrip cs7
333 raw same as -ignbrk -brkint -ignpar -parmrk -inpck -istrip -inlcr
335 -igncr -icrnl -ixon -ixoff -iuclc -ixany -imaxbel -opost
336 -isig -icanon -xcase min 1 time 0
337 -raw same as cooked
339 sane same as cread -ignbrk brkint -inlcr -igncr icrnl -iutf8 -ixoff
341 -iuclc -ixany imaxbel opost -olcuc -ocrnl onlcr -onocr -onlret
342 -ofill -ofdel nl0 cr0 tab0 bs0 vt0 ff0 isig icanon iexten echo
343 echoe echok -echonl -noflsh -xcase -tostop -echoprt echoctl
344 echoke, all special characters to their default values
345 Handle the tty line connected to standard input. Without arguments,
347 prints baud rate, line discipline, and deviations from stty sane. In
348 settings, CHAR is taken literally, or coded as in ^c, 0x37, 0177 or
349 127; special values ^- or undef used to disable special characters.
350
352 Written by David MacKenzie.
353
355 Report stty bugs to bug-coreutils@gnu.org
356 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
357 General help using GNU software: <http://www.gnu.org/gethelp/>
358 Report stty translation bugs to <http://translationproject.org/team/>
359
361 Copyright © 2010 Free Software Foundation, Inc. License GPLv3+: GNU
362 GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
363 This is free software: you are free to change and redistribute it.
364 There is NO WARRANTY, to the extent permitted by law.
365
367 The full documentation for stty is maintained as a Texinfo manual. If
368 the info and stty programs are properly installed at your site, the
369 command
370 info coreutils 'stty invocation'
372 should give you access to the complete manual.
374GNU coreutils 8.4 June 2018 STTY(1)