composefs-info(1)(composefs)

🌸 NAME 🌸

composefs-info — bestie, this one prints info about a composefs image ✨

---

💅 SYNOPSIS 💅

composefs-info [ls|objects|missing-objects|dump] IMAGE [IMAGE2 IMAGE3 ...]

---

🦋 DESCRIPTION 🦋

Okay so the composefs-info command is literally your little magnifying glass 🔍 for peeking inside a composefs image. It's got several sub-commands, and they're all kinda iconic in their own way:

• ls — prints a simple list of the files and directories in the images, plus their backing file or symlink target. Simple. Clean. We love. 🎀
• objects — prints a list of all the backing files referenced by the images, in sorted order. All of them. Sorted. Periodt. 💖
• missing-objects — prints a list of all the missing backing files referenced by the images, in sorted order. To do this it needs a backing file store, which you hand it with the --basedir option. Not me finding out what's gone 🙈
• dump — prints a full dump of the images in a line based textual format. See composefs-dump(5) for more details. And plot twist: this format is also accepted as input to mkcomposefs if the --from-file option is used. Round trip, slay. 🔥
• measure-file — interprets the provided paths as generic files, and prints their fsverity digest. Giving main character energy to random files fr fr. ⭐

---

✨ OPTIONS ✨

The IMAGE argument you pass in must be a composefs file. And you can specify multiple images, because why settle for one. 👑

compoosefs-info accepts the following options:

• --basedir=PATH — this should point to a directory of backing files, and it's what the missing-objects command uses to know what files are actually available. Point it somewhere real, bestie. 🫶
• --filter=NAME — only print entries whose name matches one of these. Can be specified multiple times. Cannot be a full path (so like, it can't contain /). This is intended to be used for tooling to efficiently look up metadata files embedded in the image without loading and printing the entire image. Efficiency? We love to see it. 💅

---

🌈 SEE ALSO 🌈

• composefs-info(1)
• composefs-dump(5)
• composefs upstream: https://github.com/containers/composefs

---

And that's the whole page, gorgeous 💖 this was from the User source, version vibes of composefs-info(1)(composefs) — no date on this one, so just take the vibe as-is. go inspect something, you got this 🌸✨