1 //===-- llvm/BinaryFormat/Dwarf.cpp - Dwarf Framework ------------*- C++-*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This file contains support for generic dwarf information.
10 //
11 //===----------------------------------------------------------------------===//
12
13 #include "llvm/BinaryFormat/Dwarf.h"
14 #include "llvm/ADT/StringSwitch.h"
15 #include "llvm/ADT/Triple.h"
16 #include "llvm/Support/ErrorHandling.h"
17
18 using namespace llvm;
19 using namespace dwarf;
20
TagString(unsigned Tag)21 StringRef llvm::dwarf::TagString(unsigned Tag) {
22 switch (Tag) {
23 default:
24 return StringRef();
25 #define HANDLE_DW_TAG(ID, NAME, VERSION, VENDOR, KIND) \
26 case DW_TAG_##NAME: \
27 return "DW_TAG_" #NAME;
28 #include "llvm/BinaryFormat/Dwarf.def"
29 }
30 }
31
getTag(StringRef TagString)32 unsigned llvm::dwarf::getTag(StringRef TagString) {
33 return StringSwitch<unsigned>(TagString)
34 #define HANDLE_DW_TAG(ID, NAME, VERSION, VENDOR, KIND) \
35 .Case("DW_TAG_" #NAME, DW_TAG_##NAME)
36 #include "llvm/BinaryFormat/Dwarf.def"
37 .Default(DW_TAG_invalid);
38 }
39
TagVersion(dwarf::Tag Tag)40 unsigned llvm::dwarf::TagVersion(dwarf::Tag Tag) {
41 switch (Tag) {
42 default:
43 return 0;
44 #define HANDLE_DW_TAG(ID, NAME, VERSION, VENDOR, KIND) \
45 case DW_TAG_##NAME: \
46 return VERSION;
47 #include "llvm/BinaryFormat/Dwarf.def"
48 }
49 }
50
TagVendor(dwarf::Tag Tag)51 unsigned llvm::dwarf::TagVendor(dwarf::Tag Tag) {
52 switch (Tag) {
53 default:
54 return 0;
55 #define HANDLE_DW_TAG(ID, NAME, VERSION, VENDOR, KIND) \
56 case DW_TAG_##NAME: \
57 return DWARF_VENDOR_##VENDOR;
58 #include "llvm/BinaryFormat/Dwarf.def"
59 }
60 }
61
ChildrenString(unsigned Children)62 StringRef llvm::dwarf::ChildrenString(unsigned Children) {
63 switch (Children) {
64 case DW_CHILDREN_no:
65 return "DW_CHILDREN_no";
66 case DW_CHILDREN_yes:
67 return "DW_CHILDREN_yes";
68 }
69 return StringRef();
70 }
71
AttributeString(unsigned Attribute)72 StringRef llvm::dwarf::AttributeString(unsigned Attribute) {
73 switch (Attribute) {
74 default:
75 return StringRef();
76 #define HANDLE_DW_AT(ID, NAME, VERSION, VENDOR) \
77 case DW_AT_##NAME: \
78 return "DW_AT_" #NAME;
79 #include "llvm/BinaryFormat/Dwarf.def"
80 }
81 }
82
AttributeVersion(dwarf::Attribute Attribute)83 unsigned llvm::dwarf::AttributeVersion(dwarf::Attribute Attribute) {
84 switch (Attribute) {
85 default:
86 return 0;
87 #define HANDLE_DW_AT(ID, NAME, VERSION, VENDOR) \
88 case DW_AT_##NAME: \
89 return VERSION;
90 #include "llvm/BinaryFormat/Dwarf.def"
91 }
92 }
93
AttributeVendor(dwarf::Attribute Attribute)94 unsigned llvm::dwarf::AttributeVendor(dwarf::Attribute Attribute) {
95 switch (Attribute) {
96 default:
97 return 0;
98 #define HANDLE_DW_AT(ID, NAME, VERSION, VENDOR) \
99 case DW_AT_##NAME: \
100 return DWARF_VENDOR_##VENDOR;
101 #include "llvm/BinaryFormat/Dwarf.def"
102 }
103 }
104
FormEncodingString(unsigned Encoding)105 StringRef llvm::dwarf::FormEncodingString(unsigned Encoding) {
106 switch (Encoding) {
107 default:
108 return StringRef();
109 #define HANDLE_DW_FORM(ID, NAME, VERSION, VENDOR) \
110 case DW_FORM_##NAME: \
111 return "DW_FORM_" #NAME;
112 #include "llvm/BinaryFormat/Dwarf.def"
113 }
114 }
115
FormVersion(dwarf::Form Form)116 unsigned llvm::dwarf::FormVersion(dwarf::Form Form) {
117 switch (Form) {
118 default:
119 return 0;
120 #define HANDLE_DW_FORM(ID, NAME, VERSION, VENDOR) \
121 case DW_FORM_##NAME: \
122 return VERSION;
123 #include "llvm/BinaryFormat/Dwarf.def"
124 }
125 }
126
FormVendor(dwarf::Form Form)127 unsigned llvm::dwarf::FormVendor(dwarf::Form Form) {
128 switch (Form) {
129 default:
130 return 0;
131 #define HANDLE_DW_FORM(ID, NAME, VERSION, VENDOR) \
132 case DW_FORM_##NAME: \
133 return DWARF_VENDOR_##VENDOR;
134 #include "llvm/BinaryFormat/Dwarf.def"
135 }
136 }
137
OperationEncodingString(unsigned Encoding)138 StringRef llvm::dwarf::OperationEncodingString(unsigned Encoding) {
139 switch (Encoding) {
140 default:
141 return StringRef();
142 #define HANDLE_DW_OP(ID, NAME, VERSION, VENDOR) \
143 case DW_OP_##NAME: \
144 return "DW_OP_" #NAME;
145 #include "llvm/BinaryFormat/Dwarf.def"
146 case DW_OP_LLVM_convert:
147 return "DW_OP_LLVM_convert";
148 case DW_OP_LLVM_fragment:
149 return "DW_OP_LLVM_fragment";
150 case DW_OP_LLVM_tag_offset:
151 return "DW_OP_LLVM_tag_offset";
152 case DW_OP_LLVM_entry_value:
153 return "DW_OP_LLVM_entry_value";
154 }
155 }
156
getOperationEncoding(StringRef OperationEncodingString)157 unsigned llvm::dwarf::getOperationEncoding(StringRef OperationEncodingString) {
158 return StringSwitch<unsigned>(OperationEncodingString)
159 #define HANDLE_DW_OP(ID, NAME, VERSION, VENDOR) \
160 .Case("DW_OP_" #NAME, DW_OP_##NAME)
161 #include "llvm/BinaryFormat/Dwarf.def"
162 .Case("DW_OP_LLVM_convert", DW_OP_LLVM_convert)
163 .Case("DW_OP_LLVM_fragment", DW_OP_LLVM_fragment)
164 .Case("DW_OP_LLVM_tag_offset", DW_OP_LLVM_tag_offset)
165 .Case("DW_OP_LLVM_entry_value", DW_OP_LLVM_entry_value)
166 .Default(0);
167 }
168
OperationVersion(dwarf::LocationAtom Op)169 unsigned llvm::dwarf::OperationVersion(dwarf::LocationAtom Op) {
170 switch (Op) {
171 default:
172 return 0;
173 #define HANDLE_DW_OP(ID, NAME, VERSION, VENDOR) \
174 case DW_OP_##NAME: \
175 return VERSION;
176 #include "llvm/BinaryFormat/Dwarf.def"
177 }
178 }
179
OperationVendor(dwarf::LocationAtom Op)180 unsigned llvm::dwarf::OperationVendor(dwarf::LocationAtom Op) {
181 switch (Op) {
182 default:
183 return 0;
184 #define HANDLE_DW_OP(ID, NAME, VERSION, VENDOR) \
185 case DW_OP_##NAME: \
186 return DWARF_VENDOR_##VENDOR;
187 #include "llvm/BinaryFormat/Dwarf.def"
188 }
189 }
190
AttributeEncodingString(unsigned Encoding)191 StringRef llvm::dwarf::AttributeEncodingString(unsigned Encoding) {
192 switch (Encoding) {
193 default:
194 return StringRef();
195 #define HANDLE_DW_ATE(ID, NAME, VERSION, VENDOR) \
196 case DW_ATE_##NAME: \
197 return "DW_ATE_" #NAME;
198 #include "llvm/BinaryFormat/Dwarf.def"
199 }
200 }
201
getAttributeEncoding(StringRef EncodingString)202 unsigned llvm::dwarf::getAttributeEncoding(StringRef EncodingString) {
203 return StringSwitch<unsigned>(EncodingString)
204 #define HANDLE_DW_ATE(ID, NAME, VERSION, VENDOR) \
205 .Case("DW_ATE_" #NAME, DW_ATE_##NAME)
206 #include "llvm/BinaryFormat/Dwarf.def"
207 .Default(0);
208 }
209
AttributeEncodingVersion(dwarf::TypeKind ATE)210 unsigned llvm::dwarf::AttributeEncodingVersion(dwarf::TypeKind ATE) {
211 switch (ATE) {
212 default:
213 return 0;
214 #define HANDLE_DW_ATE(ID, NAME, VERSION, VENDOR) \
215 case DW_ATE_##NAME: \
216 return VERSION;
217 #include "llvm/BinaryFormat/Dwarf.def"
218 }
219 }
220
AttributeEncodingVendor(dwarf::TypeKind ATE)221 unsigned llvm::dwarf::AttributeEncodingVendor(dwarf::TypeKind ATE) {
222 switch (ATE) {
223 default:
224 return 0;
225 #define HANDLE_DW_ATE(ID, NAME, VERSION, VENDOR) \
226 case DW_ATE_##NAME: \
227 return DWARF_VENDOR_##VENDOR;
228 #include "llvm/BinaryFormat/Dwarf.def"
229 }
230 }
231
DecimalSignString(unsigned Sign)232 StringRef llvm::dwarf::DecimalSignString(unsigned Sign) {
233 switch (Sign) {
234 case DW_DS_unsigned:
235 return "DW_DS_unsigned";
236 case DW_DS_leading_overpunch:
237 return "DW_DS_leading_overpunch";
238 case DW_DS_trailing_overpunch:
239 return "DW_DS_trailing_overpunch";
240 case DW_DS_leading_separate:
241 return "DW_DS_leading_separate";
242 case DW_DS_trailing_separate:
243 return "DW_DS_trailing_separate";
244 }
245 return StringRef();
246 }
247
EndianityString(unsigned Endian)248 StringRef llvm::dwarf::EndianityString(unsigned Endian) {
249 switch (Endian) {
250 case DW_END_default:
251 return "DW_END_default";
252 case DW_END_big:
253 return "DW_END_big";
254 case DW_END_little:
255 return "DW_END_little";
256 case DW_END_lo_user:
257 return "DW_END_lo_user";
258 case DW_END_hi_user:
259 return "DW_END_hi_user";
260 }
261 return StringRef();
262 }
263
AccessibilityString(unsigned Access)264 StringRef llvm::dwarf::AccessibilityString(unsigned Access) {
265 switch (Access) {
266 // Accessibility codes
267 case DW_ACCESS_public:
268 return "DW_ACCESS_public";
269 case DW_ACCESS_protected:
270 return "DW_ACCESS_protected";
271 case DW_ACCESS_private:
272 return "DW_ACCESS_private";
273 }
274 return StringRef();
275 }
276
DefaultedMemberString(unsigned DefaultedEncodings)277 StringRef llvm::dwarf::DefaultedMemberString(unsigned DefaultedEncodings) {
278 switch (DefaultedEncodings) {
279 // Defaulted Member Encodings codes
280 case DW_DEFAULTED_no:
281 return "DW_DEFAULTED_no";
282 case DW_DEFAULTED_in_class:
283 return "DW_DEFAULTED_in_class";
284 case DW_DEFAULTED_out_of_class:
285 return "DW_DEFAULTED_out_of_class";
286 }
287 return StringRef();
288 }
289
VisibilityString(unsigned Visibility)290 StringRef llvm::dwarf::VisibilityString(unsigned Visibility) {
291 switch (Visibility) {
292 case DW_VIS_local:
293 return "DW_VIS_local";
294 case DW_VIS_exported:
295 return "DW_VIS_exported";
296 case DW_VIS_qualified:
297 return "DW_VIS_qualified";
298 }
299 return StringRef();
300 }
301
VirtualityString(unsigned Virtuality)302 StringRef llvm::dwarf::VirtualityString(unsigned Virtuality) {
303 switch (Virtuality) {
304 default:
305 return StringRef();
306 #define HANDLE_DW_VIRTUALITY(ID, NAME) \
307 case DW_VIRTUALITY_##NAME: \
308 return "DW_VIRTUALITY_" #NAME;
309 #include "llvm/BinaryFormat/Dwarf.def"
310 }
311 }
312
getVirtuality(StringRef VirtualityString)313 unsigned llvm::dwarf::getVirtuality(StringRef VirtualityString) {
314 return StringSwitch<unsigned>(VirtualityString)
315 #define HANDLE_DW_VIRTUALITY(ID, NAME) \
316 .Case("DW_VIRTUALITY_" #NAME, DW_VIRTUALITY_##NAME)
317 #include "llvm/BinaryFormat/Dwarf.def"
318 .Default(DW_VIRTUALITY_invalid);
319 }
320
LanguageString(unsigned Language)321 StringRef llvm::dwarf::LanguageString(unsigned Language) {
322 switch (Language) {
323 default:
324 return StringRef();
325 #define HANDLE_DW_LANG(ID, NAME, LOWER_BOUND, VERSION, VENDOR) \
326 case DW_LANG_##NAME: \
327 return "DW_LANG_" #NAME;
328 #include "llvm/BinaryFormat/Dwarf.def"
329 }
330 }
331
getLanguage(StringRef LanguageString)332 unsigned llvm::dwarf::getLanguage(StringRef LanguageString) {
333 return StringSwitch<unsigned>(LanguageString)
334 #define HANDLE_DW_LANG(ID, NAME, LOWER_BOUND, VERSION, VENDOR) \
335 .Case("DW_LANG_" #NAME, DW_LANG_##NAME)
336 #include "llvm/BinaryFormat/Dwarf.def"
337 .Default(0);
338 }
339
LanguageVersion(dwarf::SourceLanguage Lang)340 unsigned llvm::dwarf::LanguageVersion(dwarf::SourceLanguage Lang) {
341 switch (Lang) {
342 default:
343 return 0;
344 #define HANDLE_DW_LANG(ID, NAME, LOWER_BOUND, VERSION, VENDOR) \
345 case DW_LANG_##NAME: \
346 return VERSION;
347 #include "llvm/BinaryFormat/Dwarf.def"
348 }
349 }
350
LanguageVendor(dwarf::SourceLanguage Lang)351 unsigned llvm::dwarf::LanguageVendor(dwarf::SourceLanguage Lang) {
352 switch (Lang) {
353 default:
354 return 0;
355 #define HANDLE_DW_LANG(ID, NAME, LOWER_BOUND, VERSION, VENDOR) \
356 case DW_LANG_##NAME: \
357 return DWARF_VENDOR_##VENDOR;
358 #include "llvm/BinaryFormat/Dwarf.def"
359 }
360 }
361
LanguageLowerBound(dwarf::SourceLanguage Lang)362 Optional<unsigned> llvm::dwarf::LanguageLowerBound(dwarf::SourceLanguage Lang) {
363 switch (Lang) {
364 default:
365 return None;
366 #define HANDLE_DW_LANG(ID, NAME, LOWER_BOUND, VERSION, VENDOR) \
367 case DW_LANG_##NAME: \
368 return LOWER_BOUND;
369 #include "llvm/BinaryFormat/Dwarf.def"
370 }
371 }
372
CaseString(unsigned Case)373 StringRef llvm::dwarf::CaseString(unsigned Case) {
374 switch (Case) {
375 case DW_ID_case_sensitive:
376 return "DW_ID_case_sensitive";
377 case DW_ID_up_case:
378 return "DW_ID_up_case";
379 case DW_ID_down_case:
380 return "DW_ID_down_case";
381 case DW_ID_case_insensitive:
382 return "DW_ID_case_insensitive";
383 }
384 return StringRef();
385 }
386
ConventionString(unsigned CC)387 StringRef llvm::dwarf::ConventionString(unsigned CC) {
388 switch (CC) {
389 default:
390 return StringRef();
391 #define HANDLE_DW_CC(ID, NAME) \
392 case DW_CC_##NAME: \
393 return "DW_CC_" #NAME;
394 #include "llvm/BinaryFormat/Dwarf.def"
395 }
396 }
397
getCallingConvention(StringRef CCString)398 unsigned llvm::dwarf::getCallingConvention(StringRef CCString) {
399 return StringSwitch<unsigned>(CCString)
400 #define HANDLE_DW_CC(ID, NAME) .Case("DW_CC_" #NAME, DW_CC_##NAME)
401 #include "llvm/BinaryFormat/Dwarf.def"
402 .Default(0);
403 }
404
InlineCodeString(unsigned Code)405 StringRef llvm::dwarf::InlineCodeString(unsigned Code) {
406 switch (Code) {
407 case DW_INL_not_inlined:
408 return "DW_INL_not_inlined";
409 case DW_INL_inlined:
410 return "DW_INL_inlined";
411 case DW_INL_declared_not_inlined:
412 return "DW_INL_declared_not_inlined";
413 case DW_INL_declared_inlined:
414 return "DW_INL_declared_inlined";
415 }
416 return StringRef();
417 }
418
ArrayOrderString(unsigned Order)419 StringRef llvm::dwarf::ArrayOrderString(unsigned Order) {
420 switch (Order) {
421 case DW_ORD_row_major:
422 return "DW_ORD_row_major";
423 case DW_ORD_col_major:
424 return "DW_ORD_col_major";
425 }
426 return StringRef();
427 }
428
LNStandardString(unsigned Standard)429 StringRef llvm::dwarf::LNStandardString(unsigned Standard) {
430 switch (Standard) {
431 default:
432 return StringRef();
433 #define HANDLE_DW_LNS(ID, NAME) \
434 case DW_LNS_##NAME: \
435 return "DW_LNS_" #NAME;
436 #include "llvm/BinaryFormat/Dwarf.def"
437 }
438 }
439
LNExtendedString(unsigned Encoding)440 StringRef llvm::dwarf::LNExtendedString(unsigned Encoding) {
441 switch (Encoding) {
442 default:
443 return StringRef();
444 #define HANDLE_DW_LNE(ID, NAME) \
445 case DW_LNE_##NAME: \
446 return "DW_LNE_" #NAME;
447 #include "llvm/BinaryFormat/Dwarf.def"
448 }
449 }
450
MacinfoString(unsigned Encoding)451 StringRef llvm::dwarf::MacinfoString(unsigned Encoding) {
452 switch (Encoding) {
453 // Macinfo Type Encodings
454 case DW_MACINFO_define:
455 return "DW_MACINFO_define";
456 case DW_MACINFO_undef:
457 return "DW_MACINFO_undef";
458 case DW_MACINFO_start_file:
459 return "DW_MACINFO_start_file";
460 case DW_MACINFO_end_file:
461 return "DW_MACINFO_end_file";
462 case DW_MACINFO_vendor_ext:
463 return "DW_MACINFO_vendor_ext";
464 case DW_MACINFO_invalid:
465 return "DW_MACINFO_invalid";
466 }
467 return StringRef();
468 }
469
getMacinfo(StringRef MacinfoString)470 unsigned llvm::dwarf::getMacinfo(StringRef MacinfoString) {
471 return StringSwitch<unsigned>(MacinfoString)
472 .Case("DW_MACINFO_define", DW_MACINFO_define)
473 .Case("DW_MACINFO_undef", DW_MACINFO_undef)
474 .Case("DW_MACINFO_start_file", DW_MACINFO_start_file)
475 .Case("DW_MACINFO_end_file", DW_MACINFO_end_file)
476 .Case("DW_MACINFO_vendor_ext", DW_MACINFO_vendor_ext)
477 .Default(DW_MACINFO_invalid);
478 }
479
MacroString(unsigned Encoding)480 StringRef llvm::dwarf::MacroString(unsigned Encoding) {
481 switch (Encoding) {
482 default:
483 return StringRef();
484 #define HANDLE_DW_MACRO(ID, NAME) \
485 case DW_MACRO_##NAME: \
486 return "DW_MACRO_" #NAME;
487 #include "llvm/BinaryFormat/Dwarf.def"
488 }
489 }
490
GnuMacroString(unsigned Encoding)491 StringRef llvm::dwarf::GnuMacroString(unsigned Encoding) {
492 switch (Encoding) {
493 default:
494 return StringRef();
495 #define HANDLE_DW_MACRO_GNU(ID, NAME) \
496 case DW_MACRO_GNU_##NAME: \
497 return "DW_MACRO_GNU_" #NAME;
498 #include "llvm/BinaryFormat/Dwarf.def"
499 }
500 }
501
getMacro(StringRef MacroString)502 unsigned llvm::dwarf::getMacro(StringRef MacroString) {
503 return StringSwitch<unsigned>(MacroString)
504 #define HANDLE_DW_MACRO(ID, NAME) .Case("DW_MACRO_" #NAME, ID)
505 #include "llvm/BinaryFormat/Dwarf.def"
506 .Default(DW_MACINFO_invalid);
507 }
RangeListEncodingString(unsigned Encoding)508 StringRef llvm::dwarf::RangeListEncodingString(unsigned Encoding) {
509 switch (Encoding) {
510 default:
511 return StringRef();
512 #define HANDLE_DW_RLE(ID, NAME) \
513 case DW_RLE_##NAME: \
514 return "DW_RLE_" #NAME;
515 #include "llvm/BinaryFormat/Dwarf.def"
516 }
517 }
518
LocListEncodingString(unsigned Encoding)519 StringRef llvm::dwarf::LocListEncodingString(unsigned Encoding) {
520 switch (Encoding) {
521 default:
522 return StringRef();
523 #define HANDLE_DW_LLE(ID, NAME) \
524 case DW_LLE_##NAME: \
525 return "DW_LLE_" #NAME;
526 #include "llvm/BinaryFormat/Dwarf.def"
527 }
528 }
529
CallFrameString(unsigned Encoding,Triple::ArchType Arch)530 StringRef llvm::dwarf::CallFrameString(unsigned Encoding,
531 Triple::ArchType Arch) {
532 assert(Arch != llvm::Triple::ArchType::UnknownArch);
533 #define SELECT_AARCH64 (Arch == llvm::Triple::aarch64_be || Arch == llvm::Triple::aarch64)
534 #define SELECT_MIPS64 Arch == llvm::Triple::mips64
535 #define SELECT_SPARC (Arch == llvm::Triple::sparc || Arch == llvm::Triple::sparcv9)
536 #define SELECT_X86 (Arch == llvm::Triple::x86 || Arch == llvm::Triple::x86_64)
537 #define HANDLE_DW_CFA(ID, NAME)
538 #define HANDLE_DW_CFA_PRED(ID, NAME, PRED) \
539 if (ID == Encoding && PRED) \
540 return "DW_CFA_" #NAME;
541 #include "llvm/BinaryFormat/Dwarf.def"
542
543 switch (Encoding) {
544 default:
545 return StringRef();
546 #define HANDLE_DW_CFA_PRED(ID, NAME, PRED)
547 #define HANDLE_DW_CFA(ID, NAME) \
548 case DW_CFA_##NAME: \
549 return "DW_CFA_" #NAME;
550 #include "llvm/BinaryFormat/Dwarf.def"
551
552 #undef SELECT_X86
553 #undef SELECT_SPARC
554 #undef SELECT_MIPS64
555 #undef SELECT_AARCH64
556 }
557 }
558
ApplePropertyString(unsigned Prop)559 StringRef llvm::dwarf::ApplePropertyString(unsigned Prop) {
560 switch (Prop) {
561 default:
562 return StringRef();
563 #define HANDLE_DW_APPLE_PROPERTY(ID, NAME) \
564 case DW_APPLE_PROPERTY_##NAME: \
565 return "DW_APPLE_PROPERTY_" #NAME;
566 #include "llvm/BinaryFormat/Dwarf.def"
567 }
568 }
569
UnitTypeString(unsigned UT)570 StringRef llvm::dwarf::UnitTypeString(unsigned UT) {
571 switch (UT) {
572 default:
573 return StringRef();
574 #define HANDLE_DW_UT(ID, NAME) \
575 case DW_UT_##NAME: \
576 return "DW_UT_" #NAME;
577 #include "llvm/BinaryFormat/Dwarf.def"
578 }
579 }
580
AtomTypeString(unsigned AT)581 StringRef llvm::dwarf::AtomTypeString(unsigned AT) {
582 switch (AT) {
583 case dwarf::DW_ATOM_null:
584 return "DW_ATOM_null";
585 case dwarf::DW_ATOM_die_offset:
586 return "DW_ATOM_die_offset";
587 case DW_ATOM_cu_offset:
588 return "DW_ATOM_cu_offset";
589 case DW_ATOM_die_tag:
590 return "DW_ATOM_die_tag";
591 case DW_ATOM_type_flags:
592 case DW_ATOM_type_type_flags:
593 return "DW_ATOM_type_flags";
594 case DW_ATOM_qual_name_hash:
595 return "DW_ATOM_qual_name_hash";
596 }
597 return StringRef();
598 }
599
GDBIndexEntryKindString(GDBIndexEntryKind Kind)600 StringRef llvm::dwarf::GDBIndexEntryKindString(GDBIndexEntryKind Kind) {
601 switch (Kind) {
602 case GIEK_NONE:
603 return "NONE";
604 case GIEK_TYPE:
605 return "TYPE";
606 case GIEK_VARIABLE:
607 return "VARIABLE";
608 case GIEK_FUNCTION:
609 return "FUNCTION";
610 case GIEK_OTHER:
611 return "OTHER";
612 case GIEK_UNUSED5:
613 return "UNUSED5";
614 case GIEK_UNUSED6:
615 return "UNUSED6";
616 case GIEK_UNUSED7:
617 return "UNUSED7";
618 }
619 llvm_unreachable("Unknown GDBIndexEntryKind value");
620 }
621
622 StringRef
GDBIndexEntryLinkageString(GDBIndexEntryLinkage Linkage)623 llvm::dwarf::GDBIndexEntryLinkageString(GDBIndexEntryLinkage Linkage) {
624 switch (Linkage) {
625 case GIEL_EXTERNAL:
626 return "EXTERNAL";
627 case GIEL_STATIC:
628 return "STATIC";
629 }
630 llvm_unreachable("Unknown GDBIndexEntryLinkage value");
631 }
632
AttributeValueString(uint16_t Attr,unsigned Val)633 StringRef llvm::dwarf::AttributeValueString(uint16_t Attr, unsigned Val) {
634 switch (Attr) {
635 case DW_AT_accessibility:
636 return AccessibilityString(Val);
637 case DW_AT_virtuality:
638 return VirtualityString(Val);
639 case DW_AT_language:
640 return LanguageString(Val);
641 case DW_AT_encoding:
642 return AttributeEncodingString(Val);
643 case DW_AT_decimal_sign:
644 return DecimalSignString(Val);
645 case DW_AT_endianity:
646 return EndianityString(Val);
647 case DW_AT_visibility:
648 return VisibilityString(Val);
649 case DW_AT_identifier_case:
650 return CaseString(Val);
651 case DW_AT_calling_convention:
652 return ConventionString(Val);
653 case DW_AT_inline:
654 return InlineCodeString(Val);
655 case DW_AT_ordering:
656 return ArrayOrderString(Val);
657 case DW_AT_APPLE_runtime_class:
658 return LanguageString(Val);
659 case DW_AT_defaulted:
660 return DefaultedMemberString(Val);
661 }
662
663 return StringRef();
664 }
665
AtomValueString(uint16_t Atom,unsigned Val)666 StringRef llvm::dwarf::AtomValueString(uint16_t Atom, unsigned Val) {
667 switch (Atom) {
668 case DW_ATOM_null:
669 return "NULL";
670 case DW_ATOM_die_tag:
671 return TagString(Val);
672 }
673
674 return StringRef();
675 }
676
IndexString(unsigned Idx)677 StringRef llvm::dwarf::IndexString(unsigned Idx) {
678 switch (Idx) {
679 default:
680 return StringRef();
681 #define HANDLE_DW_IDX(ID, NAME) \
682 case DW_IDX_##NAME: \
683 return "DW_IDX_" #NAME;
684 #include "llvm/BinaryFormat/Dwarf.def"
685 }
686 }
687
getFixedFormByteSize(dwarf::Form Form,FormParams Params)688 Optional<uint8_t> llvm::dwarf::getFixedFormByteSize(dwarf::Form Form,
689 FormParams Params) {
690 switch (Form) {
691 case DW_FORM_addr:
692 if (Params)
693 return Params.AddrSize;
694 return None;
695
696 case DW_FORM_block: // ULEB128 length L followed by L bytes.
697 case DW_FORM_block1: // 1 byte length L followed by L bytes.
698 case DW_FORM_block2: // 2 byte length L followed by L bytes.
699 case DW_FORM_block4: // 4 byte length L followed by L bytes.
700 case DW_FORM_string: // C-string with null terminator.
701 case DW_FORM_sdata: // SLEB128.
702 case DW_FORM_udata: // ULEB128.
703 case DW_FORM_ref_udata: // ULEB128.
704 case DW_FORM_indirect: // ULEB128.
705 case DW_FORM_exprloc: // ULEB128 length L followed by L bytes.
706 case DW_FORM_strx: // ULEB128.
707 case DW_FORM_addrx: // ULEB128.
708 case DW_FORM_loclistx: // ULEB128.
709 case DW_FORM_rnglistx: // ULEB128.
710 case DW_FORM_GNU_addr_index: // ULEB128.
711 case DW_FORM_GNU_str_index: // ULEB128.
712 return None;
713
714 case DW_FORM_ref_addr:
715 if (Params)
716 return Params.getRefAddrByteSize();
717 return None;
718
719 case DW_FORM_flag:
720 case DW_FORM_data1:
721 case DW_FORM_ref1:
722 case DW_FORM_strx1:
723 case DW_FORM_addrx1:
724 return 1;
725
726 case DW_FORM_data2:
727 case DW_FORM_ref2:
728 case DW_FORM_strx2:
729 case DW_FORM_addrx2:
730 return 2;
731
732 case DW_FORM_strx3:
733 return 3;
734
735 case DW_FORM_data4:
736 case DW_FORM_ref4:
737 case DW_FORM_ref_sup4:
738 case DW_FORM_strx4:
739 case DW_FORM_addrx4:
740 return 4;
741
742 case DW_FORM_strp:
743 case DW_FORM_GNU_ref_alt:
744 case DW_FORM_GNU_strp_alt:
745 case DW_FORM_line_strp:
746 case DW_FORM_sec_offset:
747 case DW_FORM_strp_sup:
748 if (Params)
749 return Params.getDwarfOffsetByteSize();
750 return None;
751
752 case DW_FORM_data8:
753 case DW_FORM_ref8:
754 case DW_FORM_ref_sig8:
755 case DW_FORM_ref_sup8:
756 return 8;
757
758 case DW_FORM_flag_present:
759 return 0;
760
761 case DW_FORM_data16:
762 return 16;
763
764 case DW_FORM_implicit_const:
765 // The implicit value is stored in the abbreviation as a SLEB128, and
766 // there no data in debug info.
767 return 0;
768
769 default:
770 break;
771 }
772 return None;
773 }
774
isValidFormForVersion(Form F,unsigned Version,bool ExtensionsOk)775 bool llvm::dwarf::isValidFormForVersion(Form F, unsigned Version,
776 bool ExtensionsOk) {
777 if (FormVendor(F) == DWARF_VENDOR_DWARF) {
778 unsigned FV = FormVersion(F);
779 return FV > 0 && FV <= Version;
780 }
781 return ExtensionsOk;
782 }
783
FormatString(DwarfFormat Format)784 StringRef llvm::dwarf::FormatString(DwarfFormat Format) {
785 switch (Format) {
786 case DWARF32:
787 return "DWARF32";
788 case DWARF64:
789 return "DWARF64";
790 }
791 return StringRef();
792 }
793
FormatString(bool IsDWARF64)794 StringRef llvm::dwarf::FormatString(bool IsDWARF64) {
795 return FormatString(IsDWARF64 ? DWARF64 : DWARF32);
796 }
797
RLEString(unsigned RLE)798 StringRef llvm::dwarf::RLEString(unsigned RLE) {
799 switch (RLE) {
800 default:
801 return StringRef();
802 #define HANDLE_DW_RLE(ID, NAME) \
803 case DW_RLE_##NAME: \
804 return "DW_RLE_" #NAME;
805 #include "llvm/BinaryFormat/Dwarf.def"
806 }
807 }
808
809 constexpr char llvm::dwarf::EnumTraits<Attribute>::Type[];
810 constexpr char llvm::dwarf::EnumTraits<Form>::Type[];
811 constexpr char llvm::dwarf::EnumTraits<Index>::Type[];
812 constexpr char llvm::dwarf::EnumTraits<Tag>::Type[];
813 constexpr char llvm::dwarf::EnumTraits<LineNumberOps>::Type[];
814 constexpr char llvm::dwarf::EnumTraits<LocationAtom>::Type[];
815