Development/FAQs/Debugging FAQ - Revision history

Guymaurel at 16:03, 22 March 2013

2013-03-22T16:03:34Z

Vitorboschi: /* What tools are available to debug my application? */ fix qdbusviewer name

2012-04-30T14:17:57Z

‎What tools are available to debug my application?: fix qdbusviewer name

AnneW: Marked this version for translation

2012-01-23T15:05:07Z

Marked this version for translation

AnneW at 15:04, 23 January 2012

2012-01-23T15:04:48Z

Phanect: Added tags.

2012-01-22T21:27:20Z

Added <translate> tags.

Icwiener: Delete kde3-specific instructions.

2011-06-27T16:17:03Z

Delete kde3-specific instructions.

Icwiener: Fix syntax highlighting.

2011-06-27T16:16:08Z

Fix syntax highlighting.

Bille: mention timestamps

2010-06-22T14:36:54Z

mention timestamps

Edulix: typo

2010-04-09T10:23:11Z

typo

Sreich: add dfaure's guide to why signals/slots don't work, fix it up a bit. hopefully this will help someone (if they search for it too, I hope)

2010-03-05T01:16:50Z

add dfaure's guide to why signals/slots don't work, fix it up a bit. hopefully this will help someone (if they search for it too, I hope)

@@ Line 137: / Line 137: @@
 <!--T:38-->
-To get timestamps with your debug output, which are useful for debugging multi-threaded, networked and asynchronous operations, <tt>export KDE_DEBUG_TIMESTAMP=1</tt> before running your app. Since KDE SC 4.5.
+To get timestamps with your debug output, which are useful for debugging multi-threaded, networked and asynchronous operations, <tt>export KDE_DEBUG_TIMESTAMP=1</tt> (for format 17:03:24), or <tt>export KDE_DEBUG_TIMESTAMP=2</tt> (for format 17:03:24.123) before running your app. Since KDE SC 4.5.
 <!--T:39-->

@@ Line 47: / Line 47: @@
 *kdbg is a nice graphical frontend to gdb with a KDE GUI. It has support for many Qt types (including QString).
 *Memory leak tracer : See kdesdk/kmtrace. The README explains it all.
-*qdbus and dbus-viewer from Qt allow to browse DBus interfaces and to easily make DBus calls.
+*qdbus and dbusviewer from Qt allow to browse DBus interfaces and to easily make DBus calls.
 <!--T:14-->

@@ Line 1: / Line 1: @@
 <languages />
 <translate>
-==General==
+==General== <!--T:1-->
-===How do I avoid Dr Konqi?===
+===How do I avoid Dr Konqi?=== <!--T:2-->
 You must set the environment variable KDE_DEBUG (to 1 or whatever you want in fact).
 To get Dr Konqi back, unset the KDE_DEBUG environment variable.
 Example:<br />
 *To avoid Dr Konqi:
@@ Line 15: / Line 18: @@
 ::<code>unset KDE_DEBUG</code>
-===How do I switch Dr Konqi to developer mode?===
+===How do I switch Dr Konqi to developer mode?=== <!--T:6-->
 Edit file $KDEHOME/share/config/drkonqirc and add the following:
 <syntaxhighlight lang="ini">
@@ Line 23: / Line 27: @@
 </syntaxhighlight>
-===What is a core file? How do I get a core file?===
+===What is a core file? How do I get a core file?=== <!--T:8-->
 A core file is an image of the memory when your application crashed. Using the core file, you can know which variables were set and where your application crashed.
 Some distributions disable the generation of core files. To re-enable them, use <code>ulimit -c unlimited</code>.
 Once you have a core file for a crash, you can examine it with gdb appname core . This will open gdb on the core file for the given application. Once at the gdb prompt, the most useful command is <code>bt</code> which generates a backtrace of the crash.
 For more information about how to use gdb, see [[Special:myLanguage/Development/Tutorials/Debugging/Debugging_with_GDB|this page]]
-===What tools are available to debug my application?===
+===What tools are available to debug my application?=== <!--T:12-->
 *kDebug() (kdDebug() in KDE3) calls are a simple but efficient way to debug an application.
 *gdb, the GNU debugger, is the quickest way to execute step-by-step and investigate variables (recommended versions are gdb >= 6.x)
@@ Line 41: / Line 49: @@
 *qdbus and dbus-viewer from Qt allow to browse DBus interfaces and to easily make DBus calls.
 Check [[Special:myLanguage/Development/Tools|this page]] and kdesdk, there are a bunch of useful scripts there.
-===How do I print a QString in gdb?===
+===How do I print a QString in gdb?=== <!--T:15-->
 Check out kdesdk, and add this line to your ~/.gdbinit :
 {{Input|1=source /path/to/kde/sources/kdesdk/scripts/kde-devel-gdb}}
