Difference between revisions of "Debug generated C code"
(More info on how to copy the runtime files.) |
(Updated content with the other page that contained information on how to debug a generated application) |
||
| Line 1: | Line 1: | ||
[[Category:Runtime]] | [[Category:Runtime]] | ||
Sometimes you need debug the Eiffel generated C code. This page will show you how to achieve this. In addition you may also want to compile the runtime in debug mode (see the instructions at the end of this page). | Sometimes you need debug the Eiffel generated C code. This page will show you how to achieve this. In addition you may also want to compile the runtime in debug mode (see the instructions at the end of this page). | ||
| + | |||
| + | To see the mapping between Eiffel classes and features to C files and their methods, the file '''TRANSLAT''' in the '''W_code''' or '''F_code''' directory is very useful. | ||
== Unix == | == Unix == | ||
| − | Edit $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/include/config.sh and | + | There are 2 methods: |
| − | #To the value of '''wkoptimize''' add the '''-g''' option. | + | * Edit $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/include/config.sh and |
| − | #Replace the value of '''optimize''' to disable the C optimization (usually '''-O0''') and add '''-g'''. | + | *#To the value of '''wkoptimize''' add the '''-g''' option. |
| + | *#Replace the value of '''optimize''' to disable the C optimization (usually '''-O0''') and add '''-g'''. | ||
| + | * set the '''CFLAGS''' environment variable with '''-g''' | ||
Once you have done that, do in your W_code or F_code directory: | Once you have done that, do in your W_code or F_code directory: | ||
| − | + | <pre> | |
| − | + | make clobber | |
| + | finish_freezing | ||
| + | </pre> | ||
| + | |||
| + | Now, the generated executable should contain debugger symbols. It can be debugged with gdb or ddd (Data Display Debugger). | ||
== Windows == | == Windows == | ||
Revision as of 04:17, 13 October 2014
Sometimes you need debug the Eiffel generated C code. This page will show you how to achieve this. In addition you may also want to compile the runtime in debug mode (see the instructions at the end of this page).
To see the mapping between Eiffel classes and features to C files and their methods, the file TRANSLAT in the W_code or F_code directory is very useful.
Unix
There are 2 methods:
- Edit $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/include/config.sh and
- To the value of wkoptimize add the -g option.
- Replace the value of optimize to disable the C optimization (usually -O0) and add -g.
- set the CFLAGS environment variable with -g
Once you have done that, do in your W_code or F_code directory:
make clobber finish_freezing
Now, the generated executable should contain debugger symbols. It can be debugged with gdb or ddd (Data Display Debugger).
Windows
After doing the changes below (depending on your C compiler), you can recompile your project from scratch and the debug information will be present.
MinGW
Edit $ISE_EIFFEL\studio\config\$ISE_PLATFORM\$ISE_C_COMPILER\config.eif and perform the following edits:
- Replace the content of optimize by -O0 -g.
- Replace the content of wkoptimize by -O0 -g.
Visual C++
Edit $ISE_EIFFEL\studio\config\$ISE_PLATFORM\$ISE_C_COMPILER\config.eif and perform the following edits:
- Replace the content of optimize' by -Od -Zi -MT.
- Search and replace all occurrences of -NODEFAULTLIB:libc by -NODEFAULTLIB:libc -DEBUG.
With Visual C++, you can have access to the Visual Studio C debugger which will let you attach Eiffel running processes. We certainly recommend that you catch all exceptions (Ctrl + Alt + E to get to the dialog).
If you have issues with Visual Studio not finding some debugging information, it might be necessary to tell Visual Studio where to find the associated PDB of your Eiffel executable or DLL.
Mac OS X
Hint: Eclipse works well to graphically debug your application, Xcode can be set up as well (more).
- Replace the content of optimize by -O0 -g.
- Replace the content of wkoptimize by -O0 -g.
Once you have done that, do in your W_code or F_code directory:
- make clobber
- finish_freezing
$(RM) $(OBJECTS)
The following shell script will do the magic for you:
sed -i -e 's/$(RM) $(OBJECTS)//g' `find -d . | grep "Makefile.SH"`
Runtime
Unix
Edit $EIFFEL_SRC/C/CONFIGS/$ISE_PLATFORM and perform the same substitution as above for Unix. Then type ./quick_configure in the $EIFFEL_SRC/C directory.
Once this is done make sure to copy the debugged runtime files located under $EIFFEL_SRC/C/run-time/lib* to the EiffelStudio delivery under $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/lib.
Windows
Edit the config file in $EIFFEL_SRC/C/CONFIGS that matches your platform and your C compiler. For example, windows-x86-64-msc is for Windows 64-bit using the Microsoft C++ compiler. Comment out the debug and optimize entry and replace them with their corresponding debugged version (currently commented below). Then in the $EIFFEL_SRC/C directory type configure win64 m (Windows 64-bit) or configure win32 m (Windows 32-bit) to compile the runtime for the Microsoft C++ compiler.
Once this is done make sure to copy the debugged runtime files located under $EIFFEL_SRC/C/run-time/lib/*.lib to the EiffelStudio delivery under $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/lib/$ISE_C_COMPILER.
