aboutsummaryrefslogtreecommitdiffstats
path: root/doc/service/system
diff options
context:
space:
mode:
Diffstat (limited to 'doc/service/system')
-rw-r--r--doc/service/system/goetia-runner.html44
-rw-r--r--doc/service/system/s6-svscan-log-console.html50
-rw-r--r--doc/service/system/s6-svscan-log.html37
3 files changed, 131 insertions, 0 deletions
diff --git a/doc/service/system/goetia-runner.html b/doc/service/system/goetia-runner.html
new file mode 100644
index 0000000..16abb52
--- /dev/null
+++ b/doc/service/system/goetia-runner.html
@@ -0,0 +1,44 @@
+<!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 goetia-runner</title>
+ <meta name="Description" content="System service for running little scripts from the system supervision tree." />
+ <meta name="Keywords" content="goetia s6 service run 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 goetia-runner service</h1>
+ <p>
+ This service allows to hand of execution of a commandline to the
+ <a href="//0x53.net/software/goetia/supervisiontree.html#system">system supervision tree</a>.
+ It is the "server side" counterpart to
+ <a href="//0x53.net/software/goetia/goetia-base/bin/system-run.html">system-run</a>.
+ To achieve that,
+ goetia-runner makes use of
+ <a href="https://skarnet.org/software/s6/s6-ipcserver.html">s6-ipcserver</a>
+ and
+ <a href="https://skarnet.org/software/s6/s6-sudod.html">s6-sudod</a>.
+ </p>
+ <p>
+ An example would be the
+ <a href="//0x53.net/software/goetia/goetia-base/bin/system-rc.html">system-rc</a>
+ command invoking state transitions that might bring down
+ the user interface
+ (thus aborting mid-transition,
+ since the controlling terminal dies).
+ </p>
+ </body>
+</html>
diff --git a/doc/service/system/s6-svscan-log-console.html b/doc/service/system/s6-svscan-log-console.html
new file mode 100644
index 0000000..eff7b14
--- /dev/null
+++ b/doc/service/system/s6-svscan-log-console.html
@@ -0,0 +1,50 @@
+<!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 s6-svscan-log-console</title>
+ <meta name="Description" content="System service for catch-all-logging that duplicates logs to /dev/console." />
+ <meta name="Keywords" content="goetia s6 log console 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 s6-svscan-log-console service</h1>
+ <p>
+ This service writes all messages
+ that arrive at the
+ <a href="https://skarnet.org/software/s6/s6-svscan.html">s6-svscan</a>
+ process, as well as the stdout
+ of s6-svscan itself to a directory of the logdir format
+ (see <a href="https://skarnet.org/software/s6/s6-log.html">s6-log</a>
+ and
+ <a href="//0x53.net/software/goetia/logdir.html">logging directory</a>).
+ It writes them to the <code>system/logs/uncaught-logs</code> subdirectory
+ of the <a href="//0x53.net/software/goetia/rundir.html">runtime directory</a>.
+ </p>
+ <p>
+ Additionally, all logs are duplicated to
+ <code>/dev/console</code>.
+ </p>
+ <section id="requirements">
+ <h2>Requirements</h2>
+ <ul>
+ <li>
+ The file <code>/dev/console</code>
+ must be tha appropriate device node.
+ </li>
+ </ul>
+ </section>
+ </body>
+</html>
diff --git a/doc/service/system/s6-svscan-log.html b/doc/service/system/s6-svscan-log.html
new file mode 100644
index 0000000..9d034dc
--- /dev/null
+++ b/doc/service/system/s6-svscan-log.html
@@ -0,0 +1,37 @@
+<!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 s6-svscan-log</title>
+ <meta name="Description" content="System service for catch-all-logging the system supervision tree." />
+ <meta name="Keywords" content="goetia s6 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 s6-svscan-log service</h1>
+ <p>
+ This service writes all messages
+ that arrive at the
+ <a href="https://skarnet.org/software/s6/s6-svscan.html">s6-svscan</a>
+ process, as well as the stdout
+ of s6-svscan itself to a directory of the logdir format
+ (see <a href="https://skarnet.org/software/s6/s6-log.html">s6-log</a>
+ and
+ <a href="//0x53.net/software/goetia/logdir.html">logging directory</a>).
+ It writes them to the <code>system/logs/uncaught-logs</code> subdirectory
+ of the <a href="//0x53.net/software/goetia/rundir.html">runtime directory</a>.
+ </p>
+ </body>
+</html>