docs/html/list.html

Thu, 21 Dec 2017 19:48:27 +0100

author
Mike Becker <universe@uap-core.de>
date
Thu, 21 Dec 2017 19:48:27 +0100
changeset 359
bacb54502b24
parent 320
12ed560c926c
child 429
1607450065ba
permissions
-rw-r--r--

davql: allow ANYWHERE keyword in SELECT statements

This may seem pointless, but users might want to be explicit about this and the grammar is more consistent.

This commit also adds some no-ops to the functions body of the SET parser, because some day the grammar might allow more clauses after the WHERE clause.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta http-equiv="Content-Style-Type" content="text/css" />
  <meta name="generator" content="pandoc" />
  <title>dav list</title>
  <style type="text/css">code{white-space: pre;}</style>
  <link rel="stylesheet" href="davdoc.css" type="text/css" />
</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="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="add-repository.html">add-repository</a></li>
						<li><a href="list-repositories.html">list-repositories</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="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="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">
<div id="header">
<h1 class="title">dav list</h1>
</div>
<p><strong><code>dav list [-altdepcR] [-u &lt;date&gt;] &lt;url&gt;</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 style="list-style-type: decimal">
<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 style="list-style-type: decimal">
<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 &lt;date&gt;</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>

mercurial