FUTILITY(1)

💖 FUTILITY(1) 💖

okay bestie, pull up a chair, we're reading the futility manual together and honestly? it's giving unified firmware utility energy and I'm obsessed 🫶

✨ NAME ✨

futility — Unified firmware utility

🌸 SYNOPSIS 🌸

futility [options] COMMAND [args...]

🦋 DESCRIPTION 🦋

so futility is the unified firmware utility, and like… it's coming for everyone's job 💅 it will eventually replace most of the distinct verified boot tools that the vboot_reference package used to produce. not me being the final boss of verified boot tools 😭

here's the cute part: when it gets symlinked under the name of one of those previous tools, it should fully implement the original behavior. so it'll just be that tool, no notes. you can also call it directly as futility, followed by the original name as the first argument. both work, queen behavior 👑

💜 Global options 💜

• --vb1 — Use only vboot v1.0 binary formats
• --vb21 — Use only vboot v2.1 binary formats
• --debug — Be noisy about what's going on

ngl --debug is the "tell me everything, I can handle it" option. it's loud. it's chatty. it's literally the group chat at 2am. use it when something's acting up 💀

🎀 The following commands are built-in 🎀

• create — Create a keypair from an RSA .pem file
• dump_fmap — Display FMAP contents from a firmware image
• dump_kernel_config — Prints the kernel command line
• gbb_utility — Manipulate the Google Binary Block (GBB)
• help — Show a bit of help (you're looking at it)
• load_fmap — Replace the contents of specified FMAP areas
• pcr — Simulate a TPM PCR extension operation
• show — Display the content of various binary components
• sign — Sign / resign various binary components
• vbutil_firmware — Verified boot firmware utility
• vbutil_kernel — Creates, signs, and verifies the kernel partition
• vbutil_key — Wraps RSA keys with vboot headers
• vbutil_keyblock — Creates, signs, and verifies a keyblock
• verify — Verify the signatures of various binary components
• version — Show the futility source revision and build date

and if you ever get lost, just run:

futility help COMMAND

for more information 🫶 iykyk

okay so. and then the manual does the entire thing again. not me side-eyeing the manpage author 🙈 but every detail counts so here we go, round two, same energy, iconic of it honestly:

Usage: futility [options] COMMAND [args...]

This is the unified firmware utility, which will eventually replace most of the distinct verified boot tools formerly produced by the vboot_reference package.

When symlinked under the name of one of those previous tools, it should fully implement the original behavior. It can also be invoked directly as futility, followed by the original name as the first argument.

Global options:

• --vb1 — Use only vboot v1.0 binary formats
• --vb21 — Use only vboot v2.1 binary formats
• --debug — Be noisy about what's going on

The following commands are built-in:

• create — Create a keypair from an RSA .pem file
• dump_fmap — Display FMAP contents from a firmware image
• dump_kernel_config — Prints the kernel command line
• gbb_utility — Manipulate the Google Binary Block (GBB)
• help — Show a bit of help (you're looking at it)
• load_fmap — Replace the contents of specified FMAP areas
• pcr — Simulate a TPM PCR extension operation
• show — Display the content of various binary components
• sign — Sign / resign various binary components
• vbutil_firmware — Verified boot firmware utility
• vbutil_kernel — Creates, signs, and verifies the kernel partition
• vbutil_key — Wraps RSA keys with vboot headers
• vbutil_keyblock — Creates, signs, and verifies a keyblock
• verify — Verify the signatures of various binary components
• version — Show the futility source revision and build date

Use "futility help COMMAND" for more information.

🌈 SEE ALSO 🌈

The full documentation for futility is maintained as a Texinfo manual. If the info and futility programs are properly installed at your site, the command

info futility

should give you access to the complete manual. fr fr, go read it, it's the whole vibe ⭐

and that's the whole page bestie!! this one's from futility, dated May 2016 — yeah she's a lil vintage but she still ate 💅 go forth and verify some boot, mwah 💖✨🎀