PVFS2-CHECK-SERVER(1)

✨ PVFS2-CHECK-SERVER ✨

ok so bestie, we're in the General Commands Manual section and this little icon is called pvfs2-check-server — and lowkey it's the vibe-check tool of the OrangeFS world. You point it at a server, it tells you (or, spoiler, doesn't tell you) whether that server is up and slaying. 💅

---

🌸 NAME 🌸

pvfs2-check-server – check to see if a server is responding 🫶

---

🎀 SYNOPSIS 🎀

pvfs2-check-server [-h server] [-f fsname] [-n proto] [-p port]

---

💖 DESCRIPTION 💖

ok so picture this: the pvfs2-check-server utility makes sure that the server sitting at server, on port port, speaking protocol proto, and serving the file system named fsname, is actually running. that's it, that's the whole job. main character energy, minimal effort. 👑

and here's the cute part: this utility does not require or consult the /etc/pvfs2tab file. nope, not even a little peek. it's independent, it's self-sufficient, it's giving solo era. 🦋

and if it succeeds? there is no output. none. silence. the absence of a clapback is the compliment, iykyk. 🤫

The options are as follows:

• -h — specify the host name to connect to. who are we visiting today bestie 🏠
• -f — specify the name of the file system to check. generally this is orangefs. (iconic name ngl 🍊)
• -n — specify the protocol to use. generally either tcp or ib. pick your fighter ⚔️
• -p — specify the port number to use. with tcp this is generally 3334, and with ib this is generally 3335. don't mix them up bestie, that's a whole different situation 😭

---

🌈 ENVIRONMENT 🌈

• PVFS2_DEBUGFILE — if you set this to the path of a local file, it redirects debug output into that file. so like, all the tea gets written down instead of spilled everywhere 📝
• PVFS2_DEBUGMASK — sets the OrangeFS debug mask. the possible masks are documented over in pvfs2-set-debugmask(1), so go read that if you wanna know your options 🔍

---

⭐ EXIT STATUS ⭐

the pvfs2-check-server utility exits 0 on success and non-zero on failure.

that's it. zero means we ate. non-zero means something's not giving. 💀

---

🧚 EXAMPLES 🧚

Check that a server is running.

pvfs2-check-server -h localhost -f orangefs -n tcp -p 3334

look at her go. localhost, orangefs, tcp, port 3334. if she returns nothing, she's thriving. 🌸

---

💀 BUGS 💀

found a bug? please submit bug reports to devel@lists.orangefs.org — they wanna hear it, fr fr 🫶

---

👑 SEE ALSO 👑

pvfs2-ping(1) pvfs2-validate(1) — the rest of the squad, go say hi 💜

---

and that's the whole page bestie!! this one came from the PVFS2-CHECK-SERVER(1) manual page, dated 2017-07-03 — yeah she's a vintage queen but she still works. periodt. ✨🎀🦋