3 **libeconf** is a highly flexible and configurable library to parse and
4 manage key=value configuration files.
5 It reads configuration file snippets from different directories and builds
6 the final configuration file for the application from it.
8 The first file is the vendor provided configuration file. There are
9 two methods of overriding this vendor settings: Copy the file from
10 /usr/_vendordir_ to /etc and modify the settings (see *Example 1*).
11 Alternatively, a directory named _file_._suffix_.d/ within /etc can be created,
12 with drop-in files in the form _name_._suffix_ (see *Example 2*).
13 These files contain only the changes of the specific settings the user is
14 interested in. There can be several such drop-in files, they are processed in
15 lexicographic order of their filename.
17 The first method is useful to override the complete configuration file with an
18 own one, the vendor supplied configuration is ignored.
20 So, if /etc/_example_._suffix_ exists, /usr/_vendor_/_example_._suffix_ and
21 /usr/_vendor_/_example_._suffix_.d/*._suffix_ will not be read.
22 The disadvantage is, that changes of the vendor configuration file, due e.g.
23 an package update, are ignored and the user has to manually merge them.
25 The other method will continue to use /usr/_vendor_/_example_._suffix_ as base
26 configuration file and merge all changes from /etc/_example_._suffix_.d/*._suffix_.
27 So the user will automatically get improvements of the vendor, with the drawback,
28 that they could be incompatible with the user made changes.
32 If a /etc/_example_._suffix_ files exists:
34 * /etc/_example_._suffix_
35 * /etc/_example_._suffix_.d/*._suffix_
40 The list of files and directories read if **no** /etc/_example_._suffix_ file
43 * /usr/_vendor_/_example_._suffix_
44 * /usr/_vendor_/_example_._suffix_.d/*._suffix_
45 * /etc/_example_._suffix_.d/*._suffix_
49 The API is written in plain C. The description can be found here :https://opensuse.github.io/libeconf/