openssl-cmake

Build OpenSSL in parallel within CMake

Features

• Support OpenSSL versions from 1.1.1 to the latest 3.4.x
• Detect the target platform (Linux, macOS, Windows, Android, iOS, and more)
• Download the source code only once (thanks CPM.cmake!)
• Don't reconfigure if same options are used
• Automatically use the maximum number of processors
• Reduce rebuild time using ccache
• Override the FindOpenSSL CMake module (no need to change existing CMake code)

CMake Options

[!IMPORTANT]

• OPENSSL_PATCH
  • Since OpenSSL source is distributed with LF, patch files also should be LF
• OPENSSL_USE_CCACHE
  • Whenever you change this option, perform a fresh configuration (or just delete CMakeCache.txt)
  • This option will remove /Zi /Fd on MSVC

[!NOTE]

• OPENSSL_CONFIGURE_OPTIONS
  • no-shared is added when BUILD_SHARED_LIBS is OFF
  • no-tests is added when OPENSSL_TEST is OFF
• OPENSSL_TARGET_PLATFORM
  • If this option is empty, the target platform will be detected
  • If openssl-cmake fails to detect, you need to set this option explicitly

[!TIP]

• OPENSSL_INSTALL
  • To change the installation path, add --prefix=<path> to OPENSSL_CONFIGURE_OPTIONS
• OPENSSL_INSTALL_CERT
  • The CA certs will be downloaded from https://curl.se/docs/caextract.html
• OPENSSL_SOURCE
  • You can download OpenSSL source from the internet or use the local OpenSSL source
  • If this option is empty or invalid, OpenSSL source will be downloaded from the official website

Prerequisites

Requirements

• CMake 3.25+
• OpenSSL build tools Link
  • Make implementation
  • Perl 5
  • ANSI C compiler
  • NASM (Windows only)
• ccache (optional)

Linux

Install CMake from official website or Snapcraft

# Debian
sudo snap install cmake --classic
sudo apt-get install -y build-essential perl ninja-build ccache

macOS

Install packages from Homebrew

brew install cmake perl ninja ccache
xcode-select --install

Windows

Install packages from Chocolatey

# Powershell (run as administrator)
choco install -y cmake jom strawberryperl nasm ccache --installargs 'ADD_CMAKE_TO_PATH=System'

# Append "C:\Program Files\NASM" to the PATH environment variable
# or run this code
[Environment]::SetEnvironmentVariable("PATH", "$ENV:PATH;C:\Program Files\NASM", "USER")

Usage

Build

cmake --list-presets all                    # List all CMake presets
cmake --preset windows                      # Configure
cmake --build --preset windows              # Build
ctest --preset windows                      # Test
cmake --build --preset windows -t install   # Install

Integration

FetchContent_Declare(
    openssl-cmake
    URL https://github.com/jimmy-park/openssl-cmake/archive/main.tar.gz
)
FetchContent_MakeAvailable(openssl-cmake)

add_executable(main main.cpp)
target_link_libraries(main PRIVATE
    OpenSSL::SSL
    OpenSSL::Crypto
    OpenSSL::applink
)

[!IMPORTANT]

• FetchContent_MakeAvailable(openssl-cmake) must be preceded before find_package(OpenSSL)
• If some libraries link OpenSSL using OPENSSL_LIBRARIES variable rather than OpenSSL::SSL target, add_dependencies() may help change the build order

Using CPM.cmake

CPMAddPackage(
    NAME openssl-cmake
    URL https://github.com/jimmy-park/openssl-cmake/archive/main.tar.gz
    OPTIONS
    "OPENSSL_CONFIGURE_OPTIONS no-shared\\\\;no-tests"
)

[!TIP] For some reason, CPM requires double-escaping for semicolon-separated lists.

Benchmarks

• OS : Windows 10 22H2
• CPU : AMD Ryzen 5 3600 6-Core Processor 3.60 GHz
• RAM : 16 GB
• Storage : Samsung SSD 860 EVO
• Compiler : MSVC 19.36
• Configuration
  • OpenSSL 3.1.1 (VC-WIN64A, no-tests, no-asm, no-makedepend, no-shared)
  • ccache 4.8.1 (default options)

[!TIP] There are benchmark workflows