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.

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

**`dav 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 an 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