service/protocol-plugin/lib/cpluff/INSTALL.txt

   1 INSTALLING C-PLUFF
   2 ==================
   3
   4 These are instructions for building and installing the C-Pluff framework
   5 implementation using the source code distribution. Precompiled binaries
   6 are available for some platforms at the download page
   7
   8   http://www.c-pluff.org/download
   9
  10 For help on building C-Pluff based applications, see the examples in the
  11 examples directory.
  12
  13
  14 Prerequisites
  15 -------------
  16
  17 To build C-Pluff, you need to have following prerequisites installed:
  18
  19   - a C library supporting POSIX dlopen
  20     (for example, GNU C library)
  21     or
  22     GNU Libtool libltdl library
  23     (http://www.gnu.org/software/libtool/)
  24
  25   - Expat XML Parser library for C
  26     (http://expat.sourceforge.net/)
  27
  28 Following components are optional and are used if they are installed:
  29
  30   - GNU gettext libintl library for localization
  31     (http://www.gnu.org/software/gettext/gettext.html)
  32
  33   - GNU Readline Library for enhanced command line
  34     (http://cnswww.cns.cwru.edu/php/chet/readline/rltop.html)
  35
  36
  37 Building
  38 --------
  39
  40 To build C-Pluff, follow the usual autotools procedure:
  41
  42   Building in the source directory:
  43     ./configure
  44     make
  45
  46   Building in a separate build directory:
  47     cd BUILD_DIR
  48     SOURCE_DIR/configure
  49     make
  50
  51 You can specify the installation prefix (for example, /usr or /usr/local)
  52 when running the configure script.
  53
  54   ./configure --prefix=/usr
  55
  56 The default installation prefix is /usr/local. More help on available
  57 configuration options is available using the --help option.
  58
  59   ./configure --help
  60
  61
  62 Installation
  63 ------------
  64
  65 You can install the library, header files, utilities, documentation and
  66 examples by making target install:
  67
  68   make install
  69
  70 If installing to system directories you have to do this as root.
  71
  72 Additionally, you can specify a directory to be used in place of the
  73 root directory during installation. This is typically used to create
  74 binary packages.
  75
  76   make DESTDIR=/tmp/installation install
  77
  78
  79 Known good build platforms
  80 --------------------------
  81
  82 C-Pluff is known to compile cleanly on following combinations:
  83
  84   - Native Linux build
  85     - GCC 4.1.2
  86     - GNU C library 2.3.6
  87     - Expat 1.95.8
  88
  89   - Cross compilation for Windows on Linux
  90     - MinGW Runtime 3.9
  91     - MinGW binutils 2.16.91
  92     - MinGW 3.4.5
  93     - Expat 2.0.0 (or 1.95.8 or 1.95.1)
  94     - GNU Libtool libltdl 1.5.22
  95     - GNU Gettext 0.16.1 (or 0.14.4)