summaryrefslogtreecommitdiffstats
path: root/doc/source/system/other/local.html
diff options
context:
space:
mode:
authorPS <p@0x53.net>2026-02-07 10:36:23 +0100
committerPS <p@0x53.net>2026-02-07 10:36:23 +0100
commitae0726ca490b93c9a173e6fe6ad4bd004048ec72 (patch)
treed908b5ab162265b32992a1d21fe2fb30816529cb /doc/source/system/other/local.html
parent49371f8654a82e3300caa898f4a211716681735f (diff)
downloadgoetia-freebsd-ae0726ca490b93c9a173e6fe6ad4bd004048ec72.tar.gz
goetia-freebsd-ae0726ca490b93c9a173e6fe6ad4bd004048ec72.tar.bz2
goetia-freebsd-ae0726ca490b93c9a173e6fe6ad4bd004048ec72.zip
Add doc
Diffstat (limited to 'doc/source/system/other/local.html')
-rw-r--r--doc/source/system/other/local.html69
1 files changed, 69 insertions, 0 deletions
diff --git a/doc/source/system/other/local.html b/doc/source/system/other/local.html
new file mode 100644
index 0000000..29c25e5
--- /dev/null
+++ b/doc/source/system/other/local.html
@@ -0,0 +1,69 @@
+<!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>local service</title>
+ <meta name="Description" content="System oneshot that executes scripts." />
+ <meta name="Keywords" content="goetia s6-rc FreeBSD script system supervision tree" />
+ </head>
+ <header>
+ <p>
+ <a href="//0x53.net/software/goetia/goetia-freebsd">goetia-freebsd</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 local service</h1>
+ <p>
+ local is a
+ <a href="https://skarnet.org/software/s6-rc/s6-rc-compile.html#source">oneshot service</a>.
+ </p>
+ <ul>
+ <li>
+ It tries to execute all
+ files <code>/etc/local.d/*.up</code>
+ when it is started (typically during boot).
+ </li>
+ <li>
+ It tries to execute all files <code>/etc/local.d/*.down</code>
+ when it is stopped (typically during shutdown).
+ </li>
+ </ul>
+ <p>
+ The files are executed in random order
+ and in parallel.
+ </p>
+ <section id="examples">
+ <h2>Examples</h2>
+ <p>
+ An executable file <code>/etc/local.d/echo.up</code>
+ with the content
+ <pre>
+#!/bin/execlineb -P
+
+echo "example"
+ </pre>
+ would be executed and write "example" to the system log
+ upon starting the service local.
+ </p>
+ <p>
+ An executable file <code>/etc/local.d/echo.down</code>
+ with the content
+ <pre>
+#!/bin/execlineb -P
+
+echo "example"
+ </pre>
+ would be executed and write "example" to the system log
+ upon stopping the service local.
+ </p>
+ </section>
+ </body>
+</html>