Specifications

System Software Diagnostics Guide — September 2006 141
28
28.Runtime Trace Facility (RTF)
Reference
This chapter provides an overview of the Runtime Trace Facility (RTF), including information
about editing the RTF configuration file (RtfConfigLinux.xml for Linux* and RtfConfigWin.xml for
Windows*) file to set tracing configuration options. Reference information about the RTF
command line options is also included. This chapter contains the following subsections:
• Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
• Installing RTF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
• RTF Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
• Restrictions and Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
• rtftool Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
• Example RTF Configuration Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
• Configuring Remote RTF Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
A procedure for using the tool is provided in Chapter 7, “Debugging Software”.
28.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.
RTF obtains trace control settings and output formatting from an RTF configuration file
(RtfConfigLinux.xml for Linux and RtfConfigWin.xml for Windows). Each runtime library has
several levels of tracing that can be dynamically enabled/disabled by editing the RTF configuration
file while your application runs. This allows RTF to be configured to meet specific needs.
Major RTF components include:
• Client library (librtfmt.dll for Windows, librtf.so for Linux): Dynamic loaded library that
provides the software interface to make use of RTF functionality.
• Configuration file (RtfConfigWin.xml for Windows, RtfConfigLinux.xml for Linux): Editable
file that allows you to customize the tracing and output capabilities of RTF (for example,
which runtime libraries RTF will trace, the trace levels, location and size of backup log files.)
Note: You must have administrative rights to modify the RtfConfig*.xml files.
• Server application (RtfServer.exe for Windows, RtfServer for Linux): Service that
communicates to all RTF clients, receives trace data from clients, and dispatches data to disk.