comparison: docs/html/list.html
docs/html/list.html
- changeset 282
- 3070d72f54af
- parent 273
- c743721d566f
- child 283
- 0e36bb75a732
equal
deleted
inserted
replaced
| 281:ddb5e8f2a43d | 282:3070d72f54af |
|---|---|
| 64 | 64 |
| 65 <!-- begin content --> | 65 <!-- begin content --> |
| 66 <div class="content"> | 66 <div class="content"> |
| 67 <h1 id="dav-list">dav list</h1> | 67 <h1 id="dav-list">dav list</h1> |
| 68 <p><strong><code>dav list [-altepcR] [-u <date>] <url></code></strong></p> | 68 <p><strong><code>dav list [-altepcR] [-u <date>] <url></code></strong></p> |
| 69 <p>Lists child resources of the specified collection. Without any options it shows only the direct children and hides files beginning with a dot.</p> | 69 <p>Lists child resources of the specified collection. Without any option it shows only the direct children and hides files beginning with a dot. The behavior is quite similar to that of the unix tool <code>ls</code>.</p> |
| 70 <h2 id="options">Options</h2> | 70 <h2 id="options">Options</h2> |
| 71 <p><strong><code>-a</code></strong> don't hide files whose names begins with a dot <code>.</code></p> | 71 <p><strong><code>-a</code></strong> don't hide files whose names begin with a dot <code>.</code></p> |
| 72 <p><strong><code>-l</code></strong> show additional information for resources</p> | 72 <p><strong><code>-l</code></strong> show additional information for resources</p> |
| 73 <p>Example:</p> | 73 <p>Example:</p> |
| 74 <pre><code>-- 4.2 KiB Oct 11 2015 somefile</code></pre> | 74 <pre><code>-- 4.2 KiB Oct 11 2015 somefile</code></pre> |
| 75 <p>The first column contains to fields for flags.</p> | 75 <p>The first column contains to fields for flags.</p> |
| 76 <ol style="list-style-type: decimal"> | 76 <ol style="list-style-type: decimal"> |
| 77 <li>Field: <code>d-</code> indicates a collection</li> | 77 <li>Field: <code>d-</code> indicates a collection</li> |
| 78 <li>Field: <code>-c</code> indicates an encrypted resource</li> | 78 <li>Field: <code>-c</code> indicates an encrypted resource</li> |
| 79 </ol> | 79 </ol> |
| 80 <p>Also encrypted collections are possible, but only the collection name is encrypted, the content may be unencrypted.</p> | 80 <p>Encrypted collections are also possible, but only the collection name is encrypted, the content may be unencrypted.</p> |
| 81 <p>The second column in the <code>list -l</code> 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 <a href="./info.html">dav info</a> command.</p> | 81 <p>The second column in the <code>list -l</code> 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 <a href="./info.html">dav info</a> command.</p> |
| 82 <p>The third column is the date of the last modification. The <code>strftime</code> format is <code>%b %d %H:%M</code> if the year is the same. Otherwise the format is <code>%b %d %Y</code>.</p> | 82 <p>The third column is the date of the last modification. The <code>strftime</code> format is <code>%b %d %H:%M</code> if the year is the current year. Otherwise the format is <code>%b %d %Y</code>.</p> |
| 83 <p>The last column is the resource name. If the <code>-R</code> option is specified, the resource path is shown.</p> | 83 <p>The last column is the resource name. If the <code>-R</code> option is specified, the resource path is shown.</p> |
| 84 <p><strong><code>-t</code></strong> this options only works in combination with <code>-l</code> and it adds the resource content type to the output (after the flags)</p> | 84 <p><strong><code>-t</code></strong> this options only works in combination with <code>-l</code> and it adds the resource content type to the output (after the flags)</p> |
| 85 <p><strong><code>-e</code></strong> similar to <code>-l</code>, but with 6 flag fields. Currently only the first 4 fields are used. The last two are reserved for future use.</p> | 85 <p><strong><code>-e</code></strong> similar to <code>-l</code>, but with 6 flag fields. Currently only the first 4 fields are used. The last two are reserved for future use.</p> |
| 86 <ol start="3" style="list-style-type: decimal"> | 86 <ol style="list-style-type: decimal"> |
| 87 <li>Field: <strong>l</strong> indicates a locked resource</li> | 87 <li>Field: <code>d---</code> indicates a collection</li> |
| 88 <li>Field: <strong>x</strong> indicates a executable resource (executable property with http://apache.org/dav/props/ namespace)</li> | 88 <li>Field: <code>-c--</code> indicates an encrypted resource</li> |
| 89 <li>Field: <code>--l-</code> indicates a locked resource</li> | |
| 90 <li>Field: <code>---x</code> indicates an executable resource (executable property with http://apache.org/dav/props/ namespace)</li> | |
| 89 </ol> | 91 </ol> |
| 92 <p>All combinations of these four flags are possible.</p> | |
| 90 <p><strong><code>-p</code></strong> disable file name and path decryption if enabled</p> | 93 <p><strong><code>-p</code></strong> disable file name and path decryption if enabled</p> |
| 91 <p><strong><code>-c</code></strong> enable file name and path decryption</p> | 94 <p><strong><code>-c</code></strong> enable file name and path decryption</p> |
| 92 <p><strong><code>-R</code></strong> recursively show all resources in the collection and all child collections</p> | 95 <p><strong><code>-R</code></strong> recursively show all resources in the collection and all child collections</p> |
| 93 <p><strong><code>-u <date></code></strong> show only resources with a lastmodified date after the specified date. Uses the http date format</p> | 96 <p><strong><code>-u <date></code></strong> show only resources with a <code>lastmodified</code> date after the specified date. Uses the HTTP date format.</p> |
| 94 <p><strong>Command alias:</strong> ls</p> | 97 <p><strong>Command alias:</strong> ls</p> |
| 95 </div> | 98 </div> |
| 96 <!-- end content --> | 99 <!-- end content --> |
| 97 </body> | 100 </body> |
| 98 </html> | 101 </html> |
