diff options
Diffstat (limited to 'man')
-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> |