--- /dev/null
+README for Unbound on Windows.\r
+\r
+(C) 2009, W.C.A. Wijngaards, NLnet Labs.\r
+\r
+See LICENSE for the license text file.\r
+\r
+\r
++++ Introduction\r
+\r
+Unbound is a recursive DNS server. It does caching, full recursion, stub\r
+recursion, DNSSEC validation, NSEC3, IPv6. More information can be found \r
+at the http://unbound.net site. Unbound has been built and tested on \r
+Windows XP and Windows Vista.\r
+\r
+At http://unbound.net/documentation is an install and configuration manual\r
+for windows.\r
+\r
+email: unbound-bugs@nlnetlabs.nl\r
+\r
+\r
++++ How to use it\r
+\r
+In ControlPanels\SystemTasks\Services you can start/stop the daemon.\r
+In ControlPanels\SystemTasks\Logbooks you can see log entries (unless you\r
+configured unbound to log to file).\r
+\r
+By default the daemon provides service only to localhost. See the manual\r
+on how to change that (you need to edit the config file).\r
+\r
+To change options, edit the service.conf file. The example.conf file \r
+contains information on the various configuration options. The config\r
+file is the same as on Unix. The options log-time-ascii, chroot, username\r
+and pidfile are not supported on windows.\r
+\r
+\r
++++ How to compile\r
+\r
+Unbound is open source under the BSD license. You can compile it yourself.\r
+\r
+1. Install MinGW and MSYS. http://www.mingw.org\r
+This is a free, open source, compiler and build environment.\r
+Note, if your username contains a space, create a directory\r
+C:\msys\...\home\user to work in (click on MSYS; type: mkdir /home/user ).\r
+\r
+2. Install openssl, or compile it yourself. http://www.openssl.org\r
+Ldns and unbound need the header files and libraries. Static linking makes\r
+things easier. This is an open source library for cryptographic functions.\r
+\r
+3. Compile LDNS\r
+Get the source code tarball http://nlnetlabs.nl/ldns\r
+Move it into the C:\msys\...\home\user directory.\r
+Double click on the MSYS icon and give these commands\r
+$ cd /home/user\r
+$ tar xzvf ldns-xxx.tar.gz\r
+$ cd ldns-xxx\r
+$ ./configure\r
+If you compiled openssl yourself, pass --with-ssl=../openssl-xxx\r
+$ make\r
+\r
+4. Compile Unbound\r
+Get the source code tarball http://unbound.net\r
+Move it into the C:\msys\...\home\user directory.\r
+Double click on the MSYS icon and give these commands\r
+$ cd /home/user\r
+$ tar xzvf unbound-xxx.tar.gz\r
+$ cd unbound-xxx\r
+$ ./configure --enable-static-exe --with-ldns=../ldns-xxx\r
+ "--with-conf-file=C:\Program Files\Unbound\service.conf"\r
+ --with-pidfile="" --with-chroot-dir=""\r
+Put the entire command on one line; it is paginated for display here.\r
+If you compiled openssl yourself, pass --with-ssl=../openssl-xxx too.\r
+You can set the defaults for the config file and working directory with \r
+options to configure (see ./configure -h). Set chroot and pidfile to "".\r
+If you do not give these to configure you can edit the config file later.\r
+The configure options for libevent or threads are not applicable for \r
+windows, because builtin alternatives for the windows platform are used.\r
+$ make\r
+And you have unbound.exe\r
+\r
+If you run unbound-service-install.exe (double click in the explorer),\r
+unbound is installed as a service in the controlpanels\systemtasks\services,\r
+from the current directory. unbound-service-remove.exe uninstalls the service.\r
+\r
+Unbound and its utilities also work from the commandline (like on unix) if \r
+you prefer.\r
+\r
+\r
++++ CREDITS\r
+\r
+Unbound was written in portable C by Wouter Wijngaards (NLnet Labs).\r
+See the CREDITS file in the source package for more contributor information.\r
+Email unbound-bugs@nlnetlabs.nl\r
+\r
projects / thirdparty / unbound.git / commitdiff
