README

Sun, 05 Jul 2020 11:47:24 +0200

author
Mike Becker <universe@uap-core.de>
date
Sun, 05 Jul 2020 11:47:24 +0200
branch
feature/dav-edit
changeset 721
c401f4af44b1
parent 705
3a5d9552a436
permissions
-rw-r--r--

adds support for option terminator '--'

also adds support for option arguments within the same cmd arg
e.g. -omyoutfile does now work

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
705
3a5d9552a436 update changelog
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 429
diff changeset
71 Copyright 2019 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