.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "bup-drecurse" "1" "2021-02-06" "Bup 0.32" ""
.hy
.SH NAME
.PP
bup-drecurse - recursively list files in your filesystem
.SH SYNOPSIS
.PP
bup drecurse [-x] [-q] [--exclude \f[I]path\f[R]] \ [--exclude-from
\f[I]filename\f[R]] [--exclude-rx \f[I]pattern\f[R]]
\ [--exclude-rx-from \f[I]filename\f[R]] [--profile] <path>
.SH DESCRIPTION
.PP
\f[C]bup drecurse\f[R] traverses files in the filesystem in a way
similar to \f[C]find\f[R](1).
In most cases, you should use \f[C]find\f[R](1) instead.
.PP
This program is useful mainly for testing the file traversal algorithm
used in \f[C]bup-index\f[R](1).
.PP
Note that filenames are returned in reverse alphabetical order, as in
\f[C]bup-index\f[R](1).
This is important because you can\[cq]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.
.SH OPTIONS
.TP
-x, --xdev, --one-file-system
don\[cq]t cross filesystem boundaries \[en] though as with tar and
rsync, the mount points themselves will still be reported.
.TP
-q, --quiet
don\[cq]t print filenames as they are encountered.
Useful when testing performance of the traversal algorithms.
.TP
--exclude=\f[I]path\f[R]
exclude \f[I]path\f[R] from the backup (may be repeated).
.TP
--exclude-from=\f[I]filename\f[R]
read \[en]exclude paths from \f[I]filename\f[R], one path per-line (may
be repeated).
Ignore completely empty lines.
.TP
--exclude-rx=\f[I]pattern\f[R]
exclude any path matching \f[I]pattern\f[R].
See \f[C]bup-index\f[R](1) for details, but note that unlike index,
drecurse will produce relative paths if the drecurse target is a
relative path.
(may be repeated).
.TP
--exclude-rx-from=\f[I]filename\f[R]
read \[en]exclude-rx patterns from \f[I]filename\f[R], one pattern
per-line (may be repeated).
Ignore completely empty lines.
.TP
--profile
print profiling information upon completion.
Useful when testing performance of the traversal algorithms.
.SH EXAMPLES
.IP
.nf
\f[C]
bup drecurse -x /
\f[R]
.fi
.SH SEE ALSO
.PP
\f[C]bup-index\f[R](1)
.SH BUP
.PP
Part of the \f[C]bup\f[R](1) suite.
.SH AUTHORS
Avery Pennarun <apenwarr@gmail.com>.