git.ipfire.org Git - thirdparty/pdns.git/blob

2 contributors, using the GNU GPLv2 license (see NOTICE for the

3 exact license and exception used).

5 All documentation can be found on http://doc.powerdns.com/

7 This file may lag behind at times. For most recent updates, always check

8 https://doc.powerdns.com/md/changelog/.

10 Another good place to look for information is:

11 https://doc.powerdns.com/md/appendix/compiling-powerdns/

13 To file bugs, head towards:

14 https://github.com/PowerDNS/pdns/issues

16 But please check if the issue is already reported there first.

18 SOURCE CODE / GIT

19 -----------------

20 Source code is available on GitHub:

22 ```

23 $ git clone https://github.com/PowerDNS/pdns.git

24 ```

26 This repository contains the sources for the PowerDNS Recursor, the PowerDNS

27 Authoritative Server, and dnsdist (a powerful DNS loadbalancer). All three can

28 be built from this repository. However, all three released separately as .tar.bz2,

29 .deb and .rpm.

31 COMPILING Authoritative Server

32 ------------------------------

33 The PowerDNS Authoritative Server depends on Boost, OpenSSL and requires a

34 compiler with C++-2011 support.

36 On Debian 8.0, the following is useful:

38 ```

39 $ apt-get install g++ libboost-all-dev libtool make pkg-config libmysqlclient-dev libssl-dev

40 ```

42 When building from git, the following packages are also required: autoconf, automake,

43 ragel, bison and flex, then generate the configure file:

45 ```

46 $ ./bootstrap

47 ```

49 To compile a very clean version, use:

51 ```

52 $ ./configure --with-modules="" --without-lua

53 $ make

54 # make install

55 ```

57 This generates a PowerDNS Authoritative Server binary with no modules built in.

59 When `./configure` is run without `--with-modules`, the bind and gmysql module are

60 built-in by default and the pipe-backend is compiled for runtime loading.

62 To add multiple modules, try:

64 ```

65 $ ./configure --with-modules="bind gmysql gpgsql"

66 ```

68 Note that you will need the development headers for PostgreSQL as well in this case.

70 See https://doc.powerdns.com/md/appendix/compiling-powerdns/ for more details.

72 If you run into C++11-related symbol trouble, please try passing `CPPFLAGS=-D_GLIBCXX_USE_CXX11_ABI=0` (or 1) to `./configure` to make sure you are compatible with the installed dependencies.

74 COMPILING THE RECURSOR

75 ----------------------

76 See the README in pdns/recursordist.

78 COMPILING DNSDIST

79 ----------------------

80 See the README in pdns/dnsdistdist.

82 SOLARIS NOTES

83 -------------

84 Use a recent gcc. OpenCSW is a good source, as is Solaris 11 IPS.

86 If you encounter problems with the Solaris make, gmake is advised.

88 FREEBSD NOTES

89 -------------

90 You need to compile using gmake - regular make only appears to work, but doesn't in fact. Use gmake, not make.

92 MAC OS X NOTES

93 --------------

94 PowerDNS Authoritative Server is available through Homebrew:

96 ```

97 $ brew install pdns

98 ```

100 If you want to compile yourself, the dependencies can be installed using

101 Homebrew:

102

103 ```

104 $ brew install boost lua pkg-config ragel

105 ```

106

107 For PostgreSQL support:

108

109 ```

110 $ brew install postgresql

111 ```

112

113 For MySQL support:

114

115 ```

116 $ brew install mariadb

117 ```

118

119 LINUX NOTES

120 -----------

121 None really.