From ee7462a624adfd6e27407e462d2507b5420004e0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Vavru=C5=A1a?= <marek.vavrusa@nic.cz> Date: Fri, 10 Apr 2015 11:24:34 +0200 Subject: [PATCH] doc: added coverity badge and updated documentation --- README.md | 23 ++++++----------------- doc/build.rst | 4 ++++ 2 files changed, 10 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 2538c72b2..799df3888 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,8 @@ [](https://travis-ci.org/CZ-NIC/knot-resolver) [](https://coveralls.io/r/CZ-NIC/knot-resolver) +[](https://scan.coverity.com/projects/3912) + The Knot DNS Resolver is a minimalistic caching resolver implementation. The project provides both a resolver library and a small daemon. Modular architecture of the library keeps the core tiny and efficient, and provides @@ -24,31 +26,18 @@ See the build page [registry.hub.docker.com/u/cznic/knot-resolver](https://regis ### Building from sources -The Knot DNS Resolver [depends][depends] on the development version of the Knot DNS library. -Several dependencies may not be in the packages yet, the script pulls and installs all dependencies in a chroot. - -You can avoid rebuilding dependencies by specifying `BUILD_IGNORE` variable, see the [Dockerfile](scripts/Dockerfile) -for example. Usually you only really need to rebuild `libknot`. - -``` -$ export FAKEROOT="${HOME}/.local" -$ export PKG_CONFIG_PATH="${FAKEROOT}/lib/pkgconfig" -$ ./scripts/bootstrap-depends.sh ${FAKEROOT} -$ make -$ make check -``` +The Knot DNS Resolver [depends][depends] on the pre-release version of the Knot DNS library and other projects. +See the [Building project][depends] documentation page for more information. ### Running -There is a separate resolver library in the `lib` directory, and a daemon in the `daemon` directory. +The project builds a resolver library in the `lib` directory, and a daemon in the `daemon` directory. ``` $ ./daemon/kresolved -h -$ ./daemon/kresolved -a "127.0.0.1#53" +$ ./daemon/kresolved [working_directory] ``` -### More - See the documentation at [knot-resolver.readthedocs.org][doc]. [depends]: http://knot-resolver.readthedocs.org/en/latest/build.html diff --git a/doc/build.rst b/doc/build.rst index 2dd426ce3..9bae20c73 100644 --- a/doc/build.rst +++ b/doc/build.rst @@ -93,6 +93,10 @@ Usually you only really need to rebuild `libknot`. $ make check libknot_CFLAGS="-I/opt/include" libknot_LIBS="-L/opt/lib -lknot -lknot-int -ldnssec" +.. note:: If the dependencies lie outside of library search path, you need to add them somehow. + Try ``LD_LIBRARY_PATH`` on Linux/BSD, and ``DYLD_FALLBACK_LIBRARY_PATH`` on OS X. Otherwise you might + need to add the locations to the linker search path. + When you have all the dependencies ready, you can build, test and install. .. code-block:: bash -- GitLab