From: Neil Horman <nhorman@openssl.org>
Date: Mon, 15 Sep 2025 20:36:28 +0000 (-0400)
Subject: Remove ENGINE_TABLE and ENGINE_REF_COUNT trace documentation
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=8f0c28a7bae0699237517d01127b680fc7abd192;p=thirdparty%2Fopenssl.git

Remove ENGINE_TABLE and ENGINE_REF_COUNT trace documentation

As the subject indicates, with these trace categories gone, we shouldn't
reference them in the docs anymore.

Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Matt Caswell <matt@openssl.org>
Reviewed-by: Paul Dale <ppzgs1@gmail.com>
Reviewed-by: Saša Nedvědický <sashan@openssl.org>
Reviewed-by: Eugene Syromiatnikov <esyr@openssl.org>
Reviewed-by: Norbert Pocs <norbertp@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/29305)
---

diff --git a/doc/man3/OSSL_trace_set_channel.pod b/doc/man3/OSSL_trace_set_channel.pod
index 0db38e8db0d..c4345f22fdf 100644
--- a/doc/man3/OSSL_trace_set_channel.pod
+++ b/doc/man3/OSSL_trace_set_channel.pod
@@ -145,23 +145,7 @@ Traces the ciphers used by the TLS/SSL protocol.
 
 =item B<OSSL_TRACE_CATEGORY_CONF>
 
-Traces details about the provider and engine configuration.
-
-=item B<OSSL_TRACE_CATEGORY_ENGINE_TABLE>
-
-Traces the ENGINE algorithm table selection.
-
-More precisely, functions like ENGINE_get_pkey_asn1_meth_engine(),
-ENGINE_get_pkey_meth_engine(), ENGINE_get_cipher_engine(),
-ENGINE_get_digest_engine(), will generate trace summaries of the
-handling of internal tables.
-
-=item B<OSSL_TRACE_CATEGORY_ENGINE_REF_COUNT>
-
-Traces the ENGINE reference counting.
-
-More precisely, both reference counts in the ENGINE structure will be
-monitored with a line of trace output generated for each change.
+Traces details about the provider configuration.
 
 =item B<OSSL_TRACE_CATEGORY_PKCS5V2>
 
@@ -334,6 +318,10 @@ OSSL_trace_set_channel(), OSSL_trace_set_prefix(),
 OSSL_trace_set_suffix(), and OSSL_trace_set_callback() were all added
 in OpenSSL 3.0.
 
+The B<OSSL_TRACE_CATEGORY_ENGINE_TABLE> and
+B<OSSL_TRACE_CATEGORY_ENGINE_REF_COUNT> tracing categories were removed in
+OpenSSL 4.0.  For details please see L<ossl-guide-migration(7)>
+
 =head1 COPYRIGHT
 
 Copyright 2019-2023 The OpenSSL Project Authors. All Rights Reserved.
diff --git a/doc/man7/openssl-env.pod b/doc/man7/openssl-env.pod
index 7cc6d96e8c5..541edc27f0b 100644
--- a/doc/man7/openssl-env.pod
+++ b/doc/man7/openssl-env.pod
@@ -162,17 +162,6 @@ Traces decoder operations.
 
 Traces encoder operations.
 
-=item B<ENGINE_REF_COUNT>
-
-Reference counts in the ENGINE structure will be monitored with a line
-of generated for each change.
-
-=item B<ENGINE_TABLE>
-
-The function that is used by RSA, DSA (etc) code to select registered
-ENGINEs, cache defaults and functional references (etc), will generate
-debugging summaries.
-
 =item B<HTTP>
 
 Traces the HTTP client and server, such as messages being sent and received.