summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPádraig Brady <P@draigBrady.com>2016-01-04 12:13:40 +0000
committerPádraig Brady <P@draigBrady.com>2016-01-04 23:45:19 +0000
commit5171befcb122b12677f60715603be091625a9e08 (patch)
tree6f1dd7bdfb491ea7037204227804a2ed6c1f3df3 /doc
parentc6be0b39437890876692606c233b47a1751b40e9 (diff)
downloadcoreutils-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')
-rw-r--r--doc/coreutils.texi12
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{-}.