X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/14d43f1fcf4904f401a0cb38efb921b29a6652b1..fd0abefa433e80dcc4f730f30bc5e4d918a3c10b:/rsync.yo diff --git a/rsync.yo b/rsync.yo index f5276583..90599d79 100644 --- a/rsync.yo +++ b/rsync.yo @@ -1,5 +1,5 @@ -mailto(rsync-bugs@samba.anu.edu.au) -manpage(rsync)(1)(11 Nov 1998)()() +mailto(rsync-bugs@samba.org) +manpage(rsync)(1)(9 Feb 1999)()() manpagename(rsync)(faster, flexible replacement for rcp) manpagesynopsis() @@ -54,7 +54,7 @@ itemize( single : separator. it() for copying from a remote machine to the local machine - using a remote shell program. This is invoked when the local path + using a remote shell program. This is invoked when the source contains a : separator. it() for copying from a remote rsync server to the local @@ -159,7 +159,11 @@ itemize( Some paths on the remote server may require authentication. If so then you will receive a password prompt when you connect. You can avoid the password prompt by setting the environment variable RSYNC_PASSWORD to -the password you want to use. This may be useful when scripting rsync. +the password you want to use or using the --password-file option. This +may be useful when scripting rsync. + +WARNING: On some systems environment variables are visible to all +users. On those systems using --password-file is recommended. manpagesection(RUNNING AN RSYNC SERVER) @@ -216,6 +220,7 @@ Usage: rsync [OPTION]... SRC [USER@]HOST:DEST Options -v, --verbose increase verbosity + -q, --quiet decrease verbosity -c, --checksum always checksum -a, --archive archive mode -r, --recursive recurse into directories @@ -259,6 +264,7 @@ Options --port=PORT specify alternate rsyncd port number --stats give some file transfer stats --progress show progress during transfer + --password-file=FILE get password from FILE --log-format=FORMAT log file transfers using specified format -h, --help show this help screen ) @@ -283,6 +289,11 @@ information on what files are being skipped and slightly more information at the end. More than two -v flags should only be used if you are debugging rsync. +dit(bf(-q, --quiet)) This option decreases the amount of information you +are given during the transfer, notably suppressing information messages +from the remote server. This flag is useful when invoking rsync from +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. @@ -454,7 +465,8 @@ this option. dit(bf(--exclude-from FILE)) This option is similar to the --exclude option, but instead it adds all filenames listed in the file FILE to -the exclude list. +the exclude list. Blank lines in FILE and lines starting with ';' or '#' +are ignored. dit(bf(--include pattern)) This option tells rsync to not exclude the specified pattern of filenames. This is useful as it allows you to @@ -578,6 +590,12 @@ dit(bf(--progress)) This option tells rsync to print information showing the progress of the transfer. This gives a bored user something to watch. +dit(bf(--password-file)) This option allows you to provide a password +in a file for accessing a remote rsync server. Note that this option +is only useful when accessing a rsync server using the built in +transport, not when using a remote shell as the transport. The file +must not be world readable. + enddit() manpagesection(EXCLUDE PATTERNS) @@ -616,11 +634,11 @@ itemize( only against the final component of the filename. it() if the pattern starts with "+ " (a plus followed by a space) - then it is always considered a include pattern, even if specified as + then it is always considered an include pattern, even if specified as part of an exclude option. The "+ " part is discarded before matching. it() if the pattern starts with "- " (a minus followed by a space) - then it is always considered a exclude pattern, even if specified as + then it is always considered an exclude pattern, even if specified as part of an include option. The "- " part is discarded before matching. it() if the pattern is a single exclamation mark ! then the current @@ -637,7 +655,10 @@ itemize( it() --exclude "/foo" would exclude a file in the base directory called foo it() --exclude "foo/" would exclude any directory called foo it() --include "*/" --include "*.c" --exclude "*" would include all - directories and C source files. + directories and C source files + it() --include "foo/" --include "foo/bar.c" --exclude "*" would include + only foo/bar.c (the foo/ directory must be explicitly included or + it would be excluded by the "*") ) manpagesection(DIAGNOSTICS) @@ -656,7 +677,7 @@ verb( ) then look at out.dat. If everything is working correctly then out.dat -should be a zero length file. You you are getting the above error from +should be a zero length file. If you are getting the above error from rsync then you will probably find that out.dat contains some text or data. Look at the contents and try to work out what is producing it. The most common cause is incorrectly configured shell startup @@ -708,7 +729,7 @@ values see also the comments on the --delete option Please report bugs! The rsync bug tracking system is online at -url(http://samba.anu.edu.au/rsync/)(http://samba.anu.edu.au/rsync/) +url(http://rsync.samba.org/rsync/)(http://rsync.samba.org/rsync/) manpagesection(VERSION) This man page is current for version 2.0 of rsync @@ -718,16 +739,16 @@ manpagesection(CREDITS) rsync is distributed under the GNU public license. See the file COPYING for details. -The primary ftp site for rsync is -url(ftp://samba.anu.edu.au/pub/rsync)(ftp://samba.anu.edu.au/pub/rsync). - A WEB site is available at -url(http://samba.anu.edu.au/rsync/)(http://samba.anu.edu.au/rsync/) +url(http://rsync.samba.org/)(http://rsync.samba.org/) + +The primary ftp site for rsync is +url(ftp://rsync.samba.org/pub/rsync)(ftp://rsync.samba.org/pub/rsync). We would be delighted to hear from you if you like this program. -This program uses the zlib compression library written by Jean-loup -Gailly and Mark Adler. +This program uses the excellent zlib compression library written by +Jean-loup Gailly and Mark Adler. manpagesection(THANKS) @@ -739,6 +760,6 @@ probably missed some people, my apologies if I have. manpageauthor() rsync was written by Andrew Tridgell and Paul Mackerras. They may be -contacted via email at tridge@samba.anu.edu.au and +contacted via email at tridge@samba.org and Paul.Mackerras@cs.anu.edu.au