Merge pull request #5714 from alexischr/update_bockbuild
[mono.git] / man / pdb2mdb.1
1 .\" Copyright 2003 Ximian, Inc. 
2 .\" Copyright 2004-2009 Novell, Inc. 
3 .de Sp \" Vertical space (when we can't use .PP)
4 .if t .sp .5v
5 .if n .sp
6 ..
7 .TH pdb2mdb 1 "23 April 2009"
8 .SH NAME 
9 pdb2mdb \- Program Database to Mono Debugging Symbol converter.
10 .SH SYNOPSIS
11 .B pdb2mdb
12 pdb_file
13 .SH DESCRIPTION
14 This tool is used to convert debugging symbols generated by
15 Microsoft's compilers into debugging symbols that can be consumed by
16 Mono's runtime.
17 .PP
18 Program Database files are files that end with the extension .pdb and
19 are associated with a library or executable (a .dll or .exe file).
20 This format was until recently not documented so Mono used its own
21 file format for storing debugging information, the Mono debugging
22 format.  
23 .PP
24 Just like PDB files Mono Debugging information is stored in files that
25 reside side-by-side with a program executable or a library. 
26 .PP
27 You can use the pdb2mdb tool to transform these PDB files into MDB
28 files that Mono can then consume to debug programs or provide
29 line-number information for stack traces or exceptions.
30 .SH LICENSE
31 The 
32 .I pdb2mdb
33 tool is  released under the terms of the Microsoft Public License
34 (MS-PL).
35 .AUTHORS
36 JB Evain wrote the tool.   The PDB reading support came from Microsoft
37 Common Compiler Infrastructure.
38 .SH SEE ALSO
39 mono(1), mdb(1)
40 .SH WEB SITE
41 http://www.mono-project.com