From d8392b01d3d30bf346ba6e6c0e7d816d309f68c5 Mon Sep 17 00:00:00 2001 From: Wouter Wijngaards Date: Thu, 19 Mar 2009 11:04:50 +0000 Subject: [PATCH] windows README git-svn-id: file:///svn/unbound/trunk@1535 be551aaa-1e26-0410-a405-d3ace91eadb9 --- doc/Changelog | 3 ++ doc/README | 3 +- makedist.sh | 4 +-- winrc/README.txt | 93 ++++++++++++++++++++++++++++++++++++++++++++++++ winrc/setup.nsi | 2 ++ 5 files changed, 101 insertions(+), 4 deletions(-) create mode 100644 winrc/README.txt diff --git a/doc/Changelog b/doc/Changelog index 4bacbcd74..3ed94921c 100644 --- a/doc/Changelog +++ b/doc/Changelog @@ -1,3 +1,6 @@ +19 March 2009: Wouter + - winrc/README.txt dos-format text file. + 18 March 2009: Wouter - Added tests, unknown algorithms become insecure. fallback works. - Fix for and test for unknown algorithms in a trust anchor diff --git a/doc/README b/doc/README index c62447b45..da84d4756 100644 --- a/doc/README +++ b/doc/README @@ -72,8 +72,7 @@ o If libevent is older (before 1.3c), unbound will exit instead of reload on sighup. On a restart 'did not exit gracefully last time' warning is printed. Perform ./configure --with-libevent=no or update libevent, rerun configure and recompile unbound to make sighup work correctly. - It is strongly suggested to use the latest version of libevent (1.4 or more) - on Solaris, because of fixes in the solaris event port code in libevent. + It is strongly suggested to use a recent version of libevent. o If you are not receiving the correct source IP address on replies (e.g. you are running a multihomed, anycast server), the interface-automatic option can be enabled to set socket options to achieve the correct diff --git a/makedist.sh b/makedist.sh index 056debd1d..445f78358 100755 --- a/makedist.sh +++ b/makedist.sh @@ -191,9 +191,9 @@ if [ "$DOWIN" = "yes" ]; then strip unbound-service-remove.exe cd tmp.$$ cp ../doc/example.conf example.conf - cp ../unbound.exe ../unbound-host.exe ../unbound-control.exe ../unbound-checkconf.exe ../unbound-service-install.exe ../unbound-service-remove.exe ../LICENSE ../winrc/unbound-website.url ../winrc/service.conf . + cp ../unbound.exe ../unbound-host.exe ../unbound-control.exe ../unbound-checkconf.exe ../unbound-service-install.exe ../unbound-service-remove.exe ../LICENSE ../winrc/unbound-website.url ../winrc/service.conf ../winrc/README.txt . # zipfile - zip ../$file LICENSE unbound.exe unbound-host.exe unbound-control.exe unbound-checkconf.exe unbound-service-install.exe unbound-service-remove.exe example.conf service.conf unbound-website.url + zip ../$file LICENSE README.txt unbound.exe unbound-host.exe unbound-control.exe unbound-checkconf.exe unbound-service-install.exe unbound-service-remove.exe example.conf service.conf unbound-website.url info "Testing $file" (cd .. ; zip -T $file ) # installer diff --git a/winrc/README.txt b/winrc/README.txt new file mode 100644 index 000000000..1b7cb3e10 --- /dev/null +++ b/winrc/README.txt @@ -0,0 +1,93 @@ +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 and Windows Vista. + +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 +Ldns and unbound need the header files and libraries. Static linking makes +things easier. This is an open source library for cryptographic functions. + +3. Compile LDNS +Get the source code tarball http://nlnetlabs.nl/ldns +Move it into the C:\msys\...\home\user directory. +Double click on the MSYS icon and give these commands +$ cd /home/user +$ tar xzvf ldns-xxx.tar.gz +$ cd ldns-xxx +$ ./configure +If you compiled openssl yourself, pass --with-ssl=../openssl-xxx +$ make + +4. 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 --with-ldns=../ldns-xxx + "--with-conf-file=C:\Program Files\Unbound\service.conf" + --with-pidfile="" --with-chroot-dir="" +Put the entire command on one line; it is paginated for display here. +If you compiled openssl yourself, pass --with-ssl=../openssl-xxx too. +You can set the defaults for the config file and working directory with +options to configure (see ./configure -h). Set chroot and pidfile to "". +If you do not give these to configure you can edit the config file later. +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. + + ++++ 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 + diff --git a/winrc/setup.nsi b/winrc/setup.nsi index deefaef6d..088454e9f 100644 --- a/winrc/setup.nsi +++ b/winrc/setup.nsi @@ -89,6 +89,7 @@ section "-hidden.postinstall" # copy files setOutPath $INSTDIR File "..\LICENSE" + File "README.txt" File "..\unbound.exe" File "..\unbound-checkconf.exe" File "..\unbound-control.exe" @@ -169,6 +170,7 @@ section "un.Unbound" DeleteRegKey HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\Unbound" Delete "$INSTDIR\uninst.exe" # delete self Delete "$INSTDIR\LICENSE" + Delete "$INSTDIR\README.txt" Delete "$INSTDIR\unbound.exe" Delete "$INSTDIR\unbound-checkconf.exe" Delete "$INSTDIR\unbound-control.exe" -- 2.47.3