-.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.
-.BI columns \ n\fR
-The terminal size is recorded as having
-.I n
-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)
+.\" %sccs.include.redist.man%
+.\"
+.\" @(#)stty.1 6.13 (Berkeley) %G%
+.\"
+.Dd
+.Dt STTY 1
+.Os
+.Sh NAME
+.Nm stty
+.Nd set the options for a terminal device interface
+.Sh SYNOPSIS
+.Nm stty
+.Op Fl a | Fl e | Fl g
+.Op Fl f Ar file
+.Op operands
+.Sh DESCRIPTION
+The
+.Nm stty
+utility sets or reports on terminal
+characteristics for the device that is its standard input.
+If no options or operands are specified, it reports the settings of a set
+of characteristics as well as additional ones if they differ from their
+default values.
+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:
+.Bl -tag -width Ds
+.It Fl a
+Display all the current settings for the terminal to standard output
+in the
+.St -p1003.2 .
+.It Fl e
+Display all the current settings for the terminal to standard output
+in the traditional
+.Tn BSD
+``all'' and ``everything'' formats.
+.It Fl f
+Display the current settings for the terminal named by
+.Ar file .
+.It Fl g
+Display all the current settings for the terminal to standard output
+in a form that may be used as an argument to a subsequent invocation of
+.Nm stty
+to restore the current terminal state.
+.El
+.Pp
+The following arguments are available to set the terminal
+characteristics:
+.Bl -tag -width Fl
+.It Cm parenb Pq Fl parenb
+Enable (disable) parity generation
+and detection.
+.It Cm parodd Pq Fl parodd
+Select odd (even) parity.
+.It Cm cs5 cs6 cs7 cs8
+Select character size, if possible.
+.It 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.
+.It Cm ispeed Ar number
+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.
+.It Cm ospeed Ar number
+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.
+.It Cm hupcl Pq Fl hupcl
+Stop asserting modem control
+(do not stop asserting modem control) on last close.
+.It Cm hup Pq Fl hup
+Same as hupcl
+.Pq Fl hupcl .
+.It Cm cstopb Pq Fl cstopb
+Use two (one) stop bits per character.
+.It Cm cread Pq Fl cread
+Enable (disable) the receiver.
+.It Cm clocal Pq Fl clocal
+Assume a line without (with) modem
+control.
+.It Cm ignbrk Pq Fl ignbrk
+Ignore (do not ignore) break on
+input.
+.It Cm brkint Pq Fl brkint
+Signal (do not signal)
+.Dv INTR
+on
+break.
+.It Cm ignpar Pq Fl ignpar
+Ignore (do not ignore) parity
+errors.
+.It Cm parmrk Pq Fl parmrk
+Mark (do not mark) parity errors.
+.It Cm inpck Pq Fl inpck
+Enable (disable) input parity
+checking.
+.It Cm istrip Pq Fl istrip
+Strip (do not strip) input characters
+to seven bits.
+.It Cm inlcr Pq Fl inlcr
+Map (do not map)
+.Dv NL
+to
+.Dv CR
+on input.
+.It Cm igncr Pq Fl igncr
+Ignore (do not ignore)
+.Dv CR
+on input.
+.It Cm icrnl Pq Fl icrnl
+Map (do not map)
+.Dv CR
+to
+.Dv NL
+on input.
+.It Cm ixon Pq Fl ixon
+Enable (disable)
+.Dv START/STOP
+output
+control.
+Output from the system is
+stopped when the system receives
+.Dv STOP
+and started when the system
+receives
+.Dv START .
+.It Cm ixoff Pq Fl ixoff
+Request that the system send (not
+send)
+.Dv START/STOP
+characters when
+the input queue is nearly
+empty/full.
+.It Cm opost Pq Fl opost
+Post-process output (do not
+post-process output; ignore all other
+output modes).
+.It Cm isig Pq Fl isig
+Enable (disable) the checking of
+characters against the special control
+characters
+.Dv INTR , QUIT ,
+and
+.Dv SUSP .
+.It Cm icanon Pq Fl icanon
+Enable (disable) canonical input
+.Pf ( Dv ERASE
+and
+.Dv KILL
+processing).
+.It Cm iexten Pq Fl iexten
+Enable (disable) any implementation
+defined special control characters
+not currently controlled by icanon,
+isig, or ixon.
+.It Cm echo Pq Fl echo
+Echo back (do not echo back) every
+character typed.
+.It Cm echoe Pq Fl echoe
+The
+.Dv ERASE
+character shall (shall
+not) visually erase the last character
+in the current line from the
+display, if possible.
+.It Cm echok Pq Fl echok
+Echo (do not echo)
+.Dv NL
+after
+.Dv KILL
+character.
+.It Cm echonl Pq Fl echonl
+Echo (do not echo)
+.Dv NL ,
+even if echo
+is disabled.
+.It Cm noflsh Pq Fl noflsh
+Disable (enable) flush after
+.Dv INTR , QUIT , SUSP .
+.It Cm control-character Ar string
+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
+.Pf { Dv _POSIX_VDISABLE Ns }
+if
+it is in effect for the device; if
+.Pf { Dv _POSIX_VDISABLE Ns }
+is not in effect
+for the device, it is an
+error.
+.Pp
+Recognized control-characters:
+.Bd -ragged -offset indent
+.Bl -column character Subscript
+.It control- Ta Tn POSIX.1
+.It character Subscript Description
+.It _________ _________ _______________
+.It eof Ta Tn VEOF EOF No character
+.It eol Ta Tn VEOL EOL No character
+.It erase Ta Tn VERASE ERASE No character
+.It intr Ta Tn VINTR INTR No character
+.It kill Ta Tn VKILL KILL No character
+.It quit Ta Tn VQUIT QUIT No character
+.It susp Ta Tn VSUSP SUSP No character
+.It start Ta Tn VSTART START No character
+.It stop Ta Tn VSTOP STOP No character
+.El
+.Ed
+.It Cm saved settings
+Set the current terminal
+characteristics to the saved settings
+produced by the
+.Fl g
+option.
+.It Cm min Ar number
+.It Cm time Ar number
+Set the value of min or time to
+number.
+.Dv MIN
+and
+.Dv TIME
+are used in
+Non-Canonical mode input processing
+(-icanon).
+.It Cm evenp No or Cm parity
+Enable parenb and cs7; disable
+parodd.
+.It Cm oddp
+Enable parenb, cs7, and parodd.
+.It Fl parity , evenp , oddp
+Disable parenb, and set cs8.
+.It Cm nl Pq Fl nl
+Enable (disable) icrnl.
+In addition
+-nl unsets inlcr and igncr.
+.It Cm ek
+Reset
+.Dv ERASE
+and
+.Dv KILL
+characters
+back to system defaults.
+.It Cm sane
+Resets all modes to reasonable values for interactive terminal use.
+.It Cm tty
+Set the line discipline to the standard terminal line discipline
+.Dv TTYDISC .
+.El
+.Pp
+The
+.Nm stty
+utility exits with a value of 0 if successful, and >0 if an error occurs.
+.Sh SEE ALSO
+.Xr stty 4
+.Sh STANDARDS
+The
+.Nm stty
+function is expected to be
+.St -p1003.2
+compatible.
projects / unix-history / blobdiff