bup-drecurse(1)

💖 NAME 💖

bup-drecurse — recursively list files in your filesystem, bestie 🌸

---

✨ SYNOPSIS ✨

bup drecurse [-x] [-q] [--exclude path]  [--exclude-from filename]
[--exclude-rx pattern]  [--exclude-rx-from filename] [--profile] <path>

---

🦋 DESCRIPTION 🦋

okay so bup drecurse walks through the files in your filesystem in a way that's similar to find(1). but listen — in most cases, you should literally just use find(1) instead. no cap. 🙈

so what's the point then? this program is useful mainly for testing the file traversal algorithm used in bup-index(1). that's its whole moment. it's the test kitchen, not the restaurant. 👑

and here's the tea you cannot miss: filenames are returned in reverse alphabetical order, as in bup-index(1). this is important because you can't generate the hash of a parent directory until you have generated the hashes of all its children 💅. when you're listing files in reverse order, the parent directory will come after its children, which makes that whole thing easy. it's giving parent showing up fashionably late to their own kid's recital. 🎀

---

💅 OPTIONS 💅

• -x, --xdev, --one-file-system — don't cross filesystem boundaries 🚧 — though as with tar and rsync, the mount points themselves will still be reported. so like, it respects the boundary but still yells "hey, there's a door here!" 🚪
• -q, --quiet — don't print filenames as they are encountered 🤫. useful when testing performance of the traversal algorithms — like, you want the numbers, not the noise, periodt.
• --exclude=path — exclude path from the backup (may be repeated). stack 'em up, queen. 🔥
• --exclude-from=filename — read --exclude paths from filename, one path per-line (may be repeated). ignore completely empty lines. truly the "no thoughts, head empty" line filter. 🫶
• --exclude-rx=pattern — exclude any path matching pattern. see bup-index(1) for details, but note that unlike index, drecurse will produce relative paths if the drecurse target is a relative path 🌀 (may be repeated).
• --exclude-rx-from=filename — read --exclude-rx patterns from filename, one pattern per-line (may be repeated). ignore completely empty lines. same energy as above, diff lenny face. 💜
• --profile — print profiling information upon completion 📊. useful when testing performance of the traversal algorithms. it's the "how did we do, bestie?" receipt.

---

🌈 EXAMPLES 🌈

bup drecurse -x /

---

👀 SEE ALSO 👀

• bup-index(1)

---

🧚 BUP 🧚

part of the bup(1) suite. you're in the family, you're in the group chat. 🌸

---

⭐ AUTHORS ⭐

Avery Pennarun apenwarr@gmail.com

---

~ and that's the whole page, bestie!! 🎀 written for Bup 0.34 and dated 2026-09-01 — this manual for bup-drecurse(1) ate and left no crumbs, mwah 💅✨