Developing

Getting the source code

$ git clone https://github.com/GlobalCyberAlliance/pdns
$ cd pdns
$ git checkout -b dnsdist-named-caches origin/dnsdist-named-caches

Building dnsdist with the named caches feature

Build dependencies

OS X/macOS

The following items can be installed using Homebrew:

ragel
boost
openssl
libtool
tinycdb
automake
libsodium
re2 (if compiling with --enable-re2)
luajit (if compiling with --with-luajit, which you should be)

Linux

Arch Linux

The package names for the build dependencies on Arch Linux are identical to those for OS X.

CentOS 7.3

First, you will need to enable the EPEL repositories, and then re-build your yum(8) cache:

$ sudo yum install -y epel-release
$ sudo yum makecache

Next, install the following packages:

"@Development Tools" — this is a package group, and it contains stuff like Git, m4, automake, etc.
boost-devel
libedit-devel
libsodium-devel
luajit-devel
openssl-devel
protobuf-devel
ragel-devel
re2-devel
tinycdb-devel

The following packages are also required, but should be already installed:

libtool

Optional:

python-virtualenv (for building documentation)

Build commands

The following commands will result in an unstripped dnsdist binary:

$ cd pdns/dnsdistdist
$ autoreconf -i
$ ./configure --with-luajit --enable-dnscrypt --enable-libsodium --enable-re2  --with-libboost --enable-namedcache
$ make

NOTE: OSX users must run export CPPFLAGS="-D_DARWIN_C_SOURCE" before running above because of an XCode 9 bug.

NOTE: The --with-luajit flag is recommended, as that is what we are using in production.

NOTE: The flags provided to ./configure are the same flags that are currently being used when built for production.