Cantera/Debugging Cantera - Revision history

Admin: /* Creating a Cantera Debug Build */

2014-03-27T22:14:39Z

Creating a Cantera Debug Build

@@ Line 1: / Line 1: @@
 =Creating a Cantera Debug Build=
 If you're using Cantera 1.8.0, you can edit the [[Cantera Preconfig]] file and change these lines:
@@ Line 18: / Line 20: @@
 and then run <code>./preconfig && make && make install</code> to make a debug build of Cantera.
 =Running Cantera through GDB=

Admin: moved Debugging Cantera to Cantera/Debugging Cantera

2014-01-28T20:34:44Z

moved Debugging Cantera to Cantera/Debugging Cantera

← Older revision	Revision as of 20:34, 28 January 2014
(No difference)

Admin: /* Create Your Driver */

2014-01-28T20:33:38Z

Create Your Driver

← Older revision		Revision as of 20:33, 28 January 2014
Line 25:		Line 25:
	==Create Your Driver==		==Create Your Driver==

	Before you run anything, you'll need a driver - the main program that is using the Cantera library~~. I've created a simple driver below, to illustrate by example~~.		Before you run anything, you'll need a driver - the main program that is using the Cantera library.

	<pre>		<pre>

Admin: /* Compile Your Driver */

2013-06-05T03:42:37Z

Compile Your Driver

← Older revision		Revision as of 03:42, 5 June 2013
Line 32:		Line 32:

	==Compile Your Driver==		==Compile Your Driver==

			<pre>
			...
			</pre>

	==Firing Up GDB==		==Firing Up GDB==

Admin at 03:42, 5 June 2013

2013-06-05T03:42:16Z

← Older revision		Revision as of 03:42, 5 June 2013
Line 1:		Line 1:
	=Creating a Cantera Debug Build=		=Creating a Cantera Debug Build=

	If you're using Cantera 1.8.0, you can edit the [[Cantera Preconfig]] file and change these lines:		If you're using Cantera 1.8.0, you can edit the [[Cantera Preconfig]] file and change these lines:

	<pre>		<pre>

Admin: Created page with "=Creating a Cantera Debug Build= If you're using Cantera 1.8.0, you can edit the Cantera Preconfig file and change these lines:

 CANTERA_CONFIG_PREFIX=${CANTERA_CONFI..."

2013-06-05T03:41:59Z

Created page with "=Creating a Cantera Debug Build= If you're using Cantera 1.8.0, you can edit the Cantera Preconfig file and change these lines: <pre> CANTERA_CONFIG_PREFIX=${CANTERA_CONFI..."

New page

=Creating a Cantera Debug Build=

If you're using Cantera 1.8.0, you can edit the [[Cantera Preconfig]] file and change these lines:

<pre>
CANTERA_CONFIG_PREFIX=${CANTERA_CONFIG_PREFIX:="/path/to/cantera/build"}
...
DEBUG_MODE=${DEBUG_MODE:='n'}
</pre>

to this:

<pre>
CANTERA_CONFIG_PREFIX=${CANTERA_CONFIG_PREFIX:="/path/to/cantera/dbg_build"}
...
DEBUG_MODE=${DEBUG_MODE:='y'}
</pre>

and then run <code>./preconfig && make && make install</code> to make a debug build of Cantera.

=Running Cantera through GDB=

Once you've built a version of Cantera that includes debug symbols, you'll be able to run it through GDB and step through code, set breakpoints, and get stack traces at arbitrary points in the code. This is very useful for (a) learning how Cantera works, and (b) identifying where an exception or error is being thrown, in order to determine the cause.

==Create Your Driver==

Before you run anything, you'll need a driver - the main program that is using the Cantera library. I've created a simple driver below, to illustrate by example.

<pre>
...
</pre>

==Compile Your Driver==

==Firing Up GDB==

First things first, fire up GDB. What you'll be doing is running your executable (your driver) through gdb. You'll set some breakpoints, and jump into the Cantera code using some breakpoints.

[[Category:Cantera]]