Sat, 05 Aug 2017 10:19:53 +0200
refines commands.md
265
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
1 | dav list |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
2 | ======== |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
3 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
4 | **`dav list [-altepcR] [-u <date>] <url>`** |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
5 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
6 | Lists child resources of the specified collection. Without any options it |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
7 | shows only the direct children and hides files beginning with a dot. |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
8 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
9 | Options |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
10 | ------- |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
11 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
12 | **`-a`** don't hide files whose names begins with a dot `.` |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
13 | |
266
8c44c5919691
more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
265
diff
changeset
|
14 | **`-l`** show additional information for resources |
265
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
15 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
16 | Example: |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
17 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
18 | -- 4.2 KiB Oct 11 2015 somefile |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
19 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
20 | The first column contains to fields for flags. |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
21 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
22 | 1. Field: `d-` indicates a collection |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
23 | 2. Field: `-c` indicates an encrypted resource |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
24 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
25 | Also encrypted collections are possible, but only the collection name is encrypted, the content may be unencrypted. |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
26 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
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. |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
28 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
29 | [1]: ./info.html |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
30 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
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`. |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
32 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
33 | The last column is the resource name. If the `-R` option is specified, the resource path is shown. |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
34 | |
266
8c44c5919691
more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
265
diff
changeset
|
35 | **`-t`** this options only works in combination with `-l` and it adds the resource content type to the output (after the flags) |
265
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
36 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
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. |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
38 | |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
39 | 3. Field: **l** indicates a locked resource |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
40 | 4. Field: **x** indicates a executable resource (executable property with http://apache.org/dav/props/ namespace) |
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
41 | |
266
8c44c5919691
more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
265
diff
changeset
|
42 | **`-p`** disable file name and path decryption if enabled |
265
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
43 | |
266
8c44c5919691
more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
265
diff
changeset
|
44 | **`-c`** enable file name and path decryption |
265
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
45 | |
266
8c44c5919691
more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
265
diff
changeset
|
46 | **`-R`** recursively show all resources in the collection and all child collections |
265
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
47 | |
266
8c44c5919691
more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
265
diff
changeset
|
48 | **`-u <date>`** show only resources with a lastmodified date after the specified |
265
ee9e63c437c4
adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff
changeset
|
49 | date. Uses the http date format |
266
8c44c5919691
more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
265
diff
changeset
|
50 | |
8c44c5919691
more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
265
diff
changeset
|
51 | **Command alias:** ls |