Interpreting the table

As you examine the table, note the following:

• Some of the functions listed below (e.g., InterruptDetachFunc(), SignalFault()) are internal ones that you won't find documented in the QNX Neutrino C Library Reference.
• If a function has a restartable version (with a _r in its name), the events for both versions are as listed for the function without the _r.
• If a kernel call fails, the exit trace event includes the return code and the error code (e.g., an errno value), instead of the data listed below.

As an example, let's look at the events for MsgSend(), MsgSendv(), and MsgSendvs(). As mentioned above, the information is the same for the restartable versions of these functions too.

Here's what the table gives for the entry (_NTO_TRACE_KERCALLENTER) to these functions:

Class: _NTO_TRACE_KERCALLENTER
Event: __KER_MSG_SENDV
Fast: coid, msg 
Wide: coid, sparts, rparts, msg[0], msg[1], msg[2]
Call: MsgSend,MsgSendv,MsgSendvs 
#Args: MSG_SENDV, fHcoid, Dsparts, Drparts, fSmsg, s, s

This part describes the __KER_MSG_SENDV trace event that's emitted on entry to the function. In fast mode, the event includes the following data:

In wide mode, the event includes the following data:

The second (_NTO_TRACE_KERCALLEXIT) part describes the __KER_MSG_SENDV event that's emitted on exit from the function:

Class: _NTO_TRACE_KERCALLEXIT
Event: __KER_MSG_SENDV
Fast: status, rmsg[0] 
Wide: status, rmsg[0], rmsg[1], rmsg[2] 
Call: MsgSend,MsgSendv,MsgSendvs
#Args: MSG_SENDV, fDstatus, fSrmsg, s, s 

In fast mode, the event includes the following data if the kernel call was successful:

In wide mode, the event includes the following data if the kernel call was successful:

In both fast and wide mode, the event includes the following data if the kernel call failed:

For many of the events, you'll see a comment like this:

#Args: MSG_SENDV, fHcoid, Dsparts, Drparts, fSmsg, s, s

This line indicates how traceprinter displays the data associated with the event. The format codes are as follows:

For example, fHcoid indicates that the connection ID (coid) is displayed as a 32-bit hexadecimal number, and it's included in fast mode (and wide mode).