1stty(1B) SunOS/BSD Compatibility Package Commands stty(1B)
2
6 stty - set the options for a terminal
7
9 /usr/ucb/stty [-a] [-g] [-h] [modes]
10
13 stty sets certain terminal I/O options for the device that is the cur‐
14 rent standard output. Without arguments, stty reports the settings of
15 certain options.
16
18 In this report, if a character is preceded by a caret (^), then the
19 value of that option is the corresponding CTRL character (for example,
20 ^h is CTRL-h. In this case, recall that CTRL-h is the same as the
21 BACKSPACE key.) The sequence ^@ means that an option has a null value.
22 -a Reports all of the option settings.
24 -g Reports current settings in a form that can be used as an argu‐
27 ment to another stty command.
28 -h Reports all the option settings with the control characters in an
31 easy to read column format.
32 Options in the last group are implemented using options in the previous
36 groups. Many combinations of options make no sense, but no sanity
37 checking is performed. Hardware flow control and clock modes options
38 might not be supported by all hardware interfaces. The options are
39 selected from the following:
40 Special Requests
42 all Reports the same option settings as stty without argu‐
43 ments, but with the control characters in column format.
44 everything Everything stty knows about is printed. Same as -h
47 option.
48 speed The terminal speed alone is reported on the standard out‐
51 put.
52 size The terminal (window) sizes are printed on the standard
55 output, first rows and then columns. This option is only
56 appropriate if currently running a window system.
57 size and speed always report on the settings of /dev/tty,
59 and always report the settings to the standard output.
60 Control Modes
63 parenb (-parenb)
64 Enable (disable) parity generation and detection.
66 parext (-parext)
69 Enable (disable) extended parity generation and detection for mark
71 and space parity.
72 parodd (-parodd)
75 Select odd (even) parity, or mark (space) parity if parext is
77 enabled.
78 cs5 cs6 cs7 cs8
81 Select character size (see termio(7I)).
83 0
86 Hang up line immediately.
88 110 300 600 1200 1800 2400 4800 9600 19200 exta 38400 extb
91 Set terminal baud rate to the number given, if possible. (All
93 speeds are not supported by all hardware interfaces.)
94 ispeed 0 110 300 600 1200 1800 2400 4800 9600 19200 exta 38400 extb
97 Set terminal input baud rate to the number given, if possible. (Not
99 all hardware supports split baud rates.) If the input baud rate is
100 set to zero, the input baud rate is specified by the value of the
101 output baud rate.
102 ospeed 0 110 300 600 1200 1800 2400 4800 9600 19200 exta 38400 extb
105 Set terminal output baud rate to the number given, if possible.
107 (Not all hardware supports split baud rates.) If the baud rate is
108 set to zero, the line is hung up immediately.
109 hupcl (-hupcl)
112 Hang up (do not hang up) connection on last close.
114 hup (-hup)
117 Same as hupcl (-hupcl).
119 cstopb (-cstopb)
122 Use two (one) stop bits per character.
124 cread (-cread)
127 Enable (disable) the receiver.
129 clocal (-clocal)
132 Assume a line without (with) modem control.
134 crtscts (-crtscts)
137 Enable hardware flow control. Raise the RTS (Request to Send)
139 modem control line. Suspends output until the CTS (Clear to
140 Send) line is raised.
141 loblk (-loblk)
144 Block (do not block) output from a non-current layer.
146 Input Modes
149 ignbrk (-ignbrk) Ignore (do not ignore) break on input.
150 brkint (-brkint) Signal (do not signal) INTR on break.
153 ignpar (-ignpar) Ignore (do not ignore) parity errors.
156 parmrk (-parmrk) Mark (do not mark) parity errors (see
159 termio(7I)).
160 inpck (-inpck) Enable (disable) input parity checking.
163 istrip (-istrip) Strip (do not strip) input characters to seven
166 bits.
167 inlcr (-inlcr) Map (do not map) NL to CR on input.
170 igncr (-igncr) Ignore (do not ignore) CR on input.
173 icrnl (-icrnl) Map (do not map) CR to NL on input.
176 iuclc (-iuclc) Map (do not map) upper-case alphabetics to lower
179 case on input.
180 ixon (-ixon) Enable (disable) START/STOP output control. Out‐
183 put is stopped by sending an STOP and started by
184 sending an START.
185 ixany (-ixany) Allow any character (only START) to restart out‐
188 put.
189 decctlq (-decctlq) Same as -ixany.
192 ixoff (-ixoff) Request that the system send (not send)
195 START/STOP characters when the input queue is
196 nearly empty/full.
197 tandem (-tandem) Same as ixoff.
200 imaxbel (-imaxbel) Echo (do not echo) BEL when the input line is
203 too long.
204 iexten (-iexten) Enable (disable) extended (implementation-
207 defined) functions for input data.
208 Output Modes
211 opost (-opost) Post-process output (do not post-process output;
212 ignore all other output modes).
213 olcuc (-olcuc) Map (do not map) lower-case alphabetics to upper
216 case on output.
217 onlcr (-onlcr) Map (do not map) NL to CR-NL on output.
220 ocrnl (-ocrnl) Map (do not map) CR to NL on output.
223 onocr (-onocr) Do not (do) output CRs at column zero.
226 onlret (-onlret) On the terminal NL performs (does not perform)
229 the CR function.
230 ofill (-ofill) Use fill characters (use timing) for delays.
233 ofdel (-ofdel) Fill characters are DELs (NULs).
236 cr0 cr1 cr2 cr3 Select style of delay for carriage returns (see
239 termio(7I)).
240 nl0 nl1 Select style of delay for line-feeds (see
243 termio(7I)).
244 tab0 tab1 tab2 tab3 Select style of delay for horizontal tabs (see
247 termio(7I)).
248 bs0 bs1 Select style of delay for backspaces (see
251 termio(7I)).
252 ff0 ff1 Select style of delay for form-feeds (see
255 termio(7I)).
256 vt0 vt1 Select style of delay for vertical tabs (see
259 termio(7I)).
260 Local Modes
263 isig (-isig) Enable (disable) the checking of characters
264 against the special control characters INTR,
265 QUIT, and SWTCH. For information on SWTCH, see
266 NOTES.
267 icanon (-icanon) Enable (disable) canonical input (ERASE and
270 KILL processing). Does not set MIN or TIME.
271 cbreak (-cbreak) Equivalent to -icanon min 1 time 0.
274 xcase (-xcase) Canonical (unprocessed) upper/lower-case pre‐
277 sentation.
278 echo (-echo) Echo back (do not echo back) every character
281 typed.
282 echoe (-echoe) Echo (do not echo) ERASE character as a
285 backspace-space-backspace string. Note: This
286 mode erases the ERASEed character on many CRT
287 terminals; however, it does not keep track of
288 column position and, as a result, can be con‐
289 fusing on escaped characters, tabs, and
290 backspaces.
291 crterase (-crterase) Same as echoe.
294 echok (-echok) Echo (do not echo) NL after KILL character.
297 lfkc (-lfkc) The same as echok (-echok); obsolete.
300 echonl (-echonl) Echo (do not echo) NL.
303 noflsh (-noflsh) Disable (enable) flush after INTR, QUIT, or
306 SWTCH. For information on SWTCH, see NOTES.
307 stwrap (-stwrap) Disable (enable) truncation of lines longer
310 than 79 characters on a synchronous line.
311 (Does not apply to the 3B2.)
312 tostop (-tostop) Send (do not send) SIGTTOU for background pro‐
315 cesses.
316 echoctl (-echoctl) Echo (do not echo) control characters as ^char,
319 delete as ^?
320 ctlecho (-ctlecho) Same as echoctl.
323 echoprt (-echoprt) Echo (do not echo) erase character as character
326 is ``erased''.
327 prterase (-prterase) Same as echoprt.
330 echoke (-echoke) BS-SP-BS erase (do not BS-SP-BS erase) entire
333 line on line kill.
334 crtkill (-crtkill) Same as echoke.
337 flusho (-flusho) Output is (is not) being flushed.
340 pendin (-pendin) Retype (do not retype) pending input at next
343 read or input character.
344 stflush (-stflush) Enable (disable) flush on a synchronous line
347 after every write(2). (Does not apply to the
348 3B2.)
349 stappl (-stappl) Use application mode (use line mode) on a syn‐
352 chronous line. (Does not apply to the 3B2.)
353 Hardware Flow Control Modes
356 rtsxoff (-rtsxoff) Enable (disable) RTS hardware flow control on
357 input.
358 ctsxon (-ctsxon) Enable (disable) CTS hardware flow control on
361 output.
362 dterxoff (-dterxoff) Enable (disable) DTER hardware flow control on
365 input.
366 rlsdxon (-rlsdxon) Enable (disable) RLSD hardware flow control on
369 output.
370 isxoff (-isxoff) Enable (disable) isochronous hardware flow con‐
373 trol on input.
374 Clock Modes
377 xcibrg Get transmit clock from internal baud rate generator.
378 xctset Get the transmit clock from transmitter signal element tim‐
381 ing (DCE source) lead, CCITT V.24 circuit 114, EIA-232-D
382 pin 15.
383 xcrset Get transmit clock from receiver signal element timing (DCE
386 source) lead, CCITT V.24 circuit 115, EIA-232-D pin 17.
387 rcibrg Get receive clock from internal baud rate generator.
390 rctset Get receive clock from transmitter signal element timing
393 (DCE source) lead, CCITT V.24 circuit 114, EIA-232-D pin
394 15.
395 rcrset Get receive clock from receiver signal element timing (DCE
398 source) lead, CCITT V.24 circuit 115, EIA-232-D pin 17.
399 tsetcoff Transmitter signal element timing clock not provided.
402 tsetcrc Output receive clock on transmitter signal element timing
405 (DTE source) lead, CCITT V.24 circuit 113, EIA-232-D pin
406 24, clock source.
407 tsetcxc Output transmit clock on transmitter signal element timing
410 (DTE source) lead, CCITT V.24 circuit 113, EIA-232-D pin
411 24, clock source.
412 rsetcoff Receiver signal element timing clock not provided.
415 rsetcrc Output receive clock on receiver signal element timing (DTE
418 source) lead, CCITT V.24 circuit 128, no EIA-232-D pin,
419 clock source.
420 rsetcxc Output transmit clock on receiver signal element timing
423 (DTE source) lead, CCITT V.24 circuit 128, no EIA-232-D
424 pin, clock source.
425 Control Assignments
428 control-character c Set control-character to c, where control-char‐
429 acter is intr, quit, erase, kill, eof, eol,
430 eol2, swtch, start, stop, susp, dsusp, rprnt,
431 flush, werase, lnext min, ctab, time, or brk)
432 (ctab is used with -stappl; min and time are
433 used with -icanon; see termio(7I)). If c is pre‐
434 ceded by an (escaped from the shell) caret (^),
435 then the value used is the corresponding CTRL
436 character (for example, ``^d'' is a Control-d).
437 ``^?'' is interpreted as DEL and ``^−'' is
438 interpreted as undefined. For information on
439 SWTCH, see NOTES.
440 line i Set line discipline to i (0 < i < 127 ).
443 Combination Modes
446 evenp or parity Enable parenb and cs7.
447 -evenp, or -parity Disable parenb, and set cs8.
450 even (-even) Same as evenp (-evenp).
453 oddp Enable parenb, cs7, and parodd.
456 -oddp Disable parenb and parodd, and set cs8.
459 odd (-odd) Same as oddp (-oddp).
462 spacep Enable parenb, cs7, and parext.
465 -spacep Disable parenb and parext, and set cs8.
468 markp Enable parenb, cs7, parodd, and parext.
471 -markp Disable parenb, parodd, and parext, and set
474 cs8.
475 raw (-raw or cooked) Enable (disable) raw input and output (no
478 ERASE, KILL, INTR, QUIT, SWTCH, EOT, or output
479 post processing). For information on SWTCH, see
480 NOTES.
481 nl (-nl) Unset (set) icrnl, onlcr. In addition -nl
484 unsets inlcr, igncr, ocrnl, and onlret.
485 lcase (-lcase) Set (unset) xcase, iuclc, and olcuc.
488 LCASE (-LCASE) Same as lcase (-lcase).
491 tabs (-tabs or tab3) Preserve (expand to spaces) tabs when printing.
494 ek Reset ERASE and KILL characters back to normal
497 DEL and CTRL-u, respectively.
498 sane Reset all modes to some reasonable values.
501 term Set all modes suitable for the terminal type
504 term, where term is one of tty33, tty37, vt05,
505 tn300, ti700, or tek.
506 async Set normal asynchronous communications where
509 clock settings are xcibrg, rcibrg, tsetcoff
510 and rsetcoff.
511 litout (-litout) Disable (enable) parenb, istrip, and opost, and
514 set cs8 (cs7).
515 pass8 (-pass8) Disable (enable) parenb and istrip, and set cs8
518 (cs7).
519 crt Set options for a CRT (echoe, echoctl, and, if
522 >= 1200 baud, echoke.)
523 dec Set all modes suitable for Digital Equipment
526 Corp. operating systems users ERASE, KILL, and
527 INTR characters to ^?, ^U, and ^C, decctlq, and
528 crt.)
529 Window Size
532 rowsn Set window size to n rows.
533 columnsn Set window size to n columns.
536 colsn An alias for columns n.
539 ypixelsn Set vertical window size to n pixels.
542 xpixelsn Set horizontal window size to n pixels.
545
548 See attributes(5) for descriptions of the following attributes:
549 ┌─────────────────────────────┬─────────────────────────────┐
554 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
555 ├─────────────────────────────┼─────────────────────────────┤
556 │Availability │SUNWscpu │
557 └─────────────────────────────┴─────────────────────────────┘
558
560 tabs(1), ioctl(2), attributes(5), termio(7I), termiox(7I)
561
563 Solaris does not support any of the actions implied by swtch, which was
564 used by the sxt driver on System V release 4. Solaris allows the swtch
565 value to be set, and prints it out if set, but it does not perform the
566 swtch action.
567 The job switch functionality on Solaris is actually handled by job con‐
570 trol. susp is the correct setting for this.
571SunOS 5.11 14 Feb 2005 stty(1B)