/usr/share/doc/socklog/socklog-check.8.html is in socklog 2.1.0-8.
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 | <html>
<head>
<title>socklog-check(8) 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>
socklog-check - checks for the availability of a <i>socklog(8)</i> service.
<h2><a name='sect1'>Synopsis</a></h2>
<b>socklog-check</b>
[-v] [unix [<i>address]]</i>
<h2><a name='sect2'>Description</a></h2>
<b>socklog-check</b> attempts to connect to a <i><b>socklog</b>(8)</i>
unix service and reports whether the connection attempt succeeded or not.
<p>
It connects to the datagram oriented unix domain socket <i>address</i>, and reports
success through the return code. If <i>address</i> is not specified, <b>socklog-check</b>
attempts to connect to <i>/dev/log</i>. <p>
When running services that use the syslog
facility under runit’s service supervision, <b>socklog-check</b> should be added
to the top of the service’s run script to ensure that no syslog messages
are generated until a syslog service is up and running to process the messages,
e.g.: <p>
#!/bin/sh<br>
socklog-check || exit 1<br>
exec service_using_syslog <br>
<h2><a name='sect3'>Options</a></h2>
<dl>
<dt><b>-v</b> </dt>
<dd>verbose. Print verbose message to standard error. </dd>
</dl>
<h2><a name='sect4'>Exit Codes</a></h2>
On
success <b>socklog-check</b> returns 0. <p>
On error, <b>socklog-check</b> prints a message
to standard error and exits 111.
<h2><a name='sect5'>See Also</a></h2>
<i>socklog(8)</i>, <i>socklog-conf(8)</i>, <i>svlogd(8)</i>,
<i>tryto(1)</i>, <i>uncat(1)</i>, <i>sv(8)</i>, <i>runsv(8)</i>, <i>runsvdir(8)</i> <p>
<i>http://smarden.org/socklog/</i><br>
<i>http://smarden.org/runit/</i><br>
<h2><a name='sect6'>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'>Exit Codes</a></li>
<li><a name='toc5' href='#sect5'>See Also</a></li>
<li><a name='toc6' href='#sect6'>Author</a></li>
</ul>
</body>
</html>
|