docs/src/copy.md

Thu, 12 Dec 2024 16:46:43 +0100

author
Olaf Wintermann <olaf.wintermann@gmail.com>
date
Thu, 12 Dec 2024 16:46:43 +0100
changeset 851
55c5d36b82b7
parent 407
9505224d2fd2
permissions
-rw-r--r--

fix compatibility with older libcurl versions

283
0e36bb75a732 adds dav-sync introduction and sync.xml documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 282
diff changeset
1 ---
0e36bb75a732 adds dav-sync introduction and sync.xml documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 282
diff changeset
2 title: 'dav copy'
0e36bb75a732 adds dav-sync introduction and sync.xml documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 282
diff changeset
3 ---
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
4
285
02d3e4b1245f adds some small fixes for 1.0 release
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 283
diff changeset
5 **`dav copy [-pcO] [-L <lock>] <url1> <url2>`**
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
6
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
7 Creates a duplicate of the resource identified by *url1* at the location *url2*. All resource properties are copied. Currently *url1* and *url2* must be the same host.
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
8
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
9 If *url1* is a collection, all children are copied.
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
10
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
11 If *url2* already exists, the command aborts, unless the `-O` option is specified.
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
12
279
f0f24da5f920 refines copy.md
Mike Becker <universe@uap-core.de>
parents: 266
diff changeset
13 The command uses a single WebDAV COPY request to duplicate the resources.
407
9505224d2fd2 adds documentation for new dav features
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 285
diff changeset
14 You may use file name and path decryption to copy an encrypted resource.
279
f0f24da5f920 refines copy.md
Mike Becker <universe@uap-core.de>
parents: 266
diff changeset
15 Please note that the copy will always be located at *url2*, so the top most collection name will not be disguised.
f0f24da5f920 refines copy.md
Mike Becker <universe@uap-core.de>
parents: 266
diff changeset
16 See [encryption][2] for more details on how encryption works.
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
17
279
f0f24da5f920 refines copy.md
Mike Becker <universe@uap-core.de>
parents: 266
diff changeset
18 **`-p`** disable file name and path decryption for *url1*
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
19
279
f0f24da5f920 refines copy.md
Mike Becker <universe@uap-core.de>
parents: 266
diff changeset
20 **`-c`** enable file name and path decryption for *url1*
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
21
282
3070d72f54af more minor improvements to the documentation
Mike Becker <universe@uap-core.de>
parents: 279
diff changeset
22 **`-O`** overwrite the destination resource
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
23
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
24 **`-L <lock>`** use a lock token. See [dav lock][1]
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
25
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
26 [1]: ./lock.html
279
f0f24da5f920 refines copy.md
Mike Becker <universe@uap-core.de>
parents: 266
diff changeset
27 [2]: ./encryption.html
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
28
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
29 **Command alias:** cp

mercurial