original/man1/stty.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH STTY "1" "April 2010" "GNU coreutils 8.5" "User Commands"
   3 .SH NAME
   4 stty \- change and print terminal line settings
   5 .SH SYNOPSIS
   6 .B stty
   7 [\fI-F DEVICE | --file=DEVICE\fR] [\fISETTING\fR]...
   8 .br
   9 .B stty
  10 [\fI-F DEVICE | --file=DEVICE\fR] [\fI-a|--all\fR]
  11 .br
  12 .B stty
  13 [\fI-F DEVICE | --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 * [\-]iutf8
 174 assume input characters are UTF\-8 encoded
 175 .TP
 176 * [\-]iuclc
 177 translate uppercase characters to lowercase
 178 .TP
 179 * [\-]ixany
 180 let any character restart output, not only start character
 181 .TP
 182 [\-]ixoff
 183 enable sending of start/stop characters
 184 .TP
 185 [\-]ixon
 186 enable XON/XOFF flow control
 187 .TP
 188 [\-]parmrk
 189 mark parity errors (with a 255\-0\-character sequence)
 190 .TP
 191 [\-]tandem
 192 same as [\-]ixoff
 193 .SS "Output settings:"
 194 .TP
 195 * bsN
 196 backspace delay style, N in [0..1]
 197 .TP
 198 * crN
 199 carriage return delay style, N in [0..3]
 200 .TP
 201 * ffN
 202 form feed delay style, N in [0..1]
 203 .TP
 204 * nlN
 205 newline delay style, N in [0..1]
 206 .TP
 207 * [\-]ocrnl
 208 translate carriage return to newline
 209 .TP
 210 * [\-]ofdel
 211 use delete characters for fill instead of null characters
 212 .TP
 213 * [\-]ofill
 214 use fill (padding) characters instead of timing for delays
 215 .TP
 216 * [\-]olcuc
 217 translate lowercase characters to uppercase
 218 .TP
 219 * [\-]onlcr
 220 translate newline to carriage return\-newline
 221 .TP
 222 * [\-]onlret
 223 newline performs a carriage return
 224 .TP
 225 * [\-]onocr
 226 do not print carriage returns in the first column
 227 .TP
 228 [\-]opost
 229 postprocess output
 230 .TP
 231 * tabN
 232 horizontal tab delay style, N in [0..3]
 233 .TP
 234 * tabs
 235 same as tab0
 236 .TP
 237 * \fB\-tabs\fR
 238 same as tab3
 239 .TP
 240 * vtN
 241 vertical tab delay style, N in [0..1]
 242 .SS "Local settings:"
 243 .TP
 244 [\-]crterase
 245 echo erase characters as backspace\-space\-backspace
 246 .TP
 247 * crtkill
 248 kill all line by obeying the echoprt and echoe settings
 249 .TP
 250 * \fB\-crtkill\fR
 251 kill all line by obeying the echoctl and echok settings
 252 .TP
 253 * [\-]ctlecho
 254 echo control characters in hat notation (`^c')
 255 .TP
 256 [\-]echo
 257 echo input characters
 258 .TP
 259 * [\-]echoctl
 260 same as [\-]ctlecho
 261 .TP
 262 [\-]echoe
 263 same as [\-]crterase
 264 .TP
 265 [\-]echok
 266 echo a newline after a kill character
 267 .TP
 268 * [\-]echoke
 269 same as [\-]crtkill
 270 .TP
 271 [\-]echonl
 272 echo newline even if not echoing other characters
 273 .TP
 274 * [\-]echoprt
 275 echo erased characters backward, between `\e' and '/'
 276 .TP
 277 [\-]icanon
 278 enable erase, kill, werase, and rprnt special characters
 279 .TP
 280 [\-]iexten
 281 enable non\-POSIX special characters
 282 .TP
 283 [\-]isig
 284 enable interrupt, quit, and suspend special characters
 285 .TP
 286 [\-]noflsh
 287 disable flushing after interrupt and quit special characters
 288 .TP
 289 * [\-]prterase
 290 same as [\-]echoprt
 291 .TP
 292 * [\-]tostop
 293 stop background jobs that try to write to the terminal
 294 .TP
 295 * [\-]xcase
 296 with icanon, escape with `\e' for uppercase characters
 297 .SS "Combination settings:"
 298 .TP
 299 * [\-]LCASE
 300 same as [\-]lcase
 301 .TP
 302 cbreak
 303 same as \fB\-icanon\fR
 304 .TP
 305 \fB\-cbreak\fR
 306 same as icanon
 307 .TP
 308 cooked
 309 same as brkint ignpar istrip icrnl ixon opost isig
 310 icanon, eof and eol characters to their default values
 311 .TP
 312 \fB\-cooked\fR
 313 same as raw
 314 .TP
 315 crt
 316 same as echoe echoctl echoke
 317 .TP
 318 dec
 319 same as echoe echoctl echoke \fB\-ixany\fR intr ^c erase 0177
 320 kill ^u
 321 .TP
 322 * [\-]decctlq
 323 same as [\-]ixany
 324 .TP
 325 ek
 326 erase and kill characters to their default values
 327 .TP
 328 evenp
 329 same as parenb \fB\-parodd\fR cs7
 330 .TP
 331 \fB\-evenp\fR
 332 same as \fB\-parenb\fR cs8
 333 .TP
 334 * [\-]lcase
 335 same as xcase iuclc olcuc
 336 .TP
 337 litout
 338 same as \fB\-parenb\fR \fB\-istrip\fR \fB\-opost\fR cs8
 339 .TP
 340 \fB\-litout\fR
 341 same as parenb istrip opost cs7
 342 .TP
 343 nl
 344 same as \fB\-icrnl\fR \fB\-onlcr\fR
 345 .TP
 346 \fB\-nl\fR
 347 same as icrnl \fB\-inlcr\fR \fB\-igncr\fR onlcr \fB\-ocrnl\fR \fB\-onlret\fR
 348 .TP
 349 oddp
 350 same as parenb parodd cs7
 351 .TP
 352 \fB\-oddp\fR
 353 same as \fB\-parenb\fR cs8
 354 .TP
 355 [\-]parity
 356 same as [\-]evenp
 357 .TP
 358 pass8
 359 same as \fB\-parenb\fR \fB\-istrip\fR cs8
 360 .TP
 361 \fB\-pass8\fR
 362 same as parenb istrip cs7
 363 .TP
 364 raw
 365 same as \fB\-ignbrk\fR \fB\-brkint\fR \fB\-ignpar\fR \fB\-parmrk\fR \fB\-inpck\fR \fB\-istrip\fR
 366 \fB\-inlcr\fR \fB\-igncr\fR \fB\-icrnl\fR  \fB\-ixon\fR  \fB\-ixoff\fR  \fB\-iuclc\fR  \fB\-ixany\fR
 367 \fB\-imaxbel\fR \fB\-opost\fR \fB\-isig\fR \fB\-icanon\fR \fB\-xcase\fR min 1 time 0
 368 .TP
 369 \fB\-raw\fR
 370 same as cooked
 371 .TP
 372 sane
 373 same as cread \fB\-ignbrk\fR brkint \fB\-inlcr\fR \fB\-igncr\fR icrnl \fB\-iutf8\fR
 374 \fB\-ixoff\fR \fB\-iuclc\fR \fB\-ixany\fR imaxbel opost \fB\-olcuc\fR \fB\-ocrnl\fR onlcr
 375 \fB\-onocr\fR \fB\-onlret\fR \fB\-ofill\fR \fB\-ofdel\fR nl0 cr0 tab0 bs0 vt0 ff0
 376 isig icanon iexten echo echoe echok \fB\-echonl\fR \fB\-noflsh\fR
 377 \fB\-xcase\fR \fB\-tostop\fR \fB\-echoprt\fR echoctl echoke, all special
 378 characters to their default values
 379 .PP
 380 Handle the tty line connected to standard input.  Without arguments,
 381 prints baud rate, line discipline, and deviations from stty sane.  In
 382 settings, CHAR is taken literally, or coded as in ^c, 0x37, 0177 or
 383 127; special values ^\- or undef used to disable special characters.
 384 .SH AUTHOR
 385 Written by David MacKenzie.
 386 .SH "REPORTING BUGS"
 387 Report stty bugs to bug\-coreutils@gnu.org
 388 .br
 389 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
 390 .br
 391 General help using GNU software: <http://www.gnu.org/gethelp/>
 392 .br
 393 Report stty translation bugs to <http://translationproject.org/team/>
 394 .SH COPYRIGHT
 395 Copyright \(co 2010 Free Software Foundation, Inc.
 396 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 397 .br
 398 This is free software: you are free to change and redistribute it.
 399 There is NO WARRANTY, to the extent permitted by law.
 400 .SH "SEE ALSO"
 401 The full documentation for
 402 .B stty
 403 is maintained as a Texinfo manual.  If the
 404 .B info
 405 and
 406 .B stty
 407 programs are properly installed at your site, the command
 408 .IP
 409 .B info coreutils \(aqstty invocation\(aq
 410 .PP
 411 should give you access to the complete manual.