RTSDK C/C++ Installation Guide : 4 Building RTSDK with CMake : 4.4 CMake Build Configuration Options
 
4.4 CMake Build Configuration Options
When running the CMake command, you can use any of the following options:
 
Tip: If you want to only build the Enterprise Transport API library, turn off the following options: BUILD_ETA_APPLICATIONS, BUILD_EMA_LIBRARY, and BUILD_EMA_EXAMPLES
 
Table 1: CMake Command Options
Option
Description
Default Setting
BUILD_RTSDK-BINARYPACK
Downloads needed libraries (as a tarball) from GitHub and builds the RTSDK-BinaryPack. To use this option, you must have Internet access (with any proxies specified).
If you downloaded your package from the Developer Community Portal, this option skips the tarball download and simply builds the RTSDK-BinaryPack.
On
BUILD_EMA_DOXYGEN
Builds the Enterprise Message API reference documentation using Doxygen.
Off
BUILD_EMA_EXAMPLES
Builds all programs in Cpp-C/Ema/Examples. Turning this option off also turns off BUILD_EMA_PERFTOOLS, BUILD_EMA_TRAINING, and BUILD_UNIT_TESTS.
On
BUILD_EMA_LIBRARY
Builds with the Enterprise Message API library (libema)
On
BUILD_EMA_PERFTOOLS
Builds all programs in Cpp-C/Ema/Examples/Perftools
On
BUILD_EMA_TRAINING
Builds all programs in Cpp-C/Ema/Examples/Training
On
BUILD_EMA_UNIT_TESTS
Builds all unit tests for the Enterprise Message API (located in
Cpp-C/Ema/Examples/Test/UnitTest).
On
BUILD_ETA_APPLICATIONS
The top-level control option for all Enterprise Transport API Applications. Turning this option off also turns off BUILD_ETA_EXAMPLES, BUILD_ETA_PERFTOOLS, and BUILD_ETA_TRAINING.
On
BUILD_ETA_DOXYGEN
Builds Enterprise Transport API reference documentation using Doxygen.
Off
BUILD_ETA_EXAMPLES
Builds all programs in
Cpp-C/Eta/Applications/Examples
On
BUILD_ETA_PERFTOOLS
Builds all programs in
Cpp-C/Eta/Applications/Perftools
On
BUILD_ETA_TRAINING
Builds all programs in Cpp-C/Eta/Applications/Training
On
BUILD_ETA_UNIT_TESTS
Builds all unit tests for Enterprise Transport API (located in
Cpp-C/Eta/TestTools/UnitTests).
On
BUILD_UNIT_TESTS
Builds all unit test programs for both the Enterprise Message API (located in Cpp-C/Ema/Examples/Test/UnitTest) and Enterprise Transport API (located in Cpp-C/Eta/TestTools/UnitTests). Turning this option off also turns off BUILD_EMA_UNIT_TESTS and BUILD_ETA_UNIT_TESTS.
On
BUILD_32_BIT_ETA
Forces a 32-bit build. This option builds only the Enterprise Transport API and its examples that do not require the Binary Pack (thus VA examples such as VACons, VAProv, VANIProv, and WatchlistCons are not built). Also turns off the Enterprise Message API and associated examples.
Off
Note: This is used only for forcing 32-bit Linux builds.
Tip: To force a 32-bit build in Windows, leave out the Win64 specification in the generator statement.
RTSDK_OPT_BUILD_WITH_PREBUILT_ETA_
EMA_LIBRARIES
Available only if you downloaded the RTSDK from the Developer Community Portal. This option sets CMake to build the RTSDK package using prebuilt Enterprise Transport API and Enterprise Message API libraries.
This option does not rebuild the libraries themselves.
ON
RTSDK_OPT_BUILD_ETA_EMA_LIBRARIES
Available only if you downloaded the RTSDK from the Developer Community Portal. This option sets CMake to rebuild the Enterprise Transport and Message API libraries, the examples, and the applications, and then rebuild the RTSDK package. To build external project libraries, CMake uses the tarballs from the local download cache (dlcache) in the RTSDK distribution.
OFF
RTSDK_OPT_REBUILD_ALL
Available only if you downloaded the RTSDK from the Developer Community Portal. This option sets CMake to rebuild the entire RTSDK distribution. To build external project libraries, CMake downloads the tarballs from the Internet. To use this option, you must have Internet access (with any proxies specified).
OFF