More --delete-before improvements.

This commit is contained in:
Wayne Davison
2005-01-28 08:01:33 +00:00
parent 57f74bd1c2
commit 2c0fa6c5df

View File

@@ -680,7 +680,7 @@ file that is larger than the specified SIZE. The SIZE value can be
suffixed with a letter to indicate a size multiplier (K, M, or G) and
may be a fractional value (e.g. "--max-size=1.5m").
dit(bf(--delete, --delete-before)) This tells rsync to delete extraneous files from the
dit(bf(--delete)) This tells rsync to delete extraneous files from the
receiving side (ones that aren't on the sending side), but only for the
directories that are being synchronized. You must have asked rsync to
send the whole directory (e.g. "dir" or "dir/") without using a wildcard
@@ -701,21 +701,30 @@ prevent temporary filesystem failures (such as NFS errors) on the
sending side causing a massive deletion of files on the
destination. You can override this with the --ignore-errors option.
If you don't specify --delete-during (--del) or --delete-after, the
file deletions will be done before the first file is transferred.
This is helpful if the filesystem is tight for space
The --delete option may be combined with one of the --delete-WHEN options
without conflict, as well as --delete-excluded. However, if none of the
--delete-WHEN options are specified, rsync will currently choose the
--delete-before algorithm. A future version may change this to choose the
--delete-during algorithm. See also --delete-after.
dit(bf(--delete-before)) Request that the file-deletions on the receiving
side be done before the transfer starts. This is the default if --delete
or --delete-excluded is specified without one of the --delete-WHEN options.
See --delete (which is implied) for more details on file-deletion.
Deleting before the transfer is helpful if the filesystem is tight for space
and removing extraneous files would help to make the transfer possible.
However, it does introduce a delay before the start of the transfer,
and this delay might cause the transfer to timeout (if --timeout was
specified).
dit(bf(--del, --delete-during)) Request that the file-deletions on the
receving side be done incrementally as the transfer happens. This is
a faster method than chosing the before- or after-transfer processing,
dit(bf(--delete-during, --del)) Request that the file-deletions on the
receiving side be done incrementally as the transfer happens. This is
a faster method than chosing the before- or after-transfer algorithm,
but it is only supported beginning with rsync version 2.6.4.
See --delete (which is implied) for more details on file-deletion.
dit(bf(--delete-after)) Request that the file-deletions on the receving
dit(bf(--delete-after)) Request that the file-deletions on the receiving
side be done after the transfer has completed. This is useful if you
are sending new per-directory merge files as a part of the transfer and
you want their exclusions to take effect for the delete phase of the