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 |