X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/81791cfccb89cde245a335d5df223c8a668030b0..d1be231290b3867648ee417fad341fdf1caaa94b:/rsyncd.conf.yo diff --git a/rsyncd.conf.yo b/rsyncd.conf.yo index ac0e7dea..6aae9290 100644 --- a/rsyncd.conf.yo +++ b/rsyncd.conf.yo @@ -1,5 +1,5 @@ -mailto(rsync-bugs@samba.anu.edu.au) -manpage(rsyncd.conf)(5)(13 May 1998)()() +mailto(rsync-bugs@samba.org) +manpage(rsyncd.conf)(5)(18 Nov 1998)()() manpagename(rsyncd.conf)(configuration file for rsync server) manpagesynopsis() @@ -46,7 +46,7 @@ manpagesection(LAUNCHING THE RSYNC DAEMON) The rsync daemon is launched by specifying the --daemon option to rsync. The daemon must run with root privileges. -You can launch it either via inetd or as a standalone daemon. If run +You can launch it either via inetd or as a stand-alone daemon. If run as a daemon then just run the command "rsync --daemon" from a suitable startup script. @@ -176,6 +176,20 @@ equivalent to the client specifying the --exclude-from option with a equivalent file. See also the note about security for the exclude option above. +dit(bf(include)) The "include" option allows you to specify a space +separated list of patterns which rsync should not exclude. This is +equivalent to the client specifying these patterns with the --include +option. This is useful as it allows you to build up quite complex +exclude/include rules. + +See the section of exclude patterns for information on the syntax of +this option. + +dit(bf(include from)) The "include from" option specifies a filename +on the server that contains include patterns, one per line. This is +equivalent to the client specifying the --include-from option with a +equivalent file. + dit(bf(auth users)) The "auth users" option specifies a comma and space separated list of usernames that will be allowed to connect to this module. The usernames do not need to exist on the local @@ -248,7 +262,7 @@ The default is no "hosts deny" option, which means all hosts can connect. dit(bf(transfer logging)) The "transfer logging" option enables per-file logging of downloads and uploads in a format somewhat similar to that -used by ftp daemons. If you want to customise the log formats look at +used by ftp daemons. If you want to customize the log formats look at the log format option. dit(bf(log format)) The "log format" option allows you to specify the @@ -276,16 +290,36 @@ itemize( The default log format is "%o %h [%a] %m (%u) %f %l" -A perl script called rsyncstats to summarise this format is included +A perl script called rsyncstats to summarize this format is included in the rsync source code distribution. dit(bf(timeout)) The "timeout" option allows you to override the -clients choice for IO timoeut for this module. Using this option you +clients choice for IO timeout for this module. Using this option you can ensure that rsync won't wait on a dead client forever. The timeout is specified in seconds. A value of zero means no timeout and is the default. A good choice for anonymous rsync servers may be 600 (giving a 10 minute timeout). +dit(bf(refuse options)) The "refuse options" option allows you to +specify a space separated list of rsync command line options that will +be refused by your rsync server. When an option is refused the server +prints an error message and exits. + +The full names of the options must be used (ie. you must use +"checksum" not "c" to disable checksumming). + +dit(bf(dont compress)) The "dont compress" option allows you to select +filenames based on wildcard patterns that should not be compressed +during transfer. Compression is expensive in terms of CPU usage so it +is usually good to not try to compress files that won't compress well, +such as already compressed files. + +The "dont compress" option takes a space separated list of +case-insensitive wildcard patterns. Any source filename matching one +of the patterns will not be compressed during transfer. + +The default setting is verb(*.gz *.tgz *.zip *.z *.rpm *.deb) + enddit() manpagesection(AUTHENTICATION STRENGTH) @@ -293,7 +327,7 @@ manpagesection(AUTHENTICATION STRENGTH) The authentication protocol used in rsync is a 128 bit MD4 based challenge response system. Although I believe that no one has ever demonstrated a brute-force break of this sort of system you should -realise that this is not a "military strength" authentication system. +realize that this is not a "military strength" authentication system. It should be good enough for most purposes but if you want really top quality security then I recommend that you run rsync over ssh. @@ -371,7 +405,7 @@ client. this means a client may be mystified as to why a transfer failed. The error will have been logged by syslog on the server. 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/)(http://rsync.samba.org/) manpagesection(VERSION) This man page is current for version 2.0 of rsync @@ -382,10 +416,10 @@ 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). +url(ftp://rsync.samba.org/pub/rsync)(ftp://rsync.samba.org/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/) We would be delighted to hear from you if you like this program. @@ -401,6 +435,6 @@ documentation! 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