xref: /llvm-project/llvm/lib/Object/WindowsResource.cpp (revision dd6019526de2f26a9db21b90702fea8cbccc7e7c)
1 //===-- WindowsResource.cpp -------------------------------------*- 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 implements the .res file class.
10 //
11 //===----------------------------------------------------------------------===//
12 
13 #include "llvm/Object/WindowsResource.h"
14 #include "llvm/Object/COFF.h"
15 #include "llvm/Support/FileOutputBuffer.h"
16 #include "llvm/Support/FormatVariadic.h"
17 #include "llvm/Support/MathExtras.h"
18 #include "llvm/Support/ScopedPrinter.h"
19 #include <ctime>
20 #include <queue>
21 #include <system_error>
22 
23 using namespace llvm;
24 using namespace object;
25 
26 namespace llvm {
27 namespace object {
28 
29 #define RETURN_IF_ERROR(X)                                                     \
30   if (auto EC = X)                                                             \
31     return EC;
32 
33 const uint32_t MIN_HEADER_SIZE = 7 * sizeof(uint32_t) + 2 * sizeof(uint16_t);
34 
35 // COFF files seem to be inconsistent with alignment between sections, just use
36 // 8-byte because it makes everyone happy.
37 const uint32_t SECTION_ALIGNMENT = sizeof(uint64_t);
38 
39 uint32_t WindowsResourceParser::TreeNode::StringCount = 0;
40 uint32_t WindowsResourceParser::TreeNode::DataCount = 0;
41 
42 WindowsResource::WindowsResource(MemoryBufferRef Source)
43     : Binary(Binary::ID_WinRes, Source) {
44   size_t LeadingSize = WIN_RES_MAGIC_SIZE + WIN_RES_NULL_ENTRY_SIZE;
45   BBS = BinaryByteStream(Data.getBuffer().drop_front(LeadingSize),
46                          support::little);
47 }
48 
49 // static
50 Expected<std::unique_ptr<WindowsResource>>
51 WindowsResource::createWindowsResource(MemoryBufferRef Source) {
52   if (Source.getBufferSize() < WIN_RES_MAGIC_SIZE + WIN_RES_NULL_ENTRY_SIZE)
53     return make_error<GenericBinaryError>(
54         Source.getBufferIdentifier() + ": too small to be a resource file",
55         object_error::invalid_file_type);
56   std::unique_ptr<WindowsResource> Ret(new WindowsResource(Source));
57   return std::move(Ret);
58 }
59 
60 Expected<ResourceEntryRef> WindowsResource::getHeadEntry() {
61   if (BBS.getLength() < sizeof(WinResHeaderPrefix) + sizeof(WinResHeaderSuffix))
62     return make_error<EmptyResError>(getFileName() + " contains no entries",
63                                      object_error::unexpected_eof);
64   return ResourceEntryRef::create(BinaryStreamRef(BBS), this);
65 }
66 
67 ResourceEntryRef::ResourceEntryRef(BinaryStreamRef Ref,
68                                    const WindowsResource *Owner)
69     : Reader(Ref), Owner(Owner) {}
70 
71 Expected<ResourceEntryRef>
72 ResourceEntryRef::create(BinaryStreamRef BSR, const WindowsResource *Owner) {
73   auto Ref = ResourceEntryRef(BSR, Owner);
74   if (auto E = Ref.loadNext())
75     return std::move(E);
76   return Ref;
77 }
78 
79 Error ResourceEntryRef::moveNext(bool &End) {
80   // Reached end of all the entries.
81   if (Reader.bytesRemaining() == 0) {
82     End = true;
83     return Error::success();
84   }
85   RETURN_IF_ERROR(loadNext());
86 
87   return Error::success();
88 }
89 
90 static Error readStringOrId(BinaryStreamReader &Reader, uint16_t &ID,
91                             ArrayRef<UTF16> &Str, bool &IsString) {
92   uint16_t IDFlag;
93   RETURN_IF_ERROR(Reader.readInteger(IDFlag));
94   IsString = IDFlag != 0xffff;
95 
96   if (IsString) {
97     Reader.setOffset(
98         Reader.getOffset() -
99         sizeof(uint16_t)); // Re-read the bytes which we used to check the flag.
100     RETURN_IF_ERROR(Reader.readWideString(Str));
101   } else
102     RETURN_IF_ERROR(Reader.readInteger(ID));
103 
104   return Error::success();
105 }
106 
107 Error ResourceEntryRef::loadNext() {
108   const WinResHeaderPrefix *Prefix;
109   RETURN_IF_ERROR(Reader.readObject(Prefix));
110 
111   if (Prefix->HeaderSize < MIN_HEADER_SIZE)
112     return make_error<GenericBinaryError>(Owner->getFileName() +
113                                               ": header size too small",
114                                           object_error::parse_failed);
115 
116   RETURN_IF_ERROR(readStringOrId(Reader, TypeID, Type, IsStringType));
117 
118   RETURN_IF_ERROR(readStringOrId(Reader, NameID, Name, IsStringName));
119 
120   RETURN_IF_ERROR(Reader.padToAlignment(WIN_RES_HEADER_ALIGNMENT));
121 
122   RETURN_IF_ERROR(Reader.readObject(Suffix));
123 
124   RETURN_IF_ERROR(Reader.readArray(Data, Prefix->DataSize));
125 
126   RETURN_IF_ERROR(Reader.padToAlignment(WIN_RES_DATA_ALIGNMENT));
127 
128   return Error::success();
129 }
130 
131 WindowsResourceParser::WindowsResourceParser() : Root(false) {}
132 
133 void printResourceTypeName(uint16_t TypeID, raw_ostream &OS) {
134   switch (TypeID) {
135   case  1: OS << "CURSOR (ID 1)"; break;
136   case  2: OS << "BITMAP (ID 2)"; break;
137   case  3: OS << "ICON (ID 3)"; break;
138   case  4: OS << "MENU (ID 4)"; break;
139   case  5: OS << "DIALOG (ID 5)"; break;
140   case  6: OS << "STRINGTABLE (ID 6)"; break;
141   case  7: OS << "FONTDIR (ID 7)"; break;
142   case  8: OS << "FONT (ID 8)"; break;
143   case  9: OS << "ACCELERATOR (ID 9)"; break;
144   case 10: OS << "RCDATA (ID 10)"; break;
145   case 11: OS << "MESSAGETABLE (ID 11)"; break;
146   case 12: OS << "GROUP_CURSOR (ID 12)"; break;
147   case 14: OS << "GROUP_ICON (ID 14)"; break;
148   case 16: OS << "VERSIONINFO (ID 16)"; break;
149   case 17: OS << "DLGINCLUDE (ID 17)"; break;
150   case 19: OS << "PLUGPLAY (ID 19)"; break;
151   case 20: OS << "VXD (ID 20)"; break;
152   case 21: OS << "ANICURSOR (ID 21)"; break;
153   case 22: OS << "ANIICON (ID 22)"; break;
154   case 23: OS << "HTML (ID 23)"; break;
155   case 24: OS << "MANIFEST (ID 24)"; break;
156   default: OS << "ID " << TypeID; break;
157   }
158 }
159 
160 static bool convertUTF16LEToUTF8String(ArrayRef<UTF16> Src, std::string &Out) {
161   if (!sys::IsBigEndianHost)
162     return convertUTF16ToUTF8String(Src, Out);
163 
164   std::vector<UTF16> EndianCorrectedSrc;
165   EndianCorrectedSrc.resize(Src.size() + 1);
166   llvm::copy(Src, EndianCorrectedSrc.begin() + 1);
167   EndianCorrectedSrc[0] = UNI_UTF16_BYTE_ORDER_MARK_SWAPPED;
168   return convertUTF16ToUTF8String(makeArrayRef(EndianCorrectedSrc), Out);
169 }
170 
171 static std::string makeDuplicateResourceError(
172     const ResourceEntryRef &Entry, StringRef File1, StringRef File2) {
173   std::string Ret;
174   raw_string_ostream OS(Ret);
175 
176   OS << "duplicate resource:";
177 
178   OS << " type ";
179   if (Entry.checkTypeString()) {
180     std::string UTF8;
181     if (!convertUTF16LEToUTF8String(Entry.getTypeString(), UTF8))
182       UTF8 = "(failed conversion from UTF16)";
183     OS << '\"' << UTF8 << '\"';
184   } else
185     printResourceTypeName(Entry.getTypeID(), OS);
186 
187   OS << "/name ";
188   if (Entry.checkNameString()) {
189     std::string UTF8;
190     if (!convertUTF16LEToUTF8String(Entry.getNameString(), UTF8))
191       UTF8 = "(failed conversion from UTF16)";
192     OS << '\"' << UTF8 << '\"';
193   } else {
194     OS << "ID " << Entry.getNameID();
195   }
196 
197   OS << "/language " << Entry.getLanguage() << ", in " << File1 << " and in "
198      << File2;
199 
200   return OS.str();
201 }
202 
203 Error WindowsResourceParser::parse(WindowsResource *WR,
204                                    std::vector<std::string> &Duplicates) {
205   auto EntryOrErr = WR->getHeadEntry();
206   if (!EntryOrErr) {
207     auto E = EntryOrErr.takeError();
208     if (E.isA<EmptyResError>()) {
209       // Check if the .res file contains no entries.  In this case we don't have
210       // to throw an error but can rather just return without parsing anything.
211       // This applies for files which have a valid PE header magic and the
212       // mandatory empty null resource entry.  Files which do not fit this
213       // criteria would have already been filtered out by
214       // WindowsResource::createWindowsResource().
215       consumeError(std::move(E));
216       return Error::success();
217     }
218     return E;
219   }
220 
221   ResourceEntryRef Entry = EntryOrErr.get();
222   bool End = false;
223   while (!End) {
224     Data.push_back(Entry.getData());
225 
226     bool IsNewTypeString = false;
227     bool IsNewNameString = false;
228 
229     TreeNode* Node;
230     bool IsNewNode = Root.addEntry(Entry, InputFilenames.size(),
231                                    IsNewTypeString, IsNewNameString, Node);
232     InputFilenames.push_back(WR->getFileName());
233     if (!IsNewNode) {
234       Duplicates.push_back(makeDuplicateResourceError(
235           Entry, InputFilenames[Node->Origin], WR->getFileName()));
236     }
237 
238     if (IsNewTypeString)
239       StringTable.push_back(Entry.getTypeString());
240 
241     if (IsNewNameString)
242       StringTable.push_back(Entry.getNameString());
243 
244     RETURN_IF_ERROR(Entry.moveNext(End));
245   }
246 
247   return Error::success();
248 }
249 
250 void WindowsResourceParser::printTree(raw_ostream &OS) const {
251   ScopedPrinter Writer(OS);
252   Root.print(Writer, "Resource Tree");
253 }
254 
255 bool WindowsResourceParser::TreeNode::addEntry(const ResourceEntryRef &Entry,
256                                                uint32_t Origin,
257                                                bool &IsNewTypeString,
258                                                bool &IsNewNameString,
259                                                TreeNode *&Result) {
260   TreeNode &TypeNode = addTypeNode(Entry, IsNewTypeString);
261   TreeNode &NameNode = TypeNode.addNameNode(Entry, IsNewNameString);
262   return NameNode.addLanguageNode(Entry, Origin, Result);
263 }
264 
265 WindowsResourceParser::TreeNode::TreeNode(bool IsStringNode) {
266   if (IsStringNode)
267     StringIndex = StringCount++;
268 }
269 
270 WindowsResourceParser::TreeNode::TreeNode(uint16_t MajorVersion,
271                                           uint16_t MinorVersion,
272                                           uint32_t Characteristics,
273                                           uint32_t Origin)
274     : IsDataNode(true), MajorVersion(MajorVersion), MinorVersion(MinorVersion),
275       Characteristics(Characteristics), Origin(Origin) {
276   DataIndex = DataCount++;
277 }
278 
279 std::unique_ptr<WindowsResourceParser::TreeNode>
280 WindowsResourceParser::TreeNode::createStringNode() {
281   return std::unique_ptr<TreeNode>(new TreeNode(true));
282 }
283 
284 std::unique_ptr<WindowsResourceParser::TreeNode>
285 WindowsResourceParser::TreeNode::createIDNode() {
286   return std::unique_ptr<TreeNode>(new TreeNode(false));
287 }
288 
289 std::unique_ptr<WindowsResourceParser::TreeNode>
290 WindowsResourceParser::TreeNode::createDataNode(uint16_t MajorVersion,
291                                                 uint16_t MinorVersion,
292                                                 uint32_t Characteristics,
293                                                 uint32_t Origin) {
294   return std::unique_ptr<TreeNode>(
295       new TreeNode(MajorVersion, MinorVersion, Characteristics, Origin));
296 }
297 
298 WindowsResourceParser::TreeNode &
299 WindowsResourceParser::TreeNode::addTypeNode(const ResourceEntryRef &Entry,
300                                              bool &IsNewTypeString) {
301   if (Entry.checkTypeString())
302     return addNameChild(Entry.getTypeString(), IsNewTypeString);
303   else
304     return addIDChild(Entry.getTypeID());
305 }
306 
307 WindowsResourceParser::TreeNode &
308 WindowsResourceParser::TreeNode::addNameNode(const ResourceEntryRef &Entry,
309                                              bool &IsNewNameString) {
310   if (Entry.checkNameString())
311     return addNameChild(Entry.getNameString(), IsNewNameString);
312   else
313     return addIDChild(Entry.getNameID());
314 }
315 
316 bool WindowsResourceParser::TreeNode::addLanguageNode(
317     const ResourceEntryRef &Entry, uint32_t Origin, TreeNode *&Result) {
318   return addDataChild(Entry.getLanguage(), Entry.getMajorVersion(),
319                       Entry.getMinorVersion(), Entry.getCharacteristics(),
320                       Origin, Result);
321 }
322 
323 bool WindowsResourceParser::TreeNode::addDataChild(
324     uint32_t ID, uint16_t MajorVersion, uint16_t MinorVersion,
325     uint32_t Characteristics, uint32_t Origin, TreeNode *&Result) {
326   auto NewChild =
327       createDataNode(MajorVersion, MinorVersion, Characteristics, Origin);
328   auto ElementInserted = IDChildren.emplace(ID, std::move(NewChild));
329   Result = ElementInserted.first->second.get();
330   return ElementInserted.second;
331 }
332 
333 WindowsResourceParser::TreeNode &WindowsResourceParser::TreeNode::addIDChild(
334     uint32_t ID) {
335   auto Child = IDChildren.find(ID);
336   if (Child == IDChildren.end()) {
337     auto NewChild = createIDNode();
338     WindowsResourceParser::TreeNode &Node = *NewChild;
339     IDChildren.emplace(ID, std::move(NewChild));
340     return Node;
341   } else
342     return *(Child->second);
343 }
344 
345 WindowsResourceParser::TreeNode &
346 WindowsResourceParser::TreeNode::addNameChild(ArrayRef<UTF16> NameRef,
347                                               bool &IsNewString) {
348   std::string NameString;
349   convertUTF16LEToUTF8String(NameRef, NameString);
350 
351   auto Child = StringChildren.find(NameString);
352   if (Child == StringChildren.end()) {
353     auto NewChild = createStringNode();
354     IsNewString = true;
355     WindowsResourceParser::TreeNode &Node = *NewChild;
356     StringChildren.emplace(NameString, std::move(NewChild));
357     return Node;
358   } else
359     return *(Child->second);
360 }
361 
362 void WindowsResourceParser::TreeNode::print(ScopedPrinter &Writer,
363                                             StringRef Name) const {
364   ListScope NodeScope(Writer, Name);
365   for (auto const &Child : StringChildren) {
366     Child.second->print(Writer, Child.first);
367   }
368   for (auto const &Child : IDChildren) {
369     Child.second->print(Writer, to_string(Child.first));
370   }
371 }
372 
373 // This function returns the size of the entire resource tree, including
374 // directory tables, directory entries, and data entries.  It does not include
375 // the directory strings or the relocations of the .rsrc section.
376 uint32_t WindowsResourceParser::TreeNode::getTreeSize() const {
377   uint32_t Size = (IDChildren.size() + StringChildren.size()) *
378                   sizeof(coff_resource_dir_entry);
379 
380   // Reached a node pointing to a data entry.
381   if (IsDataNode) {
382     Size += sizeof(coff_resource_data_entry);
383     return Size;
384   }
385 
386   // If the node does not point to data, it must have a directory table pointing
387   // to other nodes.
388   Size += sizeof(coff_resource_dir_table);
389 
390   for (auto const &Child : StringChildren) {
391     Size += Child.second->getTreeSize();
392   }
393   for (auto const &Child : IDChildren) {
394     Size += Child.second->getTreeSize();
395   }
396   return Size;
397 }
398 
399 class WindowsResourceCOFFWriter {
400 public:
401   WindowsResourceCOFFWriter(COFF::MachineTypes MachineType,
402                             const WindowsResourceParser &Parser, Error &E);
403   std::unique_ptr<MemoryBuffer> write(uint32_t TimeDateStamp);
404 
405 private:
406   void performFileLayout();
407   void performSectionOneLayout();
408   void performSectionTwoLayout();
409   void writeCOFFHeader(uint32_t TimeDateStamp);
410   void writeFirstSectionHeader();
411   void writeSecondSectionHeader();
412   void writeFirstSection();
413   void writeSecondSection();
414   void writeSymbolTable();
415   void writeStringTable();
416   void writeDirectoryTree();
417   void writeDirectoryStringTable();
418   void writeFirstSectionRelocations();
419   std::unique_ptr<WritableMemoryBuffer> OutputBuffer;
420   char *BufferStart;
421   uint64_t CurrentOffset = 0;
422   COFF::MachineTypes MachineType;
423   const WindowsResourceParser::TreeNode &Resources;
424   const ArrayRef<std::vector<uint8_t>> Data;
425   uint64_t FileSize;
426   uint32_t SymbolTableOffset;
427   uint32_t SectionOneSize;
428   uint32_t SectionOneOffset;
429   uint32_t SectionOneRelocations;
430   uint32_t SectionTwoSize;
431   uint32_t SectionTwoOffset;
432   const ArrayRef<std::vector<UTF16>> StringTable;
433   std::vector<uint32_t> StringTableOffsets;
434   std::vector<uint32_t> DataOffsets;
435   std::vector<uint32_t> RelocationAddresses;
436 };
437 
438 WindowsResourceCOFFWriter::WindowsResourceCOFFWriter(
439     COFF::MachineTypes MachineType, const WindowsResourceParser &Parser,
440     Error &E)
441     : MachineType(MachineType), Resources(Parser.getTree()),
442       Data(Parser.getData()), StringTable(Parser.getStringTable()) {
443   performFileLayout();
444 
445   OutputBuffer = WritableMemoryBuffer::getNewMemBuffer(FileSize);
446 }
447 
448 void WindowsResourceCOFFWriter::performFileLayout() {
449   // Add size of COFF header.
450   FileSize = COFF::Header16Size;
451 
452   // one .rsrc section header for directory tree, another for resource data.
453   FileSize += 2 * COFF::SectionSize;
454 
455   performSectionOneLayout();
456   performSectionTwoLayout();
457 
458   // We have reached the address of the symbol table.
459   SymbolTableOffset = FileSize;
460 
461   FileSize += COFF::Symbol16Size;     // size of the @feat.00 symbol.
462   FileSize += 4 * COFF::Symbol16Size; // symbol + aux for each section.
463   FileSize += Data.size() * COFF::Symbol16Size; // 1 symbol per resource.
464   FileSize += 4; // four null bytes for the string table.
465 }
466 
467 void WindowsResourceCOFFWriter::performSectionOneLayout() {
468   SectionOneOffset = FileSize;
469 
470   SectionOneSize = Resources.getTreeSize();
471   uint32_t CurrentStringOffset = SectionOneSize;
472   uint32_t TotalStringTableSize = 0;
473   for (auto const &String : StringTable) {
474     StringTableOffsets.push_back(CurrentStringOffset);
475     uint32_t StringSize = String.size() * sizeof(UTF16) + sizeof(uint16_t);
476     CurrentStringOffset += StringSize;
477     TotalStringTableSize += StringSize;
478   }
479   SectionOneSize += alignTo(TotalStringTableSize, sizeof(uint32_t));
480 
481   // account for the relocations of section one.
482   SectionOneRelocations = FileSize + SectionOneSize;
483   FileSize += SectionOneSize;
484   FileSize +=
485       Data.size() * COFF::RelocationSize; // one relocation for each resource.
486   FileSize = alignTo(FileSize, SECTION_ALIGNMENT);
487 }
488 
489 void WindowsResourceCOFFWriter::performSectionTwoLayout() {
490   // add size of .rsrc$2 section, which contains all resource data on 8-byte
491   // alignment.
492   SectionTwoOffset = FileSize;
493   SectionTwoSize = 0;
494   for (auto const &Entry : Data) {
495     DataOffsets.push_back(SectionTwoSize);
496     SectionTwoSize += alignTo(Entry.size(), sizeof(uint64_t));
497   }
498   FileSize += SectionTwoSize;
499   FileSize = alignTo(FileSize, SECTION_ALIGNMENT);
500 }
501 
502 std::unique_ptr<MemoryBuffer>
503 WindowsResourceCOFFWriter::write(uint32_t TimeDateStamp) {
504   BufferStart = OutputBuffer->getBufferStart();
505 
506   writeCOFFHeader(TimeDateStamp);
507   writeFirstSectionHeader();
508   writeSecondSectionHeader();
509   writeFirstSection();
510   writeSecondSection();
511   writeSymbolTable();
512   writeStringTable();
513 
514   return std::move(OutputBuffer);
515 }
516 
517 void WindowsResourceCOFFWriter::writeCOFFHeader(uint32_t TimeDateStamp) {
518   // Write the COFF header.
519   auto *Header = reinterpret_cast<coff_file_header *>(BufferStart);
520   Header->Machine = MachineType;
521   Header->NumberOfSections = 2;
522   Header->TimeDateStamp = TimeDateStamp;
523   Header->PointerToSymbolTable = SymbolTableOffset;
524   // One symbol for every resource plus 2 for each section and @feat.00
525   Header->NumberOfSymbols = Data.size() + 5;
526   Header->SizeOfOptionalHeader = 0;
527   // cvtres.exe sets 32BIT_MACHINE even for 64-bit machine types. Match it.
528   Header->Characteristics = COFF::IMAGE_FILE_32BIT_MACHINE;
529 }
530 
531 void WindowsResourceCOFFWriter::writeFirstSectionHeader() {
532   // Write the first section header.
533   CurrentOffset += sizeof(coff_file_header);
534   auto *SectionOneHeader =
535       reinterpret_cast<coff_section *>(BufferStart + CurrentOffset);
536   strncpy(SectionOneHeader->Name, ".rsrc$01", (size_t)COFF::NameSize);
537   SectionOneHeader->VirtualSize = 0;
538   SectionOneHeader->VirtualAddress = 0;
539   SectionOneHeader->SizeOfRawData = SectionOneSize;
540   SectionOneHeader->PointerToRawData = SectionOneOffset;
541   SectionOneHeader->PointerToRelocations = SectionOneRelocations;
542   SectionOneHeader->PointerToLinenumbers = 0;
543   SectionOneHeader->NumberOfRelocations = Data.size();
544   SectionOneHeader->NumberOfLinenumbers = 0;
545   SectionOneHeader->Characteristics += COFF::IMAGE_SCN_CNT_INITIALIZED_DATA;
546   SectionOneHeader->Characteristics += COFF::IMAGE_SCN_MEM_READ;
547 }
548 
549 void WindowsResourceCOFFWriter::writeSecondSectionHeader() {
550   // Write the second section header.
551   CurrentOffset += sizeof(coff_section);
552   auto *SectionTwoHeader =
553       reinterpret_cast<coff_section *>(BufferStart + CurrentOffset);
554   strncpy(SectionTwoHeader->Name, ".rsrc$02", (size_t)COFF::NameSize);
555   SectionTwoHeader->VirtualSize = 0;
556   SectionTwoHeader->VirtualAddress = 0;
557   SectionTwoHeader->SizeOfRawData = SectionTwoSize;
558   SectionTwoHeader->PointerToRawData = SectionTwoOffset;
559   SectionTwoHeader->PointerToRelocations = 0;
560   SectionTwoHeader->PointerToLinenumbers = 0;
561   SectionTwoHeader->NumberOfRelocations = 0;
562   SectionTwoHeader->NumberOfLinenumbers = 0;
563   SectionTwoHeader->Characteristics = COFF::IMAGE_SCN_CNT_INITIALIZED_DATA;
564   SectionTwoHeader->Characteristics += COFF::IMAGE_SCN_MEM_READ;
565 }
566 
567 void WindowsResourceCOFFWriter::writeFirstSection() {
568   // Write section one.
569   CurrentOffset += sizeof(coff_section);
570 
571   writeDirectoryTree();
572   writeDirectoryStringTable();
573   writeFirstSectionRelocations();
574 
575   CurrentOffset = alignTo(CurrentOffset, SECTION_ALIGNMENT);
576 }
577 
578 void WindowsResourceCOFFWriter::writeSecondSection() {
579   // Now write the .rsrc$02 section.
580   for (auto const &RawDataEntry : Data) {
581     llvm::copy(RawDataEntry, BufferStart + CurrentOffset);
582     CurrentOffset += alignTo(RawDataEntry.size(), sizeof(uint64_t));
583   }
584 
585   CurrentOffset = alignTo(CurrentOffset, SECTION_ALIGNMENT);
586 }
587 
588 void WindowsResourceCOFFWriter::writeSymbolTable() {
589   // Now write the symbol table.
590   // First, the feat symbol.
591   auto *Symbol = reinterpret_cast<coff_symbol16 *>(BufferStart + CurrentOffset);
592   strncpy(Symbol->Name.ShortName, "@feat.00", (size_t)COFF::NameSize);
593   Symbol->Value = 0x11;
594   Symbol->SectionNumber = 0xffff;
595   Symbol->Type = COFF::IMAGE_SYM_DTYPE_NULL;
596   Symbol->StorageClass = COFF::IMAGE_SYM_CLASS_STATIC;
597   Symbol->NumberOfAuxSymbols = 0;
598   CurrentOffset += sizeof(coff_symbol16);
599 
600   // Now write the .rsrc1 symbol + aux.
601   Symbol = reinterpret_cast<coff_symbol16 *>(BufferStart + CurrentOffset);
602   strncpy(Symbol->Name.ShortName, ".rsrc$01", (size_t)COFF::NameSize);
603   Symbol->Value = 0;
604   Symbol->SectionNumber = 1;
605   Symbol->Type = COFF::IMAGE_SYM_DTYPE_NULL;
606   Symbol->StorageClass = COFF::IMAGE_SYM_CLASS_STATIC;
607   Symbol->NumberOfAuxSymbols = 1;
608   CurrentOffset += sizeof(coff_symbol16);
609   auto *Aux = reinterpret_cast<coff_aux_section_definition *>(BufferStart +
610                                                               CurrentOffset);
611   Aux->Length = SectionOneSize;
612   Aux->NumberOfRelocations = Data.size();
613   Aux->NumberOfLinenumbers = 0;
614   Aux->CheckSum = 0;
615   Aux->NumberLowPart = 0;
616   Aux->Selection = 0;
617   CurrentOffset += sizeof(coff_aux_section_definition);
618 
619   // Now write the .rsrc2 symbol + aux.
620   Symbol = reinterpret_cast<coff_symbol16 *>(BufferStart + CurrentOffset);
621   strncpy(Symbol->Name.ShortName, ".rsrc$02", (size_t)COFF::NameSize);
622   Symbol->Value = 0;
623   Symbol->SectionNumber = 2;
624   Symbol->Type = COFF::IMAGE_SYM_DTYPE_NULL;
625   Symbol->StorageClass = COFF::IMAGE_SYM_CLASS_STATIC;
626   Symbol->NumberOfAuxSymbols = 1;
627   CurrentOffset += sizeof(coff_symbol16);
628   Aux = reinterpret_cast<coff_aux_section_definition *>(BufferStart +
629                                                         CurrentOffset);
630   Aux->Length = SectionTwoSize;
631   Aux->NumberOfRelocations = 0;
632   Aux->NumberOfLinenumbers = 0;
633   Aux->CheckSum = 0;
634   Aux->NumberLowPart = 0;
635   Aux->Selection = 0;
636   CurrentOffset += sizeof(coff_aux_section_definition);
637 
638   // Now write a symbol for each relocation.
639   for (unsigned i = 0; i < Data.size(); i++) {
640     auto RelocationName = formatv("$R{0:X-6}", i & 0xffffff).sstr<COFF::NameSize>();
641     Symbol = reinterpret_cast<coff_symbol16 *>(BufferStart + CurrentOffset);
642     memcpy(Symbol->Name.ShortName, RelocationName.data(), (size_t) COFF::NameSize);
643     Symbol->Value = DataOffsets[i];
644     Symbol->SectionNumber = 2;
645     Symbol->Type = COFF::IMAGE_SYM_DTYPE_NULL;
646     Symbol->StorageClass = COFF::IMAGE_SYM_CLASS_STATIC;
647     Symbol->NumberOfAuxSymbols = 0;
648     CurrentOffset += sizeof(coff_symbol16);
649   }
650 }
651 
652 void WindowsResourceCOFFWriter::writeStringTable() {
653   // Just 4 null bytes for the string table.
654   auto COFFStringTable = reinterpret_cast<void *>(BufferStart + CurrentOffset);
655   memset(COFFStringTable, 0, 4);
656 }
657 
658 void WindowsResourceCOFFWriter::writeDirectoryTree() {
659   // Traverse parsed resource tree breadth-first and write the corresponding
660   // COFF objects.
661   std::queue<const WindowsResourceParser::TreeNode *> Queue;
662   Queue.push(&Resources);
663   uint32_t NextLevelOffset =
664       sizeof(coff_resource_dir_table) + (Resources.getStringChildren().size() +
665                                          Resources.getIDChildren().size()) *
666                                             sizeof(coff_resource_dir_entry);
667   std::vector<const WindowsResourceParser::TreeNode *> DataEntriesTreeOrder;
668   uint32_t CurrentRelativeOffset = 0;
669 
670   while (!Queue.empty()) {
671     auto CurrentNode = Queue.front();
672     Queue.pop();
673     auto *Table = reinterpret_cast<coff_resource_dir_table *>(BufferStart +
674                                                               CurrentOffset);
675     Table->Characteristics = CurrentNode->getCharacteristics();
676     Table->TimeDateStamp = 0;
677     Table->MajorVersion = CurrentNode->getMajorVersion();
678     Table->MinorVersion = CurrentNode->getMinorVersion();
679     auto &IDChildren = CurrentNode->getIDChildren();
680     auto &StringChildren = CurrentNode->getStringChildren();
681     Table->NumberOfNameEntries = StringChildren.size();
682     Table->NumberOfIDEntries = IDChildren.size();
683     CurrentOffset += sizeof(coff_resource_dir_table);
684     CurrentRelativeOffset += sizeof(coff_resource_dir_table);
685 
686     // Write the directory entries immediately following each directory table.
687     for (auto const &Child : StringChildren) {
688       auto *Entry = reinterpret_cast<coff_resource_dir_entry *>(BufferStart +
689                                                                 CurrentOffset);
690       Entry->Identifier.setNameOffset(
691           StringTableOffsets[Child.second->getStringIndex()]);
692       if (Child.second->checkIsDataNode()) {
693         Entry->Offset.DataEntryOffset = NextLevelOffset;
694         NextLevelOffset += sizeof(coff_resource_data_entry);
695         DataEntriesTreeOrder.push_back(Child.second.get());
696       } else {
697         Entry->Offset.SubdirOffset = NextLevelOffset + (1 << 31);
698         NextLevelOffset += sizeof(coff_resource_dir_table) +
699                            (Child.second->getStringChildren().size() +
700                             Child.second->getIDChildren().size()) *
701                                sizeof(coff_resource_dir_entry);
702         Queue.push(Child.second.get());
703       }
704       CurrentOffset += sizeof(coff_resource_dir_entry);
705       CurrentRelativeOffset += sizeof(coff_resource_dir_entry);
706     }
707     for (auto const &Child : IDChildren) {
708       auto *Entry = reinterpret_cast<coff_resource_dir_entry *>(BufferStart +
709                                                                 CurrentOffset);
710       Entry->Identifier.ID = Child.first;
711       if (Child.second->checkIsDataNode()) {
712         Entry->Offset.DataEntryOffset = NextLevelOffset;
713         NextLevelOffset += sizeof(coff_resource_data_entry);
714         DataEntriesTreeOrder.push_back(Child.second.get());
715       } else {
716         Entry->Offset.SubdirOffset = NextLevelOffset + (1 << 31);
717         NextLevelOffset += sizeof(coff_resource_dir_table) +
718                            (Child.second->getStringChildren().size() +
719                             Child.second->getIDChildren().size()) *
720                                sizeof(coff_resource_dir_entry);
721         Queue.push(Child.second.get());
722       }
723       CurrentOffset += sizeof(coff_resource_dir_entry);
724       CurrentRelativeOffset += sizeof(coff_resource_dir_entry);
725     }
726   }
727 
728   RelocationAddresses.resize(Data.size());
729   // Now write all the resource data entries.
730   for (auto DataNodes : DataEntriesTreeOrder) {
731     auto *Entry = reinterpret_cast<coff_resource_data_entry *>(BufferStart +
732                                                                CurrentOffset);
733     RelocationAddresses[DataNodes->getDataIndex()] = CurrentRelativeOffset;
734     Entry->DataRVA = 0; // Set to zero because it is a relocation.
735     Entry->DataSize = Data[DataNodes->getDataIndex()].size();
736     Entry->Codepage = 0;
737     Entry->Reserved = 0;
738     CurrentOffset += sizeof(coff_resource_data_entry);
739     CurrentRelativeOffset += sizeof(coff_resource_data_entry);
740   }
741 }
742 
743 void WindowsResourceCOFFWriter::writeDirectoryStringTable() {
744   // Now write the directory string table for .rsrc$01
745   uint32_t TotalStringTableSize = 0;
746   for (auto &String : StringTable) {
747     uint16_t Length = String.size();
748     support::endian::write16le(BufferStart + CurrentOffset, Length);
749     CurrentOffset += sizeof(uint16_t);
750     auto *Start = reinterpret_cast<UTF16 *>(BufferStart + CurrentOffset);
751     llvm::copy(String, Start);
752     CurrentOffset += Length * sizeof(UTF16);
753     TotalStringTableSize += Length * sizeof(UTF16) + sizeof(uint16_t);
754   }
755   CurrentOffset +=
756       alignTo(TotalStringTableSize, sizeof(uint32_t)) - TotalStringTableSize;
757 }
758 
759 void WindowsResourceCOFFWriter::writeFirstSectionRelocations() {
760 
761   // Now write the relocations for .rsrc$01
762   // Five symbols already in table before we start, @feat.00 and 2 for each
763   // .rsrc section.
764   uint32_t NextSymbolIndex = 5;
765   for (unsigned i = 0; i < Data.size(); i++) {
766     auto *Reloc =
767         reinterpret_cast<coff_relocation *>(BufferStart + CurrentOffset);
768     Reloc->VirtualAddress = RelocationAddresses[i];
769     Reloc->SymbolTableIndex = NextSymbolIndex++;
770     switch (MachineType) {
771     case COFF::IMAGE_FILE_MACHINE_ARMNT:
772       Reloc->Type = COFF::IMAGE_REL_ARM_ADDR32NB;
773       break;
774     case COFF::IMAGE_FILE_MACHINE_AMD64:
775       Reloc->Type = COFF::IMAGE_REL_AMD64_ADDR32NB;
776       break;
777     case COFF::IMAGE_FILE_MACHINE_I386:
778       Reloc->Type = COFF::IMAGE_REL_I386_DIR32NB;
779       break;
780     case COFF::IMAGE_FILE_MACHINE_ARM64:
781       Reloc->Type = COFF::IMAGE_REL_ARM64_ADDR32NB;
782       break;
783     default:
784       llvm_unreachable("unknown machine type");
785     }
786     CurrentOffset += sizeof(coff_relocation);
787   }
788 }
789 
790 Expected<std::unique_ptr<MemoryBuffer>>
791 writeWindowsResourceCOFF(COFF::MachineTypes MachineType,
792                          const WindowsResourceParser &Parser,
793                          uint32_t TimeDateStamp) {
794   Error E = Error::success();
795   WindowsResourceCOFFWriter Writer(MachineType, Parser, E);
796   if (E)
797     return std::move(E);
798   return Writer.write(TimeDateStamp);
799 }
800 
801 } // namespace object
802 } // namespace llvm
803