Man Linux: Main Page and Category List

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)