DRELN(1)

📦 version 0.12, in nixpkgs unstable

okay so real quick, bestie: this is dreln, part of the mpiFileUtils suite, living in section 1 of the manual. It's the distributed relink tool and honestly? she's a fixer. 🧚

✨ SYNOPSIS ✨

dreln [OPTION] OLDPATH NEWPATH PATH ...

🦋 DESCRIPTION 🦋

So. It's a parallel MPI application that recursively goes through and updates symlinks inside a directory. That's the whole vibe. 💫

Here's the tea: dreln walks the PATH you give it, and whenever it finds a symlink whose target includes an absolute path to OLDPATH, it swaps that symlink out for a brand new link whose target points at NEWPATH instead. slay.

Lowkey the actual best use case: you migrated a huge directory from one file system to another, and all your symlinks are still pointing at absolute paths on the original file system. dreln is the one who comes in and fixes all of that. iconic. 👑

🎀 OPTIONS 🎀

  • -i, --input FILE — read the source list from FILE. heads up: FILE has to be generated by some other tool from the mpiFileUtils suite. no random files, okay? 🙈
  • -p, --preserve — keep the modification times that already exist on the links. don't touch what's already cute. 💖
  • -r, --relative — replace links using target paths that are relative to NEWPATH. 🦋
  • --progress N — print a progress message to stdout roughly every N seconds. N has to be a non-negative integer (fr fr, she checks). a value of 0 turns progress messages all the way off. ⭐
  • -v, --verbose — run in verbose mode. she will tell you things. 😭
  • -q, --quiet — run the tool silently. no output gets printed. not a single crumb. 💀
  • -h, --help — print a brief message listing the drm(1) options and usage. yes bestie, it literally says drm(1) — that's what the page says, and I refuse to gaslight you about it. 🫶

🌸 EXAMPLES 🌸

1. To update all links under /walk/path whose targets point to /orig/path and replace them with targets that point to /new/path:

mpirun -np 128 dreln -v /orig/path /new/path /walk/path

2. Same as above, but replace each link target with a relative path from the link to its new target under /new/path:

mpirun -np 128 dreln -v --relative /orig/path /new/path /walk/path

3. One can preserve existing modification times on links:

mpirun -np 128 dreln -v --preserve /orig/path /new/path /walk/path

4. One can specify multiple paths to walk:

mpirun -np 128 dreln -v /orig/path /new/path /walk/path1 /walk/path2

💜 SEE ALSO 💜

The mpiFileUtils source code and all documentation may be downloaded from <https://github.com/hpc/mpifileutils> — go support her, she's doing the work. 🌈

👑 AUTHOR 👑

HPC

2022, LLNL/LANL/UT-Battelle/DDN

okay that's the whole page, no cap 😭💅 — this was dreln, version 0.12, dated Jan 29, 2025, and that's the DRELN(1) manual page, mpiFileUtils girlie forever. 🎀🌸🦋

go fix your symlinks bestie, they're giving "left on read" 🫶
📦 where this page comes from