Home | History | Annotate | Download | only in dbus
      1 This file describes how to compile dbus using the cmake build system
      2 
      3 Requirements
      4 ------------
      5 - cmake version >= 2.4.4 see http://www.cmake.org
      6 - installed libexpat see http://sourceforge.net/projects/expat/ 
      7     unsupported RelWithDebInfo builds could be fetched 
      8     from http://sourceforge.net/projects/kde-windows/files/expat/
      9 
     10 Building
     11 --------
     12 
     13 Win32 MinGW-w64|32
     14 1. install mingw-w64 from http://sourceforge.net/projects/mingw-w64/
     15 2. install cmake and libexpat
     16 3. get dbus sources
     17 4. unpack dbus sources into a sub directory (referred as <dbus-src-root> later)
     18 5. mkdir dbus-build
     19 6. cd dbus-build
     20 7. run 
     21     cmake -G "MinGW Makefiles" [<options, see below>] <dbus-src-root>/cmake
     22     mingw32-make
     23     mingw32-make install
     24 
     25 Win32 Microsoft nmake
     26 1. install MSVC 2010 Express Version from http://www.microsoft.com/visualstudio/en-us/products/2010-editions/visual-cpp-express
     27 2. install cmake and libexpat
     28 3. get dbus sources
     29 4. unpack dbus sources into a sub directory (referred as <dbus-src-root> later)
     30 5. mkdir dbus-build
     31 6. cd dbus-build
     32 7. run 
     33     cmake -G "NMake Makefiles" [<options, see below>] <dbus-src-root>/cmake
     34     nmake
     35     nmake install
     36 
     37 Win32 Visual Studio 2010 Express IDE
     38 1. install MSVC 2010 Express Version from http://www.microsoft.com/visualstudio/en-us/products/2010-editions/visual-cpp-express
     39 2. install cmake and libexpat
     40 3. get dbus sources
     41 4. unpack dbus sources into a sub directory (referred as <dbus-src-root> later)
     42 5. mkdir dbus-build
     43 6. cd dbus-build
     44 7. run
     45       cmake -G "Visual Studio 10" [<options, see below>] <dbus-src-root>/cmake
     46 8a. open IDE with
     47       vcexpress dbus.sln
     48 8b. for immediate build run
     49       vcexpress dbus.sln /build
     50 
     51 Win32 Visual Studio 2010 Professional IDE
     52 1. install MSVC 2010 Professional Version
     53 2. install cmake and libexpat
     54 3. get dbus sources
     55 4. unpack dbus sources into a sub directory (referred as <dbus-src-root> later)
     56 5. mkdir dbus-build
     57 6. cd dbus-build
     58 7. run 
     59       cmake -G "Visual Studio 10" [<options, see below>] <dbus-src-root>/cmake
     60 8a. open IDE with
     61       devenv dbus.sln
     62 8b. for immediate build run
     63       devenv dbus.sln /build
     64 
     65 Linux
     66 1. install cmake and libexpat
     67 2. get dbus sources
     68 3. unpack dbus sources into a sub directory (referred as <dbus-src-root> later)
     69 4. mkdir dbus-build
     70 5. cd dbus-build
     71 6. run 
     72     cmake -G "<for available targets, see cmake --help for a list>" [<options, see below>] <dbus-src-root>/cmake
     73     make
     74     make install
     75 
     76 For other compilers see cmake --help in the Generators section
     77 
     78 Configuration flags
     79 -------------------
     80 
     81 When using the cmake build system the dbus-specific configuration flags that can be given 
     82 to the cmake program are these (use -D<key>=<value> on command line). The listed values 
     83 are the defaults.
     84 
     85 // Choose the type of build, options are: None(CMAKE_CXX_FLAGS or
     86 // CMAKE_C_FLAGS used) Debug Release RelWithDebInfo MinSizeRel.
     87 CMAKE_BUILD_TYPE:STRING=Debug
     88 
     89 // Include path for 3rdparty packages
     90 CMAKE_INCLUDE_PATH:PATH=
     91 
     92 // Library path for 3rdparty packages
     93 CMAKE_LIBRARY_PATH:PATH=
     94 
     95 // Install path prefix, prepended onto install directories.
     96 CMAKE_INSTALL_PREFIX:PATH=C:/Program Files/dbus
     97 
     98 
     99 // enable unit test code
    100 DBUS_BUILD_TESTS:BOOL=ON
    101 
    102 // The name of the dbus daemon executable
    103 DBUS_DAEMON_NAME:STRING=dbus-daemon
    104 
    105 // Disable assertion checking
    106 DBUS_DISABLE_ASSERTS:BOOL=OFF
    107 
    108 // Disable public API sanity checking
    109 DBUS_DISABLE_CHECKS:BOOL=OFF
    110 
    111 // enable -ansi -pedantic gcc flags
    112 DBUS_ENABLE_ANSI:BOOL=OFF
    113 
    114 // build DOXYGEN documentation (requires Doxygen)
    115 DBUS_ENABLE_DOXYGEN_DOCS:BOOL=OFF
    116 
    117 // enable bus daemon usage statistics
    118 DBUS_ENABLE_STATS:BOOL=OFF
    119 
    120 // support verbose debug mode
    121 DBUS_ENABLE_VERBOSE_MODE:BOOL=ON
    122 
    123 // build XML  documentation (requires xmlto or meinproc4)
    124 DBUS_ENABLE_XML_DOCS:BOOL=ON
    125 
    126 // Some atomic integer implementation present
    127 DBUS_HAVE_ATOMIC_INT:BOOL=OFF
    128 
    129 // install required system libraries
    130 DBUS_INSTALL_SYSTEM_LIBS:BOOL=OFF
    131 
    132 // session bus default address
    133 DBUS_SESSION_BUS_DEFAULT_ADDRESS:STRING=nonce-tcp:
    134 
    135 // system bus default address
    136 DBUS_SYSTEM_BUS_DEFAULT_ADDRESS:STRING=nonce-tcp:
    137 
    138 // Use atomic integer implementation for 486
    139 DBUS_USE_ATOMIC_INT_486:BOOL=OFF
    140 
    141 // Use expat (== ON) or libxml2 (==OFF)
    142 DBUS_USE_EXPAT:BOOL=ON
    143 
    144 win32 only:
    145 // enable win32 debug port for message output
    146 DBUS_USE_OUTPUT_DEBUG_STRING:BOOL=OFF
    147 
    148 gcc only:
    149 // compile with coverage profiling instrumentation
    150 DBUS_GCOV_ENABLED:BOOL=OFF
    151 
    152 linux only:
    153 // build with dnotify support 
    154 DBUS_BUS_ENABLE_DNOTIFY_ON_LINUX:BOOL=ON
    155 
    156 solaris only:
    157 // enable console owner file 
    158 HAVE_CONSOLE_OWNER_FILE:BOOL=ON
    159 
    160 // Directory to check for console ownership
    161 DBUS_CONSOLE_OWNER_FILE:STRING=/dev/console
    162 
    163 x11 only:
    164 // Build with X11 auto launch support
    165 DBUS_BUILD_X11:BOOL=ON
    166 
    167 
    168 Note: The above mentioned options could be extracted after 
    169 configuring from the output of running "<maketool> help-options" 
    170 in the build directory. The related entries start with 
    171 CMAKE_ or DBUS_. 
    172