XCOFFYAML.h 9.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294
  1. #pragma once
  2. #ifdef __GNUC__
  3. #pragma GCC diagnostic push
  4. #pragma GCC diagnostic ignored "-Wunused-parameter"
  5. #endif
  6. //===----- XCOFFYAML.h - XCOFF YAMLIO implementation ------------*- C++ -*-===//
  7. //
  8. // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
  9. // See https://llvm.org/LICENSE.txt for license information.
  10. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
  11. //
  12. //===----------------------------------------------------------------------===//
  13. //
  14. // This file declares classes for handling the YAML representation of XCOFF.
  15. //
  16. //===----------------------------------------------------------------------===//
  17. #ifndef LLVM_OBJECTYAML_XCOFFYAML_H
  18. #define LLVM_OBJECTYAML_XCOFFYAML_H
  19. #include "llvm/BinaryFormat/XCOFF.h"
  20. #include "llvm/ObjectYAML/YAML.h"
  21. #include <optional>
  22. #include <vector>
  23. namespace llvm {
  24. namespace XCOFFYAML {
  25. struct FileHeader {
  26. llvm::yaml::Hex16 Magic;
  27. uint16_t NumberOfSections;
  28. int32_t TimeStamp;
  29. llvm::yaml::Hex64 SymbolTableOffset;
  30. int32_t NumberOfSymTableEntries;
  31. uint16_t AuxHeaderSize;
  32. llvm::yaml::Hex16 Flags;
  33. };
  34. struct AuxiliaryHeader {
  35. std::optional<llvm::yaml::Hex16> Magic;
  36. std::optional<llvm::yaml::Hex16> Version;
  37. std::optional<llvm::yaml::Hex64> TextStartAddr;
  38. std::optional<llvm::yaml::Hex64> DataStartAddr;
  39. std::optional<llvm::yaml::Hex64> TOCAnchorAddr;
  40. std::optional<uint16_t> SecNumOfEntryPoint;
  41. std::optional<uint16_t> SecNumOfText;
  42. std::optional<uint16_t> SecNumOfData;
  43. std::optional<uint16_t> SecNumOfTOC;
  44. std::optional<uint16_t> SecNumOfLoader;
  45. std::optional<uint16_t> SecNumOfBSS;
  46. std::optional<llvm::yaml::Hex16> MaxAlignOfText;
  47. std::optional<llvm::yaml::Hex16> MaxAlignOfData;
  48. std::optional<llvm::yaml::Hex16> ModuleType;
  49. std::optional<llvm::yaml::Hex8> CpuFlag;
  50. std::optional<llvm::yaml::Hex8> CpuType;
  51. std::optional<llvm::yaml::Hex8> TextPageSize;
  52. std::optional<llvm::yaml::Hex8> DataPageSize;
  53. std::optional<llvm::yaml::Hex8> StackPageSize;
  54. std::optional<llvm::yaml::Hex8> FlagAndTDataAlignment;
  55. std::optional<llvm::yaml::Hex64> TextSize;
  56. std::optional<llvm::yaml::Hex64> InitDataSize;
  57. std::optional<llvm::yaml::Hex64> BssDataSize;
  58. std::optional<llvm::yaml::Hex64> EntryPointAddr;
  59. std::optional<llvm::yaml::Hex64> MaxStackSize;
  60. std::optional<llvm::yaml::Hex64> MaxDataSize;
  61. std::optional<uint16_t> SecNumOfTData;
  62. std::optional<uint16_t> SecNumOfTBSS;
  63. std::optional<llvm::yaml::Hex16> Flag;
  64. };
  65. struct Relocation {
  66. llvm::yaml::Hex64 VirtualAddress;
  67. llvm::yaml::Hex64 SymbolIndex;
  68. llvm::yaml::Hex8 Info;
  69. llvm::yaml::Hex8 Type;
  70. };
  71. struct Section {
  72. StringRef SectionName;
  73. llvm::yaml::Hex64 Address;
  74. llvm::yaml::Hex64 Size;
  75. llvm::yaml::Hex64 FileOffsetToData;
  76. llvm::yaml::Hex64 FileOffsetToRelocations;
  77. llvm::yaml::Hex64 FileOffsetToLineNumbers; // Line number pointer. Not supported yet.
  78. llvm::yaml::Hex16 NumberOfRelocations;
  79. llvm::yaml::Hex16 NumberOfLineNumbers; // Line number counts. Not supported yet.
  80. uint32_t Flags;
  81. yaml::BinaryRef SectionData;
  82. std::vector<Relocation> Relocations;
  83. };
  84. enum AuxSymbolType : uint8_t {
  85. AUX_EXCEPT = 255,
  86. AUX_FCN = 254,
  87. AUX_SYM = 253,
  88. AUX_FILE = 252,
  89. AUX_CSECT = 251,
  90. AUX_SECT = 250,
  91. AUX_STAT = 249
  92. };
  93. struct AuxSymbolEnt {
  94. AuxSymbolType Type;
  95. explicit AuxSymbolEnt(AuxSymbolType T) : Type(T) {}
  96. virtual ~AuxSymbolEnt();
  97. };
  98. struct FileAuxEnt : AuxSymbolEnt {
  99. std::optional<StringRef> FileNameOrString;
  100. std::optional<XCOFF::CFileStringType> FileStringType;
  101. FileAuxEnt() : AuxSymbolEnt(AuxSymbolType::AUX_FILE) {}
  102. static bool classof(const AuxSymbolEnt *S) {
  103. return S->Type == AuxSymbolType::AUX_FILE;
  104. }
  105. };
  106. struct CsectAuxEnt : AuxSymbolEnt {
  107. // Only for XCOFF32.
  108. std::optional<uint32_t> SectionOrLength;
  109. std::optional<uint32_t> StabInfoIndex;
  110. std::optional<uint16_t> StabSectNum;
  111. // Only for XCOFF64.
  112. std::optional<uint32_t> SectionOrLengthLo;
  113. std::optional<uint32_t> SectionOrLengthHi;
  114. // Common fields for both XCOFF32 and XCOFF64.
  115. std::optional<uint32_t> ParameterHashIndex;
  116. std::optional<uint16_t> TypeChkSectNum;
  117. std::optional<uint8_t> SymbolAlignmentAndType;
  118. std::optional<XCOFF::StorageMappingClass> StorageMappingClass;
  119. CsectAuxEnt() : AuxSymbolEnt(AuxSymbolType::AUX_CSECT) {}
  120. static bool classof(const AuxSymbolEnt *S) {
  121. return S->Type == AuxSymbolType::AUX_CSECT;
  122. }
  123. };
  124. struct FunctionAuxEnt : AuxSymbolEnt {
  125. std::optional<uint32_t> OffsetToExceptionTbl; // Only for XCOFF32.
  126. std::optional<uint64_t> PtrToLineNum;
  127. std::optional<uint32_t> SizeOfFunction;
  128. std::optional<int32_t> SymIdxOfNextBeyond;
  129. FunctionAuxEnt() : AuxSymbolEnt(AuxSymbolType::AUX_FCN) {}
  130. static bool classof(const AuxSymbolEnt *S) {
  131. return S->Type == AuxSymbolType::AUX_FCN;
  132. }
  133. };
  134. struct ExcpetionAuxEnt : AuxSymbolEnt {
  135. std::optional<uint64_t> OffsetToExceptionTbl;
  136. std::optional<uint32_t> SizeOfFunction;
  137. std::optional<int32_t> SymIdxOfNextBeyond;
  138. ExcpetionAuxEnt() : AuxSymbolEnt(AuxSymbolType::AUX_EXCEPT) {}
  139. static bool classof(const AuxSymbolEnt *S) {
  140. return S->Type == AuxSymbolType::AUX_EXCEPT;
  141. }
  142. }; // Only for XCOFF64.
  143. struct BlockAuxEnt : AuxSymbolEnt {
  144. // Only for XCOFF32.
  145. std::optional<uint16_t> LineNumHi;
  146. std::optional<uint16_t> LineNumLo;
  147. // Only for XCOFF64.
  148. std::optional<uint32_t> LineNum;
  149. BlockAuxEnt() : AuxSymbolEnt(AuxSymbolType::AUX_SYM) {}
  150. static bool classof(const AuxSymbolEnt *S) {
  151. return S->Type == AuxSymbolType::AUX_SYM;
  152. }
  153. };
  154. struct SectAuxEntForDWARF : AuxSymbolEnt {
  155. std::optional<uint32_t> LengthOfSectionPortion;
  156. std::optional<uint32_t> NumberOfRelocEnt;
  157. SectAuxEntForDWARF() : AuxSymbolEnt(AuxSymbolType::AUX_SECT) {}
  158. static bool classof(const AuxSymbolEnt *S) {
  159. return S->Type == AuxSymbolType::AUX_SECT;
  160. }
  161. };
  162. struct SectAuxEntForStat : AuxSymbolEnt {
  163. std::optional<uint32_t> SectionLength;
  164. std::optional<uint16_t> NumberOfRelocEnt;
  165. std::optional<uint16_t> NumberOfLineNum;
  166. SectAuxEntForStat() : AuxSymbolEnt(AuxSymbolType::AUX_STAT) {}
  167. static bool classof(const AuxSymbolEnt *S) {
  168. return S->Type == AuxSymbolType::AUX_STAT;
  169. }
  170. }; // Only for XCOFF32.
  171. struct Symbol {
  172. StringRef SymbolName;
  173. llvm::yaml::Hex64 Value; // Symbol value; storage class-dependent.
  174. std::optional<StringRef> SectionName;
  175. std::optional<uint16_t> SectionIndex;
  176. llvm::yaml::Hex16 Type;
  177. XCOFF::StorageClass StorageClass;
  178. std::optional<uint8_t> NumberOfAuxEntries;
  179. std::vector<std::unique_ptr<AuxSymbolEnt>> AuxEntries;
  180. };
  181. struct StringTable {
  182. std::optional<uint32_t> ContentSize; // The total size of the string table.
  183. std::optional<uint32_t> Length; // The value of the length field for the first
  184. // 4 bytes of the table.
  185. std::optional<std::vector<StringRef>> Strings;
  186. std::optional<yaml::BinaryRef> RawContent;
  187. };
  188. struct Object {
  189. FileHeader Header;
  190. std::optional<AuxiliaryHeader> AuxHeader;
  191. std::vector<Section> Sections;
  192. std::vector<Symbol> Symbols;
  193. StringTable StrTbl;
  194. Object();
  195. };
  196. } // namespace XCOFFYAML
  197. } // namespace llvm
  198. LLVM_YAML_IS_SEQUENCE_VECTOR(XCOFFYAML::Symbol)
  199. LLVM_YAML_IS_SEQUENCE_VECTOR(XCOFFYAML::Relocation)
  200. LLVM_YAML_IS_SEQUENCE_VECTOR(XCOFFYAML::Section)
  201. LLVM_YAML_IS_SEQUENCE_VECTOR(std::unique_ptr<llvm::XCOFFYAML::AuxSymbolEnt>)
  202. namespace llvm {
  203. namespace yaml {
  204. template <> struct ScalarBitSetTraits<XCOFF::SectionTypeFlags> {
  205. static void bitset(IO &IO, XCOFF::SectionTypeFlags &Value);
  206. };
  207. template <> struct ScalarEnumerationTraits<XCOFF::StorageClass> {
  208. static void enumeration(IO &IO, XCOFF::StorageClass &Value);
  209. };
  210. template <> struct ScalarEnumerationTraits<XCOFF::StorageMappingClass> {
  211. static void enumeration(IO &IO, XCOFF::StorageMappingClass &Value);
  212. };
  213. template <> struct ScalarEnumerationTraits<XCOFF::CFileStringType> {
  214. static void enumeration(IO &IO, XCOFF::CFileStringType &Type);
  215. };
  216. template <> struct ScalarEnumerationTraits<XCOFFYAML::AuxSymbolType> {
  217. static void enumeration(IO &IO, XCOFFYAML::AuxSymbolType &Type);
  218. };
  219. template <> struct MappingTraits<XCOFFYAML::FileHeader> {
  220. static void mapping(IO &IO, XCOFFYAML::FileHeader &H);
  221. };
  222. template <> struct MappingTraits<XCOFFYAML::AuxiliaryHeader> {
  223. static void mapping(IO &IO, XCOFFYAML::AuxiliaryHeader &AuxHdr);
  224. };
  225. template <> struct MappingTraits<std::unique_ptr<XCOFFYAML::AuxSymbolEnt>> {
  226. static void mapping(IO &IO, std::unique_ptr<XCOFFYAML::AuxSymbolEnt> &AuxSym);
  227. };
  228. template <> struct MappingTraits<XCOFFYAML::Symbol> {
  229. static void mapping(IO &IO, XCOFFYAML::Symbol &S);
  230. };
  231. template <> struct MappingTraits<XCOFFYAML::Relocation> {
  232. static void mapping(IO &IO, XCOFFYAML::Relocation &R);
  233. };
  234. template <> struct MappingTraits<XCOFFYAML::Section> {
  235. static void mapping(IO &IO, XCOFFYAML::Section &Sec);
  236. };
  237. template <> struct MappingTraits<XCOFFYAML::StringTable> {
  238. static void mapping(IO &IO, XCOFFYAML::StringTable &Str);
  239. };
  240. template <> struct MappingTraits<XCOFFYAML::Object> {
  241. static void mapping(IO &IO, XCOFFYAML::Object &Obj);
  242. };
  243. } // namespace yaml
  244. } // namespace llvm
  245. #endif // LLVM_OBJECTYAML_XCOFFYAML_H
  246. #ifdef __GNUC__
  247. #pragma GCC diagnostic pop
  248. #endif