LLVM 17.0.0git
X86.h
Go to the documentation of this file.
1//===-- X86.h - Top-level interface for X86 representation ------*- C++ -*-===//
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//
9// This file contains the entry points for global functions defined in the x86
10// target library, as used by the LLVM JIT.
11//
12//===----------------------------------------------------------------------===//
13
14#ifndef LLVM_LIB_TARGET_X86_X86_H
15#define LLVM_LIB_TARGET_X86_X86_H
16
18
19namespace llvm {
20
21class FunctionPass;
22class InstructionSelector;
23class PassRegistry;
24class X86RegisterBankInfo;
25class X86Subtarget;
26class X86TargetMachine;
27
28/// This pass converts a legalized DAG into a X86-specific DAG, ready for
29/// instruction scheduling.
30FunctionPass *createX86ISelDag(X86TargetMachine &TM,
31 CodeGenOpt::Level OptLevel);
32
33/// This pass initializes a global base register for PIC on x86-32.
34FunctionPass *createX86GlobalBaseRegPass();
35
36/// This pass combines multiple accesses to local-dynamic TLS variables so that
37/// the TLS base address for the module is only fetched once per execution path
38/// through the function.
40
41/// This function returns a pass which converts floating-point register
42/// references and pseudo instructions into floating-point stack references and
43/// physical instructions.
45
46/// This pass inserts AVX vzeroupper instructions before each call to avoid
47/// transition penalty between functions encoded with AVX and SSE.
48FunctionPass *createX86IssueVZeroUpperPass();
49
50/// This pass inserts ENDBR instructions before indirect jump/call
51/// destinations as part of CET IBT mechanism.
53
54/// Return a pass that pads short functions with NOOPs.
55/// This will prevent a stall when returning on the Atom.
56FunctionPass *createX86PadShortFunctions();
57
58/// Return a pass that selectively replaces certain instructions (like add,
59/// sub, inc, dec, some shifts, and some multiplies) by equivalent LEA
60/// instructions, in order to eliminate execution delays in some processors.
61FunctionPass *createX86FixupLEAs();
62
63/// Return a pass that replaces equivalent slower instructions with faster
64/// ones.
65FunctionPass *createX86FixupInstTuning();
66
67/// Return a pass that reduces the size of vector constant pool loads.
68FunctionPass *createX86FixupVectorConstants();
69
70/// Return a pass that removes redundant LEA instructions and redundant address
71/// recalculations.
72FunctionPass *createX86OptimizeLEAs();
73
74/// Return a pass that transforms setcc + movzx pairs into xor + setcc.
75FunctionPass *createX86FixupSetCC();
76
77/// Return a pass that avoids creating store forward block issues in the hardware.
79
80/// Return a pass that lowers EFLAGS copy pseudo instructions.
81FunctionPass *createX86FlagsCopyLoweringPass();
82
83/// Return a pass that expands DynAlloca pseudo-instructions.
84FunctionPass *createX86DynAllocaExpander();
85
86/// Return a pass that config the tile registers.
87FunctionPass *createX86TileConfigPass();
88
89/// Return a pass that preconfig the tile registers before fast reg allocation.
90FunctionPass *createX86FastPreTileConfigPass();
91
92/// Return a pass that config the tile registers after fast reg allocation.
93FunctionPass *createX86FastTileConfigPass();
94
95/// Return a pass that insert pseudo tile config instruction.
96FunctionPass *createX86PreTileConfigPass();
97
98/// Return a pass that lower the tile copy instruction.
99FunctionPass *createX86LowerTileCopyPass();
100
101/// Return a pass that inserts int3 at the end of the function if it ends with a
102/// CALL instruction. The pass does the same for each funclet as well. This
103/// ensures that the open interval of function start and end PCs contains all
104/// return addresses for the benefit of the Windows x64 unwinder.
105FunctionPass *createX86AvoidTrailingCallPass();
106
107/// Return a pass that optimizes the code-size of x86 call sequences. This is
108/// done by replacing esp-relative movs with pushes.
109FunctionPass *createX86CallFrameOptimization();
110
111/// Return an IR pass that inserts EH registration stack objects and explicit
112/// EH state updates. This pass must run after EH preparation, which does
113/// Windows-specific but architecture-neutral preparation.
114FunctionPass *createX86WinEHStatePass();
115
116/// Return a Machine IR pass that expands X86-specific pseudo
117/// instructions into a sequence of actual instructions. This pass
118/// must run after prologue/epilogue insertion and before lowering
119/// the MachineInstr to MC.
120FunctionPass *createX86ExpandPseudoPass();
121
122/// This pass converts X86 cmov instructions into branch when profitable.
123FunctionPass *createX86CmovConverterPass();
124
125/// Return a Machine IR pass that selectively replaces
126/// certain byte and word instructions by equivalent 32 bit instructions,
127/// in order to eliminate partial register usage, false dependences on
128/// the upper portions of registers, and to save code size.
129FunctionPass *createX86FixupBWInsts();
130
131/// Return a Machine IR pass that reassigns instruction chains from one domain
132/// to another, when profitable.
134
135/// This pass replaces EVEX encoded of AVX-512 instructiosn by VEX
136/// encoding when possible in order to reduce code size.
138
139/// This pass creates the thunks for the retpoline feature.
141
142/// This pass replaces ret instructions with jmp's to __x86_return thunk.
144
145/// This pass ensures instructions featuring a memory operand
146/// have distinctive <LineNumber, Discriminator> (with respect to eachother)
148
149/// This pass applies profiling information to insert cache prefetches.
151
152/// This pass insert wait instruction after X87 instructions which could raise
153/// fp exceptions when strict-fp enabled.
155
156/// This pass optimizes arithmetic based on knowledge that is only used by
157/// a reduction sequence and is therefore safe to reassociate in interesting
158/// ways.
160
162 X86Subtarget &,
164
170
204
205namespace X86AS {
206enum : unsigned {
207 GS = 256,
208 FS = 257,
209 SS = 258,
212 PTR64 = 272
214} // End X86AS namespace
215
216} // End llvm namespace
217
218#endif
const char LLVMTargetMachineRef TM
FunctionPass class - This class is used to implement most global optimizations.
Definition: Pass.h:311
Provides the logic to select generic machine instructions.
PassRegistry - This class manages the registration and intitialization of the pass subsystem as appli...
Definition: PassRegistry.h:37
This class provides the information for the target register banks.
Level
Code generation optimization level.
Definition: CodeGen.h:57
@ SS
Definition: X86.h:209
@ PTR32_UPTR
Definition: X86.h:211
@ FS
Definition: X86.h:208
@ PTR64
Definition: X86.h:212
@ PTR32_SPTR
Definition: X86.h:210
@ GS
Definition: X86.h:207
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
FunctionPass * createX86FloatingPointStackifierPass()
This function returns a pass which converts floating-point register references and pseudo instruction...
FunctionPass * createX86ISelDag(X86TargetMachine &TM, CodeGenOpt::Level OptLevel)
This pass converts a legalized DAG into a X86-specific DAG, ready for instruction scheduling.
FunctionPass * createX86WinEHStatePass()
Return an IR pass that inserts EH registration stack objects and explicit EH state updates.
void initializeX86TileConfigPass(PassRegistry &)
void initializeX86PartialReductionPass(PassRegistry &)
void initializeX86CallFrameOptimizationPass(PassRegistry &)
void initializeFixupBWInstPassPass(PassRegistry &)
void initializeX86LoadValueInjectionRetHardeningPassPass(PassRegistry &)
FunctionPass * createX86LoadValueInjectionLoadHardeningPass()
FunctionPass * createX86IssueVZeroUpperPass()
This pass inserts AVX vzeroupper instructions before each call to avoid transition penalty between fu...
void initializeX86ArgumentStackSlotPassPass(PassRegistry &)
void initializeX86SpeculativeLoadHardeningPassPass(PassRegistry &)
void initializeWinEHStatePassPass(PassRegistry &)
FunctionPass * createX86InsertPrefetchPass()
This pass applies profiling information to insert cache prefetches.
FunctionPass * createX86GlobalBaseRegPass()
This pass initializes a global base register for PIC on x86-32.
FunctionPass * createX86FixupBWInsts()
Return a Machine IR pass that selectively replaces certain byte and word instructions by equivalent 3...
void initializeX86LowerAMXIntrinsicsLegacyPassPass(PassRegistry &)
FunctionPass * createX86DomainReassignmentPass()
Return a Machine IR pass that reassigns instruction chains from one domain to another,...
FunctionPass * createX86LoadValueInjectionRetHardeningPass()
FunctionPass * createX86SpeculativeExecutionSideEffectSuppression()
FunctionPass * createCleanupLocalDynamicTLSPass()
This pass combines multiple accesses to local-dynamic TLS variables so that the TLS base address for ...
FunctionPass * createX86FlagsCopyLoweringPass()
Return a pass that lowers EFLAGS copy pseudo instructions.
void initializeX86FastTileConfigPass(PassRegistry &)
InstructionSelector * createX86InstructionSelector(const X86TargetMachine &TM, X86Subtarget &, X86RegisterBankInfo &)
FunctionPass * createX86EvexToVexInsts()
This pass replaces EVEX encoded of AVX-512 instructiosn by VEX encoding when possible in order to red...
void initializeX86ExpandPseudoPass(PassRegistry &)
void initializeX86AvoidTrailingCallPassPass(PassRegistry &)
FunctionPass * createX86ArgumentStackSlotPass()
void initializeX86PreTileConfigPass(PassRegistry &)
FunctionPass * createX86CmovConverterPass()
This pass converts X86 cmov instructions into branch when profitable.
FunctionPass * createX86TileConfigPass()
Return a pass that config the tile registers.
FunctionPass * createX86PadShortFunctions()
Return a pass that pads short functions with NOOPs.
void initializeX86DomainReassignmentPass(PassRegistry &)
void initializeX86LoadValueInjectionLoadHardeningPassPass(PassRegistry &)
FunctionPass * createX86FastPreTileConfigPass()
Return a pass that preconfig the tile registers before fast reg allocation.
void initializeX86AvoidSFBPassPass(PassRegistry &)
FunctionPass * createX86LowerTileCopyPass()
Return a pass that lower the tile copy instruction.
void initializeX86FastPreTileConfigPass(PassRegistry &)
FunctionPass * createX86SpeculativeLoadHardeningPass()
FunctionPass * createX86FixupSetCC()
Return a pass that transforms setcc + movzx pairs into xor + setcc.
FunctionPass * createX86IndirectBranchTrackingPass()
This pass inserts ENDBR instructions before indirect jump/call destinations as part of CET IBT mechan...
FunctionPass * createX86InsertX87waitPass()
This pass insert wait instruction after X87 instructions which could raise fp exceptions when strict-...
void initializeX86FixupSetCCPassPass(PassRegistry &)
FunctionPass * createX86ExpandPseudoPass()
Return a Machine IR pass that expands X86-specific pseudo instructions into a sequence of actual inst...
void initializeEvexToVexInstPassPass(PassRegistry &)
FunctionPass * createX86FixupInstTuning()
Return a pass that replaces equivalent slower instructions with faster ones.
void initializeX86LowerTileCopyPass(PassRegistry &)
void initializeX86OptimizeLEAPassPass(PassRegistry &)
void initializeX86PreAMXConfigPassPass(PassRegistry &)
FunctionPass * createX86FastTileConfigPass()
Return a pass that config the tile registers after fast reg allocation.
FunctionPass * createX86PartialReductionPass()
This pass optimizes arithmetic based on knowledge that is only used by a reduction sequence and is th...
FunctionPass * createX86FixupLEAs()
Return a pass that selectively replaces certain instructions (like add, sub, inc, dec,...
void initializeX86FixupInstTuningPassPass(PassRegistry &)
void initializeX86LowerAMXTypeLegacyPassPass(PassRegistry &)
void initializeX86CmovConverterPassPass(PassRegistry &)
FunctionPass * createX86CallFrameOptimization()
Return a pass that optimizes the code-size of x86 call sequences.
void initializeX86FlagsCopyLoweringPassPass(PassRegistry &)
void initializeFPSPass(PassRegistry &)
FunctionPass * createX86AvoidTrailingCallPass()
Return a pass that inserts int3 at the end of the function if it ends with a CALL instruction.
FunctionPass * createX86DynAllocaExpander()
Return a pass that expands DynAlloca pseudo-instructions.
void initializeX86SpeculativeExecutionSideEffectSuppressionPass(PassRegistry &)
FunctionPass * createX86OptimizeLEAs()
Return a pass that removes redundant LEA instructions and redundant address recalculations.
void initializeX86FixupVectorConstantsPassPass(PassRegistry &)
FunctionPass * createX86IndirectThunksPass()
This pass creates the thunks for the retpoline feature.
void initializeX86DAGToDAGISelPass(PassRegistry &)
FunctionPass * createX86FixupVectorConstants()
Return a pass that reduces the size of vector constant pool loads.
void initializeX86ExecutionDomainFixPass(PassRegistry &)
FunctionPass * createX86PreTileConfigPass()
Return a pass that insert pseudo tile config instruction.
FunctionPass * createX86ReturnThunksPass()
This pass replaces ret instructions with jmp's to __x86_return thunk.
FunctionPass * createX86AvoidStoreForwardingBlocks()
Return a pass that avoids creating store forward block issues in the hardware.
void initializeX86ReturnThunksPass(PassRegistry &)
FunctionPass * createX86DiscriminateMemOpsPass()
This pass ensures instructions featuring a memory operand have distinctive <LineNumber,...
void initializeFixupLEAPassPass(PassRegistry &)