View source for HowTo:Use GDB

{{NAV_Manual |
| previous=[[HowTo:Cygwin Compiling|Compiling with Cygwin]]
| up=[[HowTo]]
| next=[[HowTo:Use Dr Watson|Use Dr Watson]]
}}
----
= Using GDB with Vegastrike =
This page provides information on how to use GDB to help debug Vegastrike.

== Debugging process ==
=== Game compilation ===
* First you have to configure Vegastrike with the <code>--enable-debug</code> option in addition to your others:<BR/><pre>./configure <your other parameters> --enable-debug</pre>

* Then <code>make</code> your Vegastrike binary:<BR/><pre>make</pre>

Please make sure you have enough disk space available before doing this. Compiling Vegastrike with <code>--enable-debug</code> eats up a huge amount of disk space.

=== Run GDB ===
* Start <code>gdb</code> (GNU Debugger):<BR/><pre>gdb /path/to/vegastrike</pre>

* Start the game by typing this into the gdb-console:<BR/><pre>run</pre>

* When the error occurs or it dies type
<pre>
print *this
backtrace full
up
print *this
up
print *this
</pre>

== See also ==

The content of this site is mostly take from [http://vegastrike.sourceforge.net/forums/viewtopic.php?p=4688#4688 this] post in the forum.
----
{{NAV_Manual |
| previous=[[HowTo:Cygwin Compiling|Compiling with Cygwin]]
| up=[[HowTo]]
| next=[[HowTo:Use Dr Watson|Use Dr Watson]]
}}

[[Category:HowTo|Using GDB]]