LLVM  14.0.0git
Public Attributes | List of all members
llvm::jitlink::PassConfiguration Struct Reference

An LinkGraph pass configuration, consisting of a list of pre-prune, post-prune, and post-fixup passes. More...

#include "llvm/ExecutionEngine/JITLink/JITLink.h"

Collaboration diagram for llvm::jitlink::PassConfiguration:
Collaboration graph
[legend]

Public Attributes

LinkGraphPassList PrePrunePasses
 Pre-prune passes. More...
 
LinkGraphPassList PostPrunePasses
 Post-prune passes. More...
 
LinkGraphPassList PostAllocationPasses
 Post-allocation passes. More...
 
LinkGraphPassList PreFixupPasses
 Pre-fixup passes. More...
 
LinkGraphPassList PostFixupPasses
 Post-fixup passes. More...
 

Detailed Description

An LinkGraph pass configuration, consisting of a list of pre-prune, post-prune, and post-fixup passes.

Definition at line 1524 of file JITLink.h.

Member Data Documentation

◆ PostAllocationPasses

LinkGraphPassList llvm::jitlink::PassConfiguration::PostAllocationPasses

Post-allocation passes.

These passes are called on the graph after memory has been allocated and defined nodes have been assigned their final addresses, but before the context has been notified of these addresses. At this point externals have not been resolved, and symbol content has not yet been copied into working memory.

Notable use cases: Setting up data structures associated with addresses of defined symbols (e.g. a mapping of __dso_handle to JITDylib* for the JIT runtime) – using a PostAllocationPass for this ensures that the data structures are in-place before any query for resolved symbols can complete.

Definition at line 1555 of file JITLink.h.

Referenced by llvm::jitlink::link_ELF_x86_64(), and llvm::orc::DebugObjectManagerPlugin::modifyPassConfig().

◆ PostFixupPasses

LinkGraphPassList llvm::jitlink::PassConfiguration::PostFixupPasses

Post-fixup passes.

These passes are called on the graph after block contents has been copied to working memory, and fixups applied. Blocks have been updated to point to their fixed up content.

Notable use cases: Testing and validation.

Definition at line 1575 of file JITLink.h.

Referenced by llvm::orc::EHFrameRegistrationPlugin::modifyPassConfig().

◆ PostPrunePasses

LinkGraphPassList llvm::jitlink::PassConfiguration::PostPrunePasses

Post-prune passes.

These passes are called on the graph after dead stripping, but before memory is allocated or nodes assigned their final addresses.

Notable use cases: Building GOT, stub, and TLV symbols.

Definition at line 1540 of file JITLink.h.

Referenced by llvm::jitlink::link_ELF_riscv(), llvm::jitlink::link_ELF_x86_64(), llvm::jitlink::link_MachO_arm64(), llvm::jitlink::link_MachO_x86_64(), and llvm::orc::ObjectLinkingLayerJITLinkContext::modifyPassConfig().

◆ PreFixupPasses

LinkGraphPassList llvm::jitlink::PassConfiguration::PreFixupPasses

Pre-fixup passes.

These passes are called on the graph after memory has been allocated, content copied into working memory, and all nodes (including externals) have been assigned their final addresses, but before any fixups have been applied.

Notable use cases: Late link-time optimizations like GOT and stub elimination.

Definition at line 1566 of file JITLink.h.

Referenced by llvm::jitlink::link_ELF_x86_64(), and llvm::jitlink::link_MachO_x86_64().

◆ PrePrunePasses

LinkGraphPassList llvm::jitlink::PassConfiguration::PrePrunePasses

Pre-prune passes.

These passes are called on the graph after it is built, and before any symbols have been pruned. Graph nodes still have their original vmaddrs.

Notable use cases: Marking symbols live or should-discard.

Definition at line 1532 of file JITLink.h.

Referenced by llvm::jitlink::link_ELF_aarch64(), llvm::jitlink::link_ELF_riscv(), llvm::jitlink::link_ELF_x86_64(), llvm::jitlink::link_MachO_arm64(), llvm::jitlink::link_MachO_x86_64(), and llvm::orc::ObjectLinkingLayerJITLinkContext::modifyPassConfig().


The documentation for this struct was generated from the following file: