From: Wayne Davison Date: Sat, 21 Jan 2006 08:10:45 +0000 (+0000) Subject: Document the new --one-file-system behavior, with improvements to X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/commitdiff_plain/6d8c6bdbe5c6c63a81b77f928b5d477a7be8fe56 Document the new --one-file-system behavior, with improvements to the option's text taken from Matt's patch in bugzilla. --- diff --git a/rsync.yo b/rsync.yo index d06d87fc..622eb567 100644 --- a/rsync.yo +++ b/rsync.yo @@ -734,6 +734,21 @@ dit(bf(-x, --one-file-system)) This tells rsync not to cross filesystem boundaries when recursing. This is useful for transferring the contents of only one filesystem. +dit(bf(-x, --one-file-system)) This tells rsync to avoid recursing into a +directory that is the mount-point for another filesystem, including (as of +2.6.7), "bind" mount-points. You can still copy the contents of multiple +file systems if you include a source dir from each file system -- this just +limits rsync's directory-recursion algorithm. + +Rsync will copy the directory at each encountered mount-point unless this +option is repeated. Note, however, that the attributes of this mount-point +directory are copied from those currently visible in the filesystem, not +the inaccessible attributes of the underlying directory. + +This option does not affect the "collapsing" of symlinks that options such +as bf(--copy-links) perform, irrespective of what filesystem the symlink's +referent may be on. + dit(bf(--existing, --ignore-non-existing)) This tells rsync to skip updating files that do not exist yet on the destination. If this option is combined with the bf(--ignore-existing) option, no files will be updated