external/bsd/bind/dist/win32utils/legacy/win32-build.txt

   1 Copyright (C) 2004, 2005, 2008, 2009, 2012-2014  Internet Systems Consortium, Inc. ("ISC")\r
   2 Copyright (C) 2001, 2002  Internet Software Consortium.\r
   3 See COPYRIGHT in the source root or http://isc.org/copyright.html for terms.\r
   4 \r
   5    *LEGACY* BIND 9.10 for Win32 Source Build Instructions. 04-Feb-2014\r
   6 \r
   7 Building BIND 9.10 on Windows using legacy compilers (up to Visual\r
   8 Studio 2008) has the following prerequisites:\r
   9 \r
  10 1) Perl, 2) Visual C++ redistributable object, 3) OpenSSL, and\r
  11 optionally 4) LibXML2, 5) LibGeoIP, and 6) Readline.\r
  12 See ..\build.txt for more details on these prerequisites.\r
  13 \r
  14 If you want to build using Visual C++ 6.0, you'll need some extra\r
  15 files that are to be found in the Platform SDK (which you will need\r
  16 to install), namely:\r
  17 \r
  18 iphlpapi.h\r
  19 iptypes.h\r
  20 ipexport.h\r
  21 iphlpapi.lib\r
  22 \r
  23 You'll also need an updated Iprtrmib.h - using the VC++6.0 one will\r
  24 get you some compilation errors. You can just overwrite the old one if\r
  25 you're not using it for any purposes, and maybe keep a backup of it. \r
  26 \r
  27 You can copy the header files under VC98\INCLUDE and the library file\r
  28 under VC98\LIB. I think you can also put them in a separate directory\r
  29 and add it to the include search list, but I don't know if that can be\r
  30 made persistent. \r
  31 \r
  32 For building on VC++ 7.0 or more recent, no extra files are required. \r
  33 \r
  34 The instructions assume a Visual C++ 6.0 compiler with Visual Studio\r
  35 and Visual Studio Service Pack 3 or later. It may build and work with\r
  36 earlier versions but it has not been tested. The binaries may be built\r
  37 and run on any of the following platforms: NT 4.0 Workstation (SP3 or\r
  38 later), NT 4.0 Server (SP3 or later), Windows 2000 Professional (SP1\r
  39 or later), Windows 2000 Server or any kind (SP1 or later), Windows XP,\r
  40 Windows 2003 Server, Windows Vista, Windows 2008 Server, Windows 7,\r
  41 Windows 2008 R2 Server, Windows 8, Windows 2012 Server (untested), and\r
  42 further (untested as not yet available). It will NOT build or run on\r
  43 Windows 95, Windows 98, etc., or Windows RT platforms.\r
  44 \r
  45 BUILDING BIND\r
  46 \r
  47 From the command prompt cd to the win32utils\legacy directory under\r
  48 the BIND9 root:\r
  49 \r
  50   cd bind-9.10.0\win32utils\legacy\r
  51 \r
  52 If you wish to use nmake from VC++ 6.0 or more recent, run\r
  53 the BuildAll.bat file:\r
  54 \r
  55   BuildAll\r
  56 \r
  57 This will do the following:\r
  58 1) Build the gen application in the lib/dns directory.\r
  59 2) Run the gen application and build the required lib/dns header\r
  60    files.\r
  61 3) Create the Build/Release subdirectory under the root of the BIND\r
  62    source tree which will hold the binaries being built.\r
  63 4) Build the libraries, named, application tools like dig, rndc\r
  64    dnssec tools, installer, checkconf and checkzones programs,\r
  65    BIND 9 Installer.\r
  66 5) Copies the release notes and the OpenSSL DLL to the BUILD/Release\r
  67    directory.\r
  68 6) Copies the BIND 9 ARM HTML files and the application HTML files\r
  69    to the Build\Release area.\r
  70 \r
  71 If you wish to use the Visual Studio GUI for building, you can just\r
  72 run the BuildSetup.bat file:\r
  73 \r
  74   BuildSetup\r
  75   \r
  76 This will create or find and copy into place several files which are\r
  77 necessary for the build to proceed.  It also locates and copies into place\r
  78 the DLLs for OpenSSL and libxml2.\r
  79 \r
  80 Use BINDBuild.dsw (also located in the win32utils\legacy directory) to\r
  81 open the workspace for all of the BIND9 libraries and applications. If\r
  82 needed Visual Studio will update the workspace (aka solution) and\r
  83 project files. Note it is known to give slightly incorrect files on VS\r
  84 2010 or more recent, for instance BINDInstall is not compiled to use\r
  85 DLLs.  Finally select "Build->Batch Build", click "Select All", then\r
  86 click "Build".\r
  87 \r
  88 After the build has completed, run the BuildPost.bat file:\r
  89 \r
  90   BuildPost\r
  91 \r
  92 ...which does post-build processing.\r
  93 \r
  94 Installation is accomplished by running the BINDInstall program. All\r
  95 DLL's are copied to the Program Files area and all applications\r
  96 (including BINDInstall which may be necessary for uninstalling BIND 9)\r
  97 to the bin directory.  If BIND 8 has previously been installed on the\r
  98 system it must be uninstalled first by running it's own BINDInstall\r
  99 program.  The BIND 9 installer does not yet do this.\r
 100 \r
 101 All bugs found, whether in the process of building the application or\r
 102 running BIND or the tools should be reported to the bind9 bugs email\r
 103 account at bind9-bugs@isc.org.\r