Kisslinux Init Save Abandoned

Init Framework

KISS Linux's portable init framework for use with any init, service manager or device manager. It handles the boot (and shutdown) process and provides a generic interface for controlling it.

The below components have been tested and work. Other software may work out of the box as well, it just has not been tested. Send bug reports and support on this side will be added where needed.

Tested init systems Tested service managers Tested device managers

• busybox init * busybox runit * mdev
• s6 (s6-svscan) * s6 * mdevd
• sinit * runit * udevd
• runit * no service manager * no device manager
• shinit

NOTE: Any combination of the above can be used. If not using a service manager, ensure that you execute at least one getty for login to work. Also, some init systems handle what baseinit does internally so support for them here makes little sense.

[000] Index

• /etc/rc.conf ........................................................... [001]
  • CONFIG_INIT .......................................................... [002]
  • CONFIG_SERVICE ....................................................... [003]
  • CONFIG_SERVICE_DIR (runit and s6 only) ............................... [004]
  • CONFIG_DEV ........................................................... [005]
• /etc/rc.d/ ............................................................. [006]
  • /etc/rc.d/*.pre.boot ................................................. [007]
  • /etc/rc.d/*.post.boot ................................................ [008]
  • /etc/rc.d/*.pre.shutdown ............................................. [009]
  • /etc/rc.d/*.post.shutdown ............................................ [010]
• Utilities .............................................................. [011]
• How To Package An Init ................................................. [012]
• Further Reading ........................................................ [013]

[001] /etc/rc.conf

This file stores configuration for the boot/shutdown process and any scripts in /etc/rc.d. [006] If the file does not exist, create it and if any options do not exist, create them. If the options are unset (or not present) they take their default values.

--[002] CONFIG_INIT ------------------------------------------------------------

The init to assume is in use. This setting does not enable the init but merely tells baseinit which one is in use (so it can handle things accordingly). Valid values are currently 'busybox' (default), 's6', 'sinit', 'runit', 'shinit'.

+----------------------------------------------------------------------------+ | | | CONFIG_INIT=busybox | | | +----------------------------------------------------------------------------+

--[003] CONFIG_SERVICE ---------------------------------------------------------

The service manager to execute at the end of the boot process. Valid values are currently: 'runit' (default), s6, none. If 'none' is used, baseinit will not start a service manager and it is up to the user to spawn gettys, etc.

+----------------------------------------------------------------------------+ | | | CONFIG_SERVICE=runit | | | +----------------------------------------------------------------------------+

--[004] CONFIG_SERVICE_DIR (runit and s6 only) ---------------------------------

The service directory to use.

+----------------------------------------------------------------------------+ | | | CONVIG_SERVICE_DIR=/var/service | | | +----------------------------------------------------------------------------+

--[005] CONFIG_DEV -------------------------------------------------------------

The device manager to run during the init process. This is killed once boot is complete for a supervised version to take its place. Valid values are currently 'mdevd', 'mdev' (default) or 'udevd'.

+----------------------------------------------------------------------------+ | | | CONFIG_DEV=mdev | | | +----------------------------------------------------------------------------+

[006] /etc/rc.d/

Shell scripts are sourced from this directory at different stages in the boot process based on file name. Any configuration made here will run under all inits and service managers which use baseinit.

--[007] /etc/rc.d/*.pre.boot ---------------------------------------------------

Scripts in /etc/rc.d ending in .pre.boot are run at the start of the boot process but after pseudo filesystems are mounted (/sys, /dev, etc).

--[008] /etc/rc.d/*.post.boot --------------------------------------------------

Scripts in /etc/rc.d ending in .boot are run at the end of the boot process but before baseinit execs into CONFIG_SERVICE.

--[009] /etc/rc.d/*.pre.shutdown -----------------------------------------------

Scripts in /etc/rc.d ending in .pre.shutdown are run at the start of the shutdown and reboot process. If a script needs to run only on one mode, it can discern the shutdown type by checking the basename of $0.

--[010] /etc/rc.d/*.post.shutdown ----------------------------------------------

Scripts in /etc/rc.d ending in .post.shutdown are run at the end of the shutdown and reboot process. If a script needs to run only on one mode, it can discern the shutdown type by checking the basename of $0.

[011] Utilities

The baseinit package provides two utilities. 'kpow' (signal reboot/shutdown to the kernel) and 'respawn' (rerun command when it exits/dies).

These are only interesting to those looking to make larger modifications via /etc/rc.d. The respawn command should allow those not using a service manager to more easily spawn some gettys via /etc/rc.d.

[012] How To Package An Init

To package an init and have it use baseinit set it to run /usr/lib/init/rc.boot at power on, /usr/lib/init/rc.shutdown at shutdown and /usr/lib/init/rc.reboot at reboot.

Then, the package should provide /usr/bin/init, /usr/bin/poweroff and /usr/bin/reboot. This allows the alternatives system to be used and makes swapping between things easy.

Last, if the init needs modifications made to baseinit open an issue here or open a pull request. This is where CONFIG_INIT comes into play.

[013] Further Reading

• #/wiki/service-management
• #/wiki/pkg/busybox
• #/wiki/pkg/s6
• #/wiki/pkg/sinit
• #/wiki/pkg/baseinit