PVFS2-MKDIR(1)

💖 PVFS2-MKDIR — bestie's guide to making folders in OrangeFS 💖

okay so this is the pvfs2-mkdir page from the General Commands Manual section of your friendly neighbourhood Unix docs, and I'm here to make it make sense. sit down, grab a lil snack 🍓, we're doing filesystem stuff today.

---

✨ NAME ✨

pvfs2-mkdir — create directory in an OrangeFS volume 🌸

no cap, that's the whole job. it makes a directory. in OrangeFS. that's it, that's the girl.

---

🎀 SYNOPSIS 🎀

pvfs2-mkdir [-m mode] [-i initial] [-x maximum] [-s split] [-pVvh]
directory

the way all the lil flags go in the square brackets and then you just... hand her the directory at the end. main character energy fr 💅

---

👑 DESCRIPTION 👑

The pvfs2-mkdir utility creates a directory in an OrangeFS volume at directory.

that's literally the entire vibe. you point her at a path inside an OrangeFS volume, she makes a directory there. periodt.

The options are as follows:

🌈 OPTIONS 🌈

• -m — Set permission mode as three or four digit octal number mode. yes bestie, the classic 755 / 0755 situation, three or four digits, octal, you already know this one iykyk 💅
• -i — Set initial number of dirdata handles. this is how many handles she starts out with, lowkey the starting roster 🫶
• -x — Set maximum number of dirdata handles. the ceiling. the absolute limit. she will not exceed this, no matter how famous she gets ✨
• -s — Set number of directory entries stored before split. hit this number of entries and she splits, like a glow-up for your directory 😭
• -p — Create parent directories as needed within OrangeFS. the -p we all know and love, but specifically inside OrangeFS, so don't be out here thinking it'll make parent dirs anywhere else 🎀
• -V — Display verbose messages. she will tell you everything she's doing. chatty queen 👑
• -v — Print version number and exit. literally just the version, then she's out the door, bye 💀
• -h — Display synopsis. help me help you, here's the usage 🌸

---

🧚 ENVIRONMENT 🧚

• PVFS2_DEBUGFILE — If set to the path of a local file, redirect debug output to it. so all the debugging tea goes into that file instead of your screen ☕
• PVFS2_DEBUGMASK — Set the OrangeFS debug mask. Possible masks are documented in pvfs2-set-debugmask(1). go read that one for the full list, i'm not making them up, they're documented over there, promise 🫶
• PVFS2TAB_FILE — If set, the full pathname for an alternate pvfs2tab file. swap in a different tab file if you're feeling spicy 🔥

---

🦋 FILES 🦋

• /etc/pvfs2tab

the classic. the default tab location. she lives there 💜

---

💅 EXAMPLES 💅

Create a directory.

pvfs2-mkdir /mnt/foo

boom. directory. slay. ✨

Create a directory whose entries are always distributed across 4 servers. In this case a split will never need to occur, so the split size is irrelevant.

pvfs2-mkdir -i 4 -x 4 /mnt/foo

so -i 4 -x 4 means she starts with 4 dirdata handles and maxes at 4 — since she's already at the max, a split will never need to occur, which is why the split size is irrelevant here. not me pointing out that the split just doesn't apply 🙈

Create a directory whose entries initially reside on 1 server, but may eventually grow so that entries are distributed across 4 servers. When any single server reaches the maximum of 10,000 directory entries, another of the available servers becomes active and entries are split across active servers, up to a maximum of 4 servers.

pvfs2-mkdir -i 1 -x 4 -s 10000 /mnt/foo

okay this one is the glow-up arc: start on 1 server (-i 1), allowed to grow up to 4 servers (-x 4), and the second any single server hits the maximum of 10,000 directory entries (-s 10000), another of the available servers becomes active and entries get split across the active servers — up to a maximum of 4 servers. she's scaling, she's thriving, she's distributed 😭🔥

---

💀 BUGS 💀

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

found a bug? don't suffer in silence bestie, email the list, they wanna know 🫶

---

🌟 SEE ALSO 🌟

• mkdir(1)
• pvfs2-touch(1)
• pvfs2tab(5)

---

and that's the whole page!! every flag, every env var, every example, all accounted for, nothing skipped, we ate 💅✨

cute lil sign-off: this beauty is from the General Commands Manual, and the page itself is dated 2017-07-03. love that for her. now go make some directories, bestie 🎀🌈💖