libbzip2

Since r2814 (March 2009) GiBUU depends on libbz2 for reading compressed bz2 files. GiBUU is usually compiled statically (exception: Mac), so the static library libbz2.a is required. This is a standard library, and may already be present on your system. If it is not, you have the following options:

• The most convenient way is to install the libbz2 packages (usually 'libbz2' and 'libbz2-devel' or similar) via your Linux distribution's package management tool (which requires root access or a friendly admin). Unfortunately many distributions don't include the static library in their packages any more.

• If you don't have root access, your admin is not friendly or your OS is not Linux, you may instead get the bzip2 sources from ​http://www.bzip.org/ and compile it yourself. libbz2.a must be put someplace where the compiler can find it (e.g. in /usr/lib, /usr/lib64, /usr/local/lib, /usr/local/lib64 or GiBUU/workingCode/objects/LIB/lib).

This should usually be sufficient for compiling GiBUU. However, in the case that you want to compile a 32-bit GiBUU binary on a 64-bit system, you may get errors like:

ld: skipping incompatible /usr/lib64/libbz2.a when searching for -lbz2
ld: cannot find -lbz2 

If this happens, you need to build a 32-bit version of libbz2.a in addition to the 64-bit version that comes with your system. This requires the following steps:

1. Get the the bzip2 sources from ​http://www.bzip.org/ and unpack them somewhere.
2. In the bzip2 Makefile add "-m32" to CFLAGS (which tells the compiler to generate 32-bit code).
3. Type 'make' to build the library.
4. Copy the just built libbz2.a to /usr/lib or GiBUU/workingCode/objects/LIB/lib.

Two have both the 32-bit and the 64-bit version of libbz2.a installed on your system permanently, you can e.g. put one of them into /usr/lib and the other one in /usr/lib64.

For the GiBUU developers, who work with the 'workingCode' sources via svn, it is also possible to get proper bz2 libraries via:

• "make buildBZIP2" (64-bit version)
• "make buildBZIP2_32" (32-bit version)

This automates the above steps, but is not available in GiBUU's open source releases, since they don't include the bz2 sources.