PASSWORD.LUA(8)

✨ PASSWORD.LUA(8) ✨

okay bestie, so this is a password.lua page from the System Manager's Manual, and it's literally the bootloader password module 💅 like, it's the thing that goes "hey, password please" before your system boots. no cap, it's giving gatekeeper energy 👑

---

🎀 NAME 🎀

password.lua — the bootloader password module, periodt 💖

---

🌸 DESCRIPTION 🌸

so password.lua is the whole vibe for prompting for and checking passwords. that's it, that's the job 🫶

before you can use any of the functionality in password.lua, you must include it first, with a statement like this:

local password = require("password")

and then, bestie, here's what gets exported from password.lua ✨:

• password.read(prompt_length) — reads a password after a prompt. prompt_length is required so that the twiddle can be properly drawn while the user is typing. yes, the twiddle. it needs to know how long the prompt is so it can draw it correctly, don't ask questions, just pass the length 💅
• password.check() — drives the primary password checks done by the loader. this one is the main character fr fr 👑 it checks bootlock_password, geom_eli_passphrase_prompt, and password, and it'll prompt the user for passwords as-needed. and ooh, important detail: if password is set, the autoboot sequence will begin as the user is prompted for a password ⭐

---

🦋 SEE ALSO 🦋

• screen.lua(8)

---

💜 AUTHORS 💜

the password.lua file was originally written by Pedro Souza <pedrosouza@FreeBSD.org> 🎀 and later work plus this manual page was done by Kyle Evans <kevans@FreeBSD.org> ✨

---

ngl bestie, this page is short but it's iconic — can't boot without the password check, iykyk 💀🔐

Debian · March 29, 2025 — mwah, that's the whole page, love you, bye 🫶💖🌈