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   o Matthijs Mekking
  55
  56 Former main developers:
  57   o Jelte Jansen
  58   o Miek Gieben
  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
  74
  75 INFORMATION FOR SPECIFIC OPERATING SYSTEMS
  76
  77 MAC OS X
  78
  79 For MACOSX 10.4 and later, it seems that you have to set the
  80 MACOSX_DEPLOYMENT_TARGET environment variable to 10.4 before running
  81 make. Apparently it defaults to 10.1.
  82
  83 This appears to be a known problem in 10.2 to 10.4, see:
  84 http://developer.apple.com/qa/qa2001/qa1233.html
  85 for more information.
  86
  87
  88 SOLARIS
  89
  90 In Solaris multi-architecture systems (which have both 32-bit and
  91 64-bit support), it can be a bit taxing to convince the system to
  92 compile in 64-bit mode. Jakob Schlyter has kindly contributed a build
  93 script that sets the right build and link options. You can find it in
  94 contrib/build-solaris.sh
  95
  96 KNOWN ISSUES
  97
  98 A complete list of currently known open issues can be found here:
  99 http://www.nlnetlabs.nl/projects/ldns/bugs
 100
 101 * pyldns
 102 Compiling pyldns produces many ``unused parameter'' warnings.  Those are
 103 harmless and may safely be ignored.
 104 Also, when building with SWIG older than 2.0.4, compiling
 105 pyldns produces many ``missing initializer'' warnings. Those are harmless
 106 too.
 107
 108 Your Support
 109 NLnet Labs offers all of its software products as open source, most
 110 published under a BSD license. You can download them, not only from the
 111 NLnet Labs website but also through the various OS distributions for
 112 which NSD, ldns, and Unbound are packaged. We therefore have little idea
 113 who uses our software in production environments and have no direct ties
 114 with 'our customers'.
 115
 116 Therefore, we ask you to contact us at users@NLnetLabs.nl and tell us
 117 whether you use one of our products in your production environment,
 118 what that environment looks like, and maybe even share some praise.
 119 We would like to refer to the fact that your organization is using our
 120 products. We will only do that if you explicitly allow us. In all other
 121 cases we will keep the information you share with us to ourselves.
 122
 123 In addition to the moral support you can also support us
 124 financially. NLnet Labs is a recognized not-for-profit charity foundation
 125 that is chartered to develop open-source software and open-standards
 126 for the Internet. If you use our software to satisfaction please express
 127 that by giving us a donation. For small donations PayPal can be used. For
 128 larger and regular donations please contact us at users@NLnetLabs.nl. Also
 129 see http://www.nlnetlabs.nl/labs/contributors/.
 130