summaryrefslogtreecommitdiffstats
path: root/rsync.1
diff options
context:
space:
mode:
Diffstat (limited to 'rsync.1')
-rw-r--r--rsync.138
1 files changed, 27 insertions, 11 deletions
diff --git a/rsync.1 b/rsync.1
index 66a2da3..ac801d0 100644
--- a/rsync.1
+++ b/rsync.1
@@ -1,4 +1,4 @@
-.TH "rsync" "1" "20 Oct 2022" "rsync 3.2.7" "User Commands"
+.TH "rsync" "1" "6 Apr 2024" "rsync 3.3.0" "User Commands"
.\" prefix=/usr
.P
.SH "NAME"
@@ -30,7 +30,9 @@ Usages with just one SRC arg and no DEST arg will list the source files instead
of copying.
.P
The online version of this manpage (that includes cross-linking of topics)
-is available at https://download.samba.org/pub/rsync/rsync.1.
+is available at
+.UR https://download.samba.org/pub/rsync/rsync.1
+.UE .
.P
.SH "DESCRIPTION"
.P
@@ -306,7 +308,7 @@ to be copied to different destination directories using more than one copy.
.P
While a copy of a case-ignoring filesystem to a case-ignoring filesystem can
work out fairly well, if no \fB\-\-delete-during\fP or \fB\-\-delete-before\fP option is
-active, rsync can potentially update an existing file on the receiveing side
+active, rsync can potentially update an existing file on the receiving side
without noticing that the upper-/lower-case of the filename should be changed
to match the sender.
.P
@@ -1728,7 +1730,9 @@ mounted to avoid updating the atime on read access even without the
O_NOATIME flag being set.
.IP "\fB\-\-crtimes\fP, \fB\-N,\fP"
This tells rsync to set the create times (newness) of the destination
-files to the same value as the source files.
+files to the same value as the source files. Your OS & filesystem must
+support the setting of arbitrary creation (birth) times for this option
+to be supported.
.IP "\fB\-\-omit-dir-times\fP, \fB\-O\fP"
This tells rsync to omit directories when it is preserving modification,
access, and create times. If NFS is sharing the directories on the receiving
@@ -2153,7 +2157,8 @@ memory. It is a sanity-check value for each individual allocation.
See the \fB\-\-max-size\fP option for a description of how SIZE can be
specified. The default suffix if none is given is bytes.
.IP
-Beginning in 3.2.3, a value of 0 specifies no limit.
+Beginning in 3.2.7, a value of 0 is an easy way to specify SIZE_MAX (the
+largest limit possible).
.IP
You can set a default value using the environment variable
\fBRSYNC_MAX_ALLOC\fP using the same SIZE values as supported by this
@@ -5000,11 +5005,13 @@ File permissions, devices, etc. are transferred as native numerical values.
.IP o
See also the comments on the \fB\-\-delete\fP option.
.P
-Please report bugs! See the web site at https://rsync.samba.org/.
+Please report bugs! See the web site at
+.UR https://rsync.samba.org/
+.UE .
.P
.SH "VERSION"
.P
-This manpage is current for version 3.2.7 of rsync.
+This manpage is current for version 3.3.0 of rsync.
.P
.SH "INTERNAL OPTIONS"
.P
@@ -5020,14 +5027,22 @@ that can be used with a restricted ssh login.
Rsync is distributed under the GNU General Public License. See the file
COPYING for details.
.P
-An rsync web site is available at https://rsync.samba.org/. The site
+An rsync web site is available at
+.UR https://rsync.samba.org/
+.UE .
+The site
includes an FAQ-O-Matic which may cover questions unanswered by this manual
page.
.P
-The rsync github project is https://github.com/WayneD/rsync.
+The rsync github project is
+.UR https://github.com/WayneD/rsync
+.UE .
.P
We would be delighted to hear from you if you like this program. Please
-contact the mailing-list at rsync@lists.samba.org.
+contact the mailing-list at
+.UR mailto:rsync@lists.samba.org
+rsync@lists.samba.org
+.UE .
.P
This program uses the excellent zlib compression library written by Jean-loup
Gailly and Mark Adler.
@@ -5048,4 +5063,5 @@ people have later contributed to it. It is currently maintained by Wayne
Davison.
.P
Mailing lists for support and development are available at
-https://lists.samba.org/.
+.UR https://lists.samba.org/
+.UE .