1 files changed, 67 insertions, 0 deletions
diff --git a/doc/bin/system-run.html b/doc/bin/system-run.html
new file mode 100644
index 0000000..465cee4
--- /dev/null
+++ b/doc/bin/system-run.html
@@ -0,0 +1,67 @@
+<!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-run</title>
+    	<meta name="Description" content="Run little scripts from the system supervision tree, providing reliability." />
+    	<meta name="Keywords" content="goetia s6 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-run program</h1>
+		<p>
+			system-run allows
+			to hand over the execution of commands to the
+			<a href="//0x53.net/software/goetia/supervisiontree.html#system">system supervision tree</a>.
+		</p>
+		<h2>Interface</h2>
+		<pre>     system-run <em>prog...</em></pre>
+		<ul>
+			<li>
+    			Internally, system-run invokes
+				<a href="https://skarnet.org/software/s6/s6-sudo.html">s6-sudo</a>
+				to connect to an
+				<a href="https://skarnet.org/software/s6/s6-sudod.html">s6-sudod</a>
+				instance provided by the system
+				<a href="//0x53.net/software/goetia/service/system/goetia-runner.html">goetia-runner</a>.
+			</li>
+			<li>
+    			<code><em>prog...</em></code> is then transferred
+				to and executed by goetia-runner.
+			</li>
+			<li>
+    			See
+				<a href="https://skarnet.org/software/s6/s6-sudo.html">s6-sudo</a>
+				and
+				<a href="https://skarnet.org/software/s6/s6-sudod.html">s6-sudod</a>
+				for configuration options and detailed information.
+			</li>
+		</ul>
+		<h2>Exit codes</h2>
+		<ul>
+			<li>
+    			system-run behaves exactly as
+				<a href="https://skarnet.org/software/s6/s6-sudo.html">s6-sudo</a>.
+			</li>
+		</ul>
+		<h2>Options</h2>
+		<ul>
+			<li>
+    			system-run takes the exact same options as
+				<a href="https://skarnet.org/software/s6/s6-sudoc.html">s6-sudoc</a>.
+			</li>
+		</ul>
+	</body>
+</html>