dklibs

Installation

dklibs.pdf tracecc.pdf

	Recommended libraries and software packages
	Download
	Configuration, Compilation and Installation on Unix systems
		Static libraries
		Shared libraries
			Shared libraries on Linux systems
			Shared libraries on Solaris systems using Sun Workshop compiler
		Perl-XS-modules
	Preparing a directory structure for package creation
	Installation on Win32 systems

Recommended libraries and software packages

Some of the modules can use the following libraries:

• zlib http://www.zlib.net
• libbz2 http://sources.redhat.com/bzip2/
• libpng http://www.libpng.org/pub/png/libpng.html
• JPEG lib ftp://ftp.uu.net/graphics/jpeg/
• NetPBM http://sourceforge.net/projects/netpbm
• Tiff library http://www.remotesensing.org/libtiff/

It is recommended to install all the libraries before compiling and installing the dklibs libraries.
Note: If you installed these packages using your OS vendors package management software make sure the header files... are also installed.
Some systems have separated packages: one for binaries and shared libraries and an additional one (mostly called "xxx developer support" or "xxx-devel") containing C header files and other material needed to compile programs using the libraries.

The Java run-time environment version 5 is needed to run the Tracecc GUI. Note: Previous versions are not sufficient.

Download

The software is available via the SourceForge.net project page at http://sourceforge.net/projects/dklibs.

Configuration, Compilation, Installation on Unix systems

Static libraries

The typical instruction set

./configure
make
make install

can be used to build and install the software.

Shared libraries

Building shared libraries and configuring your system to use the shared libraries requires some more skills than building static libraries.
If you want to use the Perl-XS-modules accessing the libraries I recommend to build the shared library versions.
The build and configuration mechanisms differ between different OSs, I can only give hints for Linux and Solaris.

Shared libraries on Linux systems

• Configure and build the software

  ./configure
  make -f Makefile-shared-linux
  make -f Makefile-shared-linux install
  

• Edit the file /etc/ld.so.conf.d/usr-local.conf (create the file if necessary). The file must contain one line:

  /usr/local/lib
  

• Reconfigure ld.so cache

  ldconfig
  

Shared libraries on Solaris systems using Sun Workshop compilers

• Configure and build the software

  ./configure
  make -f Makefile-shared-solaris-workshop
  make -f Makefile-shared-solaris-workshop install
  

• Modify your /etc/profile to include /usr/local/lib in the LD_LIBRARY_PATH environment variable, /usr/local/bin in PATH, /usr/local/man in MANPATH, -I/usr/local/include in CPPFLAGS and CFLAGS, -L/usr/local/lib in LDFLAGS.
  Depending on the shells in use at your systems you probably have to edit other shell startup files too.

Perl-XS-modules

The steps below assume the shared libraries are installed and ready to use.

• In the source directory execute the following commands in a sh or bash shell:

  cd perlxs
  for i in DKraus*
  do
  cd $i
  perl Makefile.PL
  make
  make install
  cd ..
  done
  

Preparing a directory tree to create a binary package

Run

./configure
make
make pp=/home/joe/package install

to create a directory tree in the /home/joe/package directory.

Installation on Win32 systems

Building the libraries and the programs using the libraries on Windows systems from source requires manual changes in makefiles. Good skills in using the development tools and a significant amount of time is needed to do that.
So it is recommended to use the setup program in dklibs-win32-*-setup.exe from http://sourceforge.net/projects/dklibs.
This program installs dklibs, dktools, bmeps, png2pdf, yanolc and genau.
There are two different setup programs:

• A small executable dklibs_win32-*-user-setup.exe to install software for users (binaries and documentation) and
• a larger executable dklibs-win32-*-dev-setup.exe to install the software for developers (binaries, documentation, libraries, used libraries and sources).

For both executables you can choose either english or german language.
If you plan to install the Perl-XS-modules, install the DLL support. Add C:\Program Files\Krause\dll-bin at the end of the PATH environment variable or copy the *.dll files to C:\Program Files\Krause\bin (which should be in the PATH). The installation of the Perl-XS-modules was not yet tested on Windows, the installation procedure depends strongly on the Perl installation method, the available C compiler... Manual modifications in the Makefile.PL and Makefile may be necessary...
In all this you are on your own, good skills in handling Perl installations and in using your C compiler are required.