docs/src/copy.md

Thu, 31 Aug 2017 13:10:55 +0200

author
Mike Becker <universe@uap-core.de>
date
Thu, 31 Aug 2017 13:10:55 +0200
changeset 290
1e3e374d9386
parent 285
02d3e4b1245f
child 407
9505224d2fd2
permissions
-rw-r--r--

adds clean handling in case the stack of dav_exec_expr() runs out of memory

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.
f0f24da5f920 refines copy.md
Mike Becker <universe@uap-core.de>
parents: 266
diff changeset
14 You may use file name and path decryption to copy and encrypted resource.
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