contrib/ldns/README

   1
   2 Contents:
   3         REQUIREMENTS
   4         INSTALLATION
   5                 libdns
   6                 examples
   7                 drill
   8         INFORMATION FOR SPECIFIC OPERATING SYSTEMS
   9                 Mac OS X
  10                 Solaris
  11         KNOWN ISSUES
  12                 pyldns
  13         Your Support
  14
  15 Project page:
  16 http://www.nlnetlabs.nl/ldns/
  17 On that page you can also subscribe to the ldns mailing list.
  18
  19 * Development
  20 ldns is mainly developed on Linux and FreeBSD. It is regularly tested to
  21 compile on other systems like Solaris and Mac OS X.
  22
  23 REQUIREMENTS
  24 - OpenSSL (Optional, but needed for features like DNSSEC)
  25   - OpenSSL >= 0.9.7f for DANE support
  26   - OpenSSL >= 1.0.0  for ECDSA and GOST support
  27 - libpcap (Optional, but needed for examples/ldns-dpa)
  28 - (GNU) libtool (in OSX, that's glibtool, not libtool)
  29 - GNU make
  30
  31 INSTALLATION
  32 1. Unpack the tarball
  33 2. cd ldns-<VERSION>
  34 3. ./configure --with-examples --with-drill
  35    (optionally compile python bindings too with: --with-pyldns)
  36 4. make
  37 5. make install
  38
  39
  40 * Building from repository
  41
  42 If you are building from the repository you will need to have (gnu)
  43 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 commands may be a little bit different on your machine. Most notably, you'll
  46 need to run libtoolize (or glibtoolize). If you skip this step, you'll get
  47 an error about missing config.sub.
  48
  49 * Developers
  50 ldns is developed by the ldns team at NLnet Labs. This team currently
  51 consists of:
  52   o Willem Toorop
  53   o Wouter Wijngaards
  54
  55 Former main developers:
  56   o Jelte Jansen
  57   o Miek Gieben
  58   o Matthijs Mekking
  59
  60 * Credits
  61 We have received patches from the following people, thanks!
  62   o Bedrich Kosata
  63   o Erik Rozendaal
  64   o Håkan Olsson
  65   o Jakob Schlyter
  66   o Paul Wouters
  67   o Simon Vallet
  68   o Ondřej Surý
  69   o Karel Slany
  70   o Havard Eidnes
  71   o Leo Baltus
  72   o Dag-Erling Smørgrav
  73   o Felipe Gasper
  74
  75
  76 INFORMATION FOR SPECIFIC OPERATING SYSTEMS
  77
  78 MAC OS X
  79
  80 For MACOSX 10.4 and later, it seems that you have to set the
  81 MACOSX_DEPLOYMENT_TARGET environment variable to 10.4 before running
  82 make. Apparently it defaults to 10.1.
  83
  84 This appears to be a known problem in 10.2 to 10.4, see:
  85 http://developer.apple.com/qa/qa2001/qa1233.html
  86 for more information.
  87
  88
  89 SOLARIS
  90
  91 In Solaris multi-architecture systems (which have both 32-bit and
  92 64-bit support), it can be a bit taxing to convince the system to
  93 compile in 64-bit mode. Jakob Schlyter has kindly contributed a build
  94 script that sets the right build and link options. You can find it in
  95 contrib/build-solaris.sh
  96
  97 KNOWN ISSUES
  98
  99 A complete list of currently known open issues can be found here:
 100 https://github.com/NLnetLabs/ldns/issues
 101
 102 * pyldns
 103 Compiling pyldns produces many ``unused parameter'' warnings.  Those are
 104 harmless and may safely be ignored.
 105 Also, when building with SWIG older than 2.0.4, compiling
 106 pyldns produces many ``missing initializer'' warnings. Those are harmless
 107 too.
 108
 109 Your Support
 110 NLnet Labs offers all of its software products as open source, most
 111 published under a BSD license. You can download them, not only from the
 112 NLnet Labs website but also through the various OS distributions for
 113 which NSD, ldns, and Unbound are packaged. We therefore have little idea
 114 who uses our software in production environments and have no direct ties
 115 with 'our customers'.
 116
 117 Therefore, we ask you to contact us at users@NLnetLabs.nl and tell us
 118 whether you use one of our products in your production environment,
 119 what that environment looks like, and maybe even share some praise.
 120 We would like to refer to the fact that your organization is using our
 121 products. We will only do that if you explicitly allow us. In all other
 122 cases we will keep the information you share with us to ourselves.
 123
 124 In addition to the moral support you can also support us
 125 financially. NLnet Labs is a recognized not-for-profit charity foundation
 126 that is chartered to develop open-source software and open-standards
 127 for the Internet. If you use our software to satisfaction please express
 128 that by giving us a donation. For small donations PayPal can be used. For
 129 larger and regular donations please contact us at users@NLnetLabs.nl. Also
 130 see http://www.nlnetlabs.nl/labs/contributors/.
 131