@@ Line 50: / Line 60: @@
 For instance, <code>QString myqstring = QString::fromLatin1("contents");</code> can be examined using
 {{Input|1=
 (gdb) printqstring myqstring
 $1 = "content"}}
 See the <tt>kde-devel-gdb</tt> file for the other macros it defines.
-===I have no symbol when I debug an app that uses kpart, what should I do?===
+===I have no symbol when I debug an app that uses kpart, what should I do?=== <!--T:19-->
 You must stop just after the main to load the debugging symbols of the shared library. After that, you can debug normally.
 One can go as far as creating a gdb macro, to stop right after the part was loaded. For kword, by example, I use:
@@ Line 67: / Line 80: @@
                         QObject *, char const *, bool)' cont}}
-===How do I debug an ioslave?===
+===How do I debug an ioslave?=== <!--T:21-->
 See [[Development/Tutorials/Debugging/Debugging IOSlaves|debugging ioslaves]]
-=== Why isn't my signal and slot connection working? ===
+=== Why isn't my signal and slot connection working? === <!--T:23-->
 Here are some steps that you can use to troubleshoot why your signal/slot connection is not working (your slot does not get called for some reason).
 ) Verify that the connect() doesn't print a warning to the console at runtime.
 If it does, check that you wrote Q_OBJECT, that the parameter names are not in the connect, that the parameter types are compatible, and that the slot is defined, and that the moc was compiled.
 b) Or you can just check to see what connect() returns as a bool. Although this won't give you the error message.
 ) Verify that the signal is indeed emitted
@@ Line 85: / Line 103: @@
-==KDE 4 specific==
+==KDE 4 specific== <!--T:28-->
-===Is there a preferred way to print debug output on stderr?===
+===Is there a preferred way to print debug output on stderr?=== <!--T:29-->
 Yes, you must use kDebug():
 <syntaxhighlight lang="cpp-qt">
 #include <kdebug.h>
