Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
L
liblongpath-rsync
Project
Project
Details
Activity
Releases
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
liblongpath
liblongpath-rsync
Commits
c2582307
Commit
c2582307
authored
Feb 11, 2005
by
Wayne Davison
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
- Several improvements in describing how options imply other options.
- Improved --partial-dir.
parent
345e0988
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
32 additions
and
21 deletions
+32
-21
rsync.yo
rsync.yo
+32
-21
No files found.
rsync.yo
View file @
c2582307
...
@@ -1011,23 +1011,24 @@ it is more desirable to keep partially transferred files. Using the
...
@@ -1011,23 +1011,24 @@ it is more desirable to keep partially transferred files. Using the
bf(--partial) option tells rsync to keep the partial file which should
bf(--partial) option tells rsync to keep the partial file which should
make a subsequent transfer of the rest of the file much faster.
make a subsequent transfer of the rest of the file much faster.
dit(bf(--partial-dir=DIR)) Turns on bf(--partial) mode, but tells rsync to
dit(bf(--partial-dir=DIR)) A better way to keep partial files than the
put a partially transferred file into em(DIR) instead of writing out the
bf(--partial) option is to specify a em(DIR) that will be used to hold the
file to the destination dir. Rsync will also use a file found in this
partial data (instead of writing it out to the destination file).
dir as data to speed up the transfer (i.e. when you redo the send after
On the next transfer, rsync will use a file found in this
rsync creates a partial file) and delete such a file after it has served
dir as data to speed up the resumption of the transfer and then deletes it
its purpose. Note that if bf(--whole-file) is specified (or implied) that an
after it has served its purpose.
existing partial-dir file will not be used to speedup the transfer (since
Note that if bf(--whole-file) is specified (or implied), any partial-dir
file that is found for a file that is being updated will simply be removed
(since
rsync is sending files without using the incremental rsync algorithm).
rsync is sending files without using the incremental rsync algorithm).
Rsync will create the dir if it is missing (just the last dir -- not the
Rsync will create the em(DIR) if it is missing (just the last dir -- not
whole path). This makes it easy to use a relative path (such as
the whole path). This makes it easy to use a relative path (such as
"bf(--partial-dir=.rsync-partial)") to have rsync create the partial-directory
"bf(--partial-dir=.rsync-partial)") to have rsync create the
in the destination file's directory (rsync will also try to remove the em(DIR)
partial-directory in the destination file's directory when needed, and then
if a partial file was found to exist at the start of the transfer and the
remove it again when the partial file is deleted.
DIR was specified as a relative path).
If the partial-dir value is not an absolute path, rsync will also add a
n
If the partial-dir value is not an absolute path, rsync will also add a
directory
bf(--exclude) of this value at the end of all your existing excludes. This
bf(--exclude) of this value at the end of all your existing excludes. This
will prevent partial-dir files from being transferred and also prevent the
will prevent partial-dir files from being transferred and also prevent the
untimely deletion of partial-dir items on the receiving side. An example:
untimely deletion of partial-dir items on the receiving side. An example:
...
@@ -1036,7 +1037,8 @@ rule at the end of any other filter rules. Note that if you are
...
@@ -1036,7 +1037,8 @@ rule at the end of any other filter rules. Note that if you are
supplying your own filter rules, you may need to manually insert a
supplying your own filter rules, you may need to manually insert a
rule for this directory exclusion somewhere higher up in the list so that
rule for this directory exclusion somewhere higher up in the list so that
it has a high enough priority to be effective (e.g., if your rules specify
it has a high enough priority to be effective (e.g., if your rules specify
a trailing bf(--exclude='*') rule, the auto-added rule will be ineffective).
a trailing bf(--exclude='*') rule, the auto-added rule would never be
reached).
IMPORTANT: the bf(--partial-dir) should not be writable by other users or it
IMPORTANT: the bf(--partial-dir) should not be writable by other users or it
is a security risk. E.g. AVOID "/tmp".
is a security risk. E.g. AVOID "/tmp".
...
@@ -1052,13 +1054,22 @@ option does not look for this environment value is (1) when bf(--inplace) was
...
@@ -1052,13 +1054,22 @@ option does not look for this environment value is (1) when bf(--inplace) was
specified (since bf(--inplace) conflicts with bf(--partial-dir)), or (2) when
specified (since bf(--inplace) conflicts with bf(--partial-dir)), or (2) when
bf(--delay-updates) was specified (see below).
bf(--delay-updates) was specified (see below).
For the purposes of the server-config's "refuse options" setting,
bf(--partial-dir) does em(not) imply bf(--partial). This is so that a
refusal of the bf(--partial) option can be used to disallow the overwriting
of destination files with a partial transfer, while still allowing the
safer idiom provided by bf(--partial-dir).
dit(bf(--delay-updates)) This option puts the temporary file from each
dit(bf(--delay-updates)) This option puts the temporary file from each
updated file into
the file's partial-dir (see above)
until the end of the
updated file into
a holding directory
until the end of the
transfer, at which time all the files are renamed into place in rapid
transfer, at which time all the files are renamed into place in rapid
succession. This attempts to make the updating of the files a little more
succession. This attempts to make the updating of the files a little more
atomic. If you don't specify the bf(--partial-dir) option, this option will
atomic. By default the files are placed into a directory named ".~tmp~" in
cause it to default to ".~tmp~" (RSYNC_PARTIAL_DIR is not consulted for
each file's destination directory, but you can override this by specifying
this value). Conflicts with bf(--inplace).
the bf(--partial-dir) option. (Note that RSYNC_PARTIAL_DIR has no effect
on this value, nor is bf(--partial-dir) considered to be implied for the
purposes of the server-config's "refuse options" setting.)
Conflicts with bf(--inplace).
This option uses more memory on the receiving side (one bit per file
This option uses more memory on the receiving side (one bit per file
transferred) and also requires enough free disk space on the receiving
transferred) and also requires enough free disk space on the receiving
...
@@ -1075,7 +1086,7 @@ parallel hierarchy of files).
...
@@ -1075,7 +1086,7 @@ parallel hierarchy of files).
dit(bf(--progress)) This option tells rsync to print information
dit(bf(--progress)) This option tells rsync to print information
showing the progress of the transfer. This gives a bored user
showing the progress of the transfer. This gives a bored user
something to watch.
something to watch.
Implies bf(--verbose)
without incrementing verbosity
.
Implies bf(--verbose)
if it wasn't already specified
.
When the file is transferring, the data looks like this:
When the file is transferring, the data looks like this:
...
@@ -1424,7 +1435,7 @@ itemize(
...
@@ -1424,7 +1435,7 @@ itemize(
it() A bf(C) is used to indicate that all the global CVS-exclude rules
it() A bf(C) is used to indicate that all the global CVS-exclude rules
should be inserted as excludes in place of the "-C". No arg should
should be inserted as excludes in place of the "-C". No arg should
follow.
follow.
)
)
Per-directory rules are inherited in all subdirectories of the directory
Per-directory rules are inherited in all subdirectories of the directory
where the merge-file was found unless the 'n' modifier was used. Each
where the merge-file was found unless the 'n' modifier was used. Each
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment