diff options
author | Dr. Matthias St. Pierre <Matthias.St.Pierre@ncp-e.com> | 2019-03-21 18:27:50 +0100 |
---|---|---|
committer | Dr. Matthias St. Pierre <Matthias.St.Pierre@ncp-e.com> | 2019-03-30 00:01:55 +0100 |
commit | 02bd2d7f5ce30928baf11226fa31125337251e49 (patch) | |
tree | f81f490c3e672c5901adb4ff2771ada0178c3fe9 /doc | |
parent | 6a411436a5642a4c2ca934a649eced7118f3793d (diff) | |
download | openssl-02bd2d7f5ce30928baf11226fa31125337251e49.tar.gz |
trace: apps/openssl: print the correct category name
Previously, if the openssl application was run with OPENSSL_TRACE=any,
all trace output would just show 'ANY' as the category name, which was
not very useful. To get the correct category name printed in the trace
output, the openssl application now registers separate channels for
each category.
The trace API is unchanged, it is still possible for an application to
register a single channel for the 'ANY' category to see all outputt,
if it does not need this level of detail.
Reviewed-by: Paul Dale <paul.dale@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/8552)
Diffstat (limited to 'doc')
-rw-r--r-- | doc/man3/OSSL_trace_set_channel.pod | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/man3/OSSL_trace_set_channel.pod b/doc/man3/OSSL_trace_set_channel.pod index 773a6b1064..0fb7d06a6b 100644 --- a/doc/man3/OSSL_trace_set_channel.pod +++ b/doc/man3/OSSL_trace_set_channel.pod @@ -181,6 +181,12 @@ Traces BIGNUM context operations. There is also C<OSSL_TRACE_CATEGORY_ANY>, which works as a fallback and can be used to get I<all> trace output. +Note, however, that in this case all trace output will effectively be +associated with the 'ALL' category, which is undesirable if the +application intends to include the category name in the trace output. +In this case it is better to register separate channels for each +trace category instead. + =head1 RETURN VALUES OSSL_trace_set_channel(), OSSL_trace_set_prefix(), |