add-directory.html- add-repository.html
- add-tag.html
- add-user.html
- archive.html
- check-config.html
- check-repositories.html
- checkin.html
- checkout.html
- commands.html
- configuration.html
- copy.html
- date.html
- davdoc.css
- delete-conflicts.html
- edit-user.html
- edit.html
- empty-trash.html
- encryption.html
- export.html
- get-property.html
- get.html
- getting-started.html
- import.html
- index.html
- info.html
- introduction.html
- list-conflicts.html
- list-directories.html
- list-repositories.html
- list-tags.html
- list-users.html
- list-versions.html
- list.html
- lock.html
- mkdir.html
- move.html
- pull.html
- push.html
- put.html
- remove-property.html
- remove-repository.html
- remove-tag.html
- remove-user.html
- remove.html
- rename.html
- repository-url.html
- resolve-conflicts.html
- restore.html
- set-property.html
- set-tags.html
- sync-check-config.html
- sync-commands.html
- sync-configuration.html
- sync-list-versions.html
- trash-info.html
- uncheckout.html
- unlock.html
- versioncontrol.html
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
<head>
<meta charset="utf-8" />
<meta name="generator" content="pandoc" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
<title>dav list</title>
<style type="text/css">
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
span.underline{text-decoration: underline;}
div.column{display: inline-block; vertical-align: top; width: 50%;}
</style>
<link rel="stylesheet" href="davdoc.css" />
<!--[if lt IE 9]>
<script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
<![endif]-->
</head>
<body>
<div class="header">
<a href="./index.html"><span>DavUtils documentation</span></a>
</div>
<div class="sidebar">
<div class="nav">
<h3>dav</h3>
<ul>
<li><a href="getting-started.html">Getting started</a></li>
<li><a href="commands.html">Commands</a></li>
<ul>
<li><a href="list.html">list</a></li>
<li><a href="get.html">get</a></li>
<li><a href="put.html">put</a></li>
<li><a href="mkdir.html">mkdir</a></li>
<li><a href="remove.html">remove</a></li>
<li><a href="copy.html">copy</a></li>
<li><a href="move.html">move</a></li>
<li><a href="rename.html">rename</a></li>
<li><a href="export.html">export</a></li>
<li><a href="import.html">import</a></li>
<li><a href="get-property.html">get-property</a></li>
<li><a href="set-property.html">set-property</a></li>
<li><a href="remove-property.html">remove-property</a></li>
<li><a href="lock.html">lock</a></li>
<li><a href="unlock.html">unlock</a></li>
<li><a href="info.html">info</a></li>
<li><a href="date.html">date</a></li>
<li><a href="versioncontrol.html">versioncontrol</a></li>
<li><a href="list-versions.html">list-versions</a></li>
<li><a href="checkout.html">checkout</a></li>
<li><a href="checkin.html">checkin</a></li>
<li><a href="uncheckout.html">uncheckout</a></li>
<li><a href="add-repository.html">add-repository</a></li>
<li><a href="remove-repository.html">remove-repository</a></li>
<li><a href="list-repositories.html">list-repositories</a></li>
<li><a href="repository-url.html">repository-url</a></li>
<li><a href="add-user.html">add-user</a></li>
<li><a href="remove-user.html">remove-user</a></li>
<li><a href="edit-user.html">edit-user</a></li>
<li><a href="list-users.html">list-users</a></li>
<li><a href="check-config.html">check-config</a></li>
</ul>
<li><a href="configuration.html">Configuration</a></li>
<li><a href="encryption.html">Encryption</a></li>
</ul>
</div>
<div class="nav">
<h3>dav-sync</h3>
<ul>
<li><a href="introduction.html">Introduction</a></li>
<li><a href="sync-commands.html">Commands</a></li>
<ul>
<li><a href="pull.html">pull</a></li>
<li><a href="push.html">push</a></li>
<li><a href="archive.html">archive</a></li>
<li><a href="restore.html">restore</a></li>
<li><a href="list-conflicts.html">list-conflicts</a></li>
<li><a href="resolve-conflicts.html">resolve-conflicts</a></li>
<li><a href="delete-conflicts.html">delete-conflicts</a></li>
<li><a href="trash-info.html">trash-info</a></li>
<li><a href="empty-trash.html">empty-trash</a></li>
<li><a href="list-versions.html">list-versions</a></li>
<li><a href="add-tag.html">add-tag</a></li>
<li><a href="remove-tag.html">remove-tag</a></li>
<li><a href="set-tags.html">set-tags</a></li>
<li><a href="list-tags.html">list-tags</a></li>
<li><a href="add-directory.html">add-directory</a></li>
<li><a href="list-directories.html">list-directories</a></li>
<li><a href="sync-check-config.html">check-config</a></li>
<li><a href="check-repositories.html">check-repositories</a></li>
</ul>
<li><a href="sync-configuration.html">Configuration</a></li>
</ul>
</div>
</div>
<!-- begin content -->
<div class="content">
<header>
<h1 class="title">dav list</h1>
</header>
<p><strong><code>dav list [-altdepcR] [-u <date>] <url></code></strong></p>
<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>
<h2 id="options">Options</h2>
<p><strong><code>-a</code></strong> don’t hide files whose names begin with a dot <code>.</code></p>
<p><strong><code>-l</code></strong> show additional information for resources</p>
<p>Example:</p>
<pre><code>-- 4.2 KiB Oct 11 2015 somefile</code></pre>
<p>The first column contains to fields for flags.</p>
<ol type="1">
<li>Field: <code>d-</code> indicates a collection</li>
<li>Field: <code>-c</code> indicates an encrypted resource</li>
</ol>
<p>Encrypted collections are also possible, but only the collection name is encrypted, the content may be unencrypted.</p>
<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>
<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>
<p>The last column is the resource name. If the <code>-R</code> option is specified, the resource path is shown.</p>
<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>
<p><strong><code>-d</code></strong> order resources by their lastmodified date</p>
<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>
<ol type="1">
<li>Field: <code>d---</code> indicates a collection</li>
<li>Field: <code>-c--</code> indicates an encrypted resource</li>
<li>Field: <code>--l-</code> indicates a locked resource</li>
<li>Field: <code>---x</code> indicates an executable resource (executable property with http://apache.org/dav/props/ namespace)</li>
</ol>
<p>All combinations of these four flags are possible.</p>
<p><strong><code>-p</code></strong> disable file name and path decryption if enabled</p>
<p><strong><code>-c</code></strong> enable file name and path decryption</p>
<p><strong><code>-R</code></strong> recursively show all resources in the collection and all child collections</p>
<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>
<p><strong>Command alias:</strong> ls</p>
</div>
<!-- end content -->
</body>
</html>