Initramfs init: Difference between revisions

Latest revision as of 11:28, 10 November 2023

mkinitfs is a tool to create initramfs images. Initramfs images are small images which contain a small filesystem with everything required to boot Alpine. For example, when booting a setup with full disk encryption, the initramfs contains the binaries required to prompt for a password and mount the encrypted disk.

Usage

Under a running alpine machine, the following command can be used if for some reason the initramfs has not been created properly for a new kernel.

mkinitfs -c /etc/mkinitfs/mkinitfs.conf -b / <kernelvers>

The script is located in /sbin/ and is created with ash. It expects /lib/modules to be populated with the <kernelvers> listed. For variations on this command (e.g. for chroot) Search "mkinitfs".

initramfs init cmdline options (work in progress)

In addition to the kernel boot parameters are a number of parameters that the init script understands. These are documented in the mkinitfs-bootparam(7) man page.

Although you may specify your own init script when building an initramfs, these parameters allow for extensive control over the initial startup of an Alpine Linux system.

@@ Line 1: / Line 1: @@
-== initramfs init cmdline options ==
+[https://gitlab.alpinelinux.org/alpine/mkinitfs '''mkinitfs'''] is a tool to create initramfs images. Initramfs images are small images which contain a small filesystem with everything required to boot Alpine. For example, when booting a setup with [[Setting up encrypted volumes with LUKS|full disk encryption]], the initramfs contains the binaries required to prompt for a password and mount the encrypted disk.
-The init script in the initramfs which is loaded by the kernel understands the following entires in your kernel command line:
+== Usage ==
+Under a running alpine machine, the following command can be used if for some reason the initramfs has not been created properly for a new kernel.
+ {{cmd|mkinitfs -c /etc/mkinitfs/mkinitfs.conf -b / <kernelvers>}}
+The script is located in {{path|/sbin/}} and is created with ash. It expects {{path|/lib/modules}} to be populated with the <code><kernelvers></code> listed. For variations on this command (e.g. for chroot) Search "mkinitfs".
-* quiet (flag) less verbose init script execution
+== initramfs init cmdline options (work in progress) ==
-* debug_init (flag) sets '-x' in the init script and -d for mdev
-* chart (flag)
+In addition to the [https://www.kernel.org/doc/html/v4.14/admin-guide/kernel-parameters.html kernel boot parameters] are a number of parameters that the init script understands. These are documented in the <code>mkinitfs-bootparam(7)</code> man page.
-* alpine_repo=
-* blacklist=
+Although you may specify your own init script when building an initramfs, these parameters allow for extensive control over the initial startup of an Alpine Linux system.
-* apkovl=URL load the apkovl file from URL
-* dasd=
+== See Also ==
-* s390x_net=
+* [https://wiki.postmarketos.org/wiki/The_initramfs PostmarketOS Wiki]
-* rootfstype=
+* [https://wiki.archlinux.org/title/Arch_boot_process#initramfs ArchWiki boot process]
-* modules=
-* crytptroot=
+[[category:Kernel]]
-* cryptdm=
+[[Category:Booting]]
-* cryptheader=
-* cryptoffset=
-* cryptokey=
-* nbd=
-* root=
-* resume
-* rootflags
-* init=
-* init_args=
-* usbdelay
-* pkgs=
-* ssh_key=
-* keep_apk_new
-* splash=
-*