PLAKAR-DIAG(1)

💅 PLAKAR-DIAG(1) — the plakar-diag page, but make it make sense

okay so this is the manual page for plakar-diag, from the General Commands Manual section. it's a glow-up of the official docs, same facts, better vibes. let's go 🫶

---

✨ NAME ✨

plakar-diag — bestie, this is the command that shows you detailed info about Plakar's internal structures. like, the behind-the-scenes stuff 👀

---

🦋 SYNOPSIS 🦋

plakar diag
       [contenttype | locks | object | packfile | snapshot | state | vfs | xattr]

---

🌸 DESCRIPTION 🌸

so the plakar diag command gives you detailed info about all kinds of internal data structures. what you actually see depends on which argument you hand it — main character energy, honestly ✨

here's the thing: with no arguments at all, it just displays information about the repository. no cap, that's the default vibe check 💅

the sub-commands are as follows, bestie:

🎀 the sub-commands 🎀

• contenttype snapshotID:path — literally the contenttype sub-command, taking snapshotID:path. that's it, that's the spec 🙈
• locks — displays the list of locks currently held on the repository. so you can see who's holding what 👑
• object objectID — displays information about a specific object, including its mac, type, tags, and associated data chunks. the whole lil resume for that object 🔥
• packfile packfileID — shows details of packfiles, including entries and macs, which store object data within the repository. these are the storage containers, fr fr 🍓
• snapshot snapshotID — shows detailed information about a specific snapshot, including its metadata, directory and file count, and size. the full 411 on that snapshot 📸
• state — lists or describes the states in the repository. yes queen, the states 🧚
• vfs snapshotID:path — shows filesystem (VFS) details for a specific path within a snapshot, listing directory or file attributes, including permissions, ownership, and custom metadata. the whole filesystem tea ☕
• xattr snapshotID:path — the xattr sub-command, taking snapshotID:path. that's the spec, don't come for me 🙈

---

🔥 EXIT STATUS 🔥

the plakar-diag utility exits 0 on success, and >0 if an error occurs. so like, 0 = we ate, >0 = something went sideways 😭

---

🌈 EXAMPLES 🌈

show repository information — this is the no-argument classic:

$ plakar diag

show detailed information for a snapshot:

$ plakar diag snapshot abc123

list all states in the repository:

$ plakar diag state

display a specific object within a snapshot:

$ plakar diag object 1234567890abcdef

display filesystem details for a path within a snapshot:

$ plakar diag vfs abc123:/etc/passwd

---

👑 SEE ALSO 👑

go check these out too, iykyk:

• plakar(1)
• plakar-backup(1)

---

💖 reminder bestie: every flag, argument, path and number up there is verbatim from the real page. i changed the vibe, not the facts. periodt ✨

---

🎀 that's the whole page! 🎀 this lil cutie comes from Debian, dated May 5, 2026 — and honestly? she slays. bye bestie, go diagnose something 💜🦋