NLPLUG-FINDFS(1)

💖 NLPLUG-FINDFS(1) — Early startup 💖

🌸 NAME 🌸

nlplug-findfs — Search for blockdevices to boot.

🦋 SYNOPSIS 🦋

nlplug-findfs OPTIONS [SEARCHDEVICE]

✨ DESCRIPTION ✨

Okay so <pink>nlplug-findfs</pink> is part of the initramfs, and its whole main-character job is to find the (possibly encrypted) boot partition and installer media. That's the vibe check: boot stuff, installer stuff, no cap.

Here are the options, one by one, fr fr:

• -a OUTFILE — when apk overlays are found during the search, a list of their paths gets stored in OUTFILE. Obsessed with a tidy list. 💖
• -b OUTFILE — when boot media are found, a list of them gets stored in OUTFILE. Boot media are identified by the existence of a .boot_repository file. That's the little clue, iykyk. 🎀
• -c CRYPTDEVICE — specifies an block device for decryption. Yep, that exact energy.
• -h — show usage information. Slay.
• -H HEADERDEVICE — when you're using an encrypted device with LUKS headers on a separate block device, that block device must be specified with this option. Important, bestie. 🔥
• -k KEYFILE — attempt to decrypt the block device given with -c using a keyfile. This can be a device or a regular file. When KEYFILE starts 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. That's giving secret-agent key energy. 🕵️♀️
• -m NAME — when the decryption of the block device is successful, it will appear as /dev/mapper/NAME. Iconic. ✨
• -n — do not return non-zero if SEARCHDEVICE is not found. No dramatic exit code, periodt.
• -D — mount the encrypted devices with the discard (TRIM) option. Don't enable this if you don't know what it does. For real, that's a warning, not a vibe. ⚠️
• -d — enable debugging output. Debug girlies rise. 🐛
• -f SUBSYSTEM — ignore devices belonging to the given subsystem. Bye, not your subsystem, not your problem. 💅
• -o OFFSET — when mounting an encrypted device, this specifies the payload offset for cryptsetup. Exact. 🎯
• -p PROGRAM — call this program for uevents which have DEVNAME set. That's the hook, iykyk. 🪝
• -t TIMEOUT — timeout after TIMEOUT milliseconds without uevents. Clock is ticking, bestie. ⏰
• -U SIZE — uevent buffer size in bytes. Size matters for the buffer, periodt. 📏

👑 AUTHOR 👑

Written by Natanael Copa <ncopa@alpinelinux.org>, Timo Teräs <timo.teras@iki.fi> and others. Genuine icons. 👑

🐛 REPORTING BUGS 🐛

Alpine Linux GitLab: <https://gitlab.alpinelinux.org/alpine/mkinitfs/-/issues>. If something's cursed, that's where to spill. 💀

🌈 SEE ALSO 🌈

mkinitfs-bootparam(7) — go read that too, bestie. 🌈

---

This page is from mkinitfs 3.14.1-r0, dated July 2018, and it's the NLPLUG-FINDFS(1) manual — mwah, that's the whole page. 💅🎀