Home | History | Annotate | Line # | Download | only in dist 
      1 # NSD
      2 
      3 [![GitHub Build Status](https://github.com/NLnetLabs/nsd/actions/workflows/build-test.yml/badge.svg?branch=master)](https://github.com/NLnetLabs/nsd/actions)
      4 [![Coverity Scan Status](https://scan.coverity.com/projects/18867/badge.svg)](https://scan.coverity.com/projects/nlnetlabs-nsd)
      5 [![Packaging status](https://repology.org/badge/tiny-repos/nsd.svg)](https://repology.org/project/nsd/versions)
      6 [![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/1462/badge)](https://bestpractices.coreinfrastructure.org/projects/1462)
      7 [![Mastodon Follow](https://img.shields.io/mastodon/follow/114692612288811644?domain=social.nlnetlabs.nl&style=social)](https://social.nlnetlabs.nl/@nlnetlabs)
      8 
      9 The NLnet Labs Name Server Daemon (NSD) is an authoritative DNS name server.
     10 It has been developed for operations in environments where speed,
     11 reliability, stability and security are of high importance.  If you
     12 have any feedback, we would love to hear from you. Dont hesitate to
     13 [create an issue on Github](https://github.com/NLnetLabs/nsd/issues/new)
     14 or post a message on the
     15 [NSD mailing list](https://lists.nlnetlabs.nl/mailman/listinfo/nsd-users).
     16 You can learn more about NSD by reading our
     17 [documentation](https://nsd.docs.nlnetlabs.nl/).
     18 
     19 ## Building
     20 
     21 Make sure you have the following installed:
     22   * C toolchain (the set of tools to compile C such as a compiler, linker, and assembler)
     23   * OpenSSL, with its include files (usually these are included in the "dev" version of the library)
     24   * libevent, with its include files (usually these are included in the "dev" version of the library)
     25   * flex
     26   * bison
     27 
     28 When building from Git, the `configure` script and [simdzone][simdzone]
     29 sources are missing, use the following commands to get started (note that the
     30 `configure` script and sources are included in release tarballs and do not
     31 need to be generated/downloaded):
     32 
     33 ```
     34 $ git submodule update --init
     35 $ autoreconf -fi
     36 ```
     37 
     38 > `autoreconf` should install the required auxiliary files (e.g. `config.sub`
     39 > and `config.guess`). Older versions of `autoreconf` may not do so, try
     40 > running `libtoolize -fi -c` first in that case.
     41 
     42 Compile and install using:
     43 
     44 ```
     45 $ ./configure && make && make install
     46 ```
     47 
     48 ## NSD configuration
     49 
     50 The configuration options for NSD are described in the man pages, which are
     51 installed (use `man nsd.conf`) and are available on the NSD
     52 [documentation page](https://nsd.docs.nlnetlabs.nl/).
     53 
     54 An example configuration file is located in
     55 [nsd.conf.sample](https://github.com/NLnetLabs/nsd/blob/master/nsd.conf.sample.in).
     56 
     57 
     58 [simdzone]: https://github.com/NLnetLabs/simdzone
     59