From: Milan Broz Date: Tue, 2 Dec 2025 11:37:54 +0000 (+0100) Subject: Use better description of macros purpose in engine.h X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=456fce00cc2fd08e60c96321d142f682ac5c185e;p=thirdparty%2Fopenssl.git Use better description of macros purpose in engine.h Resolves: https://github.com/openssl/project/issues/1735 Signed-off-by: Milan Broz Reviewed-by: Eugene Syromiatnikov Reviewed-by: Saša Nedvědický (Merged from https://github.com/openssl/openssl/pull/29287) --- diff --git a/include/openssl/engine.h b/include/openssl/engine.h index 63a4e6b0cbb..a544f39aa05 100644 --- a/include/openssl/engine.h +++ b/include/openssl/engine.h @@ -20,14 +20,19 @@ # include /* - * There is no OPENSSL_NO_NO_ENGINE, Engines are permanently disabled - * and OPENSSL_NO_ENGINE must be defined + * Engine support is gone. Definitions here are provided for the source code + * compatibility only. They are meant to keep compilation working for legacy + * projects that, for whatever reason, cannot remove/disable old legacy code. * - * This header now generates compatible definitions according - * to OPENSSL_ENGINE_STUBS define. - * Note we have to use compile-time message to warn only if API is really used. - * To avoid complicated macros we kind-of abuse existing OSSL_DEPRACATED macros. + * We deliberately keep the OPENSSL_NO_ENGINE macro around as it is supplied + * when the build is configured with the `no-engine` option. OpenSSL 4.0 keeps + * the `no-engine` option around. + * + * Note, we have to use a compile-time message to warn only if the API is really + * used. To avoid complex macros, we kind of abuse the existing OSSL_DEPRECATED + * macros. */ + # ifdef OPENSSL_ENGINE_STUBS # define ENGINE_INFO_MSG \ " API symbol is replaced with stub to avoid linker error."