-.TH STTY 1 ""
-.UC 4
-.SH NAME
-stty \- set terminal options
-.SH SYNOPSIS
-.B stty
-[ option ... ]
-.SH DESCRIPTION
-.I Stty
-sets certain I/O options on the current output terminal,
-placing its output on the diagnostic output.
-With no argument, it reports the speed of the terminal and the
-settings of the options which are different from their defaults.
-Use of one of the following options modifies the output as described:
-.TP 10
-.B all
-All normally used option settings are reported.
-.TP 10
-.B everything
-Everything
-.I stty
-knows about is printed.
-.TP 10
-.B speed
-The terminal speed alone is printed on the standard output.
-.TP 10
-.B size
-The terminal (window) sizes are printed on the standard output,
-first rows and then columns.
-.sp
-The option strings are
-selected from the following set:
-.TP 10
-.B even
-allow even parity input
-.br
-.ns
-.TP 10
-.B \-even
-disallow even parity input
-.br
-.ns
-.TP 10
-.B odd
-allow odd parity input
-.br
-.ns
-.TP 10
-.B \-odd
-disallow odd parity input
-.br
-.ns
-.TP 10
-.B raw
-raw mode input
-(\fBno\fR input processing (erase, kill, interrupt, ...); parity bit passed back)
-.br
-.ns
-.TP 10
-.B \-raw
-negate raw mode
-.br
-.ns
-.TP 10
-.B cooked
-same as `\-raw'
-.br
-.ns
-.TP 10
-.B cbreak
-make each character available to
-.IR read (2)
-as received; no erase and kill processing,
-but all other processing (interrupt, suspend, ...) is performed
-.br
-.ns
-.TP 10
-.B \-cbreak
-make characters available to
-.I read
-only when newline is received
-.br
-.ns
-.TP 10
-.B \-nl
-allow carriage return for new-line,
-and output CR-LF for carriage return or new-line
-.br
-.ns
-.TP 10
-.B nl
-accept only new-line to end lines
-.br
-.ns
-.TP 10
-.B echo
-echo back every character typed
-.br
-.ns
-.TP 10
-.B \-echo
-do not echo characters
-.br
-.ns
-.TP 10
-.B lcase
-map upper case to lower case
-.br
-.ns
-.TP 10
-.B \-lcase
-do not map case
-.br
-.ns
-.TP 10
-.B tandem
-enable flow control, so that the system sends out the stop character when
-its internal queue is in danger of overflowing on input, and sends the
-start character when it is ready to accept further input
-.br
-.ns
-.TP 10
-.B \-tandem
-disable flow control
-.br
-.ns
-.TP 10
-.B \-tabs
-replace tabs by spaces when printing
-.br
-.ns
-.TP 10
-.B tabs
-preserve tabs
-.br
-.ns
-.TP 10
-.B ek
-set erase and kill characters to # and @
-.br
-.ns
-.PP
-For the following commands which take a character argument \fIc\fR,
-you may also specify \fIc\fR as the ``u'' or ``undef'', to set the value
-to be undefined. A value of ``^x'', a 2 character sequence, is also
-interpreted as a control character, with ``^?'' representing delete.
-.TP 10
-.BI erase \ c\fR
-set erase character to
-.I c
-(default `#', but often reset to ^H.)
-.br
-.ns
-.TP 10
-.BI kill \ c\fR
-set kill character to
-.I c
-(default `@', but often reset to ^U.)
-.br
-.ns
-.TP 10
-.BI intr \ c\fR
-set interrupt character to
-.I c
-(default DEL or ^? (delete), but often reset to ^C.)
-.br
-.ns
-.TP 10
-.BI quit \ c\fR
-set quit character to
-.I c
-(default control \e.)
-.br
-.ns
-.TP 10
-.BI start \ c\fR
-set start character to
-.I c
-(default control Q.)
-.br
-.ns
-.TP 10
-.BI stop \ c\fR
-set stop character to
-.I c
-(default control S.)
-.br
-.ns
-.TP 10
-.BI eof \ c\fR
-set end of file character to
-.I c
-(default control D.)
-.br
-.ns
-.TP 10
-.BI brk \ c\fR
-set break character to
-.I c
-(default undefined.)
-This character is an additional character causing wakeup.
-.br
-.ns
-.TP 10
-.B cr0 cr1 cr2 cr3
-.br
-select style of delay for carriage return (see
-.IR ioctl (2))
-.br
-.ns
-.TP 10
-.B nl0 nl1 nl2 nl3
-.br
-select style of delay for linefeed
-.br
-.ns
-.TP 10
-.B tab0 tab1 tab2 tab3
-.br
-select style of delay for tab
-.br
-.ns
-.TP 10
-.B ff0 ff1
-select style of delay for form feed
-.br
-.ns
-.TP 10
-.B bs0 bs1
-select style of delay for backspace
-.br
-.TP 10
-.B tty33
-set all modes suitable for the
-Teletype Corporation Model 33 terminal.
-.br
-.ns
-.TP 10
-.B tty37
-set all modes suitable for the
-Teletype Corporation Model 37 terminal.
-.br
-.ns
-.TP 10
-.B vt05
-set all modes suitable for Digital Equipment Corp. VT05 terminal
-.br
-.ns
-.TP 10
-.B dec
-set all modes suitable for Digital Equipment Corp. operating systems
-users; (erase, kill, and interrupt characters to ^?, ^U, and ^C,
-decctlq and ``newcrt''.)
-.ns
-.TP 10
-.B tn300
-set all modes suitable for a General Electric TermiNet 300
-.br
-.ns
-.TP 10
-.B ti700
-set all modes suitable for Texas Instruments 700 series terminal
-.br
-.ns
-.TP 10
-.B tek
-set all modes suitable for Tektronix 4014 terminal
-.br
-.ns
-.TP 10
-.B 0
-hang up phone line immediately
-.br
-.ns
-.TP 10
-.B "50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb"
-.br
-Set terminal baud rate to the number given, if possible.
-(These are the speeds supported by the DH-11 interface).
-.TP 10
-.BI rows \ n\fR
-The terminal size is recorded as having
-.I n
-rows.
-.TP 10
-.BI columns \ n\fR
-The terminal size is recorded as having
-.I n
-columns.
-.TP 10
-.BI cols \ n\fR
-is an alias for
-.IR columns .
-.PP
-A teletype driver which supports the job control processing of
-.IR csh (1)
-and more functionality than the basic driver is fully described in
-.IR tty (4).
-The following options apply only to it.
-.TP 10
-.B new
-Use new driver (switching flushes typeahead).
-.br
-.ns
-.TP 10
-.B crt
-Set options for a CRT (crtbs, ctlecho and, if >= 1200 baud,
-crterase and crtkill.)
-.br
-.ns
-.TP 10
-.B crtbs
-Echo backspaces on erase characters.
-.br
-.ns
-.TP 10
-.B prterase
-For printing terminal echo erased characters backwards within ``\e'' and ``/''.
-.br
-.ns
-.TP 10
-.B crterase
-Wipe out erased characters with ``backspace-space-backspace.''
-.br
-.ns
-.TP 10
-.B \-crterase
-Leave erased characters visible; just backspace.
-.br
-.ns
-.TP 10
-.B crtkill
-Wipe out input on like kill ala
-.B crterase.
-.br
-.ns
-.TP 10
-.B \-crtkill
-Just echo line kill character and a newline on line kill.
-.br
-.ns
-.TP 10
-.B ctlecho
-Echo control characters as ``^\fIx\fR'' (and delete as ``^?''.)
-Print two backspaces following the EOT character (control D).
-.br
-.ns
-.TP 10
-.B \-ctlecho
-Control characters echo as themselves; in cooked mode EOT (control-D)
-is not echoed.
-.TP 10
-.B decctlq
-After output is suspended (normally by ^S), only a start character
-(normally ^Q) will restart it. This is compatible with DEC's vendor
-supplied systems.
-.TP 10
-.B \-decctlq
-After output is suspended, any character typed will restart it;
-the start character will restart output without providing any input.
-(This is the default.)
-.br
-.ns
-.TP 10
-.B tostop
-Background jobs stop if they attempt terminal output.
-.br
-.ns
-.TP 10
-.B \-tostop
-Output from background jobs to the terminal is allowed.
-.br
-.ns
-.TP 10
-.B tilde
-Convert ``~'' to ``\`'' on output (for Hazeltine terminals).
-.br
-.ns
-.TP 10
-.B \-tilde
-Leave poor ``~'' alone.
-.br
-.ns
-.TP 10
-.B flusho
-Output is being discarded usually because user hit control O (internal state bit).
-.br
-.ns
-.TP 10
-.B \-flusho
-Output is not being discarded.
-.br
-.ns
-.TP 10
-.B pendin
-Input is pending after a switch from cbreak to cooked
-and will be re-input when a read becomes pending or more input arrives
-(internal state bit).
-.br
-.ns
-.TP 10
-.B \-pendin
-Input is not pending.
-.br
-.ns
-.TP 10
-.B pass8
-Passes all 8 bits through on input, in any mode.
-.br
-.ns
-.TP 10
-.B \-pass8
-Strips the 0200 bit on input except in raw mode.
-.br
-.ns
-.TP 10
-.B mdmbuf
-Start/stop output on carrier transitions (not implemented).
-.br
-.ns
-.TP 10
-.B \-mdmbuf
-Return error if write attempted after carrier drops.
-.br
-.ns
-.TP 10
-.B litout
-Send output characters without any processing.
-.br
-.ns
-.TP 10
-.B \-litout
-Do normal output processing, inserting delays, etc.
-.br
-.ns
-.TP 10
-.B nohang
-Don't send hangup signal if carrier drops.
-.br
-.ns
-.TP 10
-.B \-nohang
-Send hangup signal to control process group when carrier drops.
-.br
-.ns
-.TP 10
-.B etxack
-Diablo style etx/ack handshaking (not implemented).
-.PP
-The following special characters are applicable only to the new
-teletype driver
-and are not normally changed.
-.TP 10
-.BI susp \ c\fR
-set suspend process character to \fIc\fR (default control Z).
-.br
-.ns
-.TP 10
-.BI dsusp \ c\fR
-set delayed suspend process character to \fIc\fR (default control Y).
-.br
-.ns
-.TP 10
-.BI rprnt \ c\fR
-set reprint line character to \fIc\fR (default control R).
-.br
-.ns
-.TP 10
-.BI flush \ c\fR
-set flush output character to \fIc\fR (default control O).
-.br
-.ns
-.TP 10
-.BI werase \ c\fR
-set word erase character to \fIc\fR (default control W).
-.br
-.ns
-.TP 10
-.BI lnext \ c\fR
-set literal next character to \fIc\fR (default control V).
-.SH "SEE ALSO"
-ioctl(2), tabs(1), tset(1), tty(4)
+.\" @(#)stty.1 6.6 (Berkeley) %G%
+.\"
+.Dd
+.Dt STTY 1
+.Os BSD 4.4
+.Sh NAME
+.Nm stty
+.Nd Set the options for a terminal.
+.Sh SYNOPSIS
+.Nm stty
+.Op Fl a Ar \&| Fl g
+.Nm stty
+.Op arguments
+.De
+.Sh DESCRIPTION
+The stty utility sets or reports on terminal I/O
+characteristics for the device that is its standard input.
+Without options or arguments specified, it reports the
+settings of certain characteristics, usually those that differ
+from implementation-defined defaults.
+Otherwise it modifies
+the terminal state according to the specified arguments.
+Some combinations of arguments are mutually
+exclusive on some terminal types.
+.Pp
+The following options are available:
+.Tp Fl a
+Write to standard output all the current settings
+for the terminal.
+.Tp Fl g
+Write to standard output the current settings in an
+unspecified form that can be used as arguments to
+another stty utility on the same system.
+.Tp
+.Pp
+The following arguments are available to set the terminal
+characteristics:
+.Tw Fl
+.Tc Cm parenb
+.Ws
+.Pf \&( Fl parenb )
+.Cx
+Enable (disable) parity generation
+and detection.
+.Tc Cm parodd
+.Ws
+.Pf \&( Fl parodd )
+.Cx
+Select odd (even) parity.
+.Tp Cm cs5 cs6 cs7 cs8
+Select character size, if possible.
+.Tp Ar number
+Set terminal baud rate to the
+number given, if possible.
+If the
+baud rate is set to zero, modem
+control is no longer
+asserted.
+.Tc Cm ispeed
+.Ws
+.Ar number
+.Cx
+Set terminal input baud rate to the
+number given, if possible.
+If the
+input baud rate is set to zero, the
+input baud rate is set to the
+value of the output baud
+rate.
+.Tc Cm ospeed
+.Ws
+.Ar number
+.Cx
+Set terminal output baud rate to
+the number given, if possible.
+If
+the output baud rate is set to
+zero, modem control is
+no longer asserted.
+.Tc Cm hupcl
+.Ws
+.Pf \&( Fl hupcl )
+.Cx
+Stop asserting modem control
+(do not stop asserting modem control) on last close.
+.Tc Cm hup
+.Ws
+.Pf \&( Fl hup )
+.Cx
+Same as hupcl
+.Ws
+.Pf \&( Fl hupcl).
+.Tc Cm cstopb
+.Ws
+.Pf \&( Fl cstopb )
+.Cx
+Use two (one) stop bits per character.
+.Tc Cm cread
+.Ws
+.Pf \&( Fl cread )
+.Cx
+Enable (disable) the receiver.
+.Tc Cm clocal
+.Ws
+.Pf \&( Fl clocal )
+.Cx
+Assume a line without (with) modem
+control.
+.Tc Cm ignbrk
+.Ws
+.Pf \&( Fl ignbrk )
+.Cx
+Ignore (do not ignore) break on
+input.
+.Tc Cm brkint
+.Ws
+.Pf \&( Fl brkint )
+.Cx
+Signal (do not signal) INTR on
+break.
+.Tc Cm ignpar
+.Ws
+.Pf \&( Fl ignpar )
+.Cx
+Ignore (do not ignore) parity
+errors.
+.Tc Cm parmrk
+.Ws
+.Pf \&( Fl parmrk )
+.Cx
+Mark (do not mark) parity errors.
+.Tc Cm inpck
+.Ws
+.Pf \&( Fl inpck )
+.Cx
+Enable (disable) input parity
+checking.
+.Tc Cm istrip
+.Ws
+.Pf \&( Fl istrip )
+.Cx
+Strip (do not strip) input characters
+to seven bits.
+.Tc Cm inlcr
+.Ws
+.Pf \&( Fl inlcr )
+.Cx
+Map (do not map) NL to CR on input.
+.Tc Cm igncr
+.Ws
+.Pf \&( Fl igncr )
+.Cx
+Ignore (do not ignore) CR on input.
+.Tc Cm icrnl
+.Ws
+.Pf \&( Fl icrnl )
+.Cx
+Map (do not map) CR to NL on input.
+.Tc Cm ixon
+.Ws
+.Pf \&( Fl ixon )
+.Cx
+Enable (disable) START/STOP output
+control.
+Output from the system is
+stopped when the system receives
+STOP and started when the system
+receives START.
+.Tc Cm ixoff
+.Ws
+.Pf \&( Fl ixoff )
+.Cx
+Request that the system send (not
+send) START/STOP characters when
+the input queue is nearly
+empty/full.
+.Tc Cm opost
+.Ws
+.Pf \&( Fl opost )
+.Cx
+Post-process output (do not
+post-process output; ignore all other
+output modes).
+.Tc Cm isig
+.Ws
+.Pf \&( Fl isig )
+.Cx
+Enable (disable) the checking of
+characters against the special control
+characters INTR, QUIT, and
+SUSP.
+.Tc Cm icanon
+.Ws
+.Pf \&( Fl icanon )
+.Cx
+Enable (disable) canonical input
+(ERASE and KILL processing).
+.Tc Cm iexten
+.Ws
+.Pf \&( Fl iexten )
+.Cx
+Enable (disable) any implementation
+defined special control characters
+not currently controlled by icanon,
+isig, or ixon.
+.Tc Cm echo
+.Ws
+.Pf \&( Fl echo )
+.Cx
+Echo back (do not echo back) every
+character typed.
+.Tc Cm echoe
+.Ws
+.Pf \&( Fl echoe )
+.Cx
+The ERASE character shall (shall
+not) visually erase the last character
+in the current line from the
+display, if possible.
+.Tc Cm echok
+.Ws
+.Pf \&( Fl echok )
+.Cx
+Echo (do not echo) NL after KILL
+character.
+.Tc Cm echonl
+.Ws
+.Pf \&( Fl echonl )
+.Cx
+Echo (do not echo) NL, even if echo
+is disabled.
+.Tc Cm noflsh
+.Ws
+.Pf \&( Fl noflsh )
+.Cx
+Disable (enable) flush after INTR,
+QUIT, SUSP.
+.Tc Cm control-character
+.Ws
+.Ar string
+.Cx
+Set control-character to string.
+If string is a single character,
+the control character is set to
+that character.
+If string is the
+two character sequence "^-" or the
+string "undef" the control character
+is set to {_POSIX_VDISABLE} if
+it is in effect for the device; if
+{_POSIX_VDISABLE} is not in effect
+for the device, it is an
+error.
+.Pp
+Recognized control-characters:
+.Ds I
+.Cw character Subscript
+.Cl control- POSIX.1
+.Cl character Subscript Description
+.Cl _________ _________ _______________
+.Cl eof VEOF EOF character
+.Cl eol VEOL EOL character
+.Cl erase VERASE ERASE character
+.Cl intr VINTR INTR character
+.Cl kill VKILL KILL character
+.Cl quit VQUIT QUIT character
+.Cl susp VSUSP SUSP character
+.Cl start VSTART START character
+.Cl stop VSTOP STOP character
+.Cw
+.De
+.Tp Cm saved settings
+Set the current terminal
+characteristics to the saved settings
+produced by the -g option.
+.Tc Cm min
+.Ws
+.Ar number
+.Cx
+time number
+Set the value of min or time to
+number.
+MIN and TIME are used in
+Non-Canonical mode input processing
+(-icanon).
+.Tc Cm evenp
+.Ws
+.Cx or
+.Ws
+.Cm parity
+.Cx
+Enable parenb and cs7; disable
+parodd.
+.Tp Cm oddp
+Enable parenb, cs7, and parodd.
+.Tp Fl parity , evenp , oddp
+Disable parenb, and set cs8.
+.Tc Cm nl
+.Ws
+.Pf \&( Fl nl )
+.Cx
+Enable (disable) icrnl.
+In addition
+-nl unsets inlcr and igncr.
+.Tp Cm ek
+Reset ERASE and KILL characters
+back to system defaults.
+.Tp Cm sane
+Resets all modes to some reasonable,
+unspecified, values.
+.Tp
+.Pp
+If the -g option is specified, stty writes to standard output
+the current settings in a form that can be used as arguments
+to another instance of stty on the same system.
+.Pp
+If the -a option is specified, all of the information as
+described in arguments is written to standard output.
+Unless
+otherwise specified, this information shall be displayed as
+<space>-separated tokens in an unspecified format, on one or
+more lines, with an unspecified number of tokens per line.
+Additional information may be displayed as well.
+.Pp
+If no options are specified, an unspecified subset of the
+information displayed for the -a option is displayed.
+.Pp
+If the terminal input speed and output speed are the same,
+the speed information is displayed as follows:
+.Pp
+.Ds I
+"speed %d baud;", <speed>
+.De
+Otherwise speeds are displayed as:
+.Pp
+.Ds I
+"ispeed %d baud; ospeed %d baud;", <ispeed>, <ospeed>
+.De
+Control characters are displayed as:
+.Pp
+.Ds I
+"%s = %s;", <control-character name>, <value>
+.De
+where value is either the character, or some visual
+representation of the character if it is non-printing, or
+the string "<undef>" if the character is disabled.
+.Pp
+The
+.Nm stty
+utility exits with one of the following values:
+.Tw Ds
+.Tp Li \&0
+The terminal options were read or set successfully.
+.Tp Li \&>0
+An error occurred.
+.Tp
+.Sh SEE ALSO
+.Xr stty 4
+.Sh STANDARDS
+The
+.Nm stty
+function is expected to be POSIX 1003.2 compatible.
projects / unix-history / commitdiff