docs/src/put.md

Tue, 23 Jul 2024 14:29:33 +0200

author
Olaf Wintermann <olaf.wintermann@gmail.com>
date
Tue, 23 Jul 2024 14:29:33 +0200
changeset 824
76ca3dac6506
parent 285
02d3e4b1245f
permissions
-rw-r--r--

fix request_auth not removing the trailing newline from the user name

---
title: 'dav put'
---

**`dav put [-pcR] [-k <key>] [-L <lock>] <url> <file>`**

Uploads a file or a directory. When uploading a file while the url points to
an existing collection, a resource inside this collection with the file's name is created. When the url points to a non-existing resource, the resource is
created.

When uploading a directory, you need to specify the **`-R`** option. It uploads
all files in the directory to the specified url, but it does not create a
collection for the directory itself.
You may use [dav mkdir][1] to create this collection beforehand.

**`-p`** disable file name encryption and decryption

**`-c`** enable file name and content encryption

**`-R`** upload directory

**`-k <key>`** use the specified key for encryption. The key must be configured in
  the config.xml file

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

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

mercurial