2019-09-06 01:30:52 +08:00
|
|
|
|
User Guides
|
|
|
|
|
===========
|
|
|
|
|
|
|
|
|
|
NOTE: If you are a user who is only interested in using an LLVM-based compiler,
|
2020-03-23 05:42:03 +08:00
|
|
|
|
you should look into `Clang <https://clang.llvm.org>`_ instead. The
|
2019-09-06 01:30:52 +08:00
|
|
|
|
documentation here is intended for users who have a need to work with the
|
|
|
|
|
intermediate LLVM representation.
|
|
|
|
|
|
2019-10-06 23:36:37 +08:00
|
|
|
|
.. contents::
|
|
|
|
|
:local:
|
|
|
|
|
|
2019-09-06 01:30:52 +08:00
|
|
|
|
.. toctree::
|
|
|
|
|
:hidden:
|
|
|
|
|
|
2019-10-07 06:49:22 +08:00
|
|
|
|
AddingConstrainedIntrinsics
|
|
|
|
|
AdvancedBuilds
|
|
|
|
|
AliasAnalysis
|
|
|
|
|
AMDGPUUsage
|
|
|
|
|
Benchmarking
|
|
|
|
|
BigEndianNEON
|
|
|
|
|
BuildingADistribution
|
2019-10-14 04:05:22 +08:00
|
|
|
|
CFIVerify
|
2019-09-06 01:30:52 +08:00
|
|
|
|
CMake
|
|
|
|
|
CMakePrimer
|
2019-10-07 06:49:22 +08:00
|
|
|
|
CodeGenerator
|
|
|
|
|
CodeOfConduct
|
|
|
|
|
CommandLine
|
|
|
|
|
CompileCudaWithLLVM
|
|
|
|
|
CoverageMappingFormat
|
2021-12-10 17:06:43 +08:00
|
|
|
|
CycleTerminology
|
2019-10-07 06:49:22 +08:00
|
|
|
|
DebuggingJITedCode
|
|
|
|
|
Docker
|
|
|
|
|
ExtendingLLVM
|
|
|
|
|
GoldPlugin
|
2019-09-06 01:30:52 +08:00
|
|
|
|
HowToBuildOnARM
|
|
|
|
|
HowToBuildWithPGO
|
2021-03-09 09:33:54 +08:00
|
|
|
|
HowToBuildWindowsItaniumPrograms
|
2019-09-06 01:30:52 +08:00
|
|
|
|
HowToCrossCompileBuiltinsOnArm
|
|
|
|
|
HowToCrossCompileLLVM
|
2020-05-16 08:13:18 +08:00
|
|
|
|
HowToUpdateDebugInfo
|
2019-10-07 06:49:22 +08:00
|
|
|
|
LinkTimeOptimization
|
|
|
|
|
LoopTerminology
|
2019-09-06 01:30:52 +08:00
|
|
|
|
MarkdownQuickstartTemplate
|
2019-10-10 05:09:09 +08:00
|
|
|
|
MemorySSA
|
2019-10-07 06:49:22 +08:00
|
|
|
|
MergeFunctions
|
|
|
|
|
MCJITDesignAndImplementation
|
2021-02-24 18:04:35 +08:00
|
|
|
|
ORCv2
|
2021-05-12 08:02:12 +08:00
|
|
|
|
OpaquePointers
|
2021-02-25 05:30:47 +08:00
|
|
|
|
JITLink
|
2021-02-26 09:21:35 +08:00
|
|
|
|
NewPassManager
|
2019-10-07 06:49:22 +08:00
|
|
|
|
NVPTXUsage
|
2019-09-06 01:30:52 +08:00
|
|
|
|
Phabricator
|
|
|
|
|
Passes
|
|
|
|
|
ReportingGuide
|
|
|
|
|
Remarks
|
2019-10-07 06:49:22 +08:00
|
|
|
|
SourceLevelDebugging
|
2019-10-10 05:09:09 +08:00
|
|
|
|
StackSafetyAnalysis
|
|
|
|
|
SupportLibrary
|
2019-10-07 06:49:22 +08:00
|
|
|
|
TableGen/index
|
|
|
|
|
TableGenFundamentals
|
|
|
|
|
Vectorizers
|
2019-10-06 23:36:37 +08:00
|
|
|
|
WritingAnLLVMPass
|
2020-09-01 09:36:11 +08:00
|
|
|
|
WritingAnLLVMNewPMPass
|
2019-10-06 23:36:37 +08:00
|
|
|
|
WritingAnLLVMBackend
|
2019-10-07 06:49:22 +08:00
|
|
|
|
yaml2obj
|
2019-09-06 01:30:52 +08:00
|
|
|
|
|
2019-09-28 03:12:00 +08:00
|
|
|
|
Clang
|
2019-10-06 23:36:37 +08:00
|
|
|
|
-----
|
2019-09-28 03:12:00 +08:00
|
|
|
|
|
2019-09-06 01:30:52 +08:00
|
|
|
|
:doc:`HowToBuildOnARM`
|
|
|
|
|
Notes on building and testing LLVM/Clang on ARM.
|
|
|
|
|
|
|
|
|
|
:doc:`HowToBuildWithPGO`
|
|
|
|
|
Notes on building LLVM/Clang with PGO.
|
|
|
|
|
|
|
|
|
|
:doc:`HowToCrossCompileLLVM`
|
|
|
|
|
Notes on cross-building and testing LLVM/Clang.
|
|
|
|
|
|
2019-09-28 03:12:00 +08:00
|
|
|
|
`How to build the C, C++, ObjC, and ObjC++ front end`__
|
|
|
|
|
Instructions for building the clang front-end from source.
|
|
|
|
|
|
2020-03-23 05:42:03 +08:00
|
|
|
|
.. __: https://clang.llvm.org/get_started.html
|
2019-09-28 03:12:00 +08:00
|
|
|
|
|
2019-10-07 06:49:22 +08:00
|
|
|
|
:doc:`CoverageMappingFormat`
|
|
|
|
|
This describes the format and encoding used for LLVM’s code coverage mapping.
|
|
|
|
|
|
2019-10-14 04:05:22 +08:00
|
|
|
|
:doc:`CFIVerify`
|
|
|
|
|
A description of the verification tool for Control Flow Integrity.
|
|
|
|
|
|
2019-10-06 23:36:37 +08:00
|
|
|
|
LLVM Builds and Distributions
|
|
|
|
|
-----------------------------
|
|
|
|
|
|
|
|
|
|
:doc:`BuildingADistribution`
|
|
|
|
|
A best-practices guide for using LLVM's CMake build system to package and
|
|
|
|
|
distribute LLVM-based tools.
|
|
|
|
|
|
|
|
|
|
:doc:`CMake`
|
|
|
|
|
An addendum to the main Getting Started guide for those using the `CMake
|
|
|
|
|
build system <http://www.cmake.org>`_.
|
2019-09-28 03:12:00 +08:00
|
|
|
|
|
|
|
|
|
:doc:`Docker`
|
|
|
|
|
A reference for using Dockerfiles provided with LLVM.
|
|
|
|
|
|
2019-10-10 05:09:09 +08:00
|
|
|
|
:doc:`Support Library <SupportLibrary>`
|
|
|
|
|
This document describes the LLVM Support Library (``lib/Support``) and
|
2020-06-02 08:09:40 +08:00
|
|
|
|
how to keep LLVM source code portable.
|
|
|
|
|
|
|
|
|
|
:doc:`AdvancedBuilds`
|
|
|
|
|
This document describes more advanced build configurations.
|
2019-10-10 05:09:09 +08:00
|
|
|
|
|
2019-10-06 23:36:37 +08:00
|
|
|
|
Optimizations
|
|
|
|
|
-------------
|
2019-09-28 03:12:00 +08:00
|
|
|
|
|
2019-10-06 23:36:37 +08:00
|
|
|
|
:doc:`WritingAnLLVMPass`
|
|
|
|
|
Information on how to write LLVM transformations and analyses.
|
2019-09-28 03:12:00 +08:00
|
|
|
|
|
2020-09-01 09:36:11 +08:00
|
|
|
|
:doc:`WritingAnLLVMNewPMPass`
|
|
|
|
|
Information on how to write LLVM transformations under the new pass
|
|
|
|
|
manager.
|
|
|
|
|
|
2019-09-06 01:30:52 +08:00
|
|
|
|
:doc:`Passes`
|
|
|
|
|
A list of optimizations and analyses implemented in LLVM.
|
|
|
|
|
|
2019-10-07 06:49:22 +08:00
|
|
|
|
:doc:`StackSafetyAnalysis`
|
|
|
|
|
This document describes the design of the stack safety analysis of local
|
|
|
|
|
variables.
|
|
|
|
|
|
|
|
|
|
:doc:`MergeFunctions`
|
|
|
|
|
Describes functions merging optimization.
|
|
|
|
|
|
|
|
|
|
:doc:`AliasAnalysis`
|
|
|
|
|
Information on how to write a new alias analysis implementation or how to
|
|
|
|
|
use existing analyses.
|
|
|
|
|
|
2019-10-10 05:09:09 +08:00
|
|
|
|
:doc:`MemorySSA`
|
|
|
|
|
Information about the MemorySSA utility in LLVM, as well as how to use it.
|
|
|
|
|
|
2019-10-06 23:36:37 +08:00
|
|
|
|
:doc:`LoopTerminology`
|
|
|
|
|
A document describing Loops and associated terms as used in LLVM.
|
2019-09-06 01:30:52 +08:00
|
|
|
|
|
2021-12-10 17:06:43 +08:00
|
|
|
|
:doc:`CycleTerminology`
|
|
|
|
|
A document describing cycles as a generalization of loops.
|
|
|
|
|
|
2019-10-07 06:49:22 +08:00
|
|
|
|
:doc:`Vectorizers`
|
|
|
|
|
This document describes the current status of vectorization in LLVM.
|
|
|
|
|
|
|
|
|
|
:doc:`LinkTimeOptimization`
|
|
|
|
|
This document describes the interface between LLVM intermodular optimizer
|
|
|
|
|
and the linker and its design
|
|
|
|
|
|
|
|
|
|
:doc:`GoldPlugin`
|
|
|
|
|
How to build your programs with link-time optimization on Linux.
|
|
|
|
|
|
2019-10-06 23:36:37 +08:00
|
|
|
|
:doc:`Remarks`
|
|
|
|
|
A reference on the implementation of remarks in LLVM.
|
2019-09-06 01:30:52 +08:00
|
|
|
|
|
2019-10-07 06:49:22 +08:00
|
|
|
|
:doc:`Source Level Debugging with LLVM <SourceLevelDebugging>`
|
|
|
|
|
This document describes the design and philosophy behind the LLVM
|
|
|
|
|
source-level debugger.
|
|
|
|
|
|
2019-10-06 23:36:37 +08:00
|
|
|
|
Code Generation
|
|
|
|
|
---------------
|
2019-09-06 01:30:52 +08:00
|
|
|
|
|
2019-10-06 23:36:37 +08:00
|
|
|
|
:doc:`WritingAnLLVMBackend`
|
|
|
|
|
Information on how to write LLVM backends for machine targets.
|
2019-09-06 01:30:52 +08:00
|
|
|
|
|
2019-10-06 23:36:37 +08:00
|
|
|
|
:doc:`CodeGenerator`
|
|
|
|
|
The design and implementation of the LLVM code generator. Useful if you are
|
|
|
|
|
working on retargetting LLVM to a new architecture, designing a new codegen
|
|
|
|
|
pass, or enhancing existing components.
|
|
|
|
|
|
|
|
|
|
:doc:`TableGen <TableGen/index>`
|
|
|
|
|
Describes the TableGen tool, which is used heavily by the LLVM code
|
|
|
|
|
generator.
|
|
|
|
|
|
2019-10-07 06:49:22 +08:00
|
|
|
|
===
|
|
|
|
|
JIT
|
|
|
|
|
===
|
|
|
|
|
|
|
|
|
|
:doc:`MCJITDesignAndImplementation`
|
|
|
|
|
Describes the inner workings of MCJIT execution engine.
|
|
|
|
|
|
2021-02-24 18:04:35 +08:00
|
|
|
|
:doc:`ORCv2`
|
|
|
|
|
Describes the design and implementation of the ORC APIs, including some
|
|
|
|
|
usage examples, and a guide for users transitioning from ORCv1 to ORCv2.
|
|
|
|
|
|
2021-02-25 05:30:47 +08:00
|
|
|
|
:doc:`JITLink`
|
|
|
|
|
Describes the design and APIs for the JITLink library, ORC's new JIT
|
|
|
|
|
linker.
|
|
|
|
|
|
2019-10-07 06:49:22 +08:00
|
|
|
|
:doc:`DebuggingJITedCode`
|
|
|
|
|
How to debug JITed code with GDB.
|
|
|
|
|
|
2019-10-06 23:36:37 +08:00
|
|
|
|
Additional Topics
|
|
|
|
|
-----------------
|
|
|
|
|
|
2019-10-07 00:10:11 +08:00
|
|
|
|
:doc:`CommandLine`
|
|
|
|
|
Provides information on using the command line parsing library.
|
|
|
|
|
|
|
|
|
|
:doc:`ExtendingLLVM`
|
|
|
|
|
Look here to see how to add instructions and intrinsics to LLVM.
|
|
|
|
|
|
2019-10-07 06:49:22 +08:00
|
|
|
|
:doc:`AddingConstrainedIntrinsics`
|
|
|
|
|
Gives the steps necessary when adding a new constrained math intrinsic
|
|
|
|
|
to LLVM.
|
|
|
|
|
|
2021-03-09 09:33:54 +08:00
|
|
|
|
:doc:`HowToBuildWindowsItaniumPrograms`
|
2021-09-01 03:30:22 +08:00
|
|
|
|
Notes on assembling a Windows Itanium environment.
|
2021-03-09 09:33:54 +08:00
|
|
|
|
|
2019-10-06 23:36:37 +08:00
|
|
|
|
:doc:`HowToCrossCompileBuiltinsOnArm`
|
|
|
|
|
Notes on cross-building and testing the compiler-rt builtins for Arm.
|
|
|
|
|
|
2019-10-07 06:49:22 +08:00
|
|
|
|
:doc:`BigEndianNEON`
|
|
|
|
|
LLVM's support for generating NEON instructions on big endian ARM targets is
|
|
|
|
|
somewhat nonintuitive. This document explains the implementation and rationale.
|
|
|
|
|
|
|
|
|
|
:doc:`CompileCudaWithLLVM`
|
|
|
|
|
LLVM support for CUDA.
|
|
|
|
|
|
2019-10-06 23:36:37 +08:00
|
|
|
|
:doc:`NVPTXUsage`
|
|
|
|
|
This document describes using the NVPTX backend to compile GPU kernels.
|
|
|
|
|
|
|
|
|
|
:doc:`AMDGPUUsage`
|
2020-04-14 12:55:43 +08:00
|
|
|
|
This document describes using the AMDGPU backend to compile GPU kernels.
|
|
|
|
|
|
2020-07-30 13:10:21 +08:00
|
|
|
|
:doc:`AMDGPUDwarfExtensionsForHeterogeneousDebugging`
|
|
|
|
|
This document describes DWARF extensions to support heterogeneous debugging
|
2020-05-16 08:13:18 +08:00
|
|
|
|
for targets such as the AMDGPU backend.
|
2021-12-12 07:43:54 +08:00
|
|
|
|
|
|
|
|
|
:doc:`AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack`
|
|
|
|
|
This document describes a DWARF extension to allow location descriptions on
|
|
|
|
|
the DWARF expression stack. It is part of
|
|
|
|
|
:doc:`AMDGPUDwarfExtensionsForHeterogeneousDebugging`.
|