manual/GNU_sh-utils/original/man1/stty.1

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