nlplug-findfs - Search for blockdevices to boot

NAME SYNOPSIS DESCRIPTION AUTHOR REPORTING BUGS SEE ALSO

NAME

SYNOPSIS

nlplug-findfs OPTIONS [SEARCHDEVICE]

DESCRIPTION

nlplug-findfs is part of the initramfs and is tasked to find the (possibly encrypted) boot partition and installer media.
−a OUTFILE

When apk overlays are found during the search, a list of their paths will be stored in OUTFILE.

−b OUTFILE

When boot media are found, a list of them is stored in OUTFILE. Boot media are identified by the existence of an .boot_repository file.

−c CRYPTDEVICE

Specifies an block device for decryption.

−h

Show usage information.

−H HEADERDEVICE

When using an encrypted device with LUKS headers on an separate block device, that block device must be specified using this option.

−k KEYFILE

Attempt to decrypt the block device given with −c using a 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 set by appending :<offset>:<size> to KEYFILE.

−m NAME

When the decryption of the block device is successful, it will appear as /dev/mapper/NAME.

	−n		Do not return non-zero if SEARCHDEVICE is not found.
	−D		Mount the encrypted devices with the discard (TRIM) option. Don’t enable this if you don’t know what it does.
	−d		Enable debugging output.

−f SUBSYSTEM

Ignore devices belonging to the given subsystem.

−o OFFSET

When mounting an encrypted device, this specifies the payload offset for cryptsetup.

−p PROGRAM

Call this program for uevents which have DEVNAME set.

−t TIMEOUT

Timeout after TIMEOUT milliseconds without uevents.

−U SIZE

uevent buffer size in bytes.

AUTHOR

Written by Natanael Copa <[email protected]>, Timo TerÃ¤s <[email protected]> and others.

REPORTING BUGS

Alpine Linux GitLab: <https://gitlab.alpinelinux.org/alpine/mkinitfs/-/issues>