comparison: docs/src/list.md
docs/src/list.md
- changeset 282
- 3070d72f54af
- parent 266
- 8c44c5919691
- child 283
- 0e36bb75a732
equal
deleted
inserted
replaced
| 281:ddb5e8f2a43d | 282:3070d72f54af |
|---|---|
| 1 dav list | 1 dav list |
| 2 ======== | 2 ======== |
| 3 | 3 |
| 4 **`dav list [-altepcR] [-u <date>] <url>`** | 4 **`dav list [-altepcR] [-u <date>] <url>`** |
| 5 | 5 |
| 6 Lists child resources of the specified collection. Without any options it | 6 Lists child resources of the specified collection. Without any option it |
| 7 shows only the direct children and hides files beginning with a dot. | 7 shows only the direct children and hides files beginning with a dot. |
| 8 The behavior is quite similar to that of the unix tool `ls`. | |
| 8 | 9 |
| 9 Options | 10 Options |
| 10 ------- | 11 ------- |
| 11 | 12 |
| 12 **`-a`** don't hide files whose names begins with a dot `.` | 13 **`-a`** don't hide files whose names begin with a dot `.` |
| 13 | 14 |
| 14 **`-l`** show additional information for resources | 15 **`-l`** show additional information for resources |
| 15 | 16 |
| 16 Example: | 17 Example: |
| 17 | 18 |
| 20 The first column contains to fields for flags. | 21 The first column contains to fields for flags. |
| 21 | 22 |
| 22 1. Field: `d-` indicates a collection | 23 1. Field: `d-` indicates a collection |
| 23 2. Field: `-c` indicates an encrypted resource | 24 2. Field: `-c` indicates an encrypted resource |
| 24 | 25 |
| 25 Also encrypted collections are possible, but only the collection name is encrypted, the content may be unencrypted. | 26 Encrypted collections are also possible, but only the collection name is encrypted, the content may be unencrypted. |
| 26 | 27 |
| 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 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 |
| 29 [1]: ./info.html | 30 [1]: ./info.html |
| 30 | 31 |
| 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 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`. |
| 32 | 33 |
| 33 The last column is the resource name. If the `-R` option is specified, the resource path is shown. | 34 The last column is the resource name. If the `-R` option is specified, the resource path is shown. |
| 34 | 35 |
| 35 **`-t`** this options only works in combination with `-l` and it adds the resource content type to the output (after the flags) | 36 **`-t`** this options only works in combination with `-l` and it adds the resource content type to the output (after the flags) |
| 36 | 37 |
| 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 **`-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 |
| 39 3. Field: **l** indicates a locked resource | 40 1. Field: `d---` indicates a collection |
| 40 4. Field: **x** indicates a executable resource (executable property with http://apache.org/dav/props/ namespace) | 41 2. Field: `-c--` indicates an encrypted resource |
| 42 3. Field: `--l-` indicates a locked resource | |
| 43 4. Field: `---x` indicates an executable resource (executable property with http://apache.org/dav/props/ namespace) | |
| 44 | |
| 45 All combinations of these four flags are possible. | |
| 41 | 46 |
| 42 **`-p`** disable file name and path decryption if enabled | 47 **`-p`** disable file name and path decryption if enabled |
| 43 | 48 |
| 44 **`-c`** enable file name and path decryption | 49 **`-c`** enable file name and path decryption |
| 45 | 50 |
| 46 **`-R`** recursively show all resources in the collection and all child collections | 51 **`-R`** recursively show all resources in the collection and all child collections |
| 47 | 52 |
| 48 **`-u <date>`** show only resources with a lastmodified date after the specified | 53 **`-u <date>`** show only resources with a `lastmodified` date after the specified |
| 49 date. Uses the http date format | 54 date. Uses the HTTP date format. |
| 50 | 55 |
| 51 **Command alias:** ls | 56 **Command alias:** ls |
