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.

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