changeset
more documentation
Tue, 11 Jul 2017 20:45:32 +0200
- author
- Olaf Wintermann <olaf.wintermann@gmail.com>
- date
- Tue, 11 Jul 2017 20:45:32 +0200
- changeset 266
- 8c44c5919691
- parent 265
- ee9e63c437c4
- child 267
- 171498cb2137
more documentation
--- a/.hgignore Sun Jul 09 20:15:14 2017 +0200 +++ b/.hgignore Tue Jul 11 20:45:32 2017 +0200 @@ -1,6 +1,7 @@ syntax:regexp ^nbproject/.*$ ^build/.*$ +^docs/src/build/.*$ core$ ^.c?project$ ^.settings/.*$
--- a/docs/config.xsd Sun Jul 09 20:15:14 2017 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,126 +0,0 @@ -<?xml version="1.0"?> -<!-- -Copyright 2016 Olaf Wintermann. All rights reserved. - -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions are met: - - 1. Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - - 2. Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE -LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -POSSIBILITY OF SUCH DAMAGE. ---> - -<xs:schema version="1.0" - targetNamespace="http://davutils.org/cfg/dav" - xmlns:xs="http://www.w3.org/2001/XMLSchema" - xmlns:t="http://davutils.org/cfg/dav" - elementFormDefault="qualified" -> - - <xs:complexType name="networkProxy"> - <xs:all> - <xs:element name="url" type="xs:anyURI"/> - <xs:element name="user" minOccurs="0" type="xs:string"/> - <xs:element name="password" minOccurs="0" type="xs:base64Binary" /> - <xs:element name="no" minOccurs="0" type="xs:string"/> - </xs:all> - </xs:complexType> - - <xs:simpleType name="encryptionTypeEnum" > - <xs:restriction base="xs:string"> - <xs:enumeration value="aes128" /> - <xs:enumeration value="aes256" /> - </xs:restriction> - </xs:simpleType> - - <xs:complexType name="encryptionKey"> - <xs:all> - <xs:element name="name" type="xs:string" /> - <xs:element name="file" type="xs:string" /> - <xs:element name="type" minOccurs="0" type="t:encryptionTypeEnum" /> - </xs:all> - </xs:complexType> - - <xs:simpleType name="sslVersionEnum" > - <xs:restriction base="xs:string"> - <xs:enumeration value="TLSv1" /> - <xs:enumeration value="TLSv1.0" /> - <xs:enumeration value="TLSv1.1" /> - <xs:enumeration value="TLSv1.2" /> - <xs:enumeration value="SSLv2" /> - <xs:enumeration value="SSLv3" /> - </xs:restriction> - </xs:simpleType> - - <xs:simpleType name="authmethodEnum"> - <xs:restriction base="xs:string"> - <xs:enumeration value="basic" /> - <xs:enumeration value="digest" /> - <xs:enumeration value="negotiate" /> - <xs:enumeration value="ntlm" /> - <xs:enumeration value="any" /> - <xs:enumeration value="none" /> - </xs:restriction> - </xs:simpleType> - - <xs:complexType name="repositoryEntry"> - <xs:all> - <xs:element name="name" type="xs:string"/> - <xs:element name="url" type="xs:anyURI"/> - <xs:element name="user" minOccurs="0" type="xs:string"/> - <xs:element name="password" minOccurs="0" type="xs:base64Binary" /> - <xs:element name="default-key" minOccurs="0" type="xs:string" /> - <xs:element name="full-encryption" default="false" - minOccurs="0" type="xs:boolean" /> - <xs:element name="content-encryption" default="false" - minOccurs="0" type="xs:boolean" /> - <xs:element name="decrypt-content" default="true" - minOccurs="0" type="xs:boolean" /> - <xs:element name="decrypt-name" default="false" - minOccurs="0" type="xs:boolean" /> - <xs:element name="cert" minOccurs="0" type="xs:string"/> - <xs:element name="verification" default="true" - minOccurs="0" type="xs:boolean" /> - <xs:element name="ssl-version" - minOccurs="0" type="t:sslVersionEnum"/> - <xs:element name="authmethods" minOccurs="0"> - <xs:simpleType> - <xs:list itemType="t:authmethodEnum"/> - </xs:simpleType> - </xs:element> - </xs:all> - </xs:complexType> - - <xs:element name="configuration"> - <xs:complexType> - <xs:sequence minOccurs="0" maxOccurs="unbounded"> - <xs:element name="key" - minOccurs="0" type="t:encryptionKey"> - </xs:element> - <xs:element name="http-proxy" - minOccurs="0" type="t:networkProxy" /> - <xs:element name="https-proxy" - minOccurs="0" type="t:networkProxy" /> - <xs:element name="repository" - minOccurs="0" type="t:repositoryEntry"> - </xs:element> - </xs:sequence> - </xs:complexType> - </xs:element> - -</xs:schema>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/add-repository.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,57 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> + +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/check-config.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,57 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> + +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/commands.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,80 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="commands">Commands</h1> +<h2 id="overview">Overview</h2> +<p>List resources:</p> +<pre><code>dav list <url></code></pre> +<p>Download resource:</p> +<pre><code>dav get <url></code></pre> +<p>Download all resources from a collection:</p> +<pre><code>dav get -R <url></code></pre> +<p>Upload a file:</p> +<pre><code>dav put <url> <file></code></pre> +<p>Upload all files from a directory:</p> +<pre><code>dav put -R <url> <dir></code></pre> +<p>Duplicate a resource or a collection on a server:</p> +<pre><code>dav copy <src-url> <dst-url></code></pre> +<p>There is also a move operation similar to copy:</p> +<pre><code>dav move <src-url> <dst-url></code></pre> +<p>These are the most common commands. There are also more commands for webdav locking and manipulating webdav properties.</p> +<h2 id="common-options">Common options</h2> +<p><strong><code>-N</code></strong> disable any authentication prompt. If authentication is required, dav will abort.</p> +<p><strong><code>-i</code></strong> disable TLS certificate verification</p> +<p><strong><code>-v</code></strong> enable verbose output. Internally <code>CURLOPT_VERBOSE</code> is set to 1 and verbose output is printed on stderr.</p> +<p>Most commands have the <strong><code>-p</code></strong> and <strong><code>-c</code></strong> options for enabling or disabling encryption. If encryption is not configured for a repository, but the <strong><code>-c</code></strong> option is specified, encryption/decryption is enabled. When enabled, all commands handle encrypted resource names. The <strong><code>-p</code></strong> options disables any encryption/decryption. See <a href="./encryption.html">encryption</a> for details.</p> +<h2 id="aliases">Aliases</h2> +<p>Some commands have alternate names. For example <code>dav ls</code> is the same as <code>dav list</code>.</p> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/configuration.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,161 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="configuration">Configuration</h1> +<p>The main configuration file for <em>dav</em> is <code>$HOME/.dav/config.xml</code> and is used for configuring repositories, proxies and encryption keys. This configuration is also used by <em>dav-sync</em>. The file is created automaticaly if it doesn't exist.</p> +<p>The <em>config.xml</em> file is an XML file with <code><configuration></code> as root element. The <code><configuration></code> element can have the following child elements: <code><repository></code>, <code><http-proxy></code>, <code><https-proxy></code>, <code><key></code></p> +<h2 id="repository">repository</h2> +<p>This element is used to configure a repository. A repository must have a unique name to identify the repository and a url pointing to the root collection for this repository.</p> +<p>Required child elements: <code><name></code>, <code><url></code><br /> +Optional elements: <code><user></code>, <code><password></code>, <code><default-key></code>, <code><full-encryption></code>, <code><content-encryption></code>, <code><decrypt-content></code>, <code><decrypt-name></code>, <code><cert></code>, <code><verification></code>, <code><ssl-version></code>, <code><authmethods></code></p> +<h3 id="name">name</h3> +<p>Unique repository identifer.</p> +<p>Type: string<br /> +Example: <code><name>myrepo</name></code></p> +<h3 id="url">url</h3> +<p>The url must point to a valid WebDAV compilant collection.</p> +<p>Type: string<br /> +Example: <code><url>https://example.com/webdav/repo1/</url></code></p> +<h3 id="user">user</h3> +<p>User used for authentication</p> +<p>Type: string<br /> +Example: <code><user>alice</user></code></p> +<h3 id="password">password</h3> +<p>A base64 encoded password used for authentication.</p> +<p>Type: base64 string<br /> +Example: <code><password>MTIzNDU2Nzg=</password></code></p> +<h3 id="default-key">default-key</h3> +<p>Identifer of the key used by default for encryption. There must be a configured key with this name.</p> +<p>Type: string<br /> +Example: <code><key>mykey</key></code></p> +<h3 id="full-encryption">full-encryption</h3> +<p>If this element has the value of true, content and resource name encryption/decryption is enabled. Because encryption and decryption is disabled by default, <code>false</code> has no effect for this element.</p> +<p>Type: boolean<br /> +Default: false<br /> +Example: `<full-encryption>true</full-encryption></p> +<h3 id="content-encryption">content-encryption</h3> +<p>This element enables only content encryption and decryption. A value of <code>false</code> disables content encryption, but it does not disables content decryption, if this is enabled with <code><decrypt-content></code>.</p> +<p>Type: boolean<br /> +Default: false<br /> +Example: <code><content-encryption>true</content-encryption></code></p> +<h3 id="decrypt-content">decrypt-content</h3> +<p>Controls only the decryption of content. If <code>true</code> content is decrypted.</p> +<p>Type: boolean<br /> +Default false<br /> +Example: <code><decrypt-content>true</decrypt-content></code></p> +<h3 id="decrypt-name">decrypt-name</h3> +<p>Controls only the decryption of resource names. If <code>true</code> resource names are decrypted. This effects path to url resolution.</p> +<p>Type: boolean<br /> +Default: false<br /> +Example: <code><decrypt-name>true</decrypt-name></code></p> +<h3 id="cert">cert</h3> +<p>Path to a file containing certificates to verify the TLS connection to the server.</p> +<p>Type: string<br /> +Example: <code><cert>/etc/certs/cabundle.pem</cert></code></p> +<p>Note: This element does the same as curl's <code>--cacert</code> option.</p> +<h3 id="verification">verification</h3> +<p>This element can disable TLS certificate verification.</p> +<p>Type: boolean<br /> +Default: true<br /> +Example: <code><verification>false</verification></code></p> +<h3 id="ssl-version">ssl-version</h3> +<p>Specifies the SSL version to attempt to use. The value must be one of this strings: TLSv1, TLSv1.0, TLSv1.1, TLSv1.2, SSLv2, SSLv3</p> +<p>Type: ssl version enum<br /> +Example: <code><ssl-version>TLSv1.2</ssl-version></code></p> +<h3 id="authmethods">authmethods</h3> +<p>Controls which http authentication methods are used. Multiple methods can be used. The value must be one or more authentication methods separated by space. Valid authentication methods are: basic, digest, negotiate, ntlm, any, none</p> +<p>Type: list of authmethod</p> +<p>Default: basic<br /> +Example: <code><authmethods>basic digest</authmethods></code></p> +<h2 id="key">key</h2> +<p>The <code><key></code> element configures a key used for encryption. A key must have a unique name, which is stored in the properties of encrypted resources. To decrypt resources, dav looks for configured keys with this name, therefore the name of the key should never changed and must be the same on all hosts accessing the same repository.</p> +<p>Required child elements: <code><name></code>, <code><file></code><br /> +Optional elements: <code><type></code></p> +<h3 id="name-1">name</h3> +<p>Unique key identifer.</p> +<p>Type: string<br /> +Example: <code><name>key1</name></code></p> +<h3 id="file">file</h3> +<p>Path to the content of the key. The file should contain 32 (aes256) or 16 (aes128) bytes. If value is not an absolut path, it must be relative to the dav config directory <em>$HOME/.dav/</em>.</p> +<p>Type: string<br /> +Example: <code><path>keys/key1.bin</path></code></p> +<h3 id="type">type</h3> +<p>Specifies the key type. Valid values are <code>aes128</code> or <code>aes256</code>.</p> +<p>Type: aes type enum<br /> +Default: aes256<br /> +Example: <code><type>aes128</type></code></p> +<h2 id="http-proxy-https-proxy">http-proxy / https-proxy</h2> +<p>Configuration for http and https proxies is the same. Both use the same elements, but https-proxy expects an https url.</p> +<p>Required child elements: <code><url></code><br /> +Optional elements: <code><user></code>, <code><password></code>, <code><no></code></p> +<h3 id="url-1">url</h3> +<h3 id="user-1">user</h3> +<h3 id="password-1">password</h3> +<h3 id="no">no</h3> +<h2 id="example-1-minimal-repository-configuration">Example 1: minimal repository configuration</h2> +<p>A minimal configuration for a repository. If no user and/or password are configured, dav prompts for authentication informations if required.</p> +<pre><code><repository> + <name>myrepo</name> + <url>https://example.com/path/to/repo/</url> +</repository></code></pre> +<h2 id="example-2-repository-with-authentication-informations">Example 2: repository with authentication informations</h2> +<p>A typical configuration for easy accessing a repository without authentication prompt.</p> +<pre><code><repository> + <name>myrepo</name> + <url>https://example.com/path/to/repo/</url> + <user>alice</user> + <password>MTIzNDU2Nzg=</password> +</repository></code></pre> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/copy.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,67 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="dav-copy">dav copy</h1> +<p><strong><code>copy [-pcO] [-L <lock>] <url1> <url2></code></strong></p> +<p>Creates a duplicate of the resource identified by <em>url1</em> at the location <em>url2</em>. All resource properties are copied. Currently <em>url1</em> and <em>url2</em> must be the same host.</p> +<p>If <em>url1</em> is a collection, all children are copied.</p> +<p>If <em>url2</em> already exists, the command aborts, unless the <code>-O</code> option is specified.</p> +<p>The command uses a single WebDAV COPY request to duplicate the resources. It does not handle the dav encryption functionality, which means it does not modify <em>url2</em> if encryption is enabled.</p> +<p><strong><code>-p</code></strong> disable file name and path decryption if enabled. This applies only to <em>url1</em></p> +<p><strong><code>-c</code></strong> enable file name and path decryption This applies only to <em>url1</em></p> +<p><strong><code>-O</code></strong> override the destination resource</p> +<p><strong><code>-L <lock></code></strong> use a lock token. See <a href="./lock.html">dav lock</a></p> +<p><strong>Command alias:</strong> cp</p> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/date.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,67 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="dav-date">dav date</h1> +<p><strong><code>date [url]</code></strong></p> +<p>The purpose of this command is to get the current date from a server and print it on stdout (http date format). This in useful in combination with the <code>-U</code> option for the <code>list</code> and <code>get</code> command.</p> +<p>The <em>url</em> can be any http url. If no <em>url</em> is specified, the local time is used.</p> +<h3 id="example-incremental-dav-get">Example: incremental dav get</h3> +<p>It is possible to download only resources, which are modified since a specified date. The <em>date</em> command allows you to easily store the date of the last <em>get</em>.</p> +<pre><code>$ dav get -R myserv/col/ +... +$ dav date myserv > last_get</code></pre> +<p>After some resources are changed on the server, you can download only the modified files.</p> +<pre><code>$ dav get -R -U `cat last_get` myserv/col/</code></pre> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/davdoc.css Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,79 @@ +.header, h1, h2, h3, .sidebar { + font-family: sans-serif; +} + +div.header { + padding-top: 0.3em; + padding-bottom: 0.5em; + margin-bottom: 2em; + border: none; + border-bottom: 1px solid; + border-bottom-color: #2E2E2E; +} + +div.header span { + font-size: 2em; + font-weight: bold; + margin-left: 1em; +} + +div.header img { + float: right; +} + +div.sidebar { + float: left; + width: 15em; +} + +div.nav { + color: black; + background-color: #E9EBEC; + margin-bottom: 1em; + padding-bottom: 0.1em; +} + +div.nav h3 { + color: white; + background-color: #5B6F7A; + font-size: 1.2em; + padding-top: 0.2em; + padding-bottom: 0.2em; + padding-left: 0.5em; + margin-top: 0; +} + +div.nav ul { + margin-top: 0; + padding-top: 0; + font-size: 0.95em; +} + +div.content { + margin-left: 16em; + padding: 0; + font-family: serif; + font-size: 1em; + min-width: 16em; +} + +div.content h1 { + color: white; + background-color: #5B6F7A; + font-size: 1.2em; + padding-top: 0.2em; + padding-bottom: 0.2em; + padding-left: 0.5em; + padding-right: 0; + margin-top: 0; +} + +div.content h2 { + font-size: 1.2em; +} + +div.content h3 { + font-size: 1.05em; +} + +
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/encryption.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,57 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> + +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/get-property.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,72 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="dav-get-property">dav get-property</h1> +<p><strong><code>get-property [-pc] [-n <uri>] <url> <property></code></strong></p> +<p>Gets a specified resource property. Every WebDAV property has a name and an XMl namespace. A namespace can be specified with the <code>-n</code> option or with a prefixed name. A prefix and property name are separated by an <strong>:</strong></p> +<p>Example: <code>D:creationdate</code></p> +<p><code>D</code> is the prefix, <code>creationdate</code> is the name.</p> +<p>There are only two available prefixes:</p> +<ol style="list-style-type: decimal"> +<li><code>D</code> for the <code>DAV:</code> namespace</li> +<li><code>idav</code> for <code>http://davutils.org/</code></li> +</ol> +<p>To use an other namespace, use the <code>-n</code> option.</p> +<p>If the property name has no prefix, and no namespace is specified, the default namespace <code>DAV:</code> is used.</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>-n <uri></code></strong> specify property namespace</p> +<p><strong>Note:</strong> Properties are never encrypted.</p> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/get.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,64 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="dav-get">dav get</h1> +<p><strong><code>get [-pcR] [-o <file>] [-u <date>] <url></code></strong></p> +<p>Downloads a resource. It can also download collections and its child resources. When downloading a single resource, the default local file name is the resource name. When downloading collections, it does NOT create a local directory with the collection's name and places it children in there, but it downloads the children directly to the current working directory.</p> +<p><strong><code>-p</code></strong> disable file name and content decryption. You get exactly what is stored on the server.</p> +<p><strong><code>-c</code></strong> enable file name and content decryption</p> +<p><strong><code>-R</code></strong> download a collection</p> +<p><strong><code>-o <file></code></strong> specify the local output file. A <strong>-</strong> indicates stdout</p> +<p><strong><code>-u <date></code></strong> download only files which are modified since the specified date. Uses the http date format</p> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/getting-started.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,84 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="getting-started">Getting started</h1> +<h3 id="test">Test</h3> +<p>After successful installation you can test dav with your WebDAV server.</p> +<pre><code>dav list http://example.com/webdav/</code></pre> +<p>This lists all child resources of the specified collection. If you are unfamiliar to WebDAV terminology this means basically listing all files in a directory, similar to the ls unix tool. Infact you can also write dav ls instead of dav list and there is also a -l option like ls has one.</p> +<h3 id="create-a-repository">Create a repository</h3> +<p>All dav commands are expecting a url argument, but it may be a bit cumbersome to type a full url every time. But you can configure a repository in the dav configuration file ($HOME/.dav/config.xml) with the servers url, optional authentication information and other options. After that you can access a webdav server just with the repository name and an optional path.</p> +<p>So when you have created a repository with the name myserv and the url http://example.com/webdav/, you can just type</p> +<pre><code>dav list myserv</code></pre> +<p>You can add a path to the repository name to access an other url</p> +<pre><code>dav list myserv/mycollection/</code></pre> +<p>This lists the content of http://example.com/webdav/mycollection/</p> +<p>The easiest way to create a repository is with the add-repository command. This is a simple configuration assistant.</p> +<pre><code>$ dav add-repository +Each repository must have an unique name. +name: myserv + +Specify the repository base url. +url: http://example.com/webdav/ + +User for HTTP authentication. +user (optional): myuser +password (optional): + + +Added repository: myserv (http://example.com/webdav/)</code></pre> +<p>You can also configure the config.xml yourself, check out this example page and the config.xml spec.</p> +<p>More informations about urls and path in dav here.</p> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/info.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,96 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="dav-info">dav info</h1> +<p><strong><code>info [-pc] <url></code></strong></p> +<p>Prints some information and lists all properties for the resource specified by url.</p> +<h3 id="example-1-info-of-a-collection">Example 1: info of a collection</h3> +<p>In this example <em>myserv</em> is a configured repository with the base url <em>https://example.com/webdav/</em>. Because <em>col</em> is not encrypted, the <em>url</em> is just the <em>path</em> appended to base url.</p> +<pre><code>$ dav info myserv/col/ +name: col +path: /col +url: https://example.com/webdav/col +type: collection +size: 28 + +namespace: DAV: + creationdate: 2017-06-14T09:32:43Z + getetag: "1000-551e83bebc19c" + getlastmodified: Wed, 14 Jun 2017 09:32:43 GMT + supportedlock:</code></pre> +<h3 id="example-2-encrypted-resource">Example 2: encrypted resource</h3> +<p>With encrypted resources, the <em>path</em> and <em>url</em> are different. The real resource name is random, but the name used by <em>dav</em> is stored in the <em>crypto-name</em> property.</p> +<pre><code>$ dav info -c myserv/crres +name: crres +path: /crres +url: https://example.com/webdav/wsIwbLxuJQTGtgiMAD1KGeaY +type: resource +size: 48 bytes + +namespace: DAV: + creationdate: 2017-07-09T16:18:09Z + getcontentlength: 48 + getetag: "30-553e4cfecd170" + getlastmodified: Sun, 09 Jul 2017 16:18:09 GMT + supportedlock: + +namespace: http://apache.org/dav/props/ + executable: F + +namespace: http://davutils.org/ + crypto-hash: fm4zstp/FevTs1aoUXc3+mqTmAf2Go+zQ34rSp8/ixDlGLQJXR74Je+WMl1zxZKbS/+5VwDhyZ9pT3gInsq2SA== + crypto-key: mykey + crypto-name: ZU+lZtFi3dprBz44714plYwfRnhyI/apYq46Sk/B6QU=</code></pre> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/list-repositories.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,57 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> + +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/list.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,84 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="dav-list">dav list</h1> +<p><strong><code>dav list [-altepcR] [-u <date>] <url></code></strong></p> +<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> +<h2 id="options">Options</h2> +<p><strong><code>-a</code></strong> don't hide files whose names begins 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>Also encrypted collections are 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 same. 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>-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 start="3" style="list-style-type: decimal"> +<li>Field: <strong>l</strong> indicates a locked resource</li> +<li>Field: <strong>x</strong> indicates a executable resource (executable property with http://apache.org/dav/props/ namespace)</li> +</ol> +<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 lastmodified date after the specified date. Uses the http date format</p> +<p><strong>Command alias:</strong> ls</p> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/lock.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,67 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="dav-lock">dav lock</h1> +<p><strong><code>lock [-pc] <url></code></strong></p> +<p>Creates a lock on the resource specified by the url. The lock is an exclusive write lock with infinity depth.</p> +<p>If the resource is successfully locked, a lock token for this resource is printed on stdout. This lock token should be saved somewhere to unlock the resource eventually.</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> +<h3 id="example-1-lock-resource-and-use-the-lock-token">Example 1: lock resource and use the lock token</h3> +<pre><code>$ dav lock myserv/resource +opaquelocktoken:0454905e-f2ff-45c4-a3d7-5c4e4db5ce37 +$ dav put -L opaquelocktoken:0454905e-f2ff-45c4-a3d7-5c4e4db5ce37 myserv/resource newfile +$ dav unlock -L opaquelocktoken:0454905e-f2ff-45c4-a3d7-5c4e4db5ce37 myserv/resource</code></pre> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/mkdir.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,64 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="dav-mkdir">dav mkdir</h1> +<p><strong><code>mkdir [-pc] [-k <key>] [-L <lock>] <url></code></strong></p> +<p>Creates a collection. All intermediate collections are created.</p> +<p><strong><code>-p</code></strong> disable file name encryption and decryption</p> +<p><strong><code>-c</code></strong> enables file file name and content encryption</p> +<p><strong><code>-k <key></code></strong> use the specified key for encryption. The key must be configured in the config.xml file</p> +<p><strong><code>-L <lock></code></strong> use a lock token</p> +<p><strong>Command alias:</strong> mkcol</p> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/move.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,66 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="dav-move">dav move</h1> +<p><strong><code>move [-pcO] [-L <lock>] <url> <url></code></strong></p> +<p>Moves the resource identified by <em>url1</em> to the location <em>url2</em>. Currently <em>url1</em> and <em>url2</em> must be on the same host.</p> +<p>If <em>url2</em> already exists, the command aborts, unless the <code>-O</code> option is specified.</p> +<p>The command uses a single WebDAV MOVE request to move the resources. It does not handle the dav encryption functionality, which means it does not modify <em>url2</em> if encryption is enabled.</p> +<p><strong><code>-p</code></strong> disable file name and path decryption if enabled. This applies only to <em>url1</em></p> +<p><strong><code>-c</code></strong> enable file name and path decryption This applies only to <em>url1</em></p> +<p><strong><code>-O</code></strong> override the destination resource</p> +<p><strong><code>-L <lock></code></strong> use a lock token. See <a href="./lock.html">dav lock</a></p> +<p><strong>Command alias:</strong> mv</p> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/put.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,65 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="dav-put">dav put</h1> +<p><strong><code>put [-pcR] [-k <key>] [-L <lock>] <url> <file></code></strong></p> +<p>Uploads a file or a directory. When uploading a file and the url points to an existing collection, a resource inside this collection with the file's name is created. When the url points to a non-existing resource, the resource is created.</p> +<p>When uploading a directory, you need to specify the -R option. It uploads all files in the directory to the specified url, but it does not create a collection for the directory itself.</p> +<p><strong><code>-p</code></strong> disable file name encryption and decryption</p> +<p><strong><code>-c</code></strong> enable file name and content encryption</p> +<p><strong><code>-R</code></strong> upload directory</p> +<p><strong><code>-k <key></code></strong> use the specified key for encryption. The key must be configured in the config.xml file</p> +<p><strong><code>-L <lock></code></strong> use a lock token. See <a href="./lock.html">dav lock</a></p> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/remove.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,63 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="dav-remove">dav remove</h1> +<p><strong><code>remove [-pc] [-L <lock>] <url></code></strong></p> +<p>Removes a resource. When removing a collection, all unterneath resources are removed.</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>-L</code></strong> <lock> use a lock token</p> +<p><strong>Command aliases:</strong> rm, delete</p> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/set-property.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,66 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="dav-set-property">dav set-property</h1> +<p><strong><code>set-property [-pc] [-L <lock>] [-n <uri>] <url> <property> [value]</code></strong></p> +<p>Sets a resource property to a specified value.</p> +<p>property is a property name with or without prefix (see <a href="./get-property.html">get-property</a> for details).</p> +<p>If no value is specified, the content for the property is read from stdin.</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>-L <lock></code></strong> use a lock token. See <a href="./get-property.html">dav lock</a></p> +<p><strong><code>-n <uri></code></strong> specify property namespace</p> +<p><strong>Note:</strong> Properties are never encrypted.</p> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/unlock.html Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,69 @@ +<!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></title> + <style type="text/css">code{white-space: pre;}</style> + <link rel="stylesheet" href="davdoc.css" type="text/css" /> +</head> +<body> +<div class="header"> + <span>davutils documentation</span> +</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="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=".">.</a></li> + </ul> + </div> +</div> + +<!-- begin content --> +<div class="content"> +<h1 id="dav-unlock">dav unlock</h1> +<p><strong><code>unlock [-pc] [-L <lock>] <url></code></strong></p> +<p>Unlocks the specified url with a lock token. If no lock token is specified with the <code>-L</code> option, it read from stdin.</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>-L <lock></code></strong> use a lock token</p> +<h3 id="example-1-unlock-with-lock-token-from-stdin">Example 1: unlock with lock token from stdin</h3> +<pre><code>$ dav lock myserv/resource > locktoken +$ dav unlock myserv/resource < locktoken</code></pre> +<h3 id="example-2-unlock-with-lock-token-from-command-line-argument">Example 2: unlock with lock token from command line argument</h3> +<pre><code>$ dav lock myserv/resource +opaquelocktoken:0454905e-f2ff-45c4-a3d7-5c4e4db5ce37 +$ dav unlock -L opaquelocktoken:0454905e-f2ff-45c4-a3d7-5c4e4db5ce37 myserv/resource</code></pre> +</div> +<!-- end content --> +</body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/schema/config.xsd Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,126 @@ +<?xml version="1.0"?> +<!-- +Copyright 2016 Olaf Wintermann. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. +--> + +<xs:schema version="1.0" + targetNamespace="http://davutils.org/cfg/dav" + xmlns:xs="http://www.w3.org/2001/XMLSchema" + xmlns:t="http://davutils.org/cfg/dav" + elementFormDefault="qualified" +> + + <xs:complexType name="networkProxy"> + <xs:all> + <xs:element name="url" type="xs:anyURI"/> + <xs:element name="user" minOccurs="0" type="xs:string"/> + <xs:element name="password" minOccurs="0" type="xs:base64Binary" /> + <xs:element name="no" minOccurs="0" type="xs:string"/> + </xs:all> + </xs:complexType> + + <xs:simpleType name="encryptionTypeEnum" > + <xs:restriction base="xs:string"> + <xs:enumeration value="aes128" /> + <xs:enumeration value="aes256" /> + </xs:restriction> + </xs:simpleType> + + <xs:complexType name="encryptionKey"> + <xs:all> + <xs:element name="name" type="xs:string" /> + <xs:element name="file" type="xs:string" /> + <xs:element name="type" minOccurs="0" type="t:encryptionTypeEnum" /> + </xs:all> + </xs:complexType> + + <xs:simpleType name="sslVersionEnum" > + <xs:restriction base="xs:string"> + <xs:enumeration value="TLSv1" /> + <xs:enumeration value="TLSv1.0" /> + <xs:enumeration value="TLSv1.1" /> + <xs:enumeration value="TLSv1.2" /> + <xs:enumeration value="SSLv2" /> + <xs:enumeration value="SSLv3" /> + </xs:restriction> + </xs:simpleType> + + <xs:simpleType name="authmethodEnum"> + <xs:restriction base="xs:string"> + <xs:enumeration value="basic" /> + <xs:enumeration value="digest" /> + <xs:enumeration value="negotiate" /> + <xs:enumeration value="ntlm" /> + <xs:enumeration value="any" /> + <xs:enumeration value="none" /> + </xs:restriction> + </xs:simpleType> + + <xs:complexType name="repositoryEntry"> + <xs:all> + <xs:element name="name" type="xs:string"/> + <xs:element name="url" type="xs:anyURI"/> + <xs:element name="user" minOccurs="0" type="xs:string"/> + <xs:element name="password" minOccurs="0" type="xs:base64Binary" /> + <xs:element name="default-key" minOccurs="0" type="xs:string" /> + <xs:element name="full-encryption" default="false" + minOccurs="0" type="xs:boolean" /> + <xs:element name="content-encryption" default="false" + minOccurs="0" type="xs:boolean" /> + <xs:element name="decrypt-content" default="true" + minOccurs="0" type="xs:boolean" /> + <xs:element name="decrypt-name" default="false" + minOccurs="0" type="xs:boolean" /> + <xs:element name="cert" minOccurs="0" type="xs:string"/> + <xs:element name="verification" default="true" + minOccurs="0" type="xs:boolean" /> + <xs:element name="ssl-version" + minOccurs="0" type="t:sslVersionEnum"/> + <xs:element name="authmethods" minOccurs="0"> + <xs:simpleType> + <xs:list itemType="t:authmethodEnum"/> + </xs:simpleType> + </xs:element> + </xs:all> + </xs:complexType> + + <xs:element name="configuration"> + <xs:complexType> + <xs:sequence minOccurs="0" maxOccurs="unbounded"> + <xs:element name="key" + minOccurs="0" type="t:encryptionKey"> + </xs:element> + <xs:element name="http-proxy" + minOccurs="0" type="t:networkProxy" /> + <xs:element name="https-proxy" + minOccurs="0" type="t:networkProxy" /> + <xs:element name="repository" + minOccurs="0" type="t:repositoryEntry"> + </xs:element> + </xs:sequence> + </xs:complexType> + </xs:element> + +</xs:schema>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/schema/sync.xsd Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,72 @@ +<?xml version="1.0"?> +<!-- +Copyright 2016 Olaf Wintermann. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. +--> + +<xs:schema version="1.0" + targetNamespace="http://davutils.org/cfg/dav-sync" + xmlns:xs="http://www.w3.org/2001/XMLSchema" + xmlns:t="http://davutils.org/cfg/dav-sync" + elementFormDefault="qualified" +> + + <xs:complexType name="filenameFilter"> + <xs:sequence> + <xs:element name="include" type="xs:string" + minOccurs="0" maxOccurs="unbounded" /> + <xs:element name="exclude" type="xs:string" + minOccurs="0" maxOccurs="unbounded" /> + </xs:sequence> + </xs:complexType> + + <xs:complexType name="direntry"> + <xs:all> + <xs:element name="name" type="xs:string"/> + <xs:element name="database" type="xs:string"/> + <xs:element name="path" type="xs:string"/> + <xs:element name="repository" type="xs:string"/> + <xs:element name="collection" minOccurs="0" type="xs:string"/> + <xs:element name="trash" minOccurs="0" type="xs:string"/> + <xs:element name="filter" minOccurs="0" type="t:filenameFilter" /> + <xs:element name="max-retry" default="0" + minOccurs="0" type="xs:unsignedInt"/> + <xs:element name="backup-on-pull" default="false" + minOccurs="0" type="xs:boolean" /> + <xs:element name="lock-pull" default="false" + minOccurs="0" type="xs:boolean" /> + <xs:element name="lock-push" default="false" + minOccurs="0" type="xs:boolean" /> + </xs:all> + </xs:complexType> + + <xs:element name="configuration"> + <xs:complexType> + <xs:sequence> + <xs:element name="directory" type="t:direntry" + minOccurs="0" maxOccurs="unbounded" /> + </xs:sequence> + </xs:complexType> + </xs:element> +</xs:schema>
--- a/docs/src/Makefile Sun Jul 09 20:15:14 2017 +0200 +++ b/docs/src/Makefile Tue Jul 11 20:45:32 2017 +0200 @@ -46,6 +46,9 @@ SRC += date.md SRC += configuration.md SRC += encryption.md +SRC += add-repository.md +SRC += list-repositories.md +SRC += check-config.md HTML = $(SRC:%.md=build/%.html)
--- a/docs/src/commands.md Sun Jul 09 20:15:14 2017 +0200 +++ b/docs/src/commands.md Tue Jul 11 20:45:32 2017 +0200 @@ -42,3 +42,12 @@ **`-i`** disable TLS certificate verification **`-v`** enable verbose output. Internally `CURLOPT_VERBOSE` is set to 1 and verbose output is printed on stderr. + +Most commands have the **`-p`** and **`-c`** options for enabling or disabling encryption. If encryption is not configured for a repository, but the **`-c`** option is specified, encryption/decryption is enabled. When enabled, all commands handle encrypted resource names. The **`-p`** options disables any encryption/decryption. See [encryption][1] for details. + +[1]: ./encryption.html + +Aliases +------- + +Some commands have alternate names. For example `dav ls` is the same as `dav list`.
--- a/docs/src/configuration.md Sun Jul 09 20:15:14 2017 +0200 +++ b/docs/src/configuration.md Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,178 @@ +Configuration +============= + +The main configuration file for *dav* is `$HOME/.dav/config.xml` and is used for configuring repositories, proxies and encryption keys. This configuration is also used by *dav-sync*. The file is created automaticaly if it doesn't exist. + +The *config.xml* file is an XML file with `<configuration>` as root element. The `<configuration>` element can have the following child elements: `<repository>`, `<http-proxy>`, `<https-proxy>`, `<key>` + +## repository + +This element is used to configure a repository. A repository must have a unique name to identify the repository and a url pointing to the root collection for this repository. + +Required child elements: `<name>`, `<url>` \ +Optional elements: `<user>`, `<password>`, `<default-key>`, `<full-encryption>`, `<content-encryption>`, `<decrypt-content>`, `<decrypt-name>`, `<cert>`, `<verification>`, `<ssl-version>`, `<authmethods>` + +### name + +Unique repository identifer. + +Type: string \ +Example: `<name>myrepo</name>` + +### url + +The url must point to a valid WebDAV compilant collection. + +Type: string \ +Example: `<url>https://example.com/webdav/repo1/</url>` + +### user + +User used for authentication + +Type: string \ +Example: `<user>alice</user>` + +### password + +A base64 encoded password used for authentication. + +Type: base64 string \ +Example: `<password>MTIzNDU2Nzg=</password>` + +### default-key + +Identifer of the key used by default for encryption. There must be a configured key with this name. + +Type: string \ +Example: `<key>mykey</key>` + +### full-encryption + +If this element has the value of true, content and resource name encryption/decryption is enabled. Because encryption and decryption is disabled by default, `false` has no effect for this element. + +Type: boolean \ +Default: false \ +Example: `<full-encryption>true</full-encryption> + +### content-encryption + +This element enables only content encryption and decryption. A value of `false` disables content encryption, but it does not disables content decryption, if this is enabled with `<decrypt-content>`. + +Type: boolean \ +Default: false \ +Example: `<content-encryption>true</content-encryption>` + +### decrypt-content + +Controls only the decryption of content. If `true` content is decrypted. + +Type: boolean \ +Default false \ +Example: `<decrypt-content>true</decrypt-content>` + +### decrypt-name + +Controls only the decryption of resource names. If `true` resource names are decrypted. This effects path to url resolution. + +Type: boolean \ +Default: false \ +Example: `<decrypt-name>true</decrypt-name>` + +### cert + +Path to a file containing certificates to verify the TLS connection to the server. + +Type: string \ +Example: `<cert>/etc/certs/cabundle.pem</cert>` + +Note: This element does the same as curl's `--cacert` option. + +### verification + +This element can disable TLS certificate verification. + +Type: boolean \ +Default: true \ +Example: `<verification>false</verification>` + +### ssl-version + +Specifies the SSL version to attempt to use. The value must be one of this strings: TLSv1, TLSv1.0, TLSv1.1, TLSv1.2, SSLv2, SSLv3 + +Type: ssl version enum \ +Example: `<ssl-version>TLSv1.2</ssl-version>` + +### authmethods + +Controls which http authentication methods are used. Multiple methods can be used. The value must be one or more authentication methods separated by space. Valid authentication methods are: basic, digest, negotiate, ntlm, any, none + +Type: list of authmethod + +Default: basic \ +Example: `<authmethods>basic digest</authmethods>` + +## key + +The `<key>` element configures a key used for encryption. A key must have a unique name, which is stored in the properties of encrypted resources. To decrypt resources, dav looks for configured keys with this name, therefore the name of the key should never changed and must be the same on all hosts accessing the same repository. + +Required child elements: `<name>`, `<file>` \ +Optional elements: `<type>` + +### name + +Unique key identifer. + +Type: string \ +Example: `<name>key1</name>` + +### file + +Path to the content of the key. The file should contain 32 (aes256) or 16 (aes128) bytes. If value is not an absolut path, it must be relative to the dav config directory *$HOME/.dav/*. + +Type: string \ +Example: `<path>keys/key1.bin</path>` + +### type + +Specifies the key type. Valid values are `aes128` or `aes256`. + +Type: aes type enum \ +Default: aes256 \ +Example: `<type>aes128</type>` + +## http-proxy / https-proxy + +Configuration for http and https proxies is the same. Both use the same elements, but https-proxy expects an https url. + +Required child elements: `<url>` \ +Optional elements: `<user>`, `<password>`, `<no>` + +### url + +### user + +### password + +### no + +## Example 1: minimal repository configuration + +A minimal configuration for a repository. If no user and/or password are configured, dav prompts for authentication informations if required. + + <repository> + <name>myrepo</name> + <url>https://example.com/path/to/repo/</url> + </repository> + +## Example 2: repository with authentication informations + +A typical configuration for easy accessing a repository without authentication prompt. + + <repository> + <name>myrepo</name> + <url>https://example.com/path/to/repo/</url> + <user>alice</user> + <password>MTIzNDU2Nzg=</password> + </repository> +
--- a/docs/src/copy.md Sun Jul 09 20:15:14 2017 +0200 +++ b/docs/src/copy.md Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,24 @@ +dav copy +======== + +**`copy [-pcO] [-L <lock>] <url1> <url2>`** + +Creates a duplicate of the resource identified by *url1* at the location *url2*. All resource properties are copied. Currently *url1* and *url2* must be the same host. + +If *url1* is a collection, all children are copied. + +If *url2* already exists, the command aborts, unless the `-O` option is specified. + +The command uses a single WebDAV COPY request to duplicate the resources. It does not handle the dav encryption functionality, which means it does not modify *url2* if encryption is enabled. + +**`-p`** disable file name and path decryption if enabled. This applies only to *url1* + +**`-c`** enable file name and path decryption This applies only to *url1* + +**`-O`** override the destination resource + +**`-L <lock>`** use a lock token. See [dav lock][1] + +[1]: ./lock.html + +**Command alias:** cp
--- a/docs/src/get.md Sun Jul 09 20:15:14 2017 +0200 +++ b/docs/src/get.md Tue Jul 11 20:45:32 2017 +0200 @@ -18,6 +18,6 @@ **`-o <file>`** specify the local output file. A **-** indicates stdout -**`-u <date>`** downloads only files which are modified since the specified date. Uses the http date format +**`-u <date>`** download only files which are modified since the specified date. Uses the http date format
--- a/docs/src/header.html Sun Jul 09 20:15:14 2017 +0200 +++ b/docs/src/header.html Tue Jul 11 20:45:32 2017 +0200 @@ -21,6 +21,9 @@ <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>
--- a/docs/src/list.md Sun Jul 09 20:15:14 2017 +0200 +++ b/docs/src/list.md Tue Jul 11 20:45:32 2017 +0200 @@ -11,7 +11,7 @@ **`-a`** don't hide files whose names begins with a dot `.` -**`-l`** shows additional information for resources +**`-l`** show additional information for resources Example: @@ -32,18 +32,20 @@ The last column is the resource name. If the `-R` option is specified, the resource path is shown. -**`-t`** this options only work in combination with `-l` and it adds the resource content type to the output (after the flags) +**`-t`** this options only works in combination with `-l` and it adds the resource content type to the output (after the flags) **`-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. 3. Field: **l** indicates a locked resource 4. Field: **x** indicates a executable resource (executable property with http://apache.org/dav/props/ namespace) -**`-p`** disables file name and path decryption if enabled +**`-p`** disable file name and path decryption if enabled -**`-c`** enables file name and path decryption +**`-c`** enable file name and path decryption -**`-R`** recursively shows all resources in the collection and all child collections +**`-R`** recursively show all resources in the collection and all child collections -**`-u <date>`** shows only resources with a lastmodified date after the specified +**`-u <date>`** show only resources with a lastmodified date after the specified date. Uses the http date format + +**Command alias:** ls
--- a/docs/src/mkdir.md Sun Jul 09 20:15:14 2017 +0200 +++ b/docs/src/mkdir.md Tue Jul 11 20:45:32 2017 +0200 @@ -13,3 +13,5 @@ the config.xml file **`-L <lock>`** use a lock token + +**Command alias:** mkcol
--- a/docs/src/move.md Sun Jul 09 20:15:14 2017 +0200 +++ b/docs/src/move.md Tue Jul 11 20:45:32 2017 +0200 @@ -0,0 +1,22 @@ +dav move +======== + +**`move [-pcO] [-L <lock>] <url> <url>`** + +Moves the resource identified by *url1* to the location *url2*. Currently *url1* and *url2* must be on the same host. + +If *url2* already exists, the command aborts, unless the `-O` option is specified. + +The command uses a single WebDAV MOVE request to move the resources. It does not handle the dav encryption functionality, which means it does not modify *url2* if encryption is enabled. + +**`-p`** disable file name and path decryption if enabled. This applies only to *url1* + +**`-c`** enable file name and path decryption This applies only to *url1* + +**`-O`** override the destination resource + +**`-L <lock>`** use a lock token. See [dav lock][1] + +[1]: ./lock.html + +**Command alias:** mv
--- a/docs/src/remove.md Sun Jul 09 20:15:14 2017 +0200 +++ b/docs/src/remove.md Tue Jul 11 20:45:32 2017 +0200 @@ -11,3 +11,5 @@ **`-c`** enable file name and path decryption **`-L`** <lock> use a lock token + +**Command aliases:** rm, delete
--- a/docs/sync.xsd Sun Jul 09 20:15:14 2017 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,72 +0,0 @@ -<?xml version="1.0"?> -<!-- -Copyright 2016 Olaf Wintermann. All rights reserved. - -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions are met: - - 1. Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - - 2. Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE -LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -POSSIBILITY OF SUCH DAMAGE. ---> - -<xs:schema version="1.0" - targetNamespace="http://davutils.org/cfg/dav-sync" - xmlns:xs="http://www.w3.org/2001/XMLSchema" - xmlns:t="http://davutils.org/cfg/dav-sync" - elementFormDefault="qualified" -> - - <xs:complexType name="filenameFilter"> - <xs:sequence> - <xs:element name="include" type="xs:string" - minOccurs="0" maxOccurs="unbounded" /> - <xs:element name="exclude" type="xs:string" - minOccurs="0" maxOccurs="unbounded" /> - </xs:sequence> - </xs:complexType> - - <xs:complexType name="direntry"> - <xs:all> - <xs:element name="name" type="xs:string"/> - <xs:element name="database" type="xs:string"/> - <xs:element name="path" type="xs:string"/> - <xs:element name="repository" type="xs:string"/> - <xs:element name="collection" minOccurs="0" type="xs:string"/> - <xs:element name="trash" minOccurs="0" type="xs:string"/> - <xs:element name="filter" minOccurs="0" type="t:filenameFilter" /> - <xs:element name="max-retry" default="0" - minOccurs="0" type="xs:unsignedInt"/> - <xs:element name="backup-on-pull" default="false" - minOccurs="0" type="xs:boolean" /> - <xs:element name="lock-pull" default="false" - minOccurs="0" type="xs:boolean" /> - <xs:element name="lock-push" default="false" - minOccurs="0" type="xs:boolean" /> - </xs:all> - </xs:complexType> - - <xs:element name="configuration"> - <xs:complexType> - <xs:sequence> - <xs:element name="directory" type="t:direntry" - minOccurs="0" maxOccurs="unbounded" /> - </xs:sequence> - </xs:complexType> - </xs:element> -</xs:schema>
