aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorTom Ryder <tom@sanctum.geek.nz>2017-06-29 17:46:34 +1200
committerTom Ryder <tom@sanctum.geek.nz>2017-06-29 17:46:34 +1200
commita9e25e51ca3c96d3b5bfc86ab5a45c5bee818152 (patch)
tree83af4372bd66751ed959db5af3ebfdb63fdcc431 /man
parentAdd id_ed25519 keys to keychain (diff)
downloaddotfiles-a9e25e51ca3c96d3b5bfc86ab5a45c5bee818152.tar.gz
dotfiles-a9e25e51ca3c96d3b5bfc86ab5a45c5bee818152.zip
Add oii(1df)
Diffstat (limited to 'man')
-rw-r--r--man/man1/oii.1df21
1 files changed, 21 insertions, 0 deletions
diff --git a/man/man1/oii.1df b/man/man1/oii.1df
new file mode 100644
index 00000000..f5bb2678
--- /dev/null
+++ b/man/man1/oii.1df
@@ -0,0 +1,21 @@
+.TH OII 1df "June 2017" "Manual page for oii"
+.SH NAME
+.B oii
+\- run a command on input only if there's at least one byte of input
+.SH USAGE
+.B oii
+CMD [ARGS ...] < file
+.br
+program |
+.B oii
+CMD [ARGS ...]
+.SH DESCRIPTION
+Run the given program passing in stdin but only if at least one byte of input
+is actually received, rather like the -E switch to mail(1) behaves on
+bsd-mailx. If no input is received, exit silently with an error status.
+.SH CAVEATS
+It's slow, and doesn't work as a pipe. The entire input is written to disk and
+then tested for filesize before being re-emitted. There's almost certainly a
+more efficient way to do this while still remaining byte-safe.
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>