docs/man/dav.1.man

changeset 440
a62d312d8e53
parent 438
329d57cddae8
child 704
8b88efcbf56f
equal deleted inserted replaced
439:e85c93b59d1c 440:a62d312d8e53
10 \f[B]dav\f[] \f[I]command\f[] [\f[I]options\f[]] \f[I]arguments\f[]... 10 \f[B]dav\f[] \f[I]command\f[] [\f[I]options\f[]] \f[I]arguments\f[]...
11 .SH DESCRIPTION 11 .SH DESCRIPTION
12 .PP 12 .PP
13 TODO 13 TODO
14 .SH COMMANDS 14 .SH COMMANDS
15 .PP 15 .TP
16 list [\f[B]\-altdepcR\f[]] [\f[B]\-u\f[] \f[I]date\f[]] \f[I]url\f[] 16 .B list [\f[B]\-altdepcR\f[]] [\f[B]\-u\f[] \f[I]date\f[]] \f[I]url\f[]
17 .PP 17 Lists the files at \f[I]url\f[].
18 get [\f[B]\-pcRK\f[]] [\f[B]\-o\f[] \f[I]file\f[]] [\f[B]\-u\f[] 18 .RS
19 \f[I]date\f[]] \f[I]url\f[] 19 .RE
20 .PP 20 .TP
21 put [\f[B]\-pcR\f[]] [\f[B]\-k\f[] \f[I]key\f[]] [\f[B]\-L\f[] 21 .B get [\f[B]\-pcRK\f[]] [\f[B]\-o\f[] \f[I]file\f[]] [\f[B]\-u\f[] \f[I]date\f[]] \f[I]url\f[]
22 \f[I]lock\f[]] \f[I]url\f[] \f[I]file\f[] 22 Downloads a resource from \f[I]url\f[].
23 .PP 23 .RS
24 mkdir [\f[B]\-pc\f[]] [\f[B]\-k\f[] \f[I]key\f[]] [\f[B]\-L\f[] 24 .RE
25 \f[I]lock\f[]] \f[I]url\f[] 25 .TP
26 .PP 26 .B put [\f[B]\-pcR\f[]] [\f[B]\-k\f[] \f[I]key\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]url\f[] \f[I]file\f[]
27 remove [\f[B]\-pc\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]url\f[] 27 Uploads a resource to \f[I]url\f[].
28 .PP 28 .RS
29 copy [\f[B]\-pcO\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]srcurl\f[] 29 .RE
30 \f[I]desturl\f[] 30 .TP
31 .PP 31 .B mkdir [\f[B]\-pc\f[]] [\f[B]\-k\f[] \f[I]key\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]url\f[]
32 move [\f[B]\-pcO\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]srcurl\f[] 32 Creates a new collection at \f[I]url\f[].
33 \f[I]desturl\f[] 33 .RS
34 .PP 34 .RE
35 export [\f[B]\-pc\f[]] [\f[B]\-o\f[] \f[I]file\f[]] [\f[B]\-u\f[] 35 .TP
36 \f[I]date\f[]] \f[I]url\f[] 36 .B remove [\f[B]\-pc\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]url\f[]
37 .PP 37 Deletes a resource or collection at \f[I]url\f[]
38 import [\f[B]\-pc\f[]] [\f[B]\-k\f[] \f[I]key\f[]] [\f[B]\-L\f[] 38 .RS
39 \f[I]lock\f[]] \f[I]url\f[] \f[I]file\f[] 39 .RE
40 .PP 40 .TP
41 get\-property [\f[B]\-pcx\f[]] [\f[B]\-n\f[] \f[I]uri\f[]] \f[I]url\f[] 41 .B copy [\f[B]\-pcO\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]srcurl\f[] \f[I]desturl\f[]
42 \f[I]property\f[] 42 Copies a resource or collection from \f[I]srcurl\f[] to
43 .PP 43 \f[I]desturl\f[].
44 set\-property [\f[B]\-pcx\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] 44 .RS
45 [\f[B]\-n\f[] \f[I]uri\f[]] \f[I]url\f[] \f[I]property\f[] 45 .RE
46 [\f[I]value\f[]] 46 .TP
47 .PP 47 .B move [\f[B]\-pcO\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]srcurl\f[] \f[I]desturl\f[]
48 remove\-property [\f[B]\-pc\f[]] [\f[B]\-n\f[] \f[I]uri\f[]] 48 Moves a resource or collection from \f[I]srcurl\f[] to \f[I]desturl\f[].
49 \f[I]url\f[] \f[I]property\f[] 49 .RS
50 .PP 50 .RE
51 lock [\f[B]\-pc\f[]] [\f[B]\-T\f[] \f[I]timeout\f[]] \f[I]url\f[] 51 .TP
52 .PP 52 .B export [\f[B]\-pc\f[]] [\f[B]\-o\f[] \f[I]file\f[]] [\f[B]\-u\f[] \f[I]date\f[]] \f[I]url\f[]
53 unlock [\f[B]\-pc\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]url\f[] 53 Exports a resource or collection to a \f[B]tar(5)\f[] archive.
54 .PP 54 By default the data is written to \f[I]stdout\f[], but you may specify a
55 info [\f[B]\-pc\f[]] \f[I]url\f[] 55 \f[I]file\f[] with the \f[B]\-o\f[] option.
56 .PP 56 .RS
57 date [\f[I]url\f[]] 57 .RE
58 .TP
59 .B import [\f[B]\-pc\f[]] [\f[B]\-k\f[] \f[I]key\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]url\f[] \f[I]file\f[]
60 Uploads and extracts the contents of the \f[B]tar(5)\f[] archive
61 \f[I]file\f[] to \f[I]url\f[].
62 .RS
63 .RE
64 .TP
65 .B get\-property [\f[B]\-pcx\f[]] [\f[B]\-n\f[] \f[I]uri\f[]] \f[I]url\f[] \f[I]property\f[]
66 Gets a specific resource property.
67 Every WebDAV property has a name and an XML namespace.
68 A namespace can be specified with the \f[B]\-n\f[] option or with a
69 prefixed name.
70 The prefix and property name are separated by a colon \f[I]:\f[] as
71 usual.
72 .RS
73 .PP
74 If the \f[B]\-x\f[] option is specified, a valid XML document containing
75 the value is printed on \f[I]stdout\f[].
76 .PP
77 If the property contains XML data and the \f[B]\-x\f[] option is not
78 specified, the value is printed on \f[I]stderr\f[] in an XML\-like
79 format.
80 .RE
81 .TP
82 .B set\-property [\f[B]\-pcx\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] [\f[B]\-n\f[] \f[I]uri\f[]] \f[I]url\f[] \f[I]property\f[] [\f[I]value\f[]]
83 Sets a resource property to the specified value.
84 See \f[B]get\-property\f[] for details.
85 If no \f[I]value\f[] is specified, it is read from \f[I]stdin\f[].
86 .RS
87 .RE
88 .TP
89 .B remove\-property [\f[B]\-pc\f[]] [\f[B]\-n\f[] \f[I]uri\f[]] \f[I]url\f[] \f[I]property\f[]
90 Removes a resource property.
91 .RS
92 .RE
93 .TP
94 .B lock [\f[B]\-pc\f[]] [\f[B]\-T\f[] \f[I]timeout\f[]] \f[I]url\f[]
95 Creates a lock on the resource at \f[I]url\f[].
96 The lock is an exclusive write lock with infinite depth.
97 If the resource is sucessfully locked, a lock token for this resource is
98 printed to \f[I]stdout\f[].
99 This lock token should be saved to unlock the resource eventually.
100 .RS
101 .RE
102 .TP
103 .B unlock [\f[B]\-pc\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]url\f[]
104 Unlocks the resource at \f[I]url\f[] with a lock token.
105 If \f[I]lock\f[] is not specified, the token is read from
106 \f[I]stdin\f[].
107 .RS
108 .RE
109 .TP
110 .B info [\f[B]\-pc\f[]] \f[I]url\f[]
111 Prints some information and lists al properties for the resource at
112 \f[I]url\f[].
113 .RS
114 .RE
115 .TP
116 .B date [\f[I]url\f[]]
117 Gets the time from the server providing the resource denoted by
118 \f[I]url\f[].
119 If \f[I]url\f[] is not specified, this command prints the local time.
120 This command is useful, if the server clock and the local clock are not
121 in sync.
122 .RS
123 .RE
124 .SH CONFIGURATION COMMANDS
125 .TP
126 .B add\-repository
127 This command runs an interactive assistant that creates a repository
128 configuration.
129 .RS
130 .RE
131 .TP
132 .B remove\-repository \f[I]name\f[]
133 Removes the repository with the specified \f[I]name\f[] from the
134 configuration.
135 .RS
136 .RE
137 .TP
138 .B list\-repositories
139 Lists all currently configured repositories.
140 .RS
141 .RE
142 .TP
143 .B check\-config
144 Validates the \f[B]$HOME/.dav/config.xml\f[] configuration file.
145 .RS
146 .RE
58 .SH GENERAL OPTIONS 147 .SH GENERAL OPTIONS
59 .PP 148 .PP
60 The following options can be used with all commands. 149 The following options can be used with all commands.
61 .TP 150 .TP
62 .B \f[B]\-i\f[] 151 .B \-i
63 Disable cert verification. 152 Disable cert verification.
64 .RS 153 .RS
65 .RE 154 .RE
66 .TP 155 .TP
67 .B \f[B]\-N\f[] 156 .B \-N
68 Disable authentication prompt. 157 Disable authentication prompt.
69 .RS 158 .RS
70 .RE 159 .RE
71 .TP 160 .TP
72 .B \f[B]\-v\f[] 161 .B \-v
73 Verbose output. 162 Verbose output.
74 .RS 163 .RS
75 .RE 164 .RE
76 .SH COMMAND OPTIONS 165 .SH COMMAND OPTIONS
77 .TP 166 .TP
78 .B \f[B]\-a\f[] 167 .B \-a
79 Show all files. 168 Show all files.
80 .RS 169 .RS
81 .RE 170 .RE
82 .TP 171 .TP
83 .B \f[B]\-c\f[] 172 .B \-c
84 Enable full encryption. 173 Enable full encryption.
85 .RS 174 .RS
86 .RE 175 .RE
87 .TP 176 .TP
88 .B \f[B]\-d\f[] 177 .B \-d
89 Order by last modified date. 178 Order by last modified date.
90 .RS 179 .RS
91 .RE 180 .RE
92 .TP 181 .TP
93 .B \f[B]\-e\f[] 182 .B \-e
94 Show extended flags. 183 Show extended flags.
95 .RS 184 .RS
96 .RE 185 .RE
97 .TP 186 .TP
98 .B \f[B]\-K\f[] 187 .B \-K
99 Keep already present files. 188 Keep already present files.
100 .RS 189 .RS
101 .RE 190 .RE
102 .TP 191 .TP
103 .B \f[B]\-k\f[] \f[I]key\f[] 192 .B \-k \f[I]key\f[]
104 Key to use for encryption. 193 Key to use for encryption.
105 .RS 194 .RS
106 .RE 195 .RE
107 .TP 196 .TP
108 .B \f[B]\-l\f[] 197 .B \-l
109 Print resources in long list format. 198 Print resources in long list format.
110 .RS 199 .RS
111 .RE 200 .RE
112 .TP 201 .TP
113 .B \f[B]\-L\f[] \f[I]lock\f[] 202 .B \-L \f[I]lock\f[]
114 Specificy lock token. 203 Specificy lock token.
115 .RS 204 .RS
116 .RE 205 .RE
117 .TP 206 .TP
118 .B \f[B]\-n\f[] \f[I]uri\f[] 207 .B \-n \f[I]uri\f[]
119 Specify namespace \f[I]uri\f[]. 208 Specify namespace \f[I]uri\f[].
120 .RS 209 There are two namespaces configured by default.
121 .RE 210 .RS
122 .TP 211 .IP "1." 3
123 .B \f[B]\-o\f[] \f[I]file\f[] 212 \f[I]D\f[] for the \f[I]DAV:\f[] namespace
213 .IP "2." 3
214 \f[I]idav\f[] for the \f[I]http://davutils.org/\f[] namespace
215 .RE
216 .TP
217 .B \-o \f[I]file\f[]
124 Write output to \f[I]file\f[]. 218 Write output to \f[I]file\f[].
125 Use \[aq]\-\[aq] for stdout. 219 Use \[aq]\-\[aq] for stdout.
126 .RS 220 .RS
127 .RE 221 .RE
128 .TP 222 .TP
129 .B \f[B]\-O\f[] 223 .B \-O
130 Override resources. 224 Override resources.
131 .RS 225 .RS
132 .RE 226 .RE
133 .TP 227 .TP
134 .B \f[B]\-p\f[] 228 .B \-p
135 Don\[aq]t encrypt or decrypt files. 229 Don\[aq]t encrypt or decrypt files.
136 .RS 230 .RS
137 .RE 231 .RE
138 .TP 232 .TP
139 .B \f[B]\-R\f[] 233 .B \-R
140 Recursively do the operation for all children. 234 Recursively do the operation for all children.
141 .RS 235 .RS
142 .RE 236 .RE
143 .TP 237 .TP
144 .B \f[B]\-t\f[] 238 .B \-t
145 Print content type. 239 Print content type.
146 .RS 240 .RS
147 .RE 241 .RE
148 .TP 242 .TP
149 .B \f[B]\-T\f[] \f[I]sec\f[] 243 .B \-T \f[I]sec\f[]
150 Timeout in seconds. 244 Timeout in seconds.
151 .RS 245 .RS
152 .RE 246 .RE
153 .TP 247 .TP
154 .B \f[B]\-u\f[] \f[I]date\f[] 248 .B \-u \f[I]date\f[]
155 Get resources which are modified since the specified \f[I]date\f[]. 249 Get resources which are modified since the specified \f[I]date\f[].
156 .RS 250 .RS
157 .RE 251 .RE
158 .TP 252 .TP
159 .B \f[B]\-x\f[] 253 .B \-x
160 XML property content. 254 XML property content.
161 .RS 255 .RS
162 .RE 256 .RE
163 .SH SEE ALSO 257 .SH SEE ALSO
164 .PP 258 .PP

mercurial