aboutsummaryrefslogtreecommitdiff
path: root/man/man1/oii.1df
blob: f5bb26787c11e981aad9c0a1d8c5ab38051d2be2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
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>