1 //===- Writer.h -------------------------------------------------*- C++ -*-===//
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
7 //===----------------------------------------------------------------------===//
9 #ifndef LLD_COFF_WRITER_H
10 #define LLD_COFF_WRITER_H
13 #include "llvm/ADT/StringRef.h"
14 #include "llvm/Object/COFF.h"
21 static const int pageSize = 4096;
25 class PartialSection {
27 PartialSection(StringRef n, uint32_t chars)
28 : name(n), characteristics(chars) {}
30 unsigned characteristics;
31 std::vector<Chunk *> chunks;
34 // OutputSection represents a section in an output file. It's a
35 // container of chunks. OutputSection and Chunk are 1:N relationship.
36 // Chunks cannot belong to more than one OutputSections. The writer
37 // creates multiple OutputSections and assign them unique,
38 // non-overlapping file offsets and RVAs.
41 OutputSection(llvm::StringRef n, uint32_t chars) : name(n) {
42 header.Characteristics = chars;
44 void addChunk(Chunk *c);
45 void insertChunkAtStart(Chunk *c);
46 void merge(OutputSection *other);
47 void setPermissions(uint32_t c);
48 uint64_t getRVA() { return header.VirtualAddress; }
49 uint64_t getFileOff() { return header.PointerToRawData; }
50 void writeHeaderTo(uint8_t *buf);
51 void addContributingPartialSection(PartialSection *sec);
53 // Returns the size of this section in an executable memory image.
54 // This may be smaller than the raw size (the raw size is multiple
55 // of disk sector size, so there may be padding at end), or may be
56 // larger (if that's the case, the loader reserves spaces after end
58 uint64_t getVirtualSize() { return header.VirtualSize; }
60 // Returns the size of the section in the output file.
61 uint64_t getRawSize() { return header.SizeOfRawData; }
63 // Set offset into the string table storing this section name.
64 // Used only when the name is longer than 8 bytes.
65 void setStringTableOff(uint32_t v) { stringTableOff = v; }
67 // N.B. The section index is one based.
68 uint32_t sectionIndex = 0;
71 llvm::object::coff_section header = {};
73 std::vector<Chunk *> chunks;
74 std::vector<Chunk *> origChunks;
76 std::vector<PartialSection *> contribSections;
79 uint32_t stringTableOff = 0;