From d31250fc850b196d2b46b94c82f0538f4b79248c Mon Sep 17 00:00:00 2001 From: PS Date: Sat, 7 Feb 2026 10:38:55 +0100 Subject: Add doc --- doc/index.html | 192 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 192 insertions(+) create mode 100644 doc/index.html (limited to 'doc/index.html') diff --git a/doc/index.html b/doc/index.html new file mode 100644 index 0000000..81e4e34 --- /dev/null +++ b/doc/index.html @@ -0,0 +1,192 @@ + + + + + + + goetia-s6-linux-init + + + +

+ goetia +
+ Software +
+ 0x53.net +

+ +

goetia-s6-linux-init

What is it?

+ goetia-s6-linux-init contains a configuration for + s6-linux-init. + It also contains wrappers around some of s6-linux-inits commands + to make them fit the rest of goetia. + Finally, it contains service directories for some + s6-linux-init specific daemons. +

+ The configuration is used by copying + the s6-linux-init directory in the + installation directory + to /etc/s6-linux-init/goetia, + renaming the directory in the process. +

+ It is critical, + that some arguments given to ./configure + during the installation of + s6-linux-init + match those used in the goetia packages. + These are: +

+ --tmpfsdir=... which must be the same + in both the goetia packages and the s6-linux-init package. + The default is in both cases the same and can be left unchanged. + However, a change of this option in e.g. + goetia-base + mandates the exact same change of this option in s6-linux-init + and vice versa. +
+ --scandir=... of s6-linux-init + which must match + --sysrundir=... in goetia. + This is by default not given. + If the default of goetia packages is kept, + --scandir=system/service has to be used + for s6-linux-init. + In general setting --sysrundir=@sysrundir@ on + goetia packages means having to set + --scandir=@sysrundir@/service + on s6-linux-init. +

+ Additionally two things in respect to the + run-image subdirectory of the + system configuration directory + change for system supervision trees only. +

+ The run-image subdirectory lies now at + /etc/s6-linux-init/goetia/run-image + instead of + @sysconfdir@/system/run-image. +
+ When using s6-linux-init, the run-image is now + copied to @tmpfsdir@ instead of + @tmpfsdir@/@sysrundir@/system. + This has to be accomodated for by adding an additional system + subdirectory between the run-image and the service + directory. + To make it more clear: this results in: + /etc/s6-linux-init/goetia/run-image/system/service/ + instead of + /etc/goetia/system/run-image/service/ + with goetia-linux-init. + Bear in mind that this has to be further corrected for every non standard + --sysrundir=... setting in the goetia packages. +

+ If all defaults are kept on the other geotia packages, + this means the following in practice: +

+ During the installation of s6-linux-init, run at least ./configure --scandir=system/service. +
+ Symlink or copy + service directories + to /etc/s6-linux-init/goetia/run-image/system/service/. +

Installation

Requirements

+ A set of POSIX tools as described in the general + requirements +
+ A POSIX-compliant implementation of make, or GNU make +
+ s6-linux-init +

Licensing

+ goetia-s6-linux-init is free software. It is available under the + ISC license. +

Download

+ Alternatively, you can checkout a copy of the + goetia-s6-linux-init git repository: +
```
git clone git://git.0x53.net/goetia-s6-linux-init
```
+

Compilation

+ See the enclosed INSTALL file for installation details. +

Reference

Commands

+ All of the following are + execline + scripts. +

+ system-init +
+ system-shutdown +

Service directories

+ Service directories specific to the Linux Kernel + and to this init system. +

+ + -- cgit v1.2.3