LFS-MIRROR-VERIFY(1)

💖 LFS-MIRROR-VERIFY 💖

okay bestie, so this is a page from the Lustre User Utilities manual — the one and only lfs-mirror-verify ✨ no cap, it's literally the vibe-check tool for your mirrored files 🪞🪞

---

🌸 NAME 🌸

lfs-mirror-verify — verify mirrored file(s) 👀🦋

---

✨ SYNOPSIS ✨

lfs mirror verify [--only MIRROR_ID[,MIRROR_ID2,...]]  [--stale|-s]
                  [--verbose|-v] MIRRORED_FILE [MIRRORED_FILE2 ...]

---

💅 DESCRIPTION 💅

So here's the tea ☕: this command verifies that each SYNC mirror of a mirrored file — the one you point at with the path name MIRRORED_FILE — contains exactly the same data. And because we're efficient queens 👑, it totally supports specifying multiple mirrored files in one command line. Slay.

This is a scrub tool and bestie you should run it on a regular basis 📆 to make sure your mirrored files are not corrupted. Real talk though: it will not repair the file if it turns out to be corrupted 🫠. Usually the administrator should check the file content from each mirror, figure out which one is correct, and then invoke lfs mirror resync to repair it manually. DIY energy, iykyk 🔧

If the --only MIRROR_ID[,MIRROR_ID2,...] option is specified, then the command will only verify the mirrors specified by *MIRROR_ID*s contain exactly the same data. At least two *MIRROR_ID*s are required — not me pointing that out, it's literally in the rules 🙈. This option cannot be used when multiple mirrored files are specified. periodt.

If the --verbose|-v option is specified, then the command will print where the differences are if the data do not match 🔍. Otherwise, the command will just return an error in that case. And yes, this option can be repeated for multiple times to print more information — go off, stack it 💅✨

If the --stale|-s option is specified, then the command will check the mirrors of file and mark them stale based on the data consistency and intelligent heuristics 🧠💀

---

🎀 OPTIONS 🎀

• --only MIRROR_ID[,MIRROR_ID2,...] — this option indicates which mirrors specified by MIRROR_IDs need to be verified. The MIRROR_ID is the numerical unique identifier for a mirror 🔢. Multiple *MIRROR_ID*s are separated by comma. simple as that, bestie.
• -s, --stale — this option indicates the command will check the mirrors of file and mark them stale based on the data consistency and intelligent heuristics 🧚✨
• -v, --verbose — this option indicates the command will print where the differences are if the data do not match 🔎💖

---

🌈 EXAMPLES 🌈

Verify that each mirror of /mnt/lustre/file1 contains exactly the same data:

# lfs mirror verify /mnt/lustre/file1

Separately verify that each mirror of /mnt/lustre/file1 and /mnt/lustre/file2 contain exactly the same data. Print where the differences are if the data do not match:

# lfs mirror verify -v /mnt/lustre/file1 /mnt/lustre/file2

Verify mirrors with mirror ID 4 and 5 of /mnt/lustre/file1 contain exactly the same data:

# lfs mirror verify --only 4,5 /mnt/lustre/file1

---

⭐ AVAILABILITY ⭐

The lfs mirror verify command is part of the lustre(7) filesystem package since release 2.11.0 🎂 so it's been iconic for a minute.

---

🫶 SEE ALSO 🫶

lfs(1), lfs-mirror-create(1), lfs-mirror-extend(1), lfs-mirror-resync(1), lfs-mirror-split(1), lfs-setstripe(1)

---

and that's the whole page bestie, you ate that 💅 this lil love letter comes from the Lustre release, dated 2024-08-20 — go verify those mirrors, ily, bye 🦋💖🎀