man-pages/man1/stty.1.html
2021-03-31 01:06:50 +01:00

387 lines
12 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of STTY</TITLE>
</HEAD><BODY>
<H1>STTY</H1>
Section: User Commands (1)<BR>Updated: September 2019<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
stty - change and print terminal line settings
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>stty</B>
[<I>,-F DEVICE | --file=DEVICE/</I>] [<I>,SETTING/</I>]...
<BR>
<B>stty</B>
[<I>,-F DEVICE | --file=DEVICE/</I>] [<I>,-a|--all/</I>]
<BR>
<B>stty</B>
[<I>,-F DEVICE | --file=DEVICE/</I>] [<I>,-g|--save/</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
Print or change terminal characteristics.
<P>
Mandatory arguments to long options are mandatory for short options too.
<DL COMPACT>
<DT id="1"><B>-a</B>, <B>--all</B><DD>
print all current settings in human-readable form
<DT id="2"><B>-g</B>, <B>--save</B><DD>
print all current settings in a stty-readable form
<DT id="3"><B>-F</B>, <B>--file</B>=<I>,DEVICE/</I><DD>
open and use the specified DEVICE instead of stdin
<DT id="4"><B>--help</B><DD>
display this help and exit
<DT id="5"><B>--version</B><DD>
output version information and exit
</DL>
<P>
Optional - before SETTING indicates negation. An * marks non-POSIX
settings. The underlying system defines which settings are available.
<A NAME="lbAE">&nbsp;</A>
<H3>Special characters:</H3>
<DL COMPACT>
<DT id="6">* discard CHAR<DD>
CHAR will toggle discarding of output
<DT id="7">eof CHAR<DD>
CHAR will send an end of file (terminate the input)
<DT id="8">eol CHAR<DD>
CHAR will end the line
<DT id="9">* eol2 CHAR<DD>
alternate CHAR for ending the line
<DT id="10">erase CHAR<DD>
CHAR will erase the last character typed
<DT id="11">intr CHAR<DD>
CHAR will send an interrupt signal
<DT id="12">kill CHAR<DD>
CHAR will erase the current line
<DT id="13">* lnext CHAR<DD>
CHAR will enter the next character quoted
<DT id="14">quit CHAR<DD>
CHAR will send a quit signal
<DT id="15">* rprnt CHAR<DD>
CHAR will redraw the current line
<DT id="16">start CHAR<DD>
CHAR will restart the output after stopping it
<DT id="17">stop CHAR<DD>
CHAR will stop the output
<DT id="18">susp CHAR<DD>
CHAR will send a terminal stop signal
<DT id="19">* swtch CHAR<DD>
CHAR will switch to a different shell layer
<DT id="20">* werase CHAR<DD>
CHAR will erase the last word typed
</DL>
<A NAME="lbAF">&nbsp;</A>
<H3>Special settings:</H3>
<DL COMPACT>
<DT id="21">N<DD>
set the input and output speeds to N bauds
<DT id="22">* cols N<DD>
tell the kernel that the terminal has N columns
<DT id="23">* columns N<DD>
same as cols N
<DT id="24">* [-]drain<DD>
wait for transmission before applying settings (on by default)
<DT id="25">ispeed N<DD>
set the input speed to N
<DT id="26">* line N<DD>
use line discipline N
<DT id="27">min N<DD>
with <B>-icanon</B>, set N characters minimum for a completed read
<DT id="28">ospeed N<DD>
set the output speed to N
<DT id="29">* rows N<DD>
tell the kernel that the terminal has N rows
<DT id="30">* size<DD>
print the number of rows and columns according to the kernel
<DT id="31">speed<DD>
print the terminal speed
<DT id="32">time N<DD>
with <B>-icanon</B>, set read timeout of N tenths of a second
</DL>
<A NAME="lbAG">&nbsp;</A>
<H3>Control settings:</H3>
<DL COMPACT>
<DT id="33">[-]clocal<DD>
disable modem control signals
<DT id="34">[-]cread<DD>
allow input to be received
<DT id="35">* [-]crtscts<DD>
enable RTS/CTS handshaking
<DT id="36">csN<DD>
set character size to N bits, N in [5..8]
<DT id="37">[-]cstopb<DD>
use two stop bits per character (one with '-')
<DT id="38">[-]hup<DD>
send a hangup signal when the last process closes the tty
<DT id="39">[-]hupcl<DD>
same as [-]hup
<DT id="40">[-]parenb<DD>
generate parity bit in output and expect parity bit in input
<DT id="41">[-]parodd<DD>
set odd parity (or even parity with '-')
<DT id="42">* [-]cmspar<DD>
use &quot;stick&quot; (mark/space) parity
</DL>
<A NAME="lbAH">&nbsp;</A>
<H3>Input settings:</H3>
<DL COMPACT>
<DT id="43">[-]brkint<DD>
breaks cause an interrupt signal
<DT id="44">[-]icrnl<DD>
translate carriage return to newline
<DT id="45">[-]ignbrk<DD>
ignore break characters
<DT id="46">[-]igncr<DD>
ignore carriage return
<DT id="47">[-]ignpar<DD>
ignore characters with parity errors
<DT id="48">* [-]imaxbel<DD>
beep and do not flush a full input buffer on a character
<DT id="49">[-]inlcr<DD>
translate newline to carriage return
<DT id="50">[-]inpck<DD>
enable input parity checking
<DT id="51">[-]istrip<DD>
clear high (8th) bit of input characters
<DT id="52">* [-]iutf8<DD>
assume input characters are UTF-8 encoded
<DT id="53">* [-]iuclc<DD>
translate uppercase characters to lowercase
<DT id="54">* [-]ixany<DD>
let any character restart output, not only start character
<DT id="55">[-]ixoff<DD>
enable sending of start/stop characters
<DT id="56">[-]ixon<DD>
enable XON/XOFF flow control
<DT id="57">[-]parmrk<DD>
mark parity errors (with a 255-0-character sequence)
<DT id="58">[-]tandem<DD>
same as [-]ixoff
</DL>
<A NAME="lbAI">&nbsp;</A>
<H3>Output settings:</H3>
<DL COMPACT>
<DT id="59">* bsN<DD>
backspace delay style, N in [0..1]
<DT id="60">* crN<DD>
carriage return delay style, N in [0..3]
<DT id="61">* ffN<DD>
form feed delay style, N in [0..1]
<DT id="62">* nlN<DD>
newline delay style, N in [0..1]
<DT id="63">* [-]ocrnl<DD>
translate carriage return to newline
<DT id="64">* [-]ofdel<DD>
use delete characters for fill instead of NUL characters
<DT id="65">* [-]ofill<DD>
use fill (padding) characters instead of timing for delays
<DT id="66">* [-]olcuc<DD>
translate lowercase characters to uppercase
<DT id="67">* [-]onlcr<DD>
translate newline to carriage return-newline
<DT id="68">* [-]onlret<DD>
newline performs a carriage return
<DT id="69">* [-]onocr<DD>
do not print carriage returns in the first column
<DT id="70">[-]opost<DD>
postprocess output
<DT id="71">* tabN<DD>
horizontal tab delay style, N in [0..3]
<DT id="72">* tabs<DD>
same as tab0
<DT id="73">* <B>-tabs</B><DD>
same as tab3
<DT id="74">* vtN<DD>
vertical tab delay style, N in [0..1]
</DL>
<A NAME="lbAJ">&nbsp;</A>
<H3>Local settings:</H3>
<DL COMPACT>
<DT id="75">[-]crterase<DD>
echo erase characters as backspace-space-backspace
<DT id="76">* crtkill<DD>
kill all line by obeying the echoprt and echoe settings
<DT id="77">* <B>-crtkill</B><DD>
kill all line by obeying the echoctl and echok settings
<DT id="78">* [-]ctlecho<DD>
echo control characters in hat notation ('^c')
<DT id="79">[-]echo<DD>
echo input characters
<DT id="80">* [-]echoctl<DD>
same as [-]ctlecho
<DT id="81">[-]echoe<DD>
same as [-]crterase
<DT id="82">[-]echok<DD>
echo a newline after a kill character
<DT id="83">* [-]echoke<DD>
same as [-]crtkill
<DT id="84">[-]echonl<DD>
echo newline even if not echoing other characters
<DT id="85">* [-]echoprt<DD>
echo erased characters backward, between '\' and '/'
<DT id="86">* [-]extproc<DD>
enable &quot;LINEMODE&quot;; useful with high latency links
<DT id="87">* [-]flusho<DD>
discard output
<DT id="88">[-]icanon<DD>
enable special characters: erase, kill, werase, rprnt
<DT id="89">[-]iexten<DD>
enable non-POSIX special characters
<DT id="90">[-]isig<DD>
enable interrupt, quit, and suspend special characters
<DT id="91">[-]noflsh<DD>
disable flushing after interrupt and quit special characters
<DT id="92">* [-]prterase<DD>
same as [-]echoprt
<DT id="93">* [-]tostop<DD>
stop background jobs that try to write to the terminal
<DT id="94">* [-]xcase<DD>
with icanon, escape with '\' for uppercase characters
</DL>
<A NAME="lbAK">&nbsp;</A>
<H3>Combination settings:</H3>
<DL COMPACT>
<DT id="95">* [-]LCASE<DD>
same as [-]lcase
<DT id="96">cbreak<DD>
same as <B>-icanon</B>
<DT id="97"><B>-cbreak</B><DD>
same as icanon
<DT id="98">cooked<DD>
same as brkint ignpar istrip icrnl ixon opost isig
icanon, eof and eol characters to their default values
<DT id="99"><B>-cooked</B><DD>
same as raw
<DT id="100">crt<DD>
same as echoe echoctl echoke
<DT id="101">dec<DD>
same as echoe echoctl echoke <B>-ixany</B> intr ^c erase 0177
kill ^u
<DT id="102">* [-]decctlq<DD>
same as [-]ixany
<DT id="103">ek<DD>
erase and kill characters to their default values
<DT id="104">evenp<DD>
same as parenb <B>-parodd</B> cs7
<DT id="105"><B>-evenp</B><DD>
same as <B>-parenb</B> cs8
<DT id="106">* [-]lcase<DD>
same as xcase iuclc olcuc
<DT id="107">litout<DD>
same as <B>-parenb</B> <B>-istrip</B> <B>-opost</B> cs8
<DT id="108"><B>-litout</B><DD>
same as parenb istrip opost cs7
<DT id="109">nl<DD>
same as <B>-icrnl</B> <B>-onlcr</B>
<DT id="110"><B>-nl</B><DD>
same as icrnl <B>-inlcr</B> <B>-igncr</B> onlcr <B>-ocrnl</B> <B>-onlret</B>
<DT id="111">oddp<DD>
same as parenb parodd cs7
<DT id="112"><B>-oddp</B><DD>
same as <B>-parenb</B> cs8
<DT id="113">[-]parity<DD>
same as [-]evenp
<DT id="114">pass8<DD>
same as <B>-parenb</B> <B>-istrip</B> cs8
<DT id="115"><B>-pass8</B><DD>
same as parenb istrip cs7
<DT id="116">raw<DD>
same as <B>-ignbrk</B> <B>-brkint</B> <B>-ignpar</B> <B>-parmrk</B> <B>-inpck</B> <B>-istrip</B>
<B>-inlcr</B> <B>-igncr</B> <B>-icrnl</B> <B>-ixon</B> <B>-ixoff</B> <B>-icanon</B> <B>-opost</B>
<B>-isig</B> <B>-iuclc</B> <B>-ixany</B> <B>-imaxbel</B> <B>-xcase</B> min 1 time 0
<DT id="117"><B>-raw</B><DD>
same as cooked
<DT id="118">sane<DD>
same as cread <B>-ignbrk</B> brkint <B>-inlcr</B> <B>-igncr</B> icrnl
icanon iexten echo echoe echok <B>-echonl</B> <B>-noflsh</B>
<B>-ixoff</B> <B>-iutf8</B> <B>-iuclc</B> <B>-ixany</B> imaxbel <B>-xcase</B> <B>-olcuc</B> <B>-ocrnl</B>
opost <B>-ofill</B> onlcr <B>-onocr</B> <B>-onlret</B> nl0 cr0 tab0 bs0 vt0 ff0
isig <B>-tostop</B> <B>-ofdel</B> <B>-echoprt</B> echoctl echoke <B>-extproc</B> <B>-flusho</B>,
all special characters to their default values
</DL>
<P>
Handle the tty line connected to standard input. Without arguments,
prints baud rate, line discipline, and deviations from stty sane. In
settings, CHAR is taken literally, or coded as in ^c, 0x37, 0177 or
127; special values ^- or undef used to disable special characters.
<A NAME="lbAL">&nbsp;</A>
<H2>AUTHOR</H2>
Written by David MacKenzie.
<A NAME="lbAM">&nbsp;</A>
<H2>REPORTING BUGS</H2>
GNU coreutils online help: &lt;<A HREF="https://www.gnu.org/software/coreutils/">https://www.gnu.org/software/coreutils/</A>&gt;
<BR>
Report stty translation bugs to &lt;<A HREF="https://translationproject.org/team/">https://translationproject.org/team/</A>&gt;
<A NAME="lbAN">&nbsp;</A>
<H2>COPYRIGHT</H2>
Copyright &#169; 2018 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later &lt;<A HREF="https://gnu.org/licenses/gpl.html">https://gnu.org/licenses/gpl.html</A>&gt;.
<BR>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
<A NAME="lbAO">&nbsp;</A>
<H2>SEE ALSO</H2>
Full documentation at: &lt;<A HREF="https://www.gnu.org/software/coreutils/stty">https://www.gnu.org/software/coreutils/stty</A>&gt;
<BR>
or available locally via: info '(coreutils) stty invocation'
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="119"><A HREF="#lbAB">NAME</A><DD>
<DT id="120"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="121"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT id="122"><A HREF="#lbAE">Special characters:</A><DD>
<DT id="123"><A HREF="#lbAF">Special settings:</A><DD>
<DT id="124"><A HREF="#lbAG">Control settings:</A><DD>
<DT id="125"><A HREF="#lbAH">Input settings:</A><DD>
<DT id="126"><A HREF="#lbAI">Output settings:</A><DD>
<DT id="127"><A HREF="#lbAJ">Local settings:</A><DD>
<DT id="128"><A HREF="#lbAK">Combination settings:</A><DD>
</DL>
<DT id="129"><A HREF="#lbAL">AUTHOR</A><DD>
<DT id="130"><A HREF="#lbAM">REPORTING BUGS</A><DD>
<DT id="131"><A HREF="#lbAN">COPYRIGHT</A><DD>
<DT id="132"><A HREF="#lbAO">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:27 GMT, March 31, 2021
</BODY>
</HTML>