1 files changed, 81 insertions, 0 deletions
diff --git a/doc/source/system/vfs/mount-binfmt_misc.html b/doc/source/system/vfs/mount-binfmt_misc.html
new file mode 100644
index 0000000..09cadc8
--- /dev/null
+++ b/doc/source/system/vfs/mount-binfmt_misc.html
@@ -0,0 +1,81 @@
+<!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>mount-binfmt_misc service</title>
+    	<meta name="Description" content="System oneshot service to populate the binfmt_misc filesystem." />
+    	<meta name="Keywords" content="goetia s6-rc Linux bin system supervision tree" />
+	</head>
+	<header>
+		<p>
+			<a href="//0x53.net/software/goetia/goetia-linux">goetia-linux</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 mount-binfmt_misc service</h1>
+		<p>
+    		mount-binfmt_misc is a
+    		<a href="https://skarnet.org/software/s6-rc/s6-rc-compile.html#source">oneshot service</a>
+    		set up the
+    		<a href="https://docs.kernel.org/admin-guide/binfmt-misc.html">binfmt_misc</a>
+    		virtual filesystem.
+		</p>
+		<p>
+    		When it is started:
+		</p>
+		<ul>
+    		<li>
+        		It mounts the binfmt_misc virtual filesystem at
+        		<code>/proc/sys/fs/binfmt_misc</code>.
+    		</li>
+    		<li>
+        		It reads all files at
+        		<code>/etc/binfmt.d/*</code>
+    		</li>
+    		<li>
+        		For each line in each file it finds there,
+        		ignoring empty lines and lines starting with a
+        		<code>#</code>,
+        		it tries to apply the line
+        		as a registration string as defined
+        		<a href="https://docs.kernel.org/admin-guide/binfmt-misc.html">here</a>
+        		under the following conditions:
+    		</li>
+    		<ul>
+        		<li>
+            		Files are ordered by
+            		<a href="https://skarnet.org/software/execline/elglob.html">elglob</a>.
+        		</li>
+        		<li>
+        			If <code>name</code> fields are duplicated,
+        			the last one processed will be applied.
+        		</li>
+    		</ul>
+		</ul>
+		<p>
+    		When it is stopped:
+		</p>
+		<ul>
+    		<li>
+        		It umounts <code>/proc/sys/fs/binfmt_misc</code>.
+    		</li>
+		</ul>
+		<section id="examples">
+    		<h2>Examples</h2>
+    		<p>
+        		A file <code>/etc/binfmt.d/wine.conf</code>
+        		with the content <code>:DOSWin:M::MZ::/bin/wine:</code>
+        		would make windows binaries be executed
+        		using wine automatically.
+    		</p>
+		</section>
+	</body>
+</html>