.TH STTY 1
.SH NAME
stty \- set terminal parameters
.SH SYNOPSIS
.de SP
.if t .sp 0.4
.if n .sp
..
.in +4n
.ti -4n
.B stty
.RB [ \-ag]
.SP
.ti -4n
.B stty
.I encoded-form
.SP
.ti -4n
.B stty
.I speed
.B ispeed
.I speed
.B ospeed
.I speed
.B "cs5 cs6 cs7 cs8"
.RB [ \- ] parenb
.RB [ \- ] parodd
.RB [ \- ] hupcl
.RB [ \- ] cstopb
.RB [ \- ] cread
.RB [ \- ] clocal
.RB [ \- ] ignbrk
.RB [ \- ] brkint
.RB [ \- ] ignpar
.RB [ \- ] parmrk
.RB [ \- ] inpck
.RB [ \- ] istrip
.RB [ \- ] inlcr
.RB [ \- ] igncr
.RB [ \- ] icrnl
.RB [ \- ] ixon
.RB [ \- ] ixoff
.RB [ \- ] ixany
.RB [ \- ] opost
.RB [ \- ] onlcr
.RB [ \- ] xtabs
.RB [ \- ] onoeot
.RB [ \- ] isig
.RB [ \- ] icanon
.RB [ \- ] iexten
.RB [ \- ] echo
.RB [ \- ] echoe
.RB [ \- ] echok
.RB [ \- ] echonl
.RB [ \- ] noflsh
.RB [ \- ] tostop
.RB [ \- ] lflusho
.BR eof =\fIc
.BR eol =\fIc
.BR erase =\fIc
.BR erase =\fIc
.BR intr =\fIc
.BR kill =\fIc
.BR quit =\fIc
.BR susp =\fIc
.BR start =\fIc
.BR stop =\fIc
.BR rprnt =\fIc
.BR lnext =\fIc
.BR flush =\fIc
.BR min =\fIn
.BR time =\fIn
.B rows
.I n
.B cols
.I n
.B xpixels
.I n
.B ypixels
.I n
.B cooked
.B raw
.RB [ \- ] evenp
.RB [ \- ] parity
.RB [ \- ] oddp
.RB [ \- ] nl
.B ek
.B sane
.in -4n
.SH DESCRIPTION
.B Stty
shows or changes the parameters of the terminal connected to standard input.
.B Stty
takes a myriad of arguments most of which are mapped directly to
the flags and special characters described in
.BR tty (4),
so we won't describe them here.
.PP
.B Stty
has three forms of operation.  First, without any arguments
.B stty
shows all terminal attributes that are different from the default state.
Option
.B \-a
makes
.B stty
print all terminal attributes, and
.B \-g
lets
.B stty
print the attributes in a special encoded form, a simple row of colon separated
hexadecimal numbers.
.PP
In the second form of operation
.B stty
takes an encoded form as produced by the
.B \-g
option and sets the terminals attributes to its decoded value.
.PP
In the third form
.B stty
interprets a series of flags and parameters settings and modifies the
terminal attributes accordingly.  Flags can be given as
.B icanon
or
.B \-icanon
for instance, either setting or clearing the
.B ICANON
flag.
Special character values can by set like
.B "intr=^C"
for example, which sets the interrupt character to CTRL-C.  You can either
use a real CTRL-C, or the two characters `^' and `C'.  In any case
it is probably necessary to use quotes to guard it from the shell:
.BR "intr='^C'" .
.PP
A number alone is interpreted as a baud rate setting for both the input and
output rate.  The input or the output rate can be set separately with use
of the
.B ispeed
and
.B ospeed
prefixes to the number.  The character size can be set with
.BR cs5 ,
.BR cs6 ,
.BR cs7
or
.BR cs8 .
.PP
The
.B MIN
and
.B TIME
value, the number of rows and columns, and the xpixels and ypixels of the
window can also be set using one of the keywords
.BR min ,
.BR time ,
.BR rows ,
.BR cols ,
.BR xpixels
or
.BR ypixels ,
followed by a decimal number that is the value of the setting.
.PP
.B Stty
accepts several keywords that are not named by corresponding flags or
parameters in
.BR tty (4).
They set several attributes at once:
.TP
.B cooked
Same as
.BR "icrnl ixon opost onlcr isig icanon iexten echo" ,
setting all the attributes that are needed for line oriented mode.
.TP
.B raw
Same as
.BR "\-icrnl \-ixon \-opost \-onlcr \-isig \-icanon \-iexten \-echo" ,
setting all the attributes for a raw data channel.
.TP
.B evenp parity
These synonyms are equal to
.BR "cs7 parenb \-parodd" ,
setting the line to 7 bits even parity.
.TP
.B oddp
Same as
.BR "cs7 parenb parodd" ,
setting the line to 7 bits odd parity.
.TP
.B "\-parity \-evenp \-oddp"
All synonyms for
.BR "cs8 \-parenb" ,
setting the line to 8 bits, no parity.
.TP
.B nl
Same as
.BR icrnl ,
setting carriage return to line feed input translation.
.TP
.B \-nl
Same as
.BR "\-icrnl \-inlcr \-igncr" ,
disabling any carriage return or line feed handling.
.TP
.B ek
Set the
.B ERASE
and
.B KILL
special characters back to the default.
.TP
.B sane
Set all attributes to the default except things like the line speed and
parity, because their "sane" value is probably what it is right now.
The default values are compiled into
.B stty
from the <termios.h> include file.  Use
.B "stty sane; stty -a"
to know what they are.
.SH FILES
.TP 15n
.B /etc/ttytab
The
.B init
field of this file may contain an
.B stty
command to set the attributes to match an attached RS232 terminal or modem.
.SH "SEE ALSO"
.BR tty (4),
.BR ttytab (5).
.SH NOTES
The
.BR cooked ,
.BR raw ,
.BR rows ,
.BR cols ,
.BR xpixels
and
.BR ypixels
keywords are MINIX 3 additions beyond the keywords defined by POSIX.
.B Rows
and
.B cols
are common UNIX extensions, however.
There are more MINIX 3 specific flags that match the MINIX 3 specific attributes
described in
.BR tty (4).
.SH AUTHOR
Kees J. Bot <kjb@cs.vu.nl>