]> arthur.barton.de Git - bup.git/blobdiff - Documentation/bup-drecurse.md
main: always put BUP_FORCE_TTY into the environment
[bup.git] / Documentation / bup-drecurse.md
index 13db28d209be61dea2ce0e864e1642eece0bb0f8..ab97ea29af118dd2d146ff60c5d8901e81da0d55 100644 (file)
@@ -8,7 +8,9 @@ bup-drecurse - recursively list files in your filesystem
 
 # SYNOPSIS
 
-bup drecurse [-x] [-q] [--profile] \<path\>
+bup drecurse [-x] [-q] [\--exclude *path*]
+\ [\--exclude-from *filename*] [\--exclude-rx *pattern*]
+\ [\--exclude-rx-from *filename*] [\--profile] \<path\>
 
 # DESCRIPTION
 
@@ -28,19 +30,36 @@ come after its children, making this easy.
 
 # OPTIONS
 
--x, --xdev, --one-file-system
-:   don't cross filesystem boundaries.
+-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
+-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.
     
---profile
+\--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.
+
+\--profile
 :   print profiling information upon completion.  Useful
     when testing performance of the traversal algorithms.
     
-# EXAMPLE
-
+# EXAMPLES
     bup drecurse -x /
 
 # SEE ALSO