About

Libkolabxml is the reference implementation of the Kolab XML Format as defined in http://wiki.kolab.org/User:Mollekopf/Drafts/KEP:17.

It provides serialization/deserialization from/to in-memory representations for all Kolab Objects, including input validation.

Bindings

Based on SWIG (www.swig.org) various language-bindings are provided.

Usage

For more information about the usage please see src/kolabformat.h

Building

Build with:

$ mkdir build $ cd build $ cmake .. $ make

CMake options

Options can either be supplied on the commandline or edited in the cmake cache.

Library installation path:

LIB_INSTALL_DIR=/usr/lib

Note that LIB_SUFFIX is honored since version 1.0.2

Set the installation prefix:

CMAKE_INSTALL_PREFIX=/usr

Installation location for header files:

INCLUDE_INSTALL_DIR=/usr/include

Building of bindings can be controlled using cmake configuration options:

PYTHON_BINDINGS
PHP_BINDINGS
JAVA_BINDINGS
CSHARP_BINDINGS

The path to install the bindings:

PYTHON_INSTALL_DIR
PHP_INSTALL_DIR
JAVA_INSTALL_DIR
CSHARP_INSTALL_DIR

Example

Find libraries in lib64, install to /usr/lib64, build python and phpbindings:

$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DLIB_INSTALL_DIR=/usr/lib64 \

-DPYTHON_BINDINGS=TRUE \
-DPYTHON_INSTALL_DIR=/usr/lib64/python$x.$y/site-packages/ \
-DPHP_BINDINGS=TRUE ..

Requirements

Minimum requirements are:

• cmake 2.6
• boost >= 1.41
• xerces-c >= 3.0
• cxx >= 3.0 (http://www.codesynthesis.com/products/xsd/)
• libcurl

For further features:

• SWIG >= 2.0

For building test (controlled by -DBUILD_TESTS=TRUE):

• Qt >= 4.7

For further information see src/DEVELOPMENT.