COFFYAML.h

Go to the documentation of this file.

//===- COFFYAML.h - COFF YAMLIO implementation ------------------*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
//
// This file declares classes for handling the YAML representation of COFF.
//
//===----------------------------------------------------------------------===//
 
#ifndef LLVM_OBJECTYAML_COFFYAML_H
#define LLVM_OBJECTYAML_COFFYAML_H
 
#include "llvm/ADT/StringRef.h"
#include "llvm/BinaryFormat/COFF.h"
#include "llvm/Object/COFF.h"
#include "llvm/ObjectYAML/CodeViewYAMLDebugSections.h"
#include "llvm/ObjectYAML/CodeViewYAMLTypeHashing.h"
#include "llvm/ObjectYAML/CodeViewYAMLTypes.h"
#include "llvm/ObjectYAML/YAML.h"
#include <cstdint>
#include <optional>
#include <vector>
 
namespace llvm {
 
namespace COFF {
 
inline Characteristics operator|(Characteristics a, Characteristics b) {
  uint32_t Ret = static_cast<uint32_t>(a) | static_cast<uint32_t>(b);
  return static_cast<Characteristics>(Ret);
}
 
inline SectionCharacteristics operator|(SectionCharacteristics a,
                                        SectionCharacteristics b) {
  uint32_t Ret = static_cast<uint32_t>(a) | static_cast<uint32_t>(b);
  return static_cast<SectionCharacteristics>(Ret);
}
 
inline DLLCharacteristics operator|(DLLCharacteristics a,
                                    DLLCharacteristics b) {
  uint16_t Ret = static_cast<uint16_t>(a) | static_cast<uint16_t>(b);
  return static_cast<DLLCharacteristics>(Ret);
}
 
} // end namespace COFF
 
// The structure of the yaml files is not an exact 1:1 match to COFF. In order
// to use yaml::IO, we use these structures which are closer to the source.
namespace COFFYAML {
 
LLVM_YAML_STRONG_TYPEDEF(uint8_t, COMDATType)
LLVM_YAML_STRONG_TYPEDEF(uint32_t, WeakExternalCharacteristics)
LLVM_YAML_STRONG_TYPEDEF(uint8_t, AuxSymbolType)
 
struct Relocation {
  uint32_t VirtualAddress;
  uint16_t Type;
 
  // Normally a Relocation can refer to the symbol via its name.
  // It can also use a direct symbol table index instead (with no name
  // specified), allowing disambiguating between multiple symbols with the
  // same name or crafting intentionally broken files for testing.
  StringRef SymbolName;
  std::optional<uint32_t> SymbolTableIndex;
};
 
struct SectionDataEntry {
  std::optional<uint32_t> UInt32;
  yaml::BinaryRef Binary;
  std::optional<object::coff_load_configuration32> LoadConfig32;
  std::optional<object::coff_load_configuration64> LoadConfig64;
 
  LLVM_ABI size_t size() const;
  LLVM_ABI void writeAsBinary(raw_ostream &OS) const;
};
 
struct Section {
  COFF::section Header;
  unsigned Alignment = 0;
  yaml::BinaryRef SectionData;
  std::vector<CodeViewYAML::YAMLDebugSubsection> DebugS;
  std::vector<CodeViewYAML::LeafRecord> DebugT;
  std::vector<CodeViewYAML::LeafRecord> DebugP;
  std::optional<CodeViewYAML::DebugHSection> DebugH;
  std::vector<SectionDataEntry> StructuredData;
  std::vector<Relocation> Relocations;
  StringRef Name;
 
  LLVM_ABI Section();
};
 
struct Symbol {
  COFF::symbol Header;
  COFF::SymbolBaseType SimpleType = COFF::IMAGE_SYM_TYPE_NULL;
  COFF::SymbolComplexType ComplexType = COFF::IMAGE_SYM_DTYPE_NULL;
  std::optional<COFF::AuxiliaryFunctionDefinition> FunctionDefinition;
  std::optional<COFF::AuxiliarybfAndefSymbol> bfAndefSymbol;
  std::optional<COFF::AuxiliaryWeakExternal> WeakExternal;
  StringRef File;
  std::optional<COFF::AuxiliarySectionDefinition> SectionDefinition;
  std::optional<COFF::AuxiliaryCLRToken> CLRToken;
  StringRef Name;
 
  LLVM_ABI Symbol();
};
 
struct PEHeader {
  COFF::PE32Header Header;
  std::optional<COFF::DataDirectory>
      DataDirectories[COFF::NUM_DATA_DIRECTORIES];
};
 
struct Object {
  std::optional<PEHeader> OptionalHeader;
  COFF::header Header;
  std::vector<Section> Sections;
  std::vector<Symbol> Symbols;
 
  LLVM_ABI Object();
};
 
} // end namespace COFFYAML
 
} // end namespace llvm
 
LLVM_YAML_IS_SEQUENCE_VECTOR(COFFYAML::Section)
LLVM_YAML_IS_SEQUENCE_VECTOR(COFFYAML::Symbol)
LLVM_YAML_IS_SEQUENCE_VECTOR(COFFYAML::Relocation)
LLVM_YAML_IS_SEQUENCE_VECTOR(COFFYAML::SectionDataEntry)
 
