FSAPFSINFO(1)

πŸ“¦
this version Β· 2 versions
, in debian trixie, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– FSAPFSINFO(1) πŸ’–

okay bestie, so this is the fsapfsinfo manual page β€” it lives in the LOCAL section of your man pages, and it's genuinely one of my faves. pull up a chair, grab a boba, and let's get into it πŸ§‹βœ¨


✨ NAME ✨

fsapfsinfo β€” tells you everything about an Apple File System (APFS). like, everything. it's giving detective energy πŸ”πŸ‘‘


πŸ¦‹ SYNOPSIS πŸ¦‹

fsapfsinfo [-B bodyfile] [-E identifier] [-f file_system_index]
           [-F path] [-o offset] [-p password] [-r password] [-dhHvV]
           source

🌸 DESCRIPTION 🌸

fsapfsinfo is a utility that determines information about an Apple File System (APFS). yes, the whole thing. she's nosy and we love her for it πŸ’…

fsapfsinfo is part of the libfsapfs package. libfsapfs is a library to access the Apple File System (APFS) format. so basically, if APFS is the main character, libfsapfs is the bestie holding her purse 🫢

source is the source file. that's the thing you're pointing her at, bestie. don't forget it.

the options are as follows, and no we are NOT skipping any of them:

  • -B bodyfile β€” output file system information as a bodyfile. slay, now it's in bodyfile format.
  • -d β€” calculate a MD5 hash of a file entry to include in the bodyfile. hashes? in my bodyfile? more likely than you think ✨
  • -E identifier β€” show information about a specific file system entry, or just say "all" if you want the whole squad.
  • -f file_system_index β€” show information about a specific file system, or "all" for every single one. no cap.
  • -F path β€” show information about a specific file entry path. just point her at a path and she'll spill the tea.
  • -h β€” shows this help. hi bestie, this is your lifeline πŸ™ˆ
  • -H β€” shows the file system hierarchy. the whole family tree, iconic.
  • -o offset β€” specify the volume offset. important for when your image isn't starting at zero, iykyk.
  • -p password β€” specify the password. shhh, don't tell anyone 🀫
  • -r password β€” specify the recovery password. for when regular password said no and you need the backup queen to step in πŸ‘‘
  • -v β€” verbose output to stderr. she gets chatty.
  • -V β€” print version. the classic.

πŸ’œ ENVIRONMENT πŸ’œ

None.

like literally none. nothing here. empty. the void. πŸ’€


πŸŽ€ FILES πŸŽ€

None.

also nothing! she doesn't touch files behind your back, respect. 🌈


πŸ”₯ EXAMPLES πŸ”₯

okay so here's the moment you've all been waiting for, the demonstration:

# fsapfsinfo -o 20480 image.dmg
fsapfsinfo 20220728

Apple File System (APFS) information:

Container information:
        Identifier                      : d08a9fa0-d5a5-458b-813e-ebf9bf5d5338
        Number of volumes               : 1

Volume: 1 information:
        Identifier                      : 458ed10d-8ac3-4af1-8dfd-3954d151a3f3
        Name                            : apfs_test
        Compatible features             : 0x00000002
                (NX_FEATURE_LCFD)

        Incompatible features           : 0x00000001
                (NX_INCOMPAT_VERSION1)

        Read-only compatible features   : 0x00000000

        Number of snapshots             : 0

look at that output. gorgeous. pristine. the container identifiers, the volume name apfs_test, all those feature hex values, the snapshot count. ate and left no crumbs πŸ’…βœ¨


⭐ DIAGNOSTICS ⭐

errors, verbose and debug output are printed to stderr when verbose output -v is enabled. quick heads up though: verbose and debug output are only printed when enabled at compilation. so if you compile without it and turn on -v and get nothing, that's not a bug bestie, that's the build 😭


πŸ¦‹ BUGS πŸ¦‹

found something weird? please report bugs of any kind to <joachim.metz@gmail.com> or on the project website: https://github.com/libyal/libfsapfs/

fr fr, they want to hear about it. don't be shy 🫢


πŸ‘‘ AUTHOR πŸ‘‘

these man pages were written by Joachim Metz. ty for your service, king πŸ«‘πŸ‘‘


Copyright 2018-2022, Joachim Metz <joachim.metz@gmail.com>. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

⚠️ yes that's a NO WARRANTY in all caps. like, NO warranty, none, zero, not even the implied ones about being merchantable or fit for a particular purpose. read it and know it. πŸ’€

🌟 SEE ALSO 🌟


okay so that's the whole vibe! this page is from the libfsapfs package, dated July 28, 2022 (the manpage footer era, iconic), and honestly? she's serving. go forth and inspect some APFS images, bestie. you got this πŸ’…πŸ’–βœ¨πŸŒˆπŸ¦‹πŸŒΈ πŸŽ€