1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
This is the README file for cv2pdb, a
converter of DMD CodeView debug information to PDB files
Copyright (c) 2009 by Rainer Schuetze, All Rights Reserved
The goal of this project is to make debugging of D applications that
were created with the Digital Mars DMD compiler, as painless as possible
in current versions of Visual Studio (i.e Visual Studio 2008 and
VCExpress).
As a side effect, other applications might also benefit from the
converted debug information, like WinDbg.
Features
--------
* conversion of DMD CodeView information to PDB file
* converted line number info allows setting breakpoints
* display of variables, fields and objects in watch, local and auto window and in data tooltips
* generates generic debug info for dynamic arrays, associative arrays and delegates
* autoexp.dat allows convenient display of dynamic and associative arrays in watch windows
* demangles function names for convenient display of callstack
License information
-------------------
This code is distributed under the term of the Artistic License 2.0.
For more details, see the full text of the license in the file LICENSE.
The file demangle.cpp is an adaption of denangle.d to C++ distributed with
the DMD compiler. It is placed into the Public Domain.
The file mscvpdb.h is taken from the WINE-project (http://www.winehq.org)
and is distributed under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
See the file header for more details and
http://www.gnu.org/licenses/lgpl.html for the full license.
Installation
------------
Sorry, there is no full featured installer available yet, you'll have
to do some simple manual steps to use cv2pdb.
See the file INSTALL for further details.
Usage
-----
cv2pdb.exe is a command line tool which outputs its usage information
if run without arguments:
usage: cv2pdb [-Dversion] <exe-file> [new-exe-file] [pdb-file]
With the -D option, you can specify the version of the DMD compiler
you are using. Unfortunately, this information is not embedded into
the debug information. The default is -D2. So far, this information
is only needed to determine whether "char[]" or "const char[]" is
translated to "string".
The first file name on the command line is expected to be the executable
or dynamic library compiled by the DMD compiler and containing the
CodeView debug information (-g option used when running dmd).
If no further file name is given, a PDB file will be created with the
same base name as the executable, but with extension "pdb", and the
executable will be modified to redirect debuggers to this pdb-file instead
of the original debug information.
Example:
cv2pdb debuggee.exe
In an environment using make-like tools, it is often useful to create
a new file instead of modifying existing files. That way the file
modification time can be used to continue the build process at the
correct step.
If another file name is specified, the new executable is written
to this file and leaves the input executable unmodified.. The naming
of the pdb-file will use the base name of the output file.
Example:
cv2pdb debuggee.exe debuggee_pdb.exe
Last but not least, the resulting pdb-file can be renamed by specifying
a third file name.
Example:
cv2pdb debuggee.exe debuggee_pdb.exe debug.pdb
Changes
-------
For documentation on the changes between this version and
previous versions, please see the file CHANGES.
Feedback
--------
The project home for cv2pdb is here:
http://www.dsource.org/projects/cv2pdb
There's also a forum, where you can leave your comments and suggestions.
Have fun,
Rainer Schuetze
|