Lines Matching refs:trace
18 #include <openssl/trace.h>
25 /* trace group macros */
29 /* Leave trace group prematurely in case of an error */
36 /* one-shot trace macros */
48 /* check whether a trace category is enabled */
70 I<trace channel> is attached to it. A trace channel is simply a
71 BIO object to which the application can write its trace output.
73 The application has two different ways of registering a trace channel,
78 We call them a I<simple trace channel> and a I<callback trace channel>,
81 To produce trace output, it is necessary to obtain a pointer to the
82 trace channel (i.e., the BIO object) using OSSL_trace_begin(), write
85 calls surrounding the trace output create a group, which acts as a
86 critical section (guarded by a mutex) to ensure that the trace output
97 enabled (see L</Configure Tracing> below) and a trace channel has been
124 used as follows to wrap a trace section:
144 trace section:
174 The macro call C<OSSL_TRACE(category, text)>, produces literal text trace output.
177 printf-style trace output with n format field arguments (n=1,...,9).
198 only if a specific trace category is enabled.
199 In some situations this is simpler than entering a trace section using
215 It is not needed to guard trace output function calls like
218 If producing the trace output requires carrying out auxiliary calculations,
220 executed only if the trace category is enabled.
222 The most natural way to do this is to place the code inside the trace section
233 of a trace section. This is the case if calculations and tracing happen in
235 that placing them inside a (critical) trace section would create too much
247 it takes to print the trace output, not to calculate it.
253 necessary to configure and build OpenSSL with the 'enable-trace' option.
