From a9e25e51ca3c96d3b5bfc86ab5a45c5bee818152 Mon Sep 17 00:00:00 2001 From: Tom Ryder Date: Thu, 29 Jun 2017 17:46:34 +1200 Subject: Add oii(1df) --- man/man1/oii.1df | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 man/man1/oii.1df (limited to 'man/man1/oii.1df') 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 -- cgit v1.2.3