GRUB-FSTEST(1)

πŸ’… grub-fstest β€” the manual page, but make it make sense

okay so bestie, welcome to GRUB-FSTEST(1), one of the User Commands, and honestly? it's giving "backstage pass to the filesystem drivers." no cap. πŸŽ€


✨ NAME ✨

grub-fstest β€” a debug tool for GRUB filesystem drivers πŸ¦‹


🌸 SYNOPSIS 🌸

grub-fstest [OPTION...] IMAGE_PATH COMMANDS

πŸ‘‘ DESCRIPTION πŸ‘‘

Bestie. This is a debug tool for filesystem driver. That's the whole vibe. It pokes at an image and runs little commands on it so you can see what the driver is actually doing. πŸ’…

🫢 Commands:

  • blocklist FILE β€” shows you the blocklist of FILE. like, the receipts of where it lives on disk. πŸ’–
  • cat FILE β€” copies FILE straight to standard output. yes, cat behaviour, iconic. ✨
  • cmp FILE LOCAL β€” compares FILE against the local file LOCAL. vibe check, but for bytes. πŸ”₯
  • cp FILE LOCAL β€” copies FILE to the local file LOCAL. πŸŽ€
  • crc FILE β€” gets the crc32 checksum of FILE. math girlies rise. 🌈
  • hex FILE β€” shows the contents of FILE in hex. 🧚
  • ls PATH β€” lists the files in PATH. classic. πŸ’œ
  • xnu_uuid DEVICE β€” computes the XNU UUID of the device. 😭

⭐ Options:

  • -c, --diskcount=NUM β€” specifies the number of input files. 🫢
  • -C, --crypto β€” mounts crypto devices. πŸ”
  • -d, --debug=STRING β€” sets the debug environment variable. πŸ‘‘
  • -K, --zfs-key=FILE|prompt β€” loads the zfs crypto key. either from a file or it'll ask you, hence prompt. πŸ’…
  • -n, --length=NUM β€” handles N bytes in the output file. 🌸
  • -r, --root=DEVICE_NAME β€” sets the root device. πŸ’–
  • -s, --skip=NUM β€” skips N bytes from the output file. πŸ¦‹
  • -u, --uncompress β€” uncompresses data. ✨
  • -v, --verbose β€” print verbose messages. lowercase and unbothered, exactly as written. 😌
  • -?, --help β€” give this help list. πŸŽ€
  • --usage β€” give a short usage message. short queen. 🌈
  • -V, --version β€” print program version. ⭐
Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. fr fr, that's just how it works. πŸ’€

🌸 SEE ALSO 🌸

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

info grub-fstest

should give you access to the complete manual. πŸ“–βœ¨


and that's a wrap bestie πŸ’… this was GRUB 2.12, dated April 2026 β€” go forth and debug those filesystem drivers, you ate. πŸŽ€πŸ¦‹πŸ’–

πŸ“¦ where this page comes from