Sat, 05 Aug 2017 10:19:53 +0200
refines commands.md
273
c743721d566f
more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
266
diff
changeset
|
1 | dav add-repository |
c743721d566f
more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
266
diff
changeset
|
2 | ================== |
c743721d566f
more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
266
diff
changeset
|
3 | |
276
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
4 | This command runs an interactive assistant that creates a repository [configuration][1] and adds it to the config.xml file. |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
5 | |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
6 | [1]: ./configuration.html |
273
c743721d566f
more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
266
diff
changeset
|
7 | |
c743721d566f
more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
266
diff
changeset
|
8 | **Command alias:** add-repo |
276
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
9 | |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
10 | The assistant firstly asks for a unique repository name. |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
11 | If you are not sure, which names are already in use, you can get a list of currently present repositories with [dav list-repositories][2]. |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
12 | Then you specifiy the base URL and optional authentication information. |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
13 | Please keep in mind, that the password is stored base64 encoded in your configuration. |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
14 | If you do not want this to happen, leave the password blank. |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
15 | `dav` will ask you for the password when accessing the repository. |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
16 | Beware that you don't use password prompt in background jobs, though. |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
17 | A call of `add-repository` may look like this. |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
18 | |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
19 | $ dav add-repository |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
20 | Each repository must have an unique name. |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
21 | name: myfirstrepo |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
22 | |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
23 | Specify the repository base url. |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
24 | url: https://mynas.local/webdav |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
25 | |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
26 | User for HTTP authentication. |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
27 | user (optional): mywebuser |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
28 | password (optional): |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
29 | |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
30 | [2]: ./list-repositories.html |
20a176d5a53e
adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents:
273
diff
changeset
|
31 |