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 std::lock_guard
<std::mutex
> Lock(S
.M
);
71 auto FileName
= sys::path::filename(G
.getName());
72 if (S
.FileInfos
.count(FileName
)) {
73 return make_error
<StringError
>("When -check is passed, file names must be "
74 "distinct (duplicate: \"" +
76 inconvertibleErrorCode());
79 auto &FileInfo
= S
.FileInfos
[FileName
];
81 { dbgs() << "Registering COFF file info for \"" << FileName
<< "\"\n"; });
82 for (auto &Sec
: G
.sections()) {
84 dbgs() << " Section \"" << Sec
.getName() << "\": "
85 << (Sec
.symbols().empty() ? "empty. skipping." : "processing...")
89 // Skip empty sections.
90 if (Sec
.symbols().empty())
93 if (FileInfo
.SectionInfos
.count(Sec
.getName()))
94 return make_error
<StringError
>("Encountered duplicate section name \"" +
95 Sec
.getName() + "\" in \"" + FileName
+
97 inconvertibleErrorCode());
99 bool isGOTSection
= isCOFFGOTSection(Sec
);
100 bool isStubsSection
= isCOFFStubsSection(Sec
);
102 bool SectionContainsContent
= false;
103 bool SectionContainsZeroFill
= false;
105 auto *FirstSym
= *Sec
.symbols().begin();
106 auto *LastSym
= FirstSym
;
107 for (auto *Sym
: Sec
.symbols()) {
108 if (Sym
->getAddress() < FirstSym
->getAddress())
110 if (Sym
->getAddress() > LastSym
->getAddress())
113 if (isGOTSection
|| isStubsSection
) {
115 // Skip the GOT start symbol
116 if (Sym
->getSize() != 0)
117 if (Error E
= FileInfo
.registerGOTEntry(G
, *Sym
, getCOFFGOTTarget
))
120 if (Error E
= FileInfo
.registerStubEntry(G
, *Sym
, getCOFFStubTarget
))
123 SectionContainsContent
= true;
126 if (Sym
->hasName()) {
127 if (Sym
->isSymbolZeroFill()) {
128 S
.SymbolInfos
[Sym
->getName()] = {Sym
->getSize(),
129 Sym
->getAddress().getValue()};
130 SectionContainsZeroFill
= true;
132 S
.SymbolInfos
[Sym
->getName()] = {Sym
->getSymbolContent(),
133 Sym
->getAddress().getValue(),
134 Sym
->getTargetFlags()};
135 SectionContainsContent
= true;
140 auto SecAddr
= FirstSym
->getAddress();
142 (LastSym
->getBlock().getAddress() + LastSym
->getBlock().getSize()) -
145 if (SectionContainsZeroFill
&& SectionContainsContent
)
146 return make_error
<StringError
>("Mixed zero-fill and content sections not "
148 inconvertibleErrorCode());
150 if (SectionContainsZeroFill
)
151 FileInfo
.SectionInfos
[Sec
.getName()] = {SecSize
, SecAddr
.getValue()};
153 FileInfo
.SectionInfos
[Sec
.getName()] = {
154 ArrayRef
<char>(FirstSym
->getBlock().getContent().data(), SecSize
),
155 SecAddr
.getValue(), FirstSym
->getTargetFlags()};
158 return Error::success();
161 } // end namespace llvm