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	Read the Caveats for TraceEvent()
Signal handler	Yes
Thread	Yes