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, ... );

Arguments:

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.

Library:

libc

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

Description:

The trace_nlogf() function calls TraceEvent() to insert a user string 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.

Examples:

Classification:

QNX Neutrino

See also:

printf(), trace_func_enter(), trace_func_exit(), trace_here(), trace_logb(), trace_logbc(), trace_logf(), trace_logi(), trace_vnlogf(), TraceEvent()

tracelogger in the Utilities Reference

System Analysis Toolkit User's Guide

Analyzing Your System with Kernel Tracing chapter of the Integrated Development Environment User's Guide