mailto(rsync-bugs@samba.org)
-manpage(rsync)(1)(26 Jan 2003)()()
+manpage(rsync)(1)(1 Jan 2004)()()
manpagename(rsync)(faster, flexible replacement for rcp)
manpagesynopsis()
-R, --relative use relative path names
--no-relative turn off --relative
--no-implied-dirs don't send implied dirs with -R
- -b, --backup make backups (see --suffix)
+ -b, --backup make backups (see --suffix & --backup-dir)
--backup-dir make backups into this directory
- --suffix=SUFFIX define backup suffix (default ~ w/o --backup-dir)
+ --suffix=SUFFIX backup suffix (default ~ w/o --backup-dir)
-u, --update update only (don't overwrite newer files)
-l, --links copy symlinks as symlinks
-L, --copy-links copy the referent of symlinks
--no-whole-file turn off --whole-file
-x, --one-file-system don't cross filesystem boundaries
-B, --block-size=SIZE checksum blocking size (default 700)
- -e, --rsh=COMMAND specify the remote shell to use
+ -e, --rsh=COMMAND specify the remote shell
--rsync-path=PATH specify path to rsync on the remote machine
--existing only update files that already exist
- --ignore-existing ignore files that already exist on the receiving side
- --delete delete files that don't exist on the sending side
- --delete-excluded also delete excluded files on the receiving side
+ --ignore-existing ignore files that already exist on receiver
+ --delete delete files that don't exist on sender
+ --delete-excluded also delete excluded files on receiver
--delete-after delete after transferring, not before
--ignore-errors delete even if there are IO errors
--max-delete=NUM don't delete more than NUM files
--partial keep partially transferred files
- --force force deletion of directories even if not empty
+ --force force deletion of dirs even if not empty
--numeric-ids don't map uid/gid values by user/group name
--timeout=TIME set IO timeout in seconds
- -I, --ignore-times don't exclude files that match length and time
- --size-only only use file size when determining if a file should be transferred
- --modify-window=NUM Timestamp window (seconds) for file match (default=0)
+ -I, --ignore-times turn off mod time & file size quick check
+ --size-only ignore mod time for quick check (use size)
+ --modify-window=NUM compare mod times with reduced accuracy
-T --temp-dir=DIR create temporary files in directory DIR
- --compare-dest=DIR also compare destination files relative to DIR
+ --compare-dest=DIR also compare received files relative to DIR
--link-dest=DIR create hardlinks to DIR for unchanged files
-P equivalent to --partial --progress
-z, --compress compress file data
--include=PATTERN don't exclude files matching PATTERN
--include-from=FILE don't exclude patterns listed in FILE
--files-from=FILE read FILE for list of source-file names
- -0 --from0 file names we read are separated by nulls, not newlines
+ -0 --from0 all file lists are delimited by nulls
--version print version number
--daemon run as a rsync daemon
--no-detach do not detach from the parent
--log-format=FORMAT log file transfers using specified format
--password-file=FILE get password from FILE
--bwlimit=KBPS limit I/O bandwidth, KBytes per second
- --read-batch=PREFIX read batch fileset starting with PREFIX
--write-batch=PREFIX write batch fileset starting with PREFIX
+ --read-batch=PREFIX read batch fileset starting with PREFIX
-h, --help show this help screen
cron.
dit(bf(-I, --ignore-times)) Normally rsync will skip any files that are
-already the same length and have the same time-stamp. This option turns
-off this behavior.
+already the same size and have the same modification time-stamp.
+This option turns off this "quick check" behavior.
dit(bf(--size-only)) Normally rsync will skip any files that are
-already the same length and have the same time-stamp. With the
+already the same size and have the same modification time-stamp. With the
--size-only option files will be skipped if they have the same size,
regardless of timestamp. This is useful when starting to use rsync
after using another mirroring system which may not preserve timestamps
rather than the default port 873.
dit(bf(--blocking-io)) This tells rsync to use blocking IO when launching
-a remote shell transport. If the remote shell is either rsh or remsh (and
-assuming the RSYNC_RSH_IO value does not apply), rsync defaults to using
+a remote shell transport. If the remote shell is either rsh or remsh,
+rsync defaults to using
blocking IO, otherwise it defaults to using non-blocking IO. (Note that
ssh prefers non-blocking IO.)
override the default shell used as the transport for rsync. Command line
options are permitted after the command name, just as in the -e option.
-dit(bf(RSYNC_RSH_IO)) The RSYNC_RSH_IO environment variable allows you to
-override the blocking IO default for the shell specified in RSYNC_RSH. Set
-it to either "blocking" or "non-blocking". This value is only used if the
-remote-shell choice exactly matches the value of the RSYNC_RSH variable.
-Otherwise the default blocking-IO value will be used, as mentioned in
-the --blocking-io option's description above.
-
dit(bf(RSYNC_PROXY)) The RSYNC_PROXY environment variable allows you to
redirect your rsync client to use a web proxy when connecting to a
rsync daemon. You should set RSYNC_PROXY to a hostname:port pair.
Matt McCutchen's Web Site / rsync / rsync.git / blobdiff