README

Wed, 13 Jul 2016 14:29:50 +0200

author
Olaf Wintermann <olaf.wintermann@gmail.com>
date
Wed, 13 Jul 2016 14:29:50 +0200
changeset 244
47791bdf1725
parent 241
da7ace67deab
child 273
c743721d566f
permissions
-rw-r--r--

changed max-retry meaning and filter configuration in sync.xml

prior to this change, max-retry was the number of trials. Now it is exactly the number of retries.

include and exclude filters are now surrounded by an filter element in sync.xml

240
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
1 DavUtils - cmd tools
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
2 ============================
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
3
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
4 Introduction
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
5 ------------
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
6
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
7 A collection of command line tools for accessing WebDAV server, including the
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
8 tool dav, a general purpose WebDAV client and dav-sync, a program for
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
9 synchronizing local files with WebDAV server. Both tools can encrypt files
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
10 on the fly with AES.
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
11
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
12
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
13 Installation
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
14 ------------
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
15
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
16 See the file INSTALL for build and installation instructions.
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
17
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
18
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
19 Documentation
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
20 -------------
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
21
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
22 Documentation can be found at http://davutils.sourceforge.net/docs/
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
23
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
24
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
25 First Steps
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
26 -----------
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
27
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
28 Most dav commands expect an url, for example if you want to list all
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
29 resources in a WebDAV collection you can do it with
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
30
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
31 $ dav list https://example.com/webdav/mycollection/
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
32
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
33 A useful feature is to save your repository information in the
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
34 $HOME/.dav/config.xml file. An easy way to do this is to use the
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
35 interactive configuration assistent.
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
36
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
37 $ dav add-repository
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
38
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
39 After you configured the repository you can access it with its name, for
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
40 example
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
41
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
42 $ dav list myrepo
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
43
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
44 You can combine the repository name with a path
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
45
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
46 $ dav list myrepo/files/
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
47
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
48
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
49 Support
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
50 -------
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
51
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
52 Bug reports and feature requests can be done at sourceforge. For questions
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
53 you can use the sourceforge forum or contact me via email.
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
54
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
55 https://sourceforge.net/p/davutils/tickets/
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
56 https://sourceforge.net/p/davutils/discussion/
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
57
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
58 Olaf Wintermann <olaf.wintermann@gmail.com>
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
59
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
60
241
da7ace67deab improved dav put output
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 240
diff changeset
61 Authors
da7ace67deab improved dav put output
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 240
diff changeset
62 -------
da7ace67deab improved dav put output
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 240
diff changeset
63
da7ace67deab improved dav put output
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 240
diff changeset
64 Olaf Wintermann
da7ace67deab improved dav put output
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 240
diff changeset
65 Mike Becker
da7ace67deab improved dav put output
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 240
diff changeset
66
240
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
67 License
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
68 -------
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
69
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
70 Copyright 2016 Olaf Wintermann. All rights reserved.
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
71
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
72 Redistribution and use in source and binary forms, with or without
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
73 modification, are permitted provided that the following conditions are met:
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
74
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
75 1. Redistributions of source code must retain the above copyright
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
76 notice, this list of conditions and the following disclaimer.
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
77
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
78 2. Redistributions in binary form must reproduce the above copyright
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
79 notice, this list of conditions and the following disclaimer in the
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
80 documentation and/or other materials provided with the distribution.
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
81
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
82 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
83 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
84 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
85 ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
86 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
87 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
88 SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
89 INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
90 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
91 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
92 POSSIBILITY OF SUCH DAMAGE.
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
93

mercurial