X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/9639c7184225d4928b5908f59efb7f94fceb5402..6d8c6bdbe5c6c63a81b77f928b5d477a7be8fe56:/rsync.yo diff --git a/rsync.yo b/rsync.yo index 045f9696..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 @@ -1158,6 +1173,10 @@ ssh prefers non-blocking I/O.) dit(bf(-i, --itemize-changes)) Requests a simple itemized list of the changes that are being made to each file, including attribute changes. This is exactly the same as specifying bf(--log-format='%i %n%L'). +If you repeat the option, unchanged files will also be output, but only +if the receiving rsync is at least version 2.6.7 (you can use bf(-vv) +with older versions of rsync, but that also turns on the output of other +verbose messages). The "%i" escape has a cryptic output that is 9 letters long. The general format is like the string bf(UXcstpoga)), where bf(U) is replaced by the @@ -1601,6 +1620,10 @@ itemize( (Remember that the algorithm is applied recursively so "full filename" can actually be any portion of a path from the starting directory on down.) + it() a trailing "dir_name/***" will match both the directory (as if + "dir_name/" had been specified) and all the files in the directory + (as if "dir_name/**" had been specified). (This behavior is new for + version 2.6.7.) ) Note that, when using the bf(--recursive) (bf(-r)) option (which is implied by