Tracing Using Global Variables; Selecting Types Of Tracing - HP A4500A - VMEbus Single Board Computer 744 Motherboard Programmer's Manual

Troubleshooting Your Application
Using ROSE API Tracing
AP_TRACE_FILE:
The name of the file that is to receive tracing results.
Default = stderr.
AP_TRACE_MAX_UDATA:
The maximum amount of user data (in bytes) that will be displayed
when parameters are displayed.
Default = 16.

Tracing Using Global Variables

ROSE API tracing is controlled by three global variables. The variables
are described below:
Table 5-1 ROSE Trace Variables
rose_trace
rose_trace_fp
rose_trace_max_udata

Selecting Types of Tracing

The level of ROSE tracing is controlled by the rose_trace variable.
The rose_trace variable is defined as a bitmask that can be set to
particular values (as defined in the file /opt/ots/lib/api_trace.h) and as
listed in Table 5-1.
For example, if you want to trace output parameters only, you would set
rose_trace to API_TR_OUTPUT.
76
An integer value which constitutes a
bitmask to control the level of tracing
performed. By default this mask is 0
A pointer to a UNIX file to receive the
tracing output. By default this is set to
stderr.
The maximum amount of user data (in
bytes) that will be displayed during tracing.
The default is 16.
Chapter 5