2 .\" Copyright (c) 1990, 1993, 1994
3 .\" The Regents of the University of California. All rights reserved.
5 .\" This code is derived from software contributed to Berkeley by
6 .\" the Institute of Electrical and Electronics Engineers, Inc.
8 .\" Redistribution and use in source and binary forms, with or without
9 .\" modification, are permitted provided that the following conditions
11 .\" 1. Redistributions of source code must retain the above copyright
12 .\" notice, this list of conditions and the following disclaimer.
13 .\" 2. Redistributions in binary form must reproduce the above copyright
14 .\" notice, this list of conditions and the following disclaimer in the
15 .\" documentation and/or other materials provided with the distribution.
16 .\" 4. Neither the name of the University nor the names of its contributors
17 .\" may be used to endorse or promote products derived from this software
18 .\" without specific prior written permission.
20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 .\" @(#)stty.1 8.4 (Berkeley) 4/18/94
40 .Nd set the options for a terminal device interface
49 utility sets or reports on terminal
50 characteristics for the device that is its standard input.
51 If no options or arguments are specified, it reports the settings of a subset
52 of characteristics as well as additional ones if they differ from their
55 the terminal state according to the specified arguments.
56 Some combinations of arguments are mutually
57 exclusive on some terminal types.
59 The following options are available:
60 .Bl -tag -width indent
62 Display all the current settings for the terminal to standard output
66 Display all the current settings for the terminal to standard output
69 ``all'' and ``everything'' formats.
71 Open and use the terminal named by
73 rather than using standard input.
80 set or display settings on a terminal that might otherwise
83 Display all the current settings for the terminal to standard output
84 in a form that may be used as an argument to a subsequent invocation of
86 to restore the current terminal state as per
90 The following arguments are available to set the terminal
94 Control mode flags affect hardware characteristics associated with the
96 This corresponds to the c_cflag in the termios structure.
98 .It Cm parenb Pq Fl parenb
99 Enable (disable) parity generation
101 .It Cm parodd Pq Fl parodd
102 Select odd (even) parity.
103 .It Cm cs5 cs6 cs7 cs8
104 Select character size, if possible.
106 Set terminal baud rate to the
107 number given, if possible.
109 baud rate is set to zero, modem
112 .It Cm ispeed Ar number
113 Set terminal input baud rate to the
114 number given, if possible.
116 input baud rate is set to zero, the
117 input baud rate is set to the
118 value of the output baud
120 .It Cm ospeed Ar number
121 Set terminal output baud rate to
122 the number given, if possible.
124 the output baud rate is set to
125 zero, modem control is
127 .It Cm speed Ar number
134 .It Cm hupcl Pq Fl hupcl
135 Stop asserting modem control
136 (do not stop asserting modem control) on last close.
140 .It Cm cstopb Pq Fl cstopb
141 Use two (one) stop bits per character.
142 .It Cm cread Pq Fl cread
143 Enable (disable) the receiver.
144 .It Cm clocal Pq Fl clocal
145 Assume a line without (with) modem
147 .It Cm crtscts Pq Fl crtscts
148 Enable (disable) RTS/CTS flow control.
151 This corresponds to the c_iflag in the termios structure.
153 .It Cm ignbrk Pq Fl ignbrk
154 Ignore (do not ignore) break on
156 .It Cm brkint Pq Fl brkint
157 Signal (do not signal)
161 .It Cm ignpar Pq Fl ignpar
162 Ignore (do not ignore) characters with parity
164 .It Cm parmrk Pq Fl parmrk
165 Mark (do not mark) characters with parity errors.
166 .It Cm inpck Pq Fl inpck
167 Enable (disable) input parity
169 .It Cm istrip Pq Fl istrip
170 Strip (do not strip) input characters
172 .It Cm inlcr Pq Fl inlcr
178 .It Cm igncr Pq Fl igncr
179 Ignore (do not ignore)
182 .It Cm icrnl Pq Fl icrnl
188 .It Cm ixon Pq Fl ixon
193 Output from the system is
194 stopped when the system receives
196 and started when the system
201 is set, any character restarts output.
202 .It Cm ixoff Pq Fl ixoff
203 Request that the system send (not
207 the input queue is nearly
209 .It Cm ixany Pq Fl ixany
210 Allow any character (allow only
213 .It Cm imaxbel Pq Fl imaxbel
214 The system imposes a limit of
216 (currently 255) characters in the input queue.
219 is set and the input queue limit has been reached,
220 subsequent input causes the system to send an ASCII BEL
221 character to the output queue (the terminal beeps at you).
225 is unset and the input queue is full, the next input character causes
226 the entire input and output queues to be discarded.
229 This corresponds to the c_oflag of the termios structure.
231 .It Cm opost Pq Fl opost
232 Post-process output (do not
233 post-process output; ignore all other
235 .It Cm onlcr Pq Fl onlcr
241 .It Cm ocrnl Pq Fl ocrnl
248 Select tab expansion policy.
250 disables tab expansion, while
253 .It Cm onocr Pq Fl onocr
254 Do not (do) output CRs at column zero.
255 .It Cm onlret Pq Fl onlret
256 On the terminal NL performs (does not perform) the CR function.
260 Local mode flags (lflags) affect various and sundry characteristics of terminal
262 Historically the term "local" pertained to new job control features
263 implemented by Jim Kulp on a
267 Later the driver ran on the first
269 at Evans Hall, UC Berkeley, where the job control details
270 were greatly modified but the structure definitions and names
271 remained essentially unchanged.
272 The second interpretation of the 'l' in lflag
273 is ``line discipline flag'' which corresponds to the
279 .It Cm isig Pq Fl isig
280 Enable (disable) the checking of
281 characters against the special control
286 .It Cm icanon Pq Fl icanon
287 Enable (disable) canonical input
292 .It Cm iexten Pq Fl iexten
293 Enable (disable) any implementation
294 defined special control characters
295 not currently controlled by icanon,
297 .It Cm echo Pq Fl echo
298 Echo back (do not echo back) every
300 .It Cm echoe Pq Fl echoe
303 character shall (shall
304 not) visually erase the last character
305 in the current line from the
306 display, if possible.
307 .It Cm echok Pq Fl echok
313 .It Cm echoke Pq Fl echoke
316 character shall (shall
317 not) visually erase the
318 current line from the
319 display, if possible.
320 .It Cm echonl Pq Fl echonl
325 .It Cm echoctl Pq Fl echoctl
328 is set, echo control characters as ^X.
329 Otherwise control characters
331 .It Cm echoprt Pq Fl echoprt
332 For printing terminals.
333 If set, echo erased characters backwards within ``\\''
335 Otherwise, disable this feature.
336 .It Cm noflsh Pq Fl noflsh
337 Disable (enable) flush after
338 .Dv INTR , QUIT , SUSP .
339 .It Cm tostop Pq Fl tostop
342 for background output.
343 This causes background jobs to stop if they attempt
345 .It Cm altwerase Pq Fl altwerase
346 Use (do not use) an alternate word erase algorithm when processing
349 This alternate algorithm considers sequences of
350 alphanumeric/underscores as words.
351 It also skips the first preceding character in its classification
352 (as a convenience since the one preceding character could have been
353 erased with simply an
356 .It Cm mdmbuf Pq Fl mdmbuf
357 If set, flow control output based on condition of Carrier Detect.
359 writes return an error if Carrier Detect is low (and Carrier is not being
363 .It Cm flusho Pq Fl flusho
364 Indicates output is (is not) being discarded.
365 .It Cm pendin Pq Fl pendin
366 Indicates input is (is not) pending after a switch from non-canonical
367 to canonical mode and will be re-input when a read becomes pending
368 or more input arrives.
370 .Ss Control Characters:
372 .It Ar control-character Ar string
374 .Ar control-character
377 If string is a single character,
378 the control character is set to
381 two character sequence "^-" or the
382 string "undef" the control character
383 is disabled (i.e., set to
384 .Pf { Dv _POSIX_VDISABLE Ns } . )
386 Recognized control-characters:
387 .Bd -ragged -offset indent
388 .Bl -column character Subscript
390 .It character Ta Subscript Ta Description
391 .It _________ Ta _________ Ta _______________
392 .It eof Ta Tn VEOF Ta EOF No character
393 .It eol Ta Tn VEOL Ta EOL No character
394 .It eol2 Ta Tn VEOL2 Ta EOL2 No character
395 .It erase Ta Tn VERASE Ta ERASE No character
396 .It erase2 Ta Tn VERASE2 Ta ERASE2 No character
397 .It werase Ta Tn VWERASE Ta WERASE No character
398 .It intr Ta Tn VINTR Ta INTR No character
399 .It kill Ta Tn VKILL Ta KILL No character
400 .It quit Ta Tn VQUIT Ta QUIT No character
401 .It susp Ta Tn VSUSP Ta SUSP No character
402 .It start Ta Tn VSTART Ta START No character
403 .It stop Ta Tn VSTOP Ta STOP No character
404 .It dsusp Ta Tn VDSUSP Ta DSUSP No character
405 .It lnext Ta Tn VLNEXT Ta LNEXT No character
406 .It reprint Ta Tn VREPRINT Ta REPRINT No character
407 .It status Ta Tn VSTATUS Ta STATUS No character
411 .It Cm time Ar number
412 Set the value of min or time to
418 Non-Canonical mode input processing
421 .Ss Combination Modes:
423 .It Ar saved settings
424 Set the current terminal
425 characteristics to the saved settings
429 .It Cm evenp No or Cm parity
430 Enable parenb and cs7; disable
433 Enable parenb, cs7, and parodd.
434 .It Fl parity , evenp , oddp
435 Disable parenb, and set cs8.
436 .It Cm \&nl Pq Fl \&nl
437 Enable (disable) icrnl.
439 -nl unsets inlcr and igncr.
447 back to system defaults.
449 Resets all modes to reasonable values for interactive terminal use.
451 Set the line discipline to the standard terminal line discipline
454 Set (disable) all modes suitable for a CRT display device.
455 .It Cm kerninfo Pq Fl kerninfo
456 Enable (disable) the system generated status line associated with
459 character (usually set to ^T).
460 The status line consists of the
461 system load average, the current command name, its process ID, the
462 event the process is waiting on (or the status of the process), the user
463 and system times, percent cpu, and current memory usage.
464 .It Cm columns Ar number
465 The terminal size is recorded as having
468 .It Cm cols Ar number
471 .It Cm rows Ar number
472 The terminal size is recorded as having
476 Set modes suitable for users of Digital Equipment Corporation systems
481 characters are set to ^?, ^U, and ^C;
486 .It Cm extproc Pq Fl extproc
487 If set, this flag indicates that some amount of terminal processing is being
488 performed by either the terminal hardware or by the remote side connected
491 If set, change the modes of the terminal so that no input or output processing
493 If unset, change the modes of the terminal to some reasonable
494 state that performs input and output processing.
496 terminal driver no longer has a single
498 bit, it is not possible to intuit what flags were set prior to setting
500 This means that unsetting
502 may not put back all the setting that were previously in effect.
503 To set the terminal into a raw state and then accurately restore it, the following
504 shell code is recommended:
506 save_state=$(stty -g)
512 The size of the terminal is printed as two numbers on a single line,
513 first rows, then columns.
515 .Ss Compatibility Modes:
517 These modes remain for compatibility with the previous version of
523 Reports all the terminal modes as with
525 except that the control characters are printed in a columnar format.
534 .Cm brkint , ixon , imaxbel , opost ,
546 .It Cm newcrt Pq Fl newcrt
552 .It Cm tandem Pq Fl tandem
555 .It Cm decctlq Pq Fl decctlq
558 .It Cm crterase Pq Fl crterase
561 .It Cm crtbs Pq Fl crtbs
564 .It Cm crtkill Pq Fl crtkill
567 .It Cm ctlecho Pq Fl ctlecho
570 .It Cm prterase Pq Fl prterase
573 .It Cm litout Pq Fl litout
576 .It Cm oxtabs Pq Fl oxtabs
577 Expand (do not expand) tabs to spaces on output.
578 .It Cm tabs Pq Fl tabs
582 Same as the control character
584 .It Cm flush Ar value
585 Same as the control character
587 .It Cm rprnt Ar value
588 Same as the control character
598 utility is expected to be
606 extensions to the standard.