Filter
Top Products
Dialogic
®
Global Call IP Technology Guide — November 2007 377
Dialogic Corporation
7
7.Debugging Dialogic
®
Global Call
API IP Applications
This chapter provides information about debugging Dialogic
®
Global Call API IP applications:
• Debugging Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
• Configuring the Logging Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
7.1 Debugging Overview
The Dialogic
®
Global Call API IP Call Control Library uses the RTF (Runtime Tracing Facility)
system that is used by other Dialogic
®
Software libraries to write underlying call control library
and stack information to a consolidated log file while an application is running. This information
can help trace the sequence of events and identify the source of a problem. This information is also
useful when reporting problems to technical support personnel.
All libraries and software modules that use RTF write their messages to a single, consolidated log
file, with the default name rftlog.txt. The log file may optionally have a date and time stamp
appended to the filename; for example, rtflog01052005-13h24m19.923s. When compared to the
multiple independent log files used in previous implementations of the IP Call Control library, the
consolidated log file has the advantage of clearly showing the time relationship of events associated
with different software modules without requiring developers to correlate event time stamps.
Note: The SIP stack may also generate its own log file named sdplog.txt to capture any parsing errors that
may occur.
The RTF facility allows developers to configure which events are written to the log file based on
the importance of the event and the specific software module generating the event. All logging
configuration for all libraries and modules that use RTF (not just the IP Call Control Library) is
contained in a single, consolidated configuration file. This is in contrast to previous Global Call IP
library implementations which used multiple configuration files for the library and the two IP
protocol stacks.
The RTF facility uses the following entities to control which debug print statements are written to
the log file:
module
An RTF module corresponds to a library or software module that has internal RTF APIs
incorporated into its source code. Three separate RTF modules are used by the IP Call Control
library:
• gc_h3r – call control, signal handler, and signal adaptation layer software modules
• sip_stack – SIP protocol stack
• h323_stack – H.323 protocol stack