DSTRIPE(1)

💅 DSTRIPE(1) — the mpiFileUtils glow-up page ✨

okay so bestie, welcome to dstripe, the icon of the mpiFileUtils family 🎀 she's a parallel MPI application and her whole job is restriping files. main character energy fr fr.

🌸 NAME 🌸

dstripe — restripe files on underlying storage 🦋

✨ SYNOPSIS ✨

dstripe [OPTION] PATH...

💖 DESCRIPTION 💖

A parallel MPI application to restripe files. No cap, that's the whole vibe.

Heads up bestie 🫶 this tool is in active development. It currently only works on Lustre. That's the situation, iykyk.

dstripe lets you restripe file(s) across the underlying storage devices. You must specify a list of paths — literally, that's not optional, she needs her paths. All files in those paths can be restriped.

By default, stripe size is 1MB and stripe count is -1, which lets dstripe use all available stripes 👑 generous queen behavior.

---

🎀 OPTIONS 🎀

• -c, --count STRIPE_COUNT — the number of stripes to use during file restriping 💫 if STRIPE_COUNT is -1, then all available stripes are used. If STRIPE_COUNT is 0, the lustre file system default is used. The default stripe count is -1.
• -s, --size STRIPE_SIZE — the stripe size to use during file restriping 📏 units like "MB" and "GB" can immediately follow the number without spaces (ex. 2MB). The default stripe size is 1MB.
• -m, --minsize SIZE — the minimum size a file must be to be a candidate for restriping 🍓 files smaller than SIZE will not be restriped. Units like "MB" and "GB" can immediately follow the number without spaces (ex. 2MB). The default minimum file size is 0MB.
• -r, --report — display the file size, stripe count, and stripe size of all files found in PATH 🌈 no restriping is performed when using this option. she's just looking, not touching, respectfully.
• --progress N — print progress message to stdout approximately every N seconds ⏱️ the number of seconds must be a non-negative integer. A value of 0 disables progress messages.
• -v, --verbose — run in verbose mode 🗣️ she tells you everything.
• -q, --quiet — run tool silently. No output is printed 🤫 not a peep.
• -h, --help — print the command usage, and the list of options available 🫶 the classic.

---

🔥 EXAMPLES 🔥

1. To stripe a file on all storage devices using a 1MB stripe size:

mpirun -np 128 dstripe -s 1MB /path/to/file

2. To stripe a file across 20 storage devices with a 1GB stripe size:

mpirun -np 128 dstripe -c 20 -s 1GB /path/to/file

3. To restripe all files in /path/to/files/ that are at least 1GB in size:

mpirun -np 128 dstripe -m 1GB /path/to/files/

4. To restripe all files in /path/to/files/ across 10 storage devices with 2MB stripe size:

mpirun -np 128 dstripe -c 10 -s 2MB /path/to/files/

5. To display the current stripe count and stripe size of all files in /path/to/files/:

mpirun -np 128 dstripe -r /path/to/files/

---

🦋 SEE ALSO 🦋

The mpiFileUtils source code and all documentation may be downloaded from <https://github.com/hpc/mpifileutils> ⭐ go read it bestie, it's giving educational.

👑 AUTHOR 👑

HPC

💜 COPYRIGHT 💜

2022, LLNL/LANL/UT-Battelle/DDN

---

and that's the whole page, bestie 💅✨ this was version 0.12, dated Jan 29, 2025, and it ate, no crumbs. mwah 🫶🎀