X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/e30f065766d103b47aaccbe777308e0d2381fd6e..66203a982b3d249bafda9b9272c4c103c19e4a9b:/rsync.yo diff --git a/rsync.yo b/rsync.yo index 9007cd0d..90406aec 100644 --- a/rsync.yo +++ b/rsync.yo @@ -216,17 +216,6 @@ Here is a short summary of the options available in rsync. Please refer to the detailed description below for a complete description. verb( -Usage: rsync [OPTION]... SRC [SRC]... [USER@]HOST:DEST - or rsync [OPTION]... [USER@]HOST:SRC DEST - or rsync [OPTION]... SRC [SRC]... DEST - or rsync [OPTION]... [USER@]HOST::SRC [DEST] - or rsync [OPTION]... SRC [SRC]... [USER@]HOST::DEST - or rsync [OPTION]... rsync://[USER@]HOST[:PORT]/SRC [DEST] -SRC on single-colon remote HOST will be expanded by remote shell -SRC on server remote HOST may contain shell wildcards or multiple - sources separated by space as long as they have same top-level - -Options -v, --verbose increase verbosity -q, --quiet decrease verbosity -c, --checksum always checksum @@ -234,6 +223,7 @@ Options -r, --recursive recurse into directories -R, --relative use relative path names -b, --backup make backups (default ~ suffix) + --backup-dir=DIR put backups in the specified directory --suffix=SUFFIX override backup suffix -u, --update update only (don't overwrite newer files) -l, --links preserve soft links @@ -254,8 +244,11 @@ Options -e, --rsh=COMMAND specify rsh replacement --rsync-path=PATH specify path to rsync on the remote machine -C, --cvs-exclude auto ignore files in the same way CVS does + --existing only update files that already exist --delete delete files that don't exist on the sending side --delete-excluded also delete excluded files on the receiving side + --delete-after delete after transferring, not before + --max-delete=NUM don't delete more than NUM files --partial keep partially transferred files --force force deletion of directories even if not empty --numeric-ids don't map uid/gid values by user/group name @@ -356,6 +349,10 @@ dit(bf(-b, --backup)) With this option preexisting destination files are renamed with a ~ extension as each file is transferred. You can control the backup suffix using the --suffix option. +dit(bf(--backup-dir=DIR)) In combination with the --backup option, this +tells rsync to store all backups in the specified directory. This is +very useful for incremental backups. + dit(bf(--suffix=SUFFIX)) This option allows you to override the default backup suffix used with the -b option. The default is a ~. @@ -433,6 +430,13 @@ 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(--existing)) This tells rsync not to create any new files - +only update files that already exist on the destination. + +dit(bf(--max-delete=NUM)) This tells rsync not to delete more than NUM +files or directories. This is useful when mirroring very large trees +to prevent disasters. + dit(bf(--delete)) This tells rsync to delete any files on the receiving side that aren't on the sending side. Files that are excluded from transfer are excluded from being deleted unless you use --delete-excluded.