251 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
			
		
		
	
	
			251 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
.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>
 |