X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/d53d7795ee771a149a6ae010107bf3bf6d7588d0..38843171817eda292ad3f35de463ed2cb04689ef:/rsync.yo diff --git a/rsync.yo b/rsync.yo index e0d131b2..0b2ec981 100644 --- a/rsync.yo +++ b/rsync.yo @@ -1,5 +1,5 @@ mailto(rsync-bugs@samba.org) -manpage(rsync)(1)(25 Jan 2002)()() +manpage(rsync)(1)(26 Jan 2003)()() manpagename(rsync)(faster, flexible replacement for rcp) manpagesynopsis() @@ -212,9 +212,12 @@ used to check against the rsyncd.conf on the remote host. manpagesection(RUNNING AN RSYNC SERVER) -An rsync server is configured using a config file which by default is -called /etc/rsyncd.conf. Please see the rsyncd.conf(5) man page for more -information. +An rsync server is configured using a config file. Please see the +rsyncd.conf(5) man page for more information. By default the configuration +file is called /etc/rsyncd.conf, unless rsync is running over a remote +shell program and is not running as root; in that case, the default name +is rsyncd.conf in the current directory on the remote computer +(typically $HOME). manpagesection(RUNNING AN RSYNC SERVER OVER A REMOTE SHELL PROGRAM) @@ -234,10 +237,10 @@ quote(rsync --server --daemon .) NOTE: rsync's argument parsing expects the trailing ".", so make sure that it's there. If you want to use a rsyncd.conf(5)-style -configuration file other than /etc/rsyncd.conf, you can added a ---config-file option to the em(command): +configuration file other than the default, you can added a +--config option to the em(command): -quote(rsync --server --daemon --config-file=em(file) .) +quote(rsync --server --daemon --config=em(file) .) manpagesection(EXAMPLES) @@ -282,7 +285,7 @@ verb( -v, --verbose increase verbosity -q, --quiet decrease verbosity -c, --checksum always checksum - -a, --archive archive mode + -a, --archive archive mode, equivalent to -rlptgoD -r, --recursive recurse into directories -R, --relative use relative path names -b, --backup make backups (default ~ suffix) @@ -393,8 +396,8 @@ dit(bf(--modify-window)) When comparing two timestamps rsync treats the timestamps as being equal if they are within the value of modify_window. This is normally zero, but you may find it useful to set this to a larger value in some situations. In particular, when -transferring to/from FAT filesystems which cannot represent times with -a 1 second resolution this option is useful. +transferring to Windows FAT filesystems which cannot represent times +with a 1 second resolution --modify-window=1 is useful. dit(bf(-c, --checksum)) This forces the sender to checksum all files using a 128-bit MD4 checksum before transfer. The checksum is then @@ -640,7 +643,7 @@ a file should be ignored. The exclude list is initialized to: -quote(RCS SCCS CVS CVS.adm RCSLOG cvslog.* tags TAGS .make.state +quote(RCS/ SCCS/ CVS/ .svn/ CVS.adm RCSLOG cvslog.* tags TAGS .make.state .nse_depinfo *~ #* .#* ,* *.old *.bak *.BAK *.orig *.rej .del-* *.a *.o *.obj *.so *.Z *.elc *.ln core) @@ -727,7 +730,7 @@ bf(rsync://host/module/) syntax. If standard input is a socket then rsync will assume that it is being run via inetd, otherwise it will detach from the current terminal and become a background daemon. The daemon will read the config file -(/etc/rsyncd.conf) on each connect made by a client and respond to +(rsyncd.conf) on each connect made by a client and respond to requests accordingly. See the rsyncd.conf(5) man page for more details. @@ -747,8 +750,10 @@ address (or hostname) to bind to. This makes virtual hosting possible in conjunction with the --config option. dit(bf(--config=FILE)) This specifies an alternate config file than -the default /etc/rsyncd.conf. This is only relevant when --daemon is -specified. +the default. This is only relevant when --daemon is specified. +The default is /etc/rsyncd.conf unless the daemon is running over +a remote shell program and the remote user is not root; in that case +the default is rsyncd.conf in the current directory (typically $HOME). dit(bf(--port=PORT)) This specifies an alternate TCP port number to use rather than the default port 873. @@ -1093,7 +1098,7 @@ enddit() manpagefiles() -/etc/rsyncd.conf +/etc/rsyncd.conf or rsyncd.conf manpageseealso() @@ -1105,16 +1110,17 @@ manpagebugs() times are transferred as unix time_t values +When transferring to FAT filesystmes rsync may resync +unmodified files. +See the comments on the --modify-window option. + file permissions, devices etc are transferred as native numerical values see also the comments on the --delete option -Please report bugs! The rsync bug tracking system is online at -url(http://rsync.samba.org/rsync/)(http://rsync.samba.org/rsync/) - -manpagesection(VERSION) -This man page is current for version 2.0 of rsync +Please report bugs! See the website at +url(http://rsync.samba.org/)(http://rsync.samba.org/) manpagesection(CREDITS)