docs/src/import.md

Tue, 10 Jul 2018 18:42:52 +0200

author
Olaf Wintermann <olaf.wintermann@gmail.com>
date
Tue, 10 Jul 2018 18:42:52 +0200
branch
v1.2
changeset 451
3e77615273d3
parent 408
f71eab18ed38
permissions
-rw-r--r--

improves compatibility with owncloud/nextcloud when uploading files

408
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
1 ---
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
2 title: 'dav import'
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
3 ---
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
4
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
5 **`dav import [-pc] [-k <key>] [-L <lock>] <url> <file>`**
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
6
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
7 Uploads the content of an archive file to a collection. If the url points to a non-existing collection, the collection is created.
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
8
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
9 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.
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
10
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
11 **`-p`** disable file name encryption and decryption
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
12
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
13 **`-c`** enable file name and content encryption
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
14
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
15 **`-R`** upload directory
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
16
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
17 **`-k <key>`** use the specified key for encryption. The key must be configured in
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
18 the config.xml file
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
19
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
20 **`-L <lock>`** use a lock token. See [dav lock][2]
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
21
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
22 [1]: ./export.html
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
23 [2]: ./lock.html
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
24
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
25 ### Example: create tar archive with GNU tar and import it to a collection
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
26
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
27 $ tar cvf archive.tar --format=ustar mydir
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
28 mydir/
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
29 mydir/file.txt
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
30 mydir/otherfile
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
31 mydir/newfile
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
32 $ dav import myserv/col/ archive.tar
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
33 mkcol: mydir/
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
34 mydir: SRC/file.txt
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
35 mydir: SRC/otherfile
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
36 mydir: SRC/newfile
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
37

mercurial