aboutsummaryrefslogtreecommitdiff
path: root/contrib/unbound/README.md
diff options
context:
space:
mode:
authorDag-Erling Smørgrav <des@FreeBSD.org>2019-07-04 08:40:10 +0000
committerDag-Erling Smørgrav <des@FreeBSD.org>2019-07-04 08:40:10 +0000
commite86b9096262054dbb4228fb94def3728edcc8a37 (patch)
tree38011feac90fc25a7214578f3afe100de515941f /contrib/unbound/README.md
parent9f011bca829751ed3552ac94fe7c865d75fabfc4 (diff)
parent366b94c4a9552acfb560d3234aea0955ebc1eb8e (diff)
downloadsrc-e86b9096262054dbb4228fb94def3728edcc8a37.tar.gz
src-e86b9096262054dbb4228fb94def3728edcc8a37.zip
Upgrade Unbound to 1.9.2.
Notes
Notes: svn path=/head/; revision=349720
Diffstat (limited to 'contrib/unbound/README.md')
-rw-r--r--contrib/unbound/README.md37
1 files changed, 37 insertions, 0 deletions
diff --git a/contrib/unbound/README.md b/contrib/unbound/README.md
new file mode 100644
index 000000000000..b3d3424c99ff
--- /dev/null
+++ b/contrib/unbound/README.md
@@ -0,0 +1,37 @@
+# Unbound
+
+[![Travis Build Status](https://travis-ci.org/NLnetLabs/unbound.svg?branch=master)](https://travis-ci.org/NLnetLabs/unbound)
+[![Packaging status](https://repology.org/badge/tiny-repos/unbound.svg)](https://repology.org/project/unbound/versions)
+
+Unbound is a validating, recursive, caching DNS resolver. It is designed to be
+fast and lean and incorporates modern features based on open standards. If you
+have any feedback, we would love to hear from you. Don’t hesitate to
+[create an issue on Github](https://github.com/NLnetLabs/unbound/issues/new)
+or post a message on the [Unbound mailing list](https://nlnetlabs.nl/mailman/listinfo/unbound-users).
+You can lean more about Unbound by reading our
+[documentation](https://nlnetlabs.nl/documentation/unbound/).
+
+## Compiling
+
+Make sure you have the C toolchain, OpenSSL and its include files, and libexpat
+installed. Unbound can be compiled and installed using:
+
+```
+./configure && make && make install
+```
+
+You can use libevent if you want. libevent is useful when using many (10000)
+outgoing ports. By default max 256 ports are opened at the same time and the
+builtin alternative is equally capable and a little faster.
+
+Use the `--with-libevent=dir` configure option to compile Unbound with libevent
+support.
+
+## Unbound configuration
+
+All of Unbound's configuration options are described in the man pages, which
+will be installed and are available on the Unbound
+[documentation page](https://nlnetlabs.nl/documentation/unbound/).
+
+An example configuration file is located in
+[doc/example.conf](https://github.com/NLnetLabs/unbound/blob/master/doc/example.conf.in).