# HG changeset patch # User Olaf Wintermann # Date 1576425646 -3600 # Node ID 8b88efcbf56f518094d8310728b8503940d58a69 # Parent 2e3a24b9896af4fd30de93f074841e3f01f45c6c update html doc diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/add-directory.html --- a/docs/html/add-directory.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/add-directory.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync add-directory - - + + +
@@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,9 +95,9 @@
    - +

    This command runs an interactive assistant that creates a sync-directory configuration and adds it to the sync.xml file. Before running this command, a repository must be created. See dav add-repository.

    Command alias: add-dir

    The assistant firstly asks for a unique sync-directory name. This may not match the physical directory name. If you are not sure, which names are already in use, you can get a list of currently present sync-directories with dav-sync list-directories. Then you specifiy the local path, select the dav repository and specify the collection within that repository. You may use environment variables like $HOME within the path name. A call of add-directory may look like this.

    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/add-repository.html --- a/docs/html/add-repository.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/add-repository.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav add-repository - - + + +
    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,12 +95,12 @@
    - +

    This command runs an interactive assistant that creates a repository configuration and adds it to the config.xml file.

    Command alias: add-repo

    -

    The assistant firstly asks for a unique repository name. If you are not sure, which names are already in use, you can get a list of currently present repositories with dav list-repositories. Then you specifiy the base URL and optional authentication information. Please keep in mind, that the password is stored base64 encoded in your configuration. If you do not want this to happen, leave the password blank. dav will ask you for the password when accessing the repository. Beware that you don't use password prompt in background jobs, though. A call of add-repository may look like this.

    +

    The assistant firstly asks for a unique repository name. If you are not sure, which names are already in use, you can get a list of currently present repositories with dav list-repositories. Then you specifiy the base URL and optional authentication information. Please keep in mind, that the password is stored base64 encoded in your configuration. If you do not want this to happen, leave the password blank. dav will ask you for the password when accessing the repository. Beware that you don’t use password prompt in background jobs, though. A call of add-repository may look like this.

    $ dav add-repository
     Each repository must have an unique name.
     name: myfirstrepo
    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/add-tag.html
    --- a/docs/html/add-tag.html	Sun Dec 15 16:54:05 2019 +0100
    +++ b/docs/html/add-tag.html	Sun Dec 15 17:00:46 2019 +0100
    @@ -1,12 +1,20 @@
    -
    -
    +
    +
     
    -  
    -  
    +  
       
    +  
       dav-sync add-tag
    -  
    -  
    +  
    +  
    +  
     
     
     
    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,9 +95,9 @@
    - +

    dav-sync add-tag [-s <syncdir>] <file> <tag>

    Adds a tag to a SyncDirectory file. The file argument must be a normal file path. If multiple SyncDirectories contain this file, the SyncDirectory must be specified with the -s option.

    Tags must be enabled for the SyncDirectory. See Configuration for details.

    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/add-user.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/add-user.html Sun Dec 15 17:00:46 2019 +0100 @@ -0,0 +1,106 @@ + + + + + + + dav add-user + + + + + + + + + +
    +
    +

    dav add-user

    +
    +

    This command runs an interactive assistant that adds a user to the secret store. The secret store is an encrypted file, that stores user credentials.

    +

    The assistant firstly asks for the secret store master password. After that, you must specify a unique credentials identifier, the user name and password. Optionally it is possible to specify one or more locations (URLs), where these credentials should be used.

    +
    + + + diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/archive.html --- a/docs/html/archive.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/archive.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync archive - - + + +
    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,16 +95,19 @@
    - -

    dav-sync archive [-cld] [-t <tags>] <directory>

    + +

    dav-sync archive [-cldSRM] [-t <tags>] <directory>

    Uploads all new and modified files to the server. The command is similar to the push command, however it does not delete files on the server.

    If conflict detection is not disabled, all files that are also modified on the server will be skipped.

    -c Disable conflict detection. This always overwrites files on the server

    -l Lock the repository before accessing it. After archive completed, the repository is unlocked

    -

    -d Don't lock the repository (default)

    +

    -d Don’t lock the repository (default)

    -t <tags> Only sync files that match the tag filter expression

    +

    -S Save the previous file version, before replacing it

    +

    -R Upload files, that were deleted on the server since last sync, but still locally available

    +

    -M Upload files, that were modified on the server since last sync

    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/check-config.html --- a/docs/html/check-config.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/check-config.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav check-config - - + + +
    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,9 +95,9 @@
    - +

    Validates the config.xml file. If the config is ok, it prints Configuration OK. to stdout and returns 0, otherwise it prints an error message to stderr and returns 1.

    Command alias: check

    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/check-repositories.html --- a/docs/html/check-repositories.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/check-repositories.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync check-repositories - - + + +
    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,9 +95,9 @@
    - +

    Checks if every repository used by sync-directories is configured and available. This command outputs the status for each repository. It returns zero when all repositories are all available and non-zero otherwise.

    Command alias: check-repos

    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/checkin.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/checkin.html Sun Dec 15 17:00:46 2019 +0100 @@ -0,0 +1,108 @@ + + + + + + + dav checkin + + + + + + + + + +
    +
    +

    dav checkin

    +
    +

    dav checkin [-pc] <url>

    +

    Changes the state of a resource to checked-in. This will create a new version of the resource. In the checked-in state the resource cannot be modified.

    +

    -p disable file name and path decryption if enabled

    +

    -c enable file name and path decryption

    +
    + + + diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/checkout.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/checkout.html Sun Dec 15 17:00:46 2019 +0100 @@ -0,0 +1,108 @@ + + + + + + + dav checkout + + + + + + + + + +
    +
    +

    dav checkout

    +
    +

    dav checkout [-pc] <url>

    +

    Changes the state of a resource to checked-out to allow modifications to the content and properties.

    +

    -p disable file name and path decryption if enabled

    +

    -c enable file name and path decryption

    +
    + + + diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/commands.html --- a/docs/html/commands.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/commands.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + Commands - - + + +
    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,9 +95,9 @@
    - +

    Overview

    List resources:

    dav list <url>
    @@ -92,7 +113,7 @@
    dav copy <src-url> <dst-url>

    There is also a move operation similar to copy:

    dav move <src-url> <dst-url>
    -

    These are the most common commands. There are also more commands, e.g. for webdav locking or manipulating webdav properties. See the left menu for a complete list.

    +

    These are the most common commands. There are also more commands, e.g. for webdav locking or manipulating webdav properties. See the left menu for a complete list.

    Common options

    -N disable any authentication prompt. If authentication is required, dav will abort.

    -i disable TLS certificate verification

    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/configuration.html --- a/docs/html/configuration.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/configuration.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + Configuration - - + + +
    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,10 +95,10 @@
    - -

    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 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>, <namespace>

    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.

    @@ -99,6 +120,10 @@

    A base64 encoded password used for authentication.

    Type: base64 string
    Example: <password>MTIzNDU2Nzg=</password>

    +

    stored-user

    +

    Credentials id used for authentication. The credentials must be stored in the secret store.

    +

    Type: string
    +Example: <stored-user>alice</stored-user>

    default-key

    Identifer of the key used by default for encryption. There must be a configured key with this name.

    Type: string
    @@ -127,7 +152,7 @@

    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.

    +

    Note: This element does the same as curl’s --cacert option.

    verification

    This element can disable TLS certificate verification.

    Type: boolean
    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/copy.html --- a/docs/html/copy.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/copy.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav copy - - + + +

    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,9 +95,9 @@
    - +

    dav 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.

    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/date.html --- a/docs/html/date.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/date.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav date - - + + +
    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,9 +95,9 @@
    - +

    dav date [url]

    The purpose of this command is to get the current date from a server and print it to stdout (HTTP date format). This in useful in combination with the -u option for the list and get command.

    The url can be any http url. If no url is specified, the local time is used.

    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/delete-conflicts.html --- a/docs/html/delete-conflicts.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/delete-conflicts.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync delete-conflicts - - + + +
    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,9 +95,9 @@
    - +

    dav-sync delete-conflicts <directory>

    Deletes all files that are marked as a conflict. This will always delete the files and does not move them to the trash directory.

    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/edit-user.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/edit-user.html Sun Dec 15 17:00:46 2019 +0100 @@ -0,0 +1,105 @@ + + + + + + + dav edit-user + + + + + + + + + +
    +
    +

    dav edit-user

    +
    +

    Interactive command for editing secret store credentials.

    +
    + + + diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/empty-trash.html --- a/docs/html/empty-trash.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/empty-trash.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync empty-trash - - + + +
    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,9 +95,9 @@
    - +

    dav-sync empty-trash <directory>

    Removes all files from the trash directory of the given sync-directory.

    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/encryption.html --- a/docs/html/encryption.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/encryption.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + Encryption - - + + +
    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,11 +95,11 @@
    - +

    The davutils programs have an integrated client-side encryption feature, that allows you to encrypt and decrypt on the fly with AES256 or AES128. To use this feature, the server must support WebDAV dead properties.

    -

    The tools support both, encryption of the resource content and encryption of the resource name. Each resource is encrypted separately. With activated name encryption, the actual resource name is disguised by a random name but the name used by the client is stored encrypted as a WebDAV property. This means, an attacker can see the directory structure and the file length, but can't guess the file names and in particular which files have the same name.

    +

    The tools support both, encryption of the resource content and encryption of the resource name. Each resource is encrypted separately. With activated name encryption, the actual resource name is disguised by a random name but the name used by the client is stored encrypted as a WebDAV property. This means, an attacker can see the directory structure and the file length, but can’t guess the file names and in particular which files have the same name.

    To enable encryption a key must be configured in $HOME/.dav/config.xml. A key must have a unique name. To access encrypted resources, all clients must configure the same key with the same name. Currently a key can only be loaded from a file and not generated from a password.

    A configuration for a key looks like:

    <key>
    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/export.html
    --- a/docs/html/export.html	Sun Dec 15 16:54:05 2019 +0100
    +++ b/docs/html/export.html	Sun Dec 15 17:00:46 2019 +0100
    @@ -1,12 +1,20 @@
    -
    -
    +
    +
     
    -  
    -  
    +  
       
    +  
       dav export
    -  
    -  
    +  
    +  
    +  
     
     
     
    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,9 +95,9 @@
    - +

    dav export [-pc] [-o <file>] [-u <date>] <url>

    Downloads a resource or a collection with all child resources, and writes the contents to an archive file. The Output is written to stdout, unless the -o option is used.

    Currently the only available archive format is the ustar format.

    diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/get-property.html --- a/docs/html/get-property.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/get-property.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav get-property - - + + +
    @@ -26,6 +34,7 @@
  • remove
  • copy
  • move
  • +
  • rename
  • export
  • import
  • get-property
  • @@ -35,9 +44,19 @@
  • unlock
  • info
  • date
  • +
  • versioncontrol
  • +
  • list-versions
  • +
  • checkout
  • +
  • checkin
  • +
  • uncheckout
  • add-repository
  • remove-repository
  • list-repositories
  • +
  • repository-url
  • +
  • add-user
  • +
  • remove-user
  • +
  • edit-user
  • +
  • list-users
  • check-config
  • Configuration
  • @@ -53,11 +72,13 @@
  • pull
  • push
  • archive
  • -
  • list-conflicts
  • +
  • restore
  • +
  • list-conflicts
  • resolve-conflicts
  • delete-conflicts
  • trash-info
  • empty-trash
  • +
  • list-versions
  • add-tag
  • remove-tag
  • set-tags
  • @@ -74,9 +95,9 @@
    - +

    dav get-property [-pcx] [-n <uri>] <url> <property>

    Gets a specific resource property. Every WebDAV property has a name and an XML namespace. A namespace can be specified with the -n option or with a prefixed name. The prefix and property name are separated by a : as usual.

    If the -x option is specified, a valid xml document containing the value is printed on stdout.

    @@ -84,7 +105,7 @@

    Example: D:creationdate

    D is the prefix, creationdate is the name.

    There are only two available prefixes by default:

    -
      +
      1. D for the DAV: namespace
      2. idav for http://davutils.org/
      diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/get.html --- a/docs/html/get.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/get.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav get - - + + +
      @@ -26,6 +34,7 @@
    1. remove
    2. copy
    3. move
    4. +
    5. rename
    6. export
    7. import
    8. get-property
    9. @@ -35,9 +44,19 @@
    10. unlock
    11. info
    12. date
    13. +
    14. versioncontrol
    15. +
    16. list-versions
    17. +
    18. checkout
    19. +
    20. checkin
    21. +
    22. uncheckout
    23. add-repository
    24. remove-repository
    25. list-repositories
    26. +
    27. repository-url
    28. +
    29. add-user
    30. +
    31. remove-user
    32. +
    33. edit-user
    34. +
    35. list-users
    36. check-config
    37. Configuration
    38. @@ -53,11 +72,13 @@
    39. pull
    40. push
    41. archive
    42. -
    43. list-conflicts
    44. +
    45. restore
    46. +
    47. list-conflicts
    48. resolve-conflicts
    49. delete-conflicts
    50. trash-info
    51. empty-trash
    52. +
    53. list-versions
    54. add-tag
    55. remove-tag
    56. set-tags
    57. @@ -74,17 +95,18 @@
      - -

      dav get [-pcRK] [-o <file>] [-u <date>] <url>

      -

      Downloads a resource. This command also downloads collections and its child resources when the -R option is used. 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 its children in there, but it downloads the children directly to the current working directory.

      + +

      dav get [-pcRK] [-o <file>] [-u <date>] [-V <version>] <url>

      +

      Downloads a resource. This command also downloads collections and its child resources when the -R option is used. 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 its children in there, but it downloads the children directly to the current working directory.

      -p disable file name and content decryption. You get exactly what is stored on the server.

      -c enable file name and content decryption

      -R download a collection

      -

      -K download only files that don't exist locally

      +

      -K download only files that don’t exist locally

      -o <file> specify the local output file. A - indicates stdout

      -u <date> download only files which are modified since the specified date. Uses the HTTP date format

      +

      -V <version> downloads a specific version of the resource. Available versions can be listed with the list-versions command

      diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/getting-started.html --- a/docs/html/getting-started.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/getting-started.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + Getting started - - + + +
      @@ -26,6 +34,7 @@
    58. remove
    59. copy
    60. move
    61. +
    62. rename
    63. export
    64. import
    65. get-property
    66. @@ -35,9 +44,19 @@
    67. unlock
    68. info
    69. date
    70. +
    71. versioncontrol
    72. +
    73. list-versions
    74. +
    75. checkout
    76. +
    77. checkin
    78. +
    79. uncheckout
    80. add-repository
    81. remove-repository
    82. list-repositories
    83. +
    84. repository-url
    85. +
    86. add-user
    87. +
    88. remove-user
    89. +
    90. edit-user
    91. +
    92. list-users
    93. check-config
    94. Configuration
    95. @@ -53,11 +72,13 @@
    96. pull
    97. push
    98. archive
    99. -
    100. list-conflicts
    101. +
    102. restore
    103. +
    104. list-conflicts
    105. resolve-conflicts
    106. delete-conflicts
    107. trash-info
    108. empty-trash
    109. +
    110. list-versions
    111. add-tag
    112. remove-tag
    113. set-tags
    114. @@ -74,9 +95,9 @@
      - +

      Test

      After successful installation you can test dav with your WebDAV server.

      dav list http://example.com/webdav/
      diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/import.html --- a/docs/html/import.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/import.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav import - - + + +
      @@ -26,6 +34,7 @@
    115. remove
    116. copy
    117. move
    118. +
    119. rename
    120. export
    121. import
    122. get-property
    123. @@ -35,9 +44,19 @@
    124. unlock
    125. info
    126. date
    127. +
    128. versioncontrol
    129. +
    130. list-versions
    131. +
    132. checkout
    133. +
    134. checkin
    135. +
    136. uncheckout
    137. add-repository
    138. remove-repository
    139. list-repositories
    140. +
    141. repository-url
    142. +
    143. add-user
    144. +
    145. remove-user
    146. +
    147. edit-user
    148. +
    149. list-users
    150. check-config
    151. Configuration
    152. @@ -53,11 +72,13 @@
    153. pull
    154. push
    155. archive
    156. -
    157. list-conflicts
    158. +
    159. restore
    160. +
    161. list-conflicts
    162. resolve-conflicts
    163. delete-conflicts
    164. trash-info
    165. empty-trash
    166. +
    167. list-versions
    168. add-tag
    169. remove-tag
    170. set-tags
    171. @@ -74,9 +95,9 @@
      - +

      dav import [-pc] [-k <key>] [-L <lock>] <url> <file>

      Uploads the content of an archive file to a collection. If the url points to a non-existing collection, the collection is created.

      Currently the only available archive format is the ustar format. You can use tools like tar or the dav export command to create such archives.

      diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/info.html --- a/docs/html/info.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/info.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav info - - + + +
      @@ -26,6 +34,7 @@
    172. remove
    173. copy
    174. move
    175. +
    176. rename
    177. export
    178. import
    179. get-property
    180. @@ -35,9 +44,19 @@
    181. unlock
    182. info
    183. date
    184. +
    185. versioncontrol
    186. +
    187. list-versions
    188. +
    189. checkout
    190. +
    191. checkin
    192. +
    193. uncheckout
    194. add-repository
    195. remove-repository
    196. list-repositories
    197. +
    198. repository-url
    199. +
    200. add-user
    201. +
    202. remove-user
    203. +
    204. edit-user
    205. +
    206. list-users
    207. check-config
    208. Configuration
    209. @@ -53,11 +72,13 @@
    210. pull
    211. push
    212. archive
    213. -
    214. list-conflicts
    215. +
    216. restore
    217. +
    218. list-conflicts
    219. resolve-conflicts
    220. delete-conflicts
    221. trash-info
    222. empty-trash
    223. +
    224. list-versions
    225. add-tag
    226. remove-tag
    227. set-tags
    228. @@ -74,9 +95,9 @@
      - +

      dav info [-pc] <url>

      Prints some information and lists all properties for the resource specified by url.

      Example 1: info of a collection

      diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/introduction.html --- a/docs/html/introduction.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/introduction.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + Introduction to dav-sync - - + + +
      @@ -26,6 +34,7 @@
    229. remove
    230. copy
    231. move
    232. +
    233. rename
    234. export
    235. import
    236. get-property
    237. @@ -35,9 +44,19 @@
    238. unlock
    239. info
    240. date
    241. +
    242. versioncontrol
    243. +
    244. list-versions
    245. +
    246. checkout
    247. +
    248. checkin
    249. +
    250. uncheckout
    251. add-repository
    252. remove-repository
    253. list-repositories
    254. +
    255. repository-url
    256. +
    257. add-user
    258. +
    259. remove-user
    260. +
    261. edit-user
    262. +
    263. list-users
    264. check-config
    265. Configuration
    266. @@ -53,11 +72,13 @@
    267. pull
    268. push
    269. archive
    270. -
    271. list-conflicts
    272. +
    273. restore
    274. +
    275. list-conflicts
    276. resolve-conflicts
    277. delete-conflicts
    278. trash-info
    279. empty-trash
    280. +
    281. list-versions
    282. add-tag
    283. remove-tag
    284. set-tags
    285. @@ -74,9 +95,9 @@
      - +

      The dav-sync program can synchronize a local directory with a WebDAV collection.

      First Steps

      To use dav-sync it is required to configure a repository in config.xml and the directory in sync.xml.

      @@ -114,7 +135,7 @@

      Every sync-directory has a database xml file that contains the etag and last modified date of each file. The etag is used to detect changes on the server and the last modified date is used to detect local changes. The database file is usually located in $HOME/.dav/ and if you want to reset a sync-directory, you can delete the database. After that, pull/push (with disabled conflict detection) will download/upload all files.

      Conflict detection

      The pull and push commands detect if a file has changed remotely and locally. This is a conflict that must be resolved manually.

      -

      When pull detects a conflict it renames the local file to orig-$number.$name where $number is an integer, usually 0 if no other conflict file with the name exists and $name is the file's name. After the file is renamed the new file from the server is downloadet. The user should merge the files manually then or just delete one or keep both. After that run resolve-conflicts to remove all conflict entries from the database otherwise push will ignore any file in a conflict state. There is also the delete-conflicts command that deletes all conflict files.

      +

      When pull detects a conflict it renames the local file to orig-$number.$name where $number is an integer, usually 0 if no other conflict file with the name exists and $name is the file’s name. After the file is renamed the new file from the server is downloadet. The user should merge the files manually then or just delete one or keep both. After that run resolve-conflicts to remove all conflict entries from the database otherwise push will ignore any file in a conflict state. There is also the delete-conflicts command that deletes all conflict files.

      When push detects that a file is modified locally and on the server, it just skips this file. Run the pull command to get the new file from the server and resolve the conflict like described above.

      Trash

      For high data safety, a trash directory can be configured. If this is done, dav-sync will not delete files, but move them to the trash directory. Also the pull command can move files to the trash directory before overwriting them.

      diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/list-conflicts.html --- a/docs/html/list-conflicts.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/list-conflicts.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync list-conflicts - - + + +
      @@ -26,6 +34,7 @@
    286. remove
    287. copy
    288. move
    289. +
    290. rename
    291. export
    292. import
    293. get-property
    294. @@ -35,9 +44,19 @@
    295. unlock
    296. info
    297. date
    298. +
    299. versioncontrol
    300. +
    301. list-versions
    302. +
    303. checkout
    304. +
    305. checkin
    306. +
    307. uncheckout
    308. add-repository
    309. remove-repository
    310. list-repositories
    311. +
    312. repository-url
    313. +
    314. add-user
    315. +
    316. remove-user
    317. +
    318. edit-user
    319. +
    320. list-users
    321. check-config
    322. Configuration
    323. @@ -53,11 +72,13 @@
    324. pull
    325. push
    326. archive
    327. -
    328. list-conflicts
    329. +
    330. restore
    331. +
    332. list-conflicts
    333. resolve-conflicts
    334. delete-conflicts
    335. trash-info
    336. empty-trash
    337. +
    338. list-versions
    339. add-tag
    340. remove-tag
    341. set-tags
    342. @@ -74,12 +95,12 @@
      - +

      dav-sync list-conflicts [-v] <directory>

      Lists all conflicting files. If verbose output is enabled, the output also shows the number of entries for the same conflicting file.

      -

      For each conflict a backup file with the pattern orig.N.filename has been created. You can resolve the conflict by either deleting the backup, or replacing the conflicting file with the backup. In either case you don't need to do anything more and dav-sync will remove the conflict from the database automatically. You can also use the delete-conflicts command to bulk-delete all backups (in case you want to proceed with the upstream version of your files) or the resolve-conflicts command to forcefully clear the conflict database.

      +

      For each conflict a backup file with the pattern orig.N.filename has been created. You can resolve the conflict by either deleting the backup, or replacing the conflicting file with the backup. In either case you don’t need to do anything more and dav-sync will remove the conflict from the database automatically. You can also use the delete-conflicts command to bulk-delete all backups (in case you want to proceed with the upstream version of your files) or the resolve-conflicts command to forcefully clear the conflict database.

      diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/list-directories.html --- a/docs/html/list-directories.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/list-directories.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync list-directories - - + + +
      @@ -26,6 +34,7 @@
    343. remove
    344. copy
    345. move
    346. +
    347. rename
    348. export
    349. import
    350. get-property
    351. @@ -35,9 +44,19 @@
    352. unlock
    353. info
    354. date
    355. +
    356. versioncontrol
    357. +
    358. list-versions
    359. +
    360. checkout
    361. +
    362. checkin
    363. +
    364. uncheckout
    365. add-repository
    366. remove-repository
    367. list-repositories
    368. +
    369. repository-url
    370. +
    371. add-user
    372. +
    373. remove-user
    374. +
    375. edit-user
    376. +
    377. list-users
    378. check-config
    379. Configuration
    380. @@ -53,11 +72,13 @@
    381. pull
    382. push
    383. archive
    384. -
    385. list-conflicts
    386. +
    387. restore
    388. +
    389. list-conflicts
    390. resolve-conflicts
    391. delete-conflicts
    392. trash-info
    393. empty-trash
    394. +
    395. list-versions
    396. add-tag
    397. remove-tag
    398. set-tags
    399. @@ -74,9 +95,9 @@
      - +

      This command lists all configured sync-directories.

      Command alias: list-dirs

      diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/list-repositories.html --- a/docs/html/list-repositories.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/list-repositories.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav list-repositories - - + + +
      @@ -26,6 +34,7 @@
    400. remove
    401. copy
    402. move
    403. +
    404. rename
    405. export
    406. import
    407. get-property
    408. @@ -35,9 +44,19 @@
    409. unlock
    410. info
    411. date
    412. +
    413. versioncontrol
    414. +
    415. list-versions
    416. +
    417. checkout
    418. +
    419. checkin
    420. +
    421. uncheckout
    422. add-repository
    423. remove-repository
    424. list-repositories
    425. +
    426. repository-url
    427. +
    428. add-user
    429. +
    430. remove-user
    431. +
    432. edit-user
    433. +
    434. list-users
    435. check-config
    436. Configuration
    437. @@ -53,11 +72,13 @@
    438. pull
    439. push
    440. archive
    441. -
    442. list-conflicts
    443. +
    444. restore
    445. +
    446. list-conflicts
    447. resolve-conflicts
    448. delete-conflicts
    449. trash-info
    450. empty-trash
    451. +
    452. list-versions
    453. add-tag
    454. remove-tag
    455. set-tags
    456. @@ -74,9 +95,9 @@
      - +

      This command lists all configured repositories.

      Command alias: list-repos

      diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/list-tags.html --- a/docs/html/list-tags.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/list-tags.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync add-tag - - + + +
      @@ -26,6 +34,7 @@
    457. remove
    458. copy
    459. move
    460. +
    461. rename
    462. export
    463. import
    464. get-property
    465. @@ -35,9 +44,19 @@
    466. unlock
    467. info
    468. date
    469. +
    470. versioncontrol
    471. +
    472. list-versions
    473. +
    474. checkout
    475. +
    476. checkin
    477. +
    478. uncheckout
    479. add-repository
    480. remove-repository
    481. list-repositories
    482. +
    483. repository-url
    484. +
    485. add-user
    486. +
    487. remove-user
    488. +
    489. edit-user
    490. +
    491. list-users
    492. check-config
    493. Configuration
    494. @@ -53,11 +72,13 @@
    495. pull
    496. push
    497. archive
    498. -
    499. list-conflicts
    500. +
    501. restore
    502. +
    503. list-conflicts
    504. resolve-conflicts
    505. delete-conflicts
    506. trash-info
    507. empty-trash
    508. +
    509. list-versions
    510. add-tag
    511. remove-tag
    512. set-tags
    513. @@ -74,9 +95,9 @@
      - +

      dav-sync list-tags [-s <syncdir>] <file>

      Lists all file tags.

      Tags must be enabled for the SyncDirectory. See Configuration for details.

      diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/list-users.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/list-users.html Sun Dec 15 17:00:46 2019 +0100 @@ -0,0 +1,105 @@ + + + + + + + dav list-users + + + + + + + + + +
      +
      +

      dav list-users

      +
      +

      The command lists all credentials that are saved in the secret store.

      +
      + + + diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/list-versions.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/list-versions.html Sun Dec 15 17:00:46 2019 +0100 @@ -0,0 +1,108 @@ + + + + + + + dav list-versions + + + + + + + + + +
      +
      +

      dav list-versions

      +
      +

      dav list-versions [-pc] <url>

      +

      Lists all versions of a version-controlled resource.

      +

      -p disable file name and path decryption if enabled

      +

      -c enable file name and path decryption

      +
      + + + diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/list.html --- a/docs/html/list.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/list.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav list - - + + +
      @@ -26,6 +34,7 @@
    514. remove
    515. copy
    516. move
    517. +
    518. rename
    519. export
    520. import
    521. get-property
    522. @@ -35,9 +44,19 @@
    523. unlock
    524. info
    525. date
    526. +
    527. versioncontrol
    528. +
    529. list-versions
    530. +
    531. checkout
    532. +
    533. checkin
    534. +
    535. uncheckout
    536. add-repository
    537. remove-repository
    538. list-repositories
    539. +
    540. repository-url
    541. +
    542. add-user
    543. +
    544. remove-user
    545. +
    546. edit-user
    547. +
    548. list-users
    549. check-config
    550. Configuration
    551. @@ -53,11 +72,13 @@
    552. pull
    553. push
    554. archive
    555. -
    556. list-conflicts
    557. +
    558. restore
    559. +
    560. list-conflicts
    561. resolve-conflicts
    562. delete-conflicts
    563. trash-info
    564. empty-trash
    565. +
    566. list-versions
    567. add-tag
    568. remove-tag
    569. set-tags
    570. @@ -74,18 +95,18 @@
      - +

      dav list [-altdepcR] [-u <date>] <url>

      Lists child resources of the specified collection. Without any option it shows only the direct children and hides files beginning with a dot. The behavior is quite similar to that of the unix tool ls.

      Options

      -

      -a don't hide files whose names begin with a dot .

      +

      -a don’t hide files whose names begin with a dot .

      -l show additional information for resources

      Example:

      --     4.2 KiB  Oct 11  2015  somefile

      The first column contains to fields for flags.

      -
        +
        1. Field: d- indicates a collection
        2. Field: -c indicates an encrypted resource
        @@ -96,7 +117,7 @@

        -t this options only works in combination with -l and it adds the resource content type to the output (after the flags)

        -d order resources by their lastmodified date

        -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.

        -
          +
          1. Field: d--- indicates a collection
          2. Field: -c-- indicates an encrypted resource
          3. Field: --l- indicates a locked resource
          4. diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/lock.html --- a/docs/html/lock.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/lock.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav lock - - + + +
            @@ -26,6 +34,7 @@
          5. remove
          6. copy
          7. move
          8. +
          9. rename
          10. export
          11. import
          12. get-property
          13. @@ -35,9 +44,19 @@
          14. unlock
          15. info
          16. date
          17. +
          18. versioncontrol
          19. +
          20. list-versions
          21. +
          22. checkout
          23. +
          24. checkin
          25. +
          26. uncheckout
          27. add-repository
          28. remove-repository
          29. list-repositories
          30. +
          31. repository-url
          32. +
          33. add-user
          34. +
          35. remove-user
          36. +
          37. edit-user
          38. +
          39. list-users
          40. check-config
          41. Configuration
          42. @@ -53,11 +72,13 @@
          43. pull
          44. push
          45. archive
          46. -
          47. list-conflicts
          48. +
          49. restore
          50. +
          51. list-conflicts
          52. resolve-conflicts
          53. delete-conflicts
          54. trash-info
          55. empty-trash
          56. +
          57. list-versions
          58. add-tag
          59. remove-tag
          60. set-tags
          61. @@ -74,9 +95,9 @@
            - +

            dav lock [-pc] <url>

            Creates a lock on the resource specified by the url. The lock is an exclusive write lock with infinite depth.

            If the resource is successfully locked, a lock token for this resource is printed to stdout. This lock token should be saved somewhere to unlock the resource eventually.

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/mkdir.html --- a/docs/html/mkdir.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/mkdir.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav mkdir - - + + +
            @@ -26,6 +34,7 @@
          62. remove
          63. copy
          64. move
          65. +
          66. rename
          67. export
          68. import
          69. get-property
          70. @@ -35,9 +44,19 @@
          71. unlock
          72. info
          73. date
          74. +
          75. versioncontrol
          76. +
          77. list-versions
          78. +
          79. checkout
          80. +
          81. checkin
          82. +
          83. uncheckout
          84. add-repository
          85. remove-repository
          86. list-repositories
          87. +
          88. repository-url
          89. +
          90. add-user
          91. +
          92. remove-user
          93. +
          94. edit-user
          95. +
          96. list-users
          97. check-config
          98. Configuration
          99. @@ -53,11 +72,13 @@
          100. pull
          101. push
          102. archive
          103. -
          104. list-conflicts
          105. +
          106. restore
          107. +
          108. list-conflicts
          109. resolve-conflicts
          110. delete-conflicts
          111. trash-info
          112. empty-trash
          113. +
          114. list-versions
          115. add-tag
          116. remove-tag
          117. set-tags
          118. @@ -74,9 +95,9 @@
            - +

            dav mkdir [-pc] [-k <key>] [-L <lock>] <url>

            Creates a collection. All intermediate collections are also created as necessary.

            -p disable file name encryption and decryption

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/move.html --- a/docs/html/move.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/move.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav move - - + + +
            @@ -26,6 +34,7 @@
          119. remove
          120. copy
          121. move
          122. +
          123. rename
          124. export
          125. import
          126. get-property
          127. @@ -35,9 +44,19 @@
          128. unlock
          129. info
          130. date
          131. +
          132. versioncontrol
          133. +
          134. list-versions
          135. +
          136. checkout
          137. +
          138. checkin
          139. +
          140. uncheckout
          141. add-repository
          142. remove-repository
          143. list-repositories
          144. +
          145. repository-url
          146. +
          147. add-user
          148. +
          149. remove-user
          150. +
          151. edit-user
          152. +
          153. list-users
          154. check-config
          155. Configuration
          156. @@ -53,11 +72,13 @@
          157. pull
          158. push
          159. archive
          160. -
          161. list-conflicts
          162. +
          163. restore
          164. +
          165. list-conflicts
          166. resolve-conflicts
          167. delete-conflicts
          168. trash-info
          169. empty-trash
          170. +
          171. list-versions
          172. add-tag
          173. remove-tag
          174. set-tags
          175. @@ -74,9 +95,9 @@
            - +

            dav 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.

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/pull.html --- a/docs/html/pull.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/pull.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync pull - - + + +
            @@ -26,6 +34,7 @@
          176. remove
          177. copy
          178. move
          179. +
          180. rename
          181. export
          182. import
          183. get-property
          184. @@ -35,9 +44,19 @@
          185. unlock
          186. info
          187. date
          188. +
          189. versioncontrol
          190. +
          191. list-versions
          192. +
          193. checkout
          194. +
          195. checkin
          196. +
          197. uncheckout
          198. add-repository
          199. remove-repository
          200. list-repositories
          201. +
          202. repository-url
          203. +
          204. add-user
          205. +
          206. remove-user
          207. +
          208. edit-user
          209. +
          210. list-users
          211. check-config
          212. Configuration
          213. @@ -53,11 +72,13 @@
          214. pull
          215. push
          216. archive
          217. -
          218. list-conflicts
          219. +
          220. restore
          221. +
          222. list-conflicts
          223. resolve-conflicts
          224. delete-conflicts
          225. trash-info
          226. empty-trash
          227. +
          228. list-versions
          229. add-tag
          230. remove-tag
          231. set-tags
          232. @@ -74,16 +95,16 @@
            - +

            dav-sync pull [-cldr] [-t <tags>] <directory>

            Pulls all changes from the server. All new or modified files are downloaded and all files deleted on the server are deleted locally. If a file is also locally modified and conflict detection is not disabled, the local file is renamed and an entry in the conflict database is added.

            When a trash directory is configured for the SyncDirectory, all files that would be deleted are instead moved to the trash directory.

            When backup-on-pull is enabled for the SyncDirectory, all files that would be overwritten are also moved to the trash.

            -c Disable conflict detection. This always overwrites locally modified files

            -l Lock the repository before accessing it. After pull completed, the repository is unlocked

            -

            -d Don't lock the repository (default)

            +

            -d Don’t lock the repository (default)

            -t <tags> Only sync files that match the tag filter expression

            -r Delete files not matching the tag filter

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/push.html --- a/docs/html/push.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/push.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync push - - + + +
            @@ -26,6 +34,7 @@
          233. remove
          234. copy
          235. move
          236. +
          237. rename
          238. export
          239. import
          240. get-property
          241. @@ -35,9 +44,19 @@
          242. unlock
          243. info
          244. date
          245. +
          246. versioncontrol
          247. +
          248. list-versions
          249. +
          250. checkout
          251. +
          252. checkin
          253. +
          254. uncheckout
          255. add-repository
          256. remove-repository
          257. list-repositories
          258. +
          259. repository-url
          260. +
          261. add-user
          262. +
          263. remove-user
          264. +
          265. edit-user
          266. +
          267. list-users
          268. check-config
          269. Configuration
          270. @@ -53,11 +72,13 @@
          271. pull
          272. push
          273. archive
          274. -
          275. list-conflicts
          276. +
          277. restore
          278. +
          279. list-conflicts
          280. resolve-conflicts
          281. delete-conflicts
          282. trash-info
          283. empty-trash
          284. +
          285. list-versions
          286. add-tag
          287. remove-tag
          288. set-tags
          289. @@ -74,17 +95,20 @@
            - -

            dav-sync push [-cldr] [-t <tags>] <directory>

            + +

            dav-sync push [-cldrSRM] [-t <tags>] <directory>

            Pushes all local changes to the server. This uploads all locally modified files and deletes all locally deleted files on the server.

            If conflict detection is not disabled, all files that are also modified on the server will be skipped.

            -c Disable conflict detection. This always overwrites files on the server

            -l Lock the repository before accessing it. After push completed, the repository is unlocked

            -

            -d Don't lock the repository (default)

            +

            -d Don’t lock the repository (default)

            -t <tags> Only sync files that match the tag filter expression

            -r Remove resources not matching the tag filter

            +

            -S Save the previous file version, before replacing it

            +

            -R Upload files, that were deleted on the server since last sync, but still locally available

            +

            -M Upload files, that were modified on the server since last sync

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/put.html --- a/docs/html/put.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/put.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav put - - + + +
            @@ -26,6 +34,7 @@
          290. remove
          291. copy
          292. move
          293. +
          294. rename
          295. export
          296. import
          297. get-property
          298. @@ -35,9 +44,19 @@
          299. unlock
          300. info
          301. date
          302. +
          303. versioncontrol
          304. +
          305. list-versions
          306. +
          307. checkout
          308. +
          309. checkin
          310. +
          311. uncheckout
          312. add-repository
          313. remove-repository
          314. list-repositories
          315. +
          316. repository-url
          317. +
          318. add-user
          319. +
          320. remove-user
          321. +
          322. edit-user
          323. +
          324. list-users
          325. check-config
          326. Configuration
          327. @@ -53,11 +72,13 @@
          328. pull
          329. push
          330. archive
          331. -
          332. list-conflicts
          333. +
          334. restore
          335. +
          336. list-conflicts
          337. resolve-conflicts
          338. delete-conflicts
          339. trash-info
          340. empty-trash
          341. +
          342. list-versions
          343. add-tag
          344. remove-tag
          345. set-tags
          346. @@ -74,11 +95,11 @@
            - +

            dav put [-pcR] [-k <key>] [-L <lock>] <url> <file>

            -

            Uploads a file or a directory. When uploading a file while 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.

            +

            Uploads a file or a directory. When uploading a file while 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.

            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. You may use dav mkdir to create this collection beforehand.

            -p disable file name encryption and decryption

            -c enable file name and content encryption

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/remove-property.html --- a/docs/html/remove-property.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/remove-property.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav remove-property - - + + +
            @@ -26,6 +34,7 @@
          347. remove
          348. copy
          349. move
          350. +
          351. rename
          352. export
          353. import
          354. get-property
          355. @@ -35,9 +44,19 @@
          356. unlock
          357. info
          358. date
          359. +
          360. versioncontrol
          361. +
          362. list-versions
          363. +
          364. checkout
          365. +
          366. checkin
          367. +
          368. uncheckout
          369. add-repository
          370. remove-repository
          371. list-repositories
          372. +
          373. repository-url
          374. +
          375. add-user
          376. +
          377. remove-user
          378. +
          379. edit-user
          380. +
          381. list-users
          382. check-config
          383. Configuration
          384. @@ -53,11 +72,13 @@
          385. pull
          386. push
          387. archive
          388. -
          389. list-conflicts
          390. +
          391. restore
          392. +
          393. list-conflicts
          394. resolve-conflicts
          395. delete-conflicts
          396. trash-info
          397. empty-trash
          398. +
          399. list-versions
          400. add-tag
          401. remove-tag
          402. set-tags
          403. @@ -74,9 +95,9 @@
            - +

            dav remove-property [-pc] [-n <uri>] <url> <property>

            Deletes a specific resource property.

            property is a property name with or without prefix (see get-property for details).

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/remove-repository.html --- a/docs/html/remove-repository.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/remove-repository.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav remove-repository - - + + +
            @@ -26,6 +34,7 @@
          404. remove
          405. copy
          406. move
          407. +
          408. rename
          409. export
          410. import
          411. get-property
          412. @@ -35,9 +44,19 @@
          413. unlock
          414. info
          415. date
          416. +
          417. versioncontrol
          418. +
          419. list-versions
          420. +
          421. checkout
          422. +
          423. checkin
          424. +
          425. uncheckout
          426. add-repository
          427. remove-repository
          428. list-repositories
          429. +
          430. repository-url
          431. +
          432. add-user
          433. +
          434. remove-user
          435. +
          436. edit-user
          437. +
          438. list-users
          439. check-config
          440. Configuration
          441. @@ -53,11 +72,13 @@
          442. pull
          443. push
          444. archive
          445. -
          446. list-conflicts
          447. +
          448. restore
          449. +
          450. list-conflicts
          451. resolve-conflicts
          452. delete-conflicts
          453. trash-info
          454. empty-trash
          455. +
          456. list-versions
          457. add-tag
          458. remove-tag
          459. set-tags
          460. @@ -74,9 +95,9 @@
            - +

            dav remove-repository <reponame>

            This command removes a repository from the config.xml file.

            Command alias: remove-repo, rm-repo

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/remove-tag.html --- a/docs/html/remove-tag.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/remove-tag.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync add-tag - - + + +
            @@ -26,6 +34,7 @@
          461. remove
          462. copy
          463. move
          464. +
          465. rename
          466. export
          467. import
          468. get-property
          469. @@ -35,9 +44,19 @@
          470. unlock
          471. info
          472. date
          473. +
          474. versioncontrol
          475. +
          476. list-versions
          477. +
          478. checkout
          479. +
          480. checkin
          481. +
          482. uncheckout
          483. add-repository
          484. remove-repository
          485. list-repositories
          486. +
          487. repository-url
          488. +
          489. add-user
          490. +
          491. remove-user
          492. +
          493. edit-user
          494. +
          495. list-users
          496. check-config
          497. Configuration
          498. @@ -53,11 +72,13 @@
          499. pull
          500. push
          501. archive
          502. -
          503. list-conflicts
          504. +
          505. restore
          506. +
          507. list-conflicts
          508. resolve-conflicts
          509. delete-conflicts
          510. trash-info
          511. empty-trash
          512. +
          513. list-versions
          514. add-tag
          515. remove-tag
          516. set-tags
          517. @@ -74,9 +95,9 @@
            - +

            dav-sync remove-tag [-s <syncdir>] <file> <tag>

            Removes a tag from a SyncDirectory file.

            Tags must be enabled for the SyncDirectory. See Configuration for details.

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/remove-user.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/remove-user.html Sun Dec 15 17:00:46 2019 +0100 @@ -0,0 +1,105 @@ + + + + + + + dav remove-user + + + + + + + + + +
            +
            +

            dav remove-user

            +
            +

            Interactive command for removing secret store credentials.

            +
            + + + diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/remove.html --- a/docs/html/remove.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/remove.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav remove - - + + +
            @@ -26,6 +34,7 @@
          518. remove
          519. copy
          520. move
          521. +
          522. rename
          523. export
          524. import
          525. get-property
          526. @@ -35,9 +44,19 @@
          527. unlock
          528. info
          529. date
          530. +
          531. versioncontrol
          532. +
          533. list-versions
          534. +
          535. checkout
          536. +
          537. checkin
          538. +
          539. uncheckout
          540. add-repository
          541. remove-repository
          542. list-repositories
          543. +
          544. repository-url
          545. +
          546. add-user
          547. +
          548. remove-user
          549. +
          550. edit-user
          551. +
          552. list-users
          553. check-config
          554. Configuration
          555. @@ -53,11 +72,13 @@
          556. pull
          557. push
          558. archive
          559. -
          560. list-conflicts
          561. +
          562. restore
          563. +
          564. list-conflicts
          565. resolve-conflicts
          566. delete-conflicts
          567. trash-info
          568. empty-trash
          569. +
          570. list-versions
          571. add-tag
          572. remove-tag
          573. set-tags
          574. @@ -74,9 +95,9 @@
            - +

            dav remove [-pc] [-L <lock>] <url>

            Removes a resource. When removing a collection, all child resources are also removed.

            -p disable file name and path decryption if enabled

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/rename.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/rename.html Sun Dec 15 17:00:46 2019 +0100 @@ -0,0 +1,111 @@ + + + + + + + dav rename + + + + + + + + + +
            +
            +

            dav rename

            +
            +

            rename [-pcO] [-L <lock>] <url> <name>

            +

            Changes the name of a resource to name.

            +

            In case of unencrypted resources, this will do a MOVE-Request. On encrypted resources, this command will do a PROPPATCH-Request, changing the crypto-name property.

            +

            -p disable file name and path decryption for url

            +

            -c enable file name and path decryption for url

            +

            -O overwrite the destination resource

            +

            -L <lock> use a lock token. See dav lock

            +
            + + + diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/repository-url.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/repository-url.html Sun Dec 15 17:00:46 2019 +0100 @@ -0,0 +1,108 @@ + + + + + + + dav repository-url + + + + + + + + + +
            +
            +

            dav repository-url

            +
            +

            Prints the url of an repository.

            +

            dav repository-url [-p] <name>

            +

            -p don’t include user and password in the url

            +

            Command alias: repo-url

            +
            + + + diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/resolve-conflicts.html --- a/docs/html/resolve-conflicts.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/resolve-conflicts.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync resolve-conflicts - - + + +
            @@ -26,6 +34,7 @@
          575. remove
          576. copy
          577. move
          578. +
          579. rename
          580. export
          581. import
          582. get-property
          583. @@ -35,9 +44,19 @@
          584. unlock
          585. info
          586. date
          587. +
          588. versioncontrol
          589. +
          590. list-versions
          591. +
          592. checkout
          593. +
          594. checkin
          595. +
          596. uncheckout
          597. add-repository
          598. remove-repository
          599. list-repositories
          600. +
          601. repository-url
          602. +
          603. add-user
          604. +
          605. remove-user
          606. +
          607. edit-user
          608. +
          609. list-users
          610. check-config
          611. Configuration
          612. @@ -53,11 +72,13 @@
          613. pull
          614. push
          615. archive
          616. -
          617. list-conflicts
          618. +
          619. restore
          620. +
          621. list-conflicts
          622. resolve-conflicts
          623. delete-conflicts
          624. trash-info
          625. empty-trash
          626. +
          627. list-versions
          628. add-tag
          629. remove-tag
          630. set-tags
          631. @@ -74,9 +95,9 @@
            - +

            dav-sync resolve-conflicts <directory>

            Forcefully clears the conflict database. This does not merge any files. All files which are marked as conflict are normal files after running this command and will be uploaded at the next push. In other words: by executing this command you assert that you have resolved the conflicts. Usually you will not need this command.

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/restore.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/restore.html Sun Dec 15 17:00:46 2019 +0100 @@ -0,0 +1,112 @@ + + + + + + + dav-sync restore + + + + + + + + + +
            +
            +

            dav-sync restore

            +
            +

            dav-sync restore [-ldRM] [-V <version>] [-s <directory>] [file...]

            +

            Restores local files by downloading them from the server. The file argument can be a local absolute or relative file path.

            +

            If no files are specified, a sync directory must be specified with the -s option.

            +

            -l Lock the repository before accessing it. After restore completed, the repository is unlocked

            +

            -d Don’t lock the repository (default)

            +

            -R Restore only files, that were locally removed

            +

            -M Restore only files, that were locally modified

            +

            -V <version> Restore a specific file version. version must be the version name listed by dav-sync list-versions

            +
            + + + diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/set-property.html --- a/docs/html/set-property.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/set-property.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav set-property - - + + +
            @@ -26,6 +34,7 @@
          632. remove
          633. copy
          634. move
          635. +
          636. rename
          637. export
          638. import
          639. get-property
          640. @@ -35,9 +44,19 @@
          641. unlock
          642. info
          643. date
          644. +
          645. versioncontrol
          646. +
          647. list-versions
          648. +
          649. checkout
          650. +
          651. checkin
          652. +
          653. uncheckout
          654. add-repository
          655. remove-repository
          656. list-repositories
          657. +
          658. repository-url
          659. +
          660. add-user
          661. +
          662. remove-user
          663. +
          664. edit-user
          665. +
          666. list-users
          667. check-config
          668. Configuration
          669. @@ -53,11 +72,13 @@
          670. pull
          671. push
          672. archive
          673. -
          674. list-conflicts
          675. +
          676. restore
          677. +
          678. list-conflicts
          679. resolve-conflicts
          680. delete-conflicts
          681. trash-info
          682. empty-trash
          683. +
          684. list-versions
          685. add-tag
          686. remove-tag
          687. set-tags
          688. @@ -74,9 +95,9 @@
            - +

            dav set-property [-pc] [-L <lock>] [-n <uri>] <url> <property> [value]

            Sets a resource property to the specified value.

            property is a property name with or without prefix (see get-property for details).

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/set-tags.html --- a/docs/html/set-tags.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/set-tags.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync add-tag - - + + +
            @@ -26,6 +34,7 @@
          689. remove
          690. copy
          691. move
          692. +
          693. rename
          694. export
          695. import
          696. get-property
          697. @@ -35,9 +44,19 @@
          698. unlock
          699. info
          700. date
          701. +
          702. versioncontrol
          703. +
          704. list-versions
          705. +
          706. checkout
          707. +
          708. checkin
          709. +
          710. uncheckout
          711. add-repository
          712. remove-repository
          713. list-repositories
          714. +
          715. repository-url
          716. +
          717. add-user
          718. +
          719. remove-user
          720. +
          721. edit-user
          722. +
          723. list-users
          724. check-config
          725. Configuration
          726. @@ -53,11 +72,13 @@
          727. pull
          728. push
          729. archive
          730. -
          731. list-conflicts
          732. +
          733. restore
          734. +
          735. list-conflicts
          736. resolve-conflicts
          737. delete-conflicts
          738. trash-info
          739. empty-trash
          740. +
          741. list-versions
          742. add-tag
          743. remove-tag
          744. set-tags
          745. @@ -74,9 +95,9 @@
            - +

            dav-sync set-tags [-s <syncdir>] <file> [tags]

            Sets all tags for a SyncDirectory file. The file argument must be a normal file path. If multiple SyncDirectories contain this file, the SyncDirectory must be specified with the -s option.

            If no tags are specified, all tags are removed from this file.

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/sync-check-config.html --- a/docs/html/sync-check-config.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/sync-check-config.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync check-config - - + + +
            @@ -26,6 +34,7 @@
          746. remove
          747. copy
          748. move
          749. +
          750. rename
          751. export
          752. import
          753. get-property
          754. @@ -35,9 +44,19 @@
          755. unlock
          756. info
          757. date
          758. +
          759. versioncontrol
          760. +
          761. list-versions
          762. +
          763. checkout
          764. +
          765. checkin
          766. +
          767. uncheckout
          768. add-repository
          769. remove-repository
          770. list-repositories
          771. +
          772. repository-url
          773. +
          774. add-user
          775. +
          776. remove-user
          777. +
          778. edit-user
          779. +
          780. list-users
          781. check-config
          782. Configuration
          783. @@ -53,11 +72,13 @@
          784. pull
          785. push
          786. archive
          787. -
          788. list-conflicts
          789. +
          790. restore
          791. +
          792. list-conflicts
          793. resolve-conflicts
          794. delete-conflicts
          795. trash-info
          796. empty-trash
          797. +
          798. list-versions
          799. add-tag
          800. remove-tag
          801. set-tags
          802. @@ -74,9 +95,9 @@
            - +

            Validates the sync.xml file. If the configuration is OK, it prints Configuration OK. to stdout and returns 0, otherwise it prints an error message to stderr and returns 1.

            Command alias: check

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/sync-commands.html --- a/docs/html/sync-commands.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/sync-commands.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + Commands - - + + +
            @@ -26,6 +34,7 @@
          803. remove
          804. copy
          805. move
          806. +
          807. rename
          808. export
          809. import
          810. get-property
          811. @@ -35,9 +44,19 @@
          812. unlock
          813. info
          814. date
          815. +
          816. versioncontrol
          817. +
          818. list-versions
          819. +
          820. checkout
          821. +
          822. checkin
          823. +
          824. uncheckout
          825. add-repository
          826. remove-repository
          827. list-repositories
          828. +
          829. repository-url
          830. +
          831. add-user
          832. +
          833. remove-user
          834. +
          835. edit-user
          836. +
          837. list-users
          838. check-config
          839. Configuration
          840. @@ -53,11 +72,13 @@
          841. pull
          842. push
          843. archive
          844. -
          845. list-conflicts
          846. +
          847. restore
          848. +
          849. list-conflicts
          850. resolve-conflicts
          851. delete-conflicts
          852. trash-info
          853. empty-trash
          854. +
          855. list-versions
          856. add-tag
          857. remove-tag
          858. set-tags
          859. @@ -74,9 +95,9 @@
            - +

            All commands expect a <directory> argument, which is the identifer of a local directory that should be synchronized. The directory must be configured in sync.xml. See Configuration.

            Common Commands

            Get resources from the server, which are modified since last sync:

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/sync-configuration.html --- 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 @@ - - + + - - + + Configuration - - + + +
            @@ -26,6 +34,7 @@
          860. remove
          861. copy
          862. move
          863. +
          864. rename
          865. export
          866. import
          867. get-property
          868. @@ -35,9 +44,19 @@
          869. unlock
          870. info
          871. date
          872. +
          873. versioncontrol
          874. +
          875. list-versions
          876. +
          877. checkout
          878. +
          879. checkin
          880. +
          881. uncheckout
          882. add-repository
          883. remove-repository
          884. list-repositories
          885. +
          886. repository-url
          887. +
          888. add-user
          889. +
          890. remove-user
          891. +
          892. edit-user
          893. +
          894. list-users
          895. check-config
          896. Configuration
          897. @@ -53,11 +72,13 @@
          898. pull
          899. push
          900. archive
          901. -
          902. list-conflicts
          903. +
          904. restore
          905. +
          906. list-conflicts
          907. resolve-conflicts
          908. delete-conflicts
          909. trash-info
          910. empty-trash
          911. +
          912. list-versions
          913. add-tag
          914. remove-tag
          915. set-tags
          916. @@ -74,15 +95,15 @@
            - +

            The file $HOME/.dav/sync.xml is used for configuring sync-directories.

            The sync.xml file is an XML file with <configuration> as root element. This element can only have <directory> elements as children.

            directory

            This element configures a sync-directory. A sync-directory must have a unique name, a (local) path, repository and a database.

            Required elements: <name>, <repository>, <path>, <database>
            -Optional elements: <collection>, <trash>, <max-retry>, <backup-on-pull>, <lock-pull>, <lock-push>, <lock-timeout>, <filter>

            +Optional elements: <collection>, <trash>, <max-retry>, <backup-on-pull>, <lock-pull>, <lock-push>, <lock-timeout>, <filter>, <metadata>, <versioning>, <splitconfig>, <symlink-intern>, <symlink-extern>, <tagconfig>, <allow-cmd>

            name

            Unique sync-directory identifer. This identifer is used in combination with all dav-sync commands.

            Type: string
            @@ -106,10 +127,19 @@

            Type: string
            Default: /
            Example: <collection>/myfiles</collection>

            +

            hashing

            +

            Enables file hashing. The hash will be used for checking if files are modified and should be synchronized.

            +

            Type: boolean
            +Default: false
            +Example: <hashing>true</hashing>

            trash

            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.

            Type: string
            Example: <trash>.trash</trash>

            +

            push-strategy

            +

            Controls the strategy push uses for deciding which files should be pushed. Possible values are: metadata and hash.

            +

            Type: pushstrategy enum
            +Default: metadata Example: <push-strategy>hash</push-strategy>

            max-retry

            This integer value controls how many attempts of downloading/uploading a file in case of an error are made.

            Type: integer
            @@ -131,10 +161,37 @@ Default: false
            Example: <lock-push>true</lock-push>

            lock-timeout

            -

            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.

            +

            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.

            Type: integer
            Default: 0
            Example: <lock-timeout>50</lock-timeout>

            +

            metadata

            +

            Controls which file metadata should be synchronized. Possible values are: mtime, mode, xattr and all. If this element is not specified, no metadata will be synchronized.

            +

            Type: list of metadata
            +Example: <metadata>mtime mode</metadata>

            +

            versioning

            +

            Enables resource versioning for the commands push and archive.

            +

            Possible attributes: type, always

            +

            The attribute type sets the versioning method type. Possible values are simple and deltav. With simple versioning, resources are moved to a version history collection before the new content is uploaded. With deltav, the DeltaV methods checkout and checkin are used to store versions. The default value of the type attribute is simple.

            +

            The boolean attribute always specifies if new versions should be always created. The default value is false.

            +

            Optional elements: <history> Example: <versioning type="simple" always="true" />

            +

            history

            +

            Specifies the history collection path for simple versioning. The path is interpreted relatively to the root of the sync directory.

            +

            Type: string
            +Default: /.dav-version-history Example:

            +
            <versioning type="simple">
            +    <history>/.backup/</history>
            +</versioning>
            + +

            Configures the handling of symlinks, which have a target inside the sync directory. Possible values are: sync, follow and ignore.

            +

            Type: symlink enum
            +Default: follow
            +Example: <symlink-intern>sync</symlink-intern>

            + +

            Configures the handling of symlinks, which have a target outside the sync directory. Possible values are: follow and ignore. Unlike internal symlinks, external symlinks cannot be synced.

            +

            Type: symlink enum
            +Default: follow
            +Example: <symlink-extern>ignore</symlink-extern>

            tagconfig

            Configures the local store for resource tags. If this element is specified, resource tags are stored locally.

            Optional elements: local-store, detect-changes, xattr-name, on-conflict

            @@ -159,6 +216,34 @@

            Type: onconflict enum
            Default: no_conflict
            Example: <on-conflict>merge</on-conflict>

            +

            splitconfig

            +

            Parent element for all <split> elements.

            +

            split

            +

            Configures if and how files should be splitted into multiple parts on push.

            +

            The blocksize element configures the size of each part.

            +

            The elements filter and minsize specify, in which case the files should be splitted.

            +

            Required elements: <blocksize>
            +Optional elements: <filter>, <minsize>

            +

            Example:

            +
            <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>
            +

            blocksize

            +

            Specifies the size of each file part.

            +

            Type: size
            +Example: <blocksize>100k</blocksize>

            +

            minsize

            +

            Specifies the minimal size a file must have for enabling file splitting.

            +

            Type: size
            +Default: 0
            +Example: <minsize>100m</minsize>

            filter

            With the filter element, include and exclude filters can be specified, to control which files are synchronized. The pull, push and archive 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.

            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.

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/sync-list-versions.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/sync-list-versions.html Sun Dec 15 17:00:46 2019 +0100 @@ -0,0 +1,120 @@ + + + + + + + dav-sync list-versions + + + + + + + + + +
            +
            +

            dav-sync list-versions

            +
            +

            dav-sync list-versions [-s <syncdir>] <file>

            +

            Lists all available versions of a SyncDirectory file. Example:

            +
            $ dav-sync list-versions test.txt
            +name: 1576420562-69ba29c77659c2db
            +lastmodified: Sun, 15 Dec 2019 10:39:30 GMT
            +url: https://example.com/webdav/.history/157/1576420562-69ba29c77659c2db
            +
            +name: 1576420572-b6a1862b0b1c04e6
            +lastmodified: Sun, 15 Dec 2019 11:12:28 GMT
            +url: https://example.com/webdav/.history/157/1576420572-b6a1862b0b1c04e6
            +
            +name: 1576420613-8b1260a7a6943580
            +lastmodified: Sun, 15 Dec 2019 15:33:06 GMT
            +url: https://example.com/webdav/.history/157/1576420613-8b1260a7a6943580
            +

            The name of a version can be used to restore a previous file version with the dav-sync restore command.

            +

            -s <syncdir> SyncDirectory for this file

            +
            + + + diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/trash-info.html --- a/docs/html/trash-info.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/trash-info.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav-sync trash-info - - + + +
            @@ -26,6 +34,7 @@
          917. remove
          918. copy
          919. move
          920. +
          921. rename
          922. export
          923. import
          924. get-property
          925. @@ -35,9 +44,19 @@
          926. unlock
          927. info
          928. date
          929. +
          930. versioncontrol
          931. +
          932. list-versions
          933. +
          934. checkout
          935. +
          936. checkin
          937. +
          938. uncheckout
          939. add-repository
          940. remove-repository
          941. list-repositories
          942. +
          943. repository-url
          944. +
          945. add-user
          946. +
          947. remove-user
          948. +
          949. edit-user
          950. +
          951. list-users
          952. check-config
          953. Configuration
          954. @@ -53,11 +72,13 @@
          955. pull
          956. push
          957. archive
          958. -
          959. list-conflicts
          960. +
          961. restore
          962. +
          963. list-conflicts
          964. resolve-conflicts
          965. delete-conflicts
          966. trash-info
          967. empty-trash
          968. +
          969. list-versions
          970. add-tag
          971. remove-tag
          972. set-tags
          973. @@ -74,9 +95,9 @@
            - +

            dav-sync trash-info <directory>

            Shows the trash directory path for a sync-directory, the number of files currently in trash and the space they consume.

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/uncheckout.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/uncheckout.html Sun Dec 15 17:00:46 2019 +0100 @@ -0,0 +1,108 @@ + + + + + + + dav uncheckout + + + + + + + + + +
            +
            +

            dav uncheckout

            +
            +

            dav uncheckout [-pc] <url>

            +

            Cancels all modification of the resource and sets the state to checked-in without creating a new version.

            +

            -p disable file name and path decryption if enabled

            +

            -c enable file name and path decryption

            +
            + + + diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/unlock.html --- a/docs/html/unlock.html Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/html/unlock.html Sun Dec 15 17:00:46 2019 +0100 @@ -1,12 +1,20 @@ - - + + - - + + dav unlock - - + + +
            @@ -26,6 +34,7 @@
          974. remove
          975. copy
          976. move
          977. +
          978. rename
          979. export
          980. import
          981. get-property
          982. @@ -35,9 +44,19 @@
          983. unlock
          984. info
          985. date
          986. +
          987. versioncontrol
          988. +
          989. list-versions
          990. +
          991. checkout
          992. +
          993. checkin
          994. +
          995. uncheckout
          996. add-repository
          997. remove-repository
          998. list-repositories
          999. +
          1000. repository-url
          1001. +
          1002. add-user
          1003. +
          1004. remove-user
          1005. +
          1006. edit-user
          1007. +
          1008. list-users
          1009. check-config
          1010. Configuration
          1011. @@ -53,11 +72,13 @@
          1012. pull
          1013. push
          1014. archive
          1015. -
          1016. list-conflicts
          1017. +
          1018. restore
          1019. +
          1020. list-conflicts
          1021. resolve-conflicts
          1022. delete-conflicts
          1023. trash-info
          1024. empty-trash
          1025. +
          1026. list-versions
          1027. add-tag
          1028. remove-tag
          1029. set-tags
          1030. @@ -74,9 +95,9 @@
            - +

            dav unlock [-pc] [-L <lock>] <url>

            Unlocks the specified url with a lock token. If no lock token is specified with the -L option, it read from stdin.

            -p disable file name and path decryption if enabled

            diff -r 2e3a24b9896a -r 8b88efcbf56f docs/html/versioncontrol.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/html/versioncontrol.html Sun Dec 15 17:00:46 2019 +0100 @@ -0,0 +1,109 @@ + + + + + + + dav versioncontrol + + + + + + + + + +
            +
            +

            dav versioncontrol

            +
            +

            dav versioncontrol [-pc] <url>

            +

            Puts the resource, specified by url, under version control. This is required in order to use other versioning commands with this resource.

            +

            To use this command, the server must support DeltaV.

            +

            -p disable file name and path decryption if enabled

            +

            -c enable file name and path decryption

            +
            + + + diff -r 2e3a24b9896a -r 8b88efcbf56f docs/man/dav-sync.1.man --- a/docs/man/dav-sync.1.man Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/man/dav-sync.1.man Sun Dec 15 17:00:46 2019 +0100 @@ -1,6 +1,6 @@ -.\" Automatically generated by Pandoc 1.19.2.4 +.\" Automatically generated by Pandoc 2.2.1 .\" -.TH "DAV\-SYNC" "1" "July 1, 2018" "Version 1.2" "DavUtils User Manuals" +.TH "DAV\-SYNC" "1" "December 15, 2019" "Version 1.3" "DavUtils User Manuals" .hy .SH NAME .PP @@ -9,7 +9,7 @@ .SH SYNOPSIS .PP \f[B]dav\-sync\f[] \f[I]command\f[] [\f[I]options\f[]] -\f[I]arguments\f[]... +\f[I]arguments\f[]\&... .SH DESCRIPTION .PP TODO @@ -25,7 +25,7 @@ .RS .RE .TP -.B push [\f[B]\-cldr\f[]] [\f[B]\-t\f[] \f[I]tags\f[]] \f[I]directory\f[] +.B push [\f[B]\-cldrSRM\f[]] [\f[B]\-t\f[] \f[I]tags\f[]] \f[I]directory\f[] Pushes all local changes to the server. This uploads all locally modified files and deletes all locally deleted files on the server. @@ -34,13 +34,20 @@ .RS .RE .TP -.B archive [\f[B]\-cld\f[]] [\f[B]\-t\f[] \f[I]tags\f[]] \f[I]directory\f[] +.B archive [\f[B]\-cldSRM\f[]] [\f[B]\-t\f[] \f[I]tags\f[]] \f[I]directory\f[] Uploads all new and modified files to the server. The command is similar to the push command (with the same conflict behavior), however it does not delete files on the server. .RS .RE .TP +.B restore [\f[B]\-ldRM\f[]] [\f[B]\-V\f[] *version] [\f[B]\-s\f[] \f[I]directory\f[]] [\f[I]file\&...\f[]] +Restores local files by downloading them from the server. +The \f[I]file\f[] argument can be a local absolute or relative file +path. +.RS +.RE +.TP .B list\-conflicts [\f[B]\-v\f[]] \f[I]directory\f[] Lists all conflicting files. If verbose output is enabled, the output also shows the number of @@ -73,6 +80,11 @@ .RS .RE .TP +.B list\-versions [\f[B]\-s\f[] \f[I]syncdir\f[]] \f[I]file\f[] +Lists all available file versions. +.RS +.RE +.TP .B empty\-trash \f[I]directory\f[] Removes all files from the trash of the given \f[I]directory\f[]. .RS @@ -142,7 +154,7 @@ .RE .TP .B \-d -Don\[aq]t lock the repository. +Don't lock the repository. .RS .RE .TP diff -r 2e3a24b9896a -r 8b88efcbf56f docs/man/dav.1.man --- a/docs/man/dav.1.man Sun Dec 15 16:54:05 2019 +0100 +++ b/docs/man/dav.1.man Sun Dec 15 17:00:46 2019 +0100 @@ -1,13 +1,13 @@ -.\" Automatically generated by Pandoc 1.16.0.2 +.\" Automatically generated by Pandoc 2.2.1 .\" -.TH "DAV" "1" "July 1, 2018" "Version 1.2" "DavUtils User Manuals" +.TH "DAV" "1" "December 15, 2019" "Version 1.3" "DavUtils User Manuals" .hy .SH NAME .PP \f[B]dav\f[] \- command line WebDAV client .SH SYNOPSIS .PP -\f[B]dav\f[] \f[I]command\f[] [\f[I]options\f[]] \f[I]arguments\f[]... +\f[B]dav\f[] \f[I]command\f[] [\f[I]options\f[]] \f[I]arguments\f[]\&... .SH DESCRIPTION .PP TODO @@ -18,7 +18,7 @@ .RS .RE .TP -.B get [\f[B]\-pcRK\f[]] [\f[B]\-o\f[] \f[I]file\f[]] [\f[B]\-u\f[] \f[I]date\f[]] \f[I]url\f[] +.B get [\f[B]\-pcRK\f[]] [\f[B]\-o\f[] \f[I]file\f[]] [\f[B]\-u\f[] \f[I]date\f[]] [\f[B]\-V\f[] \f[I]version\f[]] \f[I]url\f[] Downloads a resource from \f[I]url\f[]. .RS .RE @@ -49,6 +49,12 @@ .RS .RE .TP +.B rename [\f[B]\-pcO\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]srcurl\f[] \f[I]name\f[] +Changes the name of a resource or collection at \f[I]srcurl\f[] to +\f[I]name\f[]. +.RS +.RE +.TP .B export [\f[B]\-pc\f[]] [\f[B]\-o\f[] \f[I]file\f[]] [\f[B]\-u\f[] \f[I]date\f[]] \f[I]url\f[] Exports a resource or collection to a \f[B]tar(5)\f[] archive. By default the data is written to \f[I]stdout\f[], but you may specify a @@ -121,6 +127,37 @@ in sync. .RS .RE +.TP +.B versioncontrol [\f[B]\-pc\f[]] \f[I]url\f[] +Puts the resource, specified by url, under version control. +This is required in order to use other versioning commands with this +resource. +.RS +.RE +.TP +.B list\-versions [\f[B]\-pc\f[]] \f[I]url\f[] +Lists all versions of a version\-controlled resource. +.RS +.RE +.TP +.B checkout [\f[B]\-pc\f[]] \f[I]url\f[] +Changes the state of a resource to checked\-out to allow modifications +to the content and properties. +.RS +.RE +.TP +.B checkin [\f[B]\-pc\f[]] \f[I]url\f[] +Changes the state of a resource to checked\-in. +This will create a new version of the resource. +In the checked\-in state the resource cannot be modified. +.RS +.RE +.TP +.B uncheckout [\f[B]\-pc\f[]] \f[I]url\f[] +Cancels all modification of the resource and sets the state to +checked\-in without creating a new version. +.RS +.RE .SH CONFIGURATION COMMANDS .TP .B add\-repository @@ -144,6 +181,31 @@ Validates the \f[B]$HOME/.dav/config.xml\f[] configuration file. .RS .RE +.TP +.B repository\-url [\f[B]\-p\f[]] \f[I]repository\f[] +Prints the repository url. +.RS +.RE +.TP +.B add\-user +Adds a user to the secret store. +.RS +.RE +.TP +.B remove\-user +Removes a user from the secret store. +.RS +.RE +.TP +.B edit\-user +Interactive command for modifying users stored in the secret store. +.RS +.RE +.TP +.B list\-users +Lists all users stored in the secret store. +.RS +.RE .SH GENERAL OPTIONS .PP The following options can be used with all commands. @@ -216,7 +278,7 @@ .TP .B \-o \f[I]file\f[] Write output to \f[I]file\f[]. -Use \[aq]\-\[aq] for stdout. +Use `\-' for stdout. .RS .RE .TP @@ -226,7 +288,7 @@ .RE .TP .B \-p -Don\[aq]t encrypt or decrypt files. +Don't encrypt or decrypt files. .RS .RE .TP @@ -250,6 +312,12 @@ .RS .RE .TP +.B \-V \f[I]version\f[] +downloads a specific version of the resource. +Available versions can be listed with the list\-versions command +.RS +.RE +.TP .B \-x XML property content. .RS