Outputs an event to one or more output destinations.
flags |
Control flags:
Bit |
Value |
Meaning |
0-11 |
|
Reserved for future use. Must be 0. |
12 |
0 |
Output event data only if the component is enabled for tracing, and if the
event level specified by cblte-trcevt-level is greater or equal to the tracing
level configured for the component. |
|
1 |
Force the output of the event if the component is enabled for tracing. cblte-trcevt-level
and the tracing level configured for the component are ignored. |
13 |
0 |
cblte-trcevt-event-data is an array of pointers to trace data of varying
size and type. The corresponding elements of the cblte-trcevt-event-len
and cblte-trcevt-event-type arrays need to be defined. |
|
1 |
cblte-trcevt-event-data is an array of pointers to trace data of the same
size and type. Only the first element of cblte-trcevt-event-len and cblte-trcevt-event-type
need to be defined. |
14-29 |
|
Reserved for future use. Must be 0. |
30 |
0 |
component-id is space-terminated. |
|
1 |
component-id is null-terminated. This is ignored if bit 31 is unset. |
31 |
0 |
component-id is a pic x(4) comp-5 tracer handle returned from a call to
CBL_CTF_TRACER_GET. |
|
1 |
component-id is a pic x(n) text string. The termination character for
the string is defined by bit 30. | |
component-id |
Component identifier. This is either a pic x(4) comp-5 tracer handle (from
CBL_CTF_TRACER_GET) if bit 31 of flags is not set, or a pic x(n) text
identifier if bit 31 of flags is set. |
cblte-trcevt-version |
Structure version. Must be 0. |
cblte-trcevt-flags |
Control flags. Must be 0. |
cblte-trcevt-event-id |
Component-specific event identifier used to identify the type of event being
output. |
cblte-trcevt-event-level |
Tracing level of the event being output. |
cblte-trcevt-data-count |
Number of trace data items, indicating the number of elements in the cblte-trcevt-event-len,
cblte-trcevt-event-type, and cblte-trcevt-event-data arrays. This can
be 0. |
cblte-trcevt-event-len |
Pointer to an array of 4-byte comp-5 items. Each array element indicates
the length of the corresponding trace data item in the cblte-trcevt-event-data
array. This can be NULL if cblte-trcevt-data-count is 0. |
cblte-trcevt-event-type |
Pointer to an array of 4-byte comp-5 items. Each array element indicates
the type of the corresponding trace data item in the cblte-trcevt-event-data
array. This can be NULL if cblte-trcevt-data-count is 0.
Value |
Type |
0 |
Binary |
1 |
Text (local encoding) |
2 |
Address |
3 |
COMP-5 |
4 |
COMP-X |
5 |
UTF8 |
6 |
Signed COMP-5 |
7 |
Signed COMP-X |
Any value other than the ones specified above is treated as type 0 (binary). |
cblte-trcevt-event-data |
Pointer to an array of pointer items. Each array element addresses a trace
data item of the type and length indicated by the corresponding element in
the cblte-trcevt-event-type and cblte-trcevt-event-len arrays respectively.
This can be NULL if cblte-trcevt-data-count is 0.
For address type items, the array element is the address value; not a pointer
to the address value. |