diff options
Diffstat (limited to 'init.texi')
-rw-r--r-- | init.texi | 147 |
1 files changed, 0 insertions, 147 deletions
diff --git a/init.texi b/init.texi deleted file mode 100644 index e9283bc..0000000 --- a/init.texi +++ /dev/null @@ -1,147 +0,0 @@ -@c This document is part of Carbs Linux Documentation. -@c See the top.texi file for LICENSE information. - -@c ----------------------------------------------------------------------------- - -@node Init System -@chapter Init System - -Carbs Linux init scripts are run by the init daemon (@command{busybox} by default) -on boot and shutdown processes. It also provides its own halting program named -shalt. This provides a portable method that doesn't rely on non-POSIX external -programs. - -@menu -* Configuring Init:: Ways to configure the init system -* Init Hooks:: Adding your personal commands to the init system -* Changing Init Program:: Replacing the default busybox init with something new -@end menu - - -@c ----------------------------------------------------------------------------- - -@node Configuring Init -@section Configuring Init - -There are three ways you can change the behaviour of the init system. Those are: - -@enumerate -@item -Kernel Command Line -@item -@file{/etc/init/rc.conf} file -@item -Init Hooks -@end enumerate - - -@c ----------------------------------------------------------------------------- - -@subsection Kernel Command Line - -On GRUB, you can edit the kernel command line parameters, which will be parsed -as variables on the init system. Not all of the parameters will be acted upon, -but all of them will be set as variables on the init script. For example an -example command line, and how it is interpreted. - -@example -BOOT_IMAGE=/boot/vmlinuz root=/dev/sda2 rw loglevel=3 quiet -@end example - -This command line will be parsed to set the following variables: - -@example -BOOT_IMAGE=/boot/vmlinuz -root=/dev/sda2 -rw=1 -loglevel=3 -quiet=1 -@end example - -Some of these variables, such as @env{rw}/@env{ro}, @env{loglevel}, and -@env{quiet}, will be used by the init system to change the behaviour of the -startup. - - -@c ----------------------------------------------------------------------------- - -@subsection @file{/etc/init/rc.conf} file - -However, the kernel command line isn't the only place to set your boot -parameters. You can specify variables here as well, although note that the -kernel command line always gets the priority for these variables since they can -be set just before boot. - - -@c ----------------------------------------------------------------------------- - -@node Init Hooks -@section Init Hooks - -Init hooks are for custom personal commands that the user may want to add to -alter their boot. These can be used to load kernel modules, modify interfaces, -and lot more. Those hooks are added to the @file{/etc/init} directory with the -hook name as the suffix. For example, a boot script will be placed as -@file{/etc/init/my-hook.boot}. Currently, there are 4 hooks that the user can use. - -@table @file -@item early-boot -Run after pseudo-filesystems are mounted. -@item boot -Run before the boot stage is completed. -@item pre.shutdown -Run first when shutting down. -@item post.shutdown -Run just before the system is halted. -@end table - - -@c ----------------------------------------------------------------------------- - -@node Changing Init Program -@section Changing Init Program - -By default, Carbs Linux comes preinstalled with @command{busybox-init}, but this -can easily be replaced without any issues. Currently, available init systems are: - -@itemize -@item -sinit -@item -busybox -@item -runit -@item -shinit -@end itemize - -This example is for runit, but it will work with all init systems packaged in the -distribution repositories. @xref{@command{cpt-alternatives}} - -@example -$ cpt a runit /usr/bin/init -$ cpt a runit /usr/bin/poweroff -$ cpt a runit /usr/bin/reboot -@end example - - -@c ----------------------------------------------------------------------------- - -@subsection Rebooting after changing Init - -After switching init systems, your running init system may not accept the -new poweroff commands. You will need to reboot/poweroff using the running init's -utilities for the new utilities to work. These commands are for the init system -currently running on your system and not the one you are switching to. - -@table @command -@item busybox -@code{$ busybox reboot} -@item runit -@code{$ runit-init 6} -@item shinit/sinit -@code{$ kill -s INT 1} -@end table - - -@c ----------------------------------------------------------------------------- |