Manual

Run the binary as follows:

  java -jar webdav_sync.jar [-h] [-i seconds] [-reset] \
    (-c config_file | [(-r|-no-recursion)] [-rename] \
    [-rename-depth number] [-hidden-folder] \
    [-e comma_separated_patterns] (-down|-up|-bi) \
    -u URL -d directory)

-h

Writes the command synopsis on the terminal.

-r

Recurs into empty directories. This is only useful if the server doesn't support "infinity" for the WebDAV "Depth" header or if you are not in a position to turn it on. A server may correctly report the fact that it doesn't support this, in which case you don't need the option because the recursion will be done automatically.

-no-recursion

Prohibits recursion into subdirectories, even if the server supports recursion.

-i

An interval in seconds. When set the tool loops forever and executes the synchronization every interval.

-c

A configuration file with the following form:

    <?xml version="1.0"?>
    <config>
      <sync>
        <directory>dir</directory>
        <url>https://...</url>
        <direction>down</direction>
        <!-- Optional ACL for upload. -->
        <acl xmlns="DAV:">
          <ace>
            <principal><authenticated/></principal>
            <grant>
              <privilege><read/></privilege>
            </grant>
          </ace>
        </acl>
        <exclude>filename pattern 1</exclude>
        <exclude>filename pattern 2</exclude>
        <rename/>
        <rename-depth>10<rename-depth>
        <hidden-folder-name>.Hidden<hidden-folder-name>
        <!-- The following two are mutually exclusive. -->
        <recursive/>
        <no-recursion/>
        ...
      </sync>
      ...
    </config>

See RFC 3744 for the ACL syntax.

-e

An optional comma-separated list of filename patterns. Files that match a pattern are excluded from the synchronization. If the string is surrounded by square brackets it is interpreted as a regular expression.

-down|-up|-bi

The synchronization direction. Updates and deletions are propagated to the other side. Server renames may be detected if the ETag header is consistent.

-u

The URL.

-d

The local directory.

-rename

Renames files instead of overwriting them. Files are renamed with suffixes .1, .2 and so on, up to the rename depth. This happens locally as well as on the server.

-rename-depth

The number of versions kept when renaming files.

-hidden-folder

The name of the hidden folder that is created in each folder, locally and on the server, when files or folders have to be deleted. When this option is on they are moved into the hidden folder that is in the same folder.

-reset

Remove the synchronization history prior to the synchronization, which makes it look like an initial synchronization.

Use it as an Ant task through the taskdef element:

  <taskdef
    name="webdav-sync"
    classname="be.re.webdav.cmd.SyncAntTask"
    classpath="<directory>/webdav_sync.jar" />

The Ant task has the following parameters:

directory (mandatory): Corresponds to the -d option.
url (mandatory): Corresponds to the -u option.
direction (mandatory): Can be down, up or bi. It corresponds to the -down, -up and -bi options.
recur: Either true or false. It corresponds to the -r option.
excludes: Corresponds to the -e option.
rename: Corresponds to the -rename option.
rename-depth: Corresponds to the -rename-depth option.
hidden-folder-name: Corresponds to the -hidden-folder option.

The URL might require a username and a password. You can specify it in the URL like this: https://username:password@hostname/.... Note that if the username or the password contain characters that must not appear in the URL at that place, they should be escaped using URI-encoding. For example, @ should be %40, : becomes %3a, etc. See also http://en.wikipedia.org/wiki/Percent-encoding.

A safer method is to configure it with UIVI. On the Settings tab go to the subtab URL Authentications and append a row with the pop-up menu.

A non-compliant server might respond with a Bad Request. This usually means it doesn't support compression, but responds with a 400 instead of a 415, which is what normal content negotiation prescribes. You can add -Dbe.re.http.no-compress to the beginning of the command-line and file a bug report at the provider of your server.

Some servers don't support the 100-continue feature, but fail to report this with a 417 status code. In that case you can add -Dbe.re.http.no-expect100 to the beginning of the command-line.