diff options
Diffstat (limited to 'docs/wiki/system')
-rw-r--r-- | docs/wiki/system/service-management.html | 74 | ||||
-rw-r--r-- | docs/wiki/system/service-management.txt | 82 |
2 files changed, 122 insertions, 34 deletions
diff --git a/docs/wiki/system/service-management.html b/docs/wiki/system/service-management.html index 40d9c54..da639fb 100644 --- a/docs/wiki/system/service-management.html +++ b/docs/wiki/system/service-management.html @@ -16,36 +16,82 @@ <a href='/wiki'>wiki</a> <a href='/wiki/install.html'>installation</a> </nav></div><div class="border"></div> -<h1>Service Management</h1> +<p>Carbs Linux uses <code>busybox-runit</code> by default, but the repository additionally has the +original <code>runit</code> and <code>sysmgr</code>. You can install either with <code>kiss b runit; kiss i runit</code> +or <code>kiss b sysmgr; kiss i sysmgr</code>.</p> -<p>Carbs Linux uses busybox-runit as the default system supervisor.</p> +<h1>runit</h1> -<h2>Enabling Services</h2> +<p><strong>Enabling a Service</strong></p> -<p>Services start immediately when you enable them, and run by default on boot.</p> +<pre><code>ln -sf /etc/sv/acpid /var/service +</code></pre> + +<p><strong>Disabling a Service</strong></p> + +<pre><code>unlink /var/service/acpid +</code></pre> + +<p><strong>Starting a Service</strong></p> + +<pre><code>sv start acpid +</code></pre> + +<p><strong>Stopping a Service</strong></p> + +<pre><code>sv stop acpid +</code></pre> -<pre><code>$ ln -s /etc/sv/acpid /var/service +<p>For more information refer to the <code>sv --help</code> output. Also check out the <code>sv(8)</code> +manual page if you have installed the <code>runit</code> package.</p> + +<h1>sysmgr</h1> + +<p><a href="https://github.com/cemkeylan/sysmgr">sysmgr</a> is POSIX-sh service supervisor written by me. Its usage resembles +<code>runit</code>. The biggest difference is that <code>sysmgr</code> uses service files instead +of directories with run scripts inside.</p> + +<h2>svctl</h2> + +<p><code>svctl</code> is the equivalant of <code>sv</code> for sysmgr. You can run the above commands for +<code>runit</code> and use <code>svctl</code> instead of <code>sv</code>. Those would be as follows.</p> + +<p><strong>Enabling a Service</strong></p> + +<pre><code>ln -sf /etc/sysmgr/acpid /var/sysmgr </code></pre> -<h2>Disabling a service</h2> +<p><strong>Disabling a Service</strong></p> -<pre><code>$ unlink /var/service/acpid +<pre><code>unlink /var/sysmgr/acpid </code></pre> -<h2>Starting a service</h2> +<p><strong>Starting a Service</strong></p> -<pre><code>$ sv start acpid +<pre><code>svctl start acpid </code></pre> -<h2>Stopping a service</h2> +<p><strong>Stopping a Service</strong></p> -<pre><code>$ sv stop acpid +<pre><code>svctl stop acpid </code></pre> -<h2>More</h2> +<h2>Switching from runit</h2> + +<p>Switching from <code>runit</code> is fairly easy. You can run the following commands to get +started with <code>sysmgr</code>.</p> + +<pre><code># Create the directories if you haven't yet +mkdir -p /var/sysmgr /etc/sysmgr -<p>Runit is extremely flexible and simple. Refer to <code>sv</code>, <code>runsv</code>, <code>svc</code>, <code>runsvdir</code> -help outputs for more information.</p> +# Copy all of the run scripts to /etc/sysmgr +set -- /etc/sv/* +for service; do cp "$service/run" "/etc/sysmgr/${service##*/}" ; done + +# Link all enabled services +set -- /var/service/* +for service; do ln -sf /etc/sysmgr/${service##*/} /var/sysmgr ; done +</code></pre> <a href="/wiki/system/service-management.txt">View Page Source</a><div class=border></div> <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> <p class=footer>Copyright © 2019-2020 Cem Keylan</p> diff --git a/docs/wiki/system/service-management.txt b/docs/wiki/system/service-management.txt index fc49f60..2133ea5 100644 --- a/docs/wiki/system/service-management.txt +++ b/docs/wiki/system/service-management.txt @@ -1,39 +1,81 @@ -Service Management -================== +Carbs Linux uses `busybox-runit` by default, but the repository additionally has the +original `runit` and `sysmgr`. You can install either with `kiss b runit; kiss i runit` +or `kiss b sysmgr; kiss i sysmgr`. -Carbs Linux uses busybox-runit as the default system supervisor. +runit +===== +**Enabling a Service** -Enabling Services ------------------ + ln -sf /etc/sv/acpid /var/service -Services start immediately when you enable them, and run by default on boot. +**Disabling a Service** + unlink /var/service/acpid - $ ln -s /etc/sv/acpid /var/service +**Starting a Service** + sv start acpid -Disabling a service -------------------- +**Stopping a Service** - $ unlink /var/service/acpid + sv stop acpid +For more information refer to the `sv --help` output. Also check out the `sv(8)` +manual page if you have installed the `runit` package. -Starting a service ------------------- - $ sv start acpid +sysmgr +====== +[sysmgr] is POSIX-sh service supervisor written by me. Its usage resembles +`runit`. The biggest difference is that `sysmgr` uses service files instead +of directories with run scripts inside. -Stopping a service ------------------- - $ sv stop acpid +svctl +----- +`svctl` is the equivalant of `sv` for sysmgr. You can run the above commands for +`runit` and use `svctl` instead of `sv`. Those would be as follows. -More ----- -Runit is extremely flexible and simple. Refer to `sv`, `runsv`, `svc`, `runsvdir` -help outputs for more information. +**Enabling a Service** + + ln -sf /etc/sysmgr/acpid /var/sysmgr + +**Disabling a Service** + + unlink /var/sysmgr/acpid + +**Starting a Service** + + svctl start acpid + +**Stopping a Service** + + svctl stop acpid + + +Switching from runit +-------------------- + +Switching from `runit` is fairly easy. You can run the following commands to get +started with `sysmgr`. + + + # Create the directories if you haven't yet + mkdir -p /var/sysmgr /etc/sysmgr + + # Copy all of the run scripts to /etc/sysmgr + set -- /etc/sv/* + for service; do cp "$service/run" "/etc/sysmgr/${service##*/}" ; done + + # Link all enabled services + set -- /var/service/* + for service; do ln -sf /etc/sysmgr/${service##*/} /var/sysmgr ; done + + + +[sysmgr]: https://github.com/cemkeylan/sysmgr |