docs/src/import.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 408
f71eab18ed38
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 import'
---

**`dav import [-pc] [-k <key>] [-L <lock>] <url> <file>`**

Uploads the content of an archive file to a collection. If the url points to a non-existing collection, the collection is created.

Currently the only available archive format is the ustar format. You can use tools like *tar* or the [dav export][1] command to create such archives.

**`-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]: ./export.html
[2]: ./lock.html

### Example: create tar archive with GNU tar and import it to a collection

	$ tar cvf archive.tar --format=ustar mydir
	mydir/
	mydir/file.txt
	mydir/otherfile
	mydir/newfile
	$ dav import myserv/col/ archive.tar
	mkcol: mydir/
	mydir: SRC/file.txt
	mydir: SRC/otherfile
	mydir: SRC/newfile

mercurial