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