--- a/docs/html/sync-configuration.html Sun Dec 15 16:54:05 2019 +0100
+++ b/docs/html/sync-configuration.html Sun Dec 15 17:00:46 2019 +0100
@@ -1,12 +1,20 @@
-<!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">
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
<head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
- <meta http-equiv="Content-Style-Type" content="text/css" />
+ <meta charset="utf-8" />
<meta name="generator" content="pandoc" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
<title>Configuration</title>
- <style type="text/css">code{white-space: pre;}</style>
- <link rel="stylesheet" href="davdoc.css" type="text/css" />
+ <style type="text/css">
+ code{white-space: pre-wrap;}
+ span.smallcaps{font-variant: small-caps;}
+ span.underline{text-decoration: underline;}
+ div.column{display: inline-block; vertical-align: top; width: 50%;}
+ </style>
+ <link rel="stylesheet" href="davdoc.css" />
+ <!--[if lt IE 9]>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+ <![endif]-->
</head>
<body>
<div class="header">
@@ -26,6 +34,7 @@
<li><a href="remove.html">remove</a></li>
<li><a href="copy.html">copy</a></li>
<li><a href="move.html">move</a></li>
+ <li><a href="rename.html">rename</a></li>
<li><a href="export.html">export</a></li>
<li><a href="import.html">import</a></li>
<li><a href="get-property.html">get-property</a></li>
@@ -35,9 +44,19 @@
<li><a href="unlock.html">unlock</a></li>
<li><a href="info.html">info</a></li>
<li><a href="date.html">date</a></li>
+ <li><a href="versioncontrol.html">versioncontrol</a></li>
+ <li><a href="list-versions.html">list-versions</a></li>
+ <li><a href="checkout.html">checkout</a></li>
+ <li><a href="checkin.html">checkin</a></li>
+ <li><a href="uncheckout.html">uncheckout</a></li>
<li><a href="add-repository.html">add-repository</a></li>
<li><a href="remove-repository.html">remove-repository</a></li>
<li><a href="list-repositories.html">list-repositories</a></li>
+ <li><a href="repository-url.html">repository-url</a></li>
+ <li><a href="add-user.html">add-user</a></li>
+ <li><a href="remove-user.html">remove-user</a></li>
+ <li><a href="edit-user.html">edit-user</a></li>
+ <li><a href="list-users.html">list-users</a></li>
<li><a href="check-config.html">check-config</a></li>
</ul>
<li><a href="configuration.html">Configuration</a></li>
@@ -53,11 +72,13 @@
<li><a href="pull.html">pull</a></li>
<li><a href="push.html">push</a></li>
<li><a href="archive.html">archive</a></li>
- <li><a href="list-conflicts.html">list-conflicts</a></li>
+ <li><a href="restore.html">restore</a></li>
+ <li><a href="list-conflicts.html">list-conflicts</a></li>
<li><a href="resolve-conflicts.html">resolve-conflicts</a></li>
<li><a href="delete-conflicts.html">delete-conflicts</a></li>
<li><a href="trash-info.html">trash-info</a></li>
<li><a href="empty-trash.html">empty-trash</a></li>
+ <li><a href="list-versions.html">list-versions</a></li>
<li><a href="add-tag.html">add-tag</a></li>
<li><a href="remove-tag.html">remove-tag</a></li>
<li><a href="set-tags.html">set-tags</a></li>
@@ -74,15 +95,15 @@
<!-- begin content -->
<div class="content">
-<div id="header">
+<header>
<h1 class="title">Configuration</h1>
-</div>
+</header>
<p>The file <code>$HOME/.dav/sync.xml</code> is used for configuring sync-directories.</p>
<p>The <em>sync.xml</em> file is an XML file with <code><configuration></code> as root element. This element can only have <code><directory></code> elements as children.</p>
<h2 id="directory">directory</h2>
<p>This element configures a sync-directory. A sync-directory must have a unique name, a (local) path, repository and a database.</p>
<p>Required elements: <code><name></code>, <code><repository></code>, <code><path></code>, <code><database></code><br />
-Optional elements: <code><collection></code>, <code><trash></code>, <code><max-retry></code>, <code><backup-on-pull></code>, <code><lock-pull></code>, <code><lock-push></code>, <code><lock-timeout></code>, <code><filter></code></p>
+Optional elements: <code><collection></code>, <code><trash></code>, <code><max-retry></code>, <code><backup-on-pull></code>, <code><lock-pull></code>, <code><lock-push></code>, <code><lock-timeout></code>, <code><filter></code>, <code><metadata></code>, <code><versioning></code>, <code><splitconfig></code>, <code><symlink-intern></code>, <code><symlink-extern></code>, <code><tagconfig></code>, <code><allow-cmd></code></p>
<h3 id="name">name</h3>
<p>Unique sync-directory identifer. This identifer is used in combination with all <em>dav-sync</em> commands.</p>
<p>Type: string<br />
@@ -106,10 +127,19 @@
<p>Type: string<br />
Default: /<br />
Example: <code><collection>/myfiles</collection></code></p>
+<h3 id="hashing">hashing</h3>
+<p>Enables file hashing. The hash will be used for checking if files are modified and should be synchronized.</p>
+<p>Type: boolean<br />
+Default: false<br />
+Example: <code><hashing>true</hashing></code></p>
<h3 id="trash">trash</h3>
<p>Path to the trash directory for this sync-directory. Files that should be deleted will be moved to this directory. The value must be an absolute path or relative to the sync-directory path.</p>
<p>Type: string<br />
Example: <code><trash>.trash</trash></code></p>
+<h3 id="push-strategy">push-strategy</h3>
+<p>Controls the strategy <em>push</em> uses for deciding which files should be pushed. Possible values are: <code>metadata</code> and <code>hash</code>.</p>
+<p>Type: pushstrategy enum<br />
+Default: metadata Example: <code><push-strategy>hash</push-strategy></code></p>
<h3 id="max-retry">max-retry</h3>
<p>This integer value controls how many attempts of downloading/uploading a file in case of an error are made.</p>
<p>Type: integer<br />
@@ -131,10 +161,37 @@
Default: false<br />
Example: <code><lock-push>true</lock-push></code></p>
<h3 id="lock-timeout">lock-timeout</h3>
-<p>Specifies the lock timeout in seconds. If the lock-timeout is 0, the client doesn't request a specific timeout and the server's default value is used. If the lock-timeout is -1, a infinite timeout is requested.</p>
+<p>Specifies the lock timeout in seconds. If the lock-timeout is 0, the client doesn’t request a specific timeout and the server’s default value is used. If the lock-timeout is -1, a infinite timeout is requested.</p>
<p>Type: integer<br />
Default: 0<br />
Example: <code><lock-timeout>50</lock-timeout></code></p>
+<h3 id="metadata">metadata</h3>
+<p>Controls which file metadata should be synchronized. Possible values are: <code>mtime</code>, <code>mode</code>, <code>xattr</code> and <code>all</code>. If this element is not specified, no metadata will be synchronized.</p>
+<p>Type: list of metadata<br />
+Example: <code><metadata>mtime mode</metadata></code></p>
+<h3 id="versioning">versioning</h3>
+<p>Enables resource versioning for the commands <em>push</em> and <em>archive</em>.</p>
+<p>Possible attributes: <code>type</code>, <code>always</code></p>
+<p>The attribute <code>type</code> sets the versioning method type. Possible values are <code>simple</code> and <code>deltav</code>. With <em>simple</em> versioning, resources are moved to a version history collection before the new content is uploaded. With <em>deltav</em>, the DeltaV methods <em>checkout</em> and <em>checkin</em> are used to store versions. The default value of the <code>type</code> attribute is <code>simple</code>.</p>
+<p>The boolean attribute <code>always</code> specifies if new versions should be always created. The default value is <code>false</code>.</p>
+<p>Optional elements: <code><history></code> Example: <code><versioning type="simple" always="true" /></code></p>
+<h3 id="history">history</h3>
+<p>Specifies the history collection path for <em>simple</em> versioning. The path is interpreted relatively to the root of the sync directory.</p>
+<p>Type: string<br />
+Default: <code>/.dav-version-history</code> Example:</p>
+<pre><code><versioning type="simple">
+ <history>/.backup/</history>
+</versioning></code></pre>
+<h3 id="symlink-intern">symlink-intern</h3>
+<p>Configures the handling of symlinks, which have a target inside the sync directory. Possible values are: <code>sync</code>, <code>follow</code> and <code>ignore</code>.</p>
+<p>Type: symlink enum<br />
+Default: follow<br />
+Example: <code><symlink-intern>sync</symlink-intern></code></p>
+<h2 id="symlink-extern">symlink-extern</h2>
+<p>Configures the handling of symlinks, which have a target outside the sync directory. Possible values are: <code>follow</code> and <code>ignore</code>. Unlike internal symlinks, external symlinks cannot be synced.</p>
+<p>Type: symlink enum<br />
+Default: follow<br />
+Example: <code><symlink-extern>ignore</symlink-extern></code></p>
<h3 id="tagconfig">tagconfig</h3>
<p>Configures the local store for resource tags. If this element is specified, resource tags are stored locally.</p>
<p>Optional elements: local-store, detect-changes, xattr-name, on-conflict</p>
@@ -159,6 +216,34 @@
<p>Type: onconflict enum<br />
Default: no_conflict<br />
Example: <code><on-conflict>merge</on-conflict></code></p>
+<h3 id="splitconfig">splitconfig</h3>
+<p>Parent element for all <code><split></code> elements.</p>
+<h3 id="split">split</h3>
+<p>Configures if and how files should be splitted into multiple parts on <em>push</em>.</p>
+<p>The blocksize element configures the size of each part.</p>
+<p>The elements filter and minsize specify, in which case the files should be splitted.</p>
+<p>Required elements: <code><blocksize></code><br />
+Optional elements: <code><filter></code>, <code><minsize></code></p>
+<p>Example:</p>
+<pre><code><splitconfig>
+ <!-- split all files with .vmdk file extension that are bigger than 100mb -->
+ <split>
+ <blocksize>10m</blocksize>
+ <filter>
+ <include>\.vmdk$</include>
+ </filter>
+ <minsize>100m</minsize>
+ </split>
+</splitconfig></code></pre>
+<h3 id="blocksize">blocksize</h3>
+<p>Specifies the size of each file part.</p>
+<p>Type: size<br />
+Example: <code><blocksize>100k</blocksize></code></p>
+<h3 id="minsize">minsize</h3>
+<p>Specifies the minimal size a file must have for enabling file splitting.</p>
+<p>Type: size<br />
+Default: 0<br />
+Example: <code><minsize>100m</minsize></code></p>
<h3 id="filter">filter</h3>
<p>With the filter element, include and exclude filters can be specified, to control which files are synchronized. The <em>pull</em>, <em>push</em> and <em>archive</em> command apply these filters to file paths. At first it is checked if a file is matching any include filter. If so only files matching not an exclude filter are further processed.</p>
<p>It is also possible to filter resources by tags. Tags can dynamically be applied to individual files. The tag filter elements contains a tag filter expression. Only files that match the filter expression are synchronized.</p>