wownero/external/unbound/winrc

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