diff options
Diffstat (limited to 'doc/source')
| -rw-r--r-- | doc/source/system/other/local.html | 69 | ||||
| -rw-r--r-- | doc/source/system/other/syslog-priv.html | 39 | ||||
| -rw-r--r-- | doc/source/system/other/syslog.html | 39 |
3 files changed, 147 insertions, 0 deletions
diff --git a/doc/source/system/other/local.html b/doc/source/system/other/local.html new file mode 100644 index 0000000..29c25e5 --- /dev/null +++ b/doc/source/system/other/local.html @@ -0,0 +1,69 @@ +<!DOCTYPE html> +<html> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <meta http-equiv="Content-Language" content="en" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <title>local service</title> + <meta name="Description" content="System oneshot that executes scripts." /> + <meta name="Keywords" content="goetia s6-rc FreeBSD script system supervision tree" /> + </head> + <header> + <p> + <a href="//0x53.net/software/goetia/goetia-freebsd">goetia-freebsd</a> + <br /> + <a href="//0x53.net/software/goetia">goetia</a> + <br /> + <a href="//0x53.net/software">Software</a> + <br /> + <a href="//0x53.net">0x53.net</a> + </p> + </header> + <body> + <h1>The local service</h1> + <p> + local is a + <a href="https://skarnet.org/software/s6-rc/s6-rc-compile.html#source">oneshot service</a>. + </p> + <ul> + <li> + It tries to execute all + files <code>/etc/local.d/*.up</code> + when it is started (typically during boot). + </li> + <li> + It tries to execute all files <code>/etc/local.d/*.down</code> + when it is stopped (typically during shutdown). + </li> + </ul> + <p> + The files are executed in random order + and in parallel. + </p> + <section id="examples"> + <h2>Examples</h2> + <p> + An executable file <code>/etc/local.d/echo.up</code> + with the content + <pre> +#!/bin/execlineb -P + +echo "example" + </pre> + would be executed and write "example" to the system log + upon starting the service local. + </p> + <p> + An executable file <code>/etc/local.d/echo.down</code> + with the content + <pre> +#!/bin/execlineb -P + +echo "example" + </pre> + would be executed and write "example" to the system log + upon stopping the service local. + </p> + </section> + </body> +</html> diff --git a/doc/source/system/other/syslog-priv.html b/doc/source/system/other/syslog-priv.html new file mode 100644 index 0000000..f73df27 --- /dev/null +++ b/doc/source/system/other/syslog-priv.html @@ -0,0 +1,39 @@ +<!DOCTYPE html> +<html> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <meta http-equiv="Content-Language" content="en" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <title>syslog-priv service</title> + <meta name="Description" content="System longrun to emulate syslog on the priv socket." /> + <meta name="Keywords" content="goetia s6-rc FreeBSD syslog priv system supervision tree" /> + </head> + <header> + <p> + <a href="//0x53.net/software/goetia/goetia-freebsd">goetia-freebsd</a> + <br /> + <a href="//0x53.net/software/goetia">goetia</a> + <br /> + <a href="//0x53.net/software">Software</a> + <br /> + <a href="//0x53.net">0x53.net</a> + </p> + </header> + <body> + <h1>The syslog-priv service</h1> + <p> + syslog-priv is a + <a href="https://skarnet.org/software/s6-rc/s6-rc-compile.html#source">longrun service</a> + to support legacy applications + that only support logging through a syslog socket. + </p> + <p> + It runs an instance of + <a href="https://skarnet.org/software/s6/s6-socklog.html">s6-socklog</a> + with the socket set to <code>/var/run/logpriv</code>. + The logs are then processed by + <a href="https://skarnet.org/software/s6/s6-log.html">s6-log</a> + (see <a href="//0x53.net/software/goetia/logdir.html">logging directory</a>). + </p> + </body> +</html> diff --git a/doc/source/system/other/syslog.html b/doc/source/system/other/syslog.html new file mode 100644 index 0000000..14be6c3 --- /dev/null +++ b/doc/source/system/other/syslog.html @@ -0,0 +1,39 @@ +<!DOCTYPE html> +<html> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <meta http-equiv="Content-Language" content="en" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <title>syslog service</title> + <meta name="Description" content="System longrun to emulate syslog." /> + <meta name="Keywords" content="goetia s6-rc FreeBSD syslog system supervision tree" /> + </head> + <header> + <p> + <a href="//0x53.net/software/goetia/goetia-freebsd">goetia-freebsd</a> + <br /> + <a href="//0x53.net/software/goetia">goetia</a> + <br /> + <a href="//0x53.net/software">Software</a> + <br /> + <a href="//0x53.net">0x53.net</a> + </p> + </header> + <body> + <h1>The syslog service</h1> + <p> + syslog is a + <a href="https://skarnet.org/software/s6-rc/s6-rc-compile.html#source">longrun service</a> + to support legacy applications + that only support logging through a syslog socket. + </p> + <p> + It runs an instance of + <a href="https://skarnet.org/software/s6/s6-socklog.html">s6-socklog</a> + with the socket set to <code>/var/run/log</code>. + The logs are then processed by + <a href="https://skarnet.org/software/s6/s6-log.html">s6-log</a> + (see <a href="//0x53.net/software/goetia/logdir.html">logging directory</a>). + </p> + </body> +</html> |