diff options
author | Tom Ryder <tom@sanctum.geek.nz> | 2017-06-29 17:46:34 +1200 |
---|---|---|
committer | Tom Ryder <tom@sanctum.geek.nz> | 2017-06-29 17:46:34 +1200 |
commit | a9e25e51ca3c96d3b5bfc86ab5a45c5bee818152 (patch) | |
tree | 83af4372bd66751ed959db5af3ebfdb63fdcc431 /man/man1 | |
parent | Add id_ed25519 keys to keychain (diff) | |
download | dotfiles-a9e25e51ca3c96d3b5bfc86ab5a45c5bee818152.tar.gz dotfiles-a9e25e51ca3c96d3b5bfc86ab5a45c5bee818152.zip |
Add oii(1df)
Diffstat (limited to 'man/man1')
-rw-r--r-- | man/man1/oii.1df | 21 |
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> |