1 ---
2 title: 'dav list'
3 ---
4
5 **`dav list [-altdepcR] [-u <date>] <url>`**
6
7 Lists child resources of the specified collection. Without any option it
8 shows only the direct children and hides files beginning with a dot.
9 The behavior is quite similar to that of the unix tool `ls`.
10
11 Options
12 -------
13
14 **`-a`** don't hide files whose names begin with a dot `.`
15
16 **`-l`** show additional information for resources
17
18 Example:
19
20 -- 4.2 KiB Oct 11 2015 somefile
21
22 The first column contains to fields for flags.
23
24 1. Field: `d-` indicates a collection
25 2. Field: `-c` indicates an encrypted resource
26
27 Encrypted collections are also possible, but only the collection name is encrypted, the content may be unencrypted.
28
29 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.
30
31 [1]: ./info.html
32
33 The third column is the date of the last modification. The `strftime` format is `%b %d %H:%M` if the year is the current year. Otherwise the format is `%b %d %Y`.
34
35 The last column is the resource name. If the `-R` option is specified, the resource path is shown.
36
37 **`-t`** this options only works in combination with `-l` and it adds the resource content type to the output (after the flags)
38
39 **`-d`** order resources by their lastmodified date
40
41 **`-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.
42
43 1. Field: `d---` indicates a collection
44 2. Field: `-c--` indicates an encrypted resource
45 3. Field: `--l-` indicates a locked resource
46 4. Field: `---x` indicates an executable resource (executable property with http://apache.org/dav/props/ namespace)
47
48 All combinations of these four flags are possible.
49
50 **`-p`** disable file name and path decryption if enabled
51
52 **`-c`** enable file name and path decryption
53
54 **`-R`** recursively show all resources in the collection and all child collections
55
56 **`-u <date>`** show only resources with a `lastmodified` date after the specified
57 date. Uses the HTTP date format.
58
59 **Command alias:** ls
60