XCOM Installation

This document explains how to install XCOM on a Linux machine for development purposes. Assumes that you have the basic linux command line usage.

Requirements

XCOM currently tested on GCC 4.1.1 compilers. But versions above that and some below should work either. For building CMake must be already installed.

Building XCOM

You should have two source packages names similar to xcom-yyyymmdd.tgz and xcomidl-yyyymmdd.tgz. Extracting them creates two directories xcom and xcomidl respectively. We refer to the directory into which you extracted the packages as home. Create two directories with names whatever you choose, but we refer them as xcomBuild and xcomidlBuild respectively.

Go to the directory ${xcomBuild} and type:

$ cmake ${home}/xcom
$ make

This will result in libxcom.so generated in some directory below. You can now install the headers and the produced library to a convenient place using the command where installdir specifies where the files are copied:

$ make install DESTDIR=installdir

This command places the header files to installdir/include and library files to installdir/lib which we refer as ${xcom.includes} and ${xcom.libs} respectively. The ${xcom.libs} directory must be placed to LD_LIBRARY_PATH environment variable.

Go to the directory ${xcomidlBuild} and type:

$ cmake -DXCOM_INCLUDE_DIR=${xcom.includes} -DXCOM_LIBRARY_DIR=${xcom.libs} ${home}/xcomidl
$ make

This will result in xcomidl and required shared libraries (xcom_{parser, cppgen}.so) generated in some directory below.

The executable and libraries can be installed using the command:

$ make install DESTDIR=installdir

This command places the executable to installdir/bin and library files to installdir/lib which we refer as ${xcomidl.bin} and ${xcomidl.libs} respectively.

The last step is to create a file named xcomidl.config in the directory same as the xcomidl executable with a single line containing ${xcomidl.libs}'s value. When you type xcomidl alone, no error messages must be seen.

After this point the system can be used to develop programs provided that xcomidl is in path, libxcom.so is in a directory that can be reached by dynamic linker and the xcom_{parser, cppgen}.so are in a directory listed in the xcomidl.config file.

Installation

If the header files and libraries are installed using /usr as DESTDIR then there is no need to set LD_LIBRARY_PATH and specify XCOM_INCLUDE_DIR and XCOM_LIBRARY_DIR when compiling xcomidl.