stty(1) stty(1)NAME stty - set the modes for a terminal SYNOPSIS stty [-n file] [-a] [-g] [options] DESCRIPTION stty sets certain terminal I/O modes for the device that is the current standard input; without arguments, it reports the settings of certain modes. With the -n file flag option, stty opens the file specified by file with the option O_NODELAY and uses it as standard input. (This means that it will open modem-controlled lines immediately instead of waiting for a carrier.) With the -a flag option, stty reports all of the option set- tings. With the -g flag option, stty reports current settings in a form that can be used as an argument to another stty com- mand. Detailed information about the modes listed in the groups ``Control Modes'', ``Input Modes'', ``Output Modes'', ``Local Modes'', and ``Control Assignments'' may be found in termio(7). Flag options in the ``Combination Modes'' group are implemented by using options in any of those five groups. Note that many combinations of options make no sense, however, no checking is performed. The options are selected from the following: Control Modes parenb (-parenb) Enable (disable) parity generation and detection. parodd (-parodd) Select odd (even) parity. cs5 cs6 cs7 cs8 Select character size (see termio(7)). 0 Hang up phone line immediately. 50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb Set terminal baud to the number given, if possi- ble. (All speeds are not supported by all hardware interfaces; 9600 baud is assumed.) 19200 is equivalent to exta. 38400 is equivalent to extb. hupcl (-hupcl) April, 1990 1
stty(1) stty(1)Hang up (do not hang up) modem connection on last close. hup (-hup) Same as hupcl (-hupcl). cstopb (-cstopb) Use two (one) stop bits per character. cread (-cread) Enable (disable) the receiver. clocal (-clocal) Assume a line without (with) modem control. loblk (-loblk) Block (do not block) output from a noncurrent layer. Input Modes ignbrk (-ignbrk) Ignore (do not ignore) break on input. brkint (-brkint) Signal (do not signal) INTR on break. ignpar (-ignpar) Ignore (do not ignore) parity errors. parmrk (-parmrk) Mark (do not mark) parity errors (see termio(7)). inpck (-inpck) Enable (disable) input parity checking. istrip (-istrip) Strip (do not strip) input characters to seven bits. inlcr (-inlcr) Map (do not map) NL to CR on input. igncr (-igncr) Ignore (do not ignore) CR on input. icrnl (-icrnl) Map (do not map) CR to NL on input. iuclc (-iuclc) Map (do not map) uppercase alphabetics to lower- case on input. 2 April, 1990
stty(1) stty(1)ixon (-ixon) Enable (disable) START/STOP output control. Out- put is stopped by sending an ASCII DC3 and started by sending an ASCII DC1. ixany (-ixany) Allow any character (only DC1) to restart output. ixoff (-ixoff) Request that the system send (not send) START/STOP characters when the input queue is nearly empty/full. Output Modes opost (-opost) Post-process output (do not post-process output; ignore all other output modes). olcuc (-olcuc) Map (do not map) lowercase alphabetics to upper- case on output. onlcr (-onlcr) Map (do not map) NL to CR-NL on output. ocrnl (-ocrnl) Map (do not map) CR to NL on output. onocr (-onocr) Do not (do) output a CR at column zero. onlret (-onlret) On the terminal, NL performs (does not perform) the CR function. ofill (-ofill) Use fill characters (use timing) for delays. ofdel (-ofdel) Fill characters are DELs (NULs). cr0 cr1 cr2 cr3 Select style of delay for returns (see termio(7)). nl0 nl1 Select style of delay for linefeeds (see ter- mio(7)). tab0 tab1 tab2 tab3 Select style of delay for horizontal tabs (see termio(7)). bs0 bs1 Select style of delay for backspaces (see ter- April, 1990 3
stty(1) stty(1)mio(7)). ff0 ff1 Select style of delay for form-feeds (see ter- mio(7)). vt0 vt1 Select style of delay for vertical tabs (see ter- mio(7)). Local Modes isig (-isig) Enable (disable) the checking of characters against the special control characters INTR, QUIT, and SWTCH. icanon (-icanon) Enable (disable) canonical input (ERASE and KILL processing). xcase (-xcase) Canonical (unprocessed) upper/lower-case presenta- tion. echo (-echo) Echo back (do not echo back) every character typed. echoe (-echoe) Echo (do not echo) ERASE character as a backspace-space-backspace string. Note: This mode will erase the ERASEed character on many CRT terminals; however, it does not keep track of column position and, as a result, may be confusing on escaped characters, tabs, and backspaces. echok (-echok) Echo (do not echo) NL after KILL character. lfkc (-lfkc) Same as echok (-echok); obsolete. echonl (-echonl) Echo (do not echo) NL. noflsh (-noflsh) Disable (enable) flush after INTR, QUIT, or SWTCH. stwrap (-stwrap) Disable (enable) truncation of lines longer than 79 characters on a synchronous line. 4 April, 1990
stty(1) stty(1)stflush (-stflush) Enable (disable) flush on a synchronous line after every write(3). stappl (-stappl) Use application mode (use line mode) on a synchro- nous line. Control Assignments erase c Set erase character to c (by default, set to DELETE in the A/UX standard distribution). kill c Set kill character to c (by default, set to CONTROL-U in the A/UX standard distribution). intr c Set interrupt character to c (by default, set to CONTROL-C in the A/UX standard distribution). quit c Set quit character to c (by default, set to CONTROL-| in the A/UX standard distribution). swtch c Set switch character to c (by default, set to CONTROL-` in the A/UX standard distribution). eof c Set EOF character to c (by default, set to CONTROL-D in the A/UX standard distribution). eol c Set EOL character to c (by default, set to CONTROL-` in the A/UX standard distribution). min c Set min character to c (min is used only with - icanon; (see termio(7)). time c Set time character to c (time is used only with - icanon; (see termio(7)). If c is preceded by a circumflex (^) appropriately escaped from the shell, then the value used is the corresponding control character (for example, ^d is a CONTROL-D, ^? is interpreted as DELETE, and ^- is interpreted as undefined). line i Set line discipline to i (0 < i < 127 ). BSD 4.2 Compatible Features susp c Set the suspend character to c. When typed, the suspend character sends SIGTSTP to the current process group. dsusp c When set and a program attempts to read terminal input, SIGTSTP is sent to the current process group. April, 1990 5
stty(1) stty(1)tostop (-tostop) When set, background processes which write on the control tty will be stopped until brought into foreground by the shell. Combination Modes evenp or parity Enable parenb and cs7. oddp Enable parenb, cs7, and parodd. -parity, -evenp, or -oddp Disable parenb, and set cs8. raw (-raw or cooked) Enable (disable) raw input and output (no ERASE, KILL, INTR, QUIT, SWTCH, EOT, or output post pro- cessing). nl (-nl) Unset (set) icrnl and onlcr. In addition -nl un- sets inlcr, igncr, ocrnl, and onlret. lcase (-lcase) Set (unset) xcase, iuclc, and olcuc. LCASE (-LCASE) Same as lcase (-lcase). tabs (-tabs or tab3) Preserve (expand to spaces) tabs when printing. ek Reset ERASE and KILL characters back to normal DELETE and CONTROL-U. sane Reset all modes to some reasonable values. term Set all modes suitable for the terminal type term, where term is one of tty33, tty37, vt05, tn300, ti700, or tek. Hardware-specific Modes modem (-modem) Enable (disable) modem control for this device. Normally, this is only turned on for lines con- nected to modems. Such lines cannot be opened (see open(2)) unless the device's data carrier detect line (DCD) is asserted by an external dev- ice such as a modem. Not all devices support this option; refer to the specific device's documenta- tion for details. This option is on by default for /dev/modem and /dev/tty0. Since it uses the same signal line as dtrflow and emodem, these op- 6 April, 1990
stty(1) stty(1)tions cannot be used at the same time. emodem (-emodem) Enable (disable) ``European style'' modem control. Similar to modem, as described previously. Refer to termio(7) for further information. dtrflow (-dtrflow) hxctl (-hxctl) Enable hardware flow control for this device using the DCD line as input. This is normally used as a flow control with devices such as printers. Not all devices support this option; refer to the specific device's documentation for details. These options are on by default for /dev/printer and /dev/tty1. Since they use the same signal line as modem and emodem, dtrflow cannot be used at the same time as those options. Note that dtrflow and hxctl are synonymous and cannot be used at the same time. flow (-flow) Enable hardware flow control using the request to send and clear to send lines (RTS/CTS) on a serial device. Not all devices support this option; refer to the specific device's documentation for details. Often it is preferable and easier to use XON/XOFF (ixon, ixoff and ixany) which is support- ed for all devices. The hardware-specific modes all apply to modem control; not all devices support all or any of them. If any of them are supported, then UIOCTTSTAT is supported. The default mode is UIOCNOMODEM/UIOCNOFLOW. All these are ``remembered'' when a device is closed and reopened again. FILES /bin/stty SEE ALSO tabs(1), ioctl(2), termio(7). April, 1990 7