stty.1 (9566B)
1 '\" t 2 .\" Parts taken from stty(1), Unix 7th edition: 3 .\" Copyright(C) Caldera International Inc. 2001-2002. All rights reserved. 4 .\" 5 .\" Redistribution and use in source and binary forms, with or without 6 .\" modification, are permitted provided that the following conditions 7 .\" are met: 8 .\" Redistributions of source code and documentation must retain the 9 .\" above copyright notice, this list of conditions and the following 10 .\" disclaimer. 11 .\" Redistributions in binary form must reproduce the above copyright 12 .\" notice, this list of conditions and the following disclaimer in the 13 .\" documentation and/or other materials provided with the distribution. 14 .\" All advertising materials mentioning features or use of this software 15 .\" must display the following acknowledgement: 16 .\" This product includes software developed or owned by Caldera 17 .\" International, Inc. 18 .\" Neither the name of Caldera International, Inc. nor the names of 19 .\" other contributors may be used to endorse or promote products 20 .\" derived from this software without specific prior written permission. 21 .\" 22 .\" USE OF THE SOFTWARE PROVIDED FOR UNDER THIS LICENSE BY CALDERA 23 .\" INTERNATIONAL, INC. AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR 24 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 25 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 26 .\" ARE DISCLAIMED. IN NO EVENT SHALL CALDERA INTERNATIONAL, INC. BE 27 .\" LIABLE FOR ANY DIRECT, INDIRECT INCIDENTAL, SPECIAL, EXEMPLARY, OR 28 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 29 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR 30 .\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 31 .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 32 .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 33 .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 34 .TH STTY 1 "7/15/04" "Heirloom Toolchest" "User Commands" 35 .SH NAME 36 stty \- set the options for a terminal 37 .SH SYNOPSIS 38 \fBstty\fR [\fB\-a\fR] [\fB\-g\fR] [\fIoptions\fR] 39 .SH DESCRIPTION 40 .I Stty 41 sets certain I/O options on the terminal 42 currently associated with standard input. 43 With no argument, it reports the current settings of selected options; 44 the 45 .B \-a 46 flag 47 causes it to report all options. 48 With the 49 .B \-g 50 flag, 51 .I stty 52 prints all settings in a form 53 that can be passed to it again 54 to restore the current settings. 55 .PP 56 The option strings are 57 selected from the following set; 58 where an option is shown prefixed by `[\-]', 59 it can be negated as described in the text. 60 .PP 61 Control modes: 62 .PP 63 .TS 64 l1w(16n) l. 65 [\fB\-\fR]\fBparenb\fR enable (disable) parity bits 66 [\fB\-\fR]\fBparodd\fR select odd (even) parity 67 \fBcs5 cs6 cs7 cs8\fR set character size 68 [\fB\-\fR]\fBcstopb\fR use two (one) stop bits per character\ \ \ \ \ \ 69 [\fB\-\fR]\fBclocal\fR line has (no) modem control 70 [\fB\-\fR]\fBhupcl\fR T{ 71 hang up (do not hang up) dataphone on last close 72 T} 73 [\fB\-\fR]\fBhup\fR same as \fIhupcl\fR 74 \fB0\fR hang up phone line immediately 75 T{ 76 .in 2n 77 .ti 0 78 .ad l 79 \fB50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 80 19200 38400 exta extb\fR 81 .in 0 82 .ad b 83 T} T{ 84 Set terminal baud rate to the number given, if possible 85 (not all terminals support all rates). 86 T} 87 .TE 88 .PP 89 Input modes: 90 .PP 91 .TS 92 l1w(16n) l. 93 [\fB\-\fR]\fBignbrk\fR ignore (respect) break character\ \ \ \ \ \ \ \ \ \ \ 94 [\fB\-\fR]\fBbrkint\fR (do not) send interrupt on break 95 [\fB\-\fR]\fBignpar\fR (do not) ignore parity errors 96 [\fB\-\fR]\fBparmrk\fR (do not) mark parity errors 97 [\fB\-\fR]\fBinpck\fR enable (disable) parity checking 98 [\fB\-\fR]\fBistrip\fR T{ 99 (do not) strip characters to 7 bits 100 T} 101 [\fB\-\fR]\fBinlcr\fR (do not) map NL to CR 102 [\fB\-\fR]\fBigncr\fR (do not) ignore CR 103 [\fB\-\fR]\fBicrnl\fR (do not) map CR to NL 104 [\fB\-\fR]\fBiuclc\fR (do not) map upper to lower case 105 [\fB\-\fR]\fBixon\fR enable start/stop control 106 [\fB\-\fR]\fBixany\fR any character (DC1 only) restarts output 107 [\fB\-\fR]\fBixoff\fR T{ 108 (do not) send start/stop characters 109 when the input queue is nearly full 110 T} 111 [\fB\-\fR]\fBimaxbel\fR T{ 112 (do not) ring the bell when running out of input buffers 113 T} 114 [\fB\-\fR]\fBiutf8\fR (do not) handle input as UTF-8 115 .TE 116 .PP 117 Output modes: 118 .PP 119 .TS 120 l1w(16n) l. 121 [\fB\-\fR]\fBopost\fR enable (disable) output processing\ \ \ \ \ \ \ \ \ 122 [\fB\-\fR]\fBolcuc\fR (do not) map upper to lower case 123 [\fB\-\fR]\fBonlcr\fR (do not) map NL to CR 124 [\fB\-\fR]\fBonocr\fR (do not) ignore CR 125 [\fB\-\fR]\fBonlret\fR NL is (not) return 126 [\fB\-\fR]\fBofill\fR (do not) use fill characters 127 [\fB\-\fR]\fBofdel\fR fill character is DEL (NUL) 128 \fBcr0 cr1 cr2 cr3\fR T{ 129 select style of delay for carriage return (see \fItermio\fR(3)) 130 T} 131 \fBnl0 nl1 nl2 nl3\fR select style of delay for linefeed 132 T{ 133 .in 2n 134 .ti 0 135 .ad l 136 \fBtab0 tab1 tab2 tab3\fR 137 .in 0 138 .ad b 139 T} select style of delay for tab 140 \fBff0 ff1\fR select style of delay for form feed 141 \fBbs0 bs1\fR select style of delay for backspace 142 \fBvt0 bt1\fR select style of delay for vertical tab 143 .TE 144 .PP 145 Local modes: 146 .PP 147 .TS 148 l1w(16n) l. 149 [\fB\-\fR]\fBisig\fR T{ 150 enable (disable) intr, quit, and susp processing 151 T} 152 [\fB\-\fR]\fBicanon\fR enable (disable) erase and kill processing\ 153 [\fB\-\fR]\fBxcase\fR (no) canonical case presentation 154 [\fB\-\fR]\fBecho\fR (do not) echo every character typed 155 [\fB\-\fR]\fBechoe\fR (do not) echo erase character as `^H ^H' 156 [\fB\-\fR]\fBechok\fR (do not) echo NL after kill character 157 [\fB\-\fR]\fBechonl\fR (do not) echo NL regardless of \fIecho\fR 158 [\fB\-\fR]\fBnoflsh\fR (do not) flush after intr, quit, and susp 159 [\fB\-\fR]\fBtostop\fR send SIGTTOU for background output 160 [\fB\-\fR]\fBechoctl\fR T{ 161 (no) visual representation of control characters 162 T} 163 [\fB\-\fR]\fBechoprt\fR (do not) echo erased characters 164 [\fB\-\fR]\fBechoke\fR T{ 165 (do not) print `^H ^H' sequences at line erase 166 T} 167 [\fB\-\fR]\fBflusho\fR output is (not) flushed 168 [\fB\-\fR]\fBpendin\fR (do not) retype pending input 169 [\fB\-\fR]\fBiexten\fR T{ 170 enable (disable) extended control characters 171 T} 172 .TE 173 .PP 174 Control characters: 175 .PP 176 .TS 177 l1w(16n) l. 178 \fBintr \fIc\fP\fR set intr character to \fIc\fR. 179 \fBquit \fIc\fP\fR set quit character to \fIc\fR. 180 \fBerase \fIc\fP\fR set erase character to \fIc\fR. 181 \fBkill \fIc\fP\fR set kill character to \fIc\fR. 182 \fBeof \fIc\fP\fR set eof character to \fIc\fR. 183 \fBeol \fIc\fP\fR set eol character to \fIc\fR. 184 \fBeol2 \fIc\fP\fR set eol2 character to \fIc\fR. 185 \fBswtch \fIc\fP\fR set swtch character to \fIc\fR. 186 \fBstart \fIc\fP\fR set start character to \fIc\fR. 187 \fBstop \fIc\fP\fR set stop character to \fIc\fR. 188 \fBsusp \fIc\fP\fR set susp character to \fIc\fR. 189 \fBdsusp \fIc\fP\fR set dsusp character to \fIc\fR. 190 \fBrprnt \fIc\fP\fR set rprnt character to \fIc\fR. 191 \fBflush \fIc\fP\fR set flush character to \fIc\fR. 192 \fBwerase \fIc\fP\fR set werase character to \fIc\fR. 193 \fBlnext \fIc\fP\fR set lnext character to \fIc\fR. 194 .TE 195 .PP 196 A control character may be either given as a literal character, 197 or as `\fB^\fIc\fR' for ASCII control characters CTRL-\fIc\fR; 198 the special values `\fB^\-\fR' and `\fBundef\fR' 199 disable the control function. 200 Multibyte characters cannot be used as control characters; 201 trying to do so will result in the control character 202 set to the first byte of the multibyte character sequence, 203 which has the undesired effect of applying the control function 204 to more characters than the one supplied. 205 .PP 206 Combination modes et cetera: 207 .PP 208 .TS 209 l1w(16n) l. 210 [\fB\-\fR]\fBraw\fR T{ 211 (no) raw mode input 212 (i.\|e. no erase, kill, interrupt, quit, EOT; parity bit passed back) 213 T} 214 \fBcooked\fR same as \fI\-raw\fR\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 215 \fBsane\fR reset all values to defaults 216 [\fB\-\fR]\fBcbreak\fR T{ 217 make each character available to \fIread\fR(2) 218 as received; no erase and kill 219 (make characters available to \fIread\fR 220 only when newline is received) 221 T} 222 [\fB\-\fR]\fBoddp\fR allow (disallow) odd parity 223 [\fB\-\fR]\fBevenp\fR allow (disallow) even parity 224 [\fB\-\fR]\fBnl\fR T{ 225 accept only new-line to end lines 226 (allow carriage return for new-line, 227 and output CR-LF for carriage return or new-line) 228 T} 229 [\fB\-\fR]\fBlcase\fR T{ 230 (do not) map upper case to lower case 231 T} 232 [\fB\-\fR]\fBLCASE\fR T{ 233 same as \fIlcase\fR 234 T} 235 [\fB\-\fR]\fBtabs\fR T{ 236 (do not) replace tabs by spaces when printing 237 T} 238 \fBnul-fill\fR use NUL to fill output 239 \fBdel-fill\fR use DEL to fill output 240 [\fB\-\fR]\fBfill\fR T{ 241 select NUL-filled output (disable output filling) 242 T} 243 \fBek\fR T{ 244 reset erase and kill characters back to normal ^H and ^U 245 T} 246 \fBtty33\fR T{ 247 set all modes suitable for the 248 Teletype Corporation Model 33 terminal. 249 T} 250 \fBtty37\fR T{ 251 set all modes suitable for the 252 Teletype Corporation Model 37 terminal. 253 T} 254 \fBvt05\fR T{ 255 set all modes suitable for Digital Equipment Corp. VT05 terminal 256 T} 257 \fBtn300\fR T{ 258 set all modes suitable for a General Electric TermiNet 300 259 T} 260 \fBti700\fR T{ 261 set all modes suitable for Texas Instruments 700 series terminal 262 T} 263 \fBtek\fR T{ 264 set all modes suitable for Tektronix 4014 terminal 265 T} 266 \fBmin\fR T{ 267 minimal number of bytes for non-canonical input 268 T} 269 \fBtime\fR timeout for non-canonical input 270 \fBrows\fR T{ 271 set the height of the terminal in character cell units 272 T} 273 \fBcolumns\fR T{ 274 set the width of the terminal in character cell units 275 T} 276 \fBypixels\fR T{ 277 set the height of the terminal in pixels 278 T} 279 \fBxpixels\fR T{ 280 set the width of the terminal in pixels 281 T} 282 .TE 283 .SH "ENVIRONMENT VARIABLES" 284 .TP 285 .B SYSV3 286 Affects the default and 287 .B \-a 288 output formats. 289 .SH "SEE ALSO" 290 termios(3), 291 tabs(1) 292 .SH NOTES 293 Not all settings are available on all platforms.