@@ Line 96: / Line 116: @@
 </syntaxhighlight>
 The syntax is much like cout, you can use many native types between the "<<". This will print out a debugging message, which will automatically be turned off at release time (by <tt>--disable-debug</tt>). In case you want the message to still be there during releases, because it's a warning or an error, use <tt>kWarning()</tt> or <tt>kError()</tt>.
 Components and libraries are advised to use a debug area number, as in kDebug(1234). For this, the number must be registered in kdelibs/kdecore/kdebug.areas. Debug areas make it possible to turn off or on the debug output for specific area numbers, using the {{program|kdebugdialog}} program, which is part of kdebase. <tt>kdebugdialog --fullmode</tt> also permits to control where to log debug output. It is usually not necessary to register area numbers for standalone applications, unless it's so complex that you want to divide the output into several areas.
 It is possible to omit the debug area number when calling kDebug by adding the following code to your top-level CMakeLists.txt:
 <code>
 add_definitions(-DKDE_DEFAULT_DEBUG_AREA=XXXX)
 </code>
 For more information, about this, see [http://www.kdedevelopers.org/node/3171 Allen Winter's blog post].
 To make it clear: do NOT use <tt>qDebug()</tt>, this one does not get disabled at releases. Also avoid using <tt>assert()</tt> or <tt>kFatal()</tt> which lead to a crash when something goes wrong and that is not a nice experience for the user. Better detect the error, output a <tt>kWarning()</tt> or <tt>kError()</tt>, and recover if possible.
 To get timestamps with your debug output, which are useful for debugging multi-threaded, networked and asynchronous operations, <tt>export KDE_DEBUG_TIMESTAMP=1</tt> before running your app. Since KDE SC 4.5.
 [[Category:FAQs]]
 [[Category:Programming]]
 </translate>

@@ Line 2: / Line 2: @@
 <translate>
 ==General==
 ===How do I avoid Dr Konqi?===
 You must set the environment variable KDE_DEBUG (to 1 or whatever you want in fact).
@@ Line 9: / Line 11: @@
 Example:<br />
 *To avoid Dr Konqi:
-::<pre>export KDE_DEBUG=1</pre>
+::<code>export KDE_DEBUG=1</code>
 *To see Dr Konqi:
-::<pre>unset KDE_DEBUG</pre>
+::<code>unset KDE_DEBUG</code>
 ===How do I switch Dr Konqi to developer mode?===
@@ Line 25: / Line 27: @@
 A core file is an image of the memory when your application crashed. Using the core file, you can know which variables were set and where your application crashed.
-Some distributions disable the generation of core files. To re-enable them, use "ulimit -c unlimited".
+Some distributions disable the generation of core files. To re-enable them, use <code>ulimit -c unlimited</code>.
-Once you have a core file for a crash, you can examine it with gdb appname core . This will open gdb on the core file for the given application. Once at the gdb prompt, the most useful command is "bt" which generates a backtrace of the crash.
+Once you have a core file for a crash, you can examine it with gdb appname core . This will open gdb on the core file for the given application. Once at the gdb prompt, the most useful command is <code>bt</code> which generates a backtrace of the crash.
-For more information about how to use gdb, see [[Development/Tutorials/Debugging/Debugging_with_GDB|this page]]
+For more information about how to use gdb, see [[Special:myLanguage/Development/Tutorials/Debugging/Debugging_with_GDB|this page]]
 ===What tools are available to debug my application?===
 *kDebug() (kdDebug() in KDE3) calls are a simple but efficient way to debug an application.
 *gdb, the GNU debugger, is the quickest way to execute step-by-step and investigate variables (recommended versions are gdb >= 6.x)
@@ Line 38: / Line 41: @@
 *qdbus and dbus-viewer from Qt allow to browse DBus interfaces and to easily make DBus calls.
-Check [[Development/Tools|this page]] and kdesdk, there are a bunch of useful scripts there.
+Check [[Special:myLanguage/Development/Tools|this page]] and kdesdk, there are a bunch of useful scripts there.
 ===How do I print a QString in gdb?===
 Check out kdesdk, and add this line to your ~/.gdbinit :
- source /path/to/kde/sources/kdesdk/scripts/kde-devel-gdb
+{{Input|1=source /path/to/kde/sources/kdesdk/scripts/kde-devel-gdb}}
-Then in gdb you can do printqstring myqstring to see its contents.
+Then in gdb you can do <code>printqstring myqstring</code> to see its contents.
-For instance, QString myqstring = QString::fromLatin1("contents"); can be examined using
+For instance, <code>QString myqstring = QString::fromLatin1("contents");</code> can be examined using
-<pre>
+{{Input|1=
 (gdb) printqstring myqstring
-$1 = "content"
+$1 = "content"}}
-</pre>
 See the <tt>kde-devel-gdb</tt> file for the other macros it defines.
 ===I have no symbol when I debug an app that uses kpart, what should I do?===
 You must stop just after the main to load the debugging symbols of the shared library. After that, you can debug normally.
 One can go as far as creating a gdb macro, to stop right after the part was loaded. For kword, by example, I use:
-<pre>
+{{Input|1=
 define startkword
 break main
 run
 break 'KoDocument::KoDocument(int, QWidget *, char const *,
-                        QObject *, char const *, bool)' cont
+                        QObject *, char const *, bool)' cont}}
-</pre>
 ===How do I debug an ioslave?===
@@ Line 82: / Line 86: @@
 ==KDE 4 specific==
 ===Is there a preferred way to print debug output on stderr?===
 Yes, you must use kDebug():
@@ Line 96: / Line 102: @@
 It is possible to omit the debug area number when calling kDebug by adding the following code to your top-level CMakeLists.txt:
-<pre>
+<code>
 add_definitions(-DKDE_DEFAULT_DEBUG_AREA=XXXX)
-</pre>
+</code>
 For more information, about this, see [http://www.kdedevelopers.org/node/3171 Allen Winter's blog post].

@@ Line 1: / Line 1: @@
 ==General==
 ===How do I avoid Dr Konqi?===
@@ Line 106: / Line 108: @@
 [[Category:FAQs]]
 [[Category:Programming]]

← Older revision		Revision as of 14:36, 22 June 2010
Line 98:		Line 98:
	To make it clear: do NOT use qDebug(), this one doesn't get disabled at releases. Also avoid using assert() or kFatal() which lead to a crash when something goes wrong and that is not a nice experience for the user. Better detect the error, output a kWarning or kError, and recover if possible.		To make it clear: do NOT use qDebug(), this one doesn't get disabled at releases. Also avoid using assert() or kFatal() which lead to a crash when something goes wrong and that is not a nice experience for the user. Better detect the error, output a kWarning or kError, and recover if possible.

		+	To get timestamps with your debug output, which are useful for debugging multi-threaded, networked and asynchronous operations, export KDE_DEBUG_TIMESTAMP=1 before running your app. Since KDE SC 4.5.

	==KDE 3 specific==		==KDE 3 specific==

@@ Line 91: / Line 91: @@
 <code>
-add_definition(-DKDE_DEFAULT_DEBUG_AREA=XXXX)
+add_definitions(-DKDE_DEFAULT_DEBUG_AREA=XXXX)
 </code>

@@ Line 60: / Line 60: @@
 See [[Development/Tutorials/Debugging/Debugging IOSlaves|debugging ioslaves]]
 ==KDE 4 specific==
@@ Line 83: / Line 97: @@
 To make it clear: do NOT use qDebug(), this one doesn't get disabled at releases. Also avoid using assert() or kFatal() which lead to a crash when something goes wrong and that is not a nice experience for the user. Better detect the error, output a kWarning or kError, and recover if possible.
 ==KDE 3 specific==
@@ Line 98: / Line 113: @@
 To make it clear: do NOT use qDebug(), this one doesn't get disabled at releases. Also avoid using assert() or kdFatal() which lead to a crash when something goes wrong, never nice for the user. Better detect the error, output a kdWarning or kdError, and recover if possible.
 [[Category:FAQs]]
 [[Category:Programming]]