diff -r 94c0a938b66c -r ee9e63c437c4 docs/src/list.md --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/src/list.md Sun Jul 09 20:15:14 2017 +0200 @@ -0,0 +1,49 @@ +dav list +======== + +**`dav list [-altepcR] [-u ] `** + +Lists child resources of the specified collection. Without any options it +shows only the direct children and hides files beginning with a dot. + +Options +------- + +**`-a`** don't hide files whose names begins with a dot `.` + +**`-l`** shows additional information for resources + +Example: + + -- 4.2 KiB Oct 11 2015 somefile + +The first column contains to fields for flags. + +1. Field: `d-` indicates a collection +2. Field: `-c` indicates an encrypted resource + +Also encrypted collections are possible, but only the collection name is encrypted, the content may be unencrypted. + +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. + +[1]: ./info.html + +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`. + +The last column is the resource name. If the `-R` option is specified, the resource path is shown. + +**`-t`** this options only work in combination with `-l` and it adds the resource content type to the output (after the flags) + +**`-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. + +3. Field: **l** indicates a locked resource +4. Field: **x** indicates a executable resource (executable property with http://apache.org/dav/props/ namespace) + +**`-p`** disables file name and path decryption if enabled + +**`-c`** enables file name and path decryption + +**`-R`** recursively shows all resources in the collection and all child collections + +**`-u `** shows only resources with a lastmodified date after the specified + date. Uses the http date format