PVFS2-VALIDATE(1)

💖 PVFS2-VALIDATE(1) 💖

okay bestie, so this is a page from the General Commands Manual, section 1, and it's all about pvfs2-validate — your girl for snooping around and finding what's wrong. let's get into it 🫶

---

✨ NAME ✨

pvfs2-validate – recursively check a directory or file for problems

like, it goes all the way down through your stuff and tells you what's giving red flags. no cap. 🔍

---

🌸 SYNOPSIS 🌸

pvfs2-validate [-Vvharsfc] -d pvfs2_directory

that's the whole vibe. one flag cluster, one -d, and you're off 🦋

---

💅 DESCRIPTION 💅

The pvfs2-validate utility checks for various problems in the file system. that's literally its whole job and it ate, honestly. 💖

The options are as follows:

• -h — Display synopsis. it just shows you the usage line, like a little reminder card 🎀
• -d — Specifies the directory or file to check. this is the main character argument fr fr, you basically always need it
• -c — Check for stranded objects. ⚠️ important: this requires that -d refers to the root directory. don't skip that part bestie
• -s — Check for bad practice in symbolic links. symlinks behaving badly? we're calling them out 🫢
• -f — Check for bad practice in object names. yes, names can be sus and this catches it
• -F — Stop after confirming consistent configuration. short and sweet, does one vibe check then dips 👑
• -V — Display verbose messages. for when you want the full tea ☕
• -v — Print version number and exit. identity check, then bye ✌️
• -a — (NOT IMPLEMENTED) Fix all problems found. 😭 it does not work. it is not implemented. do not count on it
• -r — (NOT IMPLEMENTED) Run in interactive mode. also not implemented 💀 don't expect a chat, she's not talking

lowkey a couple of these are just decorative, so read the labels before you build your whole plan around them 🙈

---

🌈 ENVIRONMENT 🌈

• PVFS2_DEBUGFILE — If set to the path of a local file, redirect debug output to it. basically "put the debug rambling in this file instead of my screen" 📝
• PVFS2_DEBUGMASK — Set the OrangeFS debug mask. Possible masks are documented in pvfs2-set-debugmask(1). go read that page if you need the mask menu 🧚

---

⭐ EXIT STATUS ⭐

The pvfs2-check-server utility exits 0 on success and with the sum of the following conditions on failure: 1 if file system errors corrected, 2 if the system should be rebooted, and 4 if file system errors were not corrected.

not me saying this quietly: it's a sum, so the numbers can stack. read your exit code like a math problem, bestie 🧮

---

🎀 EXAMPLES 🎀

Check that servers have consistent configuration.

pvfs2-validate -F -d /mnt

one command, one -F, one -d /mnt, consistency confirmed, slay 🔥

---

😭 BUGS 😭

Please submit bug reports to devel@lists.orangefs.org

found something cursed? tell the devs, they want to know fr fr 📬

---

🦋 SEE ALSO 🦋

• pvfs2-check-server(1)
• pvfs2-fsck(1)

go read these next, they're the rest of the friend group 💜

---

and that's the page!! this one came from the source/version tagged PVFS2-VALIDATE(1) and it's dated 2017-08-11 — so yeah, it's been iconic for a minute 👑💖