trace_func_enter()

Insert a trace event for the entry to a function

Synopsis:

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

int trace_func_enter( void *this_fn,
                      void *call_site );

Arguments:

this_fn
A pointer to the function you've entered.
call_site
The address of the calling site.

Library:

libc

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

Description:

The trace_func_enter() function calls TraceEvent() to insert an event of class _NTO_TRACE_SYSTEM and type _NTO_TRACE_SYS_FUNC_ENTER into the trace log.

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 Yes
Signal handler Yes
Thread Yes