diff options
author | Wayne Davison <wayne@opencoder.net> | 2022-01-02 14:43:30 -0800 |
---|---|---|
committer | Wayne Davison <wayne@opencoder.net> | 2022-01-02 14:43:30 -0800 |
commit | 4a7ba3cfaf99f2ad42a7b810fead3cee75d9205b (patch) | |
tree | b51a4b9442a106da99e9b2d1e42c78003c69ecd4 | |
parent | ffbca80ca2347beaa1004db56db439cdfa59f59e (diff) | |
download | rsync-4a7ba3cfaf99f2ad42a7b810fead3cee75d9205b.tar.gz |
A couple man page improvements.
-rw-r--r-- | rsync.1.md | 19 |
1 files changed, 19 insertions, 0 deletions
@@ -535,6 +535,18 @@ your home directory (remove the '=' for that). being skipped and slightly more information at the end. More than two `-v` options should only be used if you are debugging rsync. + The end-of-run summary tells you the number of bytes sent to the remote + rsync (which is the receiving side on a local copy), the number of bytes + received from the remote host, and the average bytes per second of the + transferred data computed over the entire length of the rsync run. The + second line shows the total size (in bytes), which is the sum of all the + file sizes that rsync considered transferring. It also shows a "speedup" + value, which is a ratio of the total file size divided by the sum of the + sent and received bytes (which is really just a feel-good bigger-is-better + number). Note that these byte values can be made more (or less) + human-readable by using the `--human-readable` (or `--no-human-readable`) + options. + In a modern rsync, the `-v` option is equivalent to the setting of groups of `--info` and `--debug` options. You can choose to use these newer options in addition to, or in place of using `--verbose`, as any @@ -899,6 +911,13 @@ your home directory (remove the '=' for that). data that goes into the file-lists, and thus it doesn't affect deletions. It just limits the files that the receiver requests to be transferred. + A caution for those that choose to combine `--inplace` with `--update`: an + interrupted transfer will leave behind a partial file on the receiving side + that has a very recent modified time, so re-running the transfer will + probably **not** continue the interrutped file. As such, it is usually + best to avoid combining this with `--inplace` unless you have implemented + manual steps to handle any interrutped in-progress files. + 0. `--inplace` This option changes how rsync transfers a file when its data needs to be |