Specifications

System Software Diagnostics Guide — September 2006 163
29
29.RTFManager Reference
This chapter describes how to use the Runtime Trace Facility Manager GUI (RTFManager) to
configure the trace levels and output of the Runtime Trace Facility (RTF) utility. This chapter
contains the following information:
• Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
• Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
• Starting RTFManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
• Main Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
• General Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
• Filtering Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
• Log File Filtering. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
• Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
If you prefer to configure RTF manually or need a detailed explanation of what the RTF
configuration file contains, refer to Chapter 28, “Runtime Trace Facility (RTF) Reference”.
29.1 Description
RTF provides a mechanism for tracing the execution path of the runtime libraries for the Intel
®
Dialogic
®
system release software. All libraries that use RTF write their trace messages to a log
file. The resulting log file helps troubleshoot runtime issues for applications that are built with Intel
Dialogic system release software.
Trace control settings and log file formatting are set via the Runtime Trace Facility Manager. Each
runtime library has several levels of tracing that can be dynamically enabled/disabled through the
Runtime Trace Facility Manager.
The Runtime Trace Facility Manager allows you to do the following:
• trace the host libraries on DM3, Springware, and Host Media Processing technology
• use a graphical user interface (Runtime Trace Facility Manager) to configure trace control
settings and the format of resulting log files
• use a command line utility (rtftool) to start/stop RTF tracing and incorporate RTF tracing
configuration changes dynamically
• trace multiple processes and format trace output into a central data store (log file)
• dynamically configure trace options at runtime without terminating running processes
• adjust the runtime configuration, allowing you to trace select modules (libraries), clients
(trunks or channels) and labels (trace categories or levels) to avoid collecting excess trace data
and degrading system performance