trace_nlogf()

Insert a user string trace event, specifying a maximum string length

Synopsis:

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

int trace_nlogf( int code,
                 int max,
                 const char *fmt, ... );

BlackBerry 10.0.0

code: The event code, which must be in the range from _NTO_TRACE_USERFIRST through _NTO_TRACE_USERLAST.
max: The maximum length of the string to include in the event, in bytes, or 0 for no limit.
fmt: A printf() -style formatting string. This must be followed by additional arguments that provide the items required by the fmt string.

libc

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

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

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.

It isn't safe to call this function from an interrupt handler if the formatting codes or parameters include floating-point elements.