docs/src/copy.md

Sun, 17 Dec 2023 15:33:50 +0100

author
Mike Becker <universe@uap-core.de>
date
Sun, 17 Dec 2023 15:33:50 +0100
changeset 800
30d484806c2b
parent 407
9505224d2fd2
permissions
-rw-r--r--

fix faulty string to int conversion utilities

Probably it was expected that errno is set to EINVAL when illegal characters are encountered. But this is not standard and does not happen on every system, allowing illegal strings to be parsed as valid integers.

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