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