~ubuntu-branches/ubuntu/utopic/coreutils/utopic-proposed

« back to all changes in this revision

Viewing changes to man/stty.1

  • Committer: Colin Watson
  • Date: 2013-10-30 15:48:33 UTC
  • mfrom: (8.3.5 sid)
  • Revision ID: cjwatson@canonical.com-20131030154833-xdt6e1yfffqom1c4
merge from Debian 8.21-1

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
2
 
.TH STTY "1" "October 2012" "GNU coreutils 8.20" "User Commands"
3
 
.SH NAME
4
 
stty \- change and print terminal line settings
5
 
.SH SYNOPSIS
6
 
.B stty
7
 
[\fI-F DEVICE | --file=DEVICE\fR] [\fISETTING\fR]...
8
 
.br
9
 
.B stty
10
 
[\fI-F DEVICE | --file=DEVICE\fR] [\fI-a|--all\fR]
11
 
.br
12
 
.B stty
13
 
[\fI-F DEVICE | --file=DEVICE\fR] [\fI-g|--save\fR]
14
 
.SH DESCRIPTION
15
 
.\" Add any additional description here
16
 
.PP
17
 
Print or change terminal characteristics.
18
 
.TP
19
 
\fB\-a\fR, \fB\-\-all\fR
20
 
print all current settings in human\-readable form
21
 
.TP
22
 
\fB\-g\fR, \fB\-\-save\fR
23
 
print all current settings in a stty\-readable form
24
 
.TP
25
 
\fB\-F\fR, \fB\-\-file\fR=\fIDEVICE\fR
26
 
open and use the specified DEVICE instead of stdin
27
 
.TP
28
 
\fB\-\-help\fR
29
 
display this help and exit
30
 
.TP
31
 
\fB\-\-version\fR
32
 
output version information and exit
33
 
.PP
34
 
Optional \- before SETTING indicates negation.  An * marks non\-POSIX
35
 
settings.  The underlying system defines which settings are available.
36
 
.SS "Special characters:"
37
 
.TP
38
 
* dsusp CHAR
39
 
CHAR will send a terminal stop signal once input flushed
40
 
.TP
41
 
eof CHAR
42
 
CHAR will send an end of file (terminate the input)
43
 
.TP
44
 
eol CHAR
45
 
CHAR will end the line
46
 
.TP
47
 
* eol2 CHAR
48
 
alternate CHAR for ending the line
49
 
.TP
50
 
erase CHAR
51
 
CHAR will erase the last character typed
52
 
.TP
53
 
intr CHAR
54
 
CHAR will send an interrupt signal
55
 
.TP
56
 
kill CHAR
57
 
CHAR will erase the current line
58
 
.TP
59
 
* lnext CHAR
60
 
CHAR will enter the next character quoted
61
 
.TP
62
 
quit CHAR
63
 
CHAR will send a quit signal
64
 
.TP
65
 
* rprnt CHAR
66
 
CHAR will redraw the current line
67
 
.TP
68
 
start CHAR
69
 
CHAR will restart the output after stopping it
70
 
.TP
71
 
stop CHAR
72
 
CHAR will stop the output
73
 
.TP
74
 
susp CHAR
75
 
CHAR will send a terminal stop signal
76
 
.TP
77
 
* swtch CHAR
78
 
CHAR will switch to a different shell layer
79
 
.TP
80
 
* werase CHAR
81
 
CHAR will erase the last word typed
82
 
.SS "Special settings:"
83
 
.TP
84
 
N
85
 
set the input and output speeds to N bauds
86
 
.TP
87
 
* cols N
88
 
tell the kernel that the terminal has N columns
89
 
.TP
90
 
* columns N
91
 
same as cols N
92
 
.TP
93
 
ispeed N
94
 
set the input speed to N
95
 
.TP
96
 
* line N
97
 
use line discipline N
98
 
.TP
99
 
min N
100
 
with \fB\-icanon\fR, set N characters minimum for a completed read
101
 
.TP
102
 
ospeed N
103
 
set the output speed to N
104
 
.TP
105
 
* rows N
106
 
tell the kernel that the terminal has N rows
107
 
.TP
108
 
* size
109
 
print the number of rows and columns according to the kernel
110
 
.TP
111
 
speed
112
 
print the terminal speed
113
 
.TP
114
 
time N
115
 
with \fB\-icanon\fR, set read timeout of N tenths of a second
116
 
.SS "Control settings:"
117
 
.TP
118
 
[\-]clocal
119
 
disable modem control signals
120
 
.TP
121
 
[\-]cread
122
 
allow input to be received
123
 
.TP
124
 
* [\-]crtscts
125
 
enable RTS/CTS handshaking
126
 
.TP
127
 
csN
128
 
set character size to N bits, N in [5..8]
129
 
.TP
130
 
[\-]cstopb
131
 
use two stop bits per character (one with '\-')
132
 
.TP
133
 
[\-]hup
134
 
send a hangup signal when the last process closes the tty
135
 
.TP
136
 
[\-]hupcl
137
 
same as [\-]hup
138
 
.TP
139
 
[\-]parenb
140
 
generate parity bit in output and expect parity bit in input
141
 
.TP
142
 
[\-]parodd
143
 
set odd parity (or even parity with '\-')
144
 
.SS "Input settings:"
145
 
.TP
146
 
[\-]brkint
147
 
breaks cause an interrupt signal
148
 
.TP
149
 
[\-]icrnl
150
 
translate carriage return to newline
151
 
.TP
152
 
[\-]ignbrk
153
 
ignore break characters
154
 
.TP
155
 
[\-]igncr
156
 
ignore carriage return
157
 
.TP
158
 
[\-]ignpar
159
 
ignore characters with parity errors
160
 
.TP
161
 
* [\-]imaxbel
162
 
beep and do not flush a full input buffer on a character
163
 
.TP
164
 
[\-]inlcr
165
 
translate newline to carriage return
166
 
.TP
167
 
[\-]inpck
168
 
enable input parity checking
169
 
.TP
170
 
[\-]istrip
171
 
clear high (8th) bit of input characters
172
 
.TP
173
 
* [\-]iutf8
174
 
assume input characters are UTF\-8 encoded
175
 
.TP
176
 
* [\-]iuclc
177
 
translate uppercase characters to lowercase
178
 
.TP
179
 
* [\-]ixany
180
 
let any character restart output, not only start character
181
 
.TP
182
 
[\-]ixoff
183
 
enable sending of start/stop characters
184
 
.TP
185
 
[\-]ixon
186
 
enable XON/XOFF flow control
187
 
.TP
188
 
[\-]parmrk
189
 
mark parity errors (with a 255\-0\-character sequence)
190
 
.TP
191
 
[\-]tandem
192
 
same as [\-]ixoff
193
 
.SS "Output settings:"
194
 
.TP
195
 
* bsN
196
 
backspace delay style, N in [0..1]
197
 
.TP
198
 
* crN
199
 
carriage return delay style, N in [0..3]
200
 
.TP
201
 
* ffN
202
 
form feed delay style, N in [0..1]
203
 
.TP
204
 
* nlN
205
 
newline delay style, N in [0..1]
206
 
.TP
207
 
* [\-]ocrnl
208
 
translate carriage return to newline
209
 
.TP
210
 
* [\-]ofdel
211
 
use delete characters for fill instead of null characters
212
 
.TP
213
 
* [\-]ofill
214
 
use fill (padding) characters instead of timing for delays
215
 
.TP
216
 
* [\-]olcuc
217
 
translate lowercase characters to uppercase
218
 
.TP
219
 
* [\-]onlcr
220
 
translate newline to carriage return\-newline
221
 
.TP
222
 
* [\-]onlret
223
 
newline performs a carriage return
224
 
.TP
225
 
* [\-]onocr
226
 
do not print carriage returns in the first column
227
 
.TP
228
 
[\-]opost
229
 
postprocess output
230
 
.TP
231
 
* tabN
232
 
horizontal tab delay style, N in [0..3]
233
 
.TP
234
 
* tabs
235
 
same as tab0
236
 
.TP
237
 
* \fB\-tabs\fR
238
 
same as tab3
239
 
.TP
240
 
* vtN
241
 
vertical tab delay style, N in [0..1]
242
 
.SS "Local settings:"
243
 
.TP
244
 
[\-]crterase
245
 
echo erase characters as backspace\-space\-backspace
246
 
.TP
247
 
* crtkill
248
 
kill all line by obeying the echoprt and echoe settings
249
 
.TP
250
 
* \fB\-crtkill\fR
251
 
kill all line by obeying the echoctl and echok settings
252
 
.TP
253
 
* [\-]ctlecho
254
 
echo control characters in hat notation ('^c')
255
 
.TP
256
 
[\-]echo
257
 
echo input characters
258
 
.TP
259
 
* [\-]echoctl
260
 
same as [\-]ctlecho
261
 
.TP
262
 
[\-]echoe
263
 
same as [\-]crterase
264
 
.TP
265
 
[\-]echok
266
 
echo a newline after a kill character
267
 
.TP
268
 
* [\-]echoke
269
 
same as [\-]crtkill
270
 
.TP
271
 
[\-]echonl
272
 
echo newline even if not echoing other characters
273
 
.TP
274
 
* [\-]echoprt
275
 
echo erased characters backward, between '\e' and '/'
276
 
.TP
277
 
[\-]icanon
278
 
enable erase, kill, werase, and rprnt special characters
279
 
.TP
280
 
[\-]iexten
281
 
enable non\-POSIX special characters
282
 
.TP
283
 
[\-]isig
284
 
enable interrupt, quit, and suspend special characters
285
 
.TP
286
 
[\-]noflsh
287
 
disable flushing after interrupt and quit special characters
288
 
.TP
289
 
* [\-]prterase
290
 
same as [\-]echoprt
291
 
.TP
292
 
* [\-]tostop
293
 
stop background jobs that try to write to the terminal
294
 
.TP
295
 
* [\-]xcase
296
 
with icanon, escape with '\e' for uppercase characters
297
 
.SS "Combination settings:"
298
 
.TP
299
 
* [\-]LCASE
300
 
