Mercurial > hg > dav / file diff

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/src/import.md	Sun Jun 03 14:40:07 2018 +0200
@@ -0,0 +1,37 @@
+---
+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
+