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 - libpcap (Optional, but needed for examples/ldns-dpa)
  26 - (GNU) libtool (in OSX, that's glibtool, not libtool)
  27 - GNU make
  28
  29 INSTALLATION
  30 1. Unpack the tarball
  31 2. cd ldns-<VERSION>
  32 3. ./configure
  33 4. gmake (it needs gnu make to compile, on systems where GNU make is the
  34    default you can just use 'make')
  35 5. sudo gmake install
  36 6. Optional. (cd examples; ./configure; gmake), make example programs included.
  37 7. Optional. (cd drill; ./configure; gmake; gmake install), to build drill.
  38
  39 You can configure and compile it in a separate build directory.
  40
  41 * Examples
  42 There are some examples and dns related tools in the examples/ directory.
  43 These can be built with:
  44 1. cd examples/
  45 2. ./configure [--with-ldns=<path to ldns installation or build>]
  46 3. gmake
  47
  48 * Drill
  49 Drill can be built with:
  50 1. cd drill/
  51 2. ./configure [--with-ldns=<path to ldns installation or build>]
  52 3. gmake
  53
  54 Note that you need to set LD_LIBRARY_PATH if you want to run the binaries
  55 and you have not installed the library to a system directory. You can use
  56 the make target all-static for the examples to run them if you don't want to
  57 install the library.
  58
  59
  60 * Building from subversion repository
  61
  62 If you are building from the repository you will need to have (gnu)
  63 autotools like libtool and autoreconf installed. A list of all the commands
  64 needed to build everything can be found in README.svn. Note that the actual
  65 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.
  66
  67 * Developers
  68 ldns is developed by the ldns team at NLnet Labs. This team currently
  69 consists of:
  70   o Willem Toorop
  71   o Wouter Wijngaards
  72   o Matthijs Mekking
  73
  74 Former main developers:
  75   o Jelte Jansen
  76   o Miek Gieben
  77
  78 * Credits
  79 We have received patches from the following people, thanks!
  80   o Bedrich Kosata
  81   o Erik Rozendaal
  82   o Håkan Olsson
  83   o Jakob Schlyter
  84   o Paul Wouters
  85   o Simon Vallet
  86   o Ondřej Surý
  87
  88
  89 INFORMATION FOR SPECIFIC OPERATING SYSTEMS
  90
  91 MAC OS X
  92
  93 For MACOSX 10.4 and later, it seems that you have to set the
  94 MACOSX_DEPLOYMENT_TARGET environment variable to 10.4 before running
  95 make. Apparently it defaults to 10.1.
  96
  97 This appears to be a known problem in 10.2 to 10.4, see:
  98 http://developer.apple.com/qa/qa2001/qa1233.html
  99 for more information.
 100
 101
 102 SOLARIS
 103
 104 In Solaris multi-architecture systems (that have both 32-bit and
 105 64-bit support), it can be a bit taxing to convince the system to
 106 compile in 64-bit mode. Jakob Schlyter has kindly contributed a build
 107 script that sets the right build and link options. You can find it in
 108 contrib/build-solaris.sh
 109
 110 KNOWN ISSUES
 111
 112 A complete list of currently known open issues can be found here:
 113 http://www.nlnetlabs.nl/projects/ldns/bugs
 114
 115 * pyldns
 116 Compiling pyldns produces many ``unused parameter'' warnings.  Those are
 117 harmless and may safely be ignored.
 118 Also when building with Swig which version is before 2.0.4, compiling
 119 pyldns produces many ``missing initializer'' warnings. Those are harmless
 120 too.
 121
 122 Your Support
 123 NLnet Labs offers all of its software products as open source, most are
 124 published under a BDS license. You can download them, not only from the
 125 NLnet Labs website but also through the various OS distributions for
 126 which NSD, ldns, and Unbound are packaged. We therefore have little idea
 127 who uses our software in production environments and have no direct ties
 128 with 'our customers'.
 129
 130 Therefore, we ask you to contact us at users@NLnetLabs.nl and tell us
 131 whether you use one of our products in your production environment,
 132 what that environment looks like, and maybe even share some praise.
 133 We would like to refer to the fact that your organization is using our
 134 products. We will only do that if you explicitly allow us. In all other
 135 cases we will keep the information you share with us to ourselves.
 136
 137 In addition to the moral support you can also support us
 138 financially. NLnet Labs is a recognized not-for-profit charity foundation
 139 that is chartered to develop open-source software and open-standards
 140 for the Internet. If you use our software to satisfaction please express
 141 that by giving us a donation. For small donations PayPal can be used. For
 142 larger and regular donations please contact us at users@NLnetLabs.nl. Also
 143 see http://www.nlnetlabs.nl/labs/contributors/.
 144