VDOAUDIT(8)

💅 VDOAUDIT — the vibe check for your VDO device

okay bestie, so this one's a section 8 system manager's manual situation, vdoaudit for short, and it's literally the girl who counts everything twice. no cap.

✨ NAME ✨

vdoaudit — confirm the reference counts of a VDO device 🫶

🌸 SYNOPSIS 🌸

vdoaudit [options...]  filename

🦋 DESCRIPTION 🦋

so here's the tea. vdoaudit goes through all the logical block references to every physical block of a VDO device that it finds in filename, adds them all up, and then compares that total against the stored number of logical blocks. math girl behavior, honestly. 💅

then — and this is the part that eats — it also confirms all of the actual reference counts on all the physical blocks against the stored reference counts. every single one. she does not skip. she does not scroll past.

and finally? it validates that the slab summary approximation of the free blocks in each slab is correct. yes, approximation. yes, she's checking it anyway. slay. ✨

now, about filename: it must be the path of the VDODataLV, as described in lvmvdo(7). that's the assignment, no substitutions, don't try to be cute with it. 🎀

and if you pass --verbose? you get a whole line item reported for each and every inconsistency. otherwise you just get a summary of the problems. like, the highlights reel instead of the full vlog. 🌈

👑 OPTIONS 👑

• --help — print this help message and dip. that's it, that's the whole job. 💖
• --summary — display a summary of any problems found on the volume. the tl;dr version. 📋
• --verbose — display a line item for each inconsistency found on the volume. the full receipts, one line at a time, no crumbs spared. 🔍
• --version — show the version of vdoaudit. who even is she? now you know. ⭐

🧚 EXAMPLE 🧚

okay so this is the whole routine, in order, don't shuffle it:

# lvchange -ay vdo1/vdo0pool_vdata
# vdoaudit --verbose /dev/mapper/vdo1-vdo0pool_vdata
# lvchange -an vdo1/vdo0pool_vdata

activate it, audit it, deactivate it. the three-step skincare routine of VDO maintenance. 🍓

ngl bestie, notice how you turn the volume on first and off at the end — don't be out here auditing a sleeping device and then blaming the tool. 🙈

💜 SEE ALSO 💜

• lvmvdo(7)
• lvchange(8)

okay that's the whole page, you ate it, you understood it, you're the main character of systems administration now. 👑

this little love letter to your VDO device came to you from Red Hat, dated 2023-03-28, and it lives in the System Manager's Manual as plain old VDOAUDIT(8). mwah. 💋