Thu, 20 Sep 2018 17:14:55 +0200
adds support for location credentials
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
1 | % DAV(1) Version 1.2 | DavUtils User Manuals |
436 | 2 | % Olaf Wintermann |
3 | % July 1, 2018 | |
4 | ||
5 | # NAME | |
6 | ||
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
7 | **dav** - command line WebDAV client |
436 | 8 | |
9 | # SYNOPSIS | |
10 | ||
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
11 | **dav** *command* [*options*] *arguments*... |
436 | 12 | |
13 | # DESCRIPTION | |
14 | ||
15 | TODO | |
16 | ||
17 | # COMMANDS | |
18 | ||
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
19 | list [**-altdepcR**] [**-u** *date*] *url* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
20 | : Lists the files at *url*. |
436 | 21 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
22 | get [**-pcRK**] [**-o** *file*] [**-u** *date*] *url* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
23 | : Downloads a resource from *url*. |
436 | 24 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
25 | put [**-pcR**] [**-k** *key*] [**-L** *lock*] *url* *file* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
26 | : Uploads a resource to *url*. |
436 | 27 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
28 | mkdir [**-pc**] [**-k** *key*] [**-L** *lock*] *url* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
29 | : Creates a new collection at *url*. |
436 | 30 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
31 | remove [**-pc**] [**-L** *lock*] *url* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
32 | : Deletes a resource or collection at *url* |
436 | 33 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
34 | copy [**-pcO**] [**-L** *lock*] *srcurl* *desturl* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
35 | : Copies a resource or collection from *srcurl* to *desturl*. |
436 | 36 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
37 | move [**-pcO**] [**-L** *lock*] *srcurl* *desturl* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
38 | : Moves a resource or collection from *srcurl* to *desturl*. |
436 | 39 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
40 | export [**-pc**] [**-o** *file*] [**-u** *date*] *url* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
41 | : Exports a resource or collection to a **tar(5)** archive. By default the |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
42 | data is written to *stdout*, but you may specify a *file* with the **-o** |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
43 | option. |
436 | 44 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
45 | import [**-pc**] [**-k** *key*] [**-L** *lock*] *url* *file* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
46 | : Uploads and extracts the contents of the **tar(5)** archive *file* to *url*. |
436 | 47 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
48 | get-property [**-pcx**] [**-n** *uri*] *url* *property* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
49 | : Gets a specific resource property. Every WebDAV property has a name and an |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
50 | XML namespace. A namespace can be specified with the **-n** option or with |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
51 | a prefixed name. The prefix and property name are separated by a colon |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
52 | *:* as usual. |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
53 | |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
54 | If the **-x** option is specified, a valid XML document containing the |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
55 | value is printed on *stdout*. |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
56 | |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
57 | If the property contains XML data and the **-x** option is not specified, |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
58 | the value is printed on *stderr* in an XML-like format. |
436 | 59 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
60 | set-property [**-pcx**] [**-L** *lock*] [**-n** *uri*] *url* *property* [*value*] |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
61 | : Sets a resource property to the specified value. See **get-property** for |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
62 | details. If no *value* is specified, it is read from *stdin*. |
436 | 63 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
64 | remove-property [**-pc**] [**-n** *uri*] *url* *property* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
65 | : Removes a resource property. |
436 | 66 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
67 | lock [**-pc**] [**-T** *timeout*] *url* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
68 | : Creates a lock on the resource at *url*. The lock is an exclusive write |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
69 | lock with infinite depth. If the resource is sucessfully locked, a lock |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
70 | token for this resource is printed to *stdout*. This lock token should be |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
71 | saved to unlock the resource eventually. |
436 | 72 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
73 | unlock [**-pc**] [**-L** *lock*] *url* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
74 | : Unlocks the resource at *url* with a lock token. If *lock* is not |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
75 | specified, the token is read from *stdin*. |
436 | 76 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
77 | info [**-pc**] *url* |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
78 | : Prints some information and lists al properties for the resource at *url*. |
436 | 79 | |
80 | date [*url*] | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
81 | : Gets the time from the server providing the resource denoted by *url*. |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
82 | If *url* is not specified, this command prints the local time. |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
83 | This command is useful, if the server clock and the local clock are not |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
84 | in sync. |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
85 | |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
86 | # CONFIGURATION COMMANDS |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
87 | |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
88 | add-repository |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
89 | : This command runs an interactive assistant that creates a repository |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
90 | configuration. |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
91 | |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
92 | remove-repository *name* |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
93 | : Removes the repository with the specified *name* from the configuration. |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
94 | |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
95 | list-repositories |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
96 | : Lists all currently configured repositories. |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
97 | |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
98 | check-config |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
99 | : Validates the **$HOME/.dav/config.xml** configuration file. |
436 | 100 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
101 | # GENERAL OPTIONS |
436 | 102 | |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
103 | The following options can be used with all commands. |
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
104 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
105 | -i |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
106 | : Disable cert verification. |
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
107 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
108 | -N |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
109 | : Disable authentication prompt. |
436 | 110 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
111 | -v |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
112 | : Verbose output. |
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
113 | |
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
114 | # COMMAND OPTIONS |
436 | 115 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
116 | -a |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
117 | : Show all files. |
436 | 118 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
119 | -c |
436 | 120 | : Enable full encryption. |
121 | ||
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
122 | -d |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
123 | : Order by last modified date. |
436 | 124 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
125 | -e |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
126 | : Show extended flags. |
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
127 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
128 | -K |
436 | 129 | : Keep already present files. |
130 | ||
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
131 | -k *key* |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
132 | : Key to use for encryption. |
436 | 133 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
134 | -l |
436 | 135 | : Print resources in long list format. |
136 | ||
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
137 | -L *lock* |
436 | 138 | : Specificy lock token. |
139 | ||
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
140 | -n *uri* |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
141 | : Specify namespace *uri*. There are two namespaces configured by default. |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
142 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
143 | 1. *D* for the *DAV:* namespace |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
144 | |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
145 | 2. *idav* for the *http://davutils.org/* namespace |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
146 | |
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
147 | -o *file* |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
148 | : Write output to *file*. Use '-' for stdout. |
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
149 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
150 | -O |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
151 | : Override resources. |
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
152 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
153 | -p |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
154 | : Don't encrypt or decrypt files. |
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
155 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
156 | -R |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
157 | : Recursively do the operation for all children. |
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
158 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
159 | -t |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
160 | : Print content type. |
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
161 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
162 | -T *sec* |
436 | 163 | : Timeout in seconds. |
164 | ||
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
165 | -u *date* |
438
329d57cddae8
improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents:
436
diff
changeset
|
166 | : Get resources which are modified since the specified *date*. |
436 | 167 | |
440
a62d312d8e53
adds brief command descriptions to the dav man page
Mike Becker <universe@uap-core.de>
parents:
438
diff
changeset
|
168 | -x |
436 | 169 | : XML property content. |
170 | ||
171 | ||
172 | # SEE ALSO | |
173 | ||
174 | `dav-sync` (1). | |
175 | ||
176 | DavUtils full documentation: <https://davutils.sourceforge.io/>. | |
177 |