PVFS2-SETMATTR(1)

💅 PVFS2-SETMATTR — like, the setmattr girlies ✨

okay so bestie, welcome to PVFS2-SETMATTR(1), a General Commands Manual page that's literally all about setting file mirroring properties. yes, volumes. it's giving very niche, very powerful, very main character. 🎀

---

🌸 SYNOPSIS 🌸

pvfs2-setmattr [-c copies] [-m mode] [-h] -f file
setmattr [-c copies] [-m mode] [-h] -f file

two names, same energy. pick whichever one your shell fancies. 💖

---

✨ DESCRIPTION ✨

the pvfs2-setmattr utility changes information about file mirroring for a given file. that's it, that's the whole job. it's a little tool with a big glow-up responsibility. 🦋

here's the tea on the options:

• -c — set the number of mirror copies. how many copies? you decide, queen. 👑
• -m — set the mirroring mode. mode 100 means no mirroring, and mode 200 means create mirror when immutable is set. no cap, those are the vibes. 🔥
• -h — display synopsis. the "wait what were the flags again" button. 🙈

also -f file is right there in the synopsis, and it's how you tell the utility which file we're talking about. don't forget her. 💅

---

🌈 ENVIRONMENT 🌈

• PVFS2_DEBUGFILE — if you set this to the path of a local file, debug output gets redirected to it. all that messy debug chatter, but cute and contained. 💜
• PVFS2_DEBUGMASK — sets the OrangeFS debug mask. the possible masks are documented over in pvfs2-set-debugmask(1), so go read that if you want the full lore. ⭐
• PVFS2TAB_FILE — if set, this is the full pathname for an alternate pvfs2tab file. a lil backup tab file, as a treat. 🍓

---

🧚 FILES 🧚

• /etc/passwd
• /etc/pvfs2tab

just the classics. sitting there. being files. iconic behaviour honestly. 🌸

---

💖 EXAMPLES 💖

set mirroring for the file /mnt/foo:

pvfs2-setmattr -c 2 -m 200 -f /mnt/foo

two copies, mode 200, file /mnt/foo. absolutely ate. no crumbs. 🫶

---

😭 BUGS 😭

please submit bug reports to devel@lists.orangefs.org. we don't gatekeep, we report. fr fr. 💀

---

👑 SEE ALSO 👑

pvfs2-getmattr(1), pvfs2tab(5)

go read those too, they're the supporting cast and they understood the assignment. 🌈

---

okay that's the whole page bestie!! this one's from 2017-07-13, and it's the PVFS2-SETMATTR(1) girl herself. mwah, go mirror some files. 💅✨