trace_logi()

Insert a user simple trace event

Synopsis:

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

int trace_logi( int code,
                unsigned d1,
                unsigned d2 );

Since:

BlackBerry 10.0.0

Arguments:

code: The event code, which must be in the range from _NTO_TRACE_USERFIRST through _NTO_TRACE_USERLAST.
d1, d2: Data to include with the event.

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 simple 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:

Safety:
Cancellation point	No
Interrupt handler	Yes
Signal handler	Yes
Thread	Yes