STTY(1) UNIX Programmer's Manual STTY(1) NAME stty - set terminal options SYNOPSIS stty [-a | -e] [-f _f_i_l_e] [operands] DESCRIPTION _S_t_t_y sets certain I/O options on the current output termi- nal, placing its output on the diagnostic output. With no argument, it reports the speed of the terminal and the set- tings of the options which are different from their defaults. The following options are available: -a Display everything _s_t_t_y knows. This has the same effect as using the operand all or everything. The distinction between all and everything has been removed. -e Same a -a above. -f Open and use the terminal named by _f_i_l_e rather than using standard output. The file is opened using the O_NONBLOCK flag of open(), making it possible to set or display settings on a terminal that might otherwise block on the open. The following operands are special: all Everything _s_t_t_y knows about is printed. everything Same as all above. flushout Flush the queues for the device. This is most useful when an exiting process is stuck waiting for terminal output to drain. speed The terminal speed alone is printed on the stan- dard output. size The terminal (window) sizes are printed on the standard output, first rows and then columns. _O_p_e_r_a_n_d_s are selected from the following: even allow even parity input -even disallow even parity input odd allow odd parity input -odd disallow odd parity input Printed 11/24/99 March 27, 1997 1 STTY(1) UNIX Programmer's Manual STTY(1) raw raw mode input (no input processing (erase, kill, interrupt, ...); parity bit passed back) -raw negate raw mode cooked same as `-raw' cbreak make each character available to _r_e_a_d(2) as received; no erase and kill processing, but all other processing (interrupt, suspend, ...) is per- formed -cbreak make characters available to _r_e_a_d only when new- line is received -nl allow carriage return for new-line, and output CR-LF for carriage return or new-line nl accept only new-line to end lines echo echo back every character typed -echo do not echo characters tandem enable inbound software (xon/xoff) flow control, so that the system sends out the stop character when its internal queue is in danger of overflow- ing on input, and sends the start character when it is ready to accept further input -tandem disable inbound software (xon/xoff) flow control -tabs replace tabs by spaces when printing tabs preserve tabs For the following commands which take a character argument _c, you may also specify _c as ``undef'', to set the value to be undefined. A value of ``^x'', a 2 character sequence, is also interpreted as a control character, with ``^?'' representing delete. erase _c set erase character to _c (default `#', but often reset to ^H.) kill _c set kill character to _c (default `@', but often reset to ^U.) intr _c set interrupt character to _c (default DEL or ^? (delete), but often reset to ^C.) quit _c set quit character to _c (default control \.) start _c set start character to _c (default control Q.) stop _c set stop character to _c (default control S.) eof _c set end of file character to _c (default control D.) brk _c set break character to _c (default undefined.) This character is an additional character causing wakeup. dec set all modes suitable for Digital Equipment Corp. operating systems users; (erase, kill, and Printed 11/24/99 March 27, 1997 2 STTY(1) UNIX Programmer's Manual STTY(1) interrupt characters to ^?, ^U, and ^C, decctlq and ``newcrt''.) 0 hang up phone line immediately 50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb Set terminal baud rate to the number given, if possible. (These are the speeds supported by the DH-11 interface). rows _n The terminal size is recorded as having _n rows. columns _n The terminal size is recorded as having _n columns. cols _n is an alias for _c_o_l_u_m_n_s. A teletype driver which supports the job control processing of _c_s_h(1) and more functionality than the basic driver is fully described in _t_t_y(4). The following options apply only to it. new Use new driver (switching flushes typeahead). crt Set options for a CRT (crtbs, ctlecho and, if >= 1200 baud, crterase and crtkill.) crtbs Echo backspaces on erase characters. prterase For printing terminal echo erased characters back- wards within ``\'' and ``/''. crterase Wipe out erased characters with ``backspace- space-backspace.'' -crterase Leave erased characters visible; just backspace. crtkill Wipe out input on like kill ala crterase. -crtkill Just echo line kill character and a newline on line kill. ctlecho Echo control characters as ``^_x'' (and delete as ``^?''.) Print two backspaces following the EOT character (control D). -ctlecho Control characters echo as themselves; in cooked mode EOT (control-D) is not echoed. decctlq After output is suspended (normally by ^S), only a start character (normally ^Q) will restart it. This is compatible with DEC's vendor supplied sys- tems. -decctlq After output is suspended, any character typed will restart it; the start character will restart output without providing any input. (This is the default.) Printed 11/24/99 March 27, 1997 3 STTY(1) UNIX Programmer's Manual STTY(1) tostop Background jobs stop if they attempt terminal out- put. -tostop Output from background jobs to the terminal is allowed. flusho Output is being discarded usually because user hit control O (internal state bit). -flusho Output is not being discarded. pendin Input is pending after a switch from cbreak to cooked and will be re-input when a read becomes pending or more input arrives (internal state bit). -pendin Input is not pending. pass8 Passes all 8 bits through on input, in any mode. -pass8 Strips the 0200 bit on input except in raw mode. mdmbuf Start/stop output on carrier transitions (not implemented). -mdmbuf Return error if write attempted after carrier drops. litout Send output characters without any processing. -litout Do normal output processing, inserting delays, etc. nohang Don't send hangup signal if carrier drops. -nohang Send hangup signal to control process group when carrier drops. The following special characters are applicable only to the new teletype driver and are not normally changed. susp _c set suspend process character to _c (default con- trol Z). dsusp _c set delayed suspend process character to _c (default control Y). rprnt _c set reprint line character to _c (default control R). flush _c set flush output character to _c (default control O). werase _c set word erase character to _c (default control W). lnext _c set literal next character to _c (default control V). Modem Control Status: These display the current state of modem control. They are only displayed for actual tty lines and not for pseudo tty lines (more precisely, it is only displayed for lines which support the TIOCMGET ioctl. See tty(4). Printed 11/24/99 March 27, 1997 4 STTY(1) UNIX Programmer's Manual STTY(1) While it is possible to change the state of the modem con- trol lines, the hardware or other software may prevent the change from actually taking place, or may cause the state to immediately revert to the original state. dcd (-dcd) State of Data Carrier Detect. dsr (-dsr) State of Data Set Ready. dtr (-dtr) State of Data Terminal Ready. cts (-cts) State of Clear To Send. rts (-rts) State of Request To Send. SEE ALSO ioctl(2), tabs(1), tset(1), tty(4) Printed 11/24/99 March 27, 1997 5