mkinitfs-bootparam - control the startup behavior using the kernel command line

NAME DESCRIPTION FILES AUTHOR REPORTING BUGS SEE ALSO

NAME

alpine-bootparams − control the startup behavior using the kernel command line

In early boot, the preferred way to supply configuration data to the running system is via kernel options. The kernel options are specified in the bootloader configuration and are supplied to the kernel and early userspace in early boot. The mechanism and options that are interpreted by the kernel itself are documented in bootparam(7).

The options documented here are interpreted by the initramfs-init script that is part of the initramfs, see mkinitfs(1) to learn how to customize it.
aoe=0.0,2.1,...

A comma separated list of ATA-over-Ethernet shelf.slot required for boot. If this is left empty, aoe will be enabled, but boot will not pause for device discovery.

aoe_iflist=eth0,...

This is a mandatory parameter if you intend to use aoe at boot. It is a comma separated list of ethernet interfaces to use with the aoe module.

aoe_mtu=1500

Maximum Transmission Unit (MTU) to use for aoe interfaces on networks that support jumbo packets. The default (usually 1500) is used if this is not set.

blacklist=MODULE{,MODULE}

This comma-separated list names kernel modules that modprobe will reject to load.

chart

Enables bootchartd for measuring system startup speed.

cryptdiscards

Enable the discard feature for encrypted Solid State Disks. This might have security implications.

cryptdm=NAME

After the block device has been decrypted, make it available as /dev/mapper/NAME.

cryptheader=DEVICE

When the LUKS headers and encrypted data are on different devices, this option specifies the device with the LUKS headers.

cryptkey=KEYFILE

Read the key to decrypt the encrypted partition from KEYFILE This can be a device or a regular file. When KEYFILEis starting with EXEC= it specifies a command without arguments that is executed and the stdout used as key. The key offset and size can be specified by appending :<offset>:<size> to KEYFILE.

cryptoffset=SECTORS

Indicate that the encrypted data begins the given number of sectors after the start of the block device.

cryptroot=DEVICE

Attempt to decrypt DEVICE.

	dasd		Enable DASD devices on S/390x architectures.
	zfcp		Enable zFCP SCSI devices on S/390x architectures.

debug_init

Print debug information during boot.

init=PATH

Path to init program to execute instead of /sbin/init.

init_args=ARGUMENTS

Additional command line arguments for /sbin/init.

ip=CLIENT-IP:SERVER-IP:GATEWAY-IP:NETMASK:HOSTNAME:DEVICE:AUTOCONF:DNS-IP:DNS-IP:NTP-IP

Specify the network configuration. The format is equivalent to the linux kernel option with the same name. Per default, the SERVER-IP, HOSTNAME and NTP-IP parameters are ignored by the initramfs. Consult the kernel documentation on nfsroot for further information regarding the fields of this parameter.

modules=MODULE{,MODULE}

Comma-separated list of kernel modules to load explicitly.

nbd=HOST:PORT{,...}

Comma-separated list of nbd servers. Connects to each server running nbd-server to use its exported block device.

overlaytmpfs

When booting from a read-only filesystem, you can specify this flag to have your changes written to an in-memory temporary overlayfs. The underlying filesystem will always be mounted read-only, the overlay always writable.

overlaytmpfsflags=OPTIONS

Optional comma-separated list of tmpfs(5) mount options when overlaytmpfs is used. The default is mode=0755,rw, you cannot override rw.

panic=TIMEOUT

Disable the recovery/emergency shell when an error in initramfs occurs. Trigger a kernel panic instead.

quiet

Generate less output.

resume=DEVICE

Partition to resume from. This can either be a swap partition or a partition containing a swap file. If this is a partition containing a swap file, you must also use resume_offset.

resume_offset=OFFSET

If resume specifies a partition containing a swap file to resume from, you must also specify the offset of that file from the beginning of the partition using this flag.

root=(DEVICE | nfs:IP-ADDRESS:PATH)

Device or NFS url for the root partition.

rootflags=OPTIONS

Mount options for the device specified with root=.

rootfstype=FS_TYPE

File system type for the device specified with root=. Allowed values are the same like the −t option for mount(1).

usrflags=OPTIONS

Mount options for /usr, if in a different filesystem than root. The special value disable can be used to avoid /usr from being mounted from the initramfs. Only use it if you know what you are doing.

s390x_net=qeth_l2,BUS-ID{,BUS-ID}

Configure network devices for the S/390x architecture.

single

Launch root shell before switching to the root partition.

uevent_buf_size=BYTES

Set the buffer size for kernel uevents.

If no root= parameter is given, the initramfs will build a live system in memory from scratch. This is also called diskless mode.

When booting in diskless mode, the following options are also available:
alpine_repo=(URL | PATH)

If set, /etc/apk/repositories will be filled with this. May be a comma-separated list of URLs.

apkovl=(URL | [DEVICE[:FS_TYPE]:]PATH)

A HTTP, HTTPS or FTP URL to an apkovl.tar.gz file which will be retrieved and applied. Can also be a filesystem path, optionally prepended with the device name with the /dev/ prefix.

autodetect_serial=(no | setconsole | setconsole=REGEX{,REGEX,...})

Configure serial console detection and setup. If set to no, automatic detection and setup of serial consoles is disabled. If set to setconsole, the first detected serial console is set as the system console early during boot. If set to setconsole=REGEX{,REGEX,...}, the same behavior applies, but setconsole is only invoked if any of the provided regular expressions match the content of /sys/class/dmi/id/modalias.

ds=OPTIONS

Data source for tiny-cloud. If OPTIONS starts with nocloud, tiny-cloud will be enabled.

nokeep_apk_new

Setup a fresh system, ignore any apkovl.

pkgs=PACKAGE{,PACKAGE}

Comma-separated list of packages to be installed.

ssh_key=(URL | SSH_KEY)

This setting installs openssh and places the public key given as value in /root/.ssh/authorized_keys. If the value is an HTTP or FTP URL, it fetches the key(s) from there.

splash

Enable splash screen.

usbdelay=NUMBER

Wait NUMBER seconds for USB devices to show up before searching for boot media.

wireguard=INTERFACE;IP_ADDRESS{,IP_ADDRESS,...}[;WG_CONFIG_FILE]

Set up a wireguard interface named INTERFACE with the addresses IP_ADDRESS and use /etc/wireguard/initrd.conf or WG_CONFIG_FILE as a classic wg (not wg-quick) config.

zfs_force=NUMBER

Enable force importing the root zpool on boot, even if it was previously mounted from a different system/OS.