1 //===-- llvm-dwarfdump.cpp - Debug info dumping utility for llvm ----------===//
2 //
3 // The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This program is a utility that works like "dwarfdump".
11 //
12 //===----------------------------------------------------------------------===//
13
14 #include "llvm/ADT/STLExtras.h"
15 #include "llvm/ADT/Triple.h"
16 #include "llvm/DebugInfo/DIContext.h"
17 #include "llvm/DebugInfo/DWARF/DWARFContext.h"
18 #include "llvm/Object/MachOUniversal.h"
19 #include "llvm/Object/ObjectFile.h"
20 #include "llvm/Object/RelocVisitor.h"
21 #include "llvm/Support/CommandLine.h"
22 #include "llvm/Support/Debug.h"
23 #include "llvm/Support/Format.h"
24 #include "llvm/Support/ManagedStatic.h"
25 #include "llvm/Support/MemoryBuffer.h"
26 #include "llvm/Support/Path.h"
27 #include "llvm/Support/PrettyStackTrace.h"
28 #include "llvm/Support/Signals.h"
29 #include "llvm/Support/raw_ostream.h"
30 #include <algorithm>
31 #include <cstring>
32 #include <string>
33 #include <system_error>
34
35 using namespace llvm;
36 using namespace object;
37
38 static cl::list<std::string>
39 InputFilenames(cl::Positional, cl::desc("<input object files or .dSYM bundles>"),
40 cl::ZeroOrMore);
41
42 static cl::opt<DIDumpType> DumpType(
43 "debug-dump", cl::init(DIDT_All), cl::desc("Dump of debug sections:"),
44 cl::values(
45 clEnumValN(DIDT_All, "all", "Dump all debug sections"),
46 clEnumValN(DIDT_Abbrev, "abbrev", ".debug_abbrev"),
47 clEnumValN(DIDT_AbbrevDwo, "abbrev.dwo", ".debug_abbrev.dwo"),
48 clEnumValN(DIDT_AppleNames, "apple_names", ".apple_names"),
49 clEnumValN(DIDT_AppleTypes, "apple_types", ".apple_types"),
50 clEnumValN(DIDT_AppleNamespaces, "apple_namespaces",
51 ".apple_namespaces"),
52 clEnumValN(DIDT_AppleObjC, "apple_objc", ".apple_objc"),
53 clEnumValN(DIDT_Aranges, "aranges", ".debug_aranges"),
54 clEnumValN(DIDT_Info, "info", ".debug_info"),
55 clEnumValN(DIDT_InfoDwo, "info.dwo", ".debug_info.dwo"),
56 clEnumValN(DIDT_Types, "types", ".debug_types"),
57 clEnumValN(DIDT_TypesDwo, "types.dwo", ".debug_types.dwo"),
58 clEnumValN(DIDT_Line, "line", ".debug_line"),
59 clEnumValN(DIDT_LineDwo, "line.dwo", ".debug_line.dwo"),
60 clEnumValN(DIDT_Loc, "loc", ".debug_loc"),
61 clEnumValN(DIDT_LocDwo, "loc.dwo", ".debug_loc.dwo"),
62 clEnumValN(DIDT_Frames, "frames", ".debug_frame"),
63 clEnumValN(DIDT_Macro, "macro", ".debug_macinfo"),
64 clEnumValN(DIDT_Ranges, "ranges", ".debug_ranges"),
65 clEnumValN(DIDT_Pubnames, "pubnames", ".debug_pubnames"),
66 clEnumValN(DIDT_Pubtypes, "pubtypes", ".debug_pubtypes"),
67 clEnumValN(DIDT_GnuPubnames, "gnu_pubnames", ".debug_gnu_pubnames"),
68 clEnumValN(DIDT_GnuPubtypes, "gnu_pubtypes", ".debug_gnu_pubtypes"),
69 clEnumValN(DIDT_Str, "str", ".debug_str"),
70 clEnumValN(DIDT_StrDwo, "str.dwo", ".debug_str.dwo"),
71 clEnumValN(DIDT_StrOffsetsDwo, "str_offsets.dwo",
72 ".debug_str_offsets.dwo"),
73 clEnumValN(DIDT_CUIndex, "cu_index", ".debug_cu_index"),
74 clEnumValN(DIDT_TUIndex, "tu_index", ".debug_tu_index"), clEnumValEnd));
75
error(StringRef Filename,std::error_code EC)76 static void error(StringRef Filename, std::error_code EC) {
77 if (!EC)
78 return;
79 errs() << Filename << ": " << EC.message() << "\n";
80 exit(1);
81 }
82
DumpObjectFile(ObjectFile & Obj,Twine Filename)83 static void DumpObjectFile(ObjectFile &Obj, Twine Filename) {
84 std::unique_ptr<DIContext> DICtx(new DWARFContextInMemory(Obj));
85
86 outs() << Filename.str() << ":\tfile format " << Obj.getFileFormatName()
87 << "\n\n";
88 // Dump the complete DWARF structure.
89 DICtx->dump(outs(), DumpType);
90 }
91
DumpInput(StringRef Filename)92 static void DumpInput(StringRef Filename) {
93 ErrorOr<std::unique_ptr<MemoryBuffer>> BuffOrErr =
94 MemoryBuffer::getFileOrSTDIN(Filename);
95 error(Filename, BuffOrErr.getError());
96 std::unique_ptr<MemoryBuffer> Buff = std::move(BuffOrErr.get());
97
98 Expected<std::unique_ptr<Binary>> BinOrErr =
99 object::createBinary(Buff->getMemBufferRef());
100 if (!BinOrErr)
101 error(Filename, errorToErrorCode(BinOrErr.takeError()));
102
103 if (auto *Obj = dyn_cast<ObjectFile>(BinOrErr->get()))
104 DumpObjectFile(*Obj, Filename);
105 else if (auto *Fat = dyn_cast<MachOUniversalBinary>(BinOrErr->get()))
106 for (auto &ObjForArch : Fat->objects()) {
107 auto MachOOrErr = ObjForArch.getAsObjectFile();
108 error(Filename, errorToErrorCode(MachOOrErr.takeError()));
109 DumpObjectFile(**MachOOrErr,
110 Filename + " (" + ObjForArch.getArchTypeName() + ")");
111 }
112 }
113
114 /// If the input path is a .dSYM bundle (as created by the dsymutil tool),
115 /// replace it with individual entries for each of the object files inside the
116 /// bundle otherwise return the input path.
expandBundle(const std::string & InputPath)117 static std::vector<std::string> expandBundle(const std::string &InputPath) {
118 std::vector<std::string> BundlePaths;
119 SmallString<256> BundlePath(InputPath);
120 // Manually open up the bundle to avoid introducing additional dependencies.
121 if (sys::fs::is_directory(BundlePath) &&
122 sys::path::extension(BundlePath) == ".dSYM") {
123 std::error_code EC;
124 sys::path::append(BundlePath, "Contents", "Resources", "DWARF");
125 for (sys::fs::directory_iterator Dir(BundlePath, EC), DirEnd;
126 Dir != DirEnd && !EC; Dir.increment(EC)) {
127 const std::string &Path = Dir->path();
128 sys::fs::file_status Status;
129 EC = sys::fs::status(Path, Status);
130 error(Path, EC);
131 switch (Status.type()) {
132 case sys::fs::file_type::regular_file:
133 case sys::fs::file_type::symlink_file:
134 case sys::fs::file_type::type_unknown:
135 BundlePaths.push_back(Path);
136 break;
137 default: /*ignore*/;
138 }
139 }
140 error(BundlePath, EC);
141 }
142 if (!BundlePaths.size())
143 BundlePaths.push_back(InputPath);
144 return BundlePaths;
145 }
146
main(int argc,char ** argv)147 int main(int argc, char **argv) {
148 // Print a stack trace if we signal out.
149 sys::PrintStackTraceOnErrorSignal(argv[0]);
150 PrettyStackTraceProgram X(argc, argv);
151 llvm_shutdown_obj Y; // Call llvm_shutdown() on exit.
152
153 cl::ParseCommandLineOptions(argc, argv, "llvm dwarf dumper\n");
154
155 // Defaults to a.out if no filenames specified.
156 if (InputFilenames.size() == 0)
157 InputFilenames.push_back("a.out");
158
159 // Expand any .dSYM bundles to the individual object files contained therein.
160 std::vector<std::string> Objects;
161 for (const auto &F : InputFilenames) {
162 auto Objs = expandBundle(F);
163 Objects.insert(Objects.end(), Objs.begin(), Objs.end());
164 }
165
166 std::for_each(Objects.begin(), Objects.end(), DumpInput);
167
168 return EXIT_SUCCESS;
169 }
170