README

Sat, 22 Jun 2019 16:36:52 +0200

author
Olaf Wintermann <olaf.wintermann@gmail.com>
date
Sat, 22 Jun 2019 16:36:52 +0200
changeset 607
5dc7fe41e8f8
parent 429
1607450065ba
child 705
3a5d9552a436
permissions
-rw-r--r--

move some properties to new namespace

for properties encryption we need to decide which props must be encrypted and the plan is, to decide by namespace

273
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 241
diff changeset
1 DavUtils - dav cmd tools
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 241
diff changeset
2 ==========================
240
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
285
02d3e4b1245f adds some small fixes for 1.0 release
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 284
diff changeset
22 Documentation can be found at http://davutils.sourceforge.net/docs/dav1/ and
273
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 241
diff changeset
23 in the docs sub-directory.
240
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
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
26 First Steps
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
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
29 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
30 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
31
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
32 $ dav list https://example.com/webdav/mycollection/
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
33
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
34 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
35 $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
36 interactive configuration assistent.
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
37
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
38 $ dav add-repository
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
39
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
40 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
41 example
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
42
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
43 $ dav list myrepo
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
44
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
45 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
46
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
47 $ dav list myrepo/files/
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
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
50 Support
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
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
53 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
54 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
55
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
56 https://sourceforge.net/p/davutils/tickets/
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
57 https://sourceforge.net/p/davutils/discussion/
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
58
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
59 Olaf Wintermann <olaf.wintermann@gmail.com>
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
60
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
61
241
da7ace67deab improved dav put output
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 240
diff changeset
62 Authors
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
da7ace67deab improved dav put output
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 240
diff changeset
65 Olaf Wintermann
da7ace67deab improved dav put output
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 240
diff changeset
66 Mike Becker
da7ace67deab improved dav put output
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 240
diff changeset
67
240
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
68 License
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
429
1607450065ba this could be the 1.2 release
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 285
diff changeset
71 Copyright 2018 Olaf Wintermann. All rights reserved.
240
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
72
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
73 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
74 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
75
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
76 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
77 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
78
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
79 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
80 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
81 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
82
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
83 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
84 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
85 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
86 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
87 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
88 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
89 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
90 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
91 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
92 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
93 POSSIBILITY OF SUCH DAMAGE.
220ea6247077 added README, INSTALL and LICENSE files
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
94

mercurial