diff options
Diffstat (limited to 'doc/bin/system-ml.html')
| -rw-r--r-- | doc/bin/system-ml.html | 96 |
1 files changed, 96 insertions, 0 deletions
diff --git a/doc/bin/system-ml.html b/doc/bin/system-ml.html new file mode 100644 index 0000000..bc487a9 --- /dev/null +++ b/doc/bin/system-ml.html @@ -0,0 +1,96 @@ +<!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>system-ml</title> + <meta name="Description" content="Script to autogenerate loggers for the system supervision tree." /> + <meta name="Keywords" content="goetia longrun-make s6-rc logger log system supervision tree" /> + </head> + <header> + <p> + <a href="//0x53.net/software/goetia/goetia-base">goetia-base</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 system-ml program</h1> + <p> + system-ml automatically creates logging service + <a href="https://skarnet.org/software/s6-rc/s6-rc-compile.html#source">source directories</a> + for longrun services in the + <a href="//0x53.net/software/goetia/confdir.html#system">system configuration directory</a>. + To create the logging service source directories, + system-ml uses + <a href="./longrun-make.html">longrun-make</a> internally. + </p> + <h2>Interface</h2> + <pre> system-ml</pre> + <ul> + <li> + system-ml takes no arguments. + </li> + <li> + It deletes the <code>src/generated-logger</code> subdirectory of the + <a href="//0x53.net/software/goetia/confdir.html#system">system configuration directory</a>. + </li> + <li> + It scans the <code>src</code> subdirecotry of the + <a href="//0x53.net/software/goetia/confdir.html#system">system configuration directory</a> + for longrun services. + </li> + <li> + It checks for each longrun it detects, + whether its source directory contains a file <code>no-ml</code>. + If this file exits, this longrun is skipped in the subsequent logger generation. + </li> + <li> + It generates a logging service source directory at + <code>src/generated-logger/<var>@longrun@</var>-log</code> + in the <a href="//0x53.net/software/goetia/confdir.html#system">system configuration directory</a>. + It does so in parallel for each longrun <code><var>@longrun@</var>-srv</code> it found. + </li> + </ul> + <h2>Exit codes</h2> + <ul> + <li> + Since system-ml is an + <a href="https://skarnet.org/software/execline/">execline</a> + script, it exits with an approximation + of employed program that failed. + </li> + <li> + system-ml mostly uses + <a href="https://skarnet.org/software/execline/">execline</a> + and + <a href="https://skarnet.org/software/s6/">s6</a> + software, the exit behaviour of which can be looked up on + their respective pages. + </li> + <li> + See also: + <a href="https://skarnet.org/software/execline/exitcodes.html">execline exit code handling</a>. + </li> + </ul> + <h2>Options</h2> + <ul> + <li> + There are no options to system-ml. + </li> + </ul> + <h2>Notes</h2> + <p> + The logger services created by this script + will drop privileges to + <code><var>@loguser@</var></code>, + which must exist at runtime. + (see <a href="//0x53.net/software/goetia/logdir.html">log directory</a>). + </p> + </body> +</html> |