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 Mandatory arguments to long options are mandatory for short options
17 too.
18 -a, --all
20 print all current settings in human-readable form
21 -g, --save
23 print all current settings in a stty-readable form
24 -F, --file=DEVICE
26 open and use the specified DEVICE instead of stdin
27 --help display this help and exit
29 --version
31 output version information and exit
32 Optional - before SETTING indicates negation. An * marks non-POSIX
34 settings. The underlying system defines which settings are available.
35 Special characters:
37 * discard CHAR
38 CHAR will toggle discarding of output
39 eof CHAR
41 CHAR will send an end of file (terminate the input)
42 eol CHAR
44 CHAR will end the line
45 * eol2 CHAR
47 alternate CHAR for ending the line
48 erase CHAR
50 CHAR will erase the last character typed
51 intr CHAR
53 CHAR will send an interrupt signal
54 kill CHAR
56 CHAR will erase the current line
57 * lnext CHAR
59 CHAR will enter the next character quoted
60 quit CHAR
62 CHAR will send a quit signal
63 * rprnt CHAR
65 CHAR will redraw the current line
66 start CHAR
68 CHAR will restart the output after stopping it
69 stop CHAR
71 CHAR will stop the output
72 susp CHAR
74 CHAR will send a terminal stop signal
75 * swtch CHAR
77 CHAR will switch to a different shell layer
78 * werase CHAR
80 CHAR will erase the last word typed
81 Special settings:
83 N set the input and output speeds to N bauds
84 * cols N
86 tell the kernel that the terminal has N columns
87 * columns N
89 same as cols N
90 * [-]drain
92 wait for transmission before applying settings (on by default)
93 ispeed N
95 set the input speed to N
96 * line N
98 use line discipline N
99 min N with -icanon, set N characters minimum for a completed read
101 ospeed N
103 set the output speed to N
104 * rows N
106 tell the kernel that the terminal has N rows
107 * size print the number of rows and columns according to the kernel
109 speed print the terminal speed
111 time N with -icanon, set read timeout of N tenths of a second
113 Control settings:
115 [-]clocal
116 disable modem control signals
117 [-]cread
119 allow input to be received
120 * [-]crtscts
122 enable RTS/CTS handshaking
123 csN set character size to N bits, N in [5..8]
125 [-]cstopb
127 use two stop bits per character (one with '-')
128 [-]hup send a hangup signal when the last process closes the tty
130 [-]hupcl
132 same as [-]hup
133 [-]parenb
135 generate parity bit in output and expect parity bit in input
136 [-]parodd
138 set odd parity (or even parity with '-')
139 * [-]cmspar
141 use "stick" (mark/space) parity
142 Input settings:
144 [-]brkint
145 breaks cause an interrupt signal
146 [-]icrnl
148 translate carriage return to newline
149 [-]ignbrk
151 ignore break characters
152 [-]igncr
154 ignore carriage return
155 [-]ignpar
157 ignore characters with parity errors
158 * [-]imaxbel
160 beep and do not flush a full input buffer on a character
161 [-]inlcr
163 translate newline to carriage return
164 [-]inpck
166 enable input parity checking
167 [-]istrip
169 clear high (8th) bit of input characters
170 * [-]iutf8
172 assume input characters are UTF-8 encoded
173 * [-]iuclc
175 translate uppercase characters to lowercase
176 * [-]ixany
178 let any character restart output, not only start character
179 [-]ixoff
181 enable sending of start/stop characters
182 [-]ixon
184 enable XON/XOFF flow control
185 [-]parmrk
187 mark parity errors (with a 255-0-character sequence)
188 [-]tandem
190 same as [-]ixoff
191 Output settings:
193 * bsN backspace delay style, N in [0..1]
194 * crN carriage return delay style, N in [0..3]
196 * ffN form feed delay style, N in [0..1]
198 * nlN newline delay style, N in [0..1]
200 * [-]ocrnl
202 translate carriage return to newline
203 * [-]ofdel
205 use delete characters for fill instead of NUL characters
206 * [-]ofill
208 use fill (padding) characters instead of timing for delays
209 * [-]olcuc
211 translate lowercase characters to uppercase
212 * [-]onlcr
214 translate newline to carriage return-newline
215 * [-]onlret
217 newline performs a carriage return
218 * [-]onocr
220 do not print carriage returns in the first column
221 [-]opost
223 postprocess output
224 * tabN horizontal tab delay style, N in [0..3]
226 * tabs same as tab0
228 * -tabs
230 same as tab3
231 * vtN vertical tab delay style, N in [0..1]
233 Local settings:
235 [-]crterase
236 echo erase characters as backspace-space-backspace
237 * crtkill
239 kill all line by obeying the echoprt and echoe settings
240 * -crtkill
242 kill all line by obeying the echoctl and echok settings
243 * [-]ctlecho
245 echo control characters in hat notation ('^c')
246 [-]echo
248 echo input characters
249 * [-]echoctl
251 same as [-]ctlecho
252 [-]echoe
254 same as [-]crterase
255 [-]echok
257 echo a newline after a kill character
258 * [-]echoke
260 same as [-]crtkill
261 [-]echonl
263 echo newline even if not echoing other characters
264 * [-]echoprt
266 echo erased characters backward, between '\' and '/'
267 * [-]extproc
269 enable "LINEMODE"; useful with high latency links
270 * [-]flusho
272 discard output
273 [-]icanon
275 enable special characters: erase, kill, werase, rprnt
276 [-]iexten
278 enable non-POSIX special characters
279 [-]isig
281 enable interrupt, quit, and suspend special characters
282 [-]noflsh
284 disable flushing after interrupt and quit special characters
285 * [-]prterase
287 same as [-]echoprt
288 * [-]tostop
290 stop background jobs that try to write to the terminal
291 * [-]xcase
293 with icanon, escape with '\' for uppercase characters
294 Combination settings:
296 * [-]LCASE
297 same as [-]lcase
298 cbreak same as -icanon
300 -cbreak
302 same as icanon
303 cooked same as brkint ignpar istrip icrnl ixon opost isig icanon, eof
305 and eol characters to their default values
306 -cooked
308 same as raw
309 crt same as echoe echoctl echoke
311 dec same as echoe echoctl echoke -ixany intr ^c erase 0177 kill ^u
313 * [-]decctlq
315 same as [-]ixany
316 ek erase and kill characters to their default values
318 evenp same as parenb -parodd cs7
320 -evenp same as -parenb cs8
322 * [-]lcase
324 same as xcase iuclc olcuc
325 litout same as -parenb -istrip -opost cs8
327 -litout
329 same as parenb istrip opost cs7
330 nl same as -icrnl -onlcr
332 -nl same as icrnl -inlcr -igncr onlcr -ocrnl -onlret
334 oddp same as parenb parodd cs7
336 -oddp same as -parenb cs8
338 [-]parity
340 same as [-]evenp
341 pass8 same as -parenb -istrip cs8
343 -pass8 same as parenb istrip cs7
345 raw same as -ignbrk -brkint -ignpar -parmrk -inpck -istrip -inlcr
347 -igncr -icrnl -ixon -ixoff -icanon -opost -isig -iuclc -ixany
348 -imaxbel -xcase min 1 time 0
349 -raw same as cooked
351 sane same as cread -ignbrk brkint -inlcr -igncr icrnl icanon iexten
353 echo echoe echok -echonl -noflsh -ixoff -iutf8 -iuclc -ixany
354 imaxbel -xcase -olcuc -ocrnl opost -ofill onlcr -onocr -onlret
355 nl0 cr0 tab0 bs0 vt0 ff0 isig -tostop -ofdel -echoprt echoctl
356 echoke -extproc -flusho, all special characters to their default
357 values
358 Handle the tty line connected to standard input. Without arguments,
360 prints baud rate, line discipline, and deviations from stty sane. In
361 settings, CHAR is taken literally, or coded as in ^c, 0x37, 0177 or
362 127; special values ^- or undef used to disable special characters.
363
365 Written by David MacKenzie.
366
368 GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
369 Report any translation bugs to <https://translationproject.org/team/>
370
372 Copyright © 2021 Free Software Foundation, Inc. License GPLv3+: GNU
373 GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
374 This is free software: you are free to change and redistribute it.
375 There is NO WARRANTY, to the extent permitted by law.
376
378 Full documentation <https://www.gnu.org/software/coreutils/stty>
379 or available locally via: info '(coreutils) stty invocation'
380GNU coreutils 9.0 March 2022 STTY(1)