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