101 lines
3.6 KiB
Plaintext
101 lines
3.6 KiB
Plaintext
README for Unbound on Windows.
|
|
|
|
(C) 2009, W.C.A. Wijngaards, NLnet Labs.
|
|
|
|
See LICENSE for the license text file.
|
|
|
|
|
|
+++ Introduction
|
|
|
|
Unbound is a recursive DNS server. It does caching, full recursion, stub
|
|
recursion, DNSSEC validation, NSEC3, IPv6. More information can be found
|
|
at the http://unbound.net site. Unbound has been built and tested on
|
|
Windows XP, Vista and 7.
|
|
|
|
At http://unbound.net/documentation is an install and configuration manual
|
|
for windows.
|
|
|
|
email: unbound-bugs@nlnetlabs.nl
|
|
|
|
|
|
+++ How to use it
|
|
|
|
In ControlPanels\SystemTasks\Services you can start/stop the daemon.
|
|
In ControlPanels\SystemTasks\Logbooks you can see log entries (unless you
|
|
configured unbound to log to file).
|
|
|
|
By default the daemon provides service only to localhost. See the manual
|
|
on how to change that (you need to edit the config file).
|
|
|
|
To change options, edit the service.conf file. The example.conf file
|
|
contains information on the various configuration options. The config
|
|
file is the same as on Unix. The options log-time-ascii, chroot, username
|
|
and pidfile are not supported on windows.
|
|
|
|
|
|
+++ How to compile
|
|
|
|
Unbound is open source under the BSD license. You can compile it yourself.
|
|
|
|
1. Install MinGW and MSYS. http://www.mingw.org
|
|
This is a free, open source, compiler and build environment.
|
|
Note, if your username contains a space, create a directory
|
|
C:\msys\...\home\user to work in (click on MSYS; type: mkdir /home/user ).
|
|
|
|
2. Install openssl, or compile it yourself. http://www.openssl.org
|
|
Unbounds need the header files and libraries. Static linking makes
|
|
things easier. This is an open source library for cryptographic functions.
|
|
And libexpat is needed.
|
|
|
|
3. Compile Unbound
|
|
Get the source code tarball http://unbound.net
|
|
Move it into the C:\msys\...\home\user directory.
|
|
Double click on the MSYS icon and give these commands
|
|
$ cd /home/user
|
|
$ tar xzvf unbound-xxx.tar.gz
|
|
$ cd unbound-xxx
|
|
$ ./configure --enable-static-exe
|
|
If you compiled openssl yourself, pass --with-ssl=../openssl-xxx too.
|
|
If you compiled libexpat yourself, pass --with-libexpat=../expat-install too.
|
|
The configure options for libevent or threads are not applicable for
|
|
windows, because builtin alternatives for the windows platform are used.
|
|
$ make
|
|
And you have unbound.exe
|
|
|
|
If you run unbound-service-install.exe (double click in the explorer),
|
|
unbound is installed as a service in the controlpanels\systemtasks\services,
|
|
from the current directory. unbound-service-remove.exe uninstalls the service.
|
|
|
|
Unbound and its utilities also work from the commandline (like on unix) if
|
|
you prefer.
|
|
|
|
|
|
+++ Cross compile
|
|
|
|
You can crosscompile unbound. This results in .exe files.
|
|
Install the packages: mingw32-binutils mingw32-cpp mingw32-filesystem
|
|
mingw32-gcc mingw32-openssl mingw32-openssl-static mingw32-runtime zip
|
|
mingw32-termcap mingw32-w32api mingw32-zlib mingw32-zlib-static mingw32-nsis
|
|
(package names for fedora 11).
|
|
|
|
For dynamic linked executables
|
|
$ mingw32-configure
|
|
$ make
|
|
$ mkdir /home/user/installdir
|
|
$ make install DESTDIR=/home/user/installdir
|
|
Find the dlls and exes in /home/user/installdir and
|
|
crypto in /usr/i686-pc-mingw32/sys-root/mingw/bin
|
|
|
|
For static linked executables
|
|
Use --enable-staticexe for mingw32-configure, see above. Or use makedist.sh,
|
|
copy System.dll from the windows dist of NSIS to /usr/share/nsis/Plugins/
|
|
Then do ./makedist.sh -w and the setup.exe is created using nsis.
|
|
|
|
|
|
+++ CREDITS
|
|
|
|
Unbound was written in portable C by Wouter Wijngaards (NLnet Labs).
|
|
See the CREDITS file in the source package for more contributor information.
|
|
Email unbound-bugs@nlnetlabs.nl
|
|
|