original/man1/stty.1

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