same as [\-]lcase
301
 
.TP
302
 
cbreak
303
 
same as \fB\-icanon\fR
304
 
.TP
305
 
\fB\-cbreak\fR
306
 
same as icanon
307
 
.TP
308
 
cooked
309
 
same as brkint ignpar istrip icrnl ixon opost isig
310
 
icanon, eof and eol characters to their default values
311
 
.TP
312
 
\fB\-cooked\fR
313
 
same as raw
314
 
.TP
315
 
crt
316
 
same as echoe echoctl echoke
317
 
.TP
318
 
dec
319
 
same as echoe echoctl echoke \fB\-ixany\fR intr ^c erase 0177
320
 
kill ^u
321
 
.TP
322
 
* [\-]decctlq
323
 
same as [\-]ixany
324
 
.TP
325
 
ek
326
 
erase and kill characters to their default values
327
 
.TP
328
 
evenp
329
 
same as parenb \fB\-parodd\fR cs7
330
 
.TP
331
 
\fB\-evenp\fR
332
 
same as \fB\-parenb\fR cs8
333
 
.TP
334
 
* [\-]lcase
335
 
same as xcase iuclc olcuc
336
 
.TP
337
 
litout
338
 
same as \fB\-parenb\fR \fB\-istrip\fR \fB\-opost\fR cs8
339
 
.TP
340
 
\fB\-litout\fR
341
 
same as parenb istrip opost cs7
342
 
.TP
343
 
nl
344
 
same as \fB\-icrnl\fR \fB\-onlcr\fR
345
 
.TP
346
 
\fB\-nl\fR
347
 
same as icrnl \fB\-inlcr\fR \fB\-igncr\fR onlcr \fB\-ocrnl\fR \fB\-onlret\fR
348
 
.TP
349
 
oddp
350
 
same as parenb parodd cs7
351
 
.TP
352
 
\fB\-oddp\fR
353
 
same as \fB\-parenb\fR cs8
354
 
.TP
355
 
[\-]parity
356
 
same as [\-]evenp
357
 
.TP
358
 
pass8
359
 
same as \fB\-parenb\fR \fB\-istrip\fR cs8
360
 
.TP
361
 
\fB\-pass8\fR
362
 
same as parenb istrip cs7
363
 
.TP
364
 
raw
365
 
same as \fB\-ignbrk\fR \fB\-brkint\fR \fB\-ignpar\fR \fB\-parmrk\fR \fB\-inpck\fR \fB\-istrip\fR
366
 
\fB\-inlcr\fR \fB\-igncr\fR \fB\-icrnl\fR  \fB\-ixon\fR  \fB\-ixoff\fR  \fB\-iuclc\fR  \fB\-ixany\fR
367
 
\fB\-imaxbel\fR \fB\-opost\fR \fB\-isig\fR \fB\-icanon\fR \fB\-xcase\fR min 1 time 0
368
 
.TP
369
 
\fB\-raw\fR
370
 
same as cooked
371
 
.TP
372
 
sane
373
 
same as cread \fB\-ignbrk\fR brkint \fB\-inlcr\fR \fB\-igncr\fR icrnl \fB\-iutf8\fR
374
 
\fB\-ixoff\fR \fB\-iuclc\fR \fB\-ixany\fR imaxbel opost \fB\-olcuc\fR \fB\-ocrnl\fR onlcr
375
 
\fB\-onocr\fR \fB\-onlret\fR \fB\-ofill\fR \fB\-ofdel\fR nl0 cr0 tab0 bs0 vt0 ff0
376
 
isig icanon iexten echo echoe echok \fB\-echonl\fR \fB\-noflsh\fR
377
 
\fB\-xcase\fR \fB\-tostop\fR \fB\-echoprt\fR echoctl echoke, all special
378
 
characters to their default values
379
 
.PP
380
 
Handle the tty line connected to standard input.  Without arguments,
381
 
prints baud rate, line discipline, and deviations from stty sane.  In
382
 
settings, CHAR is taken literally, or coded as in ^c, 0x37, 0177 or
383
 
127; special values ^\- or undef used to disable special characters.
384
 
.SH AUTHOR
385
 
Written by David MacKenzie.
386
 
.SH "REPORTING BUGS"
387
 
Report stty bugs to bug\-coreutils@gnu.org
388
 
.br
389
 
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
390
 
.br
391
 
General help using GNU software: <http://www.gnu.org/gethelp/>
392
 
.br
393
 
Report stty translation bugs to <http://translationproject.org/team/>
394
 
.SH COPYRIGHT
395
 
Copyright \(co 2012 Free Software Foundation, Inc.
396
 
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
397
 
.br
398
 
This is free software: you are free to change and redistribute it.
399
 
There is NO WARRANTY, to the extent permitted by law.
400
 
.SH "SEE ALSO"
401
 
The full documentation for
402
 
.B stty
403
 
is maintained as a Texinfo manual.  If the
404
 
.B info
405
 
and
406
 
.B stty
407
 
programs are properly installed at your site, the command
408
 
.IP
409
 
.B info coreutils \(aqstty invocation\(aq
410
 
.PP
411
 
should give you access to the complete manual.