aboutsummaryrefslogtreecommitdiff
path: root/system/s6-rc/README
diff options
context:
space:
mode:
Diffstat (limited to 'system/s6-rc/README')
-rw-r--r--system/s6-rc/README29
1 files changed, 29 insertions, 0 deletions
diff --git a/system/s6-rc/README b/system/s6-rc/README
new file mode 100644
index 0000000000000..5a565ceed226a
--- /dev/null
+++ b/system/s6-rc/README
@@ -0,0 +1,29 @@
+s6-rc is a service manager for s6-based systems, i.e. a suite of programs
+that can start and stop services, both long-running daemons and one-time
+initialization scripts, in the proper order according to a dependency tree.
+It ensures that long-running daemons are supervised by the s6 infrastructure,
+and that one-time scripts are also run in a controlled environment.
+
+NOTE:
+Upstream recommends building skarnet.org softwares with static libraries
+as most of skarnet.org softwares are small enough that using shared
+libraries are generally not worth using. Therefore, by default, shared
+libraries are not built and binaries are linked against the static
+versions of the skarnet.org libraries.
+
+If you want to also build the shared libraries, pass BUILD_SHARED=yes
+environment variable to the SlackBuild script like below:
+
+ BUILD_SHARED=yes ./s6-rc.SlackBuild
+
+Similarly, to avoid building the static libraries, you can pass
+BUILD_STATIC=no to the script. For example, to only build the shared
+libraries and not the static ones, you can do something like:
+
+ BUILD_SHARED=yes BUILD_STATIC=no ./s6-rc.SlackBuild
+
+If you just want to build and use skarnet.org softwares, building only
+the static libraries should be sufficient.
+
+If you want the binaries to be linked against the shared versions of the
+skarnet.org libraries, pass LINK_SHARED=yes to the script.