X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/bef493404517020b3c863c90d5d26f50bbf0bc74..59c95e4243749273fe91f8197a39f89e4d905cb8:/rsync.yo diff --git a/rsync.yo b/rsync.yo index 9df6b6f4..21d69624 100644 --- a/rsync.yo +++ b/rsync.yo @@ -15,6 +15,8 @@ rsync [OPTION]... SRC [SRC]... [USER@]HOST::DEST rsync [OPTION]... rsync://[USER@]HOST[:PORT]/SRC [DEST] +rsync [OPTION]... SRC [SRC]... rsync://[USER@]HOST[:PORT]/DEST + manpagedescription() rsync is a program that behaves in much the same way that rcp does, @@ -63,7 +65,7 @@ itemize( it() for copying from the local machine to a remote rsync server. This is invoked when the destination path contains a :: - separator. + separator or a rsync:// URL. it() for copying from a remote machine using a remote shell program as the transport, using rsync server on the remote @@ -163,7 +165,7 @@ that: itemize( it() you use a double colon :: instead of a single colon to - separate the hostname from the path. + separate the hostname from the path or a rsync:// URL. it() the remote server may print a message of the day when you connect. @@ -322,6 +324,7 @@ verb( --modify-window=NUM Timestamp window (seconds) for file match (default=0) -T --temp-dir=DIR create temporary files in directory DIR --compare-dest=DIR also compare destination files relative to DIR + --link-dest=DIR create hardlinks to DIR for unchanged files -P equivalent to --partial --progress -z, --compress compress file data --exclude=PATTERN exclude files matching PATTERN @@ -580,7 +583,8 @@ If this option is used with bf([user@]host::module/path), then the remote shell em(COMMMAND) will be used to run an rsync server on the remote host, and all data will be transmitted through that remote shell connection, rather than through a direct socket connection to a -running rsync server on the remote host. +running rsync server on the remote host. See the section "CONNECTING +TO AN RSYNC SERVER OVER A REMOTE SHELL PROGRAM" above. Command-line arguments are permitted in COMMAND provided that COMMAND is presented to rsync as a single argument. For example: @@ -614,6 +618,8 @@ dit(bf(--exclude-from=FILE)) This option is similar to the --exclude option, but instead it adds all exclude patterns listed in the file FILE to the exclude list. Blank lines in FILE and lines starting with ';' or '#' are ignored. +If em(FILE) is bf(-) the list will be read from standard input. + dit(bf(--include=PATTERN)) This option tells rsync to not exclude the specified pattern of filenames. This is useful as it allows you to @@ -624,6 +630,8 @@ this option. dit(bf(--include-from=FILE)) This specifies a list of include patterns from a file. +If em(FILE) is bf(-) the list will be read from standard input. + dit(bf(-C, --cvs-exclude)) This is a useful shorthand for excluding a broad range of files that you often don't want to transfer between @@ -679,6 +687,11 @@ files that haven't changed). This option increases the usefulness of temporary destination until they have a chance to be completed. If DIR is a relative path, it is relative to the destination directory. +dit(bf(--link-dest=DIR)) This option behaves like bf(--compare-dest) but +also will create hard links from em(DIR) to the destination directory for +unchanged files. Files with changed ownership or permissions will not be +linked. + dit(bf(-z, --compress)) With this option, rsync compresses any data from the files that it sends to the destination machine. This option is useful on slow links. The compression method used is the