docs/src/copy.md

Sat, 05 Aug 2017 11:33:17 +0200

author
Mike Becker <universe@uap-core.de>
date
Sat, 05 Aug 2017 11:33:17 +0200
changeset 281
ddb5e8f2a43d
parent 279
f0f24da5f920
child 282
3070d72f54af
permissions
-rw-r--r--

some more minor doc improvements

266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
1 dav copy
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
2 ========
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
3
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
4 **`copy [-pcO] [-L <lock>] <url1> <url2>`**
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
5
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
6 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
7
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
8 If *url1* is a collection, all children are copied.
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
9
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
10 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
11
279
f0f24da5f920 refines copy.md
Mike Becker <universe@uap-core.de>
parents: 266
diff changeset
12 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
13 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
14 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
15 See [encryption][2] for more details on how encryption works.
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
16
279
f0f24da5f920 refines copy.md
Mike Becker <universe@uap-core.de>
parents: 266
diff changeset
17 **`-p`** disable file name and path decryption for *url1*
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
18
279
f0f24da5f920 refines copy.md
Mike Becker <universe@uap-core.de>
parents: 266
diff changeset
19 **`-c`** enable file name and path decryption for *url1*
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
20
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
21 **`-O`** override the destination resource
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
22
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
23 **`-L <lock>`** use a lock token. See [dav lock][1]
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
24
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
25 [1]: ./lock.html
279
f0f24da5f920 refines copy.md
Mike Becker <universe@uap-core.de>
parents: 266
diff changeset
26 [2]: ./encryption.html
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
27
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
28 **Command alias:** cp

mercurial