annotate lld/COFF/Writer.h @ 240:ca573705d418

merge
author matac
date Fri, 28 Jul 2023 20:50:09 +0900 (2023-07-28)
parents c4bab56944e8
children 1f2b6ac9f198
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
150
anatofuz
parents:
diff changeset
1 //===- Writer.h -------------------------------------------------*- C++ -*-===//
anatofuz
parents:
diff changeset
2 //
anatofuz
parents:
diff changeset
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
anatofuz
parents:
diff changeset
4 // See https://llvm.org/LICENSE.txt for license information.
anatofuz
parents:
diff changeset
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
anatofuz
parents:
diff changeset
6 //
anatofuz
parents:
diff changeset
7 //===----------------------------------------------------------------------===//
anatofuz
parents:
diff changeset
8
anatofuz
parents:
diff changeset
9 #ifndef LLD_COFF_WRITER_H
anatofuz
parents:
diff changeset
10 #define LLD_COFF_WRITER_H
anatofuz
parents:
diff changeset
11
anatofuz
parents:
diff changeset
12 #include "Chunks.h"
anatofuz
parents:
diff changeset
13 #include "llvm/ADT/StringRef.h"
anatofuz
parents:
diff changeset
14 #include "llvm/Object/COFF.h"
anatofuz
parents:
diff changeset
15 #include <chrono>
anatofuz
parents:
diff changeset
16 #include <cstdint>
anatofuz
parents:
diff changeset
17 #include <vector>
anatofuz
parents:
diff changeset
18
236
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
19 namespace lld::coff {
150
anatofuz
parents:
diff changeset
20 static const int pageSize = 4096;
236
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
21 class COFFLinkerContext;
150
anatofuz
parents:
diff changeset
22
236
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
23 void writeResult(COFFLinkerContext &ctx);
150
anatofuz
parents:
diff changeset
24
anatofuz
parents:
diff changeset
25 class PartialSection {
anatofuz
parents:
diff changeset
26 public:
anatofuz
parents:
diff changeset
27 PartialSection(StringRef n, uint32_t chars)
anatofuz
parents:
diff changeset
28 : name(n), characteristics(chars) {}
anatofuz
parents:
diff changeset
29 StringRef name;
anatofuz
parents:
diff changeset
30 unsigned characteristics;
anatofuz
parents:
diff changeset
31 std::vector<Chunk *> chunks;
anatofuz
parents:
diff changeset
32 };
anatofuz
parents:
diff changeset
33
anatofuz
parents:
diff changeset
34 // OutputSection represents a section in an output file. It's a
anatofuz
parents:
diff changeset
35 // container of chunks. OutputSection and Chunk are 1:N relationship.
anatofuz
parents:
diff changeset
36 // Chunks cannot belong to more than one OutputSections. The writer
anatofuz
parents:
diff changeset
37 // creates multiple OutputSections and assign them unique,
anatofuz
parents:
diff changeset
38 // non-overlapping file offsets and RVAs.
anatofuz
parents:
diff changeset
39 class OutputSection {
anatofuz
parents:
diff changeset
40 public:
anatofuz
parents:
diff changeset
41 OutputSection(llvm::StringRef n, uint32_t chars) : name(n) {
anatofuz
parents:
diff changeset
42 header.Characteristics = chars;
anatofuz
parents:
diff changeset
43 }
anatofuz
parents:
diff changeset
44 void addChunk(Chunk *c);
anatofuz
parents:
diff changeset
45 void insertChunkAtStart(Chunk *c);
anatofuz
parents:
diff changeset
46 void merge(OutputSection *other);
anatofuz
parents:
diff changeset
47 void setPermissions(uint32_t c);
anatofuz
parents:
diff changeset
48 uint64_t getRVA() { return header.VirtualAddress; }
anatofuz
parents:
diff changeset
49 uint64_t getFileOff() { return header.PointerToRawData; }
anatofuz
parents:
diff changeset
50 void writeHeaderTo(uint8_t *buf);
anatofuz
parents:
diff changeset
51 void addContributingPartialSection(PartialSection *sec);
anatofuz
parents:
diff changeset
52
anatofuz
parents:
diff changeset
53 // Returns the size of this section in an executable memory image.
anatofuz
parents:
diff changeset
54 // This may be smaller than the raw size (the raw size is multiple
anatofuz
parents:
diff changeset
55 // of disk sector size, so there may be padding at end), or may be
anatofuz
parents:
diff changeset
56 // larger (if that's the case, the loader reserves spaces after end
anatofuz
parents:
diff changeset
57 // of raw data).
anatofuz
parents:
diff changeset
58 uint64_t getVirtualSize() { return header.VirtualSize; }
anatofuz
parents:
diff changeset
59
anatofuz
parents:
diff changeset
60 // Returns the size of the section in the output file.
anatofuz
parents:
diff changeset
61 uint64_t getRawSize() { return header.SizeOfRawData; }
anatofuz
parents:
diff changeset
62
anatofuz
parents:
diff changeset
63 // Set offset into the string table storing this section name.
anatofuz
parents:
diff changeset
64 // Used only when the name is longer than 8 bytes.
anatofuz
parents:
diff changeset
65 void setStringTableOff(uint32_t v) { stringTableOff = v; }
anatofuz
parents:
diff changeset
66
anatofuz
parents:
diff changeset
67 // N.B. The section index is one based.
anatofuz
parents:
diff changeset
68 uint32_t sectionIndex = 0;
anatofuz
parents:
diff changeset
69
anatofuz
parents:
diff changeset
70 llvm::StringRef name;
anatofuz
parents:
diff changeset
71 llvm::object::coff_section header = {};
anatofuz
parents:
diff changeset
72
anatofuz
parents:
diff changeset
73 std::vector<Chunk *> chunks;
anatofuz
parents:
diff changeset
74 std::vector<Chunk *> origChunks;
anatofuz
parents:
diff changeset
75
anatofuz
parents:
diff changeset
76 std::vector<PartialSection *> contribSections;
anatofuz
parents:
diff changeset
77
anatofuz
parents:
diff changeset
78 private:
anatofuz
parents:
diff changeset
79 uint32_t stringTableOff = 0;
anatofuz
parents:
diff changeset
80 };
anatofuz
parents:
diff changeset
81
236
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
82 } // namespace lld::coff
150
anatofuz
parents:
diff changeset
83
anatofuz
parents:
diff changeset
84 #endif