DFILEMAKER(1)

💅 DFILEMAKER(1) — the mpiFileUtils glow-up edition 🎀

okay bestie, so this is the dfilemaker page from mpiFileUtils, and honestly? it's giving "chaos generator but make it useful." let me walk you through it ✨

---

🌸 NAME 🌸

dfilemaker — generate random files. literally that's it, that's the vibe. it makes random stuff so you don't have to 🦋

---

🫶 SYNOPSIS 🫶

dfilemaker <destination_path>

one argument. one. you got this 💖

---

👑 DESCRIPTION 👑

dfilemaker creates a number of random directory trees with subdirectories and files of various sizes, and that is useful for testing — like, it's the main character of your test suite setup, no cap 🔥

Directory trees are created under destination_path, which must be a directory. (yes, really. it's a directory. be normal about it 💀)

• destination_path — Directory under which the new directory tree will be created. that's the whole assignment, bestie 🎯

---

✨ OPTIONS ✨

• -d, --depth=*min*-*max* — Specify the depth of the file system tree to generate. the depth gets picked at random within the bounds of min and max. the default depth is set to 10 min, 20 max. so it goes deep-deep 🌊
• -f, --fill=*type* — Specify the fill pattern of the file. current options available are: random, true, false, and alternate. let me break it down because this is the part people always ask about 💅
  • random will fill the file using urandom(4).
  • true will fill the file with a 0xFF pattern.
  • false will fill the file with a 0x00 pattern.
  • alternate will fill the file with a 0xAA pattern.

the default fill is random. slay 🎀

• -i, --seed=*integer* — Specify the seed to use for random number generation. This can be used to create reproducible test runs — so yes, you can make the chaos repeatable, iconic behavior honestly 🧚 the default is to generate a random seed.
• -s, --size=*min*-*max* — Specify the file sizes to generate. The file size will be chosen at random random within the bounds of min and max. (and yes, the original page says "random random" — I'm not touching that, it stays, it's canon now 💀) the default file size is set from 1MB to 5MB 🍓
• -h, --help — Print a brief message listing the dfilemaker(1) options and usage. your little rescue button when you forget everything 🫶
• -v, --version — Print version information and exit. bye bestie 👋

---

🌈 SEE ALSO 🌈

The mpiFileUtils source code and all documentation may be downloaded from <https://github.com/hpc/mpifileutils> — go follow the source, it's lowkey famous 💜

---

⭐ AUTHOR ⭐

HPC 👑 — short, mysterious, main character energy.

---

💖 COPYRIGHT 💖

2022, LLNL/LANL/UT-Battelle/DDN — protect the institutions, periodt 🫡

---

heads up bestie: destination_path has got to be a directory, and the defaults for depth and size are 10–20 and 1MB–5MB respectively, with random fill unless you say otherwise. don't come for me if you forget 🥲

---

and that's the whole page! this one's from mpiFileUtils, version 0.12, dated Jan 29, 2025 — write that down, the trivia round is coming 🌸🎀✨