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>
(Merged from https://github.com/openssl/openssl/pull/28556)

diff --git a/doc/man3/OSSL_trace_set_channel.pod b/doc/man3/OSSL_trace_set_channel.pod
index 0db38e8db0d29590c56a05ae25419e3d65a1b12e..c4345f22fdfc2b00411f20a86bb8d374fb392c2c 100644 (file)
--- 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 7cc6d96e8c598584bac60f266366a0bcdaf5ac42..541edc27f0b4abfabac51ff812548dbefeeed709 100644 (file)
--- 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.