Documente Academic
Documente Profesional
Documente Cultură
_/_ _\_
__/__/ TDM-GCC Compiler Suite for Windows \__\__
| � � | GDB 7.9 Series | � � |
��\��\ MinGW 32-bit Edition /��/��
�\� �/�
����������������������������������������
[[[ THIS IS THE README FOR THE 32-BIT GDB (DEBUGGER) DISTRIBUTION PROVIDED BY
[[[ TDM-GCC. PLEASE SEE THE FILE "README-GCC-TDM.TXT" FROM THE TDM32 CORE
[[[ PACKAGE FOR GENERAL NOTES ABOUT 32-BIT TDM-GCC.
This edition of GDB is a 32-bit native build for Windows hosts. It is designed
to debug 32-bit Windows (PE) binaries generated by GCC. It is tested with
TDM-GCC, but should also be able to debug binaries from other GCC toolchains
that target 32-bit Windows, without any issues.
REPORTING BUGS:
TDM-GCC's GDB packages incorporate wrapper executables and auto-executing
Python code to load libstdc++ pretty printers. If you encounter a bug relating
to one of these, please file a report according to the directions at:
http://tdm-gcc.tdragon.net/bugs
Otherwise, bug reports should be directed to Sourceware:
http://www.gnu.org/software/gdb/bugs/
Download the GDB archive (provided in .zip or .tar.lzma format) and unpack it to
the location of your choosing. It's recommended that you choose a path with no
spaces in the folder names. This GDB edition is designed to cooperate with
other executables in a standard GCC-on-Windows installation tree if desired.
Because a 64-bit GDB can't locally debug a 32-bit target program, and a
32-bit GDB can't locally debug a 64-bit target program, TDM now provides both a
32-bit and a 64-bit edition of GDB. Each edition comes with one or more wrapper
executables. This allows the differently-named wrappers to coexist in the
toolchain's normal "bin" directory, while keeping the actual GDB executables in
separate subdirectories.
* The 32-bit GDB wrapper is "bin/gdb32.exe", and the actual executable it wraps
is "gdb32/bin/gdb32.exe".
* The 32-bit GDBSERVER wrapper is "bin/gdbserver32.exe", and the actual
executable it wraps is "gdb32/bin/gdbserver32.exe".
* The 64-bit GDB wrappers are "bin/gdb.exe" and "bin/gdb64.exe", and the actual
executable they wrap is "gdb64/bin/gdb.exe".
* The 64-bit GDBSERVER wrappers are "bin/gdbserver.exe" and
"bin/gdbserver64.exe", and the actual executable they wrap is
"gdb64/bin/gdbserver.exe".
Thus, the "default" GDB you get from running the toolchain bin directory's
gdb.exe is the 64-bit GDB. However, feel free to delete it and copy gdb32.exe as
gdb.exe instead, if you prefer 32-bit to be your default.
If you have a different Python installation that you would prefer TDM GDB to
use, you need to:
1) Set the %PYTHONHOME% environment variable to point to that installation,
2) Make sure the %PATH% environment variable includes that installation's Python
DLL (often the DLL is installed to C:\Windows\System32, already in %PATH%),
and
3) Rename or delete "python27.dll" from the gdb*/bin directory.
GCC provides a set of Python "pretty printers" for libstdc++ objects in GDB. TDM
GDB includes a Python script called "gdbinit" that automatically runs whenever
GDB starts -- this script searches for the most recent version of the libstdc++
pretty printers in the toolchain "share/gcc-*/python/libstdcxx/v6" path and, if
found, loads them for you.
If you would prefer not to auto-load the libstdc++ pretty printers, you can
rename or delete the gdbinit script file.
The GDB package is a binary distribution licensed under the GPLv3; see
"COPYING3-gdb-tdm.txt". It is additionally based on the Expat XML Parser, whose
license is available in "COPYING-expat.txt"; on the "winpthreads" compatibility
library, whose license is available in "COPYING.winpthreads.txt"; and finally it
includes a copy of the Python DLL and base libraries, licensed under the terms
in LICENSE-python.txt.