From d6b9ae6c46e16e5f9f3bd90f6fb95e5c2d0bb343 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Vavru=C5=A1a?= <marek.vavrusa@nic.cz> Date: Tue, 8 Dec 2015 19:38:36 +0100 Subject: [PATCH] doc: documented default paths --- doc/build.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/doc/build.rst b/doc/build.rst index 55d93032b..819a54e0b 100644 --- a/doc/build.rst +++ b/doc/build.rst @@ -135,6 +135,25 @@ The build system supports both DESTDIR_ and `amalgamated builds <https://www.sql .. note:: Amalgamated build assembles everything in one source file and compiles it. It is useful for packages, as the compiler sees the whole program and is able to produce a smaller and faster binary. On the other hand, it complicates debugging. +Default paths +~~~~~~~~~~~~~ + +The default installation follows FHS with several custom paths for configuration and modules. +All paths are prefixed with ``PREFIX`` variable by default if not specified otherwise. + + .. csv-table:: + :header: "Component", "Variable", "Default", "Notes" + + "library", "``LIBDIR``", "``$(PREFIX)/lib``", "Built statically." + "daemon", "``BINDIR``", "``$(PREFIX)/bin``", "" + "configuration", "``ETCDIR``", "``$(PREFIX)/etc/kresd``", "Configuration file, templates." + "modules", "``MODULEDIR``", "``$(LIBDIR)/kdns_modules``", "[#]_" + "work directory", "", "``$(PREFIX)/var/run/kresd``", "Run directory for daemon." + +.. [#] Users may install additional modules in ``~/.local/lib/kdns_modules`` or in the rundir of a specific instance. + +.. note:: Each module is self-contained and may install additional bundled files within ``$(MODULEDIR)/$(modulename)``. These files should be read-only, non-executable. + Building dependencies ~~~~~~~~~~~~~~~~~~~~~ -- GitLab