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