![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to stty.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / bin / stty|
Return to stty.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / bin / stty |
1.1 ! root 1: .\" Copyright (c) 1990 The Regents of the University of California. ! 2: .\" All rights reserved. ! 3: .\" ! 4: .\" Redistribution and use in source and binary forms are permitted provided ! 5: .\" that: (1) source distributions retain this entire copyright notice and ! 6: .\" comment, and (2) distributions including binaries display the following ! 7: .\" acknowledgement: ``This product includes software developed by the ! 8: .\" University of California, Berkeley and its contributors'' in the ! 9: .\" documentation or other materials provided with the distribution and in ! 10: .\" all advertising materials mentioning features or use of this software. ! 11: .\" Neither the name of the University nor the names of its contributors may ! 12: .\" be used to endorse or promote products derived from this software without ! 13: .\" specific prior written permission. ! 14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED ! 15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF ! 16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. ! 17: .\" ! 18: .\" @(#)stty.1 6.7 (Berkeley) 7/24/90 ! 19: .\" ! 20: .Dd July 24, 1990 ! 21: .Dt STTY 1 ! 22: .Os BSD 4.4 ! 23: .Sh NAME ! 24: .Nm stty ! 25: .Nd Set the options for a terminal. ! 26: .Sh SYNOPSIS ! 27: .Nm stty ! 28: .Op Fl a Ar \&| Fl g ! 29: .Nm stty ! 30: .Op arguments ! 31: .De ! 32: .Sh DESCRIPTION ! 33: The stty utility sets or reports on terminal I/O ! 34: characteristics for the device that is its standard input. ! 35: Without options or arguments specified, it reports the ! 36: settings of certain characteristics, usually those that differ ! 37: from implementation-defined defaults. ! 38: Otherwise it modifies ! 39: the terminal state according to the specified arguments. ! 40: Some combinations of arguments are mutually ! 41: exclusive on some terminal types. ! 42: .Pp ! 43: The following options are available: ! 44: .Tw Ds ! 45: .Tp Fl a ! 46: Write to standard output all the current settings ! 47: for the terminal. ! 48: .Tp Fl g ! 49: Write to standard output the current settings in an ! 50: unspecified form that can be used as arguments to ! 51: another stty utility on the same system. ! 52: .Tp ! 53: .Pp ! 54: The following arguments are available to set the terminal ! 55: characteristics: ! 56: .Tw Fl ! 57: .Tc Cm parenb ! 58: .Ws ! 59: .Pf \&( Fl parenb ) ! 60: .Cx ! 61: Enable (disable) parity generation ! 62: and detection. ! 63: .Tc Cm parodd ! 64: .Ws ! 65: .Pf \&( Fl parodd ) ! 66: .Cx ! 67: Select odd (even) parity. ! 68: .Tp Cm cs5 cs6 cs7 cs8 ! 69: Select character size, if possible. ! 70: .Tp Ar number ! 71: Set terminal baud rate to the ! 72: number given, if possible. ! 73: If the ! 74: baud rate is set to zero, modem ! 75: control is no longer ! 76: asserted. ! 77: .Tc Cm ispeed ! 78: .Ws ! 79: .Ar number ! 80: .Cx ! 81: Set terminal input baud rate to the ! 82: number given, if possible. ! 83: If the ! 84: input baud rate is set to zero, the ! 85: input baud rate is set to the ! 86: value of the output baud ! 87: rate. ! 88: .Tc Cm ospeed ! 89: .Ws ! 90: .Ar number ! 91: .Cx ! 92: Set terminal output baud rate to ! 93: the number given, if possible. ! 94: If ! 95: the output baud rate is set to ! 96: zero, modem control is ! 97: no longer asserted. ! 98: .Tc Cm hupcl ! 99: .Ws ! 100: .Pf \&( Fl hupcl ) ! 101: .Cx ! 102: Stop asserting modem control ! 103: (do not stop asserting modem control) on last close. ! 104: .Tc Cm hup ! 105: .Ws ! 106: .Pf \&( Fl hup ) ! 107: .Cx ! 108: Same as hupcl ! 109: .Ws ! 110: .Pf \&( Fl hupcl). ! 111: .Tc Cm cstopb ! 112: .Ws ! 113: .Pf \&( Fl cstopb ) ! 114: .Cx ! 115: Use two (one) stop bits per character. ! 116: .Tc Cm cread ! 117: .Ws ! 118: .Pf \&( Fl cread ) ! 119: .Cx ! 120: Enable (disable) the receiver. ! 121: .Tc Cm clocal ! 122: .Ws ! 123: .Pf \&( Fl clocal ) ! 124: .Cx ! 125: Assume a line without (with) modem ! 126: control. ! 127: .Tc Cm ignbrk ! 128: .Ws ! 129: .Pf \&( Fl ignbrk ) ! 130: .Cx ! 131: Ignore (do not ignore) break on ! 132: input. ! 133: .Tc Cm brkint ! 134: .Ws ! 135: .Pf \&( Fl brkint ) ! 136: .Cx ! 137: Signal (do not signal) INTR on ! 138: break. ! 139: .Tc Cm ignpar ! 140: .Ws ! 141: .Pf \&( Fl ignpar ) ! 142: .Cx ! 143: Ignore (do not ignore) parity ! 144: errors. ! 145: .Tc Cm parmrk ! 146: .Ws ! 147: .Pf \&( Fl parmrk ) ! 148: .Cx ! 149: Mark (do not mark) parity errors. ! 150: .Tc Cm inpck ! 151: .Ws ! 152: .Pf \&( Fl inpck ) ! 153: .Cx ! 154: Enable (disable) input parity ! 155: checking. ! 156: .Tc Cm istrip ! 157: .Ws ! 158: .Pf \&( Fl istrip ) ! 159: .Cx ! 160: Strip (do not strip) input characters ! 161: to seven bits. ! 162: .Tc Cm inlcr ! 163: .Ws ! 164: .Pf \&( Fl inlcr ) ! 165: .Cx ! 166: Map (do not map) NL to CR on input. ! 167: .Tc Cm igncr ! 168: .Ws ! 169: .Pf \&( Fl igncr ) ! 170: .Cx ! 171: Ignore (do not ignore) CR on input. ! 172: .Tc Cm icrnl ! 173: .Ws ! 174: .Pf \&( Fl icrnl ) ! 175: .Cx ! 176: Map (do not map) CR to NL on input. ! 177: .Tc Cm ixon ! 178: .Ws ! 179: .Pf \&( Fl ixon ) ! 180: .Cx ! 181: Enable (disable) START/STOP output ! 182: control. ! 183: Output from the system is ! 184: stopped when the system receives ! 185: STOP and started when the system ! 186: receives START. ! 187: .Tc Cm ixoff ! 188: .Ws ! 189: .Pf \&( Fl ixoff ) ! 190: .Cx ! 191: Request that the system send (not ! 192: send) START/STOP characters when ! 193: the input queue is nearly ! 194: empty/full. ! 195: .Tc Cm opost ! 196: .Ws ! 197: .Pf \&( Fl opost ) ! 198: .Cx ! 199: Post-process output (do not ! 200: post-process output; ignore all other ! 201: output modes). ! 202: .Tc Cm isig ! 203: .Ws ! 204: .Pf \&( Fl isig ) ! 205: .Cx ! 206: Enable (disable) the checking of ! 207: characters against the special control ! 208: characters INTR, QUIT, and ! 209: SUSP. ! 210: .Tc Cm icanon ! 211: .Ws ! 212: .Pf \&( Fl icanon ) ! 213: .Cx ! 214: Enable (disable) canonical input ! 215: (ERASE and KILL processing). ! 216: .Tc Cm iexten ! 217: .Ws ! 218: .Pf \&( Fl iexten ) ! 219: .Cx ! 220: Enable (disable) any implementation ! 221: defined special control characters ! 222: not currently controlled by icanon, ! 223: isig, or ixon. ! 224: .Tc Cm echo ! 225: .Ws ! 226: .Pf \&( Fl echo ) ! 227: .Cx ! 228: Echo back (do not echo back) every ! 229: character typed. ! 230: .Tc Cm echoe ! 231: .Ws ! 232: .Pf \&( Fl echoe ) ! 233: .Cx ! 234: The ERASE character shall (shall ! 235: not) visually erase the last character ! 236: in the current line from the ! 237: display, if possible. ! 238: .Tc Cm echok ! 239: .Ws ! 240: .Pf \&( Fl echok ) ! 241: .Cx ! 242: Echo (do not echo) NL after KILL ! 243: character. ! 244: .Tc Cm echonl ! 245: .Ws ! 246: .Pf \&( Fl echonl ) ! 247: .Cx ! 248: Echo (do not echo) NL, even if echo ! 249: is disabled. ! 250: .Tc Cm noflsh ! 251: .Ws ! 252: .Pf \&( Fl noflsh ) ! 253: .Cx ! 254: Disable (enable) flush after INTR, ! 255: QUIT, SUSP. ! 256: .Tc Cm control-character ! 257: .Ws ! 258: .Ar string ! 259: .Cx ! 260: Set control-character to string. ! 261: If string is a single character, ! 262: the control character is set to ! 263: that character. ! 264: If string is the ! 265: two character sequence "^-" or the ! 266: string "undef" the control character ! 267: is set to {_POSIX_VDISABLE} if ! 268: it is in effect for the device; if ! 269: {_POSIX_VDISABLE} is not in effect ! 270: for the device, it is an ! 271: error. ! 272: .Pp ! 273: Recognized control-characters: ! 274: .Ds I ! 275: .Cw character Subscript ! 276: .Cl control- POSIX.1 ! 277: .Cl character Subscript Description ! 278: .Cl _________ _________ _______________ ! 279: .Cl eof VEOF EOF character ! 280: .Cl eol VEOL EOL character ! 281: .Cl erase VERASE ERASE character ! 282: .Cl intr VINTR INTR character ! 283: .Cl kill VKILL KILL character ! 284: .Cl quit VQUIT QUIT character ! 285: .Cl susp VSUSP SUSP character ! 286: .Cl start VSTART START character ! 287: .Cl stop VSTOP STOP character ! 288: .Cw ! 289: .De ! 290: .Tp Cm saved settings ! 291: Set the current terminal ! 292: characteristics to the saved settings ! 293: produced by the -g option. ! 294: .Tc Cm min ! 295: .Ws ! 296: .Ar number ! 297: .Cx ! 298: time number ! 299: Set the value of min or time to ! 300: number. ! 301: MIN and TIME are used in ! 302: Non-Canonical mode input processing ! 303: (-icanon). ! 304: .Tc Cm evenp ! 305: .Ws ! 306: .Cx or ! 307: .Ws ! 308: .Cm parity ! 309: .Cx ! 310: Enable parenb and cs7; disable ! 311: parodd. ! 312: .Tp Cm oddp ! 313: Enable parenb, cs7, and parodd. ! 314: .Tp Fl parity , evenp , oddp ! 315: Disable parenb, and set cs8. ! 316: .Tc Cm nl ! 317: .Ws ! 318: .Pf \&( Fl nl ) ! 319: .Cx ! 320: Enable (disable) icrnl. ! 321: In addition ! 322: -nl unsets inlcr and igncr. ! 323: .Tp Cm ek ! 324: Reset ERASE and KILL characters ! 325: back to system defaults. ! 326: .Tp Cm sane ! 327: Resets all modes to some reasonable, ! 328: unspecified, values. ! 329: .Tp ! 330: .Pp ! 331: If the -g option is specified, stty writes to standard output ! 332: the current settings in a form that can be used as arguments ! 333: to another instance of stty on the same system. ! 334: .Pp ! 335: If the -a option is specified, all of the information as ! 336: described in arguments is written to standard output. ! 337: Unless ! 338: otherwise specified, this information shall be displayed as ! 339: <space>-separated tokens in an unspecified format, on one or ! 340: more lines, with an unspecified number of tokens per line. ! 341: Additional information may be displayed as well. ! 342: .Pp ! 343: If no options are specified, an unspecified subset of the ! 344: information displayed for the -a option is displayed. ! 345: .Pp ! 346: If the terminal input speed and output speed are the same, ! 347: the speed information is displayed as follows: ! 348: .Pp ! 349: .Ds I ! 350: "speed %d baud;", <speed> ! 351: .De ! 352: .Pp ! 353: Otherwise speeds are displayed as: ! 354: .Pp ! 355: .Ds I ! 356: "ispeed %d baud; ospeed %d baud;", <ispeed>, <ospeed> ! 357: .De ! 358: .Pp ! 359: Control characters are displayed as: ! 360: .Pp ! 361: .Ds I ! 362: "%s = %s;", <control-character name>, <value> ! 363: .De ! 364: .Pp ! 365: where value is either the character, or some visual ! 366: representation of the character if it is non-printing, or ! 367: the string "<undef>" if the character is disabled. ! 368: .Pp ! 369: The ! 370: .Nm stty ! 371: utility exits with one of the following values: ! 372: .Tw Ds ! 373: .Tp Li \&0 ! 374: The terminal options were read or set successfully. ! 375: .Tp Li \&>0 ! 376: An error occurred. ! 377: .Tp ! 378: .Sh SEE ALSO ! 379: .Xr stty 4 ! 380: .Sh STANDARDS ! 381: The ! 382: .Nm stty ! 383: function is expected to be POSIX 1003.2 compatible.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.