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 csN set character size to N bits, N in [5..8]
119 [-]cstopb
121 use two stop bits per character (one with `-')
122 [-]hup send a hangup signal when the last process closes the tty
124 [-]hupcl
126 same as [-]hup
127 [-]parenb
129 generate parity bit in output and expect parity bit in input
130 [-]parodd
132 set odd parity (even with `-')
133 Input settings:
135 [-]brkint
136 breaks cause an interrupt signal
137 [-]icrnl
139 translate carriage return to newline
140 [-]ignbrk
142 ignore break characters
143 [-]igncr
145 ignore carriage return
146 [-]ignpar
148 ignore characters with parity errors
149 * [-]imaxbel
151 beep and do not flush a full input buffer on a character
152 [-]inlcr
154 translate newline to carriage return
155 [-]inpck
157 enable input parity checking
158 [-]istrip
160 clear high (8th) bit of input characters
161 * [-]iutf8
163 assume input characters are UTF-8 encoded
164 * [-]iuclc
166 translate uppercase characters to lowercase
167 * [-]ixany
169 let any character restart output, not only start character
170 [-]ixoff
172 enable sending of start/stop characters
173 [-]ixon
175 enable XON/XOFF flow control
176 [-]parmrk
178 mark parity errors (with a 255-0-character sequence)
179 [-]tandem
181 same as [-]ixoff
182 Output settings:
184 * bsN backspace delay style, N in [0..1]
185 * crN carriage return delay style, N in [0..3]
187 * ffN form feed delay style, N in [0..1]
189 * nlN newline delay style, N in [0..1]
191 * [-]ocrnl
193 translate carriage return to newline
194 * [-]ofdel
196 use delete characters for fill instead of null characters
197 * [-]ofill
199 use fill (padding) characters instead of timing for delays
200 * [-]olcuc
202 translate lowercase characters to uppercase
203 * [-]onlcr
205 translate newline to carriage return-newline
206 * [-]onlret
208 newline performs a carriage return
209 * [-]onocr
211 do not print carriage returns in the first column
212 [-]opost
214 postprocess output
215 * tabN horizontal tab delay style, N in [0..3]
217 * tabs same as tab0
219 * -tabs
221 same as tab3
222 * vtN vertical tab delay style, N in [0..1]
224 Local settings:
226 [-]crterase
227 echo erase characters as backspace-space-backspace
228 * crtkill
230 kill all line by obeying the echoprt and echoe settings
231 * -crtkill
233 kill all line by obeying the echoctl and echok settings
234 * [-]ctlecho
236 echo control characters in hat notation (`^c')
237 [-]echo
239 echo input characters
240 * [-]echoctl
242 same as [-]ctlecho
243 [-]echoe
245 same as [-]crterase
246 [-]echok
248 echo a newline after a kill character
249 * [-]echoke
251 same as [-]crtkill
252 [-]echonl
254 echo newline even if not echoing other characters
255 * [-]echoprt
257 echo erased characters backward, between `\' and '/'
258 [-]icanon
260 enable erase, kill, werase, and rprnt special characters
261 [-]iexten
263 enable non-POSIX special characters
264 [-]isig
266 enable interrupt, quit, and suspend special characters
267 [-]noflsh
269 disable flushing after interrupt and quit special characters
270 * [-]prterase
272 same as [-]echoprt
273 * [-]tostop
275 stop background jobs that try to write to the terminal
276 * [-]xcase
278 with icanon, escape with `\' for uppercase characters
279 Combination settings:
281 * [-]LCASE
282 same as [-]lcase
283 cbreak same as -icanon
285 -cbreak
287 same as icanon
288 cooked same as brkint ignpar istrip icrnl ixon opost isig icanon, eof
290 and eol characters to their default values
291 -cooked
293 same as raw
294 crt same as echoe echoctl echoke
296 dec same as echoe echoctl echoke -ixany intr ^c erase 0177 kill ^u
298 * [-]decctlq
300 same as [-]ixany
301 ek erase and kill characters to their default values
303 evenp same as parenb -parodd cs7
305 -evenp same as -parenb cs8
307 * [-]lcase
309 same as xcase iuclc olcuc
310 litout same as -parenb -istrip -opost cs8
312 -litout
314 same as parenb istrip opost cs7
315 nl same as -icrnl -onlcr
317 -nl same as icrnl -inlcr -igncr onlcr -ocrnl -onlret
319 oddp same as parenb parodd cs7
321 -oddp same as -parenb cs8
323 [-]parity
325 same as [-]evenp
326 pass8 same as -parenb -istrip cs8
328 -pass8 same as parenb istrip cs7
330 raw same as -ignbrk -brkint -ignpar -parmrk -inpck -istrip -inlcr
332 -igncr -icrnl -ixon -ixoff -iuclc -ixany -imaxbel -opost
333 -isig -icanon -xcase min 1 time 0
334 -raw same as cooked
336 sane same as cread -ignbrk brkint -inlcr -igncr icrnl -iutf8 -ixoff
338 -iuclc -ixany imaxbel opost -olcuc -ocrnl onlcr -onocr -onlret
339 -ofill -ofdel nl0 cr0 tab0 bs0 vt0 ff0 isig icanon iexten echo
340 echoe echok -echonl -noflsh -xcase -tostop -echoprt echoctl
341 echoke, all special characters to their default values.
342 Handle the tty line connected to standard input. Without arguments,
344 prints baud rate, line discipline, and deviations from stty sane. In
345 settings, CHAR is taken literally, or coded as in ^c, 0x37, 0177 or
346 127; special values ^- or undef used to disable special characters.
347
349 Written by David MacKenzie.
350
352 Report bugs to <bug-coreutils@gnu.org>.
353
355 Copyright © 2007 Free Software Foundation, Inc.
356 This is free software. You may redistribute copies of it under the
357 terms of the GNU General Public License
358 <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the
359 extent permitted by law.
360
362 The full documentation for stty is maintained as a Texinfo manual. If
363 the info and stty programs are properly installed at your site, the
364 command
365 info stty
367 should give you access to the complete manual.
369GNU coreutils 6.9 March 2008 STTY(1)