docs/src/dav-sync.1.md

Sat, 12 Oct 2019 11:17:11 +0200

author
Olaf Wintermann <olaf.wintermann@gmail.com>
date
Sat, 12 Oct 2019 11:17:11 +0200
changeset 654
8f2b8f2a5cde
parent 563
3dffe58a573f
child 703
2e3a24b9896a
permissions
-rw-r--r--

add remove-user and list-users commands

438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
1 % DAV-SYNC(1) Version 1.2 | DavUtils User Manuals
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
2 % Olaf Wintermann
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
3 % July 1, 2018
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
4
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
5 # NAME
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
6
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
7 **dav-sync** - synchronize a local directory with a WebDAV collection.
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
8
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
9 # SYNOPSIS
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
10
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
11 **dav-sync** *command* [*options*] *arguments*...
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
12
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
13 # DESCRIPTION
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
14
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
15 TODO
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
16
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
17 # COMMANDS
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
18
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
19 pull [**-cldr**] [**-t** *tags*] *directory*
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
20 : Pulls all changes from the server. All new or modified files are downloaded
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
21 and all files deleted on the server are deleted locally. If a file is also
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
22 locally modified and conflict detection is not disabled, the local file is
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
23 renamed and an entry in the conflict database is added.
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
24
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
25 push [**-cldr**] [**-t** *tags*] *directory*
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
26 : Pushes all local changes to the server. This uploads all locally modified
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
27 files and deletes all locally deleted files on the server. If conflict
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
28 detection is not disabled, all files that are also modified on the server
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
29 will be skipped.
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
30
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
31 archive [**-cld**] [**-t** *tags*] *directory*
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
32 : Uploads all new and modified files to the server. The command is similar to
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
33 the push command (with the same conflict behavior), however it does not
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
34 delete files on the server.
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
35
563
3dffe58a573f adds list-conflicts command to dav-sync
Mike Becker <universe@uap-core.de>
parents: 439
diff changeset
36 list-conflicts [**-v**] *directory*
3dffe58a573f adds list-conflicts command to dav-sync
Mike Becker <universe@uap-core.de>
parents: 439
diff changeset
37 : Lists all conflicting files. If verbose output is enabled, the output also
3dffe58a573f adds list-conflicts command to dav-sync
Mike Becker <universe@uap-core.de>
parents: 439
diff changeset
38 shows the number of entries for the same conflicting file.
3dffe58a573f adds list-conflicts command to dav-sync
Mike Becker <universe@uap-core.de>
parents: 439
diff changeset
39
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
40 resolve-conflicts *directory*
563
3dffe58a573f adds list-conflicts command to dav-sync
Mike Becker <universe@uap-core.de>
parents: 439
diff changeset
41 : Forcefully clears the conflict database. This does not merge any files.
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
42 All files which are marked as conflict are normal files after running this
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
43 command. In other words: by executing this command you assert that **you**
563
3dffe58a573f adds list-conflicts command to dav-sync
Mike Becker <universe@uap-core.de>
parents: 439
diff changeset
44 have resolved the conflicts. Usually you will never need this command.
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
45
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
46 delete-conflicts *directory*
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
47 : Deletes all files that are marked as a conflict. This will always delete
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
48 the files and does not move them to the trash directory. Use this command
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
49 with caution.
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
50
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
51 trash-info *directory*
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
52 : Shows the trash directory path for a *directory*, the number of files
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
53 currently in the trash and the space they consume.
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
54
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
55 empty-trash *directory*
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
56 : Removes all files from the trash of the given *directory*.
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
57
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
58 add-tag [**-s** *syncdir*] *file* *tag*
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
59 : Adds a *tag* to a SyncDirectory *file*. The *file* argument must denote a
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
60 local file path.
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
61
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
62 remove-tag [**-s** *syncdir*] *file* *tag*
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
63 : Removes a *tag* from a SyncDirectory *file*. See **add-tag**.
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
64
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
65 set-tags [**-s** *syncdir*] *file* *tags*
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
66 : Sets the list of *tags* for a SyncDirectory *file*. This command behaves,
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
67 as if you would remove all tags with **remove-tag** and add the *tags* with
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
68 **add-tag**.
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
69
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
70 list-tags [**-s** *syncdir*] *file*
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
71 : List all tags for the specified *file*.
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
72
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
73 # CONFIGURATION COMMANDS
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
74
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
75 add-directory
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
76 : Runs an interactive assistant to create a SyncDirectory.
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
77
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
78 list-directories
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
79 : Lists all available SyncDirectories.
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
80
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
81 check-config
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
82 : Validates the **$HOME/.dav/sync.xml** configuration file.
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
83
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
84 check-repositories
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
85 : Checks if every repository used by sync-directories is configured and
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
86 available. This command outputs the status for each repository. It returns
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
87 zero when all repositories are all available and non-zero otherwise.
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
88
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
89 # GENERAL OPTIONS
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
90
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
91 The following options can be used with all commands.
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
92
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
93 -v
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
94 : Verbose output.
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
95
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
96 # COMMAND OPTIONS
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
97
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
98 -c
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
99 : Disable conflict detection.
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
100
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
101 -d
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
102 : Don't lock the repository.
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
103
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
104 -l
438
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
105 : Lock the repository before access.
329d57cddae8 improves formatting of man pages
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
106
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
107 -s *syncdir*
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
108 : If multiple SyncDirectories contain a local file, this option must be used
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
109 to resolve the ambiguity.
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
110
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
111 -t *tags*
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
112 : Only sync files which have the specified tags.
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
113
439
e85c93b59d1c command documentation for dav-sync man page
Mike Becker <universe@uap-core.de>
parents: 438
diff changeset
114 -r
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
115 : Remove ressources not matching the tag filter.
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
116
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
117 # SEE ALSO
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
118
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
119 `dav` (1).
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
120
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
121 DavUtils full documentation: <https://davutils.sourceforge.io/>.
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents:
diff changeset
122

mercurial