1 //===--- llvm-jitlink-coff.cpp -- COFF parsing support for llvm-jitlink ---===//
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 // COFF parsing support for llvm-jitlink.
11 //===----------------------------------------------------------------------===//
13 #include "llvm-jitlink.h"
15 #include "llvm/Support/Error.h"
16 #include "llvm/Support/Path.h"
18 #define DEBUG_TYPE "llvm_jitlink"
21 using namespace llvm::jitlink
;
23 static bool isCOFFGOTSection(Section
&S
) { return S
.getName() == "$__GOT"; }
25 static bool isCOFFStubsSection(Section
&S
) { return S
.getName() == "$__STUBS"; }
27 static Expected
<Edge
&> getFirstRelocationEdge(LinkGraph
&G
, Block
&B
) {
29 llvm::find_if(B
.edges(), [](Edge
&E
) { return E
.isRelocation(); });
30 if (EItr
== B
.edges().end())
31 return make_error
<StringError
>("GOT entry in " + G
.getName() + ", \"" +
32 B
.getSection().getName() +
33 "\" has no relocations",
34 inconvertibleErrorCode());
38 static Expected
<Symbol
&> getCOFFGOTTarget(LinkGraph
&G
, Block
&B
) {
39 auto E
= getFirstRelocationEdge(G
, B
);
42 auto &TargetSym
= E
->getTarget();
43 if (!TargetSym
.hasName())
44 return make_error
<StringError
>(
45 "GOT entry in " + G
.getName() + ", \"" +
46 TargetSym
.getBlock().getSection().getName() +
47 "\" points to anonymous "
49 inconvertibleErrorCode());
53 static Expected
<Symbol
&> getCOFFStubTarget(LinkGraph
&G
, Block
&B
) {
54 auto E
= getFirstRelocationEdge(G
, B
);
57 auto &GOTSym
= E
->getTarget();
58 if (!GOTSym
.isDefined() || !isCOFFGOTSection(GOTSym
.getBlock().getSection()))
59 return make_error
<StringError
>(
60 "Stubs entry in " + G
.getName() + ", \"" +
61 GOTSym
.getBlock().getSection().getName() +
62 "\" does not point to GOT entry",
63 inconvertibleErrorCode());
64 return getCOFFGOTTarget(G
, GOTSym
.getBlock());
68 Error
registerCOFFGraphInfo(Session
&S
, LinkGraph
&G
) {
69 auto FileName
= sys::path::filename(G
.getName());
70 if (S
.FileInfos
.count(FileName
)) {
71 return make_error
<StringError
>("When -check is passed, file names must be "
72 "distinct (duplicate: \"" +
74 inconvertibleErrorCode());
77 auto &FileInfo
= S
.FileInfos
[FileName
];
79 { dbgs() << "Registering COFF file info for \"" << FileName
<< "\"\n"; });
80 for (auto &Sec
: G
.sections()) {
82 dbgs() << " Section \"" << Sec
.getName() << "\": "
83 << (Sec
.symbols().empty() ? "empty. skipping." : "processing...")
87 // Skip empty sections.
88 if (Sec
.symbols().empty())
91 if (FileInfo
.SectionInfos
.count(Sec
.getName()))
92 return make_error
<StringError
>("Encountered duplicate section name \"" +
93 Sec
.getName() + "\" in \"" + FileName
+
95 inconvertibleErrorCode());
97 bool isGOTSection
= isCOFFGOTSection(Sec
);
98 bool isStubsSection
= isCOFFStubsSection(Sec
);
100 bool SectionContainsContent
= false;
101 bool SectionContainsZeroFill
= false;
103 auto *FirstSym
= *Sec
.symbols().begin();
104 auto *LastSym
= FirstSym
;
105 for (auto *Sym
: Sec
.symbols()) {
106 if (Sym
->getAddress() < FirstSym
->getAddress())
108 if (Sym
->getAddress() > LastSym
->getAddress())
111 if (isGOTSection
|| isStubsSection
) {
113 // Skip the GOT start symbol
114 if (Sym
->getSize() != 0)
115 if (Error E
= FileInfo
.registerGOTEntry(G
, *Sym
, getCOFFGOTTarget
))
118 if (Error E
= FileInfo
.registerStubEntry(G
, *Sym
, getCOFFStubTarget
))
121 SectionContainsContent
= true;
124 if (Sym
->hasName()) {
125 if (Sym
->isSymbolZeroFill()) {
126 S
.SymbolInfos
[Sym
->getName()] = {Sym
->getSize(),
127 Sym
->getAddress().getValue()};
128 SectionContainsZeroFill
= true;
130 S
.SymbolInfos
[Sym
->getName()] = {Sym
->getSymbolContent(),
131 Sym
->getAddress().getValue(),
132 Sym
->getTargetFlags()};
133 SectionContainsContent
= true;
138 auto SecAddr
= FirstSym
->getAddress();
140 (LastSym
->getBlock().getAddress() + LastSym
->getBlock().getSize()) -
143 if (SectionContainsZeroFill
&& SectionContainsContent
)
144 return make_error
<StringError
>("Mixed zero-fill and content sections not "
146 inconvertibleErrorCode());
148 if (SectionContainsZeroFill
)
149 FileInfo
.SectionInfos
[Sec
.getName()] = {SecSize
, SecAddr
.getValue()};
151 FileInfo
.SectionInfos
[Sec
.getName()] = {
152 ArrayRef
<char>(FirstSym
->getBlock().getContent().data(), SecSize
),
153 SecAddr
.getValue(), FirstSym
->getTargetFlags()};
156 return Error::success();
159 } // end namespace llvm