Meant to be run as pid 1 as a stage1 init. Performs the necessary early system preparation and execs into 66‑scandir.
66-boot [ -h ] [ -z ] [ -m ] [ -s skel ] [ -l log_user ] [ -e environment ] [ -d dev ] [ -b banner ]
This program performs some early preparations, spawns a process that will run the rc.init script and then execs into 66‑scandir.
66-boot never exits. It spawns the rc.init script and execs into 66‑scandir which runs forever until the machine stops or reboots.
-h : prints this help.
-m : umount the basename of the LIVE directory set into the init.conf skeleton file, if it is already mounted, and mounts a tmpfs on it. By default, the LIVE basename is mounted if it is not already a valid mountpoint. Otherwise without the -m option, it does nothing.
-s skel : an absolute path. Directory that holds skeleton files. By default this will be /etc/66. The default can also be changed at compile time by passing the --with-skeleton=DIR option to ./configure. This directory must contain the necessary skeleton files to properly boot the machine, without it the system will not boot.
-l log_user : the catch-all logger will run as log_user. Default is s6log. The default can also be changed at compile-time by passing the --with-s6-log-user=user option to ./configure.
-e environment : an absolute path. stage 1 init empties its environment before spawning the rc.init skeleton file and executing into 66-scandir in order to prevent kernel environment variables from leaking into the process tree. The PATH variable is the only variable set for the environment. If you want to define additional environment variables then use this option. Behaves the same as 66-scandir -e.
-d dev : mounts a devtmpfs on dev. By default, no such mount is performed - it is assumed that a devtmpfs is automounted on /dev at boot time by the kernel or an initramfs.
-b banner : prints banner to /dev/console at the start of the stage 1 init process. Defaults to:
[Starts stage1 process ...]
When booting a system, 66-boot performs the following operations:
It prints a banner to /dev/console.
It parses the init.conf skeleton file.
It chdirs into /.
It sets the umask to initial_umask.
It becomes a session leader.
It mounts a devtmpfs on dev, if requested.
It uses /dev/null as its stdin (instead of /dev/console). Although stdout and stderr still use /dev/console for now.
It checks if the LIVE basename is a valid mountpoint, and if so it mounts it. If requested, it unmounts if the LIVE basename is a valid mountpoint and performs a mount.
It creates the LIVE directory invocating 66-scandir -v VERBOSITY -l LIVE -b -c -s skel plus -L user_log if requested.
It initiates the early services of TREE invocating 66-init -v VERBOSITY -l LIVE -t TREE classic.
It reads the initial environment from environment if requested.
It performs “the fifo trick" where it redirects its stdout to the catch-all logger's fifo without blocking before the catch-all logger is even up (because it's a service that will be spawned a bit later, when 66-scandir is executed).
It forks a child, also called stage2.
The child is blocked until the catch-all logger runs.
The child starts any service of tree TREE.
The child becomes a session leader.
It also makes the catch-all logger's fifo its stderr.
It execs into 66-scandir -v VERBOSITY -l LIVE -u with LIVE/scandir/0 (default /run/66/scandir/0) as its scandir.
66-scandir transitions into s6-svscan which spawns the early services that are defined in TREE where one of those services is scandir-log, which is the catch-all logger. Once this service is up 66-boot's child stage2 unblocks.
The child then execs into rc.init
In the unusual event that any of the above processes fail, 66-boot will try to launch a single-user login namely sulogin to provide the means to repair the system.
Skeleton files are mandatory and must exist on your system to be able to boot and shutdown the machine properly. By default those files are installed at /etc/66. Use the --with-skeleton=DIR option at compile time to change it.
init : the 66-boot binary is not meant to be called directly or be linked to the binary directory because it takes command line options. Therefore the init skeleton file is used to pass any options to *66-boot. By default 66-boot is launched without options. This file should be copied by the administrator into the binary directory of your system.
init.conf : this file contains a set of key=value pairs. All keys are mandatory where the name of the key must not be changed. This is the file available to a user to configure the boot process. By default:
VERBOSITY=0 : increases/decreases the verbosity of the stage1 process.
LIVE=/run/66 : an absolute path; creates the scandir at LIVE. The value will depend by default on the --livedir=live option set at compile time.
PATH=/usr/bin:/usr/sbin:/bin:/sbin:/usr/local/bin : the initial value for the PATH environment variable that will be passed on to all starting processes unless it's overridden by PATH declaration with the -e option. It is absolutely necessary for execline,s6,s6-rc and all 66 tools binaries to be accessible via PATH, else the machine will not boot.
TREE=boot : name of the tree to start. This tree should contain a sane set of services to bring up the machine into an operating system. ‘classic’ services will start early at the invocation of 66-init. stage2 will then start any other service type. It is the responsibility of the system administrator to build this tree without errors.
RCINIT=/etc/66/rc.init : an absolute path. This file is launched at the end of stage1 and run as stage2. It calls 66-init to initiate any services inside of TREE except ‘classic’ ones which were already initiated by stage1. After that it invokes 66-dbctl to bring up all services.
RCSHUTDOWN=/etc/66/rc.shutdown : an absolute path. This is launched when a shutdown is requested also called stage3. It invokes 66-all to bring down all services of TREE.
RCSHUTDOWNFINAL=/etc/66/rc.shutdown.final : an absolute path. This file will be run at the very end of the shutdown procedure, after all processes have been killed and all filesystems have been unmounted, just before the system is rebooted or the power turned off.
UMASK=0022 : sets the value of the initial file umask for all starting processes in octal.
RESCAN=0 : forces s6-svscan to perform a scan every RESCAN milliseconds. This is an overload function mostly for debugging. It should be 0 during stage1. It is strongly discouraged to set RESCAN to a positive value smaller than 500.
CONTAINER=0 : accepted value are 0 or 1 where 0 ask to boot on a hardware system and 1 ask to boot inside a container. Default 0. If set to 1, the rc.init.container file is used instead of the rc.init file.
RCINIT_CONTAINER=/etc/66/rc.init.container : an absolute path. This is launched when a boot inside a container is asked. It as the same behavior of the rc.init file but allows to implement a command to run inside this container and retrieves the exit code of that command. The exit code of the command is automatically written at the /etc/66/container/<owner>/halt file modifying the EXITCODE= variable.
CATCHLOG=1 : accepted value are 0 or 1 where 0 ask to not redirects its stdout to the catch-all logger's fifo and 1 ask to redirects its stdout to the catch-all logger's fifo. Default 1.
rc.init : this file is called by the child of 66-boot to process stage2. It invokes two commands:
66-init -v${VERBOSITY} -l ${LIVE} -t ${TREE} database will initiate bundle and atomic services inside of TREE.
66-dbctl -v${VERBOSITY} -l ${LIVE} -t ${TREE} -u will bring up all bundle and atomic services inside of TREE.
If any of these two commands fail a warning message is sent to sdtout.
rc.init.container : this file replace the rc.init when a boot inside a container is asked. It has the same behavior than the rc.init file. However, this file is especially designed to be used for a boot inside a container. It allow to easily define a command(see comment on that file) to launch inside the container and to retrieve the exit code of that command.
rc.shutdown : this file is called at shudown when the administrator requests the shutdown, halt, poweroff or reboot command. It invokes a single command:
66-all -v${VERBOSITY} -l ${LIVE} -t ${TREE} -f down to bring down all services for all trees marked as enabled.The following skeleton files are called to execute their corresponding power related functions and are safe wrappers that accept their corresponding command options. They should be copied or symlinked to the binary directory of the system.
halt : wraps 66-hpr -h. Terminates all processes and shuts down the CPU.
poweroff : wraps 66-hpr -p. Like halt but also turns off the machine itself. Sends an ACPI command to the motherboard then to the PSU to cut off power.
reboot : wraps 66-hpr -r. Terminates all processes and instructs a warm boot.
shutdown : wraps 66-shutdown. Like poweroff but also runs scripts to bring the system down in a sane way including user notification.
Any valid key=value pair set at the init.conf skeleton file can be passed on the kernel command line as parameter:
BOOT_IMAGE=../vmlinuz-linux root=/dev/sda3 ro vga=895 initrd=../intel-ucode.img,../initramfs-linux.img TREE=boot VERBOSITY=4