PVFS2-CHMOD(1)

💅 pvfs2-chmod — the girlies' guide to OrangeFS permissions

okay so bestie, welcome to pvfs2-chmod(1), a page from the General Commands Manual section. It's giving "I just want to fix my file perms" energy and honestly? Same. Let's go. ✨

---

🌸 NAME 🌸

pvfs2-chmod — modify permissions on files in OrangeFS volumes. That's it, that's the whole job, and it does it flawlessly. 💖

---

🎀 SYNOPSIS 🎀

pvfs2-chmod [-v] mode filename(s)

yeah it's short. it's iconic. it doesn't need to be long. periodt.

---

✨ DESCRIPTION ✨

So like, the pvfs2-chmod utility modifies the permission bits on the OrangeFS files you point it at. 💫

And the mode? You write it as a three or four digit octal number, in the conventional manner. That's the whole vibe — digits, not letters. (More on that in CAVEATS, bestie, and you're gonna want to read it fr fr. 😭)

The options are as follows:

• -v — print the version number and exit. That's literally all it does. Cute, quick, slay. 🫶

---

🌈 ENVIRONMENT 🌈

Environment variables, aka the settings that be lurking in the background:

• PVFS2_DEBUGFILE — if you set this to the path of a local file, the debug output gets redirected to it. All the messy little thoughts go in the file instead of your terminal. 🍓
• PVFS2_DEBUGMASK — sets the OrangeFS debug mask. The possible masks are documented over in pvfs2-set-debugmask(1), so go read that one if you're nosy. 👀
• PVFS2TAB_FILE — if it's set, it's the full pathname for an alternate pvfs2tab file. An alternate. Fancy. 💅

---

💜 FILES 💜

• /etc/pvfs2tab

one file. one legend. 🌟

---

🔥 EXAMPLES 🔥

Prevent other users from accessing a file. No one else gets in, we're gatekeeping:

pvfs2-chmod 600 /mnt/foo

Allow the owner and users in the file's group to read and modify the file, and other users to only read the file. So: owner + group get read and modify, everyone else just gets read:

pvfs2-chmod 664 /mnt/foo

see how the mode is literally just the octal digits and the path? no dashes, no u+x, just numbers and vibes. 😌

---

💀 CAVEATS 💀

okay this is the important part, do not scroll past this.

• This utility does not support symbolic permissions like the chmod(1) utility does. So no u+rwx, no go-w, none of that. Octal only. It's a choice, and it's the choice we live with. 😭
• And ngl, here's the big one: because OrangeFS is a network file system, any user with access to the network may be able to circumvent file permissions. Yeah. Read that again. The permissions are cute but the network is not always your friend. Be aware. 🙈

---

🐛 BUGS 🐛

Please submit bug reports to devel@lists.orangefs.org — the devs want to hear from you, bestie, don't be shy. 💌

---

👑 SEE ALSO 👑

• chmod(1)
• pvfs2-chown(1)
• pvfs2-stat(1)
• pvfs2tab(5)

go read those too, they're the friend group. 🦋

---

and that's the page!! this one's from 2017-07-03, source/version and date both intact because we respect the archive in this house. mwah, go fix those perms, you ate. 💖✨🎀