LLVM 20.0.0git
EPCDynamicLibrarySearchGenerator.cpp
Go to the documentation of this file.
1//===---------------- EPCDynamicLibrarySearchGenerator.cpp ----------------===//
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
10
13#include "llvm/Support/Error.h"
14
15#define DEBUG_TYPE "orc"
16
17namespace llvm {
18namespace orc {
19
20Expected<std::unique_ptr<EPCDynamicLibrarySearchGenerator>>
22 ExecutionSession &ES, const char *LibraryPath, SymbolPredicate Allow,
23 AddAbsoluteSymbolsFn AddAbsoluteSymbols) {
24 auto Handle =
26 if (!Handle)
27 return Handle.takeError();
28
29 return std::make_unique<EPCDynamicLibrarySearchGenerator>(
30 ES, *Handle, std::move(Allow), std::move(AddAbsoluteSymbols));
31}
32
35 JITDylibLookupFlags JDLookupFlags, const SymbolLookupSet &Symbols) {
36
37 if (Symbols.empty())
38 return Error::success();
39
41 dbgs() << "EPCDynamicLibrarySearchGenerator trying to generate "
42 << Symbols << "\n";
43 });
44
45 SymbolLookupSet LookupSymbols;
46
47 for (auto &KV : Symbols) {
48 // Skip symbols that don't match the filter.
49 if (Allow && !Allow(KV.first))
50 continue;
51 LookupSymbols.add(KV.first, SymbolLookupFlags::WeaklyReferencedSymbol);
52 }
53
54 DylibManager::LookupRequest Request(H, LookupSymbols);
55 // Copy-capture LookupSymbols, since LookupRequest keeps a reference.
56 EPC.getDylibMgr().lookupSymbolsAsync(Request, [this, &JD, LS = std::move(LS),
57 LookupSymbols](
58 auto Result) mutable {
59 if (!Result) {
61 dbgs() << "EPCDynamicLibrarySearchGenerator lookup failed due to error";
62 });
63 return LS.continueLookup(Result.takeError());
64 }
65
66 assert(Result->size() == 1 && "Results for more than one library returned");
67 assert(Result->front().size() == LookupSymbols.size() &&
68 "Result has incorrect number of elements");
69
70 SymbolMap NewSymbols;
71 auto ResultI = Result->front().begin();
72 for (auto &KV : LookupSymbols) {
73 if (ResultI->getAddress())
74 NewSymbols[KV.first] = *ResultI;
75 ++ResultI;
76 }
77
79 dbgs() << "EPCDynamicLibrarySearchGenerator lookup returned "
80 << NewSymbols << "\n";
81 });
82
83 // If there were no resolved symbols bail out.
84 if (NewSymbols.empty())
85 return LS.continueLookup(Error::success());
86
87 // Define resolved symbols.
88 Error Err = AddAbsoluteSymbols
89 ? AddAbsoluteSymbols(JD, std::move(NewSymbols))
90 : JD.define(absoluteSymbols(std::move(NewSymbols)));
91
92 LS.continueLookup(std::move(Err));
93 });
94
95 return Error::success();
96}
97
98} // end namespace orc
99} // end namespace llvm
#define LLVM_DEBUG(...)
Definition: Debug.h:106
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
bool empty() const
Definition: DenseMap.h:98
Lightweight error class with error context and mandatory checking.
Definition: Error.h:160
static ErrorSuccess success()
Create a success value.
Definition: Error.h:337
virtual void lookupSymbolsAsync(ArrayRef< LookupRequest > Request, SymbolLookupCompleteFn F)=0
Search for symbols in the target process.
virtual Expected< tpctypes::DylibHandle > loadDylib(const char *DylibPath)=0
Load the dynamic library at the given path and return a handle to it.
static Expected< std::unique_ptr< EPCDynamicLibrarySearchGenerator > > Load(ExecutionSession &ES, const char *LibraryPath, SymbolPredicate Allow=SymbolPredicate(), AddAbsoluteSymbolsFn AddAbsoluteSymbols=nullptr)
Permanently loads the library at the given path and, on success, returns a DynamicLibrarySearchGenera...
Error tryToGenerate(LookupState &LS, LookupKind K, JITDylib &JD, JITDylibLookupFlags JDLookupFlags, const SymbolLookupSet &Symbols) override
DefinitionGenerators should override this method to insert new definitions into the parent JITDylib.
An ExecutionSession represents a running JIT program.
Definition: Core.h:1339
ExecutorProcessControl & getExecutorProcessControl()
Get the ExecutorProcessControl object associated with this ExecutionSession.
Definition: Core.h:1379
DylibManager & getDylibMgr() const
Return the DylibManager for the target process.
Represents a JIT'd dynamic library.
Definition: Core.h:897
Error define(std::unique_ptr< MaterializationUnitType > &&MU, ResourceTrackerSP RT=nullptr)
Define all symbols provided by the materialization unit to be part of this JITDylib.
Definition: Core.h:1822
Wraps state for a lookup-in-progress.
Definition: Core.h:829
A set of symbols to look up, each associated with a SymbolLookupFlags value.
Definition: Core.h:194
SymbolLookupSet & add(SymbolStringPtr Name, SymbolLookupFlags Flags=SymbolLookupFlags::RequiredSymbol)
Add an element to the set.
Definition: Core.h:260
std::unique_ptr< AbsoluteSymbolsMaterializationUnit > absoluteSymbols(SymbolMap Symbols)
Create an AbsoluteSymbolsMaterializationUnit with the given symbols.
JITDylibLookupFlags
Lookup flags that apply to each dylib in the search order for a lookup.
Definition: Core.h:146
LookupKind
Describes the kind of lookup being performed.
Definition: Core.h:168
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
raw_ostream & dbgs()
dbgs() - This returns a reference to a raw_ostream for debugging messages.
Definition: Debug.cpp:163
A pair of a dylib and a set of symbols to be looked up.
Definition: DylibManager.h:31