mangosone-server/CMakeLists.txt
r-log e5317def81 [Cleanup] Remove the unused USE_STORMLIB option
Nothing in this repo's own tree reads the variable: the CI workflows,
ci-compile.sh, and the repo's CLAUDE.md example already stopped passing
-DUSE_STORMLIB in an earlier commit, leaving the option() declaration
orphaned. Mirrors the removal already done on mangoszero/server.

The Eluna submodule's own CI still passes -DUSE_STORMLIB:BOOL=1 when it
builds this repo, but an unrecognized -D is a non-fatal CMake warning,
not a configure failure, and Eluna is maintained in its own repo.
2026-08-03 07:19:25 +01:00

267 lines
11 KiB
CMake

# SPDX-License-Identifier: GPL-3.0-or-later
#
# MaNGOS is a full featured server for World of Warcraft, supporting
# the following clients: 1.12.x, 2.4.3, 3.3.5a, 4.3.4a and 5.4.8
#
# Copyright (C) 2005-2026 MaNGOS <https://www.getmangos.eu>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <https://www.gnu.org/licenses/>.
cmake_minimum_required(VERSION 3.18 FATAL_ERROR)
# =============================================================================
# Project setup
# =============================================================================
project(MaNGOS VERSION 0.22.0 LANGUAGES C CXX)
# Build artefacts never land in the source tree. This is a test, not hygiene:
# sources here still carry relative includes like "../../dep/foo.h", and an
# in-source build tree can make those resolve by accident.
if(CMAKE_BINARY_DIR STREQUAL CMAKE_SOURCE_DIR)
message(FATAL_ERROR
"In-source builds are not supported. Configure from a separate build "
"directory, e.g. cmake -S . -B ../build")
endif()
# Use modern CMake policies
cmake_policy(SET CMP0028 NEW)
cmake_policy(SET CMP0048 NEW)
cmake_policy(SET CMP0054 NEW)
cmake_policy(SET CMP0063 NEW)
# CMP0042 = MACOSX_RPATH (macOS only) — optional
if(APPLE)
cmake_policy(SET CMP0042 NEW)
endif()
# =============================================================================
# C++ / C standard configuration
# =============================================================================
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)
set(CMAKE_C_STANDARD 11)
set(CMAKE_C_STANDARD_REQUIRED ON)
# IDE folder organization
set_property(GLOBAL PROPERTY USE_FOLDERS ON)
# Always export compile_commands.json for tooling
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
#==================================================================================
# Define available cmake options below
option(BUILD_MANGOSD "Build the main server" ON)
option(BUILD_REALMD "Build the login server" ON)
option(BUILD_TOOLS "Build the client-data extractor" ON)
option(WITH_TESTS "Build the unit tests" OFF)
option(WITH_NET_TESTS "Build the socket tests (slow; never in CI)" OFF)
option(SCRIPT_LIB_ELUNA "Compile with support for Eluna scripts" ON)
option(SCRIPT_LIB_SD3 "Compile with support for ScriptDev3 scripts" ON)
option(PLAYERBOTS "Enable Player Bots" OFF)
option(SOAP "Enable remote access via SOAP" OFF)
option(PCH "Enable precompiled headers" ON)
option(WITH_IO_URING "Use the io_uring network backend (Linux, needs liburing)" OFF)
option(DEBUG "Enable debug build (only on non IDEs)" OFF)
option(WITHOUT_GIT "Disable Git revision detection" OFF)
#==================================================================================
message("")
message(
"This script builds the MaNGOS server.
Options that can be used in order to configure the process:
General:
CMAKE_INSTALL_PREFIX Path where the server should be installed to
BUILD_MANGOSD Build the main server
BUILD_REALMD Build the login server
BUILD_TOOLS Build the client-data extractor
SOAP Enable remote access via SOAP
PCH Enable use of precompiled headers
WITH_TESTS Build the unit tests (target: mangos_tests)
WITH_NET_TESTS Build the socket tests as well. Disjoint from WITH_TESTS,
off by default, and deliberately not run in CI: they bind
real sockets and dominate the suite's wall-clock time.
DEBUG Debug build, only for systems without IDE (Linux, *BSD)
WITHOUT_GIT Disable Git revision detection
Scripting engines:
SCRIPT_LIB_ELUNA Compile with support for Eluna scripts
SCRIPT_LIB_SD3 Compile with support for ScriptDev3 scripts
Modules:
PLAYERBOTS Enable Player Bots
To set an option simply type -D<OPTION>=<VALUE> after 'cmake <srcs>'.
Also, you can specify the generator with -G. See 'cmake --help' for more details
For example: cmake .. -DCMAKE_INSTALL_PREFIX=/opt/mangos -DSCRIPT_LIB_SD3=0"
)
message("")
#==================================================================================#
# =============================================================================
# Build type logic
# =============================================================================
if(NOT CMAKE_CONFIGURATION_TYPES)
if(DEBUG)
set(CMAKE_BUILD_TYPE Debug CACHE STRING "" FORCE)
else()
set(CMAKE_BUILD_TYPE Release CACHE STRING "" FORCE)
endif()
endif()
# =============================================================================
# Install paths
# =============================================================================
include(GNUInstallDirs)
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
set(CMAKE_INSTALL_PREFIX ${CMAKE_CURRENT_SOURCE_DIR}_install CACHE PATH "Default install directory" FORCE)
endif()
if(UNIX)
set(BIN_DIR "${CMAKE_INSTALL_FULL_BINDIR}")
set(CONF_INSTALL_DIR "${CMAKE_INSTALL_FULL_SYSCONFDIR}")
else()
set(BIN_DIR "${CMAKE_INSTALL_PREFIX}")
set(CONF_INSTALL_DIR "${CMAKE_INSTALL_PREFIX}")
endif()
# =============================================================================
# Runtime library search path (RPATH)
# =============================================================================
if(APPLE)
set(CMAKE_INSTALL_RPATH "@loader_path/../lib")
set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
elseif(UNIX)
set(CMAKE_INSTALL_RPATH "$ORIGIN/../lib")
set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
endif()
# =============================================================================
# Dependencies
# =============================================================================
# =============================================================================
# Include project CMake modules safely (relative to current dir)
# =============================================================================
list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake")
if(NOT WITHOUT_GIT)
find_package(Git QUIET)
endif()
find_package(Threads REQUIRED)
find_package(OpenSSL 3.0 REQUIRED)
# OpenSSL 4.x support is intentionally deferred until the OpenSSL 4.2 LTS migration.
if(OPENSSL_VERSION VERSION_GREATER_EQUAL "4.0.0")
message(FATAL_ERROR
"Unsupported OpenSSL ${OPENSSL_VERSION}: MaNGOS currently requires >=3.0.0 and <4.0.0")
endif()
find_package(MySQL REQUIRED)
# =============================================================================
# OpenSSL policy
#
# Every OpenSSL decision lives here, in two interface targets:
#
# mangos_openssl - what to link against and where the headers live.
# Linked PUBLIC by anything exposing OpenSSL types in
# its own headers (`shared`), so consumers inherit it.
#
# mangos_openssl_strict - the API level we hold ourselves to. Together these
# two definitions delete the *declarations* of
# everything OpenSSL deprecated up to 3.0 -- the
# low-level MD5_*, SHA1_*, HMAC_CTX and SSLeay_*
# families. Reaching for the old API is then a
# compile error rather than a warning nobody reads.
#
# Link it PRIVATE, always. It must not leak into
# targets that still use the old API: the realmd
# submodule (which reaches us through `shared`) and
# the vendored code under dep/.
# =============================================================================
add_library(mangos_openssl INTERFACE)
target_link_libraries(mangos_openssl
INTERFACE
OpenSSL::SSL
OpenSSL::Crypto
)
add_library(mangos_openssl_strict INTERFACE)
target_compile_definitions(mangos_openssl_strict
INTERFACE
OPENSSL_API_COMPAT=0x30000000L
OPENSSL_NO_DEPRECATED
)
# Network backend selection. Detection lives here, beside the option, rather than in
# src/shared: the result is read by the build summary at the end of this file, and a
# set() made inside a subdirectory would not be visible up here.
#
set(MANGOS_USE_IO_URING OFF)
if(WITH_IO_URING AND UNIX AND NOT APPLE)
find_library(URING_LIBRARY NAMES uring)
find_path(URING_INCLUDE_DIR NAMES liburing.h)
if(URING_LIBRARY AND URING_INCLUDE_DIR)
set(MANGOS_USE_IO_URING ON)
message(STATUS "Networking backend: io_uring (${URING_LIBRARY})")
else()
message(WARNING "WITH_IO_URING was requested but liburing was not found; "
"falling back to the epoll reactor.")
endif()
endif()
find_package(ZLIB QUIET)
find_package(BZip2 QUIET)
# dep/lualib (the Lua build used by Eluna) links against readline by its bare
# library name and is not itself touched here; find_package(Readline) below
# declares a GLOBAL IMPORTED target literally named `readline` (see
# cmake/FindReadline.cmake) before that subdirectory is added, so its
# existing bare-name references resolve to a properly-detected library
# instead of an unqualified linker search. Readline has no Windows build and
# is only needed when Eluna is being built.
if(NOT WIN32 AND SCRIPT_LIB_ELUNA)
find_package(Readline REQUIRED)
endif()
include(${CMAKE_CURRENT_SOURCE_DIR}/cmake/GenRevision.cmake)
include(${CMAKE_CURRENT_SOURCE_DIR}/cmake/EnsureVersion.cmake)
include(${CMAKE_CURRENT_SOURCE_DIR}/cmake/MangosParams.cmake)
include(${CMAKE_CURRENT_SOURCE_DIR}/cmake/SetDefinitions.cmake)
include(${CMAKE_CURRENT_SOURCE_DIR}/cmake/SubmoduleCompat.cmake)
if(PCH)
include(${CMAKE_CURRENT_SOURCE_DIR}/cmake/PCHSupport.cmake)
endif()
# =============================================================================
# Subdirectories
# =============================================================================
if(WITH_TESTS OR WITH_NET_TESTS)
set(BUILD_TESTING ON)
enable_testing()
endif()
# Not the submodule's own CMakeLists: this fork decides which dependencies it
# builds, and with what gating. See cmake/Dependencies.cmake.
include(Dependencies)
if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/src/CMakeLists.txt")
add_subdirectory(src)
else()
message(WARNING "Source directory 'src' not found. Nothing to build.")
endif()
# =============================================================================
# Final info and summary
# =============================================================================
include(${CMAKE_CURRENT_SOURCE_DIR}/cmake/StatusInfo.cmake)