LineageOS/android_external_rsync
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Improve --mkpath a bit more.

Browse Source
This commit is contained in:
Wayne Davison
2022-10-16 12:23:39 -07:00
parent ad6245f394
commit 42f8386823
1 changed files with 14 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
rsync.1.md
View File

@@ -436,7 +436,7 @@ has its own detailed description later in this manpage.
--append-verify --append w/old data in file checksum --append-verify --append w/old data in file checksum
--dirs, -d transfer directories without recursing --dirs, -d transfer directories without recursing
--old-dirs, --old-d works like --dirs when talking to old rsync --old-dirs, --old-d works like --dirs when talking to old rsync
--mkpath create the destination's path component --mkpath create destination's missing path components
--links, -l copy symlinks as symlinks --links, -l copy symlinks as symlinks
--copy-links, -L transform symlink into referent file/dir --copy-links, -L transform symlink into referent file/dir
--copy-unsafe-links only "unsafe" symlinks are transformed --copy-unsafe-links only "unsafe" symlinks are transformed
@@ -1149,23 +1149,25 @@ expand it.
0. `--mkpath` 0. `--mkpath`
Create a missing path component of the destination path. By default, rsync Create all missing path components of the destination path.
allows only the final element of the destination path to not exist, which
is an attempt to help you to validate your destination path. With this By default, rsync allows only the final component of the destination path
option, rsync creates all the missing destination-path components just as to not exist, which is an attempt to help you to validate your destination
if `mkdir -p $DEST_PATH` had been run. path. With this option, rsync creates all the missing destination-path
components, just as if `mkdir -p $DEST_PATH` had been run on the receiving
side.
When specifying a destination path, including a trailing slash ensures that When specifying a destination path, including a trailing slash ensures that
rsync always treats the whole path as the directory name to be created, the whole path is treated as directory names to be created, even when the
even if the source arg is a single filename. See the [COPYING TO A file list has a single item. See the [COPYING TO A DIFFERENT NAME](#)
DIFFERENT NAME](#) section for full details on how rsync decides if a final section for full details on how rsync decides if a final destination-path
destination path element is a directory element or not. component should be created as a directory or not.
If you would like the newly-created destination dirs to match the dirs on If you would like the newly-created destination dirs to match the dirs on
the sending side, you should be using [`--relative`](#opt) (`-R`) instead the sending side, you should be using [`--relative`](#opt) (`-R`) instead
of `--mkpath`. For instance, the following two commands result in the same of `--mkpath`. For instance, the following two commands result in the same
destination tree, but it is only the second command that ensures that the destination tree, but only the second command ensures that the
"some/extra/path" elements match the dirs on the sending side: "some/extra/path" components match the dirs on the sending side:
> rsync -ai --mkpath host:some/extra/path/*.c some/extra/path/ > rsync -ai --mkpath host:some/extra/path/*.c some/extra/path/
> rsync -aiR host:some/extra/path/*.c ./ > rsync -aiR host:some/extra/path/*.c ./