User class: _NTO_TRACE_USER

QNX SDP8.0System Analysis Toolkit (SAT) User's GuideUser

The _NTO_TRACE_USER class includes custom events that your program creates.

You can create these events by calling one of the following convenience functions:

trace_logb()
Insert a user combine trace event
trace_logf()
Insert a user string trace event
trace_logi()
Insert a user simple trace event
trace_nlogf()
Insert a user string trace event, specifying a maximum string length
trace_vnlogf()
Insert a user string trace event, using a variable argument list

or by calling TraceEvent() directly, with one of the following commands:

  • _NTO_TRACE_INSERTSUSEREVENT to create a simple event containing a small amount of data
  • _NTO_TRACE_INSERTCUSEREVENT to create a combine event containing an arbitrary amount of data
    Note:
    The len argument for the _NTO_TRACE_INSERTCUSEREVENT command is the number of integers (not bytes) in the passed buffer.
  • _NTO_TRACE_INSERTUSRSTREVENT to create an event containing a null-terminated string

The event must be in the range from _NTO_TRACE_USERFIRST through _NTO_TRACE_USERLAST, but you can decide what each event means.

The traceprinter label for these events is USREVENT; the IDE label is User Event. In both cases, this label is followed by the event type, expressed as an integer.

Page updated: