1[![Build Status](https://travis-ci.org/farsightsec/wdns.png?branch=master)](https://travis-ci.org/farsightsec/wdns)
2
3Farsight wdns
4=============
5
6`wdns` is a low-level C library for dealing with wire-format dns packets.
7
8Contact information
9-------------------
10
11Questions about `wdns`, should be directed to the `wdns-dev` mailing list:
12
13https://lists.farsightsecurity.com/mailman/listinfo/wdns-dev
14
15Building and installing wdns
16----------------------------
17
18wdns has the following external dependencies:
19
20* [pcap](http://www.tcpdump.org/)
21
22* [pkg-config](https://wiki.freedesktop.org/www/Software/pkg-config/)
23
24On Debian systems, the following packages should be installed, if available:
25
26    pkg-config libpcap0.8-dev
27
28Note that on Debian systems, binary packages of wdns are available from
29[a Debian package repository maintained by Farsight Security](https://archive.farsightsecurity.com/SIE_Software_Installation_Debian/).
30These packages should be used in preference to building from source on
31Debian-based systems.
32
33On FreeBSD systems, the following ports should be installed, if available:
34
35    devel/pkgconf
36
37After satisfying the prerequisites, `./configure && make && make install` should
38compile and install `libwdns` in `/usr/local`. If building from a git checkout,
39run the `./autogen.sh` command first to generate the `configure` script.
40
41Examples
42--------
43
44C language examples are in the `examples/` directory.
45