Lines Matching refs:a
48 /* check whether a trace category is enabled */
69 Tracing for a specific category is enabled at run-time if a so-called
70 I<trace channel> is attached to it. A trace channel is simply a
73 The application has two different ways of registering a trace channel,
74 either by directly providing a BIO object using L<OSSL_trace_set_channel(3)>,
75 or by providing a callback routine using L<OSSL_trace_set_callback(3)>.
76 The latter is wrapped internally by a dedicated BIO object, so for the
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
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
90 but rather uses a set of convenience macros, see the L</Macros> section below.
97 enabled (see L</Configure Tracing> below) and a trace channel has been
100 OSSL_trace_begin() is used to start a tracing section,
101 and get the channel for the given I<category> in form of a BIO.
105 OSSL_trace_end() is used to end a tracing section.
112 OSSL_trace_string() outputs I<data> of length I<size> as a string on BIO I<out>.
114 newlines and makes sure for nonempty input that the output ends with a newline.
115 Unless I<full> is nonzero, the length is limited (with a suitable warning)
120 There are a number of convenience macros defined, to make tracing
124 used as follows to wrap a trace section:
143 OSSL_TRACE_CANCEL() must be used before returning from or jumping out of a
184 Internally, all one-shot macros are implemented using a generic OSSL_TRACEV()
185 macro, since C90 does not support variadic macros. This helper macro has a rather
189 outputs I<data> of length I<size> as a string
198 only if a specific trace category is enabled.
199 In some situations this is simpler than entering a trace section using
219 this auxiliary code should be placed inside a conditional block which is
223 itself because it already introduces such a conditional block.
232 In some cases it is more advantageous to use a simple conditional group instead
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
304 OSSL_trace_begin() returns a B<BIO> pointer if the given I<type> is enabled,
325 this file except in compliance with the License. You can obtain a copy
