1README for Unbound on Windows. 2 3(C) 2009, W.C.A. Wijngaards, NLnet Labs. 4 5See LICENSE for the license text file. 6 7 8+++ Introduction 9 10Unbound is a recursive DNS server. It does caching, full recursion, stub 11recursion, DNSSEC validation, NSEC3, IPv6. More information can be found 12at the http://unbound.net site. Unbound has been built and tested on 13Windows XP, Vista, 7 and 8. 14 15At http://unbound.net/documentation is an install and configuration manual 16for windows. 17 18email: unbound-bugs@nlnetlabs.nl 19 20 21+++ How to use it 22 23In ControlPanels\SystemTasks\Services you can start/stop the daemon. 24In ControlPanels\SystemTasks\Logbooks you can see log entries (unless you 25configured unbound to log to file). 26 27By default the daemon provides service only to localhost. See the manual 28on how to change that (you need to edit the config file). 29 30To change options, edit the service.conf file. The example.conf file 31contains information on the various configuration options. The config 32file is the same as on Unix. The options log-time-ascii, chroot, username 33and pidfile are not supported on windows. 34 35 36+++ How to compile 37 38Unbound is open source under the BSD license. You can compile it yourself. 39 401. Install MinGW and MSYS. http://www.mingw.org 41This is a free, open source, compiler and build environment. 42Note, if your username contains a space, create a directory 43C:\msys\...\home\user to work in (click on MSYS; type: mkdir /home/user ). 44 452. Install openssl, or compile it yourself. http://www.openssl.org 46Unbounds need the header files and libraries. Static linking makes 47things easier. This is an open source library for cryptographic functions. 48And libexpat is needed. 49 503. Compile Unbound 51Get the source code tarball http://unbound.net 52Move it into the C:\msys\...\home\user directory. 53Double click on the MSYS icon and give these commands 54$ cd /home/user 55$ tar xzvf unbound-xxx.tar.gz 56$ cd unbound-xxx 57$ ./configure --enable-static-exe 58If you compiled openssl yourself, pass --with-ssl=../openssl-xxx too. 59If you compiled libexpat yourself, pass --with-libexpat=../expat-install too. 60The configure options for libevent or threads are not applicable for 61windows, because builtin alternatives for the windows platform are used. 62$ make 63And you have unbound.exe 64 65If you run unbound-service-install.exe (double click in the explorer), 66unbound is installed as a service in the controlpanels\systemtasks\services, 67from the current directory. unbound-service-remove.exe uninstalls the service. 68 69Unbound and its utilities also work from the commandline (like on unix) if 70you prefer. 71 72 73+++ Cross compile 74 75You can crosscompile unbound. This results in .exe files. 76Install the packages: mingw32-binutils mingw32-cpp mingw32-filesystem 77mingw32-gcc mingw32-openssl mingw32-openssl-static mingw32-runtime zip 78mingw32-termcap mingw32-w32api mingw32-zlib mingw32-zlib-static mingw32-nsis 79(package names for fedora 11). 80 81For dynamic linked executables 82$ mingw32-configure 83$ make 84$ mkdir /home/user/installdir 85$ make install DESTDIR=/home/user/installdir 86Find the dlls and exes in /home/user/installdir and 87crypto in /usr/i686-pc-mingw32/sys-root/mingw/bin 88 89For static linked executables 90Use --enable-staticexe for mingw32-configure, see above. Or use makedist.sh, 91copy System.dll from the windows dist of NSIS to /usr/share/nsis/Plugins/ 92Then do ./makedist.sh -w and the setup.exe is created using nsis. 93 94 95+++ CREDITS 96 97Unbound was written in portable C by Wouter Wijngaards (NLnet Labs). 98See the CREDITS file in the source package for more contributor information. 99Email unbound-bugs@nlnetlabs.nl 100 101