README 4.04 KB
Newer Older
1

2 3 4 5 6 7 8 9 10
Contents: 
	REQUIREMENTS
	INSTALLATION
		libdns
		examples
		drill
	INFORMATION FOR SPECIFIC OPERATING SYSTEMS
		Mac OS X
		Solaris
11 12
	KNOWN ISSUES
		pyldns
13
        Your Support
14 15 16 17 18 19 20 21 22 23 24

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)
25 26
  - OpenSSL >= 0.9.7f for DANE support
  - OpenSSL >= 1.0.0  for ECDSA and GOST support
27 28 29 30 31 32 33
- 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>
34 35 36 37
3. ./configure --with-examples --with-drill
   (optionally compile python bindings too with: --with-pyldns)
4. make
5. make install
38 39


40
* Building from repository
41 42 43

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
44
needed to build everything can be found in README.git. Note that the actual
45 46 47
commands may be a little bit different on your machine. Most notably, you'll
need to run libtoolize (or glibtoolize). If you skip this step, you'll get
an error about missing config.sub.
48 49 50 51

* Developers
ldns is developed by the ldns team at NLnet Labs. This team currently
consists of:
52
  o Willem Toorop
53
  o Wouter Wijngaards
54
  o Matthijs Mekking
55

56
Former main developers:
57
  o Jelte Jansen
58 59
  o Miek Gieben

60 61
* Credits
We have received patches from the following people, thanks!
62
  o Bedrich Kosata
63 64 65 66 67 68
  o Erik Rozendaal
  o Håkan Olsson
  o Jakob Schlyter
  o Paul Wouters
  o Simon Vallet
  o Ondřej Surý
69 70 71 72
  o Karel Slany
  o Havard Eidnes
  o Leo Baltus
  o Dag-Erling Smørgrav
73 74


75
INFORMATION FOR SPECIFIC OPERATING SYSTEMS
76 77 78 79 80 81 82 83 84 85 86 87 88 89

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

90
In Solaris multi-architecture systems (which have both 32-bit and
91 92 93 94 95
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

96 97 98 99 100 101 102 103
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.
104
Also, when building with SWIG older than 2.0.4, compiling
105 106
pyldns produces many ``missing initializer'' warnings. Those are harmless
too.
107 108

Your Support
109 110
NLnet Labs offers all of its software products as open source, most
published under a BSD license. You can download them, not only from the
111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130
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/.