forked from OSchip/llvm-project
[ORC] Update comments in RTDyldObjectLinkingLayer to refer to singular objects
rather than object sets. llvm-svn: 312423
This commit is contained in:
parent
619b759a57
commit
b3942ac521
|
@ -41,9 +41,9 @@ public:
|
|||
|
||||
protected:
|
||||
|
||||
/// @brief Holds a set of objects to be allocated/linked as a unit in the JIT.
|
||||
/// @brief Holds an object to be allocated/linked as a unit in the JIT.
|
||||
///
|
||||
/// An instance of this class will be created for each set of objects added
|
||||
/// An instance of this class will be created for each object added
|
||||
/// via JITObjectLayer::addObject. Deleting the instance (via
|
||||
/// removeObject) frees its memory, removing all symbol definitions that
|
||||
/// had been provided by this instance. Higher level layers are responsible
|
||||
|
@ -83,7 +83,7 @@ protected:
|
|||
using LinkedObjectListT = std::list<std::unique_ptr<LinkedObject>>;
|
||||
|
||||
public:
|
||||
/// @brief Handle to a set of loaded objects.
|
||||
/// @brief Handle to a loaded object.
|
||||
using ObjHandleT = LinkedObjectListT::iterator;
|
||||
};
|
||||
|
||||
|
@ -253,10 +253,9 @@ public:
|
|||
this->ProcessAllSections = ProcessAllSections;
|
||||
}
|
||||
|
||||
/// @brief Add a set of objects (or archives) that will be treated as a unit
|
||||
/// for the purposes of symbol lookup and memory management.
|
||||
/// @brief Add an object to the JIT.
|
||||
///
|
||||
/// @return A handle that can be used to refer to the loaded objects (for
|
||||
/// @return A handle that can be used to refer to the loaded object (for
|
||||
/// symbol searching, finalization, freeing memory, etc.).
|
||||
Expected<ObjHandleT> addObject(ObjectPtr Obj,
|
||||
std::shared_ptr<JITSymbolResolver> Resolver) {
|
||||
|
@ -291,10 +290,10 @@ public:
|
|||
return Handle;
|
||||
}
|
||||
|
||||
/// @brief Remove the set of objects associated with handle H.
|
||||
/// @brief Remove the object associated with handle H.
|
||||
///
|
||||
/// All memory allocated for the objects will be freed, and the sections and
|
||||
/// symbols they provided will no longer be available. No attempt is made to
|
||||
/// All memory allocated for the object will be freed, and the sections and
|
||||
/// symbols it provided will no longer be available. No attempt is made to
|
||||
/// re-emit the missing symbols, and any use of these symbols (directly or
|
||||
/// indirectly) will result in undefined behavior. If dependence tracking is
|
||||
/// required to detect or resolve such issues it should be added at a higher
|
||||
|
@ -318,27 +317,27 @@ public:
|
|||
return nullptr;
|
||||
}
|
||||
|
||||
/// @brief Search for the given named symbol in the context of the set of
|
||||
/// loaded objects represented by the handle H.
|
||||
/// @param H The handle for the object set to search in.
|
||||
/// @brief Search for the given named symbol in the context of the loaded
|
||||
/// object represented by the handle H.
|
||||
/// @param H The handle for the object to search in.
|
||||
/// @param Name The name of the symbol to search for.
|
||||
/// @param ExportedSymbolsOnly If true, search only for exported symbols.
|
||||
/// @return A handle for the given named symbol, if it is found in the
|
||||
/// given object set.
|
||||
/// given object.
|
||||
JITSymbol findSymbolIn(ObjHandleT H, StringRef Name,
|
||||
bool ExportedSymbolsOnly) {
|
||||
return (*H)->getSymbol(Name, ExportedSymbolsOnly);
|
||||
}
|
||||
|
||||
/// @brief Map section addresses for the objects associated with the handle H.
|
||||
/// @brief Map section addresses for the object associated with the handle H.
|
||||
void mapSectionAddress(ObjHandleT H, const void *LocalAddress,
|
||||
JITTargetAddress TargetAddr) {
|
||||
(*H)->mapSectionAddress(LocalAddress, TargetAddr);
|
||||
}
|
||||
|
||||
/// @brief Immediately emit and finalize the object set represented by the
|
||||
/// given handle.
|
||||
/// @param H Handle for object set to emit/finalize.
|
||||
/// @brief Immediately emit and finalize the object represented by the given
|
||||
/// handle.
|
||||
/// @param H Handle for object to emit/finalize.
|
||||
Error emitAndFinalize(ObjHandleT H) {
|
||||
(*H)->finalize();
|
||||
return Error::success();
|
||||
|
|
Loading…
Reference in New Issue