docs/src/copy.md

Sun, 06 Aug 2017 14:41:20 +0200

author
Olaf Wintermann <olaf.wintermann@gmail.com>
date
Sun, 06 Aug 2017 14:41:20 +0200
changeset 283
0e36bb75a732
parent 282
3070d72f54af
child 285
02d3e4b1245f
permissions
-rw-r--r--

adds dav-sync introduction and sync.xml documentation

---
title: 'dav copy'
---

**`copy [-pcO] [-L <lock>] <url1> <url2>`**

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. 

If *url1* is a collection, all children are copied.

If *url2* already exists, the command aborts, unless the `-O` option is specified.

The command uses a single WebDAV COPY request to duplicate the resources.
You may use file name and path decryption to copy and encrypted resource.
Please note that the copy will always be located at *url2*, so the top most collection name will not be disguised.
See [encryption][2] for more details on how encryption works.

**`-p`** disable file name and path decryption for *url1*

**`-c`** enable file name and path decryption for *url1*

**`-O`** overwrite the destination resource

**`-L <lock>`** use a lock token. See [dav lock][1]

[1]: ./lock.html
[2]: ./encryption.html

**Command alias:** cp

mercurial