diff options
| author | Pádraig Brady <P@draigBrady.com> | 2016-01-04 12:13:40 +0000 |
|---|---|---|
| committer | Pádraig Brady <P@draigBrady.com> | 2016-01-04 23:45:19 +0000 |
| commit | 5171befcb122b12677f60715603be091625a9e08 (patch) | |
| tree | 6f1dd7bdfb491ea7037204227804a2ed6c1f3df3 /doc/coreutils.texi | |
| parent | c6be0b39437890876692606c233b47a1751b40e9 (diff) | |
| download | coreutils-5171befcb122b12677f60715603be091625a9e08.tar.xz | |
stty: support -I, --immediate to not wait for pending transmission
In some cases an initial drain may block indefinitely as discussed at:
http://lists.gnu.org/archive/html/coreutils/2016-01/msg00007.html
* src/stty.c (main): Use TCSANOW rather than TCSADRAIN if -I specified.
(usage): Document the new option.
* doc/coreutils.texi (stty invocation): Likewise.
* tests/misc/stty.sh: Ensure -I is supported.
* NEWS: Mention the new feature.
Diffstat (limited to 'doc/coreutils.texi')
| -rw-r--r-- | doc/coreutils.texi | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 62955a508..85477a05a 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -13808,6 +13808,18 @@ Print all current settings in a form that can be used as an argument to another @command{stty} command to restore the current settings. This option may not be used in combination with any line settings. +@item -I +@itemx --immediate +@opindex -I +@opindex --immediate +@cindex nonblocking @command{stty} setting +Apply settings without first waiting for pending output to be transmitted. +In some cases the system may be in a state where serial transmission +is not possible. +For example, if the system has received the @samp{DC3} character +with @code{ixon} (software flow control) enabled, then @command{stty} would +block without this option. + @end table Many settings can be turned off by preceding them with a @samp{-}. |