docs/src/export.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 export'
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 export [-pc] [-o <file>] [-u <date>] <url>`**
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 Downloads a resource or a collection with all child resources, and writes the contents to an archive file. The Output is written to stdout, unless the **`-o`** option is used.
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.
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 These archive files can be uploaded to an collection with the [dav import][1] command.
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 **`-p`** disable file name and content decryption. You get exactly what is stored
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
14 on the server.
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
15
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
16 **`-c`** enable file name and content decryption
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
17
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
18 **`-o <file>`** specify the local output file. A **-** indicates stdout
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 **`-u <date>`** download only files which are modified since the specified date. Uses the HTTP date format
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]: ./import.html
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
23
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
24 ### Example: create tar file from collection
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
25
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
26 $ dav export -o collection.tar myserv/col/
f71eab18ed38 more dav documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
27

mercurial