VDOREADONLY(8)

💖 VDOREADONLY — the vdoreadonly(8) era 💖

okay bestie, so this is a System Manager's Manual page, section 8, and it's literally just called vdoreadonly. that's the whole name. it's giving "i do one thing and i do it slayfully" and honestly? respect. 🫶

✨ NAME ✨

vdoreadonly — puts a VDO device into read-only mode 🎀

✨ SYNOPSIS ✨

vdoreadonly filename

that's it. one arg. no flags required. we love a low-maintenance icon. 💅

✨ DESCRIPTION ✨

so basically, vdoreadonly forces an existing VDO device into read-only mode. no cap, that's the entire job. it does not do anything else. it is not here to be versatile, it is here to be correct. 👑

filename must be the path of the VDODataLV, exactly as described over in lvmvdo(7). like, that's non-negotiable, bestie.

and here's the tea ☕: lvchange(8) will only mount that thing as read-only, so if you actually want a writable version of the device you have to manually create it yourself. the example below walks you through it step by step, so don't panic, we got you. 🌸

✨ OPTIONS ✨

• --help — prints this help message and then dips out. that's it. it said "here's the info, bye" 💖
• --version — shows you the version of vdoreadonly. so you can be like "what version am i running" and it will simply tell you. iconic behaviour. ⭐

✨ EXAMPLE ✨

this is the whole little ritual, in order, exactly like this:

# lvchange -ay vdo1/vdo0pool_vdata
# dmsetup table vdo1-vdo0pool_vdata > vdata.table
# lvchange -an vdo1/vdo0pool_vdata
# dmsetup create vdo1-vdo0pool_vdata --table "`cat vdata.table`"
# vdoreadonly /dev/mapper/vdo1-vdo0pool_vdata
# dmsetup remove vdo1-vdo0pool_vdata

see how we activate it, dump the table to a file, deactivate it, recreate it with that saved table (that's the manual writable-version step from up there ⬆️), run vdoreadonly on it, and then clean up with dmsetup remove? chef's kiss. 🔥 don't skip steps, fr fr. 💀

✨ SEE ALSO ✨

lvmvdo(7), lvchange(8), dmsetup(8)

go read those too, they're the supporting cast and they ate. 🦋

and that's the page!! Red Hat made this one, and this version is from 2023-04-14 — yes that date is giving "a while ago" but the info still hits. anyway ily, go forth and make your VDO device read-only responsibly 💜🧚🌈