diff options
Diffstat (limited to 'man-pages-posix-2003/man1p/stty.1p')
-rw-r--r-- | man-pages-posix-2003/man1p/stty.1p | 702 |
1 files changed, 702 insertions, 0 deletions
diff --git a/man-pages-posix-2003/man1p/stty.1p b/man-pages-posix-2003/man1p/stty.1p new file mode 100644 index 0000000..64affc9 --- /dev/null +++ b/man-pages-posix-2003/man1p/stty.1p @@ -0,0 +1,702 @@ +.\" Copyright (c) 2001-2003 The Open Group, All Rights Reserved +.TH "STTY" 1P 2003 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" stty +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.SH NAME +stty \- set the options for a terminal +.SH SYNOPSIS +.LP +\fBstty\fP \fB[\fP \fB-a| -g\fP\fB]\fP\fB +.br +.sp +stty\fP \fIoperands\fP\fB +.br +\fP +.SH DESCRIPTION +.LP +The \fIstty\fP utility shall set or report on terminal I/O characteristics +for the device that is its standard input. Without +options or operands specified, it shall report the settings of certain +characteristics, usually those that differ from +implementation-defined defaults. Otherwise, it shall modify the terminal +state according to the specified operands. Detailed +information about the modes listed in the first five groups below +are described in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. Operands +in the Combination Modes group (see Combination Modes ) are implemented +using operands in the +previous groups. Some combinations of operands are mutually-exclusive +on some terminal types; the results of using such +combinations are unspecified. +.LP +Typical implementations of this utility require a communications line +configured to use the \fBtermios\fP interface defined in +the System Interfaces volume of IEEE\ Std\ 1003.1-2001. On systems +where none of these lines are available, and on lines +not currently configured to support the \fBtermios\fP interface, some +of the operands need not affect terminal +characteristics. +.SH OPTIONS +.LP +The \fIstty\fP utility shall conform to the Base Definitions volume +of IEEE\ Std\ 1003.1-2001, Section 12.2, Utility Syntax Guidelines. +.LP +The following options shall be supported: +.TP 7 +\fB-a\fP +Write to standard output all the current settings for the terminal. +.TP 7 +\fB-g\fP +Write to standard output all the current settings in an unspecified +form that can be used as arguments to another invocation of +the \fIstty\fP utility on the same system. The form used shall not +contain any characters that would require quoting to avoid word +expansion by the shell; see \fIWord Expansions\fP . +.sp +.SH OPERANDS +.LP +The following operands shall be supported to set the terminal characteristics. +.SS Control Modes +.TP 7 +\fBparenb\ \fP (\fB-parenb\fP) +Enable (disable) parity generation and detection. This shall have +the effect of setting (not setting) PARENB in the +\fBtermios\fP \fIc_cflag\fP field, as defined in the Base Definitions +volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBparodd\ \fP (\fB-parodd\fP) +.sp +Select odd (even) parity. This shall have the effect of setting (not +setting) PARODD in the \fBtermios\fP \fIc_cflag\fP field, as +defined in the Base Definitions volume of IEEE\ Std\ 1003.1-2001, +Chapter 11, +General Terminal Interface. +.TP 7 +\fBcs5\ cs6\ cs7\ cs8\fP +Select character size, if possible. This shall have the effect of +setting CS5, CS6, CS7, and CS8, respectively, in the +\fBtermios\fP \fIc_cflag\fP field, as defined in the Base Definitions +volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fInumber\fP +Set terminal baud rate to the number given, if possible. If the baud +rate is set to zero, the modem control lines shall no +longer be asserted. This shall have the effect of setting the input +and output \fBtermios\fP baud rate values as defined in the +Base Definitions volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General +Terminal Interface. +.TP 7 +\fBispeed\ \fP \fInumber\fP +Set terminal input baud rate to the number given, if possible. If +the input baud rate is set to zero, the input baud rate shall +be specified by the value of the output baud rate. This shall have +the effect of setting the input \fBtermios\fP baud rate values +as defined in the Base Definitions volume of IEEE\ Std\ 1003.1-2001, +Chapter +11, General Terminal Interface. +.TP 7 +\fBospeed\ \fP \fInumber\fP +Set terminal output baud rate to the number given, if possible. If +the output baud rate is set to zero, the modem control lines +shall no longer be asserted. This shall have the effect of setting +the output \fBtermios\fP baud rate values as defined in the +Base Definitions volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General +Terminal Interface. +.TP 7 +\fBhupcl\ \fP (\fB-hupcl\fP) +Stop asserting modem control lines (do not stop asserting modem control +lines) on last close. This shall have the effect of +setting (not setting) HUPCL in the \fBtermios\fP \fIc_cflag\fP field, +as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBhup\ \fP (\fB-hup\fP) +Equivalent to \fBhupcl\fP( \fB-hupcl\fP). +.TP 7 +\fBcstopb\ \fP (\fB-cstopb\fP) +Use two (one) stop bits per character. This shall have the effect +of setting (not setting) CSTOPB in the \fBtermios\fP +\fIc_cflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBcread\ \fP (\fB-cread\fP) +Enable (disable) the receiver. This shall have the effect of setting +(not setting) CREAD in the \fBtermios\fP \fIc_cflag\fP +field, as defined in the Base Definitions volume of IEEE\ Std\ 1003.1-2001, +Chapter 11, General Terminal Interface. +.TP 7 +\fBclocal\ \fP (\fB-clocal\fP) +Assume a line without (with) modem control. This shall have the effect +of setting (not setting) CLOCAL in the \fBtermios\fP +\fIc_cflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.sp +.LP +It is unspecified whether \fIstty\fP shall report an error if an attempt +to set a Control Mode fails. +.SS Input Modes +.TP 7 +\fBignbrk\ \fP (\fB-ignbrk\fP) +Ignore (do not ignore) break on input. This shall have the effect +of setting (not setting) IGNBRK in the \fBtermios\fP +\fIc_iflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBbrkint\ \fP (\fB-brkint\fP) +Signal (do not signal) INTR on break. This shall have the effect of +setting (not setting) BRKINT in the \fBtermios\fP +\fIc_iflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBignpar\ \fP (\fB-ignpar\fP) +Ignore (do not ignore) bytes with parity errors. This shall have the +effect of setting (not setting) IGNPAR in the +\fBtermios\fP \fIc_iflag\fP field, as defined in the Base Definitions +volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBparmrk\ \fP (\fB-parmrk\fP) +.sp +Mark (do not mark) parity errors. This shall have the effect of setting +(not setting) PARMRK in the \fBtermios\fP \fIc_iflag\fP +field, as defined in the Base Definitions volume of IEEE\ Std\ 1003.1-2001, +Chapter 11, General Terminal Interface. +.TP 7 +\fBinpck\ \fP (\fB-inpck\fP) +Enable (disable) input parity checking. This shall have the effect +of setting (not setting) INPCK in the \fBtermios\fP +\fIc_iflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBistrip\ \fP (\fB-istrip\fP) +Strip (do not strip) input characters to seven bits. This shall have +the effect of setting (not setting) ISTRIP in the +\fBtermios\fP \fIc_iflag\fP field, as defined in the Base Definitions +volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBinlcr\ \fP (\fB-inlcr\fP) +Map (do not map) NL to CR on input. This shall have the effect of +setting (not setting) INLCR in the \fBtermios\fP +\fIc_iflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBigncr\ (-igncr)\fP +Ignore (do not ignore) CR on input. This shall have the effect of +setting (not setting) IGNCR in the \fBtermios\fP +\fIc_iflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBicrnl\ \fP (\fB-icrnl\fP) +Map (do not map) CR to NL on input. This shall have the effect of +setting (not setting) ICRNL in the \fBtermios\fP +\fIc_iflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBixon\ \fP (\fB-ixon\fP) +Enable (disable) START/STOP output control. Output from the system +is stopped when the system receives STOP and started when +the system receives START. This shall have the effect of setting (not +setting) IXON in the \fBtermios\fP \fIc_iflag\fP field, as +defined in the Base Definitions volume of IEEE\ Std\ 1003.1-2001, +Chapter 11, +General Terminal Interface. +.TP 7 +\fBixany\ \fP (\fB-ixany\fP) +Allow any character to restart output. This shall have the effect +of setting (not setting) IXANY in the \fBtermios\fP +\fIc_iflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBixoff\ \fP (\fB-ixoff\fP) +Request that the system send (not send) STOP characters when the input +queue is nearly full and START characters to resume data +transmission. This shall have the effect of setting (not setting) +IXOFF in the \fBtermios\fP \fIc_iflag\fP field, as defined in +the Base Definitions volume of IEEE\ Std\ 1003.1-2001, Chapter 11, +General +Terminal Interface. +.sp +.SS Output Modes +.TP 7 +\fBopost\ \fP (\fB-opost\fP) +Post-process output (do not post-process output; ignore all other +output modes). This shall have the effect of setting (not +setting) OPOST in the \fBtermios\fP \fIc_oflag\fP field, as defined +in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBocrnl\ \fP (\fB-ocrnl\fP) +Map (do not map) CR to NL on output This shall have the effect of +setting (not setting) OCRNL in the \fBtermios\fP \fIc_oflag\fP +field, as defined in the Base Definitions volume of IEEE\ Std\ 1003.1-2001, +Chapter 11, General Terminal Interface. +.TP 7 +\fBonocr\ \fP (\fB-onocr\fP) +Do not (do) output CR at column zero. This shall have the effect of +setting (not setting) ONOCR in the \fBtermios\fP +\fIc_oflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBonlret\ \fP (\fB-onlret\fP) +The terminal newline key performs (does not perform) the CR function. +This shall have the effect of setting (not setting) +ONLRET in the \fBtermios\fP \fIc_oflag\fP field, as defined in the +Base Definitions volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General +Terminal Interface. +.TP 7 +\fBofill\ \fP (\fB-ofill\fP) +Use fill characters (use timing) for delays. This shall have the effect +of setting (not setting) OFILL in the \fBtermios\fP +\fIc_oflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBofdel\ \fP (\fB-ofdel\fP) +Fill characters are DELs (NULs). This shall have the effect of setting +(not setting) OFDEL in the \fBtermios\fP \fIc_oflag\fP +field, as defined in the Base Definitions volume of IEEE\ Std\ 1003.1-2001, +Chapter 11, General Terminal Interface. +.TP 7 +\fBcr0\ cr1\ cr2\ cr3\fP +Select the style of delay for CRs. This shall have the effect of setting +CRDLY to CR0, CR1, CR2, or CR3, respectively, in the +\fBtermios\fP \fIc_oflag\fP field, as defined in the Base Definitions +volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBnl0\ nl1\fP +Select the style of delay for NL. This shall have the effect of setting +NLDLY to NL0 or NL1, respectively, in the +\fBtermios\fP \fIc_oflag\fP field, as defined in the Base Definitions +volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBtab0\ tab1\ tab2\ tab3\fP +.sp +Select the style of delay for horizontal tabs. This shall have the +effect of setting TABDLY to TAB0, TAB1, TAB2, or TAB3, +respectively, in the \fBtermios\fP \fIc_oflag\fP field, as defined +in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. Note +that +TAB3 has the effect of expanding <tab>s to <space>s. +.TP 7 +\fBtabs\ \fP (\fB-tabs\fP) +Synonym for \fBtab0\fP ( \fBtab3\fP). +.TP 7 +\fBbs0\ bs1\fP +Select the style of delay for backspaces. This shall have the effect +of setting BSDLY to BS0 or BS1, respectively, in the +\fBtermios\fP \fIc_oflag\fP field, as defined in the Base Definitions +volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBff0\ ff1\fP +Select the style of delay for form-feeds. This shall have the effect +of setting FFDLY to FF0 or FF1, respectively, in the +\fBtermios\fP \fIc_oflag\fP field, as defined in the Base Definitions +volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBvt0\ vt1\fP +Select the style of delay for vertical-tabs. This shall have the effect +of setting VTDLY to VT0 or VT1, respectively, in the +\fBtermios\fP \fIc_oflag\fP field, as defined in the Base Definitions +volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.sp +.SS Local Modes +.TP 7 +\fBisig\ \fP (\fB-isig\fP) +Enable (disable) the checking of characters against the special control +characters INTR, QUIT, and SUSP. This shall have the +effect of setting (not setting) ISIG in the \fBtermios\fP \fIc_lflag\fP +field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBicanon\ \fP (\fB-icanon\fP) +Enable (disable) canonical input (ERASE and KILL processing). This +shall have the effect of setting (not setting) ICANON in the +\fBtermios\fP \fIc_lflag\fP field, as defined in the Base Definitions +volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBiexten\ \fP (\fB-iexten\fP) +Enable (disable) any implementation-defined special control characters +not currently controlled by \fBicanon\fP, \fBisig\fP, +\fBixon\fP, or \fBixoff\fP. This shall have the effect of setting +(not setting) IEXTEN in the \fBtermios\fP \fIc_lflag\fP +field, as defined in the Base Definitions volume of IEEE\ Std\ 1003.1-2001, +Chapter 11, General Terminal Interface. +.TP 7 +\fBecho\ \fP (\fB-echo\fP) +Echo back (do not echo back) every character typed. This shall have +the effect of setting (not setting) ECHO in the +\fBtermios\fP \fIc_lflag\fP field, as defined in the Base Definitions +volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBechoe\ \fP (\fB-echoe\fP) +The ERASE character visually erases (does not erase) the last character +in the current line from the display, if possible. This +shall have the effect of setting (not setting) ECHOE in the \fBtermios\fP +\fIc_lflag\fP field, as defined in the Base Definitions +volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal +Interface. +.TP 7 +\fBechok\ \fP (\fB-echok\fP) +Echo (do not echo) NL after KILL character. This shall have the effect +of setting (not setting) ECHOK in the \fBtermios\fP +\fIc_lflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBechonl\ \fP (\fB-echonl\fP) +Echo (do not echo) NL, even if \fBecho\fP is disabled. This shall +have the effect of setting (not setting) ECHONL in the +\fBtermios\fP \fIc_lflag\fP field, as defined in the Base Definitions +volume of IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBnoflsh\ \fP (\fB-noflsh\fP) +Disable (enable) flush after INTR, QUIT, SUSP. This shall have the +effect of setting (not setting) NOFLSH in the \fBtermios\fP +\fIc_lflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.TP 7 +\fBtostop\ \fP (\fB-tostop\fP) +Send SIGTTOU for background output. This shall have the effect of +setting (not setting) TOSTOP in the \fBtermios\fP +\fIc_lflag\fP field, as defined in the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface. +.sp +.SS Special Control Character Assignments +.TP 7 +<\fIcontrol\fP>-\fIcharacter\ string\fP +.sp +Set <\fIcontrol\fP>-\fIcharacter\fP to \fIstring\fP. If <\fIcontrol\fP>-\fIcharacter\fP +is one of the character +sequences in the first column of the following table, the corresponding +Base Definitions volume of IEEE\ Std\ 1003.1-2001, +Chapter 11, General Terminal Interface control character from the +second column +shall be recognized. This has the effect of setting the corresponding +element of the \fBtermios\fP \fIc_cc\fP array (see the Base +Definitions volume of IEEE\ Std\ 1003.1-2001, Chapter 13, Headers, +\fI<termios.h>\fP). +.br +.sp +.ce 1 +\fBTable: Control Character Names in \fIstty\fP\fP +.TS C +center; l2 l2 l. +\fBControl Character\fP \fBc_cc Subscript\fP \fBDescription\fP +\fBeof\fP VEOF EOF character +\fBeol\fP VEOL EOL character +\fBerase\fP VERASE ERASE character +\fBintr\fP VINTR INTR character +\fBkill\fP VKILL KILL character +\fBquit\fP VQUIT QUIT character +\fBsusp\fP VSUSP SUSP character +\fBstart\fP VSTART START character +\fBstop\fP VSTOP STOP character +.TE +.LP +If \fIstring\fP is a single character, the control character shall +be set to that character. If \fIstring\fP is the +two-character sequence \fB"^-"\fP or the string \fIundef\fP, the control +character shall be set to _POSIX_VDISABLE, if it is +in effect for the device; if _POSIX_VDISABLE is not in effect for +the device, it shall be treated as an error. In the POSIX locale, +if \fIstring\fP is a two-character sequence beginning with circumflex +( \fB'^'\fP ), and the second character is one of those +listed in the \fB"^c"\fP column of the following table, the control +character shall be set to the corresponding character value +in the Value column of the table. +.sp +.ce 1 +\fBTable: Circumflex Control Characters in \fIstty\fP\fP +.TS C +center; l l l l l l. +\fB^c\fP \fBValue\fP \fB^c\fP \fBValue\fP \fB^c\fP \fBValue\fP +a, A <SOH> l, L <FF> w, W <ETB> +b, B <STX> m, M <CR> x, X <CAN> +c, C <ETX> n, N <SO> y, Y <EM> +d, D <EOT> o, O <SI> z, Z <SUB> +e, E <ENQ> p, P <DLE> [ <ESC> +f, F <ACK> q, Q <DC1> \\ <FS> +g, G <BEL> r, R <DC2> ] <GS> +h, H <BS> s, S <DC3> ^ <RS> +i, I <HT> t, T <DC4> _ <US> +j, J <LF> u, U <NAK> ? <DEL> +k, K <VT> v, V <SYN> +.TE +.TP 7 +\fBmin\ \fP \fInumber\fP +.sp +Set the value of MIN to \fInumber\fP. MIN is used in non-canonical +mode input processing ( \fBicanon\fP). +.TP 7 +\fBtime\ \fP \fInumber\fP +.sp +Set the value of TIME to \fInumber\fP. TIME is used in non-canonical +mode input processing ( \fBicanon\fP). +.sp +.SS Combination Modes +.TP 7 +\fIsaved\ settings\fP +.sp +Set the current terminal characteristics to the saved settings produced +by the \fB-g\fP option. +.TP 7 +\fBevenp\fP\ or\ \fBparity\fP +.sp +Enable \fBparenb\fP and \fBcs7\fP; disable \fBparodd\fP. +.TP 7 +\fBoddp\fP +.sp +Enable \fBparenb\fP, \fBcs7\fP, and \fBparodd\fP. +.TP 7 +\fB-parity\fP, \fB-evenp\fP, or \fB-oddp\fP +.sp +Disable \fBparenb\fP, and set \fBcs8\fP. +.TP 7 +\fBraw\ \fP (\fB-raw\fP\ or\ \fBcooked\fP) +.sp +Enable (disable) raw input and output. Raw mode shall be equivalent +to setting: +.sp +.RS +.nf + +\fBstty cs8 erase ^- kill ^- intr ^- \\ + quit ^- eof ^- eol ^- -post -inpck +\fP +.fi +.RE +.TP 7 +\fBnl\ \fP (\fB-nl\fP) +.sp +Disable (enable) \fBicrnl\fP. In addition, \fB-nl\fP unsets \fBinlcr\fP +and \fBigncr\fP. +.TP 7 +\fBek\fP +Reset ERASE and KILL characters back to system defaults. +.TP 7 +\fBsane\fP +.sp +Reset all modes to some reasonable, unspecified, values. +.sp +.SH STDIN +.LP +Although no input is read from standard input, standard input shall +be used to get the current terminal I/O characteristics and +to set new terminal I/O characteristics. +.SH INPUT FILES +.LP +None. +.SH ENVIRONMENT VARIABLES +.LP +The following environment variables shall affect the execution of +\fIstty\fP: +.TP 7 +\fILANG\fP +Provide a default value for the internationalization variables that +are unset or null. (See the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Section 8.2, Internationalization Variables +for +the precedence of internationalization variables used to determine +the values of locale categories.) +.TP 7 +\fILC_ALL\fP +If set to a non-empty string value, override the values of all the +other internationalization variables. +.TP 7 +\fILC_CTYPE\fP +This variable determines the locale for the interpretation of sequences +of bytes of text data as characters (for example, +single-byte as opposed to multi-byte characters in arguments) and +which characters are in the class \fBprint\fP. +.TP 7 +\fILC_MESSAGES\fP +Determine the locale that should be used to affect the format and +contents of diagnostic messages written to standard +error. +.TP 7 +\fINLSPATH\fP +Determine the location of message catalogs for the processing of \fILC_MESSAGES +\&.\fP +.sp +.SH ASYNCHRONOUS EVENTS +.LP +Default. +.SH STDOUT +.LP +If operands are specified, no output shall be produced. +.LP +If the \fB-g\fP option is specified, \fIstty\fP shall write to standard +output the current settings in a form that can be used +as arguments to another instance of \fIstty\fP on the same system. +.LP +If the \fB-a\fP option is specified, all of the information as described +in the OPERANDS section shall be written to standard +output. Unless otherwise specified, this information shall be written +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 written. +.LP +If no options or operands are specified, an unspecified subset of +the information written for the \fB-a\fP option shall be +written. +.LP +If speed information is written as part of the default output, or +if the \fB-a\fP option is specified and if the terminal input +speed and output speed are the same, the speed information shall be +written as follows: +.sp +.RS +.nf + +\fB"speed %d baud;", <\fP\fIspeed\fP\fB> +\fP +.fi +.RE +.LP +Otherwise, speeds shall be written as: +.sp +.RS +.nf + +\fB"ispeed %d baud; ospeed %d baud;", <\fP\fIispeed\fP\fB>, <\fP\fIospeed\fP\fB> +\fP +.fi +.RE +.LP +In locales other than the POSIX locale, the word \fBbaud\fP may be +changed to something more appropriate in those locales. +.LP +If control characters are written as part of the default output, or +if the \fB-a\fP option is specified, control characters +shall be written as: +.sp +.RS +.nf + +\fB"%s = %s;", <\fP\fIcontrol-character name\fP\fB>, <\fP\fIvalue\fP\fB> +\fP +.fi +.RE +.LP +where <\fIvalue\fP> is either the character, or some visual representation +of the character if it is non-printable, or +the string \fIundef\fP if the character is disabled. +.SH STDERR +.LP +The standard error shall be used only for diagnostic messages. +.SH OUTPUT FILES +.LP +None. +.SH EXTENDED DESCRIPTION +.LP +None. +.SH EXIT STATUS +.LP +The following exit values shall be returned: +.TP 7 +\ 0 +The terminal options were read or set successfully. +.TP 7 +>0 +An error occurred. +.sp +.SH CONSEQUENCES OF ERRORS +.LP +Default. +.LP +\fIThe following sections are informative.\fP +.SH APPLICATION USAGE +.LP +The \fB-g\fP flag is designed to facilitate the saving and restoring +of terminal state from the shell level. For example, a +program may: +.sp +.RS +.nf + +\fBsaveterm="$(stty -g)" # save terminal state +stty\fP \fI(new settings)\fP \fB # set new state +\&... # ... +stty $saveterm # restore terminal state +\fP +.fi +.RE +.LP +Since the format is unspecified, the saved value is not portable across +systems. +.LP +Since the \fB-a\fP format is so loosely specified, scripts that save +and restore terminal settings should use the \fB-g\fP +option. +.SH EXAMPLES +.LP +None. +.SH RATIONALE +.LP +The original \fIstty\fP description was taken directly from System +V and reflected the System V terminal driver \fBtermio\fP. +It has been modified to correspond to the terminal driver \fBtermios\fP. +.LP +Output modes are specified only for XSI-conformant systems. All implementations +are expected to provide \fIstty\fP operands +corresponding to all of the output modes they support. +.LP +The \fIstty\fP utility is primarily used to tailor the user interface +of the terminal, such as selecting the preferred ERASE +and KILL characters. As an application programming utility, \fIstty\fP +can be used within shell scripts to alter the terminal +settings for the duration of the script. +.LP +The \fBtermios\fP section states that individual disabling of control +characters is possible through the option +_POSIX_VDISABLE. If enabled, two conventions currently exist for specifying +this: System V uses \fB"^-"\fP, and BSD uses +\fIundef\fP. Both are accepted by \fIstty\fP in this volume of IEEE\ Std\ 1003.1-2001. +The other BSD convention of using +the letter \fB'u'\fP was rejected because it conflicts with the actual +letter \fB'u'\fP, which is an acceptable value for a +control character. +.LP +Early proposals did not specify the mapping of \fB"^c"\fP to control +characters because the control characters were not +specified in the POSIX locale character set description file requirements. +The control character set is now specified in the Base +Definitions volume of IEEE\ Std\ 1003.1-2001, Chapter 3, Definitions +so the +historical mapping is specified. Note that although the mapping corresponds +to control-character key assignments on many terminals +that use the ISO/IEC\ 646:1991 standard (or ASCII) character encodings, +the mapping specified here is to the control +characters, not their keyboard encodings. +.LP +Since \fBtermios\fP supports separate speeds for input and output, +two new options were added to specify each distinctly. +.LP +Some historical implementations use standard input to get and set +terminal characteristics; others use standard output. Since +input from a login TTY is usually restricted to the owner while output +to a TTY is frequently open to anyone, using standard input +provides fewer chances of accidentally (or maliciously) altering the +terminal settings of other users. Using standard input also +allows \fIstty\fP \fB-a\fP and \fIstty\fP \fB-g\fP output to be redirected +for later use. Therefore, usage of standard input is +required by this volume of IEEE\ Std\ 1003.1-2001. +.SH FUTURE DIRECTIONS +.LP +None. +.SH SEE ALSO +.LP +\fIShell Command Language\fP, the Base Definitions volume of +IEEE\ Std\ 1003.1-2001, Chapter 11, General Terminal Interface, \fI<termios.h>\fP +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. In the +event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . |