/usr/share/doc/socklog/uncat.1.html is in socklog 2.1.0-8.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 | <html>
<head>
<title>uncat(1) manual page</title>
</head>
<body bgcolor='white'>
<a href='http://smarden.org/pape/'>G. Pape</a><br><a href='index.html'>socklog</A><hr><p>
<h2><a name='sect0'>Name</a></h2>
uncat - continuously reads stdin, splits up the data either by timeout
or number of bytes read to process it
<h2><a name='sect1'>Synopsis</a></h2>
<b>uncat</b> [-vo] [-t <i>seconds</i>] [-s
<i>size</i>] <i>prog</i>
<h2><a name='sect2'>Description</a></h2>
<b>uncat</b> continuously reads stdin and repeatedly processes
the data either after <i>seconds</i> timeout or maximal number of bytes <i>size</i> read.
To process the data, <b>uncat</b> starts <i>prog</i> and feeds the data into <i>prog</i>’s standard
input. <i>prog</i>’s standard output is redirected to standard error. <b>uncat</b> never
writes to standard output. <p>
<i>prog</i> consist of one or more arguments. <p>
If <i>prog</i>
exits non-zero, <b>uncat</b> prints an error message, discards the data and continues
to read stdin. <p>
Note that <b>uncat</b> is not crash proof. <p>
<b>uncat</b> is used to run the
<i>socklog-notify</i> service.
<h2><a name='sect3'>Options</a></h2>
<dl>
<dt><b>-v</b> </dt>
<dd>verbose. Print verbose messages to stderr.
</dd>
<dt><b>-o</b> </dt>
<dd>once. Exit on end of input. Normally <b>uncat</b> continues waiting for data on
standard input, even on end of file. </dd>
<dt><b>-t <i>seconds</b> </i></dt>
<dd>timeout. Set the timeout to
<i>seconds</i> seconds. Default is 300. </dd>
<dt><b>-s <i>size</b> </i></dt>
<dd>Set the maximal number of bytes to
<i>size</i>. Default is 1024. </dd>
</dl>
<h2><a name='sect4'>Signals</a></h2>
If <b>uncat</b> receives a TERM signal, it starts
to process the data in memory and exits as soon as possible. <p>
<b>uncat</b> also
does this on end of input if the <b>-o</b> option was given.
<h2><a name='sect5'>Exit Codes</a></h2>
<b>uncat</b> returns
0 after receiving a TERM signal. <b>uncat</b> returns 111 on error.
<h2><a name='sect6'>See Also</a></h2>
<i>socklog(8)</i>,
<i>socklog-conf(8)</i>, <i>sv(8)</i>, <i>runsv(8)</i>, <i>svlogd(8)</i>, <i>tryto(1)</i> <p>
<i>http://smarden.org/socklog/</i><br>
<i>http://smarden.org/runit/</i><br>
<h2><a name='sect7'>Author</a></h2>
Gerrit Pape <pape@smarden.org> <p>
<hr><p>
<a name='toc'><b>Table of Contents</b></a><p>
<ul>
<li><a name='toc0' href='#sect0'>Name</a></li>
<li><a name='toc1' href='#sect1'>Synopsis</a></li>
<li><a name='toc2' href='#sect2'>Description</a></li>
<li><a name='toc3' href='#sect3'>Options</a></li>
<li><a name='toc4' href='#sect4'>Signals</a></li>
<li><a name='toc5' href='#sect5'>Exit Codes</a></li>
<li><a name='toc6' href='#sect6'>See Also</a></li>
<li><a name='toc7' href='#sect7'>Author</a></li>
</ul>
</body>
</html>
|