From: Ian Jackson Date: Fri, 23 Jul 2021 10:01:16 +0000 (+0100) Subject: README.config: clarifications X-Git-Tag: hippotat/1.0.0~524 X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?p=hippotat.git;a=commitdiff_plain;h=3fb2f0ebe7bdb520f4df17d688155b909a2f7150 README.config: clarifications Signed-off-by: Ian Jackson --- diff --git a/README.config b/README.config index 3c3a169..42e623d 100644 --- a/README.config +++ b/README.config @@ -6,19 +6,30 @@ Sections [] [] often [SERVER] [COMMON] + [DEFAULT] Keys are looked up in that order, unless otherwise specified. is the client's virtual address. must be a valid DNS hostname and not look like an address. +Things not in a section are an error. -Both client and server read all files + +Both client and server read the files /etc/hippotat/main.cfg - /etc/hippotat/config.d - /etc/hippotat/server.d + /etc/hippotat/config.d/* + /etc/hippotat/secrets.d/* and in each case if it's a directory, all contained files whose names consists of only ascii alphanumerics plus '-' and '_'. + The ini file format sections from these files are all unioned. +Later files (in the list above, or alphabetically later) can +override settings from earlier ones. + +Note that although it is conventional for information for a particular +server or client to be in a file named after that endpoint, there is +no semantic link: all the files are always read and the appropriate +section from each is applied to every endpoint. (If main.cfg does not exist, master.cfg will be tried for backward compatibility reasons.)