X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/15800c7e89b4b5a51b6fe7cc42e28be6c37bb04f..0503f06089b89aa4166d6ced8d5901ad6a112c41:/rsync.yo diff --git a/rsync.yo b/rsync.yo index 3d3eee5e..459fb44c 100644 --- a/rsync.yo +++ b/rsync.yo @@ -1,5 +1,5 @@ mailto(rsync-bugs@samba.org) -manpage(rsync)(1)(17 Feb 1999)()() +manpage(rsync)(1)(1 Mar 1999)()() manpagename(rsync)(faster, flexible replacement for rcp) manpagesynopsis() @@ -139,6 +139,11 @@ It is also possible to use rsync without using rsh or ssh as the transport. In this case you will connect to a remote rsync server running on TCP port 873. +You may establish the connetcion via a web proxy by setting the +environment variable RSYNC_PROXY to a hostname:port pair pointing to +your web proxy. Note that your web proxy must allow proxying to port +873, this must be configured in your proxy servers ruleset. + Using rsync in this way is the same as using it with rsh or ssh except that: @@ -250,11 +255,13 @@ Options --rsync-path=PATH specify path to rsync on the remote machine -C, --cvs-exclude auto ignore files in the same way CVS does --delete delete files that don't exist on the sending side + --delete-excluded also delete excluded files on the receiving side --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 --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 -T --temp-dir=DIR create temporary files in directory DIR --compare-dest=DIR also compare destination files relative to DIR -z, --compress compress file data @@ -304,19 +311,28 @@ 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. +dit(bf(-I, --size-only)) Normally rsync will skip any files that are +already the same length and have the same 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 +exactly. + dit(bf(-c, --checksum)) This forces the sender to checksum all files using a 128-bit MD4 checksum before transfer. The checksum is then explicitly checked on the receiver and any files of the same name which already exist and have the same checksum and size on the receiver are skipped. This option can be quite slow. -dit(bf(-a, --archive)) This is equivalent to -rlptDg. It is a quick way +dit(bf(-a, --archive)) This is equivalent to -rlptg. It is a quick way of saying you want recursion and want to preserve everything. -Note: if the user launching rsync is root then the -o option (preserve -uid) is also implied. +Note: if the user launching rsync is root then the -o (preserve +uid) and -D (preserve devices) options are also implied. -dit(bf(-r, --recursive)) This tells rsync to copy directories recursively. +dit(bf(-r, --recursive)) This tells rsync to copy directories +recursively. If you don't specify this then rsync won't copy +directories at all. dit(bf(-R, --relative)) Use relative paths. This means that the full path names specified on the command line are sent to the server rather than @@ -391,9 +407,9 @@ the --numeric-ids option is implied because the source system cannot get access to the usernames. dit(bf(-g, --group)) This option causes rsync to update the remote group -of the file to be the same as the local group. Note that if the source -system is a daemon using chroot, the --numeric-ids option is implied because -the source system cannot get access to the group names. +of the file to be the same as the local group. If the receving system is +not running as the super-user, only groups that the receiver is a member of +will be preserved (by group name, not group id number). dit(bf(-D, --devices)) This option causes rsync to transfer character and block device information to the remote system to recreate these @@ -422,12 +438,14 @@ boundaries when recursing. This is useful for transferring the contents of only one filesystem. dit(bf(--delete)) This tells rsync to delete any files on the receiving -side that aren't on the sending side. This option can be dangerous if -used incorrectly! +side that aren't on the sending side. Files that are excluded from +transfer are excluded from being deleted unless you use --delete-excluded. + +This option has no effect if directory recursion is not selected. -It is a very good idea to run first using the dry run option (-n) to -see what files would be deleted to make sure important files aren't -listed. +This option can be dangerous if used incorrectly! It is a very good idea +to run first using the dry run option (-n) to see what files would be +deleted to make sure important files aren't listed. rsync 1.6.4 changed the behavior of --delete to make it less dangerous. rsync now only scans directories on the receiving side @@ -444,6 +462,10 @@ prevent temporary filesystem failures (such as NFS errors) on the sending side causing a massive deletion of files on the destination. +dit(bf(--delete-excluded)) In addition to deleting the files on the +receiving side that are not on the sending side, this tells rsync to also +delete any files on the receiving side that are excluded (see --exclude). + dit(bf(--force)) This options tells rsync to delete directories even if they are not empty. This applies to both the --delete option and to cases where rsync tries to copy a normal file but the destination @@ -633,14 +655,15 @@ itemize( directory, not a file, link or device. it() if the pattern contains a wildcard character from the set - *?[ then regular expression matching is applied using the - normal shell filename matching rules. Otherwise a simple string - match is used. + *?[ then expression matching is applied using the shell filename + matching rules. Otherwise a simple string match is used. it() if the pattern contains a / (not counting a trailing /) then it is matched against the full filename, including any leading directory. If the pattern doesn't contain a / then it is matched - only against the final component of the filename. + only against the final component of the filename. Furthermore, if + the pattern includes a double asterisk "**" then all wildcards in + the pattern will match slashes, otherwise they will stop at slashes. it() if the pattern starts with "+ " (a plus followed by a space) then it is always considered an include pattern, even if specified as @@ -663,6 +686,10 @@ itemize( it() --exclude "*.o" would exclude all filenames matching *.o it() --exclude "/foo" would exclude a file in the base directory called foo it() --exclude "foo/" would exclude any directory called foo + it() --exclude "/foo/*/bar" would exclude any file called bar two + levels below a base directory called foo + it() --exclude "/foo/**/bar" would exclude any file called bar two + or more levels below a base directory called foo it() --include "*/" --include "*.c" --exclude "*" would include all directories and C source files it() --include "foo/" --include "foo/bar.c" --exclude "*" would include @@ -705,6 +732,10 @@ dit(bf(RSYNC_RSH)) The RSYNC_RSH environment variable allows you to override the default shell used as the transport for rsync. This can be used instead of the -e option. +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. + dit(bf(RSYNC_PASSWORD)) Setting RSYNC_PASSWORD to the required password allows you to run authenticated rsync connections to a rsync daemon without user intervention. Note that this does not supply a