| blob | df32bc68a9bdd5e3aff1afa2b7a26ea211bfa6f3 |
1 '\" te
2 .\" Copyright 1989 AT&T
3 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
4 .\" Copyright (c) 2014, Joyent, Inc. All Rights Reserved
5 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
6 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at http://www.opengroup.org/bookstore/.
7 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text
8 .\" are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical
9 .\" and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
10 .\" This notice shall appear on any product containing this material.
11 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
12 .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
13 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
14 .TH STTY 1 "Oct 25, 2017"
15 .SH NAME
16 stty \- set the options for a terminal
17 .SH SYNOPSIS
18 .LP
19 .nf
20 \fB/usr/bin/stty\fR [\fB-a\fR | \fB-g\fR]
21 .fi
23 .LP
24 .nf
25 \fB/usr/bin/stty\fR [\fImodes\fR]
26 .fi
28 .SH DESCRIPTION
29 .LP
30 The \fBstty\fR utility sets certain terminal I/O options for the device that is
31 the current standard input. Without arguments, \fBstty\fR reports the settings
32 of certain options.
33 .sp
34 .LP
35 In this report, if a character is preceded by a caret (\fB^\fR), then the value
36 of that option is the corresponding control character (for example, \fB^h\fR is
37 CTRL-h. In this case, recall that CTRL-h is the same as the BACKSPACE key). The
38 sequence \fB^@\fR means that an option has a null value.
39 .sp
40 .LP
41 See \fBtermio\fR(7I) for detailed information about the modes listed from
42 \fBControl\fR \fBModes\fR through \fBLocal Modes\fR. For detailed information
43 about the modes listed under \fBHardware\fR \fBFlow\fR \fBControl\fR
44 \fBModes\fR and \fBClock Modes\fR, see \fBtermiox\fR(7I).
45 .sp
46 .LP
47 Operands described in the \fBCombination Modes\fR section are implemented using
48 options in the earlier sections. Notice that many combinations of options make
49 no sense, but no sanity checking is performed. Hardware flow control and clock
50 modes options might not be supported by all hardware interfaces.
51 .SH OPTIONS
52 .LP
53 The following options are supported:
54 .sp
55 .ne 2
56 .na
57 \fB\fB-a\fR\fR
58 .ad
59 .RS 6n
60 Writes to standard output all of the option settings for the terminal.
61 .RE
63 .sp
64 .ne 2
65 .na
66 \fB\fB-g\fR\fR
67 .ad
68 .RS 6n
69 Reports current settings in a form that can be used as an argument to another
70 \fBstty\fR command. Emits termios-type output if the underlying driver supports
71 it. Otherwise, it emits termio-type output.
72 .RE
74 .SH OPERANDS
75 .LP
76 The following \fImode\fR operands are supported:
77 .SS "Control Modes"
78 .ne 2
79 .na
80 \fB\fBparenb\fR(\fB-parenb\fR)\fR
81 .ad
82 .RS 24n
83 Enable (disable) parity generation and detection.
84 .RE
86 .sp
87 .ne 2
88 .na
89 \fB\fBparext\fR(\fB-parext\fR)\fR
90 .ad
91 .RS 24n
92 Enable (disable) extended parity generation and detection for mark and space
93 parity.
94 .RE
96 .sp
97 .ne 2
98 .na
99 \fB\fBparodd\fR(\fB-parodd\fR)\fR
100 .ad
101 .RS 24n
102 Select odd (even) parity, or mark (space) parity if \fBparext\fR is enabled.
103 .RE
105 .sp
106 .ne 2
107 .na
108 \fB\fBcs5\fR \fBcs6\fR \fBcs7\fR \fBcs8\fR\fR
109 .ad
110 .RS 24n
111 Select character size (see \fBtermio\fR(7I)).
112 .RE
114 .sp
115 .ne 2
116 .na
117 \fB\fB0\fR\fR
118 .ad
119 .RS 24n
120 Hang up line immediately.
121 .RE
123 .sp
124 .ne 2
125 .na
126 \fB\fBhupcl\fR (\fB-hupcl\fR)\fR
127 .ad
128 .RS 24n
129 Hang up (do not hang up) connection on last close.
130 .RE
132 .sp
133 .ne 2
134 .na
135 \fB\fBhup\fR (\fB-hup\fR)\fR
136 .ad
137 .RS 24n
138 Same as \fBhupcl\fR(\fB-hupcl\fR).
139 .RE
141 .sp
142 .ne 2
143 .na
144 \fB\fBcstopb\fR (\fB-cstopb\fR)\fR
145 .ad
146 .RS 24n
147 Use two (one) stop bits per character.
148 .RE
150 .sp
151 .ne 2
152 .na
153 \fB\fBcread\fR (\fB-cread\fR)\fR
154 .ad
155 .RS 24n
156 Enable (disable) the receiver.
157 .RE
159 .sp
160 .ne 2
161 .na
162 \fB\fBcrtscts\fR (\fB-crtscts\fR)\fR
163 .ad
164 .RS 24n
165 Enable output hardware flow control. Raise the \fBRTS\fR (Request to Send)
166 modem control line. Suspends output until the CTS (Clear to Send) line is
167 raised.
168 .RE
170 .sp
171 .ne 2
172 .na
173 \fB\fBcrtsxoff\fR (\fB-crtsxoff\fR)\fR
174 .ad
175 .RS 24n
176 Enable input hardware flow control. Raise the \fBRTS\fR (Request to Send) modem
177 control line to receive data. Suspends input when RTS is low.
178 .RE
180 .sp
181 .ne 2
182 .na
183 \fB\fBclocal\fR (\fB-clocal\fR)\fR
184 .ad
185 .RS 24n
186 Assume a line without (with) modem control.
187 .RE
189 .sp
190 .ne 2
191 .na
192 \fB\fBdefeucw\fR\fR
193 .ad
194 .RS 24n
195 Set the widths of multibyte characters to the values defined in the current
196 locale specified by \fBLC_CTYPE\fR. Internally, width is expressed in terms of
197 bytes per character, and screen or display columns per character.
198 .RE
200 .sp
201 .ne 2
202 .na
203 \fB110 300 600 1200 1800\fR
204 .ad
205 .br
206 .na
207 \fB2400 4800 9600 19200\fR
208 .ad
209 .br
210 .na
211 \fB38400 357600 76800 115200\fR
212 .ad
213 .br
214 .na
215 \fB153600 230400 307200 460800\fR
216 .ad
217 .sp .6
218 .RS 4n
219 Set terminal baud rate to the number given, if possible. (All speeds are not
220 supported by all hardware interfaces.)
221 .RE
223 .sp
224 .ne 2
225 .na
226 \fBispeed 0 110 300 600 1200\fR
227 .ad
228 .br
229 .na
230 \fB1800 2400 4800 9600 19200\fR
231 .ad
232 .br
233 .na
234 \fB38400 57600 76800 115200\fR
235 .ad
236 .br
237 .na
238 \fB153600 230400 307200 460800\fR
239 .ad
240 .sp .6
241 .RS 4n
242 Set terminal input baud rate to the number given, if possible. (Not all
243 hardware supports split baud rates.) If the input baud rate is set to \fB0\fR,
244 the input baud rate is specified by the value of the output baud rate.
245 .RE
247 .sp
248 .ne 2
249 .na
250 \fBospeed 0 110 300 600 1200\fR
251 .ad
252 .br
253 .na
254 \fB1800 2400 4800 9600 19200\fR
255 .ad
256 .br
257 .na
258 \fB38400 57600 76800 115200\fR
259 .ad
260 .br
261 .na
262 \fB153600 230400 307200 460800\fR
263 .ad
264 .sp .6
265 .RS 4n
266 Set terminal output baud rate to the number given, if possible. (Not all
267 hardware supports split baud rates.) If the output baud rate is set to \fB0\fR,
268 the line is hung up immediately.
269 .RE
271 .SS "Input Modes"
272 .ne 2
273 .na
274 \fB\fBignbrk\fR (\fB-ignbrk\fR)\fR
275 .ad
276 .RS 22n
277 Ignore (do not ignore) break on input.
278 .RE
280 .sp
281 .ne 2
282 .na
283 \fB\fBbrkint\fR (\fB-brkint\fR)\fR
284 .ad
285 .RS 22n
286 Signal (do not signal) INTR on break.
287 .RE
289 .sp
290 .ne 2
291 .na
292 \fB\fBignpar\fR (\fB-ignpar\fR)\fR
293 .ad
294 .RS 22n
295 Ignore (do not ignore) parity errors.
296 .RE
298 .sp
299 .ne 2
300 .na
301 \fB\fBparmrk\fR (\fB-parmrk\fR)\fR
302 .ad
303 .RS 22n
304 Mark (do not mark) parity errors (see \fBtermio\fR(7I)).
305 .RE
307 .sp
308 .ne 2
309 .na
310 \fB\fBinpck\fR (\fB-inpck\fR)\fR
311 .ad
312 .RS 22n
313 Enable (disable) input parity checking.
314 .RE
316 .sp
317 .ne 2
318 .na
319 \fB\fBistrip\fR (\fB-istrip\fR)\fR
320 .ad
321 .RS 22n
322 Strip (do not strip) input characters to seven bits.
323 .RE
325 .sp
326 .ne 2
327 .na
328 \fB\fBinlcr\fR (\fB-inlcr\fR)\fR
329 .ad
330 .RS 22n
331 Map (do not map) NL to CR on input.
332 .RE
334 .sp
335 .ne 2
336 .na
337 \fB\fBigncr\fR (\fB-igncr\fR)\fR
338 .ad
339 .RS 22n
340 Ignore (do not ignore) CR on input.
341 .RE
343 .sp
344 .ne 2
345 .na
346 \fB\fBicrnl\fR (\fB-icrnl\fR)\fR
347 .ad
348 .RS 22n
349 Map (do not map) CR to NL on input.
350 .RE
352 .sp
353 .ne 2
354 .na
355 \fB\fBiuclc\fR (\fB-iuclc\fR)\fR
356 .ad
357 .RS 22n
358 Map (do not map) upper-case alphabetics to lower case on input.
359 .RE
361 .sp
362 .ne 2
363 .na
364 \fB\fBixon\fR (\fB-ixon\fR)\fR
365 .ad
366 .RS 22n
367 Enable (disable) START/STOP output control. Output is stopped by sending STOP
368 control character and started by sending the START control character.
369 .RE
371 .sp
372 .ne 2
373 .na
374 \fB\fBixany\fR (\fB-ixany\fR)\fR
375 .ad
376 .RS 22n
377 Allow any character (only DC1) to restart output.
378 .RE
380 .sp
381 .ne 2
382 .na
383 \fB\fBixoff\fR (\fB-ixoff\fR)\fR
384 .ad
385 .RS 22n
386 Request that the system send (not send) START/STOP characters when the input
387 queue is nearly empty/full.
388 .RE
390 .sp
391 .ne 2
392 .na
393 \fB\fBimaxbel\fR (\fB-imaxbel\fR)\fR
394 .ad
395 .RS 22n
396 Echo (do not echo) \fBBEL\fR when the input line is too long. If \fBimaxbel\fR
397 is set, the \fBASCII BEL\fR character (\fB07 hex\fR) is echoed if the input
398 stream overflows. Further input is not stored, but any input already present
399 is not disturbed. If \fB-imaxbel\fR is set, no \fBBEL\fR character is echoed,
400 and all unread input present in the input queue is discarded if the input
401 stream overflows.
402 .RE
404 .SS "Output Modes"
405 .ne 2
406 .na
407 \fB\fBopost\fR (\fB-opost\fR)\fR
408 .ad
409 .RS 23n
410 Post-process output (do not post-process output; ignore all other output
411 modes).
412 .RE
414 .sp
415 .ne 2
416 .na
417 \fB\fBolcuc\fR (\fB-olcuc\fR)\fR
418 .ad
419 .RS 23n
420 Map (do not map) lower-case alphabetics to upper case on output.
421 .RE
423 .sp
424 .ne 2
425 .na
426 \fB\fBonlcr\fR (\fB-onlcr\fR)\fR
427 .ad
428 .RS 23n
429 Map (do not map) NL to CR-NL on output.
430 .RE
432 .sp
433 .ne 2
434 .na
435 \fB\fBocrnl\fR (\fB-ocrnl\fR)\fR
436 .ad
437 .RS 23n
438 Map (do not map) CR to NL on output.
439 .RE
441 .sp
442 .ne 2
443 .na
444 \fB\fBonocr\fR (\fB-onocr\fR)\fR
445 .ad
446 .RS 23n
447 Do not (do) output CRs at column zero.
448 .RE
450 .sp
451 .ne 2
452 .na
453 \fB\fBonlret\fR (\fB-onlret\fR)\fR
454 .ad
455 .RS 23n
456 On the terminal NL performs (does not perform) the CR function.
457 .RE
459 .sp
460 .ne 2
461 .na
462 \fB\fBofill\fR (\fB-ofill\fR)\fR
463 .ad
464 .RS 23n
465 Use fill characters (use timing) for delays.
466 .RE
468 .sp
469 .ne 2
470 .na
471 \fB\fBofdel\fR (\fB-ofdel\fR)\fR
472 .ad
473 .RS 23n
474 Fill characters are DELs (NULs).
475 .RE
477 .sp
478 .ne 2
479 .na
480 \fB\fBcr0 cr1 cr2 cr3\fR\fR
481 .ad
482 .RS 23n
483 Select style of delay for carriage returns (see \fBtermio\fR(7I)).
484 .RE
486 .sp
487 .ne 2
488 .na
489 \fB\fBnl0 nl1\fR\fR
490 .ad
491 .RS 23n
492 Select style of delay for line-feeds (see \fBtermio\fR(7I)).
493 .RE
495 .sp
496 .ne 2
497 .na
498 \fB\fBtab0 tab1 tab2 tab3\fR\fR
499 .ad
500 .RS 23n
501 Select style of delay for horizontal tabs (see \fBtermio\fR(7I)).
502 .RE
504 .sp
505 .ne 2
506 .na
507 \fB\fBbs0 bs1\fR\fR
508 .ad
509 .RS 23n
510 Select style of delay for backspaces (see \fBtermio\fR(7I)).
511 .RE
513 .sp
514 .ne 2
515 .na
516 \fB\fBff0 ff1\fR\fR
517 .ad
518 .RS 23n
519 Select style of delay for form-feeds (see \fBtermio\fR(7I)).
520 .RE
522 .sp
523 .ne 2
524 .na
525 \fB\fBvt0 vt1\fR\fR
526 .ad
527 .RS 23n
528 Select style of delay for vertical tabs (see \fBtermio\fR(7I)).
529 .RE
531 .SS "Local Modes"
532 .ne 2
533 .na
534 \fB\fBisig\fR(\fB-isig\fR)\fR
535 .ad
536 .RS 22n
537 Enable (disable) the checking of characters against the special control
538 characters INTR, QUIT, SWTCH, and SUSP. For information on \fBSWTCH\fR, see
539 \fBNOTES\fR.
540 .RE
542 .sp
543 .ne 2
544 .na
545 \fB\fBicanon\fR (\fB-icanon\fR)\fR
546 .ad
547 .RS 22n
548 Enable (disable) canonical input (ERASE and KILL processing). Does not set
549 \fBMIN\fR or \fBTIME\fR.
550 .RE
552 .sp
553 .ne 2
554 .na
555 \fB\fBxcase\fR (\fB-xcase\fR)\fR
556 .ad
557 .RS 22n
558 Canonical (unprocessed) upper/lower-case presentation.
559 .RE
561 .sp
562 .ne 2
563 .na
564 \fB\fBecho\fR (\fB-echo\fR)\fR
565 .ad
566 .RS 22n
567 Echo back (do not echo back) every character typed.
568 .RE
570 .sp
571 .ne 2
572 .na
573 \fB\fBechoe\fR (\fB-echoe\fR)\fR
574 .ad
575 .RS 22n
576 Echo (do not echo) ERASE character as a backspace-space-backspace string. This
577 mode erases the ERASEed character on many CRT terminals; however, it does not
578 keep track of column position and, as a result, it might be confusing for
579 escaped characters, tabs, and backspaces.
580 .RE
582 .sp
583 .ne 2
584 .na
585 \fB\fBechok\fR(\fB-echok\fR)\fR
586 .ad
587 .RS 22n
588 Echo (do not echo) NL after KILL character.
589 .RE
591 .sp
592 .ne 2
593 .na
594 \fB\fBlfkc\fR (\fB-lfkc\fR)\fR
595 .ad
596 .RS 22n
597 The same as \fBechok\fR(\fB-echok\fR); obsolete.
598 .RE
600 .sp
601 .ne 2
602 .na
603 \fB\fBechonl\fR (\fB-echonl\fR)\fR
604 .ad
605 .RS 22n
606 Echo (do not echo) NL.
607 .RE
609 .sp
610 .ne 2
611 .na
612 \fB\fBnoflsh\fR (\fB-noflsh\fR)\fR
613 .ad
614 .RS 22n
615 Disable (enable) flush after INTR, QUIT, or SUSP.
616 .RE
618 .sp
619 .ne 2
620 .na
621 \fB\fBstwrap\fR (\fB-stwrap\fR)\fR
622 .ad
623 .RS 22n
624 Disable (enable) truncation of lines longer than \fB79\fR characters on a
625 synchronous line.
626 .RE
628 .sp
629 .ne 2
630 .na
631 \fB\fBtostop\fR (\fB-tostop\fR)\fR
632 .ad
633 .RS 22n
634 Send (do not send) \fBSIGTTOU\fR when background processes write to the
635 terminal.
636 .RE
638 .sp
639 .ne 2
640 .na
641 \fB\fBechoctl\fR \fB(\fR\fB-echoctl\fR\fB)\fR\fR
642 .ad
643 .RS 22n
644 Echo (do not echo) control characters as \fB^\fR\fIchar,\fR delete as \fB^?\fR.
645 .RE
647 .sp
648 .ne 2
649 .na
650 \fB\fBechoprt\fR \fB(\fR\fB-echoprt\fR\fB)\fR\fR
651 .ad
652 .RS 22n
653 Echo (do not echo) erase character as character is ``erased''.
654 .RE
656 .sp
657 .ne 2
658 .na
659 \fB\fBechoke\fR \fB(\fR\fB-echoke\fR\fB)\fR\fR
660 .ad
661 .RS 22n
662 BS-SP-BS erase (do not BS-SP-BS erase) entire line on line kill.
663 .RE
665 .sp
666 .ne 2
667 .na
668 \fB\fBflusho\fR \fB(\fR\fB-flusho\fR\fB)\fR\fR
669 .ad
670 .RS 22n
671 Output is (is not) being flushed.
672 .RE
674 .sp
675 .ne 2
676 .na
677 \fB\fBpendin\fR \fB(\fR\fB-pendin\fR\fB)\fR\fR
678 .ad
679 .RS 22n
680 Retype (do not retype) pending input at next read or input character.
681 .RE
683 .sp
684 .ne 2
685 .na
686 \fB\fBiexten\fR \fB(\fR\fB-iexten\fR\fB)\fR\fR
687 .ad
688 .RS 22n
689 Enable (disable) special control characters not currently controlled by
690 \fBicanon\fR, \fBisig\fR, \fBixon\fR, or \fBixoff\fR: \fBVEOL\fR, \fBVSWTCH\fR,
691 \fBVREPRINT\fR, \fBVDISCARD\fR, \fBVDSUSP\fR, \fBVWERASE\fR, \fBand\fR
692 \fBVLNEXT\fR.
693 .RE
695 .sp
696 .ne 2
697 .na
698 \fB\fBstflush\fR \fB(\fR\fB-stflush\fR)\fR
699 .ad
700 .RS 22n
701 Enable (disable) flush on a synchronous line after every \fBwrite\fR(2).
702 .RE
704 .sp
705 .ne 2
706 .na
707 \fB\fBstappl\fR \fB(\fR\fB-stappl\fR)\fR
708 .ad
709 .RS 22n
710 Use application mode (use line mode) on a synchronous line.
711 .RE
713 .SS "Hardware Flow Control Modes"
714 .ne 2
715 .na
716 \fB\fBrtsxoff\fR (\fB-rtsxoff\fR)\fR
717 .ad
718 .RS 22n
719 Enable (disable) RTS hardware flow control on input.
720 .RE
722 .sp
723 .ne 2
724 .na
725 \fB\fBctsxon\fR (\fB-ctsxon\fR)\fR
726 .ad
727 .RS 22n
728 Enable (disable) CTS hardware flow control on output.
729 .RE
731 .sp
732 .ne 2
733 .na
734 \fB\fBdtrxoff\fR (\fB-dtrxoff\fR)\fR
735 .ad
736 .RS 22n
737 Enable (disable) DTR hardware flow control on input.
738 .RE
740 .sp
741 .ne 2
742 .na
743 \fB\fBcdxon\fR (\fB-cdxon\fR)\fR
744 .ad
745 .RS 22n
746 Enable (disable) CD hardware flow control on output.
747 .RE
749 .sp
750 .ne 2
751 .na
752 \fB\fBisxoff\fR (\fB-isxoff\fR)\fR
753 .ad
754 .RS 22n
755 Enable (disable) isochronous hardware flow control on input.
756 .RE
758 .SS "Clock Modes"
759 .ne 2
760 .na
761 \fB\fBxcibrg\fR\fR
762 .ad
763 .RS 13n
764 Get transmit clock from internal baud rate generator.
765 .RE
767 .sp
768 .ne 2
769 .na
770 \fB\fBxctset\fR\fR
771 .ad
772 .RS 13n
773 Get the transmit clock from transmitter signal element timing (DCE source)
774 lead, CCITT V.24 circuit 114, EIA-232-D pin 15.
775 .RE
777 .sp
778 .ne 2
779 .na
780 \fB\fBxcrset\fR\fR
781 .ad
782 .RS 13n
783 Get transmit clock from receiver signal element timing (DCE source) lead, CCITT
784 V.24 circuit 115, EIA-232-D pin 17.
785 .RE
787 .sp
788 .ne 2
789 .na
790 \fB\fBrcibrg\fR\fR
791 .ad
792 .RS 13n
793 Get receive clock from internal baud rate generator.
794 .RE
796 .sp
797 .ne 2
798 .na
799 \fB\fBrctset\fR\fR
800 .ad
801 .RS 13n
802 Get receive clock from transmitter signal element timing (DCE source) lead,
803 CCITT V.24 circuit 114, EIA-232-D pin 15.
804 .RE
806 .sp
807 .ne 2
808 .na
809 \fB\fBrcrset\fR\fR
810 .ad
811 .RS 13n
812 Get receive clock from receiver signal element timing (DCE source) lead, CCITT
813 V.24 circuit 115, EIA-232-D pin 17.
814 .RE
816 .sp
817 .ne 2
818 .na
819 \fB\fBtsetcoff\fR\fR
820 .ad
821 .RS 13n
822 Transmitter signal element timing clock not provided.
823 .RE
825 .sp
826 .ne 2
827 .na
828 \fB\fBtsetcrbrg\fR\fR
829 .ad
830 .RS 13n
831 Output receive baud rate generator on transmitter signal element timing (DTE
832 source) lead, CCITT V.24 circuit 113, EIA-232-D pin 24.
833 .RE
835 .sp
836 .ne 2
837 .na
838 \fB\fBtsetctbrg\fR\fR
839 .ad
840 .RS 13n
841 Output transmit baud rate generator on transmitter signal element timing (DTE
842 source) lead, CCITT V.24 circuit 113, EIA-232-D pin 24.
843 .RE
845 .sp
846 .ne 2
847 .na
848 \fB\fBtsetctset\fR\fR
849 .ad
850 .RS 13n
851 Output transmitter signal element timing (DCE source) on transmitter signal
852 element timing (DTE source) lead, CCITT V.24 circuit 113, EIA-232-D pin 24.
853 .RE
855 .sp
856 .ne 2
857 .na
858 \fB\fBtsetcrset\fR\fR
859 .ad
860 .RS 13n
861 Output receiver signal element timing (DCE source) on transmitter signal
862 element timing (DTE source) lead, CCITT V.24 circuit 113, EIA-232-D pin 24.
863 .RE
865 .sp
866 .ne 2
867 .na
868 \fB\fBrsetcoff\fR\fR
869 .ad
870 .RS 13n
871 Receiver signal element timing clock not provided.
872 .RE
874 .sp
875 .ne 2
876 .na
877 \fB\fBrsetcrbrg\fR\fR
878 .ad
879 .RS 13n
880 Output receive baud rate generator on receiver signal element timing (DTE
881 source) lead, CCITT V.24 circuit 128, no EIA-232-D pin.
882 .RE
884 .sp
885 .ne 2
886 .na
887 \fB\fBrsetctbrg\fR\fR
888 .ad
889 .RS 13n
890 Output transmit baud rate generator on receiver signal element timing (DTE
891 source) lead, CCITT V.24 circuit 128, no EIA-232-D pin.
892 .RE
894 .sp
895 .ne 2
896 .na
897 \fB\fBrsetctset\fR\fR
898 .ad
899 .RS 13n
900 Output transmitter signal element timing (DCE source) on receiver signal
901 element timing (DTE source) lead, CCITT V.24 circuit 128, no EIA-232-D pin.
902 .RE
904 .sp
905 .ne 2
906 .na
907 \fB\fBrsetcrset\fR\fR
908 .ad
909 .RS 13n
910 Output receiver signal element timing (DCE source) on receiver signal element
911 timing (DTE source) lead, CCITT V.24 circuit 128, no EIA-232-D pin.
912 .RE
914 .SS "Control Assignments"
915 .ne 2
916 .na
917 \fB\fIcontrol-character\fR \fIc\fR\fR
918 .ad
919 .sp .6
920 .RS 4n
921 Set \fIcontrol-character\fR to \fIc\fR, where:
922 .sp
923 .ne 2
924 .na
925 \fB\fIcontrol-character\fR\fR
926 .ad
927 .RS 21n
928 is \fBctab\fR, \fBdiscard\fR, \fBdsusp\fR, \fBeof\fR, \fBeol\fR, \fBeol2\fR,
929 \fBerase\fR, \fBerase2\fR, \fBintr\fR, \fBkill\fR, \fBlnext\fR, \fBquit\fR,
930 \fBreprint\fR, \fBstart\fR, \fBstop\fR, \fBsusp\fR, \fBstatus\fR, \fBswtch\fR,
931 or \fBwerase\fR (\fBctab\fR is used with \fB-stappl\fR, see \fBtermio\fR(7I)).
932 For information on \fBswtch\fR, see NOTES.
933 .RE
935 .sp
936 .ne 2
937 .na
938 \fB\fIc\fR\fR
939 .ad
940 .RS 21n
941 If \fIc\fR is a single character, the control character is set to that
942 character.
943 .sp
944 In the POSIX locale, if \fIc\fR is preceded by a caret (\fB^\fR) indicating an
945 escape from the shell and is one of those listed in the \fI^c\fR column of the
946 following table, then its value used (in the Value column) is the corresponding
947 control character (for example, ``\fB^d\fR'' is a CTRL-d). ``\fB^?\fR'' is
948 interpreted as DEL and ``\fB^\(mi\fR'' is interpreted as undefined.
949 .RE
951 .RE
953 .sp
955 .sp
956 .TS
957 box;
958 c c c c c c
959 l l l l l l .
960 \fB^\fR\fIc\fR \fBValue\fR \fB^\fR\fIc\fR \fBValue\fR \fB^\fR\fIc\fR \fBValue\fR
961 \fBa\fR, A <SOH> \fBl\fR, L <FF> \fBw\fR, W <ETB>
962 \fBb\fR, B <STX> \fBm\fR, M <CR> \fBx\fR, X <CAN>
963 \fBc\fR, C <ETX> \fBn\fR, N <SO> \fBy\fR, Y <EM>
964 \fBd\fR, D <EOT> \fBo\fR, O <SI> \fBz\fR, Z <SUB>
965 \fBe\fR, E <ENQ> \fBp\fR, P <DLE> \fB[\fR <ESC>
966 \fBf\fR, F <ACK> \fBq\fR, Q <DC1> \fB\e\fR <FS>
967 \fBg\fR, G <BEL> \fBr\fR, R <DC2> \fB]\fR <GS>
968 \fBh\fR, H <BS> \fBs\fR, S <DC3> \fB^\fR <RS>
969 \fBi\fR, I <HT> \fBt\fR, T <DC4> \fB_\fR <US>
970 \fBj\fR, J <LF> \fBu\fR, U <NAK> \fB?\fR <DEL>
971 \fBk\fR, K <VT> \fBv\fR, V <SYN>
972 .TE
974 .sp
975 .ne 2
976 .na
977 \fB\fBmin\fR \fInumber\fR\fR
978 .ad
979 .br
980 .na
981 \fB\fBtime\fR \fInumber\fR\fR
982 .ad
983 .RS 15n
984 Set the value of \fBmin\fR or \fBtime\fR to \fInumber\fR. \fBMIN\fR and
985 \fBTIME\fR are used in Non-Canonical mode input processing (\fB-icanon\fR).
986 .RE
988 .sp
989 .ne 2
990 .na
991 \fB\fBline\fR \fIi\fR\fR
992 .ad
993 .RS 15n
994 Set line discipline to \fIi\fR ( \fB0\fR< \fIi\fR <\fB127\fR).
995 .RE
997 .SS "Combination Modes"
998 .ne 2
999 .na
1000 \fB\fIsaved\fR \fIsettings\fR\fR
1001 .ad
1002 .RS 24n
1003 Set the current terminal characteristics to the saved settings produced by the
1004 \fB-g\fR option.
1005 .RE
1007 .sp
1008 .ne 2
1009 .na
1010 \fB\fBevenp\fR or \fBparity\fR\fR
1011 .ad
1012 .RS 24n
1013 Enable \fBparenb\fR and \fBcs7\fR, or disable \fBparodd\fR.
1014 .RE
1016 .sp
1017 .ne 2
1018 .na
1019 \fB\fBoddp\fR\fR
1020 .ad
1021 .RS 24n
1022 Enable \fBparenb\fR, \fBcs7\fR, and \fBparodd\fR.
1023 .RE
1025 .sp
1026 .ne 2
1027 .na
1028 \fB\fBspacep\fR\fR
1029 .ad
1030 .RS 24n
1031 Enable \fBparenb\fR, \fBcs7\fR, and \fBparext\fR.
1032 .RE
1034 .sp
1035 .ne 2
1036 .na
1037 \fB\fBmarkp\fR\fR
1038 .ad
1039 .RS 24n
1040 Enable \fBparenb\fR, \fBcs7\fR, \fBparodd\fR, and \fBparext\fR.
1041 .RE
1043 .sp
1044 .ne 2
1045 .na
1046 \fB\fB-parity\fR, or \fB-evenp\fR\fR
1047 .ad
1048 .RS 24n
1049 Disable \fBparenb\fR, and set \fBcs8\fR.
1050 .RE
1052 .sp
1053 .ne 2
1054 .na
1055 \fB\fB-oddp\fR\fR
1056 .ad
1057 .RS 24n
1058 Disable \fBparenb\fR and \fBparodd\fR, and set \fBcs8\fR.
1059 .RE
1061 .sp
1062 .ne 2
1063 .na
1064 \fB\fB-spacep\fR\fR
1065 .ad
1066 .RS 24n
1067 Disable \fBparenb\fR and \fBparext\fR, and set \fBcs8\fR.
1068 .RE
1070 .sp
1071 .ne 2
1072 .na
1073 \fB\fB-markp\fR\fR
1074 .ad
1075 .RS 24n
1076 Disable \fBparenb\fR, \fBparodd\fR, and \fBparext\fR, and set \fBcs8\fR.
1077 .RE
1079 .sp
1080 .ne 2
1081 .na
1082 \fB\fBraw\fR (\fB-raw\fR or \fBcooked\fR)\fR
1083 .ad
1084 .RS 24n
1085 Enable (disable) raw input and output. Raw mode is equivalent to setting:
1086 .sp
1087 .in +2
1088 .nf
1089 stty cs8 -icanon min 1 time 0 -isig -xcase \e
1090 -inpck -opost
1091 .fi
1092 .in -2
1094 .RE
1096 .ne 2
1097 .na
1098 \fB\fBnl\fR (\fB-nl\fR)\fR
1099 .ad
1100 .RS 12n
1101 Unset (set) \fBicrnl\fR, \fBonlcr\fR. In addition \fB-nl\fR unsets \fBinlcr\fR,
1102 \fBigncr\fR, \fBocrnl\fR, and \fBonlret\fR.
1103 .RE
1105 .ne 2
1106 .na
1107 \fB\fBnl\fR (\fB-nl\fR)\fR
1108 .ad
1109 .RS 24n
1110 Set (unset) \fBicrnl\fR. In addition, \fB-nl\fR unsets \fBinlcr\fR,
1111 \fBigncr\fR, \fBocrnl\fR, and \fBonlret\fR; \fB-nl\fR sets \fBonlcr\fR, and
1112 \fBnl\fR unsets \fBonlcr\fR.
1113 .RE
1115 .sp
1116 .ne 2
1117 .na
1118 \fB\fBlcase\fR (\fB-lcase\fR)\fR
1119 .ad
1120 .RS 24n
1121 Set (unset) \fBxcase\fR, \fBiuclc\fR, and \fBolcuc\fR.
1122 .RE
1124 .sp
1125 .ne 2
1126 .na
1127 \fB\fBLCASE\fR (\fB-LCASE\fR)\fR
1128 .ad
1129 .RS 24n
1130 Same as \fBlcase\fR (\fB-lcase\fR).
1131 .RE
1133 .sp
1134 .ne 2
1135 .na
1136 \fB\fBtabs\fR (\fB-tabs\fR or \fBtab3\fR)\fR
1137 .ad
1138 .RS 24n
1139 Preserve (expand to spaces) tabs when printing.
1140 .RE
1142 .sp
1143 .ne 2
1144 .na
1145 \fB\fBek\fR\fR
1146 .ad
1147 .RS 24n
1148 Reset ERASE, ERASE2, and KILL characters back to normal DEL, CTRL-h, and CTRL-u,
1149 respectively.
1150 .RE
1152 .sp
1153 .ne 2
1154 .na
1155 \fB\fBsane\fR\fR
1156 .ad
1157 .RS 24n
1158 Reset all modes to some reasonable values.
1159 .RE
1161 .sp
1162 .ne 2
1163 .na
1164 \fB\fIterm\fR\fR
1165 .ad
1166 .RS 24n
1167 Set all modes suitable for the terminal type \fIterm\fR, where \fIterm\fR is
1168 one of \fBtty33\fR, \fBtty37\fR, \fBvt05\fR, \fBtn300\fR, \fBti700\fR, or
1169 \fBtek\fR.
1170 .RE
1172 .sp
1173 .ne 2
1174 .na
1175 \fB\fBasync\fR\fR
1176 .ad
1177 .RS 24n
1178 Set normal asynchronous communications where clock settings are \fBxcibrg\fR,
1179 \fBrcibrg\fR, \fBtsetcoff\fR and \fBrsetcoff\fR.
1180 .RE
1182 .SS "Window Size"
1183 .ne 2
1184 .na
1185 \fB\fBrows\fR \fIn\fR\fR
1186 .ad
1187 .RS 13n
1188 Set window size to \fIn\fR rows.
1189 .RE
1191 .sp
1192 .ne 2
1193 .na
1194 \fB\fBcolumns\fR \fIn\fR\fR
1195 .ad
1196 .RS 13n
1197 Set window size to \fIn\fR columns.
1198 .RE
1200 .sp
1201 .ne 2
1202 .na
1203 \fB\fBcols\fR \fIn\fR\fR
1204 .ad
1205 .RS 13n
1206 Set window size to \fIn\fR columns. \fBcols\fR is a shorthand alias for
1207 columns.
1208 .RE
1210 .sp
1211 .ne 2
1212 .na
1213 \fB\fBypixels\fR \fIn\fR\fR
1214 .ad
1215 .RS 13n
1216 Set vertical window size to \fIn\fR pixels.
1217 .RE
1219 .sp
1220 .ne 2
1221 .na
1222 \fB\fBxpixels\fR \fIn\fR\fR
1223 .ad
1224 .RS 13n
1225 Set horizontal window size to \fIn\fR pixels.
1226 .RE
1228 .SH USAGE
1229 .LP
1230 The \fB-g\fR flag is designed to facilitate the saving and restoring of
1231 terminal state from the shell level. For example, a program can:
1232 .sp
1233 .in +2
1234 .nf
1235 saveterm="$(stty -g)" # save terminal state
1236 stty (new settings) # set new state
1237 \&... # ...
1238 stty $saveterm # restore terminal state
1239 .fi
1240 .in -2
1241 .sp
1243 .sp
1244 .LP
1245 Since the \fB-a\fR format is so loosely specified, scripts that save and
1246 restore terminal settings should use the \fB-g\fR option.
1247 .SH ENVIRONMENT VARIABLES
1248 .LP
1249 See \fBenviron\fR(5) for descriptions of the following environment variables
1250 that affect the execution of \fBstty\fR: \fBLANG\fR, \fBLC_ALL\fR,
1251 \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
1252 .SH EXIT STATUS
1253 .LP
1254 The following exit values are returned:
1255 .sp
1256 .ne 2
1257 .na
1258 \fB\fB0\fR\fR
1259 .ad
1260 .RS 6n
1261 Successful completion.
1262 .RE
1264 .sp
1265 .ne 2
1266 .na
1267 \fB\fB>0\fR\fR
1268 .ad
1269 .RS 6n
1270 An error occurred.
1271 .RE
1273 .SH ATTRIBUTES
1274 .LP
1275 See \fBattributes\fR(5) for descriptions of the following attributes:
1276 .SS "/usr/bin/stty"
1277 .TS
1278 box;
1279 c | c
1280 l | l .
1281 ATTRIBUTE TYPE ATTRIBUTE VALUE
1282 _
1283 Interface Stability Committed
1284 _
1285 Standard See \fBstandards\fR(5).
1286 .TE
1288 .SH SEE ALSO
1289 .LP
1290 \fBtabs\fR(1), \fBioctl\fR(2), \fBwrite\fR(2), \fBgetwidth\fR(3C),
1291 \fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5), \fBldterm\fR(7M),
1292 \fBtermio\fR(7I), \fBtermiox\fR(7I)
1293 .SH NOTES
1294 .LP
1295 Solaris does not support any of the actions implied by \fBswtch\fR, which was
1296 used by the \fBsxt\fR driver on System V release 4. Solaris allows the
1297 \fBswtch\fR value to be set, and prints it out if set, but it does not perform
1298 the \fBswtch\fR action.
1299 .sp
1300 .LP
1301 The job switch functionality on Solaris is actually handled by job control.
1302 \fBsusp\fR is the correct setting for this.