# HG changeset patch # User Olaf Wintermann # Date 1531242845 -7200 # Node ID 9255f59139c6e3921f79705636422accc9e90c9b # Parent a62d312d8e53f0c4de9bf1a1b5fd5f0ee4c0f8ab# Parent 99c26b1b732724463016874e5cd783d3d5d8ab4f merge diff -r 99c26b1b7327 -r 9255f59139c6 docs/man/dav-sync.1.man --- a/docs/man/dav-sync.1.man Tue Jul 10 18:42:52 2018 +0200 +++ b/docs/man/dav-sync.1.man Tue Jul 10 19:14:05 2018 +0200 @@ -1,53 +1,151 @@ .\" Automatically generated by Pandoc 1.16.0.2 .\" -.TH "DAV\-SYNC" "1" "July 1, 2018" "dav\-sync User Manuals" "" +.TH "DAV\-SYNC" "1" "July 1, 2018" "Version 1.2" "DavUtils User Manuals" .hy .SH NAME .PP -dav\-sync \- synchronize a local directory with a WebDAV collection. +\f[B]dav\-sync\f[] \- synchronize a local directory with a WebDAV +collection. .SH SYNOPSIS .PP -dav\-sync \f[I]command\f[] [\f[I]options\f[]] \f[I]arguments\f[]... +\f[B]dav\-sync\f[] \f[I]command\f[] [\f[I]options\f[]] +\f[I]arguments\f[]... .SH DESCRIPTION .PP TODO .SH COMMANDS -.PP -pull [\f[I]\-cldr\f[]] [\f[I]\-t tags\f[]] \f[I]directory\f[] -.PP -push [\f[I]\-cldr\f[]] [\f[I]\-t tags\f[]] \f[I]directory\f[] -.PP -archive [\f[I]\-cld\f[]] [\f[I]\-t tags\f[]] \f[I]directory\f[] -.PP -resolve\-conflicts \f[I]directory\f[] -.PP -delete\-conflicts \f[I]directory\f[] +.TP +.B pull [\f[B]\-cldr\f[]] [\f[B]\-t\f[] \f[I]tags\f[]] \f[I]directory\f[] +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. +.RS +.RE +.TP +.B push [\f[B]\-cldr\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. +If conflict detection is not disabled, all files that are also modified +on the server will be skipped. +.RS +.RE +.TP +.B archive [\f[B]\-cld\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 resolve\-conflicts \f[I]directory\f[] +Removes conflict entries from the database. +This does not merge any files. +All files which are marked as conflict are normal files after running +this command. +In other words: by executing this command you assert that \f[B]you\f[] +have resolved the conflicts. +.RS +.RE +.TP +.B delete\-conflicts \f[I]directory\f[] +Deletes all files that are marked as a conflict. +This will always delete the files and does not move them to the trash +directory. +Use this command with caution. +.RS +.RE +.TP +.B trash\-info \f[I]directory\f[] +Shows the trash directory path for a \f[I]directory\f[], the number of +files currently in the trash and the space they consume. +.RS +.RE +.TP +.B empty\-trash \f[I]directory\f[] +Removes all files from the trash of the given \f[I]directory\f[]. +.RS +.RE +.TP +.B add\-tag [\f[B]\-s\f[] \f[I]syncdir\f[]] \f[I]file\f[] \f[I]tag\f[] +Adds a \f[I]tag\f[] to a SyncDirectory \f[I]file\f[]. +The \f[I]file\f[] argument must denote a local file path. +.RS +.RE +.TP +.B remove\-tag [\f[B]\-s\f[] \f[I]syncdir\f[]] \f[I]file\f[] \f[I]tag\f[] +Removes a \f[I]tag\f[] from a SyncDirectory \f[I]file\f[]. +See \f[B]add\-tag\f[]. +.RS +.RE +.TP +.B set\-tags [\f[B]\-s\f[] \f[I]syncdir\f[]] \f[I]file\f[] \f[I]tags\f[] +Sets the list of \f[I]tags\f[] for a SyncDirectory \f[I]file\f[]. +This command behaves, as if you would remove all tags with +\f[B]remove\-tag\f[] and add the \f[I]tags\f[] with \f[B]add\-tag\f[]. +.RS +.RE +.TP +.B list\-tags [\f[B]\-s\f[] \f[I]syncdir\f[]] \f[I]file\f[] +List all tags for the specified \f[I]file\f[]. +.RS +.RE +.SH CONFIGURATION COMMANDS +.TP +.B add\-directory +Runs an interactive assistant to create a SyncDirectory. +.RS +.RE +.TP +.B list\-directories +Lists all available SyncDirectories. +.RS +.RE +.TP +.B check\-config +Validates the \f[B]$HOME/.dav/sync.xml\f[] configuration file. +.RS +.RE +.TP +.B check\-repositories +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. +.RS +.RE +.SH GENERAL OPTIONS .PP -trash\-info \f[I]directory\f[] -.PP -empty\-trash \f[I]directory\f[] -.PP -add\-tag [\f[I]\-s syncdir\f[]] \f[I]file\f[] \f[I]tag\f[] -.PP -remove\-tag [\f[I]\-s syncdir\f[]] \f[I]file\f[] \f[I]tag\f[] -.PP -set\-tags [\f[I]\-s syncdir\f[]] \f[I]file\f[] \f[I]tags\f[] -.PP -list\-tags [\f[I]\-s syncdir\f[]] \f[I]file\f[] -.SH OPTIONS +The following options can be used with all commands. +.TP +.B \-v +Verbose output. +.RS +.RE +.SH COMMAND OPTIONS .TP .B \-c Disable conflict detection. .RS .RE .TP +.B \-d +Don\[aq]t lock the repository. +.RS +.RE +.TP .B \-l Lock the repository before access. .RS .RE .TP -.B \-d -Don\[aq]t lock the repository. +.B \-s \f[I]syncdir\f[] +If multiple SyncDirectories contain a local file, this option must be +used to resolve the ambiguity. .RS .RE .TP @@ -60,11 +158,6 @@ Remove ressources not matching the tag filter. .RS .RE -.TP -.B \-v -Verbose output (all commands). -.RS -.RE .SH SEE ALSO .PP \f[C]dav\f[] (1). diff -r 99c26b1b7327 -r 9255f59139c6 docs/man/dav.1.man --- a/docs/man/dav.1.man Tue Jul 10 18:42:52 2018 +0200 +++ b/docs/man/dav.1.man Tue Jul 10 19:14:05 2018 +0200 @@ -1,107 +1,176 @@ .\" Automatically generated by Pandoc 1.16.0.2 .\" -.TH "DAV" "1" "July 1, 2018" "dav User Manuals" "" +.TH "DAV" "1" "July 1, 2018" "Version 1.2" "DavUtils User Manuals" .hy .SH NAME .PP -dav \- command line WebDAV client +\f[B]dav\f[] \- command line WebDAV client .SH SYNOPSIS .PP -dav \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 .SH COMMANDS -.PP -list [\f[I]\-altdepcR\f[]] [\f[I]\-u date\f[]] \f[I]url\f[] -.PP -get [\f[I]\-pcRK\f[]] [\f[I]\-o file\f[]] [\f[I]\-u date\f[]] -\f[I]url\f[] -.PP -put [\f[I]\-pcR\f[]] [\f[I]\-k key\f[]] [\f[I]\-L lock\f[]] \f[I]url\f[] -\f[I]file\f[] -.PP -mkdir [\f[I]\-pc\f[]] [\f[I]\-k key\f[]] [\f[I]\-L lock\f[]] -\f[I]url\f[] -.PP -remove [\f[I]\-pc\f[]] [\f[I]\-L lock\f[]] \f[I]url\f[] -.PP -copy [\f[I]\-pcO\f[]] [\f[I]\-L lock\f[]] \f[I]url\f[] \f[I]url\f[] -.PP -move [\f[I]\-pcO\f[]] [\f[I]\-L lock\f[]] \f[I]url\f[] \f[I]url\f[] -.PP -export [\f[I]\-pc\f[]] [\f[I]\-o file\f[]] [\f[I]\-u date\f[]] -\f[I]url\f[] +.TP +.B list [\f[B]\-altdepcR\f[]] [\f[B]\-u\f[] \f[I]date\f[]] \f[I]url\f[] +Lists the files at \f[I]url\f[]. +.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[] +Downloads a resource from \f[I]url\f[]. +.RS +.RE +.TP +.B put [\f[B]\-pcR\f[]] [\f[B]\-k\f[] \f[I]key\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]url\f[] \f[I]file\f[] +Uploads a resource to \f[I]url\f[]. +.RS +.RE +.TP +.B mkdir [\f[B]\-pc\f[]] [\f[B]\-k\f[] \f[I]key\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]url\f[] +Creates a new collection at \f[I]url\f[]. +.RS +.RE +.TP +.B remove [\f[B]\-pc\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]url\f[] +Deletes a resource or collection at \f[I]url\f[] +.RS +.RE +.TP +.B copy [\f[B]\-pcO\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]srcurl\f[] \f[I]desturl\f[] +Copies a resource or collection from \f[I]srcurl\f[] to +\f[I]desturl\f[]. +.RS +.RE +.TP +.B move [\f[B]\-pcO\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]srcurl\f[] \f[I]desturl\f[] +Moves a resource or collection from \f[I]srcurl\f[] to \f[I]desturl\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 +\f[I]file\f[] with the \f[B]\-o\f[] option. +.RS +.RE +.TP +.B import [\f[B]\-pc\f[]] [\f[B]\-k\f[] \f[I]key\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]url\f[] \f[I]file\f[] +Uploads and extracts the contents of the \f[B]tar(5)\f[] archive +\f[I]file\f[] to \f[I]url\f[]. +.RS +.RE +.TP +.B get\-property [\f[B]\-pcx\f[]] [\f[B]\-n\f[] \f[I]uri\f[]] \f[I]url\f[] \f[I]property\f[] +Gets a specific resource property. +Every WebDAV property has a name and an XML namespace. +A namespace can be specified with the \f[B]\-n\f[] option or with a +prefixed name. +The prefix and property name are separated by a colon \f[I]:\f[] as +usual. +.RS .PP -import [\f[I]\-pc\f[]] [\f[I]\-k key\f[]] [\f[I]\-L lock\f[]] -\f[I]url\f[] \f[I]file\f[] -.PP -get\-property [\f[I]\-pcx\f[]] [\f[I]\-n uri\f[]] \f[I]url\f[] -\f[I]property\f[] -.PP -set\-property [\f[I]\-pcx\f[]] [\f[I]\-L lock\f[]] [\f[I]\-n uri\f[]] -\f[I]url\f[] \f[I]property\f[] [\f[I]value\f[]] -.PP -remove\-property [\f[I]\-pc\f[]] [\f[I]\-n uri\f[]] \f[I]url\f[] -\f[I]property\f[] +If the \f[B]\-x\f[] option is specified, a valid XML document containing +the value is printed on \f[I]stdout\f[]. .PP -lock [\f[I]\-pc\f[]] [\f[I]\-T timeout\f[]] \f[I]url\f[] -.PP -unlock [\f[I]\-pc\f[]] [\f[I]\-L lock\f[]] \f[I]url\f[] -.PP -info [\f[I]\-pc\f[]] \f[I]url\f[] -.PP -date [\f[I]url\f[]] -.SH OPTIONS +If the property contains XML data and the \f[B]\-x\f[] option is not +specified, the value is printed on \f[I]stderr\f[] in an XML\-like +format. +.RE .TP -.B \-k \f[I]key\f[] -Key to use for encryption. +.B set\-property [\f[B]\-pcx\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] [\f[B]\-n\f[] \f[I]uri\f[]] \f[I]url\f[] \f[I]property\f[] [\f[I]value\f[]] +Sets a resource property to the specified value. +See \f[B]get\-property\f[] for details. +If no \f[I]value\f[] is specified, it is read from \f[I]stdin\f[]. .RS .RE .TP -.B \-p -Don\[aq]t encrypt or decrypt files. +.B remove\-property [\f[B]\-pc\f[]] [\f[B]\-n\f[] \f[I]uri\f[]] \f[I]url\f[] \f[I]property\f[] +Removes a resource property. .RS .RE .TP -.B \-c -Enable full encryption. +.B lock [\f[B]\-pc\f[]] [\f[B]\-T\f[] \f[I]timeout\f[]] \f[I]url\f[] +Creates a lock on the resource at \f[I]url\f[]. +The lock is an exclusive write lock with infinite depth. +If the resource is sucessfully locked, a lock token for this resource is +printed to \f[I]stdout\f[]. +This lock token should be saved to unlock the resource eventually. .RS .RE .TP -.B \-R -Recursively do the operation for all children. +.B unlock [\f[B]\-pc\f[]] [\f[B]\-L\f[] \f[I]lock\f[]] \f[I]url\f[] +Unlocks the resource at \f[I]url\f[] with a lock token. +If \f[I]lock\f[] is not specified, the token is read from +\f[I]stdin\f[]. +.RS +.RE +.TP +.B info [\f[B]\-pc\f[]] \f[I]url\f[] +Prints some information and lists al properties for the resource at +\f[I]url\f[]. .RS .RE .TP -.B \-K -Keep already present files. +.B date [\f[I]url\f[]] +Gets the time from the server providing the resource denoted by +\f[I]url\f[]. +If \f[I]url\f[] is not specified, this command prints the local time. +This command is useful, if the server clock and the local clock are not +in sync. +.RS +.RE +.SH CONFIGURATION COMMANDS +.TP +.B add\-repository +This command runs an interactive assistant that creates a repository +configuration. +.RS +.RE +.TP +.B remove\-repository \f[I]name\f[] +Removes the repository with the specified \f[I]name\f[] from the +configuration. .RS .RE .TP -.B \-o \f[I]file\f[] -Write output to \f[I]file\f[]. -Use \[aq]\-\[aq] for stdout. +.B list\-repositories +Lists all currently configured repositories. .RS .RE .TP -.B \-u \f[I]date\f[] -Get resources which are modified since the specified \f[I]date\f[]. +.B check\-config +Validates the \f[B]$HOME/.dav/config.xml\f[] configuration file. +.RS +.RE +.SH GENERAL OPTIONS +.PP +The following options can be used with all commands. +.TP +.B \-i +Disable cert verification. .RS .RE .TP +.B \-N +Disable authentication prompt. +.RS +.RE +.TP +.B \-v +Verbose output. +.RS +.RE +.SH COMMAND OPTIONS +.TP .B \-a Show all files. .RS .RE .TP -.B \-l -Print resources in long list format. -.RS -.RE -.TP -.B \-t -Print content type. +.B \-c +Enable full encryption. .RS .RE .TP @@ -115,13 +184,59 @@ .RS .RE .TP +.B \-K +Keep already present files. +.RS +.RE +.TP +.B \-k \f[I]key\f[] +Key to use for encryption. +.RS +.RE +.TP +.B \-l +Print resources in long list format. +.RS +.RE +.TP +.B \-L \f[I]lock\f[] +Specificy lock token. +.RS +.RE +.TP +.B \-n \f[I]uri\f[] +Specify namespace \f[I]uri\f[]. +There are two namespaces configured by default. +.RS +.IP "1." 3 +\f[I]D\f[] for the \f[I]DAV:\f[] namespace +.IP "2." 3 +\f[I]idav\f[] for the \f[I]http://davutils.org/\f[] namespace +.RE +.TP +.B \-o \f[I]file\f[] +Write output to \f[I]file\f[]. +Use \[aq]\-\[aq] for stdout. +.RS +.RE +.TP .B \-O Override resources. .RS .RE .TP -.B \-L \f[I]lock\f[] -Specificy lock token. +.B \-p +Don\[aq]t encrypt or decrypt files. +.RS +.RE +.TP +.B \-R +Recursively do the operation for all children. +.RS +.RE +.TP +.B \-t +Print content type. .RS .RE .TP @@ -130,8 +245,8 @@ .RS .RE .TP -.B \-n \f[I]uri\f[] -Specify namespace \f[I]uri\f[]. +.B \-u \f[I]date\f[] +Get resources which are modified since the specified \f[I]date\f[]. .RS .RE .TP @@ -139,21 +254,6 @@ XML property content. .RS .RE -.TP -.B \-N -Disable authentication prompt (all commands). -.RS -.RE -.TP -.B \-i -Disable cert verification (all commands). -.RS -.RE -.TP -.B \-v -Verbose output (all commands). -.RS -.RE .SH SEE ALSO .PP \f[C]dav\-sync\f[] (1). diff -r 99c26b1b7327 -r 9255f59139c6 docs/src/dav-sync.1.md --- a/docs/src/dav-sync.1.md Tue Jul 10 18:42:52 2018 +0200 +++ b/docs/src/dav-sync.1.md Tue Jul 10 19:14:05 2018 +0200 @@ -1,14 +1,14 @@ -% DAV-SYNC(1) dav-sync User Manuals +% DAV-SYNC(1) Version 1.2 | DavUtils User Manuals % Olaf Wintermann % July 1, 2018 # NAME -dav-sync - synchronize a local directory with a WebDAV collection. +**dav-sync** - synchronize a local directory with a WebDAV collection. # SYNOPSIS -dav-sync *command* [*options*] *arguments*... +**dav-sync** *command* [*options*] *arguments*... # DESCRIPTION @@ -16,39 +16,93 @@ # COMMANDS -pull [*-cldr*] [*-t tags*] *directory* +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. -push [*-cldr*] [*-t tags*] *directory* +push [**-cldr**] [**-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. -archive [*-cld*] [*-t tags*] *directory* +archive [**-cld**] [**-t** *tags*] *directory* +: 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. resolve-conflicts *directory* +: Removes conflict entries from the database. This does not merge any files. + All files which are marked as conflict are normal files after running this + command. In other words: by executing this command you assert that **you** + have resolved the conflicts. 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. Use this command + with caution. trash-info *directory* +: Shows the trash directory path for a *directory*, the number of files + currently in the trash and the space they consume. empty-trash *directory* +: Removes all files from the trash of the given *directory*. -add-tag [*-s syncdir*] *file* *tag* +add-tag [**-s** *syncdir*] *file* *tag* +: Adds a *tag* to a SyncDirectory *file*. The *file* argument must denote a + local file path. + +remove-tag [**-s** *syncdir*] *file* *tag* +: Removes a *tag* from a SyncDirectory *file*. See **add-tag**. -remove-tag [*-s syncdir*] *file* *tag* +set-tags [**-s** *syncdir*] *file* *tags* +: Sets the list of *tags* for a SyncDirectory *file*. This command behaves, + as if you would remove all tags with **remove-tag** and add the *tags* with + **add-tag**. + +list-tags [**-s** *syncdir*] *file* +: List all tags for the specified *file*. + +# CONFIGURATION COMMANDS -set-tags [*-s syncdir*] *file* *tags* +add-directory +: Runs an interactive assistant to create a SyncDirectory. + +list-directories +: Lists all available SyncDirectories. + +check-config +: Validates the **$HOME/.dav/sync.xml** configuration file. -list-tags [*-s syncdir*] *file* +check-repositories +: 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. + +# GENERAL OPTIONS +The following options can be used with all commands. -# OPTIONS +-v +: Verbose output. + +# COMMAND OPTIONS -c : Disable conflict detection. +-d +: Don't lock the repository. + -l : Lock the repository before access. --d -: Don't lock the repository. +-s *syncdir* +: If multiple SyncDirectories contain a local file, this option must be used + to resolve the ambiguity. -t *tags* : Only sync files which have the specified tags. @@ -56,9 +110,6 @@ -r : Remove ressources not matching the tag filter. --v -: Verbose output (all commands). - # SEE ALSO `dav` (1). diff -r 99c26b1b7327 -r 9255f59139c6 docs/src/dav.1.md --- a/docs/src/dav.1.md Tue Jul 10 18:42:52 2018 +0200 +++ b/docs/src/dav.1.md Tue Jul 10 19:14:05 2018 +0200 @@ -1,14 +1,14 @@ -% DAV(1) dav User Manuals +% DAV(1) Version 1.2 | DavUtils User Manuals % Olaf Wintermann % July 1, 2018 # NAME -dav - command line WebDAV client +**dav** - command line WebDAV client # SYNOPSIS -dav *command* [*options*] *arguments*... +**dav** *command* [*options*] *arguments*... # DESCRIPTION @@ -16,70 +16,108 @@ # COMMANDS -list [*-altdepcR*] [*-u date*] *url* +list [**-altdepcR**] [**-u** *date*] *url* +: Lists the files at *url*. + +get [**-pcRK**] [**-o** *file*] [**-u** *date*] *url* +: Downloads a resource from *url*. -get [*-pcRK*] [*-o file*] [*-u date*] *url* +put [**-pcR**] [**-k** *key*] [**-L** *lock*] *url* *file* +: Uploads a resource to *url*. -put [*-pcR*] [*-k key*] [*-L lock*] *url* *file* +mkdir [**-pc**] [**-k** *key*] [**-L** *lock*] *url* +: Creates a new collection at *url*. -mkdir [*-pc*] [*-k key*] [*-L lock*] *url* +remove [**-pc**] [**-L** *lock*] *url* +: Deletes a resource or collection at *url* -remove [*-pc*] [*-L lock*] *url* +copy [**-pcO**] [**-L** *lock*] *srcurl* *desturl* +: Copies a resource or collection from *srcurl* to *desturl*. -copy [*-pcO*] [*-L lock*] *url* *url* +move [**-pcO**] [**-L** *lock*] *srcurl* *desturl* +: Moves a resource or collection from *srcurl* to *desturl*. -move [*-pcO*] [*-L lock*] *url* *url* +export [**-pc**] [**-o** *file*] [**-u** *date*] *url* +: Exports a resource or collection to a **tar(5)** archive. By default the + data is written to *stdout*, but you may specify a *file* with the **-o** + option. + +import [**-pc**] [**-k** *key*] [**-L** *lock*] *url* *file* +: Uploads and extracts the contents of the **tar(5)** archive *file* to *url*. -export [*-pc*] [*-o file*] [*-u date*] *url* - -import [*-pc*] [*-k key*] [*-L lock*] *url* *file* +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 colon + *:* as usual. + + If the **-x** option is specified, a valid XML document containing the + value is printed on *stdout*. + + If the property contains XML data and the **-x** option is not specified, + the value is printed on *stderr* in an XML-like format. -get-property [*-pcx*] [*-n uri*] *url* *property* - -set-property [*-pcx*] [*-L lock*] [*-n uri*] *url* *property* [*value*] +set-property [**-pcx**] [**-L** *lock*] [**-n** *uri*] *url* *property* [*value*] +: Sets a resource property to the specified value. See **get-property** for + details. If no *value* is specified, it is read from *stdin*. -remove-property [*-pc*] [*-n uri*] *url* *property* - -lock [*-pc*] [*-T timeout*] *url* +remove-property [**-pc**] [**-n** *uri*] *url* *property* +: Removes a resource property. -unlock [*-pc*] [*-L lock*] *url* +lock [**-pc**] [**-T** *timeout*] *url* +: Creates a lock on the resource at *url*. The lock is an exclusive write + lock with infinite depth. If the resource is sucessfully locked, a lock + token for this resource is printed to *stdout*. This lock token should be + saved to unlock the resource eventually. -info [*-pc*] *url* +unlock [**-pc**] [**-L** *lock*] *url* +: Unlocks the resource at *url* with a lock token. If *lock* is not + specified, the token is read from *stdin*. + +info [**-pc**] *url* +: Prints some information and lists al properties for the resource at *url*. date [*url*] - +: Gets the time from the server providing the resource denoted by *url*. + If *url* is not specified, this command prints the local time. + This command is useful, if the server clock and the local clock are not + in sync. -# OPTIONS +# CONFIGURATION COMMANDS --k *key* -: Key to use for encryption. +add-repository +: This command runs an interactive assistant that creates a repository + configuration. --p -: Don't encrypt or decrypt files. +remove-repository *name* +: Removes the repository with the specified *name* from the configuration. + +list-repositories +: Lists all currently configured repositories. --c -: Enable full encryption. +check-config +: Validates the **$HOME/.dav/config.xml** configuration file. --R -: Recursively do the operation for all children. +# GENERAL OPTIONS + +The following options can be used with all commands. --K -: Keep already present files. +-i +: Disable cert verification. --o *file* -: Write output to *file*. Use '-' for stdout. +-N +: Disable authentication prompt. --u *date* -: Get resources which are modified since the specified *date*. +-v +: Verbose output. + +# COMMAND OPTIONS -a : Show all files. --l -: Print resources in long list format. - --t -: Print content type. +-c +: Enable full encryption. -d : Order by last modified date. @@ -87,29 +125,49 @@ -e : Show extended flags. +-K +: Keep already present files. + +-k *key* +: Key to use for encryption. + +-l +: Print resources in long list format. + +-L *lock* +: Specificy lock token. + +-n *uri* +: Specify namespace *uri*. There are two namespaces configured by default. + + 1. *D* for the *DAV:* namespace + + 2. *idav* for the *http://davutils.org/* namespace + +-o *file* +: Write output to *file*. Use '-' for stdout. + -O : Override resources. --L *lock* -: Specificy lock token. +-p +: Don't encrypt or decrypt files. + +-R +: Recursively do the operation for all children. + +-t +: Print content type. -T *sec* : Timeout in seconds. --n *uri* -: Specify namespace *uri*. +-u *date* +: Get resources which are modified since the specified *date*. -x : XML property content. --N -: Disable authentication prompt (all commands). - --i -: Disable cert verification (all commands). - --v -: Verbose output (all commands). # SEE ALSO