• file
• latest
• revisions
• annotate
• diff
• comparison
• raw

docs/src/add-repository.md@30d484806c2b (annotated)

docs/src/add-repository.md

Sun, 17 Dec 2023 15:33:50 +0100

author

Mike Becker <universe@uap-core.de>

date

Sun, 17 Dec 2023 15:33:50 +0100

changeset 800

30d484806c2b

parent 283

0e36bb75a732

permissions

-rw-r--r--

fix faulty string to int conversion utilities

Probably it was expected that errno is set to EINVAL when illegal characters are encountered. But this is not standard and does not happen on every system, allowing illegal strings to be parsed as valid integers.

283 0e36bb75a732 adds dav-sync introduction and sync.xml documentation Olaf Wintermann <olaf.wintermann@gmail.com> parents: 276 diff changeset	1	---
0e36bb75a732 adds dav-sync introduction and sync.xml documentation Olaf Wintermann <olaf.wintermann@gmail.com> parents: 276 diff changeset	2	title: 'dav add-repository'
0e36bb75a732 adds dav-sync introduction and sync.xml documentation Olaf Wintermann <olaf.wintermann@gmail.com> parents: 276 diff changeset	3	---
273 c743721d566f more documentation Olaf Wintermann <olaf.wintermann@gmail.com> parents: 266 diff changeset	4
276 20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	5	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	6
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	7	[1]: ./configuration.html
273 c743721d566f more documentation Olaf Wintermann <olaf.wintermann@gmail.com> parents: 266 diff changeset	8
c743721d566f more documentation Olaf Wintermann <olaf.wintermann@gmail.com> parents: 266 diff changeset	9	**Command alias:** add-repo
276 20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	10
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	11	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	12	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	13	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	14	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	15	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	16	`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	17	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	18	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	19
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	20	$ dav add-repository
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	21	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	22	name: myfirstrepo
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	23
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	24	Specify the repository base url.
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	25	url: https://mynas.local/webdav
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	26
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	27	User for HTTP authentication.
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	28	user (optional): mywebuser
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	29	password (optional):
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	30
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	31	[2]: ./list-repositories.html
20a176d5a53e adds more details to add-directory.md Mike Becker <universe@uap-core.de> parents: 273 diff changeset	32