summaryrefslogtreecommitdiffstats
path: root/doc/source/system/vfs
diff options
context:
space:
mode:
authorPS <p@0x53.net>2026-02-07 10:36:49 +0100
committerPS <p@0x53.net>2026-02-07 10:36:49 +0100
commit49098cf9c6055b85a4cd0dcb4a0d57fc003310f4 (patch)
treee2166c108782293693549eea821dd622eeba5491 /doc/source/system/vfs
parenteaf0ecff18ee063286ad423469241ca0eb2e4c6c (diff)
downloadgoetia-linux-49098cf9c6055b85a4cd0dcb4a0d57fc003310f4.tar.gz
goetia-linux-49098cf9c6055b85a4cd0dcb4a0d57fc003310f4.tar.bz2
goetia-linux-49098cf9c6055b85a4cd0dcb4a0d57fc003310f4.zip
Add doc
Diffstat (limited to 'doc/source/system/vfs')
-rw-r--r--doc/source/system/vfs/mount-binfmt_misc.html81
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>