As of version 0.12.0, Log4cxx requires a minimum C++ version of C++11.

Log4cxx requires the following software to build and/or run correctly:

APR+APR-Util

The Apache Portable Runtime(APR) provides the cross-platform backend for Log4cxx. Both APR and APR-util need to be installed and available on your system.

sed+gzip+zip

These applications are needed to test Log4cxx. gzip and sed are generally installed by default on Linux. zip may not be installed by default; check your distribution's documentation for information on how to install these applications.

For Windows, you will have to install those tools through a system such as MinGW, cygwin, or MSYS2.

gzip and zip only needed during runtime if you are compressing the log files, for example by setting a rollover policy which ends in .gz or .zip.

Using std::format instead of fmt::format

The LOG4CXX_XXXXX_FMT logging macros use the macro LOG4CXX_FORMAT_NS to select the format function version.

Use the CMake option LOG4CXX_FORMAT_NAMESPACE=std to set the default value for LOG4CXX_FORMAT_NS to std. If LOG4CXX_FORMAT_NAMESPACE is not specified when Log4cxx is built, the default value for LOG4CXX_FORMAT_NS is fmt.

Setting LOG4CXX_FORMAT_NAMESPACE=std when building Log4cxx does not prevent an application from using the {fmt} library. An application developer can choose the implementation by adding LOG4CXX_FORMAT_NS=std or LOG4CXX_FORMAT_NS=fmt to the target_compile_definitions command in their CMakeLists.txt. If that preprocessor macro is absent, the LOG4CXX_XXXXX_FMT logging macros will expand to the default value of LOG4CXX_FORMAT_NS defined when Log4cxx was built.

Optional Dependencies

The following table lists CMake options that require additional dependencies.

Default CMake option values

All the above CMake options default to OFF except for the {fmt} library options.

If the {fmt} library is found (by find_package(fmt 7.1 QUIET)) when Log4cxx is built, the options ENABLE_FMT_ASYNC and ENABLE_FMT_LAYOUT default to ON.

Licenses(direct dependencies only)