---
name: "bup-drecurse"
section: "1"
platform: "linux"
package: "bup"
version: "0.34-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/bup-drecurse"
---

# bup-drecurse(1)

recursively list files in your filesystem

## NAME

bup-drecurse - recursively list files in your filesystem

## SYNOPSIS

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

## DESCRIPTION

`bup drecurse` traverses files in the filesystem in a way similar to [`find`(1)](/find/1.md). In most cases, you should use [`find`(1)](/find/1.md) instead.

This program is useful mainly for testing the file traversal algorithm used in [`bup-index`(1)](/bup-index/1.md).

Note that filenames are returned in reverse alphabetical order, as in [`bup-index`(1)](/bup-index/1.md). 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 listing files in reverse order, the parent directory will come after its children, making this easy.

## 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.

- \-q, --quiet

  don’t print filenames as they are encountered. Useful when testing performance of the traversal algorithms.

- \--exclude=*path*

  exclude *path* from the backup (may be repeated).

- \--exclude-from=*filename*

  read –exclude paths from *filename*, one path per-line (may be repeated). Ignore completely empty lines.

- \--exclude-rx=*pattern*

  exclude any path matching *pattern*. See [`bup-index`(1)](/bup-index/1.md) 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.

- \--profile

  print profiling information upon completion. Useful when testing performance of the traversal algorithms.

## EXAMPLES

-

  ```
  bup drecurse -x /
  ```

## SEE ALSO

[`bup-index`(1)](/bup-index/1.md)

## BUP

Part of the [`bup`(1)](/bup/1.md) suite.

## AUTHORS

Avery Pennarun ⟨apenwarr@gmail.com⟩\\c.