1 //===-- SymbolFileDWARFDebugMap.cpp ----------------------------*- C++ -*-===//
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 #include "SymbolFileDWARFDebugMap.h"
11 
12 #include "lldb/Core/Module.h"
13 #include "lldb/Core/ModuleList.h"
14 #include "lldb/Core/PluginManager.h"
15 #include "lldb/Core/RegularExpression.h"
16 #include "lldb/Core/StreamFile.h"
17 #include "lldb/Core/Timer.h"
18 
19 #include "lldb/Symbol/ClangExternalASTSourceCallbacks.h"
20 #include "lldb/Symbol/ObjectFile.h"
21 #include "lldb/Symbol/SymbolVendor.h"
22 #include "lldb/Symbol/VariableList.h"
23 
24 #include "SymbolFileDWARF.h"
25 
26 using namespace lldb;
27 using namespace lldb_private;
28 
29 void
30 SymbolFileDWARFDebugMap::Initialize()
31 {
32     PluginManager::RegisterPlugin (GetPluginNameStatic(),
33                                    GetPluginDescriptionStatic(),
34                                    CreateInstance);
35 }
36 
37 void
38 SymbolFileDWARFDebugMap::Terminate()
39 {
40     PluginManager::UnregisterPlugin (CreateInstance);
41 }
42 
43 
44 const char *
45 SymbolFileDWARFDebugMap::GetPluginNameStatic()
46 {
47     return "dwarf-debugmap";
48 }
49 
50 const char *
51 SymbolFileDWARFDebugMap::GetPluginDescriptionStatic()
52 {
53     return "DWARF and DWARF3 debug symbol file reader (debug map).";
54 }
55 
56 SymbolFile*
57 SymbolFileDWARFDebugMap::CreateInstance (ObjectFile* obj_file)
58 {
59     return new SymbolFileDWARFDebugMap (obj_file);
60 }
61 
62 
63 SymbolFileDWARFDebugMap::SymbolFileDWARFDebugMap (ObjectFile* ofile) :
64     SymbolFile(ofile),
65     m_flags(),
66     m_compile_unit_infos(),
67     m_func_indexes(),
68     m_glob_indexes()
69 {
70 }
71 
72 
73 SymbolFileDWARFDebugMap::~SymbolFileDWARFDebugMap()
74 {
75 }
76 
77 void
78 SymbolFileDWARFDebugMap::InitializeObject()
79 {
80     // Install our external AST source callbacks so we can complete Clang types.
81     llvm::OwningPtr<clang::ExternalASTSource> ast_source_ap (
82         new ClangExternalASTSourceCallbacks (SymbolFileDWARFDebugMap::CompleteTagDecl,
83                                              SymbolFileDWARFDebugMap::CompleteObjCInterfaceDecl,
84                                              NULL,
85                                              this));
86 
87     GetClangASTContext().SetExternalSource (ast_source_ap);
88 }
89 
90 
91 
92 void
93 SymbolFileDWARFDebugMap::InitOSO ()
94 {
95     if (m_flags.test(kHaveInitializedOSOs))
96         return;
97 
98     m_flags.set(kHaveInitializedOSOs);
99     // In order to get the abilities of this plug-in, we look at the list of
100     // N_OSO entries (object files) from the symbol table and make sure that
101     // these files exist and also contain valid DWARF. If we get any of that
102     // then we return the abilities of the first N_OSO's DWARF.
103 
104     Symtab* symtab = m_obj_file->GetSymtab();
105     if (symtab)
106     {
107         std::vector<uint32_t> oso_indexes;
108 //      StreamFile s(stdout);
109 //      symtab->Dump(&s, NULL, eSortOrderNone);
110 
111         // When a mach-o symbol is encoded, the n_type field is encoded in bits
112         // 23:16, and the n_desc field is encoded in bits 15:0.
113         //
114         // To find all N_OSO entries that are part of the DWARF + debug map
115         // we find only object file symbols with the flags value as follows:
116         // bits 23:16 == 0x66 (N_OSO)
117         // bits 15: 0 == 0x0001 (specifies this is a debug map object file)
118         const uint32_t k_oso_symbol_flags_value = 0x660001u;
119 
120         const uint32_t oso_index_count = symtab->AppendSymbolIndexesWithTypeAndFlagsValue(eSymbolTypeObjectFile, k_oso_symbol_flags_value, oso_indexes);
121 
122         if (oso_index_count > 0)
123         {
124             symtab->AppendSymbolIndexesWithType (eSymbolTypeCode, Symtab::eDebugYes, Symtab::eVisibilityAny, m_func_indexes);
125             symtab->AppendSymbolIndexesWithType (eSymbolTypeData, Symtab::eDebugYes, Symtab::eVisibilityAny, m_glob_indexes);
126 
127             symtab->SortSymbolIndexesByValue(m_func_indexes, true);
128             symtab->SortSymbolIndexesByValue(m_glob_indexes, true);
129 
130             m_compile_unit_infos.resize(oso_index_count);
131 //          s.Printf("%s N_OSO symbols:\n", __PRETTY_FUNCTION__);
132 //          symtab->Dump(&s, oso_indexes);
133 
134             for (uint32_t i=0; i<oso_index_count; ++i)
135             {
136                 m_compile_unit_infos[i].so_symbol = symtab->SymbolAtIndex(oso_indexes[i] - 1);
137                 if (m_compile_unit_infos[i].so_symbol->GetSiblingIndex() == 0)
138                     m_compile_unit_infos[i].so_symbol = symtab->SymbolAtIndex(oso_indexes[i] - 2);
139                 m_compile_unit_infos[i].oso_symbol = symtab->SymbolAtIndex(oso_indexes[i]);
140                 uint32_t sibling_idx = m_compile_unit_infos[i].so_symbol->GetSiblingIndex();
141                 assert (sibling_idx != 0);
142                 assert (sibling_idx > i + 1);
143                 m_compile_unit_infos[i].last_symbol = symtab->SymbolAtIndex (sibling_idx - 1);
144                 m_compile_unit_infos[i].first_symbol_index = symtab->GetIndexForSymbol(m_compile_unit_infos[i].so_symbol);
145                 m_compile_unit_infos[i].last_symbol_index = symtab->GetIndexForSymbol(m_compile_unit_infos[i].last_symbol);
146             }
147         }
148     }
149 }
150 
151 Module *
152 SymbolFileDWARFDebugMap::GetModuleByOSOIndex (uint32_t oso_idx)
153 {
154     const uint32_t cu_count = GetNumCompileUnits();
155     if (oso_idx < cu_count)
156         return GetModuleByCompUnitInfo (&m_compile_unit_infos[oso_idx]);
157     return NULL;
158 }
159 
160 Module *
161 SymbolFileDWARFDebugMap::GetModuleByCompUnitInfo (CompileUnitInfo *comp_unit_info)
162 {
163     if (comp_unit_info->oso_module_sp.get() == NULL)
164     {
165         Symbol *oso_symbol = comp_unit_info->oso_symbol;
166         if (oso_symbol)
167         {
168             FileSpec oso_file_spec(oso_symbol->GetMangled().GetName().AsCString(), true);
169             // Always create a new module for .o files. Why? Because we
170             // use the debug map, to add new sections to each .o file and
171             // even though a .o file might not have changed, the sections
172             // that get added to the .o file can change.
173             comp_unit_info->oso_module_sp = new Module (oso_file_spec,
174                                                         m_obj_file->GetModule()->GetArchitecture(),
175                                                         NULL,
176                                                         0);
177         }
178     }
179     return comp_unit_info->oso_module_sp.get();
180 }
181 
182 
183 bool
184 SymbolFileDWARFDebugMap::GetFileSpecForSO (uint32_t oso_idx, FileSpec &file_spec)
185 {
186     if (oso_idx < m_compile_unit_infos.size())
187     {
188         if (!m_compile_unit_infos[oso_idx].so_file)
189         {
190 
191             if (m_compile_unit_infos[oso_idx].so_symbol == NULL)
192                 return false;
193 
194             std::string so_path (m_compile_unit_infos[oso_idx].so_symbol->GetMangled().GetName().AsCString());
195             if (m_compile_unit_infos[oso_idx].so_symbol[1].GetType() == eSymbolTypeSourceFile)
196                 so_path += m_compile_unit_infos[oso_idx].so_symbol[1].GetMangled().GetName().AsCString();
197             m_compile_unit_infos[oso_idx].so_file.SetFile(so_path.c_str(), true);
198         }
199         file_spec = m_compile_unit_infos[oso_idx].so_file;
200         return true;
201     }
202     return false;
203 }
204 
205 
206 
207 ObjectFile *
208 SymbolFileDWARFDebugMap::GetObjectFileByOSOIndex (uint32_t oso_idx)
209 {
210     Module *oso_module = GetModuleByOSOIndex (oso_idx);
211     if (oso_module)
212         return oso_module->GetObjectFile();
213     return NULL;
214 }
215 
216 SymbolFileDWARF *
217 SymbolFileDWARFDebugMap::GetSymbolFile (const SymbolContext& sc)
218 {
219     CompileUnitInfo *comp_unit_info = GetCompUnitInfo (sc);
220     if (comp_unit_info)
221         return GetSymbolFileByCompUnitInfo (comp_unit_info);
222     return NULL;
223 }
224 
225 ObjectFile *
226 SymbolFileDWARFDebugMap::GetObjectFileByCompUnitInfo (CompileUnitInfo *comp_unit_info)
227 {
228     Module *oso_module = GetModuleByCompUnitInfo (comp_unit_info);
229     if (oso_module)
230         return oso_module->GetObjectFile();
231     return NULL;
232 }
233 
234 
235 uint32_t
236 SymbolFileDWARFDebugMap::GetCompUnitInfoIndex (const CompileUnitInfo *comp_unit_info)
237 {
238     if (!m_compile_unit_infos.empty())
239     {
240         const CompileUnitInfo *first_comp_unit_info = &m_compile_unit_infos.front();
241         const CompileUnitInfo *last_comp_unit_info = &m_compile_unit_infos.back();
242         if (first_comp_unit_info <= comp_unit_info && comp_unit_info <= last_comp_unit_info)
243             return comp_unit_info - first_comp_unit_info;
244     }
245     return UINT32_MAX;
246 }
247 
248 SymbolFileDWARF *
249 SymbolFileDWARFDebugMap::GetSymbolFileByOSOIndex (uint32_t oso_idx)
250 {
251     if (oso_idx < m_compile_unit_infos.size())
252         return GetSymbolFileByCompUnitInfo (&m_compile_unit_infos[oso_idx]);
253     return NULL;
254 }
255 
256 SymbolFileDWARF *
257 SymbolFileDWARFDebugMap::GetSymbolFileByCompUnitInfo (CompileUnitInfo *comp_unit_info)
258 {
259     if (comp_unit_info->oso_symbol_vendor == NULL)
260     {
261         ObjectFile *oso_objfile = GetObjectFileByCompUnitInfo (comp_unit_info);
262 
263         if (oso_objfile)
264         {
265             comp_unit_info->oso_symbol_vendor = oso_objfile->GetModule()->GetSymbolVendor();
266 //          SymbolFileDWARF *oso_dwarf = new SymbolFileDWARF(oso_objfile);
267 //          comp_unit_info->oso_dwarf_sp.reset (oso_dwarf);
268             if (comp_unit_info->oso_symbol_vendor)
269             {
270                 // Set a a pointer to this class to set our OSO DWARF file know
271                 // that the DWARF is being used along with a debug map and that
272                 // it will have the remapped sections that we do below.
273                 SymbolFileDWARF *oso_symfile = (SymbolFileDWARF *)comp_unit_info->oso_symbol_vendor->GetSymbolFile();
274                 oso_symfile->SetDebugMapSymfile(this);
275                 // Set the ID of the symbol file DWARF to the index of the OSO
276                 // shifted left by 32 bits to provide a unique prefix for any
277                 // UserID's that get created in the symbol file.
278                 oso_symfile->SetID (((uint64_t)GetCompUnitInfoIndex(comp_unit_info) + 1ull) << 32ull);
279                 comp_unit_info->debug_map_sections_sp.reset(new SectionList);
280 
281                 Symtab *exe_symtab = m_obj_file->GetSymtab();
282                 Module *oso_module = oso_objfile->GetModule();
283                 Symtab *oso_symtab = oso_objfile->GetSymtab();
284 //#define DEBUG_OSO_DMAP    // Do not check in with this defined...
285 #if defined(DEBUG_OSO_DMAP)
286                 StreamFile s(stdout);
287                 s << "OSO symtab:\n";
288                 oso_symtab->Dump(&s, NULL);
289                 s << "OSO sections before:\n";
290                 oso_objfile->GetSectionList()->Dump(&s, NULL, true);
291 #endif
292 
293                 ///const uint32_t fun_resolve_flags = SymbolContext::Module | eSymbolContextCompUnit | eSymbolContextFunction;
294                 //SectionList *oso_sections = oso_objfile->Sections();
295                 // Now we need to make sections that map from zero based object
296                 // file addresses to where things eneded up in the main executable.
297                 uint32_t oso_start_idx = exe_symtab->GetIndexForSymbol (comp_unit_info->oso_symbol);
298                 assert (oso_start_idx != UINT32_MAX);
299                 oso_start_idx += 1;
300                 const uint32_t oso_end_idx = comp_unit_info->so_symbol->GetSiblingIndex();
301                 uint32_t sect_id = 0x10000;
302                 for (uint32_t idx = oso_start_idx; idx < oso_end_idx; ++idx)
303                 {
304                     Symbol *exe_symbol = exe_symtab->SymbolAtIndex(idx);
305                     if (exe_symbol)
306                     {
307                         if (exe_symbol->IsDebug() == false)
308                             continue;
309 
310                         switch (exe_symbol->GetType())
311                         {
312                         default:
313                             break;
314 
315                         case eSymbolTypeCode:
316                             {
317                                 // For each N_FUN, or function that we run into in the debug map
318                                 // we make a new section that we add to the sections found in the
319                                 // .o file. This new section has the file address set to what the
320                                 // addresses are in the .o file, and the load address is adjusted
321                                 // to match where it ended up in the final executable! We do this
322                                 // before we parse any dwarf info so that when it goes get parsed
323                                 // all section/offset addresses that get registered will resolve
324                                 // correctly to the new addresses in the main executable.
325 
326                                 // First we find the original symbol in the .o file's symbol table
327                                 Symbol *oso_fun_symbol = oso_symtab->FindFirstSymbolWithNameAndType(exe_symbol->GetMangled().GetName(Mangled::ePreferMangled), eSymbolTypeCode, Symtab::eDebugNo, Symtab::eVisibilityAny);
328                                 if (oso_fun_symbol)
329                                 {
330                                     // If we found the symbol, then we
331                                     Section* exe_fun_section = const_cast<Section *>(exe_symbol->GetAddressRangePtr()->GetBaseAddress().GetSection());
332                                     Section* oso_fun_section = const_cast<Section *>(oso_fun_symbol->GetAddressRangePtr()->GetBaseAddress().GetSection());
333                                     if (oso_fun_section)
334                                     {
335                                         // Now we create a section that we will add as a child of the
336                                         // section in which the .o symbol (the N_FUN) exists.
337 
338                                         // We use the exe_symbol size because the one in the .o file
339                                         // will just be a symbol with no size, and the exe_symbol
340                                         // size will reflect any size changes (ppc has been known to
341                                         // shrink function sizes when it gets rid of jump islands that
342                                         // aren't needed anymore).
343                                         SectionSP oso_fun_section_sp (new Section (const_cast<Section *>(oso_fun_symbol->GetAddressRangePtr()->GetBaseAddress().GetSection()),
344                                                                                    oso_module,                         // Module (the .o file)
345                                                                                    sect_id++,                          // Section ID starts at 0x10000 and increments so the section IDs don't overlap with the standard mach IDs
346                                                                                    exe_symbol->GetMangled().GetName(Mangled::ePreferMangled), // Name the section the same as the symbol for which is was generated!
347                                                                                    eSectionTypeDebug,
348                                                                                    oso_fun_symbol->GetAddressRangePtr()->GetBaseAddress().GetOffset(),  // File VM address offset in the current section
349                                                                                    exe_symbol->GetByteSize(),          // File size (we need the size from the executable)
350                                                                                    0, 0, 0));
351 
352                                         oso_fun_section_sp->SetLinkedLocation (exe_fun_section,
353                                                                                exe_symbol->GetValue().GetFileAddress() - exe_fun_section->GetFileAddress());
354                                         oso_fun_section->GetChildren().AddSection(oso_fun_section_sp);
355                                         comp_unit_info->debug_map_sections_sp->AddSection(oso_fun_section_sp);
356                                     }
357                                 }
358                             }
359                             break;
360 
361                         case eSymbolTypeData:
362                             {
363                                 // For each N_GSYM we remap the address for the global by making
364                                 // a new section that we add to the sections found in the .o file.
365                                 // This new section has the file address set to what the
366                                 // addresses are in the .o file, and the load address is adjusted
367                                 // to match where it ended up in the final executable! We do this
368                                 // before we parse any dwarf info so that when it goes get parsed
369                                 // all section/offset addresses that get registered will resolve
370                                 // correctly to the new addresses in the main executable. We
371                                 // initially set the section size to be 1 byte, but will need to
372                                 // fix up these addresses further after all globals have been
373                                 // parsed to span the gaps, or we can find the global variable
374                                 // sizes from the DWARF info as we are parsing.
375 
376                                 // Next we find the non-stab entry that corresponds to the N_GSYM in the .o file
377                                 Symbol *oso_gsym_symbol = oso_symtab->FindFirstSymbolWithNameAndType (exe_symbol->GetMangled().GetName(),
378                                                                                                       eSymbolTypeData,
379                                                                                                       Symtab::eDebugNo,
380                                                                                                       Symtab::eVisibilityAny);
381 
382                                 if (exe_symbol && oso_gsym_symbol && exe_symbol->GetAddressRangePtr() && oso_gsym_symbol->GetAddressRangePtr())
383                                 {
384                                     // If we found the symbol, then we
385                                     Section* exe_gsym_section = const_cast<Section *>(exe_symbol->GetAddressRangePtr()->GetBaseAddress().GetSection());
386                                     Section* oso_gsym_section = const_cast<Section *>(oso_gsym_symbol->GetAddressRangePtr()->GetBaseAddress().GetSection());
387                                     if (oso_gsym_section)
388                                     {
389                                         SectionSP oso_gsym_section_sp (new Section (const_cast<Section *>(oso_gsym_symbol->GetAddressRangePtr()->GetBaseAddress().GetSection()),
390                                                                                     oso_module,                         // Module (the .o file)
391                                                                                     sect_id++,                          // Section ID starts at 0x10000 and increments so the section IDs don't overlap with the standard mach IDs
392                                                                                     exe_symbol->GetMangled().GetName(Mangled::ePreferMangled), // Name the section the same as the symbol for which is was generated!
393                                                                                     eSectionTypeDebug,
394                                                                                     oso_gsym_symbol->GetAddressRangePtr()->GetBaseAddress().GetOffset(),  // File VM address offset in the current section
395                                                                                     1,                                   // We don't know the size of the global, just do the main address for now.
396                                                                                     0, 0, 0));
397 
398                                         oso_gsym_section_sp->SetLinkedLocation (exe_gsym_section,
399                                                                                 exe_symbol->GetValue().GetFileAddress() - exe_gsym_section->GetFileAddress());
400                                         oso_gsym_section->GetChildren().AddSection(oso_gsym_section_sp);
401                                         comp_unit_info->debug_map_sections_sp->AddSection(oso_gsym_section_sp);
402                                     }
403                                 }
404                             }
405                             break;
406                         }
407                     }
408                 }
409 #if defined(DEBUG_OSO_DMAP)
410                 s << "OSO sections after:\n";
411                 oso_objfile->GetSectionList()->Dump(&s, NULL, true);
412 #endif
413             }
414         }
415     }
416     if (comp_unit_info->oso_symbol_vendor)
417         return (SymbolFileDWARF *)comp_unit_info->oso_symbol_vendor->GetSymbolFile();
418     return NULL;
419 }
420 
421 uint32_t
422 SymbolFileDWARFDebugMap::GetAbilities ()
423 {
424     // In order to get the abilities of this plug-in, we look at the list of
425     // N_OSO entries (object files) from the symbol table and make sure that
426     // these files exist and also contain valid DWARF. If we get any of that
427     // then we return the abilities of the first N_OSO's DWARF.
428 
429     const uint32_t oso_index_count = GetNumCompileUnits();
430     if (oso_index_count > 0)
431     {
432         const uint32_t dwarf_abilities = SymbolFile::CompileUnits |
433                                          SymbolFile::Functions |
434                                          SymbolFile::Blocks |
435                                          SymbolFile::GlobalVariables |
436                                          SymbolFile::LocalVariables |
437                                          SymbolFile::VariableTypes |
438                                          SymbolFile::LineTables;
439 
440         for (uint32_t oso_idx=0; oso_idx<oso_index_count; ++oso_idx)
441         {
442             SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex (oso_idx);
443             if (oso_dwarf)
444             {
445                 uint32_t oso_abilities = oso_dwarf->GetAbilities();
446                 if ((oso_abilities & dwarf_abilities) == dwarf_abilities)
447                     return oso_abilities;
448             }
449         }
450     }
451     return 0;
452 }
453 
454 uint32_t
455 SymbolFileDWARFDebugMap::GetNumCompileUnits()
456 {
457     InitOSO ();
458     return m_compile_unit_infos.size();
459 }
460 
461 
462 CompUnitSP
463 SymbolFileDWARFDebugMap::ParseCompileUnitAtIndex(uint32_t cu_idx)
464 {
465     CompUnitSP comp_unit_sp;
466     const uint32_t cu_count = GetNumCompileUnits();
467 
468     if (cu_idx < cu_count)
469     {
470         if (m_compile_unit_infos[cu_idx].oso_compile_unit_sp.get() == NULL)
471         {
472             SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex (cu_idx);
473             if (oso_dwarf)
474             {
475                 // There is only one compile unit for N_OSO entry right now, so
476                 // it will always exist at index zero.
477                 m_compile_unit_infos[cu_idx].oso_compile_unit_sp = m_compile_unit_infos[cu_idx].oso_symbol_vendor->GetCompileUnitAtIndex (0);
478             }
479 
480             if (m_compile_unit_infos[cu_idx].oso_compile_unit_sp.get() == NULL)
481             {
482                 // We weren't able to get the DWARF for this N_OSO entry (the
483                 // .o file may be missing or not at the specified path), make
484                 // one up as best we can from the debug map. We set the uid
485                 // of the compile unit to the symbol index with the MSBit set
486                 // so that it doesn't collide with any uid values from the DWARF
487                 Symbol *so_symbol = m_compile_unit_infos[cu_idx].so_symbol;
488                 if (so_symbol)
489                 {
490                     m_compile_unit_infos[cu_idx].oso_compile_unit_sp.reset(new CompileUnit (m_obj_file->GetModule(),
491                                                                                             NULL,
492                                                                                             so_symbol->GetMangled().GetName().AsCString(),
493                                                                                             cu_idx,
494                                                                                             eLanguageTypeUnknown));
495 
496                     // Let our symbol vendor know about this compile unit
497                     m_obj_file->GetModule()->GetSymbolVendor()->SetCompileUnitAtIndex (m_compile_unit_infos[cu_idx].oso_compile_unit_sp,
498                                                                                        cu_idx);
499                 }
500             }
501         }
502         comp_unit_sp = m_compile_unit_infos[cu_idx].oso_compile_unit_sp;
503     }
504 
505     return comp_unit_sp;
506 }
507 
508 SymbolFileDWARFDebugMap::CompileUnitInfo *
509 SymbolFileDWARFDebugMap::GetCompUnitInfo (const SymbolContext& sc)
510 {
511     const uint32_t cu_count = GetNumCompileUnits();
512     for (uint32_t i=0; i<cu_count; ++i)
513     {
514         if (sc.comp_unit == m_compile_unit_infos[i].oso_compile_unit_sp.get())
515             return &m_compile_unit_infos[i];
516     }
517     return NULL;
518 }
519 
520 size_t
521 SymbolFileDWARFDebugMap::ParseCompileUnitFunctions (const SymbolContext& sc)
522 {
523     SymbolFileDWARF *oso_dwarf = GetSymbolFile (sc);
524     if (oso_dwarf)
525         return oso_dwarf->ParseCompileUnitFunctions (sc);
526     return 0;
527 }
528 
529 bool
530 SymbolFileDWARFDebugMap::ParseCompileUnitLineTable (const SymbolContext& sc)
531 {
532     SymbolFileDWARF *oso_dwarf = GetSymbolFile (sc);
533     if (oso_dwarf)
534         return oso_dwarf->ParseCompileUnitLineTable (sc);
535     return false;
536 }
537 
538 bool
539 SymbolFileDWARFDebugMap::ParseCompileUnitSupportFiles (const SymbolContext& sc, FileSpecList &support_files)
540 {
541     SymbolFileDWARF *oso_dwarf = GetSymbolFile (sc);
542     if (oso_dwarf)
543         return oso_dwarf->ParseCompileUnitSupportFiles (sc, support_files);
544     return false;
545 }
546 
547 
548 size_t
549 SymbolFileDWARFDebugMap::ParseFunctionBlocks (const SymbolContext& sc)
550 {
551     SymbolFileDWARF *oso_dwarf = GetSymbolFile (sc);
552     if (oso_dwarf)
553         return oso_dwarf->ParseFunctionBlocks (sc);
554     return 0;
555 }
556 
557 
558 size_t
559 SymbolFileDWARFDebugMap::ParseTypes (const SymbolContext& sc)
560 {
561     SymbolFileDWARF *oso_dwarf = GetSymbolFile (sc);
562     if (oso_dwarf)
563         return oso_dwarf->ParseTypes (sc);
564     return 0;
565 }
566 
567 
568 size_t
569 SymbolFileDWARFDebugMap::ParseVariablesForContext (const SymbolContext& sc)
570 {
571     SymbolFileDWARF *oso_dwarf = GetSymbolFile (sc);
572     if (oso_dwarf)
573         return oso_dwarf->ParseTypes (sc);
574     return 0;
575 }
576 
577 
578 
579 Type*
580 SymbolFileDWARFDebugMap::ResolveTypeUID(lldb::user_id_t type_uid)
581 {
582     const uint64_t oso_idx = GetOSOIndexFromUserID (type_uid);
583     SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex (oso_idx);
584     if (oso_dwarf)
585         oso_dwarf->ResolveTypeUID (type_uid);
586     return NULL;
587 }
588 
589 lldb::clang_type_t
590 SymbolFileDWARFDebugMap::ResolveClangOpaqueTypeDefinition (lldb::clang_type_t clang_type)
591 {
592     // We have a struct/union/class/enum that needs to be fully resolved.
593     return NULL;
594 }
595 
596 uint32_t
597 SymbolFileDWARFDebugMap::ResolveSymbolContext (const Address& exe_so_addr, uint32_t resolve_scope, SymbolContext& sc)
598 {
599     uint32_t resolved_flags = 0;
600     Symtab* symtab = m_obj_file->GetSymtab();
601     if (symtab)
602     {
603         const addr_t exe_file_addr = exe_so_addr.GetFileAddress();
604         sc.symbol = symtab->FindSymbolContainingFileAddress (exe_file_addr, &m_func_indexes[0], m_func_indexes.size());
605 
606         if (sc.symbol != NULL)
607         {
608             resolved_flags |= eSymbolContextSymbol;
609 
610             uint32_t oso_idx = 0;
611             CompileUnitInfo* comp_unit_info = GetCompileUnitInfoForSymbolWithID (sc.symbol->GetID(), &oso_idx);
612             if (comp_unit_info)
613             {
614                 SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex (oso_idx);
615                 ObjectFile *oso_objfile = GetObjectFileByOSOIndex (oso_idx);
616                 if (oso_dwarf && oso_objfile)
617                 {
618                     SectionList *oso_section_list = oso_objfile->GetSectionList();
619 
620                     SectionSP oso_symbol_section_sp (oso_section_list->FindSectionContainingLinkedFileAddress (exe_file_addr, UINT32_MAX));
621 
622                     if (oso_symbol_section_sp)
623                     {
624                         const addr_t linked_file_addr = oso_symbol_section_sp->GetLinkedFileAddress();
625                         Address oso_so_addr (oso_symbol_section_sp.get(), exe_file_addr - linked_file_addr);
626                         if (oso_so_addr.IsSectionOffset())
627                             resolved_flags |= oso_dwarf->ResolveSymbolContext (oso_so_addr, resolve_scope, sc);
628                     }
629                 }
630             }
631         }
632     }
633     return resolved_flags;
634 }
635 
636 
637 uint32_t
638 SymbolFileDWARFDebugMap::ResolveSymbolContext (const FileSpec& file_spec, uint32_t line, bool check_inlines, uint32_t resolve_scope, SymbolContextList& sc_list)
639 {
640     uint32_t initial = sc_list.GetSize();
641     const uint32_t cu_count = GetNumCompileUnits();
642 
643     FileSpec so_file_spec;
644     for (uint32_t i=0; i<cu_count; ++i)
645     {
646         if (GetFileSpecForSO (i, so_file_spec))
647         {
648             // By passing false to the comparison we will be able to match
649             // and files given a filename only. If both file_spec and
650             // so_file_spec have directories, we will still do a full match.
651             if (FileSpec::Compare (file_spec, so_file_spec, false) == 0)
652             {
653                 SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex (i);
654 
655                 oso_dwarf->ResolveSymbolContext(file_spec, line, check_inlines, resolve_scope, sc_list);
656             }
657         }
658     }
659     return sc_list.GetSize() - initial;
660 }
661 
662 uint32_t
663 SymbolFileDWARFDebugMap::PrivateFindGlobalVariables
664 (
665     const ConstString &name,
666     const ClangNamespaceDecl *namespace_decl,
667     const std::vector<uint32_t> &indexes,   // Indexes into the symbol table that match "name"
668     uint32_t max_matches,
669     VariableList& variables
670 )
671 {
672     const uint32_t original_size = variables.GetSize();
673     const size_t match_count = indexes.size();
674     for (size_t i=0; i<match_count; ++i)
675     {
676         uint32_t oso_idx;
677         CompileUnitInfo* comp_unit_info = GetCompileUnitInfoForSymbolWithIndex (indexes[i], &oso_idx);
678         if (comp_unit_info)
679         {
680             SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex (oso_idx);
681             if (oso_dwarf)
682             {
683                 if (oso_dwarf->FindGlobalVariables(name, namespace_decl, true, max_matches, variables))
684                     if (variables.GetSize() > max_matches)
685                         break;
686             }
687         }
688     }
689     return variables.GetSize() - original_size;
690 }
691 
692 uint32_t
693 SymbolFileDWARFDebugMap::FindGlobalVariables (const ConstString &name, const ClangNamespaceDecl *namespace_decl, bool append, uint32_t max_matches, VariableList& variables)
694 {
695 
696     // If we aren't appending the results to this list, then clear the list
697     if (!append)
698         variables.Clear();
699 
700     // Remember how many variables are in the list before we search in case
701     // we are appending the results to a variable list.
702     const uint32_t original_size = variables.GetSize();
703 
704     uint32_t total_matches = 0;
705     SymbolFileDWARF *oso_dwarf;
706     for (uint32_t oso_idx = 0; ((oso_dwarf = GetSymbolFileByOSOIndex (oso_idx)) != NULL); ++oso_idx)
707     {
708         const uint32_t oso_matches = oso_dwarf->FindGlobalVariables (name,
709                                                                      namespace_decl,
710                                                                      true,
711                                                                      max_matches,
712                                                                      variables);
713         if (oso_matches > 0)
714         {
715             total_matches += oso_matches;
716 
717             // Are we getting all matches?
718             if (max_matches == UINT32_MAX)
719                 continue;   // Yep, continue getting everything
720 
721             // If we have found enough matches, lets get out
722             if (max_matches >= total_matches)
723                 break;
724 
725             // Update the max matches for any subsequent calls to find globals
726             // in any other object files with DWARF
727             max_matches -= oso_matches;
728         }
729     }
730     // Return the number of variable that were appended to the list
731     return variables.GetSize() - original_size;
732 }
733 
734 
735 uint32_t
736 SymbolFileDWARFDebugMap::FindGlobalVariables (const RegularExpression& regex, bool append, uint32_t max_matches, VariableList& variables)
737 {
738     // If we aren't appending the results to this list, then clear the list
739     if (!append)
740         variables.Clear();
741 
742     // Remember how many variables are in the list before we search in case
743     // we are appending the results to a variable list.
744     const uint32_t original_size = variables.GetSize();
745 
746     uint32_t total_matches = 0;
747     SymbolFileDWARF *oso_dwarf;
748     for (uint32_t oso_idx = 0; ((oso_dwarf = GetSymbolFileByOSOIndex (oso_idx)) != NULL); ++oso_idx)
749     {
750         const uint32_t oso_matches = oso_dwarf->FindGlobalVariables (regex,
751                                                                      true,
752                                                                      max_matches,
753                                                                      variables);
754         if (oso_matches > 0)
755         {
756             total_matches += oso_matches;
757 
758             // Are we getting all matches?
759             if (max_matches == UINT32_MAX)
760                 continue;   // Yep, continue getting everything
761 
762             // If we have found enough matches, lets get out
763             if (max_matches >= total_matches)
764                 break;
765 
766             // Update the max matches for any subsequent calls to find globals
767             // in any other object files with DWARF
768             max_matches -= oso_matches;
769         }
770     }
771     // Return the number of variable that were appended to the list
772     return variables.GetSize() - original_size;
773 }
774 
775 
776 int
777 SymbolFileDWARFDebugMap::SymbolContainsSymbolWithIndex (uint32_t *symbol_idx_ptr, const CompileUnitInfo *comp_unit_info)
778 {
779     const uint32_t symbol_idx = *symbol_idx_ptr;
780 
781     if (symbol_idx < comp_unit_info->first_symbol_index)
782         return -1;
783 
784     if (symbol_idx <= comp_unit_info->last_symbol_index)
785         return 0;
786 
787     return 1;
788 }
789 
790 
791 int
792 SymbolFileDWARFDebugMap::SymbolContainsSymbolWithID (user_id_t *symbol_idx_ptr, const CompileUnitInfo *comp_unit_info)
793 {
794     const user_id_t symbol_id = *symbol_idx_ptr;
795 
796     if (symbol_id < comp_unit_info->so_symbol->GetID())
797         return -1;
798 
799     if (symbol_id <= comp_unit_info->last_symbol->GetID())
800         return 0;
801 
802     return 1;
803 }
804 
805 
806 SymbolFileDWARFDebugMap::CompileUnitInfo*
807 SymbolFileDWARFDebugMap::GetCompileUnitInfoForSymbolWithIndex (uint32_t symbol_idx, uint32_t *oso_idx_ptr)
808 {
809     const uint32_t oso_index_count = m_compile_unit_infos.size();
810     CompileUnitInfo *comp_unit_info = NULL;
811     if (oso_index_count)
812     {
813         comp_unit_info = (CompileUnitInfo*)bsearch(&symbol_idx,
814                                                    &m_compile_unit_infos[0],
815                                                    m_compile_unit_infos.size(),
816                                                    sizeof(CompileUnitInfo),
817                                                    (ComparisonFunction)SymbolContainsSymbolWithIndex);
818     }
819 
820     if (oso_idx_ptr)
821     {
822         if (comp_unit_info != NULL)
823             *oso_idx_ptr = comp_unit_info - &m_compile_unit_infos[0];
824         else
825             *oso_idx_ptr = UINT32_MAX;
826     }
827     return comp_unit_info;
828 }
829 
830 SymbolFileDWARFDebugMap::CompileUnitInfo*
831 SymbolFileDWARFDebugMap::GetCompileUnitInfoForSymbolWithID (user_id_t symbol_id, uint32_t *oso_idx_ptr)
832 {
833     const uint32_t oso_index_count = m_compile_unit_infos.size();
834     CompileUnitInfo *comp_unit_info = NULL;
835     if (oso_index_count)
836     {
837         comp_unit_info = (CompileUnitInfo*)::bsearch (&symbol_id,
838                                                       &m_compile_unit_infos[0],
839                                                       m_compile_unit_infos.size(),
840                                                       sizeof(CompileUnitInfo),
841                                                       (ComparisonFunction)SymbolContainsSymbolWithID);
842     }
843 
844     if (oso_idx_ptr)
845     {
846         if (comp_unit_info != NULL)
847             *oso_idx_ptr = comp_unit_info - &m_compile_unit_infos[0];
848         else
849             *oso_idx_ptr = UINT32_MAX;
850     }
851     return comp_unit_info;
852 }
853 
854 
855 static void
856 RemoveFunctionsWithModuleNotEqualTo (Module *module, SymbolContextList &sc_list, uint32_t start_idx)
857 {
858     // We found functions in .o files. Not all functions in the .o files
859     // will have made it into the final output file. The ones that did
860     // make it into the final output file will have a section whose module
861     // matches the module from the ObjectFile for this SymbolFile. When
862     // the modules don't match, then we have something that was in a
863     // .o file, but doesn't map to anything in the final executable.
864     uint32_t i=start_idx;
865     while (i < sc_list.GetSize())
866     {
867         SymbolContext sc;
868         sc_list.GetContextAtIndex(i, sc);
869         if (sc.function)
870         {
871             const Section *section = sc.function->GetAddressRange().GetBaseAddress().GetSection();
872             if (section->GetModule() != module)
873             {
874                 sc_list.RemoveContextAtIndex(i);
875                 continue;
876             }
877         }
878         ++i;
879     }
880 }
881 
882 uint32_t
883 SymbolFileDWARFDebugMap::FindFunctions(const ConstString &name, const ClangNamespaceDecl *namespace_decl, uint32_t name_type_mask, bool append, SymbolContextList& sc_list)
884 {
885     Timer scoped_timer (__PRETTY_FUNCTION__,
886                         "SymbolFileDWARFDebugMap::FindFunctions (name = %s)",
887                         name.GetCString());
888 
889     uint32_t initial_size = 0;
890     if (append)
891         initial_size = sc_list.GetSize();
892     else
893         sc_list.Clear();
894 
895     uint32_t oso_idx = 0;
896     SymbolFileDWARF *oso_dwarf;
897     while ((oso_dwarf = GetSymbolFileByOSOIndex (oso_idx++)) != NULL)
898     {
899         uint32_t sc_idx = sc_list.GetSize();
900         if (oso_dwarf->FindFunctions(name, namespace_decl, name_type_mask, true, sc_list))
901         {
902             RemoveFunctionsWithModuleNotEqualTo (m_obj_file->GetModule(), sc_list, sc_idx);
903         }
904     }
905 
906     return sc_list.GetSize() - initial_size;
907 }
908 
909 
910 uint32_t
911 SymbolFileDWARFDebugMap::FindFunctions (const RegularExpression& regex, bool append, SymbolContextList& sc_list)
912 {
913     Timer scoped_timer (__PRETTY_FUNCTION__,
914                         "SymbolFileDWARFDebugMap::FindFunctions (regex = '%s')",
915                         regex.GetText());
916 
917     uint32_t initial_size = 0;
918     if (append)
919         initial_size = sc_list.GetSize();
920     else
921         sc_list.Clear();
922 
923     uint32_t oso_idx = 0;
924     SymbolFileDWARF *oso_dwarf;
925     while ((oso_dwarf = GetSymbolFileByOSOIndex (oso_idx++)) != NULL)
926     {
927         uint32_t sc_idx = sc_list.GetSize();
928 
929         if (oso_dwarf->FindFunctions(regex, true, sc_list))
930         {
931             RemoveFunctionsWithModuleNotEqualTo (m_obj_file->GetModule(), sc_list, sc_idx);
932         }
933     }
934 
935     return sc_list.GetSize() - initial_size;
936 }
937 
938 TypeSP
939 SymbolFileDWARFDebugMap::FindDefinitionTypeForDIE (
940     DWARFCompileUnit* cu,
941     const DWARFDebugInfoEntry *die,
942     const ConstString &type_name
943 )
944 {
945     TypeSP type_sp;
946     SymbolFileDWARF *oso_dwarf;
947     for (uint32_t oso_idx = 0; ((oso_dwarf = GetSymbolFileByOSOIndex (oso_idx)) != NULL); ++oso_idx)
948     {
949         type_sp = oso_dwarf->FindDefinitionTypeForDIE (cu, die, type_name);
950         if (type_sp)
951             break;
952     }
953     return type_sp;
954 }
955 
956 uint32_t
957 SymbolFileDWARFDebugMap::FindTypes
958 (
959     const SymbolContext& sc,
960     const ConstString &name,
961     const ClangNamespaceDecl *namespace_decl,
962     bool append,
963     uint32_t max_matches,
964     TypeList& types
965 )
966 {
967     if (!append)
968         types.Clear();
969 
970     const uint32_t initial_types_size = types.GetSize();
971     SymbolFileDWARF *oso_dwarf;
972 
973     if (sc.comp_unit)
974     {
975         oso_dwarf = GetSymbolFile (sc);
976         if (oso_dwarf)
977             return oso_dwarf->FindTypes (sc, name, namespace_decl, append, max_matches, types);
978     }
979     else
980     {
981         uint32_t oso_idx = 0;
982         while ((oso_dwarf = GetSymbolFileByOSOIndex (oso_idx++)) != NULL)
983             oso_dwarf->FindTypes (sc, name, namespace_decl, append, max_matches, types);
984     }
985 
986     return types.GetSize() - initial_types_size;
987 }
988 
989 //
990 //uint32_t
991 //SymbolFileDWARFDebugMap::FindTypes (const SymbolContext& sc, const RegularExpression& regex, bool append, uint32_t max_matches, Type::Encoding encoding, lldb::user_id_t udt_uid, TypeList& types)
992 //{
993 //  SymbolFileDWARF *oso_dwarf = GetSymbolFile (sc);
994 //  if (oso_dwarf)
995 //      return oso_dwarf->FindTypes (sc, regex, append, max_matches, encoding, udt_uid, types);
996 //  return 0;
997 //}
998 
999 
1000 ClangNamespaceDecl
1001 SymbolFileDWARFDebugMap::FindNamespace (const lldb_private::SymbolContext& sc,
1002                                         const lldb_private::ConstString &name,
1003                                         const ClangNamespaceDecl *parent_namespace_decl)
1004 {
1005     ClangNamespaceDecl matching_namespace;
1006     SymbolFileDWARF *oso_dwarf;
1007 
1008     if (sc.comp_unit)
1009     {
1010         oso_dwarf = GetSymbolFile (sc);
1011         if (oso_dwarf)
1012             matching_namespace = oso_dwarf->FindNamespace (sc, name, parent_namespace_decl);
1013     }
1014     else
1015     {
1016         for (uint32_t oso_idx = 0;
1017              ((oso_dwarf = GetSymbolFileByOSOIndex (oso_idx)) != NULL);
1018              ++oso_idx)
1019         {
1020             matching_namespace = oso_dwarf->FindNamespace (sc, name, parent_namespace_decl);
1021 
1022             if (matching_namespace)
1023                 break;
1024         }
1025     }
1026 
1027     return matching_namespace;
1028 }
1029 
1030 //------------------------------------------------------------------
1031 // PluginInterface protocol
1032 //------------------------------------------------------------------
1033 const char *
1034 SymbolFileDWARFDebugMap::GetPluginName()
1035 {
1036     return "SymbolFileDWARFDebugMap";
1037 }
1038 
1039 const char *
1040 SymbolFileDWARFDebugMap::GetShortPluginName()
1041 {
1042     return GetPluginNameStatic();
1043 }
1044 
1045 uint32_t
1046 SymbolFileDWARFDebugMap::GetPluginVersion()
1047 {
1048     return 1;
1049 }
1050 
1051 void
1052 SymbolFileDWARFDebugMap::SetCompileUnit (SymbolFileDWARF *oso_dwarf, const CompUnitSP &cu_sp)
1053 {
1054     const uint32_t cu_count = GetNumCompileUnits();
1055     for (uint32_t i=0; i<cu_count; ++i)
1056     {
1057         if (m_compile_unit_infos[i].oso_symbol_vendor &&
1058             m_compile_unit_infos[i].oso_symbol_vendor->GetSymbolFile() == oso_dwarf)
1059         {
1060             if (m_compile_unit_infos[i].oso_compile_unit_sp)
1061             {
1062                 assert (m_compile_unit_infos[i].oso_compile_unit_sp.get() == cu_sp.get());
1063             }
1064             else
1065             {
1066                 m_compile_unit_infos[i].oso_compile_unit_sp = cu_sp;
1067             }
1068         }
1069     }
1070 }
1071 
1072 
1073 void
1074 SymbolFileDWARFDebugMap::CompleteTagDecl (void *baton, clang::TagDecl *decl)
1075 {
1076     SymbolFileDWARFDebugMap *symbol_file_dwarf = (SymbolFileDWARFDebugMap *)baton;
1077     clang_type_t clang_type = symbol_file_dwarf->GetClangASTContext().GetTypeForDecl (decl);
1078     if (clang_type)
1079     {
1080         SymbolFileDWARF *oso_dwarf;
1081 
1082         for (uint32_t oso_idx = 0; ((oso_dwarf = symbol_file_dwarf->GetSymbolFileByOSOIndex (oso_idx)) != NULL); ++oso_idx)
1083         {
1084             if (oso_dwarf->HasForwardDeclForClangType (clang_type))
1085             {
1086                 oso_dwarf->ResolveClangOpaqueTypeDefinition (clang_type);
1087                 return;
1088             }
1089         }
1090     }
1091 }
1092 
1093 void
1094 SymbolFileDWARFDebugMap::CompleteObjCInterfaceDecl (void *baton, clang::ObjCInterfaceDecl *decl)
1095 {
1096     SymbolFileDWARFDebugMap *symbol_file_dwarf = (SymbolFileDWARFDebugMap *)baton;
1097     clang_type_t clang_type = symbol_file_dwarf->GetClangASTContext().GetTypeForDecl (decl);
1098     if (clang_type)
1099     {
1100         SymbolFileDWARF *oso_dwarf;
1101 
1102         for (uint32_t oso_idx = 0; ((oso_dwarf = symbol_file_dwarf->GetSymbolFileByOSOIndex (oso_idx)) != NULL); ++oso_idx)
1103         {
1104             if (oso_dwarf->HasForwardDeclForClangType (clang_type))
1105             {
1106                 oso_dwarf->ResolveClangOpaqueTypeDefinition (clang_type);
1107                 return;
1108             }
1109         }
1110     }
1111 }
1112 
1113 clang::DeclContext*
1114 SymbolFileDWARFDebugMap::GetClangDeclContextContainingTypeUID (lldb::user_id_t type_uid)
1115 {
1116     const uint64_t oso_idx = GetOSOIndexFromUserID (type_uid);
1117     SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex (oso_idx);
1118     if (oso_dwarf)
1119         return oso_dwarf->GetClangDeclContextContainingTypeUID (type_uid);
1120     return NULL;
1121 }
1122 
1123 clang::DeclContext*
1124 SymbolFileDWARFDebugMap::GetClangDeclContextForTypeUID (const lldb_private::SymbolContext &sc, lldb::user_id_t type_uid)
1125 {
1126     const uint64_t oso_idx = GetOSOIndexFromUserID (type_uid);
1127     SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex (oso_idx);
1128     if (oso_dwarf)
1129         return oso_dwarf->GetClangDeclContextForTypeUID (sc, type_uid);
1130     return NULL;
1131 }
1132 
1133 
1134