1238104Sdes 2238104SdesContents: 3238104Sdes REQUIREMENTS 4238104Sdes INSTALLATION 5238104Sdes libdns 6238104Sdes examples 7238104Sdes drill 8238104Sdes INFORMATION FOR SPECIFIC OPERATING SYSTEMS 9238104Sdes Mac OS X 10238104Sdes Solaris 11238104Sdes KNOWN ISSUES 12238104Sdes pyldns 13238104Sdes Your Support 14238104Sdes 15238104SdesProject page: 16238104Sdeshttp://www.nlnetlabs.nl/ldns/ 17238104SdesOn that page you can also subscribe to the ldns mailing list. 18238104Sdes 19238104Sdes* Development 20238104Sdesldns is mainly developed on Linux and FreeBSD. It is regularly tested to 21238104Sdescompile on other systems like Solaris and Mac OS X. 22238104Sdes 23238104SdesREQUIREMENTS 24238104Sdes- OpenSSL (Optional, but needed for features like DNSSEC) 25249307Sdes - OpenSSL >= 0.9.7f for DANE support 26249307Sdes - OpenSSL >= 1.0.0 for ECDSA and GOST support 27238104Sdes- libpcap (Optional, but needed for examples/ldns-dpa) 28238104Sdes- (GNU) libtool (in OSX, that's glibtool, not libtool) 29238104Sdes- GNU make 30238104Sdes 31238104SdesINSTALLATION 32238104Sdes1. Unpack the tarball 33238104Sdes2. cd ldns-<VERSION> 34249307Sdes3. ./configure --with-examples --with-drill 35249307Sdes (optionally compile python bindings too with: --with-pyldns) 36249307Sdes4. make 37249307Sdes5. make install 38238104Sdes 39238104Sdes 40269257Sdes* Building from repository 41238104Sdes 42238104SdesIf you are building from the repository you will need to have (gnu) 43238104Sdesautotools like libtool and autoreconf installed. A list of all the commands 44269257Sdesneeded to build everything can be found in README.git. Note that the actual 45238104Sdescommands 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. 46238104Sdes 47238104Sdes* Developers 48238104Sdesldns is developed by the ldns team at NLnet Labs. This team currently 49238104Sdesconsists of: 50238104Sdes o Willem Toorop 51238104Sdes o Wouter Wijngaards 52238104Sdes o Matthijs Mekking 53238104Sdes 54238104SdesFormer main developers: 55238104Sdes o Jelte Jansen 56238104Sdes o Miek Gieben 57238104Sdes 58238104Sdes* Credits 59238104SdesWe have received patches from the following people, thanks! 60238104Sdes o Bedrich Kosata 61238104Sdes o Erik Rozendaal 62238104Sdes o H��kan Olsson 63238104Sdes o Jakob Schlyter 64238104Sdes o Paul Wouters 65238104Sdes o Simon Vallet 66238104Sdes o Ond��ej Sur�� 67249307Sdes o Karel Slany 68249307Sdes o Havard Eidnes 69249307Sdes o Leo Baltus 70249307Sdes o Dag-Erling Sm��rgrav 71238104Sdes 72238104Sdes 73238104SdesINFORMATION FOR SPECIFIC OPERATING SYSTEMS 74238104Sdes 75238104SdesMAC OS X 76238104Sdes 77238104SdesFor MACOSX 10.4 and later, it seems that you have to set the 78238104SdesMACOSX_DEPLOYMENT_TARGET environment variable to 10.4 before running 79238104Sdesmake. Apparently it defaults to 10.1. 80238104Sdes 81238104SdesThis appears to be a known problem in 10.2 to 10.4, see: 82238104Sdeshttp://developer.apple.com/qa/qa2001/qa1233.html 83238104Sdesfor more information. 84238104Sdes 85238104Sdes 86238104SdesSOLARIS 87238104Sdes 88238104SdesIn Solaris multi-architecture systems (that have both 32-bit and 89238104Sdes64-bit support), it can be a bit taxing to convince the system to 90238104Sdescompile in 64-bit mode. Jakob Schlyter has kindly contributed a build 91238104Sdesscript that sets the right build and link options. You can find it in 92238104Sdescontrib/build-solaris.sh 93238104Sdes 94238104SdesKNOWN ISSUES 95238104Sdes 96238104SdesA complete list of currently known open issues can be found here: 97238104Sdeshttp://www.nlnetlabs.nl/projects/ldns/bugs 98238104Sdes 99238104Sdes* pyldns 100238104SdesCompiling pyldns produces many ``unused parameter'' warnings. Those are 101238104Sdesharmless and may safely be ignored. 102238104SdesAlso when building with Swig which version is before 2.0.4, compiling 103238104Sdespyldns produces many ``missing initializer'' warnings. Those are harmless 104238104Sdestoo. 105238104Sdes 106238104SdesYour Support 107238104SdesNLnet Labs offers all of its software products as open source, most are 108238104Sdespublished under a BDS license. You can download them, not only from the 109238104SdesNLnet Labs website but also through the various OS distributions for 110238104Sdeswhich NSD, ldns, and Unbound are packaged. We therefore have little idea 111238104Sdeswho uses our software in production environments and have no direct ties 112238104Sdeswith 'our customers'. 113238104Sdes 114238104SdesTherefore, we ask you to contact us at users@NLnetLabs.nl and tell us 115238104Sdeswhether you use one of our products in your production environment, 116238104Sdeswhat that environment looks like, and maybe even share some praise. 117238104SdesWe would like to refer to the fact that your organization is using our 118238104Sdesproducts. We will only do that if you explicitly allow us. In all other 119238104Sdescases we will keep the information you share with us to ourselves. 120238104Sdes 121238104SdesIn addition to the moral support you can also support us 122238104Sdesfinancially. NLnet Labs is a recognized not-for-profit charity foundation 123238104Sdesthat is chartered to develop open-source software and open-standards 124238104Sdesfor the Internet. If you use our software to satisfaction please express 125238104Sdesthat by giving us a donation. For small donations PayPal can be used. For 126238104Sdeslarger and regular donations please contact us at users@NLnetLabs.nl. Also 127238104Sdessee http://www.nlnetlabs.nl/labs/contributors/. 128238104Sdes 129