Repository files navigation

Useful issuesresolved in the past

Basic usage steps:

1. study and practicesystem recovery
   

2. install the package

pacman -S mkinitcpio-systemd-tool

3. activate required hooks in/etc/mkinitcpio.conf:

HOOKS=(base ... systemd systemd-tool)

4. configure, override and enable/disableprovided units, for example:
   for remote unlocking of luks root withcryptsetup andtinysshd use:

edit /etc/mkinitcpio-systemd-tool/config/crypttabedit /etc/mkinitcpio-systemd-tool/config/fstabsystemctl enable initrd-cryptsetup.pathsystemctl enable initrd-tinysshd.servicesystemctl enable initrd-debug-progs.servicesystemctl enable initrd-sysroot-mount.service

5. build image, review content and finally reboot:

mkinitcpio -v -p linux > /tmp/initrd.loglsinitcpio -l /boot/initramfs-linux.img | grep initrdsystemctl reboot

pacman install actions:

• take a look inarch repoandmake file
• provision user config and vendor systemd units into:
• /etc/mkinitcpio-systemd-tool (with backup)
• /usr/lib/systemd/system (with silent overwrite)

mkinitcpio install hook actions:

• look for enabled units in the/etc/systemd/system
• include in initrd units containing marker/etc/initrd-release
• activate transitively in initrd any discovered systemd service units
• auto provision into initramfs resources declared inside initrd service units

what is the mkinitcpio hook entry provided by this package?

• hook name:systemd-tool
• required hooks are:base systemd systemd-tool
• recommended hooks are:base autodetect modconf block filesystems keyboard fsck systemd systemd-tool

how can I customize installed service units?

• follow regular approaches toediting provided units
• create service unit override withsystemctl edit $unit_name
• enable/disable withsystemctl enable $unit_name /systemctl disable $unit_name

how can I review generated/boot/initramfs-linux.img?

• to reviewinitramfs.img aftermkinitcpio but beforereboot, use:
• visually, withmidnight commanderor scripted, withmkinitcpio lsinitcpio

how systemd unit transitive dependency provisioning works?

• seemkinitcpio-install.sh/add_systemd_unit_X()
• units found in[Unit]/Requires|OnFailure are recursively installed

what is the purpose of[X-SystemdTool] section in service unit files?

• seesystemd/systemd#3340
• this section provides configuration interface formkinitcpio provisioning actions
• directives:InitrdPathInitrdLinkInitrdBinaryInitrdBuildInitrdCallInitrdUnit

how can I auto-provision my custom service unit binaries into initramfs?

• useInitrdBinary=/path/target-exec to provision service binary
• also will be provisioned allExec* entries such asExecStart=/usr/bin/program

how can I auto-provision my custom service unit resources into initramfs?

• useInitrdPath=/path/to/host/folder-or-file

how can I relocate folder during provisioning?

• not implemented, source and target folder must use the same location

how can I relocate file and/or change file mode during provisioning?

• useInitrdPath=/target-file source=/source-file mode=NNN

how can I filter directory content during provisioning?

• useInitrdPath=/target-folder glob=*.example

how can I provision optional folder or file?

• useInitrdPath=/target-file source=/source-file optional=yes

is there a way to create empty folder or file?

• for empty dir, useInitrdPath=/path/target-dir/ create=yes note trailing SLASH
• for empty file, useInitrdPath=/path/target-file create=yes note NO trailing slash

how can I provision a symbolic link?

• useInitrdLink=/path-to-link/link-name target=/path-to-target/target-name
• note that link target/path-to-target/target-name must be provisioned separately

can I invoke a provisioning script related to my service during mkinitcpio build time?

• useInitrdBuild=/path-to/script.sh command=function_name

can I call a little provisioning script snippet during mkinitcpio build time?

• check for availablemkinitcpio functions in/usr/lib/initcpio/functions.sh
• useInitrdCall=inline-bash-code-here to call these functions

how can I provide custom interactive user shell for ssh client

• change sample shell file located in/usr/lib/mkinitcpio-systemd-tool/initrd-shell.sh

which ssh user keys are used by initramfs sshd server(s)?

• they come from host/etc/mkinitcpio-systemd-tool/config/authorized_keys

there is ainitrd-shell.sh script provided, what does it do?

• it is used as both interactive login shell and as a systemd service
• when crypto disks are present, it acts as password agent
• when in ssh console, it offers simple interactive menu
• when in systemd service mode, it acts as service

how can I reviewinitrd-shell.sh actions during last boot?

• usejournalctl -b -t shell

what doesCTRL-C do toinitrd-shell.sh in different modes?

• initrd-shell.sh provides appropriate reaction to interrupt, depending on the context
• while inssh terminal password agent prompt, it will start a menu forminitrd-shell.sh
• while in/dev/tty local debug console, it will exit frominitrd-shell.sh
• while in/dev/console password agent prompt, it will restart theinitrd-shell.sh service

is there a silent or no-echo mode during password entry ininitrd-shell.sh?

• there are two ways to enter silent mode (seesystemd-ask-password.c):
• either by pressingBACKSPACE as first key or by pressingTAB at any time
• then the prompt will show extra text:(no echo)