summaryrefslogtreecommitdiffstats
path: root/system/runit/README
diff options
context:
space:
mode:
author Chris Abela2018-11-16 15:47:41 +0100
committer Willy Sudiarto Raharjo2018-11-17 12:42:49 +0100
commit4e065419beb99c93093dda74740dd58cc8f424f3 (patch)
tree3d93648503f98342c18511ab2ee96970216b0abf /system/runit/README
parente6b5f6f80c1dda93cfb6c18a3267b2c2f17573d7 (diff)
downloadslackbuilds-4e065419beb99c93093dda74740dd58cc8f424f3.tar.gz
system/runit: Updated for version 2.1.2 + new maintainer.
Signed-off-by: David Spencer <idlemoor@slackbuilds.org>
Diffstat (limited to 'system/runit/README')
-rw-r--r--system/runit/README61
1 files changed, 57 insertions, 4 deletions
diff --git a/system/runit/README b/system/runit/README
index 8182586e4d..a48d34bcc1 100644
--- a/system/runit/README
+++ b/system/runit/README
@@ -1,7 +1,60 @@
runit (a UNIX init scheme with service supervision)
-a cross-platform Unix init scheme with service supervision, a
-replacement for sysvinit, and other init schemes.
+A cross-platform Unix init scheme with service supervision, a replacement for
+sysvinit, and other init schemes.
-runit can replace init or its service supervision can be used with
-traditional init. runit is compatible with djb's daemontools
+runit can replace init or its service supervision can be used with traditional
+init. runit is compatible with djb's daemontools.
+
+By default, this slackbuild sets-up a basic configuration to replace init with
+runit. To disable this, pass CONFIG=no to the script.
+
+To use runit with init, just call it
+ /sbin/runsvdir-start &
+
+To replace init with runit, reboot and enter init=/sbin/runit-init in the Lilo
+prompt.
+
+Alternatively, if you do not have a multi boot system, you may append this line
+in /etc/lilo.conf
+
+E.g:
+ append="vt.default_utf8=0 init=/sbin/runit-init"
+
+Then run lilo:
+ # lilo -v
+
+Or just replace /sbin/init with /sbin/runit-init
+ # mv /sbin/init /sbin/init.sysv
+ # cp /sbin/runit-init /sbin/init
+Be warned that if you had booted with the original init, the system may refuse
+to reboot, therefore boot from runit-init first.
+
+To migrate a service to runit, switch it off and disable it as usual, place
+an initialisation script called run under a suitably named directory under
+/etc/sv/ and symlink it to /service.
+
+E.g.:
+ # /etc/rc.d/rc.networkmanager stop
+ # chmod -x /etc/rc.d/rc.networkmanager
+ # mkdir /etc/sv/networkmanager/
+
+Write a script to start the service in /etc/sv/networkmanager/run such as
+ #!/bin/sh
+ exec NetworkManager -n > /dev/null 2>&1
+
+Give it executable permission:
+ # chmod +x /etc/sv/networkmanager/run
+
+Link it to /service and NetworkManager will start in a few seconds and enabled
+under current runlevel
+ # ln -s /etc/sv/networkmanager /service
+
+Hint:
+To Reboot:
+ # runit-init 6
+To Halt:
+ # runit-init 0
+
+A /usr/sbin/shutdown shell script has been included with the configuration
+files if you enabled them.