dnsfunnel

What is it ?

dnsfunnel is a small daemon listening to DNS client requests over UDP (typically from the libc's getaddrinfo() function) and forwards them to a list of DNS caches. It provides the client with the first answer it gets, trimming the answer so it fits in an UDP packet.

dnsfunnel is especially useful for distributions using the musl libc, which does not support TCP DNS transport. It was originally written to be used in the Alpine Linux distribution.

Installation

Requirements

A POSIX-compliant system with a standard C development environment.
GNU make, version 3.81 or later
skalibs version 2.10.0.0 or later. It's a build-time requirement. It's also a run-time requirement if you link against the shared version of the skalibs library.
s6-dns version 2.3.4.0 or later. It's a build-time requirement. It's also a run-time requirement if you link against the shared version of the s6dns library.

Licensing

dnsfunnel is free software. It is available under the ISC license.

Download

The current released version of dnsfunnel is 0.0.1.0. (This is a lie. dnsfunnel is in alpha development at the moment, and only available through git.)
Alternatively, you can checkout a copy of the dnsfunnel git repository:
```
 git clone git://git.skarnet.org/dnsfunnel 
```
There's also a GitHub mirror of the dnsfunnel git repository.

Compilation

See the enclosed INSTALL file for installation details.

Upgrade notes

This page lists the differences to be aware of between the previous versions of dnsfunnel and the current one.

Reference

Commands

Related resources

dnsfunnel is discussed on the skaware mailing-list.