trace_logb()

Updated: April 19, 2023

Insert a user combine trace event

Synopsis:

#include <sys/neutrino.h>
#include <sys/trace.h>

int trace_logb( int code,
                const void *buf,
                size_t nbytes );

Arguments:

code
The event code, which must be in the range from _NTO_TRACE_USERFIRST through _NTO_TRACE_USERLAST.
data
A pointer to the data to include with the event.
nbytes
The length of the data, in bytes. The function converts this value into the number of 32-bit integers.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The trace_() function calls TraceEvent() to insert a user combine event of class _NTO_TRACE_USER, and of the type specified by code.

Returns:

0
Success.
-1
An error occurred (errno is set).

Errors:

ECANCELED
The requested action has been canceled.
EFAULT
Bad internal trace buffer address. The requested action has been specified out of order.
ENOMEM
Insufficient memory to allocate the trace buffers.
ENOTSUP
The requested action isn't supported.
EPERM
The application doesn't have permission to perform the action.

Classification:

QNX Neutrino

Safety:  
Cancellation point No
Interrupt handler Read the Caveats for TraceEvent()
Signal handler Yes
Thread Yes