uncat(1)                   OpenBSD Reference Manual                   uncat(1)



NAME
       uncat - continuously reads stdin, splits up the data either by timeout
       or number of bytes read to process it

SYNOPSIS
       uncat [-vo] [-t seconds] [-s size] prog

DESCRIPTION
       uncat continuously reads stdin and repeatedly processes the data either
       after seconds timeout or maximal number of bytes size read. To process
       the data, uncat starts prog and feeds the data into prog's standard
       input.  prog's standard output is redirected to standard error.  uncat
       never writes to standard output.

       prog consist of one or more arguments.

       If prog exits non-zero, uncat prints an error message, discards the
       data and continues to read stdin.

       Note that uncat is not crash proof.

       uncat is used to run the socklog-notify service.

OPTIONS
       -v     verbose. Print verbose messages to stderr.

       -o     once. Exit on end of input. Normally uncat continues waiting for
              data on standard input, even on end of file.

       -t seconds
              timeout. Set the timeout to seconds seconds. Default is 300.

       -s size
              Set the maximal number of bytes to size.  Default is 1024.

SIGNALS
       If uncat receives a TERM signal, it starts to process the data in
       memory and exits as soon as possible.

       uncat also does this on end of input if the -o option was given.

EXIT CODES
       uncat returns 0 after receiving a TERM signal.  uncat returns 111 on
       error.

SEE ALSO
       socklog(8), socklog-conf(8), sv(8), runsv(8), svlogd(8), tryto(1)

        http://smarden.org/socklog/
        http://smarden.org/runit/

AUTHOR
       Gerrit Pape <pape@smarden.org>



                                                                      uncat(1)
