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
  12 Project page:
  13 http://www.nlnetlabs.nl/ldns/
  14 On that page you can also subscribe to the ldns mailing list.
  15
  16 * Development
  17 ldns is mainly developed on Linux and FreeBSD. It is regularly tested to
  18 compile on other systems like Solaris and Mac OS X.
  19
  20 REQUIREMENTS
  21 - OpenSSL (Optional, but needed for features like DNSSEC)
  22 - libpcap (Optional, but needed for examples/ldns-dpa)
  23 - (GNU) libtool (in OSX, that's glibtool, not libtool)
  24 - GNU make
  25
  26 INSTALLATION
  27 1. Unpack the tarball
  28 2. cd ldns-<VERSION>
  29 3. ./configure
  30 4. gmake (it needs gnu make to compile, on systems where GNU make is the
  31    default you can just use 'make')
  32 5. sudo gmake install
  33 6. Optional. (cd examples; ./configure; gmake), make example programs included.
  34 7. Optional. (cd drill; ./configure; gmake; gmake install), to build drill.
  35
  36 You can configure and compile it in a separate build directory.
  37
  38 * Examples
  39 There are some examples and dns related tools in the examples/ directory.
  40 These can be built with:
  41 1. cd examples/
  42 2. ./configure [--with-ldns=<path to ldns installation or build>]
  43 3. gmake
  44
  45 * Drill
  46 Drill can be built with:
  47 1. cd drill/
  48 2. ./configure [--with-ldns=<path to ldns installation or build>]
  49 3. gmake
  50
  51 Note that you need to set LD_LIBRARY_PATH if you want to run the binaries
  52 and you have not installed the library to a system directory. You can use
  53 the make target all-static for the examples to run them if you don't want to
  54 install the library.
  55
  56
  57 * Building from subversion repository
  58
  59 If you are building from the repository you will need to have (gnu)
  60 autotools like libtool and autoreconf installed. A list of all the commands
  61 needed to build everything can be found in README.svn. Note that the actual
  62 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.
  63
  64 * Developers
  65 ldns is developed by the ldns team at NLnet Labs. This team currently
  66 consists of:
  67   o Jelte Jansen
  68   o Wouter Wijngaards
  69
  70 Former main developers:
  71   o Miek Gieben
  72
  73 * Credits
  74 We have received patches from the following people, thanks!
  75   o Erik Rozendaal
  76   o Håkan Olsson
  77   o Jakob Schlyter
  78   o Paul Wouters
  79   o Simon Vallet
  80   o Ondřej Surý
  81
  82
  83 IFORMATION FOR SPECIFIC OPERATING SYSTEMS
  84
  85 MAC OS X
  86
  87 For MACOSX 10.4 and later, it seems that you have to set the
  88 MACOSX_DEPLOYMENT_TARGET environment variable to 10.4 before running
  89 make. Apparently it defaults to 10.1.
  90
  91 This appears to be a known problem in 10.2 to 10.4, see:
  92 http://developer.apple.com/qa/qa2001/qa1233.html
  93 for more information.
  94
  95
  96 SOLARIS
  97
  98 In Solaris multi-architecture systems (that have both 32-bit and
  99 64-bit support), it can be a bit taxing to convince the system to
 100 compile in 64-bit mode. Jakob Schlyter has kindly contributed a build
 101 script that sets the right build and link options. You can find it in
 102 contrib/build-solaris.sh
 103