2007-01-31 06:58:25 +00:00
|
|
|
README for Unbound @version@
|
2007-01-03 09:17:12 +00:00
|
|
|
Copyright 2007 NLnet Labs
|
|
|
|
http://unbound.net
|
|
|
|
|
|
|
|
This software is under BSD license, see LICENSE for details.
|
|
|
|
|
2007-05-25 12:02:37 +00:00
|
|
|
* Download the latest version of this software from
|
|
|
|
http://unbound.net
|
|
|
|
or get a beta version from the svn repository at
|
|
|
|
http://unbound.net/svn/
|
|
|
|
|
2007-10-18 13:05:41 +00:00
|
|
|
* Uses the following libraries;
|
2007-01-03 09:27:01 +00:00
|
|
|
* ldns http://www.nlnetlabs.nl/ldns/ (BSD license)
|
|
|
|
* libevent http://www.monkey.org/~provos/libevent/ (BSD license)
|
2007-01-03 09:17:12 +00:00
|
|
|
|
2007-05-25 12:02:37 +00:00
|
|
|
* Create build environment
|
2007-08-09 15:23:36 +00:00
|
|
|
* run libtoolize -c if config.sub is missing, or run glibtoolize.
|
2007-05-25 12:02:37 +00:00
|
|
|
* autoreconf (autoheader && autoconf), if ./configure is missing.
|
|
|
|
|
2007-06-13 11:14:20 +00:00
|
|
|
* Make and install: ./configure; make; make install
|
2007-11-19 11:04:05 +00:00
|
|
|
* Use GNU make; default on linux, often called 'gmake' on BSD and Solaris.
|
2007-01-03 09:17:12 +00:00
|
|
|
* --with-ldns=/path/to/ldns
|
2007-11-15 14:27:47 +00:00
|
|
|
If ldns is not detected on the system, a prepackaged tarball
|
2007-10-18 13:05:41 +00:00
|
|
|
of the ldns library is used to compile and statically link against.
|
|
|
|
If detected on the system, it will dynamically link against it.
|
2007-02-19 10:07:52 +00:00
|
|
|
* --with-libevent=/path/to/libevent
|
|
|
|
Can be set to either the system install or the build directory.
|
2007-05-25 12:02:37 +00:00
|
|
|
--with-libevent=no gives a builtin alternative implementation.
|
2007-11-19 11:04:05 +00:00
|
|
|
libevent is useful when having many (thousands) of outgoing ports.
|
|
|
|
This improves randomization and spoof resistance. For the default
|
|
|
|
of 16 ports the builtin alternative works well.
|
2007-05-25 12:02:37 +00:00
|
|
|
* --without-pthreads
|
|
|
|
This disables pthreads, and uses Solaris thr library or no threading.
|
|
|
|
Without this option the pthreads library is detected automatically.
|
2007-06-13 11:14:20 +00:00
|
|
|
* --enable-static-exe
|
|
|
|
This enables a debug option to statically link, against ldns and
|
|
|
|
libevent libraries.
|
2007-08-14 13:33:41 +00:00
|
|
|
* --enable-lock-checks
|
|
|
|
This enables a debug option to check lock and unlock calls. It needs
|
|
|
|
a recent pthreads library to work.
|
2007-09-05 13:52:23 +00:00
|
|
|
* --enable-alloc-checks
|
|
|
|
This enables a debug option to check malloc (calloc, realloc, free).
|
|
|
|
The server periodically checks if the amount of memory used fits with
|
|
|
|
the amount of memory it thinks it should be using, and reports
|
|
|
|
memory usage in detail.
|
2007-01-03 09:17:12 +00:00
|
|
|
|
2007-09-24 08:04:05 +00:00
|
|
|
* 'make test' attempts to run a series of tests, depending on the support
|
|
|
|
programs that are installed.
|
|
|
|
|
2007-03-02 09:48:31 +00:00
|
|
|
Known issues
|
|
|
|
------------
|
2007-08-16 09:33:35 +00:00
|
|
|
o If libevent is older (before 1.3c), unbound will exit instead of reload
|
2007-03-02 09:48:31 +00:00
|
|
|
on sighup. On a restart 'did not exit gracefully last time' warning is
|
|
|
|
printed. Perform ./configure --with-libevent=no or update libevent, rerun
|
|
|
|
configure and recompile unbound to make sighup work correctly.
|
|
|
|
|
2007-05-25 12:02:37 +00:00
|
|
|
Acknowledgements
|
|
|
|
----------------
|
|
|
|
o Thanks to David Blacka and Matt Larson (Verisign) for the unbound-java
|
|
|
|
prototype. Design and code from that prototype has been used to create
|
|
|
|
this program. Such as the iterator state machine and the cache design.
|
2007-05-25 12:25:15 +00:00
|
|
|
o Other code origins are from the NSD (NLnet Labs) and LDNS (NLnet Labs)
|
|
|
|
projects. Such as buffer, region-allocator and red-black tree code.
|
2007-05-25 12:02:37 +00:00
|
|
|
o See Credits file for contributors.
|
|
|
|
|
2007-11-12 13:58:34 +00:00
|
|
|
* mailto:unbound-bugs@nlnetlabs.nl
|