X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/42d8ec616d5108d1dc2bc949fe967620da653451..4e9c7fae8f6feb2fecaea811b318cf416d23dd9a:/rsync.yo diff --git a/rsync.yo b/rsync.yo index 941f7a58..a1b69ef0 100644 --- a/rsync.yo +++ b/rsync.yo @@ -566,7 +566,7 @@ dit(bf(-c, --checksum)) This changes the way rsync checks if the files have been changed and are in need of a transfer. Without this option, rsync uses a "quick check" that (by default) checks if each file's size and time of last modification match between the sender and receiver. This option -changes this to compare a 128-bit MD4 checksum for each file that has a +changes this to compare a 128-bit checksum for each file that has a matching size. Generating the checksums means that both sides will expend a lot of disk I/O reading all the data in the files in the transfer (and this is prior to any reading that will be done to transfer changed files), @@ -584,6 +584,9 @@ checksum that is generated as the file is transferred, but that automatic after-the-transfer verification has nothing to do with this option's before-the-transfer "Does this file need to be updated?" check. +For protocol 30 and beyond (first supported in 3.0.0), the checksum used is +MD5. For older protocols, the checksum used is MD4. + dit(bf(-a, --archive)) This is equivalent to bf(-rlptgoD). It is a quick way of saying you want recursion and want to preserve almost everything (with -H being a notable omission). @@ -1945,6 +1948,9 @@ specify an empty string, updated files will not be mentioned in the log file. For a list of the possible escape characters, see the "log format" setting in the rsyncd.conf manpage. +The default FORMAT used if bf(--log-file) is specified and this option is not +is '%i %n%L'. + dit(bf(--stats)) This tells rsync to print a verbose set of statistics on the file transfer, allowing you to tell how effective rsync's delta-transfer algorithm is for your data. This option is equivalent to bf(--info=stats2) @@ -2303,9 +2309,9 @@ If rsync was complied without support for IPv6, the bf(--ipv6) option will have no effect. The bf(--version) output will tell you if this is the case. -dit(bf(--checksum-seed=NUM)) Set the MD4 checksum seed to the integer +dit(bf(--checksum-seed=NUM)) Set the checksum seed to the integer NUM. This 4 byte checksum seed is included in each block and file -MD4 checksum calculation. By default the checksum seed is generated +checksum calculation. By default the checksum seed is generated by the server and defaults to the current code(time()). This option is used to set a specific checksum seed, which is useful for applications that want repeatable block and file checksums, or @@ -2859,27 +2865,26 @@ of the destination trees. The write-batch option causes the rsync client to store in a "batch file" all the information needed to repeat this operation against other, identical destination trees. -To apply the recorded changes to another destination tree, run rsync -with the read-batch option, specifying the name of the same batch -file, and the destination tree. Rsync updates the destination tree -using the information stored in the batch file. - -For convenience, one additional file is creating when the write-batch -option is used. This file's name is created by appending -".sh" to the batch filename. The .sh file contains -a command-line suitable for updating a destination tree using that -batch file. It can be executed using a Bourne (or Bourne-like) shell, -optionally -passing in an alternate destination tree pathname which is then used -instead of the original path. This is useful when the destination tree -path differs from the original destination tree path. - Generating the batch file once saves having to perform the file status, checksum, and data block generation more than once when updating multiple destination trees. Multicast transport protocols can be used to transfer the batch update files in parallel to many hosts at once, instead of sending the same data to every host individually. +To apply the recorded changes to another destination tree, run rsync +with the read-batch option, specifying the name of the same batch +file, and the destination tree. Rsync updates the destination tree +using the information stored in the batch file. + +For your convenience, a script file is also created when the write-batch +option is used: it will be named the same as the batch file with ".sh" +appended. This script file contains a command-line suitable for updating a +destination tree using the associated batch file. It can be executed using +a Bourne (or Bourne-like) shell, optionally passing in an alternate +destination tree pathname which is then used instead of the original +destination path. This is useful when the destination tree path on the +current host differs from the one used to create the batch file. + Examples: quote(