unbound/winrc/README.txt

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