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);
33 IO.enumFallback<Hex16>(Value);
37 ScalarEnumerationTraits<ELFYAML::ELF_EM>::enumeration(IO &IO,
38 ELFYAML::ELF_EM &Value) {
39 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
116 ECase(EM_ARC_COMPACT)
136 ECase(EM_ALTERA_NIOS2)
151 ECase(EM_LATTICEMICO32)
157 ECase(EM_CYPRESS_M8C)
172 ECase(EM_MCST_ELBRUS)
186 ECase(EM_CLOUDSHIELD)
189 ECase(EM_ARC_COMPACT2)
198 void ScalarEnumerationTraits<ELFYAML::ELF_ELFCLASS>::enumeration(
199 IO &IO, ELFYAML::ELF_ELFCLASS &Value) {
200 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
201 // Since the semantics of ELFCLASSNONE is "invalid", just don't accept it
208 void ScalarEnumerationTraits<ELFYAML::ELF_ELFDATA>::enumeration(
209 IO &IO, ELFYAML::ELF_ELFDATA &Value) {
210 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
211 // Since the semantics of ELFDATANONE is "invalid", just don't accept it
218 void ScalarEnumerationTraits<ELFYAML::ELF_ELFOSABI>::enumeration(
219 IO &IO, ELFYAML::ELF_ELFOSABI &Value) {
220 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
223 ECase(ELFOSABI_NETBSD)
227 ECase(ELFOSABI_SOLARIS)
230 ECase(ELFOSABI_FREEBSD)
231 ECase(ELFOSABI_TRU64)
232 ECase(ELFOSABI_MODESTO)
233 ECase(ELFOSABI_OPENBSD)
234 ECase(ELFOSABI_OPENVMS)
237 ECase(ELFOSABI_FENIXOS)
238 ECase(ELFOSABI_CLOUDABI)
239 ECase(ELFOSABI_C6000_ELFABI)
240 ECase(ELFOSABI_C6000_LINUX)
242 ECase(ELFOSABI_STANDALONE)
246 void ScalarBitSetTraits<ELFYAML::ELF_EF>::bitset(IO &IO,
247 ELFYAML::ELF_EF &Value) {
248 const auto *Object = static_cast<ELFYAML::Object *>(IO.getContext());
249 assert(Object && "The IO context is not initialized");
250 #define BCase(X) IO.bitSetCase(Value, #X, ELF::X);
251 #define BCaseMask(X, M) IO.maskedBitSetCase(Value, #X, ELF::X, ELF::M);
252 switch (Object->Header.Machine) {
254 BCase(EF_ARM_SOFT_FLOAT)
255 BCase(EF_ARM_VFP_FLOAT)
256 BCaseMask(EF_ARM_EABI_UNKNOWN, EF_ARM_EABIMASK)
257 BCaseMask(EF_ARM_EABI_VER1, EF_ARM_EABIMASK)
258 BCaseMask(EF_ARM_EABI_VER2, EF_ARM_EABIMASK)
259 BCaseMask(EF_ARM_EABI_VER3, EF_ARM_EABIMASK)
260 BCaseMask(EF_ARM_EABI_VER4, EF_ARM_EABIMASK)
261 BCaseMask(EF_ARM_EABI_VER5, EF_ARM_EABIMASK)
264 BCase(EF_MIPS_NOREORDER)
268 BCase(EF_MIPS_32BITMODE)
270 BCase(EF_MIPS_NAN2008)
271 BCase(EF_MIPS_MICROMIPS)
272 BCase(EF_MIPS_ARCH_ASE_M16)
273 BCase(EF_MIPS_ARCH_ASE_MDMX)
274 BCaseMask(EF_MIPS_ABI_O32, EF_MIPS_ABI)
275 BCaseMask(EF_MIPS_ABI_O64, EF_MIPS_ABI)
276 BCaseMask(EF_MIPS_ABI_EABI32, EF_MIPS_ABI)
277 BCaseMask(EF_MIPS_ABI_EABI64, EF_MIPS_ABI)
278 BCaseMask(EF_MIPS_ARCH_1, EF_MIPS_ARCH)
279 BCaseMask(EF_MIPS_ARCH_2, EF_MIPS_ARCH)
280 BCaseMask(EF_MIPS_ARCH_3, EF_MIPS_ARCH)
281 BCaseMask(EF_MIPS_ARCH_4, EF_MIPS_ARCH)
282 BCaseMask(EF_MIPS_ARCH_5, EF_MIPS_ARCH)
283 BCaseMask(EF_MIPS_ARCH_32, EF_MIPS_ARCH)
284 BCaseMask(EF_MIPS_ARCH_64, EF_MIPS_ARCH)
285 BCaseMask(EF_MIPS_ARCH_32R2, EF_MIPS_ARCH)
286 BCaseMask(EF_MIPS_ARCH_64R2, EF_MIPS_ARCH)
287 BCaseMask(EF_MIPS_ARCH_32R6, EF_MIPS_ARCH)
288 BCaseMask(EF_MIPS_ARCH_64R6, EF_MIPS_ARCH)
290 case ELF::EM_HEXAGON:
291 BCase(EF_HEXAGON_MACH_V2)
292 BCase(EF_HEXAGON_MACH_V3)
293 BCase(EF_HEXAGON_MACH_V4)
294 BCase(EF_HEXAGON_MACH_V5)
295 BCase(EF_HEXAGON_ISA_V2)
296 BCase(EF_HEXAGON_ISA_V3)
297 BCase(EF_HEXAGON_ISA_V4)
298 BCase(EF_HEXAGON_ISA_V5)
301 llvm_unreachable("Unsupported architecture");
307 void ScalarEnumerationTraits<ELFYAML::ELF_SHT>::enumeration(
308 IO &IO, ELFYAML::ELF_SHT &Value) {
309 const auto *Object = static_cast<ELFYAML::Object *>(IO.getContext());
310 assert(Object && "The IO context is not initialized");
311 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
314 // No SHT_SYMTAB. Use the top-level `Symbols` key instead.
315 // FIXME: Issue a diagnostic with this information.
325 ECase(SHT_INIT_ARRAY)
326 ECase(SHT_FINI_ARRAY)
327 ECase(SHT_PREINIT_ARRAY)
329 ECase(SHT_SYMTAB_SHNDX)
331 ECase(SHT_GNU_ATTRIBUTES)
333 ECase(SHT_GNU_verdef)
334 ECase(SHT_GNU_verneed)
335 ECase(SHT_GNU_versym)
338 switch (Object->Header.Machine) {
341 ECase(SHT_ARM_PREEMPTMAP)
342 ECase(SHT_ARM_ATTRIBUTES)
343 ECase(SHT_ARM_DEBUGOVERLAY)
344 ECase(SHT_ARM_OVERLAYSECTION)
346 case ELF::EM_HEXAGON:
347 ECase(SHT_HEX_ORDERED)
350 ECase(SHT_X86_64_UNWIND)
353 ECase(SHT_MIPS_REGINFO)
354 ECase(SHT_MIPS_OPTIONS)
355 ECase(SHT_MIPS_ABIFLAGS)
364 void ScalarBitSetTraits<ELFYAML::ELF_SHF>::bitset(IO &IO,
365 ELFYAML::ELF_SHF &Value) {
366 #define BCase(X) IO.bitSetCase(Value, #X, ELF::X);
374 BCase(SHF_LINK_ORDER)
375 BCase(SHF_OS_NONCONFORMING)
381 void ScalarEnumerationTraits<ELFYAML::ELF_STT>::enumeration(
382 IO &IO, ELFYAML::ELF_STT &Value) {
383 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
395 void ScalarEnumerationTraits<ELFYAML::ELF_STV>::enumeration(
396 IO &IO, ELFYAML::ELF_STV &Value) {
397 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
405 void ScalarBitSetTraits<ELFYAML::ELF_STO>::bitset(IO &IO,
406 ELFYAML::ELF_STO &Value) {
407 const auto *Object = static_cast<ELFYAML::Object *>(IO.getContext());
408 assert(Object && "The IO context is not initialized");
409 #define BCase(X) IO.bitSetCase(Value, #X, ELF::X);
410 switch (Object->Header.Machine) {
412 BCase(STO_MIPS_OPTIONAL)
415 BCase(STO_MIPS_MICROMIPS)
418 break; // Nothing to do
424 void ScalarEnumerationTraits<ELFYAML::ELF_RSS>::enumeration(
425 IO &IO, ELFYAML::ELF_RSS &Value) {
426 #define ECase(X) IO.enumCase(Value, #X, ELF::X);
434 void ScalarEnumerationTraits<ELFYAML::ELF_REL>::enumeration(
435 IO &IO, ELFYAML::ELF_REL &Value) {
436 const auto *Object = static_cast<ELFYAML::Object *>(IO.getContext());
437 assert(Object && "The IO context is not initialized");
438 #define ELF_RELOC(X, Y) IO.enumCase(Value, #X, ELF::X);
439 switch (Object->Header.Machine) {
441 #include "llvm/Support/ELFRelocs/x86_64.def"
444 #include "llvm/Support/ELFRelocs/Mips.def"
446 case ELF::EM_HEXAGON:
447 #include "llvm/Support/ELFRelocs/Hexagon.def"
450 #include "llvm/Support/ELFRelocs/i386.def"
452 case ELF::EM_AARCH64:
453 #include "llvm/Support/ELFRelocs/AArch64.def"
456 #include "llvm/Support/ELFRelocs/ARM.def"
459 llvm_unreachable("Unsupported architecture");
464 void MappingTraits<ELFYAML::FileHeader>::mapping(IO &IO,
465 ELFYAML::FileHeader &FileHdr) {
466 IO.mapRequired("Class", FileHdr.Class);
467 IO.mapRequired("Data", FileHdr.Data);
468 IO.mapOptional("OSABI", FileHdr.OSABI, ELFYAML::ELF_ELFOSABI(0));
469 IO.mapRequired("Type", FileHdr.Type);
470 IO.mapRequired("Machine", FileHdr.Machine);
471 IO.mapOptional("Flags", FileHdr.Flags, ELFYAML::ELF_EF(0));
472 IO.mapOptional("Entry", FileHdr.Entry, Hex64(0));
476 struct NormalizedOther {
477 NormalizedOther(IO &)
478 : Visibility(ELFYAML::ELF_STV(0)), Other(ELFYAML::ELF_STO(0)) {}
479 NormalizedOther(IO &, uint8_t Original)
480 : Visibility(Original & 0x3), Other(Original & ~0x3) {}
482 uint8_t denormalize(IO &) { return Visibility | Other; }
484 ELFYAML::ELF_STV Visibility;
485 ELFYAML::ELF_STO Other;
489 void MappingTraits<ELFYAML::Symbol>::mapping(IO &IO, ELFYAML::Symbol &Symbol) {
490 IO.mapOptional("Name", Symbol.Name, StringRef());
491 IO.mapOptional("Type", Symbol.Type, ELFYAML::ELF_STT(0));
492 IO.mapOptional("Section", Symbol.Section, StringRef());
493 IO.mapOptional("Value", Symbol.Value, Hex64(0));
494 IO.mapOptional("Size", Symbol.Size, Hex64(0));
496 MappingNormalization<NormalizedOther, uint8_t> Keys(IO, Symbol.Other);
497 IO.mapOptional("Visibility", Keys->Visibility, ELFYAML::ELF_STV(0));
498 IO.mapOptional("Other", Keys->Other, ELFYAML::ELF_STO(0));
501 void MappingTraits<ELFYAML::LocalGlobalWeakSymbols>::mapping(
502 IO &IO, ELFYAML::LocalGlobalWeakSymbols &Symbols) {
503 IO.mapOptional("Local", Symbols.Local);
504 IO.mapOptional("Global", Symbols.Global);
505 IO.mapOptional("Weak", Symbols.Weak);
508 static void commonSectionMapping(IO &IO, ELFYAML::Section &Section) {
509 IO.mapOptional("Name", Section.Name, StringRef());
510 IO.mapRequired("Type", Section.Type);
511 IO.mapOptional("Flags", Section.Flags, ELFYAML::ELF_SHF(0));
512 IO.mapOptional("Address", Section.Address, Hex64(0));
513 IO.mapOptional("Link", Section.Link, StringRef());
514 IO.mapOptional("AddressAlign", Section.AddressAlign, Hex64(0));
515 IO.mapOptional("Info", Section.Info, StringRef());
518 static void sectionMapping(IO &IO, ELFYAML::RawContentSection &Section) {
519 commonSectionMapping(IO, Section);
520 IO.mapOptional("Content", Section.Content);
521 IO.mapOptional("Size", Section.Size, Hex64(Section.Content.binary_size()));
524 static void sectionMapping(IO &IO, ELFYAML::RelocationSection &Section) {
525 commonSectionMapping(IO, Section);
526 IO.mapOptional("Relocations", Section.Relocations);
529 static void groupSectionMapping(IO &IO, ELFYAML::Group &group) {
530 commonSectionMapping(IO, group);
531 IO.mapRequired("Members", group.Members);
534 void MappingTraits<ELFYAML::SectionOrType>::mapping(
535 IO &IO, ELFYAML::SectionOrType §ionOrType) {
536 IO.mapRequired("SectionOrType", sectionOrType.sectionNameOrType);
539 void MappingTraits<std::unique_ptr<ELFYAML::Section>>::mapping(
540 IO &IO, std::unique_ptr<ELFYAML::Section> &Section) {
541 ELFYAML::ELF_SHT sectionType;
543 sectionType = Section->Type;
545 IO.mapRequired("Type", sectionType);
547 switch (sectionType) {
550 if (!IO.outputting())
551 Section.reset(new ELFYAML::RelocationSection());
552 sectionMapping(IO, *cast<ELFYAML::RelocationSection>(Section.get()));
555 if (!IO.outputting())
556 Section.reset(new ELFYAML::Group());
557 groupSectionMapping(IO, *cast<ELFYAML::Group>(Section.get()));
560 if (!IO.outputting())
561 Section.reset(new ELFYAML::RawContentSection());
562 sectionMapping(IO, *cast<ELFYAML::RawContentSection>(Section.get()));
566 StringRef MappingTraits<std::unique_ptr<ELFYAML::Section>>::validate(
567 IO &io, std::unique_ptr<ELFYAML::Section> &Section) {
568 const auto *RawSection = dyn_cast<ELFYAML::RawContentSection>(Section.get());
569 if (!RawSection || RawSection->Size >= RawSection->Content.binary_size())
571 return "Section size must be greater or equal to the content size";
575 struct NormalizedMips64RelType {
576 NormalizedMips64RelType(IO &)
577 : Type(ELFYAML::ELF_REL(ELF::R_MIPS_NONE)),
578 Type2(ELFYAML::ELF_REL(ELF::R_MIPS_NONE)),
579 Type3(ELFYAML::ELF_REL(ELF::R_MIPS_NONE)),
580 SpecSym(ELFYAML::ELF_REL(ELF::RSS_UNDEF)) {}
581 NormalizedMips64RelType(IO &, ELFYAML::ELF_REL Original)
582 : Type(Original & 0xFF), Type2(Original >> 8 & 0xFF),
583 Type3(Original >> 16 & 0xFF), SpecSym(Original >> 24 & 0xFF) {}
585 ELFYAML::ELF_REL denormalize(IO &) {
586 ELFYAML::ELF_REL Res = Type | Type2 << 8 | Type3 << 16 | SpecSym << 24;
590 ELFYAML::ELF_REL Type;
591 ELFYAML::ELF_REL Type2;
592 ELFYAML::ELF_REL Type3;
593 ELFYAML::ELF_RSS SpecSym;
597 void MappingTraits<ELFYAML::Relocation>::mapping(IO &IO,
598 ELFYAML::Relocation &Rel) {
599 const auto *Object = static_cast<ELFYAML::Object *>(IO.getContext());
600 assert(Object && "The IO context is not initialized");
602 IO.mapRequired("Offset", Rel.Offset);
603 IO.mapRequired("Symbol", Rel.Symbol);
605 if (Object->Header.Machine == ELFYAML::ELF_EM(ELF::EM_MIPS) &&
606 Object->Header.Class == ELFYAML::ELF_ELFCLASS(ELF::ELFCLASS64)) {
607 MappingNormalization<NormalizedMips64RelType, ELFYAML::ELF_REL> Key(
609 IO.mapRequired("Type", Key->Type);
610 IO.mapOptional("Type2", Key->Type2, ELFYAML::ELF_REL(ELF::R_MIPS_NONE));
611 IO.mapOptional("Type3", Key->Type3, ELFYAML::ELF_REL(ELF::R_MIPS_NONE));
612 IO.mapOptional("SpecSym", Key->SpecSym, ELFYAML::ELF_RSS(ELF::RSS_UNDEF));
614 IO.mapRequired("Type", Rel.Type);
616 IO.mapOptional("Addend", Rel.Addend, (int64_t)0);
619 void MappingTraits<ELFYAML::Object>::mapping(IO &IO, ELFYAML::Object &Object) {
620 assert(!IO.getContext() && "The IO context is initialized already");
621 IO.setContext(&Object);
622 IO.mapRequired("FileHeader", Object.Header);
623 IO.mapOptional("Sections", Object.Sections);
624 IO.mapOptional("Symbols", Object.Symbols);
625 IO.setContext(nullptr);
628 } // end namespace yaml
629 } // end namespace llvm