docs/src/list.md

changeset 265
ee9e63c437c4
child 266
8c44c5919691
equal deleted inserted replaced
264:94c0a938b66c 265:ee9e63c437c4
1 dav list
2 ========
3
4 **`dav list [-altepcR] [-u <date>] <url>`**
5
6 Lists child resources of the specified collection. Without any options it
7 shows only the direct children and hides files beginning with a dot.
8
9 Options
10 -------
11
12 **`-a`** don't hide files whose names begins with a dot `.`
13
14 **`-l`** shows additional information for resources
15
16 Example:
17
18 -- 4.2 KiB Oct 11 2015 somefile
19
20 The first column contains to fields for flags.
21
22 1. Field: `d-` indicates a collection
23 2. Field: `-c` indicates an encrypted resource
24
25 Also encrypted collections are possible, but only the collection name is encrypted, the content may be unencrypted.
26
27 The second column in the `list -l` output is the resource size. The number has always a suffix (bytes, KiB, MiB, GiB, TiB). To get the exact content-length in bytes you can use the [dav info][1] command.
28
29 [1]: ./info.html
30
31 The third column is the date of the last modification. The `strftime` format is `%b %d %H:%M` if the year is the same. Otherwise the format is `%b %d %Y`.
32
33 The last column is the resource name. If the `-R` option is specified, the resource path is shown.
34
35 **`-t`** this options only work in combination with `-l` and it adds the resource content type to the output (after the flags)
36
37 **`-e`** similar to `-l`, but with 6 flag fields. Currently only the first 4 fields are used. The last two are reserved for future use.
38
39 3. Field: **l** indicates a locked resource
40 4. Field: **x** indicates a executable resource (executable property with http://apache.org/dav/props/ namespace)
41
42 **`-p`** disables file name and path decryption if enabled
43
44 **`-c`** enables file name and path decryption
45
46 **`-R`** recursively shows all resources in the collection and all child collections
47
48 **`-u <date>`** shows only resources with a lastmodified date after the specified
49 date. Uses the http date format

mercurial