namespace llvm {
namespace yaml {
 
template <>
struct ScalarEnumerationTraits<COFFYAML::WeakExternalCharacteristics> {
  LLVM_ABI static void
  enumeration(IO &IO, COFFYAML::WeakExternalCharacteristics &Value);
};
 
template <>
struct ScalarEnumerationTraits<COFFYAML::AuxSymbolType> {
  LLVM_ABI static void enumeration(IO &IO, COFFYAML::AuxSymbolType &Value);
};
 
template <>
struct ScalarEnumerationTraits<COFFYAML::COMDATType> {
  LLVM_ABI static void enumeration(IO &IO, COFFYAML::COMDATType &Value);
};
 
template <>
struct ScalarEnumerationTraits<COFF::MachineTypes> {
  LLVM_ABI static void enumeration(IO &IO, COFF::MachineTypes &Value);
};
 
template <>
struct ScalarEnumerationTraits<COFF::SymbolBaseType> {
  LLVM_ABI static void enumeration(IO &IO, COFF::SymbolBaseType &Value);
};
 
template <>
struct ScalarEnumerationTraits<COFF::SymbolStorageClass> {
  LLVM_ABI static void enumeration(IO &IO, COFF::SymbolStorageClass &Value);
};
 
template <>
struct ScalarEnumerationTraits<COFF::SymbolComplexType> {
  LLVM_ABI static void enumeration(IO &IO, COFF::SymbolComplexType &Value);
};
 
template <>
struct ScalarEnumerationTraits<COFF::RelocationTypeI386> {
  LLVM_ABI static void enumeration(IO &IO, COFF::RelocationTypeI386 &Value);
};
 
template <>
struct ScalarEnumerationTraits<COFF::RelocationTypeAMD64> {
  LLVM_ABI static void enumeration(IO &IO, COFF::RelocationTypeAMD64 &Value);
};
 
template <> struct ScalarEnumerationTraits<COFF::RelocationTypesMips> {
  LLVM_ABI static void enumeration(IO &IO, COFF::RelocationTypesMips &Value);
};
 
template <>
struct ScalarEnumerationTraits<COFF::RelocationTypesARM> {
  LLVM_ABI static void enumeration(IO &IO, COFF::RelocationTypesARM &Value);
};
 
template <>
struct ScalarEnumerationTraits<COFF::RelocationTypesARM64> {
  LLVM_ABI static void enumeration(IO &IO, COFF::RelocationTypesARM64 &Value);
};
 
template <>
struct ScalarEnumerationTraits<COFF::WindowsSubsystem> {
  LLVM_ABI static void enumeration(IO &IO, COFF::WindowsSubsystem &Value);
};
 
template <>
struct ScalarBitSetTraits<COFF::Characteristics> {
  LLVM_ABI static void bitset(IO &IO, COFF::Characteristics &Value);
};
 
template <>
struct ScalarBitSetTraits<COFF::SectionCharacteristics> {
  LLVM_ABI static void bitset(IO &IO, COFF::SectionCharacteristics &Value);
};
 
template <>
struct ScalarBitSetTraits<COFF::DLLCharacteristics> {
  LLVM_ABI static void bitset(IO &IO, COFF::DLLCharacteristics &Value);
};
 
template <>
struct MappingTraits<COFFYAML::Relocation> {
  LLVM_ABI static void mapping(IO &IO, COFFYAML::Relocation &Rel);
};
 
template <>
struct MappingTraits<COFFYAML::PEHeader> {
  LLVM_ABI static void mapping(IO &IO, COFFYAML::PEHeader &PH);
};
 
template <>
struct MappingTraits<COFF::DataDirectory> {
  LLVM_ABI static void mapping(IO &IO, COFF::DataDirectory &DD);
};
 
template <>
struct MappingTraits<COFF::header> {
  LLVM_ABI static void mapping(IO &IO, COFF::header &H);
};
 
template <> struct MappingTraits<COFF::AuxiliaryFunctionDefinition> {
  LLVM_ABI static void mapping(IO &IO, COFF::AuxiliaryFunctionDefinition &AFD);
};
 
template <> struct MappingTraits<COFF::AuxiliarybfAndefSymbol> {
  LLVM_ABI static void mapping(IO &IO, COFF::AuxiliarybfAndefSymbol &AAS);
};
 
template <> struct MappingTraits<COFF::AuxiliaryWeakExternal> {
  LLVM_ABI static void mapping(IO &IO, COFF::AuxiliaryWeakExternal &AWE);
};
 
template <> struct MappingTraits<COFF::AuxiliarySectionDefinition> {
  LLVM_ABI static void mapping(IO &IO, COFF::AuxiliarySectionDefinition &ASD);
};
 
template <> struct MappingTraits<COFF::AuxiliaryCLRToken> {
  LLVM_ABI static void mapping(IO &IO, COFF::AuxiliaryCLRToken &ACT);
};
 
template <> struct MappingTraits<object::coff_load_configuration32> {
  LLVM_ABI static void mapping(IO &IO, object::coff_load_configuration32 &ACT);
};
 
template <> struct MappingTraits<object::coff_load_configuration64> {
  LLVM_ABI static void mapping(IO &IO, object::coff_load_configuration64 &ACT);
};
 
template <> struct MappingTraits<object::coff_load_config_code_integrity> {
  LLVM_ABI static void mapping(IO &IO,
                               object::coff_load_config_code_integrity &ACT);
};
 
template <>
struct MappingTraits<COFFYAML::Symbol> {
  LLVM_ABI static void mapping(IO &IO, COFFYAML::Symbol &S);
};
 
template <> struct MappingTraits<COFFYAML::SectionDataEntry> {
  LLVM_ABI static void mapping(IO &IO, COFFYAML::SectionDataEntry &Sec);
};
 
template <>
struct MappingTraits<COFFYAML::Section> {
  LLVM_ABI static void mapping(IO &IO, COFFYAML::Section &Sec);
};
 
template <>
struct MappingTraits<COFFYAML::Object> {
  LLVM_ABI static void mapping(IO &IO, COFFYAML::Object &Obj);
};
 
} // end namespace yaml
} // end namespace llvm
 
#endif // LLVM_OBJECTYAML_COFFYAML_H