145 lines
4.7 KiB
Plaintext
145 lines
4.7 KiB
Plaintext
|
|
||
|
|
Contents:
|
||
|
|
REQUIREMENTS
|
||
|
|
INSTALLATION
|
||
|
|
libdns
|
||
|
|
examples
|
||
|
|
drill
|
||
|
|
INFORMATION FOR SPECIFIC OPERATING SYSTEMS
|
||
|
|
Mac OS X
|
||
|
|
Solaris
|
||
|
|
KNOWN ISSUES
|
||
|
|
pyldns
|
||
|
|
Your Support
|
||
|
|
|
||
|
|
Project page:
|
||
|
|
http://www.nlnetlabs.nl/ldns/
|
||
|
|
On that page you can also subscribe to the ldns mailing list.
|
||
|
|
|
||
|
|
* Development
|
||
|
|
ldns is mainly developed on Linux and FreeBSD. It is regularly tested to
|
||
|
|
compile on other systems like Solaris and Mac OS X.
|
||
|
|
|
||
|
|
REQUIREMENTS
|
||
|
|
- OpenSSL (Optional, but needed for features like DNSSEC)
|
||
|
|
- libpcap (Optional, but needed for examples/ldns-dpa)
|
||
|
|
- (GNU) libtool (in OSX, that's glibtool, not libtool)
|
||
|
|
- GNU make
|
||
|
|
|
||
|
|
INSTALLATION
|
||
|
|
1. Unpack the tarball
|
||
|
|
2. cd ldns-<VERSION>
|
||
|
|
3. ./configure
|
||
|
|
4. gmake (it needs gnu make to compile, on systems where GNU make is the
|
||
|
|
default you can just use 'make')
|
||
|
|
5. sudo gmake install
|
||
|
|
6. Optional. (cd examples; ./configure; gmake), make example programs included.
|
||
|
|
7. Optional. (cd drill; ./configure; gmake; gmake install), to build drill.
|
||
|
|
|
||
|
|
You can configure and compile it in a separate build directory.
|
||
|
|
|
||
|
|
* Examples
|
||
|
|
There are some examples and dns related tools in the examples/ directory.
|
||
|
|
These can be built with:
|
||
|
|
1. cd examples/
|
||
|
|
2. ./configure [--with-ldns=<path to ldns installation or build>]
|
||
|
|
3. gmake
|
||
|
|
|
||
|
|
* Drill
|
||
|
|
Drill can be built with:
|
||
|
|
1. cd drill/
|
||
|
|
2. ./configure [--with-ldns=<path to ldns installation or build>]
|
||
|
|
3. gmake
|
||
|
|
|
||
|
|
Note that you need to set LD_LIBRARY_PATH if you want to run the binaries
|
||
|
|
and you have not installed the library to a system directory. You can use
|
||
|
|
the make target all-static for the examples to run them if you don't want to
|
||
|
|
install the library.
|
||
|
|
|
||
|
|
|
||
|
|
* Building from subversion repository
|
||
|
|
|
||
|
|
If you are building from the repository you will need to have (gnu)
|
||
|
|
autotools like libtool and autoreconf installed. A list of all the commands
|
||
|
|
needed to build everything can be found in README.svn. Note that the actual
|
||
|
|
commands may be a little bit different on your machine. Most notable, you'll need to run libtoolize (or glibtoolize), if you skip this step, you'll get an error about missing config.sub.
|
||
|
|
|
||
|
|
* Developers
|
||
|
|
ldns is developed by the ldns team at NLnet Labs. This team currently
|
||
|
|
consists of:
|
||
|
|
o Willem Toorop
|
||
|
|
o Wouter Wijngaards
|
||
|
|
o Matthijs Mekking
|
||
|
|
|
||
|
|
Former main developers:
|
||
|
|
o Jelte Jansen
|
||
|
|
o Miek Gieben
|
||
|
|
|
||
|
|
* Credits
|
||
|
|
We have received patches from the following people, thanks!
|
||
|
|
o Bedrich Kosata
|
||
|
|
o Erik Rozendaal
|
||
|
|
o Håkan Olsson
|
||
|
|
o Jakob Schlyter
|
||
|
|
o Paul Wouters
|
||
|
|
o Simon Vallet
|
||
|
|
o Ondřej Surý
|
||
|
|
|
||
|
|
|
||
|
|
INFORMATION FOR SPECIFIC OPERATING SYSTEMS
|
||
|
|
|
||
|
|
MAC OS X
|
||
|
|
|
||
|
|
For MACOSX 10.4 and later, it seems that you have to set the
|
||
|
|
MACOSX_DEPLOYMENT_TARGET environment variable to 10.4 before running
|
||
|
|
make. Apparently it defaults to 10.1.
|
||
|
|
|
||
|
|
This appears to be a known problem in 10.2 to 10.4, see:
|
||
|
|
http://developer.apple.com/qa/qa2001/qa1233.html
|
||
|
|
for more information.
|
||
|
|
|
||
|
|
|
||
|
|
SOLARIS
|
||
|
|
|
||
|
|
In Solaris multi-architecture systems (that have both 32-bit and
|
||
|
|
64-bit support), it can be a bit taxing to convince the system to
|
||
|
|
compile in 64-bit mode. Jakob Schlyter has kindly contributed a build
|
||
|
|
script that sets the right build and link options. You can find it in
|
||
|
|
contrib/build-solaris.sh
|
||
|
|
|
||
|
|
KNOWN ISSUES
|
||
|
|
|
||
|
|
A complete list of currently known open issues can be found here:
|
||
|
|
http://www.nlnetlabs.nl/projects/ldns/bugs
|
||
|
|
|
||
|
|
* pyldns
|
||
|
|
Compiling pyldns produces many ``unused parameter'' warnings. Those are
|
||
|
|
harmless and may safely be ignored.
|
||
|
|
Also when building with Swig which version is before 2.0.4, compiling
|
||
|
|
pyldns produces many ``missing initializer'' warnings. Those are harmless
|
||
|
|
too.
|
||
|
|
|
||
|
|
Your Support
|
||
|
|
NLnet Labs offers all of its software products as open source, most are
|
||
|
|
published under a BDS license. You can download them, not only from the
|
||
|
|
NLnet Labs website but also through the various OS distributions for
|
||
|
|
which NSD, ldns, and Unbound are packaged. We therefore have little idea
|
||
|
|
who uses our software in production environments and have no direct ties
|
||
|
|
with 'our customers'.
|
||
|
|
|
||
|
|
Therefore, we ask you to contact us at users@NLnetLabs.nl and tell us
|
||
|
|
whether you use one of our products in your production environment,
|
||
|
|
what that environment looks like, and maybe even share some praise.
|
||
|
|
We would like to refer to the fact that your organization is using our
|
||
|
|
products. We will only do that if you explicitly allow us. In all other
|
||
|
|
cases we will keep the information you share with us to ourselves.
|
||
|
|
|
||
|
|
In addition to the moral support you can also support us
|
||
|
|
financially. NLnet Labs is a recognized not-for-profit charity foundation
|
||
|
|
that is chartered to develop open-source software and open-standards
|
||
|
|
for the Internet. If you use our software to satisfaction please express
|
||
|
|
that by giving us a donation. For small donations PayPal can be used. For
|
||
|
|
larger and regular donations please contact us at users@NLnetLabs.nl. Also
|
||
|
|
see http://www.nlnetlabs.nl/labs/contributors/.
|
||
|
|
|