Compilation and installation options

Custom installation directory

By default, the make install command will install the library globally in your system (/usr/lib for example).

You can change that location by using a dedicated cmake option:

cmake -DCMAKE_INSTALL_PREFIX=/destination/path ..

Enable logging

By default, all lines of code related to logging are suppressed at the preprocessing step.

This is done to provide higher performance by avoiding the execution of unnecessary lines of code related to logging even though no logger has been configured.

If you wish to enable logging, you have to disable that default behavior by setting the CMake variable LOGGING_ENABLED.

# Enable logging
cmake .. -DLOGGING_ENABLED=1

Custom socket read size

# Change the read size used to read data from sockets (default value: 4096)
cmake .. -DREAD_SIZE=4096

Custom number of io_service workers

The io_service is multithreaded: multiple workers are in charged of IO operations and call the underlying read and write callbacks.

You can configure the number of workers assigned to the io_service by setting the IO_SERVICE_NB_WORKERS CMake variable.

# Change the default number of io_service workers (default value: 1)
cmake .. -DIO_SERVICE_NB_WORKERS=1

To learn more about tacopie io_service, please refer to the dedicated wiki page.

Windows Runtime Library configuration

By default, cpp_redis is compiled using the /MT Runtime Library configuration.

You can use the MSVC_RUNTIME_LIBRARY_CONFIG Cmake variable to override this setting and choose the Runtime Library of your choice (/MT, /MD, /MTd, /MDd, ...).

cmake .. -DMSVC_RUNTIME_LIBRARY_CONFIG=/MD

Building tests

cmake .. -DBUILD_TESTS=true

Building examples

cmake .. -DBUILD_EXAMPLES=true

Specify your custom library

To be written