diff options
Diffstat (limited to 'upstream/fedora-rawhide/man1/rsync.1')
| -rw-r--r-- | upstream/fedora-rawhide/man1/rsync.1 | 65 |
1 files changed, 54 insertions, 11 deletions
diff --git a/upstream/fedora-rawhide/man1/rsync.1 b/upstream/fedora-rawhide/man1/rsync.1 index 66a2da39..63277c0e 100644 --- a/upstream/fedora-rawhide/man1/rsync.1 +++ b/upstream/fedora-rawhide/man1/rsync.1 @@ -1,4 +1,4 @@ -.TH "rsync" "1" "20 Oct 2022" "rsync 3.2.7" "User Commands" +.TH "rsync" "1" "6 Apr 2024" "rsync 3.3.0" "User Commands" .\" prefix=/usr .P .SH "NAME" @@ -30,7 +30,9 @@ Usages with just one SRC arg and no DEST arg will list the source files instead of copying. .P The online version of this manpage (that includes cross-linking of topics) -is available at https://download.samba.org/pub/rsync/rsync.1. +is available at +.UR https://download.samba.org/pub/rsync/rsync.1 +.UE . .P .SH "DESCRIPTION" .P @@ -306,7 +308,7 @@ to be copied to different destination directories using more than one copy. .P While a copy of a case-ignoring filesystem to a case-ignoring filesystem can work out fairly well, if no \fB\-\-delete-during\fP or \fB\-\-delete-before\fP option is -active, rsync can potentially update an existing file on the receiveing side +active, rsync can potentially update an existing file on the receiving side without noticing that the upper-/lower-case of the filename should be changed to match the sender. .P @@ -604,6 +606,9 @@ has its own detailed description later in this manpage. --modify-window=NUM, -@ set the accuracy for mod-time comparisons --temp-dir=DIR, -T create temporary files in directory DIR --fuzzy, -y find similar file for basis if no dest file +--detect-renamed try to find renamed files to speed the xfer +--detect-renamed-lax ...& assume identical to src files (risky!) +--detect-moved ... only if basenames match (less risky) --compare-dest=DIR also compare destination files relative to DIR --copy-dest=DIR ... and include copies of unchanged files --link-dest=DIR hardlink to files in DIR when unchanged @@ -1728,7 +1733,9 @@ mounted to avoid updating the atime on read access even without the O_NOATIME flag being set. .IP "\fB\-\-crtimes\fP, \fB\-N,\fP" This tells rsync to set the create times (newness) of the destination -files to the same value as the source files. +files to the same value as the source files. Your OS & filesystem must +support the setting of arbitrary creation (birth) times for this option +to be supported. .IP "\fB\-\-omit-dir-times\fP, \fB\-O\fP" This tells rsync to omit directories when it is preserving modification, access, and create times. If NFS is sharing the directories on the receiving @@ -2153,7 +2160,8 @@ memory. It is a sanity-check value for each individual allocation. See the \fB\-\-max-size\fP option for a description of how SIZE can be specified. The default suffix if none is given is bytes. .IP -Beginning in 3.2.3, a value of 0 specifies no limit. +Beginning in 3.2.7, a value of 0 is an easy way to specify SIZE_MAX (the +largest limit possible). .IP You can set a default value using the environment variable \fBRSYNC_MAX_ALLOC\fP using the same SIZE values as supported by this @@ -2698,6 +2706,30 @@ alternate destination directories that are specified via Note that the use of the \fB\-\-delete\fP option might get rid of any potential fuzzy-match files, so either use \fB\-\-delete-after\fP or specify some filename exclusions if you need to prevent this. +.IP "\fB\-\-detect-renamed\fP" +With this option, for each new source file (call it \fBsrc/S\fP), rsync looks +for a file \fBdest/D\fP anywhere in the destination that passes the quick check +with \fBsrc/S\fP. If such a \fBdest/D\fP is found, rsync uses it as an alternate +basis for transferring \fBS\fP. The idea is that if \fBsrc/S\fP was renamed from +\fBsrc/D\fP (as opposed to \fBsrc/S\fP passing the quick check with \fBdest/D\fP by +coincidence), the delta-transfer algorithm will find that all the data +matches between \fBsrc/S\fP and \fBdest/D\fP, and the transfer will be really fast. +.IP +By default, alternate-basis files are hard-linked into a directory named +".~tmp~" in each file's destination directory, but if you've specified the +\fB\-\-partial-dir\fP option, that directory will be used instead. These +otential alternate-basis files will be removed as the transfer progresses. +This option conflicts with \fB\-\-inplace\fP and \fB\-\-append\fP. +.IP "\fB\-\-detect-renamed-lax\fP" +This version of \fB\-\-detect-renamed\fP makes rsync hard-link \fBdest/D\fP +to \fBdest/S\fP without verifying that \fBsrc/S\fP and \fBdest/S\fP have the same data. +This poses a significant risk of corrupting the destination by representing +a new source file by an unrelated destination file that coincidentally +passes the quick check with the source file. Use this option only if you +accept the risk and disk I/O is a bottleneck. +.IP "\fB\-\-detect-moved\fP" +A less risky variant of \fB\-\-detect-renamed-lax\fP that only uses a +destination file that has the same basename as the new source file. .IP "\fB\-\-compare-dest=DIR\fP" This option instructs rsync to use \fIDIR\fP on the destination machine as an additional hierarchy to compare destination files against doing transfers @@ -5000,11 +5032,13 @@ File permissions, devices, etc. are transferred as native numerical values. .IP o See also the comments on the \fB\-\-delete\fP option. .P -Please report bugs! See the web site at https://rsync.samba.org/. +Please report bugs! See the web site at +.UR https://rsync.samba.org/ +.UE . .P .SH "VERSION" .P -This manpage is current for version 3.2.7 of rsync. +This manpage is current for version 3.3.0 of rsync. .P .SH "INTERNAL OPTIONS" .P @@ -5020,14 +5054,22 @@ that can be used with a restricted ssh login. Rsync is distributed under the GNU General Public License. See the file COPYING for details. .P -An rsync web site is available at https://rsync.samba.org/. The site +An rsync web site is available at +.UR https://rsync.samba.org/ +.UE . +The site includes an FAQ-O-Matic which may cover questions unanswered by this manual page. .P -The rsync github project is https://github.com/WayneD/rsync. +The rsync github project is +.UR https://github.com/WayneD/rsync +.UE . .P We would be delighted to hear from you if you like this program. Please -contact the mailing-list at rsync@lists.samba.org. +contact the mailing-list at +.UR mailto:rsync@lists.samba.org +rsync@lists.samba.org +.UE . .P This program uses the excellent zlib compression library written by Jean-loup Gailly and Mark Adler. @@ -5048,4 +5090,5 @@ people have later contributed to it. It is currently maintained by Wayne Davison. .P Mailing lists for support and development are available at -https://lists.samba.org/. +.UR https://lists.samba.org/ +.UE . |