UNIXworkcode

1 % DAV(1) Version 1.3 | DavUtils User Manuals 2 % Olaf Wintermann 3 % December 15, 2019 4 5 # NAME 6 7 **dav** - command line WebDAV client 8 9 # SYNOPSIS 10 11 **dav** *command* [*options*] *arguments*... 12 13 # DESCRIPTION 14 15 TODO 16 17 # COMMANDS 18 19 list [**-altdepcR**] [**-u** *date*] *url* 20 : Lists the files at *url*. 21 22 get [**-pcRK**] [**-o** *file*] [**-u** *date*] [**-V** *version*] *url* 23 : Downloads a resource from *url*. 24 25 put [**-pcR**] [**-k** *key*] [**-L** *lock*] *url* *file* 26 : Uploads a resource to *url*. 27 28 edit [**-pc**] [**-k** *key*] [**-V** *version*] [**-L** *lock*] *url* 29 : Downloads or creates a resource and opens the editor. 30 31 The editor can be specified via the EDITOR environment variable. 32 Default editor is vi. 33 34 mkdir [**-pc**] [**-k** *key*] [**-L** *lock*] *url* 35 : Creates a new collection at *url*. 36 37 remove [**-pc**] [**-L** *lock*] *url* 38 : Deletes a resource or collection at *url* 39 40 copy [**-pcO**] [**-L** *lock*] *srcurl* *desturl* 41 : Copies a resource or collection from *srcurl* to *desturl*. 42 43 move [**-pcO**] [**-L** *lock*] *srcurl* *desturl* 44 : Moves a resource or collection from *srcurl* to *desturl*. 45 46 rename [**-pcO**] [**-L** *lock*] *srcurl* *name* 47 : Changes the name of a resource or collection at *srcurl* to *name*. 48 49 export [**-pc**] [**-o** *file*] [**-u** *date*] *url* 50 : Exports a resource or collection to a **tar(5)** archive. By default the 51 data is written to *stdout*, but you may specify a *file* with the **-o** 52 option. 53 54 import [**-pc**] [**-k** *key*] [**-L** *lock*] *url* *file* 55 : Uploads and extracts the contents of the **tar(5)** archive *file* to *url*. 56 57 get-property [**-pcx**] [**-n** *uri*] *url* *property* 58 : Gets a specific resource property. Every WebDAV property has a name and an 59 XML namespace. A namespace can be specified with the **-n** option or with 60 a prefixed name. The prefix and property name are separated by a colon 61 *:* as usual. 62 63 If the **-x** option is specified, a valid XML document containing the 64 value is printed on *stdout*. 65 66 If the property contains XML data and the **-x** option is not specified, 67 the value is printed on *stderr* in an XML-like format. 68 69 set-property [**-pcx**] [**-L** *lock*] [**-n** *uri*] *url* *property* [*value*] 70 : Sets a resource property to the specified value. See **get-property** for 71 details. If no *value* is specified, it is read from *stdin*. 72 73 remove-property [**-pc**] [**-n** *uri*] *url* *property* 74 : Removes a resource property. 75 76 lock [**-pc**] [**-T** *timeout*] *url* 77 : Creates a lock on the resource at *url*. The lock is an exclusive write 78 lock with infinite depth. If the resource is sucessfully locked, a lock 79 token for this resource is printed to *stdout*. This lock token should be 80 saved to unlock the resource eventually. 81 82 unlock [**-pc**] [**-L** *lock*] *url* 83 : Unlocks the resource at *url* with a lock token. If *lock* is not 84 specified, the token is read from *stdin*. 85 86 info [**-pc**] *url* 87 : Prints some information and lists al properties for the resource at *url*. 88 89 date [*url*] 90 : Gets the time from the server providing the resource denoted by *url*. 91 If *url* is not specified, this command prints the local time. 92 This command is useful, if the server clock and the local clock are not 93 in sync. 94 95 versioncontrol [**-pc**] *url* 96 : Puts the resource, specified by url, under version control. This is 97 required in order to use other versioning commands with this resource. 98 99 list-versions [**-pc**] *url* 100 : Lists all versions of a version-controlled resource. 101 102 checkout [**-pc**] *url* 103 : Changes the state of a resource to checked-out to allow modifications 104 to the content and properties. 105 106 checkin [**-pc**] *url* 107 : Changes the state of a resource to checked-in. This will create a new 108 version of the resource. In the checked-in state the resource cannot 109 be modified. 110 111 uncheckout [**-pc**] *url* 112 : Cancels all modification of the resource and sets the state to checked-in 113 without creating a new version. 114 115 # CONFIGURATION COMMANDS 116 117 add-repository 118 : This command runs an interactive assistant that creates a repository 119 configuration. 120 121 remove-repository *name* 122 : Removes the repository with the specified *name* from the configuration. 123 124 list-repositories 125 : Lists all currently configured repositories. 126 127 check-config 128 : Validates the **$HOME/.dav/config.xml** configuration file. 129 130 repository-url [**-p**] *repository* 131 : Prints the repository url. 132 133 add-user 134 : Adds a user to the secret store. 135 136 remove-user 137 : Removes a user from the secret store. 138 139 edit-user 140 : Interactive command for modifying users stored in the secret store. 141 142 list-users 143 : Lists all users stored in the secret store. 144 145 # GENERAL OPTIONS 146 147 The following options can be used with all commands. 148 149 -i 150 : Disable cert verification. 151 152 -N 153 : Disable authentication prompt. 154 155 -v 156 : Verbose output. 157 158 # COMMAND OPTIONS 159 160 -a 161 : Show all files. 162 163 -c 164 : Enable full encryption. 165 166 -d 167 : Order by last modified date. 168 169 -e 170 : Show extended flags. 171 172 -K 173 : Keep already present files. 174 175 -k *key* 176 : Key to use for encryption. 177 178 -l 179 : Print resources in long list format. 180 181 -L *lock* 182 : Specificy lock token. 183 184 -n *uri* 185 : Specify namespace *uri*. There are two namespaces configured by default. 186 187 1. *D* for the *DAV:* namespace 188 189 2. *idav* for the *http://davutils.org/* namespace 190 191 -o *file* 192 : Write output to *file*. Use '-' for stdout. 193 194 -O 195 : Override resources. 196 197 -p 198 : Don't encrypt or decrypt files. 199 200 -R 201 : Recursively do the operation for all children. 202 203 -t 204 : Print content type. 205 206 -T *sec* 207 : Timeout in seconds. 208 209 -u *date* 210 : Get resources which are modified since the specified *date*. 211 212 -V *version* 213 : downloads a specific version of the resource. Available versions can be 214 listed with the list-versions command 215 216 -x 217 : XML property content. 218 219 220 # SEE ALSO 221 222 `dav-sync` (1). 223 224 DavUtils full documentation: <https://davutils.sourceforge.io/>. 225 226