1 //===- ELFYAML.cpp - ELF YAMLIO implementation ----------------------------===//
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 file defines classes for handling the YAML representation of ELF.
12 //===----------------------------------------------------------------------===//
14 #include "llvm/Object/ELFYAML.h"
15 #include "llvm/Support/Casting.h"
19 ELFYAML::Section::~Section() {}
24 ScalarEnumerationTraits<ELFYAML::ELF_ET>::enumeration(IO &IO,
25 ELFYAML::ELF_ET &Value) {
26 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
36 ScalarEnumerationTraits<ELFYAML::ELF_EM>::enumeration(IO &IO,
37 ELFYAML::ELF_EM &Value) {
38 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
115 ECase(EM_ARC_COMPACT)
135 ECase(EM_ALTERA_NIOS2)
150 ECase(EM_LATTICEMICO32)
156 ECase(EM_CYPRESS_M8C)
171 ECase(EM_MCST_ELBRUS)
185 ECase(EM_CLOUDSHIELD)
188 ECase(EM_ARC_COMPACT2)
197 void ScalarEnumerationTraits<ELFYAML::ELF_ELFCLASS>::enumeration(
198 IO &IO, ELFYAML::ELF_ELFCLASS &Value) {
199 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
200 // Since the semantics of ELFCLASSNONE is "invalid", just don't accept it
207 void ScalarEnumerationTraits<ELFYAML::ELF_ELFDATA>::enumeration(
208 IO &IO, ELFYAML::ELF_ELFDATA &Value) {
209 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
210 // Since the semantics of ELFDATANONE is "invalid", just don't accept it
217 void ScalarEnumerationTraits<ELFYAML::ELF_ELFOSABI>::enumeration(
218 IO &IO, ELFYAML::ELF_ELFOSABI &Value) {
219 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
222 ECase(ELFOSABI_NETBSD)
226 ECase(ELFOSABI_SOLARIS)
229 ECase(ELFOSABI_FREEBSD)
230 ECase(ELFOSABI_TRU64)
231 ECase(ELFOSABI_MODESTO)
232 ECase(ELFOSABI_OPENBSD)
233 ECase(ELFOSABI_OPENVMS)
236 ECase(ELFOSABI_FENIXOS)
237 ECase(ELFOSABI_C6000_ELFABI)
238 ECase(ELFOSABI_C6000_LINUX)
240 ECase(ELFOSABI_STANDALONE)
244 void ScalarBitSetTraits<ELFYAML::ELF_EF>::bitset(IO &IO,
245 ELFYAML::ELF_EF &Value) {
246 const auto *Object = static_cast<ELFYAML::Object *>(IO.getContext());
247 assert(Object && "The IO context is not initialized");
248 #define BCase(X) IO.bitSetCase(Value, #X, ELF::X);
249 #define BCaseMask(X, M) IO.maskedBitSetCase(Value, #X, ELF::X, ELF::M);
250 switch (Object->Header.Machine) {
252 BCase(EF_ARM_SOFT_FLOAT)
253 BCase(EF_ARM_VFP_FLOAT)
254 BCaseMask(EF_ARM_EABI_UNKNOWN, EF_ARM_EABIMASK)
255 BCaseMask(EF_ARM_EABI_VER1, EF_ARM_EABIMASK)
256 BCaseMask(EF_ARM_EABI_VER2, EF_ARM_EABIMASK)
257 BCaseMask(EF_ARM_EABI_VER3, EF_ARM_EABIMASK)
258 BCaseMask(EF_ARM_EABI_VER4, EF_ARM_EABIMASK)
259 BCaseMask(EF_ARM_EABI_VER5, EF_ARM_EABIMASK)
262 BCase(EF_MIPS_NOREORDER)
266 BCase(EF_MIPS_32BITMODE)
267 BCase(EF_MIPS_ABI_O32)
268 BCase(EF_MIPS_MICROMIPS)
269 BCase(EF_MIPS_ARCH_ASE_M16)
270 BCaseMask(EF_MIPS_ARCH_1, EF_MIPS_ARCH)
271 BCaseMask(EF_MIPS_ARCH_2, EF_MIPS_ARCH)
272 BCaseMask(EF_MIPS_ARCH_3, EF_MIPS_ARCH)
273 BCaseMask(EF_MIPS_ARCH_4, EF_MIPS_ARCH)
274 BCaseMask(EF_MIPS_ARCH_5, EF_MIPS_ARCH)
275 BCaseMask(EF_MIPS_ARCH_32, EF_MIPS_ARCH)
276 BCaseMask(EF_MIPS_ARCH_64, EF_MIPS_ARCH)
277 BCaseMask(EF_MIPS_ARCH_32R2, EF_MIPS_ARCH)
278 BCaseMask(EF_MIPS_ARCH_64R2, EF_MIPS_ARCH)
279 BCaseMask(EF_MIPS_ARCH_32R6, EF_MIPS_ARCH)
280 BCaseMask(EF_MIPS_ARCH_64R6, EF_MIPS_ARCH)
282 case ELF::EM_HEXAGON:
283 BCase(EF_HEXAGON_MACH_V2)
284 BCase(EF_HEXAGON_MACH_V3)
285 BCase(EF_HEXAGON_MACH_V4)
286 BCase(EF_HEXAGON_MACH_V5)
287 BCase(EF_HEXAGON_ISA_V2)
288 BCase(EF_HEXAGON_ISA_V3)
289 BCase(EF_HEXAGON_ISA_V4)
290 BCase(EF_HEXAGON_ISA_V5)
293 llvm_unreachable("Unsupported architecture");
299 void ScalarEnumerationTraits<ELFYAML::ELF_SHT>::enumeration(
300 IO &IO, ELFYAML::ELF_SHT &Value) {
301 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
304 // No SHT_SYMTAB. Use the top-level `Symbols` key instead.
305 // FIXME: Issue a diagnostic with this information.
315 ECase(SHT_INIT_ARRAY)
316 ECase(SHT_FINI_ARRAY)
317 ECase(SHT_PREINIT_ARRAY)
319 ECase(SHT_SYMTAB_SHNDX)
321 ECase(SHT_GNU_ATTRIBUTES)
323 ECase(SHT_GNU_verdef)
324 ECase(SHT_GNU_verneed)
325 ECase(SHT_GNU_versym)
329 ECase(SHT_ARM_PREEMPTMAP)
330 ECase(SHT_ARM_ATTRIBUTES)
331 ECase(SHT_ARM_DEBUGOVERLAY)
332 ECase(SHT_ARM_OVERLAYSECTION)
333 ECase(SHT_HEX_ORDERED)
334 ECase(SHT_X86_64_UNWIND)
335 ECase(SHT_MIPS_REGINFO)
336 ECase(SHT_MIPS_OPTIONS)
340 void ScalarBitSetTraits<ELFYAML::ELF_SHF>::bitset(IO &IO,
341 ELFYAML::ELF_SHF &Value) {
342 #define BCase(X) IO.bitSetCase(Value, #X, ELF::X);
350 BCase(SHF_LINK_ORDER)
351 BCase(SHF_OS_NONCONFORMING)
357 void ScalarEnumerationTraits<ELFYAML::ELF_STT>::enumeration(
358 IO &IO, ELFYAML::ELF_STT &Value) {
359 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
371 void ScalarEnumerationTraits<ELFYAML::ELF_STV>::enumeration(
372 IO &IO, ELFYAML::ELF_STV &Value) {
373 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
381 void ScalarEnumerationTraits<ELFYAML::ELF_REL>::enumeration(
382 IO &IO, ELFYAML::ELF_REL &Value) {
383 const auto *Object = static_cast<ELFYAML::Object *>(IO.getContext());
384 assert(Object && "The IO context is not initialized");
385 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
386 switch (Object->Header.Machine) {
391 ECase(R_X86_64_GOT32)
392 ECase(R_X86_64_PLT32)
394 ECase(R_X86_64_GLOB_DAT)
395 ECase(R_X86_64_JUMP_SLOT)
396 ECase(R_X86_64_RELATIVE)
397 ECase(R_X86_64_GOTPCREL)
404 ECase(R_X86_64_DTPMOD64)
405 ECase(R_X86_64_DTPOFF64)
406 ECase(R_X86_64_TPOFF64)
407 ECase(R_X86_64_TLSGD)
408 ECase(R_X86_64_TLSLD)
409 ECase(R_X86_64_DTPOFF32)
410 ECase(R_X86_64_GOTTPOFF)
411 ECase(R_X86_64_TPOFF32)
413 ECase(R_X86_64_GOTOFF64)
414 ECase(R_X86_64_GOTPC32)
415 ECase(R_X86_64_GOT64)
416 ECase(R_X86_64_GOTPCREL64)
417 ECase(R_X86_64_GOTPC64)
418 ECase(R_X86_64_GOTPLT64)
419 ECase(R_X86_64_PLTOFF64)
420 ECase(R_X86_64_SIZE32)
421 ECase(R_X86_64_SIZE64)
422 ECase(R_X86_64_GOTPC32_TLSDESC)
423 ECase(R_X86_64_TLSDESC_CALL)
424 ECase(R_X86_64_TLSDESC)
425 ECase(R_X86_64_IRELATIVE)
435 ECase(R_MIPS_GPREL16)
436 ECase(R_MIPS_LITERAL)
440 ECase(R_MIPS_GPREL32)
441 ECase(R_MIPS_UNUSED1)
442 ECase(R_MIPS_UNUSED2)
446 ECase(R_MIPS_GOT_DISP)
447 ECase(R_MIPS_GOT_PAGE)
448 ECase(R_MIPS_GOT_OFST)
449 ECase(R_MIPS_GOT_HI16)
450 ECase(R_MIPS_GOT_LO16)
452 ECase(R_MIPS_INSERT_A)
453 ECase(R_MIPS_INSERT_B)
456 ECase(R_MIPS_HIGHEST)
457 ECase(R_MIPS_CALL_HI16)
458 ECase(R_MIPS_CALL_LO16)
459 ECase(R_MIPS_SCN_DISP)
461 ECase(R_MIPS_ADD_IMMEDIATE)
465 ECase(R_MIPS_TLS_DTPMOD32)
466 ECase(R_MIPS_TLS_DTPREL32)
467 ECase(R_MIPS_TLS_DTPMOD64)
468 ECase(R_MIPS_TLS_DTPREL64)
470 ECase(R_MIPS_TLS_LDM)
471 ECase(R_MIPS_TLS_DTPREL_HI16)
472 ECase(R_MIPS_TLS_DTPREL_LO16)
473 ECase(R_MIPS_TLS_GOTTPREL)
474 ECase(R_MIPS_TLS_TPREL32)
475 ECase(R_MIPS_TLS_TPREL64)
476 ECase(R_MIPS_TLS_TPREL_HI16)
477 ECase(R_MIPS_TLS_TPREL_LO16)
478 ECase(R_MIPS_GLOB_DAT)
479 ECase(R_MIPS_PC21_S2)
480 ECase(R_MIPS_PC26_S2)
481 ECase(R_MIPS_PC18_S3)
482 ECase(R_MIPS_PC19_S2)
485 ECase(R_MIPS16_GOT16)
489 ECase(R_MIPS_JUMP_SLOT)
490 ECase(R_MICROMIPS_26_S1)
491 ECase(R_MICROMIPS_HI16)
492 ECase(R_MICROMIPS_LO16)
493 ECase(R_MICROMIPS_GOT16)
494 ECase(R_MICROMIPS_PC16_S1)
495 ECase(R_MICROMIPS_CALL16)
496 ECase(R_MICROMIPS_GOT_DISP)
497 ECase(R_MICROMIPS_GOT_PAGE)
498 ECase(R_MICROMIPS_GOT_OFST)
499 ECase(R_MICROMIPS_TLS_GD)
500 ECase(R_MICROMIPS_TLS_LDM)
501 ECase(R_MICROMIPS_TLS_DTPREL_HI16)
502 ECase(R_MICROMIPS_TLS_DTPREL_LO16)
503 ECase(R_MICROMIPS_TLS_TPREL_HI16)
504 ECase(R_MICROMIPS_TLS_TPREL_LO16)
508 case ELF::EM_HEXAGON:
510 ECase(R_HEX_B22_PCREL)
511 ECase(R_HEX_B15_PCREL)
512 ECase(R_HEX_B7_PCREL)
518 ECase(R_HEX_GPREL16_0)
519 ECase(R_HEX_GPREL16_1)
520 ECase(R_HEX_GPREL16_2)
521 ECase(R_HEX_GPREL16_3)
523 ECase(R_HEX_B13_PCREL)
524 ECase(R_HEX_B9_PCREL)
525 ECase(R_HEX_B32_PCREL_X)
527 ECase(R_HEX_B22_PCREL_X)
528 ECase(R_HEX_B15_PCREL_X)
529 ECase(R_HEX_B13_PCREL_X)
530 ECase(R_HEX_B9_PCREL_X)
531 ECase(R_HEX_B7_PCREL_X)
540 ECase(R_HEX_32_PCREL)
542 ECase(R_HEX_GLOB_DAT)
543 ECase(R_HEX_JMP_SLOT)
544 ECase(R_HEX_RELATIVE)
545 ECase(R_HEX_PLT_B22_PCREL)
546 ECase(R_HEX_GOTREL_LO16)
547 ECase(R_HEX_GOTREL_HI16)
548 ECase(R_HEX_GOTREL_32)
549 ECase(R_HEX_GOT_LO16)
550 ECase(R_HEX_GOT_HI16)
553 ECase(R_HEX_DTPMOD_32)
554 ECase(R_HEX_DTPREL_LO16)
555 ECase(R_HEX_DTPREL_HI16)
556 ECase(R_HEX_DTPREL_32)
557 ECase(R_HEX_DTPREL_16)
558 ECase(R_HEX_GD_PLT_B22_PCREL)
559 ECase(R_HEX_GD_GOT_LO16)
560 ECase(R_HEX_GD_GOT_HI16)
561 ECase(R_HEX_GD_GOT_32)
562 ECase(R_HEX_GD_GOT_16)
566 ECase(R_HEX_IE_GOT_LO16)
567 ECase(R_HEX_IE_GOT_HI16)
568 ECase(R_HEX_IE_GOT_32)
569 ECase(R_HEX_IE_GOT_16)
570 ECase(R_HEX_TPREL_LO16)
571 ECase(R_HEX_TPREL_HI16)
572 ECase(R_HEX_TPREL_32)
573 ECase(R_HEX_TPREL_16)
574 ECase(R_HEX_6_PCREL_X)
575 ECase(R_HEX_GOTREL_32_6_X)
576 ECase(R_HEX_GOTREL_16_X)
577 ECase(R_HEX_GOTREL_11_X)
578 ECase(R_HEX_GOT_32_6_X)
579 ECase(R_HEX_GOT_16_X)
580 ECase(R_HEX_GOT_11_X)
581 ECase(R_HEX_DTPREL_32_6_X)
582 ECase(R_HEX_DTPREL_16_X)
583 ECase(R_HEX_DTPREL_11_X)
584 ECase(R_HEX_GD_GOT_32_6_X)
585 ECase(R_HEX_GD_GOT_16_X)
586 ECase(R_HEX_GD_GOT_11_X)
587 ECase(R_HEX_IE_32_6_X)
589 ECase(R_HEX_IE_GOT_32_6_X)
590 ECase(R_HEX_IE_GOT_16_X)
591 ECase(R_HEX_IE_GOT_11_X)
592 ECase(R_HEX_TPREL_32_6_X)
593 ECase(R_HEX_TPREL_16_X)
594 ECase(R_HEX_TPREL_11_X)
603 ECase(R_386_GLOB_DAT)
604 ECase(R_386_JUMP_SLOT)
605 ECase(R_386_RELATIVE)
609 ECase(R_386_TLS_TPOFF)
611 ECase(R_386_TLS_GOTIE)
619 ECase(R_386_TLS_GD_32)
620 ECase(R_386_TLS_GD_PUSH)
621 ECase(R_386_TLS_GD_CALL)
622 ECase(R_386_TLS_GD_POP)
623 ECase(R_386_TLS_LDM_32)
624 ECase(R_386_TLS_LDM_PUSH)
625 ECase(R_386_TLS_LDM_CALL)
626 ECase(R_386_TLS_LDM_POP)
627 ECase(R_386_TLS_LDO_32)
628 ECase(R_386_TLS_IE_32)
629 ECase(R_386_TLS_LE_32)
630 ECase(R_386_TLS_DTPMOD32)
631 ECase(R_386_TLS_DTPOFF32)
632 ECase(R_386_TLS_TPOFF32)
633 ECase(R_386_TLS_GOTDESC)
634 ECase(R_386_TLS_DESC_CALL)
635 ECase(R_386_TLS_DESC)
636 ECase(R_386_IRELATIVE)
640 llvm_unreachable("Unsupported architecture");
645 void MappingTraits<ELFYAML::FileHeader>::mapping(IO &IO,
646 ELFYAML::FileHeader &FileHdr) {
647 IO.mapRequired("Class", FileHdr.Class);
648 IO.mapRequired("Data", FileHdr.Data);
649 IO.mapOptional("OSABI", FileHdr.OSABI, ELFYAML::ELF_ELFOSABI(0));
650 IO.mapRequired("Type", FileHdr.Type);
651 IO.mapRequired("Machine", FileHdr.Machine);
652 IO.mapOptional("Flags", FileHdr.Flags, ELFYAML::ELF_EF(0));
653 IO.mapOptional("Entry", FileHdr.Entry, Hex64(0));
656 void MappingTraits<ELFYAML::Symbol>::mapping(IO &IO, ELFYAML::Symbol &Symbol) {
657 IO.mapOptional("Name", Symbol.Name, StringRef());
658 IO.mapOptional("Type", Symbol.Type, ELFYAML::ELF_STT(0));
659 IO.mapOptional("Section", Symbol.Section, StringRef());
660 IO.mapOptional("Value", Symbol.Value, Hex64(0));
661 IO.mapOptional("Size", Symbol.Size, Hex64(0));
662 IO.mapOptional("Visibility", Symbol.Visibility, ELFYAML::ELF_STV(0));
665 void MappingTraits<ELFYAML::LocalGlobalWeakSymbols>::mapping(
666 IO &IO, ELFYAML::LocalGlobalWeakSymbols &Symbols) {
667 IO.mapOptional("Local", Symbols.Local);
668 IO.mapOptional("Global", Symbols.Global);
669 IO.mapOptional("Weak", Symbols.Weak);
672 static void commonSectionMapping(IO &IO, ELFYAML::Section &Section) {
673 IO.mapOptional("Name", Section.Name, StringRef());
674 IO.mapRequired("Type", Section.Type);
675 IO.mapOptional("Flags", Section.Flags, ELFYAML::ELF_SHF(0));
676 IO.mapOptional("Address", Section.Address, Hex64(0));
677 IO.mapOptional("Link", Section.Link, StringRef());
678 IO.mapOptional("AddressAlign", Section.AddressAlign, Hex64(0));
681 static void sectionMapping(IO &IO, ELFYAML::RawContentSection &Section) {
682 commonSectionMapping(IO, Section);
683 IO.mapOptional("Content", Section.Content);
684 IO.mapOptional("Size", Section.Size, Hex64(Section.Content.binary_size()));
687 static void sectionMapping(IO &IO, ELFYAML::RelocationSection &Section) {
688 commonSectionMapping(IO, Section);
689 IO.mapOptional("Info", Section.Info, StringRef());
690 IO.mapOptional("Relocations", Section.Relocations);
693 void MappingTraits<std::unique_ptr<ELFYAML::Section>>::mapping(
694 IO &IO, std::unique_ptr<ELFYAML::Section> &Section) {
695 ELFYAML::ELF_SHT sectionType;
697 sectionType = Section->Type;
699 IO.mapRequired("Type", sectionType);
701 switch (sectionType) {
704 if (!IO.outputting())
705 Section.reset(new ELFYAML::RelocationSection());
706 sectionMapping(IO, *cast<ELFYAML::RelocationSection>(Section.get()));
709 if (!IO.outputting())
710 Section.reset(new ELFYAML::RawContentSection());
711 sectionMapping(IO, *cast<ELFYAML::RawContentSection>(Section.get()));
715 StringRef MappingTraits<std::unique_ptr<ELFYAML::Section>>::validate(
716 IO &io, std::unique_ptr<ELFYAML::Section> &Section) {
717 const auto *RawSection = dyn_cast<ELFYAML::RawContentSection>(Section.get());
718 if (!RawSection || RawSection->Size >= RawSection->Content.binary_size())
720 return "Section size must be greater or equal to the content size";
723 void MappingTraits<ELFYAML::Relocation>::mapping(IO &IO,
724 ELFYAML::Relocation &Rel) {
725 IO.mapRequired("Offset", Rel.Offset);
726 IO.mapRequired("Symbol", Rel.Symbol);
727 IO.mapRequired("Type", Rel.Type);
728 IO.mapOptional("Addend", Rel.Addend);
731 void MappingTraits<ELFYAML::Object>::mapping(IO &IO, ELFYAML::Object &Object) {
732 assert(!IO.getContext() && "The IO context is initialized already");
733 IO.setContext(&Object);
734 IO.mapRequired("FileHeader", Object.Header);
735 IO.mapOptional("Sections", Object.Sections);
736 IO.mapOptional("Symbols", Object.Symbols);
737 IO.setContext(nullptr);
740 } // end namespace yaml
741 } // end namespace llvm