raw/man1/stty.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.022.
   2 .TH STTY "1" "October 2003" "GNU coreutils 5.0" FSF
   3 .SH NAME
   4 stty \- change and print terminal line settings
   5 .SH SYNOPSIS
   6 .B stty
   7 [\fI-F DEVICE\fR] [\fI--file=DEVICE\fR] [\fISETTING\fR]...
   8 .br
   9 .B stty
  10 [\fI-F DEVICE\fR] [\fI--file=DEVICE\fR] [\fI-a|--all\fR]
  11 .br
  12 .B stty
  13 [\fI-F DEVICE\fR] [\fI--file=DEVICE\fR] [\fI-g|--save\fR]
  14 .SH DESCRIPTION
  15 .\" Add any additional description here
  16 .PP
  17 Print or change terminal characteristics.
  18 .TP
  19 \fB\-a\fR, \fB\-\-all\fR
  20 print all current settings in human-readable form
  21 .TP
  22 \fB\-g\fR, \fB\-\-save\fR
  23 print all current settings in a stty-readable form
  24 .TP
  25 \fB\-F\fR, \fB\-\-file\fR=\fIDEVICE\fR
  26 open and use the specified DEVICE instead of stdin
  27 .TP
  28 \fB\-\-help\fR
  29 display this help and exit
  30 .TP
  31 \fB\-\-version\fR
  32 output version information and exit
  33 .PP
  34 Optional - before SETTING indicates negation.  An * marks non-POSIX
  35 settings.  The underlying system defines which settings are available.
  36 .SS "Special characters:"
  37 .TP
  38 * dsusp CHAR
  39 CHAR will send a terminal stop signal once input flushed
  40 .TP
  41 eof CHAR
  42 CHAR will send an end of file (terminate the input)
  43 .TP
  44 eol CHAR
  45 CHAR will end the line
  46 .TP
  47 * eol2 CHAR
  48 alternate CHAR for ending the line
  49 .TP
  50 erase CHAR
  51 CHAR will erase the last character typed
  52 .TP
  53 intr CHAR
  54 CHAR will send an interrupt signal
  55 .TP
  56 kill CHAR
  57 CHAR will erase the current line
  58 .TP
  59 * lnext CHAR
  60 CHAR will enter the next character quoted
  61 .TP
  62 quit CHAR
  63 CHAR will send a quit signal
  64 .TP
  65 * rprnt CHAR
  66 CHAR will redraw the current line
  67 .TP
  68 start CHAR
  69 CHAR will restart the output after stopping it
  70 .TP
  71 stop CHAR
  72 CHAR will stop the output
  73 .TP
  74 susp CHAR
  75 CHAR will send a terminal stop signal
  76 .TP
  77 * swtch CHAR
  78 CHAR will switch to a different shell layer
  79 .TP
  80 * werase CHAR
  81 CHAR will erase the last word typed
  82 .SS "Special settings:"
  83 .TP
  84 N
  85 set the input and output speeds to N bauds
  86 .TP
  87 * cols N
  88 tell the kernel that the terminal has N columns
  89 .TP
  90 * columns N
  91 same as cols N
  92 .TP
  93 ispeed N
  94 set the input speed to N
  95 .TP
  96 * line N
  97 use line discipline N
  98 .TP
  99 min N
 100 with \fB\-icanon\fR, set N characters minimum for a completed read
 101 .TP
 102 ospeed N
 103 set the output speed to N
 104 .TP
 105 * rows N
 106 tell the kernel that the terminal has N rows
 107 .TP
 108 * size
 109 print the number of rows and columns according to the kernel
 110 .TP
 111 speed
 112 print the terminal speed
 113 .TP
 114 time N
 115 with \fB\-icanon\fR, set read timeout of N tenths of a second
 116 .SS "Control settings:"
 117 .TP
 118 [-]clocal
 119 disable modem control signals
 120 .TP
 121 [-]cread
 122 allow input to be received
 123 .TP
 124 * [-]crtscts
 125 enable RTS/CTS handshaking
 126 .TP
 127 csN
 128 set character size to N bits, N in [5..8]
 129 .TP
 130 [-]cstopb
 131 use two stop bits per character (one with `-')
 132 .TP
 133 [-]hup
 134 send a hangup signal when the last process closes the tty
 135 .TP
 136 [-]hupcl
 137 same as [-]hup
 138 .TP
 139 [-]parenb
 140 generate parity bit in output and expect parity bit in input
 141 .TP
 142 [-]parodd
 143 set odd parity (even with `-')
 144 .SS "Input settings:"
 145 .TP
 146 [-]brkint
 147 breaks cause an interrupt signal
 148 .TP
 149 [-]icrnl
 150 translate carriage return to newline
 151 .TP
 152 [-]ignbrk
 153 ignore break characters
 154 .TP
 155 [-]igncr
 156 ignore carriage return
 157 .TP
 158 [-]ignpar
 159 ignore characters with parity errors
 160 .TP
 161 * [-]imaxbel
 162 beep and do not flush a full input buffer on a character
 163 .TP
 164 [-]inlcr
 165 translate newline to carriage return
 166 .TP
 167 [-]inpck
 168 enable input parity checking
 169 .TP
 170 [-]istrip
 171 clear high (8th) bit of input characters
 172 .TP
 173 * [-]iuclc
 174 translate uppercase characters to lowercase
 175 .TP
 176 * [-]ixany
 177 let any character restart output, not only start character
 178 .TP
 179 [-]ixoff
 180 enable sending of start/stop characters
 181 .TP
 182 [-]ixon
 183 enable XON/XOFF flow control
 184 .TP
 185 [-]parmrk
 186 mark parity errors (with a 255-0-character sequence)
 187 .TP
 188 [-]tandem
 189 same as [-]ixoff
 190 .SS "Output settings:"
 191 .TP
 192 * bsN
 193 backspace delay style, N in [0..1]
 194 .TP
 195 * crN
 196 carriage return delay style, N in [0..3]
 197 .TP
 198 * ffN
 199 form feed delay style, N in [0..1]
 200 .TP
 201 * nlN
 202 newline delay style, N in [0..1]
 203 .TP
 204 * [-]ocrnl
 205 translate carriage return to newline
 206 .TP
 207 * [-]ofdel
 208 use delete characters for fill instead of null characters
 209 .TP
 210 * [-]ofill
 211 use fill (padding) characters instead of timing for delays
 212 .TP
 213 * [-]olcuc
 214 translate lowercase characters to uppercase
 215 .TP
 216 * [-]onlcr
 217 translate newline to carriage return-newline
 218 .TP
 219 * [-]onlret
 220 newline performs a carriage return
 221 .TP
 222 * [-]onocr
 223 do not print carriage returns in the first column
 224 .TP
 225 [-]opost
 226 postprocess output
 227 .TP
 228 * tabN
 229 horizontal tab delay style, N in [0..3]
 230 .TP
 231 * tabs
 232 same as tab0
 233 .TP
 234 * \fB\-tabs\fR
 235 same as tab3
 236 .TP
 237 * vtN
 238 vertical tab delay style, N in [0..1]
 239 .SS "Local settings:"
 240 .TP
 241 [-]crterase
 242 echo erase characters as backspace-space-backspace
 243 .TP
 244 * crtkill
 245 kill all line by obeying the echoprt and echoe settings
 246 .TP
 247 * \fB\-crtkill\fR
 248 kill all line by obeying the echoctl and echok settings
 249 .TP
 250 * [-]ctlecho
 251 echo control characters in hat notation (`^c')
 252 .TP
 253 [-]echo
 254 echo input characters
 255 .TP
 256 * [-]echoctl
 257 same as [-]ctlecho
 258 .TP
 259 [-]echoe
 260 same as [-]crterase
 261 .TP
 262 [-]echok
 263 echo a newline after a kill character
 264 .TP
 265 * [-]echoke
 266 same as [-]crtkill
 267 .TP
 268 [-]echonl
 269 echo newline even if not echoing other characters
 270 .TP
 271 * [-]echoprt
 272 echo erased characters backward, between `\e' and '/'
 273 .TP
 274 [-]icanon
 275 enable erase, kill, werase, and rprnt special characters
 276 .TP
 277 [-]iexten
 278 enable non-POSIX special characters
 279 .TP
 280 [-]isig
 281 enable interrupt, quit, and suspend special characters
 282 .TP
 283 [-]noflsh
 284 disable flushing after interrupt and quit special characters
 285 .TP
 286 * [-]prterase
 287 same as [-]echoprt
 288 .TP
 289 * [-]tostop
 290 stop background jobs that try to write to the terminal
 291 .TP
 292 * [-]xcase
 293 with icanon, escape with `\e' for uppercase characters
 294 .SS "Combination settings:"
 295 .TP
 296 * [-]LCASE
 297 same as [-]lcase
 298 .TP
 299 cbreak
 300 same as \fB\-icanon\fR
 301 .TP
 302 \fB\-cbreak\fR
 303 same as icanon
 304 .TP
 305 cooked
 306 same as brkint ignpar istrip icrnl ixon opost isig
 307 icanon, eof and eol characters to their default values
 308 .TP
 309 \fB\-cooked\fR
 310 same as raw
 311 .TP
 312 crt
 313 same as echoe echoctl echoke
 314 .TP
 315 dec
 316 same as echoe echoctl echoke \fB\-ixany\fR intr ^c erase 0177
 317 kill ^u
 318 .TP
 319 * [-]decctlq
 320 same as [-]ixany
 321 .TP
 322 ek
 323 erase and kill characters to their default values
 324 .TP
 325 evenp
 326 same as parenb \fB\-parodd\fR cs7
 327 .TP
 328 \fB\-evenp\fR
 329 same as \fB\-parenb\fR cs8
 330 .TP
 331 * [-]lcase
 332 same as xcase iuclc olcuc
 333 .TP
 334 litout
 335 same as \fB\-parenb\fR \fB\-istrip\fR \fB\-opost\fR cs8
 336 .TP
 337 \fB\-litout\fR
 338 same as parenb istrip opost cs7
 339 .TP
 340 nl
 341 same as \fB\-icrnl\fR \fB\-onlcr\fR
 342 .TP
 343 \fB\-nl\fR
 344 same as icrnl \fB\-inlcr\fR \fB\-igncr\fR onlcr \fB\-ocrnl\fR \fB\-onlret\fR
 345 .TP
 346 oddp
 347 same as parenb parodd cs7
 348 .TP
 349 \fB\-oddp\fR
 350 same as \fB\-parenb\fR cs8
 351 .TP
 352 [-]parity
 353 same as [-]evenp
 354 .TP
 355 pass8
 356 same as \fB\-parenb\fR \fB\-istrip\fR cs8
 357 .TP
 358 \fB\-pass8\fR
 359 same as parenb istrip cs7
 360 .TP
 361 raw
 362 same as \fB\-ignbrk\fR \fB\-brkint\fR \fB\-ignpar\fR \fB\-parmrk\fR \fB\-inpck\fR \fB\-istrip\fR
 363 \fB\-inlcr\fR \fB\-igncr\fR \fB\-icrnl\fR  \fB\-ixon\fR  \fB\-ixoff\fR  \fB\-iuclc\fR  \fB\-ixany\fR
 364 \fB\-imaxbel\fR \fB\-opost\fR \fB\-isig\fR \fB\-icanon\fR \fB\-xcase\fR min 1 time 0
 365 .TP
 366 \fB\-raw\fR
 367 same as cooked
 368 .TP
 369 sane
 370 same as cread \fB\-ignbrk\fR brkint \fB\-inlcr\fR \fB\-igncr\fR icrnl
 371 \fB\-ixoff\fR \fB\-iuclc\fR \fB\-ixany\fR imaxbel opost \fB\-olcuc\fR \fB\-ocrnl\fR onlcr
 372 \fB\-onocr\fR \fB\-onlret\fR \fB\-ofill\fR \fB\-ofdel\fR nl0 cr0 tab0 bs0 vt0 ff0
 373 isig icanon iexten echo echoe echok \fB\-echonl\fR \fB\-noflsh\fR
 374 \fB\-xcase\fR \fB\-tostop\fR \fB\-echoprt\fR echoctl echoke, all special
 375 characters to their default values.
 376 .PP
 377 Handle the tty line connected to standard input.  Without arguments,
 378 prints baud rate, line discipline, and deviations from stty sane.  In
 379 settings, CHAR is taken literally, or coded as in ^c, 0x37, 0177 or
 380 127; special values ^- or undef used to disable special characters.
 381 .SH AUTHOR
 382 Written by David MacKenzie.
 383 .SH "REPORTING BUGS"
 384 Report bugs to <bug-coreutils@gnu.org>.
 385 .SH COPYRIGHT
 386 Copyright \(co 2003 Free Software Foundation, Inc.
 387 .br
 388 This is free software; see the source for copying conditions.  There is NO
 389 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 390 .SH "SEE ALSO"
 391 The full documentation for
 392 .B stty
 393 is maintained as a Texinfo manual.  If the
 394 .B info
 395 and
 396 .B stty
 397 programs are properly installed at your site, the command
 398 .IP
 399 .B info stty
 400 .PP
 401 should give you access to the complete manual.