BOOTC-CONT...EFS-DIGEST(8)

πŸ“¦
version 1.17.1 Β· 3 versions
, in fedora 43, fedora 44

πŸ’– NAME πŸ’–

bootc-container-composefs-digest β€” bestie, this one outputs the bootable composefs digest for a directory. That's it. That's the whole job. She's a one-trick pony and she ate. πŸ’…


✨ SYNOPSIS ✨

bootc container compute-composefs-digest [OPTIONS] [PATH]

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so. This command outputs the bootable composefs digest for a directory. Slay.

This is literally the digest that bootc container ukify embeds in the kernel command line of a UKI. It's a 128-character SHA-512 hex string that identifies the filesystem contents. So like, it's the fingerprint of ur filesystem. Her vibe check, if u will. πŸ”₯

Most image builds should be using bootc-container-ukify(8) instead, which computes it internally anyway β€” so if that's ur flow, u don't even need to be here, babes. This command is for scripting and debugging outside of that flow. It's giving "I know a guy who knows a guy" energy.

The digest depends on the EROFS format; see --erofs-version. And heads up:

⚠️ It must be run against a separate mount of the root filesystem, not the running root. Not the live one. Do not. not me running it against the running root and wondering why everything's cursed πŸ’€

πŸ‘‘ OPTIONS πŸ‘‘

  • PATH β€” Path to the filesystem root. Tell her where the root is at. 🫢
  • --write-dumpfile-to=WRITE_DUMPFILE_TO β€” Oh u want receipts? This additionally generates a dumpfile for the preferred digest, written to the target path. Perfect for comparing builds side by side, no cap.
  • --erofs-version=EROFS_VERSION β€” EROFS format version to use when computing the composefs digest. Which flavor of EROFS are we doing today bestie 🌸

Possible values:

  • v1
  • v2

Default: v1


🌈 EXAMPLES 🌈

Compute the digest of a root filesystem mounted at /target:

bootc container compute-composefs-digest /target

Also write a composefs dumpfile, to compare against another build:

bootc container compute-composefs-digest --write-dumpfile-to /tmp/rootfs.dump /target

See? Easy. Iconic behaviour honestly. ⭐


πŸŽ€ SEE ALSO πŸŽ€

bootc(8), bootc-container-ukify(8)


πŸ’œ VERSION πŸ’œ

v1.17.1


and that's the whole page, bestie πŸ’– this was BOOTC-CONT...EFS-DIGEST(8) from the System Manager's Manual, rockin' v1.17.1 β€” go forth and compute those digests, u absolute main character πŸ‘‘βœ¨

πŸ“¦ where this page comes from
  • fedora 43: bootc 1.17.1-1.fc43 Β· Apache-2.0 AND BSD-3-Clause AND MIT AND (Apache-2.0 OR BSL-1.0) AND (Apache-2.0 OR MIT) AND (Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT) AND (Unlicense OR MIT)
  • fedora 44: bootc 1.17.1-1.fc44 Β· Apache-2.0 AND BSD-3-Clause AND MIT AND (Apache-2.0 OR BSL-1.0) AND (Apache-2.0 OR MIT) AND (Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT) AND (Unlicense OR MIT)
  • πŸ’– girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms