This file documents the tools (scripts) we use for building Bacula for
Microsoft Windows using the cross-compiler tools on a Linux system. We
-use Fedora Core 5 and SuSE so those should definitely work. But there
+use Ubuntu 8.04 so building on that system should definitely work. But there
shouldn't be any issues on other Linux distributions.
We don't officially support this script, but it is what we use, and it should
build on any Linux machine if you carefully follow the instructions and have
all the prerequisite programs loaded on your machine.
-It has also been tested on other systems such as FreeBSD and CentOS. We
-expect that there may be problems on systems other than Linux where you
+It has also been tested on other systems such as FreeBSD, CentOS, Fedora, and SUSE.
+We expect that there may be problems on systems other than Linux where you
are pretty much on your own. However, we will try to provide responses to
your questions on the bacula-devel list, but we can't guarantee anything.
depkgs-mingw32 (MinGW32) 3rd Party Dependencies for MinGW32 build
or
depkgs-msvc (MS VC++) 3rd Party Dependencies for Microsoft VC++ build.
- bin --
+ bin -- NOTE! depkgs-msvc is no longer suppored
include |
lib |
man | Created by script
extracted the contents of the source tar. If not you need to do that first.
You also need to download one of the doc tar balls and extract to your
-top level Bacula directory. It is referred to as bacula-top in the
-diagram located in README.win32. It will be signified in this file as ...
+top level Bacula directory.
The extracted doc directory name will be bacula-docs-version where version
is the version number. The directory must be renamed to docs (ie remove
postgresql (at least client)
mysql (at least client)
SQLite3 (from depkgs or as package)
+ readline (readlineN-dev on Debian)
...
+NB: On Debian, I had to remove /usr/bin/lorder for
+postresql to build correctly.
+
Once the source is on your system, change to the win32 directory
cd .../bacula/src/win32
problem.
You need the header files from the Microsoft VSS SDK. Unfortunately the SDK
-can only be downloaded and installed on a Windows system. You can find it on
-Microsoft's web-site at:
+can only be downloaded and installed on a Windows system. We do not have
+the right to distribute it, so you must download it yourself.
+You can find it on Microsoft's web-site at:
http://www.microsoft.com/downloads/details.aspx?FamilyID=0b4f56e4-0ccc-4626-826a-ed2c4c95c871&DisplayLang=en
texinfo
bison
flex
+ python
+ unzip
+ tar
and possibly other packages.
make
If all goes well, you will end with all the executables in the
-.../bacula/src/win32/release directory.
+.../bacula/src/win32/release directory, and the installer binary
+containing everything will be named winbacula-xx.yy.zz.exe where
+xx.yy.zz is the Bacula version you are building.
If you have an older build environment, you might do the following
to ensure that you pick up all the new Win32 changes:
cd src/win32
make
-The installer is now built as part of the default rule when you
-say "make" in the src/win32 directory.
-
Updating the 3rd party package patches
======================================
New data variables are exported by adding the macro DLL_IMP_EXP to
the variable declaration in the header file. All exported variables
must be declared in a header file and MUST NOT be declared in a
-source file referencing the variable.
+source file referencing the variable. Example, src/lib/runscript.h:
+
+extern DLL_IMP_EXP bool (*console_command)(JCR *jcr, const char *cmd);
+
+or src/jcr.h
+
+extern int DLL_IMP_EXP num_jobs_run;
+extern DLL_IMP_EXP dlist * last_jobs;
+...
+
Exporting functions is now more or less automated. If you find that
a function name has been added, changed, or an argument modified,
simply do the following:
- cd .../bacula/src/win32/dll
+ cd .../bacula/src/win32/lib
make (to build the .o files, note the link will fail)
./make_def >bacula.def
Exporting a function requires a bit more work. You must determine the
C++ mangled name of the new function.
- strings .../bacula/src/win32/dll/<file>.o | grep <symbol>
+ strings .../bacula/src/win32/lib/<file>.o | grep <symbol>
Note, strings often will not show the desired symbol. In that case,
use:
- nm .../bacula/src/win32/dll/<file>.o
+ nm .../bacula/src/win32/lib/<file>.o
Replace <file> with the base part of the name of the source code file
which contains the new function. Replace <symbol> with the name of
the new function. Remove the leading underscore and place the result
in the file
- .../bacula/src/win32/dll/bacula.def
+ .../bacula/src/win32/lib/bacula.def
=== end manual changing of bacula.def ==========
If you add a new file, you will need to specify its name in
- .../bacula/src/win32/dll/Makefile
+ .../bacula/src/win32/lib/Makefile
and
.../bacula/src/win32/libbac/Makefile
Note, strings often will not show the desired symbol. In that case,
use:
- nm .../bacula/src/win32/dll/<file>.o
+ nm .../bacula/src/win32/lib/<file>.o
Replace <file> with the base part of the name of the source code file
which contains the new function. Replace <symbol> with the name of
=== end manual changing of bacula_cats.def ==========
+Running gdb on the Win32 files
+==================================================
+You can use the mingw32 gdb to debug Bacula on Win32 by downloading
+it from Source Forge:
+
+http://sourceforge.net/project/showfiles.php?group_id=2435&package_id=20507
+
+Download one of their .exe versions, which is an installer that you
+can run on Win32 to install gdb. This gdb is built with mingw32 so will
+run independently of any cygwin installation. Note, not all the releases
+come with an installer. I had to go back 3 or 4 versions to find it. Otherwise
+you can download the source and build it. Thanks to Eric Bollengier for
+this tip.
+
+
Structure of the MinGW32 build environment
==========================================