| This file describes how to compile dbus using the cmake build system | |
| Requirements | |
| ------------ | |
| - cmake version >= 2.4.4 see http://www.cmake.org | |
| - installed libexpat see http://sourceforge.net/projects/expat/ | |
| unsupported RelWithDebInfo builds could be fetched | |
| from http://sourceforge.net/projects/kde-windows/files/expat/ | |
| Building | |
| -------- | |
| Win32 MinGW-w64|32 | |
| 1. install mingw-w64 from http://sourceforge.net/projects/mingw-w64/ | |
| 2. install cmake and libexpat | |
| 3. get dbus sources | |
| 4. unpack dbus sources into a sub directory (referred as <dbus-src-root> later) | |
| 5. mkdir dbus-build | |
| 6. cd dbus-build | |
| 7. run | |
| cmake -G "MinGW Makefiles" [<options, see below>] <dbus-src-root>/cmake | |
| mingw32-make | |
| mingw32-make install | |
| Win32 Microsoft nmake | |
| 1. install MSVC 2010 Express Version from http://www.microsoft.com/visualstudio/en-us/products/2010-editions/visual-cpp-express | |
| 2. install cmake and libexpat | |
| 3. get dbus sources | |
| 4. unpack dbus sources into a sub directory (referred as <dbus-src-root> later) | |
| 5. mkdir dbus-build | |
| 6. cd dbus-build | |
| 7. run | |
| cmake -G "NMake Makefiles" [<options, see below>] <dbus-src-root>/cmake | |
| nmake | |
| nmake install | |
| Win32 Visual Studio 2010 Express IDE | |
| 1. install MSVC 2010 Express Version from http://www.microsoft.com/visualstudio/en-us/products/2010-editions/visual-cpp-express | |
| 2. install cmake and libexpat | |
| 3. get dbus sources | |
| 4. unpack dbus sources into a sub directory (referred as <dbus-src-root> later) | |
| 5. mkdir dbus-build | |
| 6. cd dbus-build | |
| 7. run | |
| cmake -G "Visual Studio 10" [<options, see below>] <dbus-src-root>/cmake | |
| 8a. open IDE with | |
| vcexpress dbus.sln | |
| 8b. for immediate build run | |
| vcexpress dbus.sln /build | |
| Win32 Visual Studio 2010 Professional IDE | |
| 1. install MSVC 2010 Professional Version | |
| 2. install cmake and libexpat | |
| 3. get dbus sources | |
| 4. unpack dbus sources into a sub directory (referred as <dbus-src-root> later) | |
| 5. mkdir dbus-build | |
| 6. cd dbus-build | |
| 7. run | |
| cmake -G "Visual Studio 10" [<options, see below>] <dbus-src-root>/cmake | |
| 8a. open IDE with | |
| devenv dbus.sln | |
| 8b. for immediate build run | |
| devenv dbus.sln /build | |
| Linux | |
| 1. install cmake and libexpat | |
| 2. get dbus sources | |
| 3. unpack dbus sources into a sub directory (referred as <dbus-src-root> later) | |
| 4. mkdir dbus-build | |
| 5. cd dbus-build | |
| 6. run | |
| cmake -G "<for available targets, see cmake --help for a list>" [<options, see below>] <dbus-src-root>/cmake | |
| make | |
| make install | |
| For other compilers see cmake --help in the Generators section | |
| Configuration flags | |
| ------------------- | |
| When using the cmake build system the dbus-specific configuration flags that can be given | |
| to the cmake program are these (use -D<key>=<value> on command line). The listed values | |
| are the defaults. | |
| // Choose the type of build, options are: None(CMAKE_CXX_FLAGS or | |
| // CMAKE_C_FLAGS used) Debug Release RelWithDebInfo MinSizeRel. | |
| CMAKE_BUILD_TYPE:STRING=Debug | |
| // Include path for 3rdparty packages | |
| CMAKE_INCLUDE_PATH:PATH= | |
| // Library path for 3rdparty packages | |
| CMAKE_LIBRARY_PATH:PATH= | |
| // Install path prefix, prepended onto install directories. | |
| CMAKE_INSTALL_PREFIX:PATH=C:/Program Files/dbus | |
| // enable unit test code | |
| DBUS_BUILD_TESTS:BOOL=ON | |
| // The name of the dbus daemon executable | |
| DBUS_DAEMON_NAME:STRING=dbus-daemon | |
| // Disable assertion checking | |
| DBUS_DISABLE_ASSERTS:BOOL=OFF | |
| // Disable public API sanity checking | |
| DBUS_DISABLE_CHECKS:BOOL=OFF | |
| // enable -ansi -pedantic gcc flags | |
| DBUS_ENABLE_ANSI:BOOL=OFF | |
| // build DOXYGEN documentation (requires Doxygen) | |
| DBUS_ENABLE_DOXYGEN_DOCS:BOOL=OFF | |
| // enable bus daemon usage statistics | |
| DBUS_ENABLE_STATS:BOOL=OFF | |
| // support verbose debug mode | |
| DBUS_ENABLE_VERBOSE_MODE:BOOL=ON | |
| // build XML documentation (requires xmlto or meinproc4) | |
| DBUS_ENABLE_XML_DOCS:BOOL=ON | |
| // Some atomic integer implementation present | |
| DBUS_HAVE_ATOMIC_INT:BOOL=OFF | |
| // install required system libraries | |
| DBUS_INSTALL_SYSTEM_LIBS:BOOL=OFF | |
| // session bus default address | |
| DBUS_SESSION_BUS_DEFAULT_ADDRESS:STRING=nonce-tcp: | |
| // system bus default address | |
| DBUS_SYSTEM_BUS_DEFAULT_ADDRESS:STRING=nonce-tcp: | |
| // Use atomic integer implementation for 486 | |
| DBUS_USE_ATOMIC_INT_486:BOOL=OFF | |
| // Use expat (== ON) or libxml2 (==OFF) | |
| DBUS_USE_EXPAT:BOOL=ON | |
| win32 only: | |
| // enable win32 debug port for message output | |
| DBUS_USE_OUTPUT_DEBUG_STRING:BOOL=OFF | |
| gcc only: | |
| // compile with coverage profiling instrumentation | |
| DBUS_GCOV_ENABLED:BOOL=OFF | |
| linux only: | |
| // build with dnotify support | |
| DBUS_BUS_ENABLE_DNOTIFY_ON_LINUX:BOOL=ON | |
| solaris only: | |
| // enable console owner file | |
| HAVE_CONSOLE_OWNER_FILE:BOOL=ON | |
| // Directory to check for console ownership | |
| DBUS_CONSOLE_OWNER_FILE:STRING=/dev/console | |
| x11 only: | |
| // Build with X11 auto launch support | |
| DBUS_BUILD_X11:BOOL=ON | |
| Note: The above mentioned options could be extracted after | |
| configuring from the output of running "<maketool> help-options" | |
| in the build directory. The related entries start with | |
| CMAKE_ or DBUS_. |