README

   1 PowerDNS is copyright 2011 by PowerDNS.COM BV
   2
   3 This file may lag behind at times. For most recent updates, always check
   4 http://doc.powerdns.com/changelog.html and http://wiki.powerdns.com
   5
   6 Another good place to look for information is:
   7 http://doc.powerdns.com/compiling-powerdns.html
   8
   9 To file bugs, head towards:
  10
  11         http://wiki.powerdns.com/projects/trac/newticket
  12
  13 but first check existing ones:
  14
  15         http://wiki.powerdns.com/projects/trac/report/1
  16
  17 COMPILING
  18 ---------
  19 PowerDNS 3.0 and beyond depend on Lua and Boost. To get these libraries,
  20 install the relevant packages. On Debian and Ubunty, try:
  21
  22 # apt-get install g++ libboost-program-options-dev
  23   libboost-serialization-dev libpqclient-dev libmysqlclient-dev
  24   libsqlite3-dev libpq-dev
  25
  26 To compile a very clean version, use:
  27
  28 $ ./configure --with-modules=""
  29 $ make
  30 # make install
  31
  32 This generates a PowerDNS binary with no modules, except the bind backend,
  33 built in, and the pipe-backend available for runtime loading.
  34
  35 When ./configure is run without --with-modules, the gmysql module is
  36 built-in by default and the pipe-backend is compiled for runtime loading.
  37
  38 To add multiple modules, try:
  39
  40 $ ./configure --with-modules="gmysql gpgsql"
  41
  42 See http://rtfm.powerdns.com/compiling-powerdns.html for more details.
  43
  44 Please don't use the 'mysql' backend, it is deprecated. Use the 'gmysql'
  45 one!
  46
  47 SUBVERSION / CVS
  48 ----------------
  49
  50 If you need code from SVN read HACKING
  51
  52 SOLARIS NOTES
  53 -------------
  54 You need gcc 3.x, preferably 3.2! The 'Sunpro' compiler is currently not
  55 supported (patches are welcome if not too intrusive).
  56
  57 If you encounter problems with the Solaris make, gmake is advised
  58
  59 IPv6 is broken in Solaris 2.7, use 2.8 or higher for that. PowerDNS on
  60 Solaris 2.7 won't even serve AAAA records.
  61
  62 FREEBSD NOTES
  63 -------------
  64 gcc 2.95.x works. You need to compile using gmake - regular make only
  65 appears to work, but doesn't in fact. Use gmake, not make.
  66
  67 pipebackend does not work due to bad interaction between fork and pthreads.
  68 Amazingly, running the Linux version under the linuxulator DOES work!
  69
  70 LINUX NOTES
  71 -----------
  72 None really.
  73
  74 WIN32 NOTES
  75 -----------
  76 See http://rtfm.powerdns.com/compiling-powerdns.html#ON-WINDOWS
  77
  78 Needs Visual C++
  79
  80 ---
  81
  82 After compiling, you may find the file 'pdns/pdns' helpful, we suggest you
  83 place it in /etc/init.d/ or your operating system's equivalent.
  84