STTY(1) UNIX Reference Manual STTY(1) NNAAMMEE ssttttyy - Set the options for a terminal. SSYYNNOOPPSSIISS ssttttyy [--aa | --gg] ssttttyy [arguments] DDEESSCCRRIIPPTTIIOONN The stty utility sets or reports on terminal I/O characteristics for the device that is its standard input. Without options or arguments speci- fied, it reports the settings of certain characteristics, usually those that differ from implementation-defined defaults. Otherwise it modifies the terminal state according to the specified arguments. Some combina- tions of arguments are mutually exclusive on some terminal types. The following options are available: --aa Write to standard output all the current settings for the terminal. --gg Write to standard output the current settings in an unspecified form that can be used as arguments to another stty utility on the same system. The following arguments are available to set the terminal characteris- tics: ppaarreennbb (--ppaarreennbb) Enable (disable) parity generation and detection. ppaarroodddd (--ppaarroodddd) Select odd (even) parity. ccss55 ccss66 ccss77 ccss88 Select character size, if possible. _n_u_m_b_e_r Set terminal baud rate to the number given, if possible. If the baud rate is set to zero, modem control is no longer as- serted. iissppeeeedd _n_u_m_b_e_r Set terminal input baud rate to the number given, if possible. If the input baud rate is set to zero, the input baud rate is set to the value of the output baud rate. oossppeeeedd _n_u_m_b_e_r Set terminal output baud rate to the number given, if possible. If the output baud rate is set to zero, modem control is no longer asserted. hhuuppccll (--hhuuppccll) Stop asserting modem control (do not stop asserting modem control) on last close. hhuupp (--hhuupp) Same as hupcl (--hhuuppccll)).. ccssttooppbb (--ccssttooppbb) Use two (one) stop bits per character. ccrreeaadd (--ccrreeaadd) Enable (disable) the receiver. ccllooccaall (--ccllooccaall) Assume a line without (with) modem control. iiggnnbbrrkk (--iiggnnbbrrkk) Ignore (do not ignore) break on input. bbrrkkiinntt (--bbrrkkiinntt) Signal (do not signal) INTR on break. iiggnnppaarr (--iiggnnppaarr) Ignore (do not ignore) parity errors. ppaarrmmrrkk (--ppaarrmmrrkk) Mark (do not mark) parity errors. iinnppcckk (--iinnppcckk) Enable (disable) input parity checking. iissttrriipp (--iissttrriipp) Strip (do not strip) input characters to seven bits. iinnllccrr (--iinnllccrr) Map (do not map) NL to CR on input. iiggnnccrr (--iiggnnccrr) Ignore (do not ignore) CR on input. iiccrrnnll (--iiccrrnnll) Map (do not map) CR to NL on input. iixxoonn (--iixxoonn) Enable (disable) START/STOP output control. Output from the system is stopped when the system receives STOP and started when the system receives START. iixxooffff (--iixxooffff) Request that the system send (not send) START/STOP characters when the input queue is nearly empty/full. ooppoosstt (--ooppoosstt) Post-process output (do not post-process output; ignore all other output modes). iissiigg (--iissiigg) Enable (disable) the checking of characters against the special control characters INTR, QUIT, and SUSP. iiccaannoonn (--iiccaannoonn) Enable (disable) canonical input (ERASE and KILL processing). iieexxtteenn (--iieexxtteenn) Enable (disable) any implementation defined special control characters not currently controlled by icanon, isig, or ixon. eecchhoo (--eecchhoo) Echo back (do not echo back) every character typed. eecchhooee (--eecchhooee) The ERASE character shall (shall not) visually erase the last character in the current line from the display, if possible. eecchhookk (--eecchhookk) Echo (do not echo) NL after KILL character. eecchhoonnll (--eecchhoonnll) Echo (do not echo) NL, even if echo is disabled. nnooffllsshh (--nnooffllsshh) Disable (enable) flush after INTR, QUIT, SUSP. ccoonnttrrooll--cchhaarraacctteerr _s_t_r_i_n_g Set control-character to string. If string is a single character, the control character is set to that character. If string is the two character sequence "^-" or the string "undef" the control character is set to {_POSIX_VDISABLE} if it is in effect for the device; if {_POSIX_VDISABLE} is not in effect for the device, it is an error. Recognized control-characters: control- POSIX.1 character Subscript Description _________ _________ _______________ eof VEOF EOF character eol VEOL EOL character erase VERASE ERASE character intr VINTR INTR character kill VKILL KILL character quit VQUIT QUIT character susp VSUSP SUSP character start VSTART START character stop VSTOP STOP character ssaavveedd sseettttiinnggss Set the current terminal characteristics to the saved settings produced by the -g option. mmiinn _n_u_m_b_e_r time number Set the value of min or time to number. MIN and TIME are used in Non-Canonical mode input processing (-icanon). eevveennpp or ppaarriittyy Enable parenb and cs7; disable parodd. ooddddpp Enable parenb, cs7, and parodd. --ppaarriittyy, --eevveennpp, --ooddddpp Disable parenb, and set cs8. nnll (--nnll) Enable (disable) icrnl. In addition -nl unsets inlcr and igncr. eekk Reset ERASE and KILL characters back to system defaults. ssaannee Resets all modes to some reasonable, unspecified, values. If the -g option is specified, stty writes to standard output the current settings in a form that can be used as arguments to another instance of stty on the same system. If the -a option is specified, all of the information as described in ar- guments is written to standard output. Unless otherwise specified, this information shall be displayed as <space>-separated tokens in an unspeci- fied format, on one or more lines, with an unspecified number of tokens per line. Additional information may be displayed as well. If no options are specified, an unspecified subset of the information displayed for the -a option is displayed. If the terminal input speed and output speed are the same, the speed in- formation is displayed as follows: "speed %d baud;", <speed> Otherwise speeds are displayed as: "ispeed %d baud; ospeed %d baud;", <ispeed>, <ospeed> Control characters are displayed as: "%s = %s;", <control-character name>, <value> where value is either the character, or some visual representation of the character if it is non-printing, or the string "<undef>" if the character is disabled. The ssttttyy utility exits with one of the following values: 0 The terminal options were read or set successfully. >0 An error occurred. SSEEEE AALLSSOO stty(4) SSTTAANNDDAARRDDSS The ssttttyy function is expected to be POSIX 1003.2 compatible.