1 //===-- llvm-dwarfdump.cpp - Debug info dumping utility for llvm ----------===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This program is a utility that works like "dwarfdump".
12 //===----------------------------------------------------------------------===//
14 #include "llvm/ADT/STLExtras.h"
15 #include "llvm/ADT/Triple.h"
16 #include "llvm/DebugInfo/DIContext.h"
17 #include "llvm/Object/ObjectFile.h"
18 #include "llvm/Object/RelocVisitor.h"
19 #include "llvm/Support/CommandLine.h"
20 #include "llvm/Support/Debug.h"
21 #include "llvm/Support/Format.h"
22 #include "llvm/Support/ManagedStatic.h"
23 #include "llvm/Support/MemoryBuffer.h"
24 #include "llvm/Support/MemoryObject.h"
25 #include "llvm/Support/PrettyStackTrace.h"
26 #include "llvm/Support/Signals.h"
27 #include "llvm/Support/raw_ostream.h"
28 #include "llvm/Support/system_error.h"
35 using namespace object;
37 static cl::list<std::string>
38 InputFilenames(cl::Positional, cl::desc("<input object files>"),
41 static cl::opt<unsigned long long>
42 Address("address", cl::init(-1ULL),
43 cl::desc("Print line information for a given address"));
46 PrintFunctions("functions", cl::init(false),
47 cl::desc("Print function names as well as line information "
48 "for a given address"));
51 PrintInlining("inlining", cl::init(false),
52 cl::desc("Print all inlined frames for a given address"));
54 static cl::opt<DIDumpType>
55 DumpType("debug-dump", cl::init(DIDT_All),
56 cl::desc("Dump of debug sections:"),
58 clEnumValN(DIDT_All, "all", "Dump all debug sections"),
59 clEnumValN(DIDT_Abbrev, "abbrev", ".debug_abbrev"),
60 clEnumValN(DIDT_AbbrevDwo, "abbrev.dwo", ".debug_abbrev.dwo"),
61 clEnumValN(DIDT_Aranges, "aranges", ".debug_aranges"),
62 clEnumValN(DIDT_Info, "info", ".debug_info"),
63 clEnumValN(DIDT_InfoDwo, "info.dwo", ".debug_info.dwo"),
64 clEnumValN(DIDT_Types, "types", ".debug_types"),
65 clEnumValN(DIDT_TypesDwo, "types.dwo", ".debug_types.dwo"),
66 clEnumValN(DIDT_Line, "line", ".debug_line"),
67 clEnumValN(DIDT_LineDwo, "line.dwo", ".debug_line.dwo"),
68 clEnumValN(DIDT_Loc, "loc", ".debug_loc"),
69 clEnumValN(DIDT_LocDwo, "loc.dwo", ".debug_loc.dwo"),
70 clEnumValN(DIDT_Frames, "frames", ".debug_frame"),
71 clEnumValN(DIDT_Ranges, "ranges", ".debug_ranges"),
72 clEnumValN(DIDT_Pubnames, "pubnames", ".debug_pubnames"),
73 clEnumValN(DIDT_Pubtypes, "pubtypes", ".debug_pubtypes"),
74 clEnumValN(DIDT_GnuPubnames, "gnu_pubnames", ".debug_gnu_pubnames"),
75 clEnumValN(DIDT_GnuPubtypes, "gnu_pubtypes", ".debug_gnu_pubtypes"),
76 clEnumValN(DIDT_Str, "str", ".debug_str"),
77 clEnumValN(DIDT_StrDwo, "str.dwo", ".debug_str.dwo"),
78 clEnumValN(DIDT_StrOffsetsDwo, "str_offsets.dwo", ".debug_str_offsets.dwo"),
81 static void PrintDILineInfo(DILineInfo dli) {
83 outs() << (dli.getFunctionName() ? dli.getFunctionName() : "<unknown>")
85 outs() << (dli.getFileName() ? dli.getFileName() : "<unknown>") << ':'
86 << dli.getLine() << ':' << dli.getColumn() << '\n';
89 static void DumpInput(const StringRef &Filename) {
90 std::unique_ptr<MemoryBuffer> Buff;
92 if (error_code ec = MemoryBuffer::getFileOrSTDIN(Filename, Buff)) {
93 errs() << Filename << ": " << ec.message() << "\n";
97 ErrorOr<ObjectFile*> ObjOrErr(ObjectFile::createObjectFile(Buff.release()));
98 if (error_code EC = ObjOrErr.getError()) {
99 errs() << Filename << ": " << EC.message() << '\n';
102 std::unique_ptr<ObjectFile> Obj(ObjOrErr.get());
104 std::unique_ptr<DIContext> DICtx(DIContext::getDWARFContext(Obj.get()));
106 if (Address == -1ULL) {
108 << ":\tfile format " << Obj->getFileFormatName() << "\n\n";
109 // Dump the complete DWARF structure.
110 DICtx->dump(outs(), DumpType);
112 // Print line info for the specified address.
113 int SpecFlags = DILineInfoSpecifier::FileLineInfo |
114 DILineInfoSpecifier::AbsoluteFilePath;
116 SpecFlags |= DILineInfoSpecifier::FunctionName;
118 DIInliningInfo InliningInfo =
119 DICtx->getInliningInfoForAddress(Address, SpecFlags);
120 uint32_t n = InliningInfo.getNumberOfFrames();
122 // Print one empty debug line info in any case.
123 PrintDILineInfo(DILineInfo());
125 for (uint32_t i = 0; i < n; i++) {
126 DILineInfo dli = InliningInfo.getFrame(i);
127 PrintDILineInfo(dli);
131 DILineInfo dli = DICtx->getLineInfoForAddress(Address, SpecFlags);
132 PrintDILineInfo(dli);
137 int main(int argc, char **argv) {
138 // Print a stack trace if we signal out.
139 sys::PrintStackTraceOnErrorSignal();
140 PrettyStackTraceProgram X(argc, argv);
141 llvm_shutdown_obj Y; // Call llvm_shutdown() on exit.
143 cl::ParseCommandLineOptions(argc, argv, "llvm dwarf dumper\n");
145 // Defaults to a.out if no filenames specified.
146 if (InputFilenames.size() == 0)
147 InputFilenames.push_back("a.out");
149 std::for_each(InputFilenames.begin(), InputFilenames.end(), DumpInput);