mirrors/llvm-project
0
0
Fork 0
mirror of https://github.com/llvm/llvm-project.git synced 2025-04-24 15:06:06 +00:00
Code Issues Projects Releases Wiki Activity

[docs] Re-generate ClangCommandLineReference.rst

Browse Source
This commit is contained in:
Fangrui Song 2022-05-16 10:34:01 -07:00
parent 5f7ef65245
commit babbd96f23
1 changed files with 194 additions and 110 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

304
clang/docs/ClangCommandLineReference.rst
View File

@ -76,16 +76,6 @@ Pass <arg> to fatbinary invocation
Pass <arg> to the ptxas assembler
.. option:: -Xopenmp-target <arg>
Pass <arg> to the target offloading toolchain.
.. program:: clang1
.. option:: -Xopenmp-target=<triple> <arg>
.. program:: clang
Pass <arg> to the target offloading toolchain identified by <triple>.
.. option:: -Z<arg>
.. option:: -a<arg>, --profile-blocks
@ -142,17 +132,9 @@ Specifies configuration file
.. option:: --constant-cfstrings
.. option:: --cuda-compile-host-device
.. option:: --cuda-feature=<arg>
Compile CUDA code for both host and device (default). Has no effect on non-CUDA compilations.
.. option:: --cuda-device-only
Compile CUDA code for device only
.. option:: --cuda-host-only
Compile CUDA code for host only. Has no effect on non-CUDA compilations.
Manually specify the CUDA feature to use
.. option:: --cuda-include-ptx=<arg>, --no-cuda-include-ptx=<arg>
@ -168,6 +150,14 @@ An ID for compilation unit, which should be the same for the same compilation un
.. option:: -current\_version<arg>
.. option:: -darwin-target-variant <arg>
Generate code for an additional runtime variant of the deployment target
.. option:: -darwin-target-variant-triple <arg>
Specify the darwin target variant triple
.. option:: -dead\_strip
.. option:: -dependency-dot <arg>
@ -226,6 +216,10 @@ Start emitting warnings for unused driver arguments
Reserve register r19 (Hexagon only)
.. option:: -fgpu-default-stream=<arg>
Specify default stream. The default value is 'legacy'. (HIP only). <arg> must be 'legacy' or 'per-thread'.
.. option:: -fgpu-flush-denormals-to-zero, -fcuda-flush-denormals-to-zero, -fno-gpu-flush-denormals-to-zero
Flush denormal floating point values to zero in CUDA/HIP device mode.
@ -238,22 +232,6 @@ Flush denormal floating point values to zero in CUDA/HIP device mode.
Specify comma-separated list of triples OpenMP offloading targets to be supported
.. option:: -fopenmp-new-driver, -fno-openmp-new-driver
Use the new driver for OpenMP offloading.
.. option:: --offload-new-driver, --no-offload-new-driver
Use the new driver for offloading compilation.
.. option:: --offload-host-only
Only compile for the host when offloading.
.. option:: --offload-device-only
Only compile for the device when offloading.
.. option:: -force\_cpusubtype\_ALL
.. program:: clang1
@ -313,7 +291,7 @@ Default max threads per block for kernel launch bounds for HIP
.. option:: -headerpad\_max\_install\_names<arg>
.. option:: -help, --help
.. option:: -help, --help, /help<arg>, -help<arg>, --help<arg>
Display available options
@ -355,10 +333,6 @@ Make the next included directory (-I or -F) an indexer header map
.. option:: -mbig-endian, -EB
.. option:: -mbranch-protection=<arg>
Enforce targets of indirect branches and function returns
.. option:: -menable-unsafe-fp-math
Allow unsafe floating-point math optimizations which may decrease precision
@ -381,6 +355,10 @@ Run the migrator
Additional arguments to forward to LLVM's option processing
.. option:: -mmlir <arg>
Additional arguments to forward to MLIR's option processing
.. option:: -module-dependency-dir <arg>
Directory to dump module dependencies to
@ -401,6 +379,10 @@ Directory to dump module dependencies to
Don't error out if the detected version of the CUDA install is too low for the requested CUDA gpu architecture.
.. option:: -no-hip-rt
Do not link against HIP runtime libraries
.. option:: -no-integrated-cpp, --no-integrated-cpp
.. option:: -no\_dead\_strip\_inits\_and\_terms
@ -411,6 +393,8 @@ Disable builtin #include directories
.. option:: -nodefaultlibs
.. option:: -nodriverkitlib
.. option:: -nofixprebinding
.. option:: -nogpuinc, -nocudainc
@ -449,7 +433,9 @@ Disable standard #include directories for the C++ standard library
.. option:: -nostdlibinc
.. option:: -o<file>, --output <arg>, --output=<arg>
.. program:: clang1
.. option:: -o<file>, /Fo<arg>, -Fo<arg>, --output <arg>, --output=<arg>
.. program:: clang
Write output to <file>
@ -527,6 +513,18 @@ Set the output <file> for debug infos
CUDA offloading device architecture (e.g. sm\_35), or HIP offloading target ID in the form of a device architecture followed by target ID features delimited by a colon. Each target ID feature is a pre-defined string followed by a plus or minus sign (e.g. gfx908:xnack+:sramecc-). May be specified more than once.
.. option:: --offload-device-only, --cuda-device-only
Only compile for the offloading device.
.. option:: --offload-host-device, --cuda-compile-host-device
Only compile for the offloading host.
.. option:: --offload-host-only, --cuda-host-only
Only compile for the offloading host.
.. option:: --offload=<arg1>,<arg2>...
Specify comma-separated list of offloading target triples (CUDA and HIP only)
@ -607,6 +605,8 @@ Print the registered targets
.. option:: -private\_bundle
.. option:: --product-name=<arg>
.. option:: -pthread, -no-pthread
Support POSIX threads in generated code
@ -703,7 +703,7 @@ Use the static host OpenMP runtime while linking.
.. option:: -stdlib=<arg>, --stdlib=<arg>, --stdlib <arg>
C++ standard library to use
C++ standard library to use. <arg> must be 'libc++', 'libstdc++' or 'platform'.
.. option:: -sub\_library<arg>
@ -741,7 +741,7 @@ Enable some traditional CPP emulation
.. option:: -unwindlib=<arg>, --unwindlib=<arg>
Unwind library to use
Unwind library to use. <arg> must be 'libgcc', 'unwindlib' or 'platform'.
.. option:: -v, --verbose
@ -849,6 +849,16 @@ Pass <arg> to the assembler
Pass <arg> to the clang compiler
.. option:: -Xopenmp-target <arg>
Pass <arg> to the target offloading toolchain.
.. program:: clang1
.. option:: -Xopenmp-target=<triple> <arg>
.. program:: clang
Pass <arg> to the target offloading toolchain identified by <triple>.
.. option:: -ansi, --ansi
.. option:: -fc++-abi=<arg>
@ -857,7 +867,7 @@ C++ ABI to use. This will override the target C++ ABI.
.. option:: -fclang-abi-compat=<version>
Attempt to match the ABI of Clang <version>
Attempt to match the ABI of Clang <version>. <version> must be '<major>.<minor>' or 'latest'.
.. option:: -fcomment-block-commands=<arg>,<arg2>...
@ -919,31 +929,37 @@ Inline suitable functions
Inline functions which are (explicitly or implicitly) marked inline
.. option:: -flegacy-pass-manager, -fno-legacy-pass-manager
Use the legacy pass manager in LLVM (deprecated, to be removed in a future release)
.. option:: -fno-crash-diagnostics
Disable auto-generation of preprocessed source files and a script for reproduction during a clang crash
.. option:: -fno-legacy-pass-manager, -fexperimental-new-pass-manager
.. option:: -fno-sanitize-ignorelist, -fno-sanitize-blacklist
Don't use ignorelist file for sanitizers
.. option:: -fparse-all-comments
.. option:: -frandomize-layout-seed-file=<file>
File holding the seed used by the randomize structure layout feature
.. option:: -frandomize-layout-seed=<seed>
The seed used by the randomize structure layout feature
.. option:: -frecord-command-line, -fno-record-command-line, -frecord-gcc-switches
.. option:: -fsanitize-address-destructor=<arg>
Set destructor type used in ASan instrumentation
Set destructor type used in ASan instrumentation. <arg> must be 'none' or 'global'.
.. option:: -fsanitize-address-field-padding=<arg>
Level of field padding for AddressSanitizer
.. option:: -fsanitize-address-globals-dead-stripping
.. option:: -fsanitize-address-globals-dead-stripping, -fno-sanitize-address-globals-dead-stripping
Enable linker dead stripping of globals in AddressSanitizer
@ -957,7 +973,7 @@ Enable poisoning array cookies when using custom operator new\[\] in AddressSani
.. option:: -fsanitize-address-use-after-return=<mode>
Select the mode of detecting stack use-after-return in AddressSanitizer: never \| runtime (default) \| always
Select the mode of detecting stack use-after-return in AddressSanitizer. <mode> must be 'never', 'runtime' or 'always'.
.. option:: -fsanitize-address-use-after-scope, -fno-sanitize-address-use-after-scope
@ -1021,6 +1037,10 @@ Enable origins tracking in MemorySanitizer
Enable use-after-destroy detection in MemorySanitizer
.. option:: -fsanitize-memtag-mode=<arg>
Set default MTE mode to 'sync' (default) or 'async'
.. option:: -fsanitize-minimal-runtime, -fno-sanitize-minimal-runtime
.. option:: -fsanitize-recover=<arg1>,<arg2>..., -fno-sanitize-recover=<arg1>,<arg2>..., -fsanitize-recover (equivalent to -fsanitize-recover=all)
@ -1188,14 +1208,6 @@ Validate the system headers that a module depends on when loading the module
Specify the prebuilt module path
.. option:: -fmodule-header
Build a C++20 header unit from a header specified.
.. option:: -fmodule-header=\[user,system\]
Build a C++20 header unit, but search for the header in the user or system header search paths respectively.
.. option:: --hip-path=<arg>
HIP runtime installation path, used for finding HIP version and adding HIP include path.
@ -1431,7 +1443,7 @@ Treat editor placeholders as valid source code
.. option:: -faltivec-src-compat=<arg>
Source-level compatibility for Altivec vectors (for PowerPC targets). This includes results of vector comparison (scalar for 'xl', vector for 'gcc') as well as behavior when initializing with a scalar (splatting for 'xl', element zero only for 'gcc'). For 'mixed', the compatibility is as 'gcc' for 'vector bool/vector pixel' and as 'xl' for other types. Current default is 'mixed'.
Source-level compatibility for Altivec vectors (for PowerPC targets). This includes results of vector comparison (scalar for 'xl', vector for 'gcc') as well as behavior when initializing with a scalar (splatting for 'xl', element zero only for 'gcc'). For 'mixed', the compatibility is as 'gcc' for 'vector bool/vector pixel' and as 'xl' for other types. Current default is 'mixed'. <arg> must be 'mixed', 'gcc' or 'xl'.
.. option:: -fansi-escape-codes
@ -1481,7 +1493,7 @@ Enable EH Asynchronous exceptions
.. option:: -fbasic-block-sections=<arg>
Generate labels for each basic block or place each basic block or a subset of basic blocks in its own section.
Generate labels for each basic block or place each basic block or a subset of basic blocks in its own section. <arg> must be 'all', 'labels', 'none' or 'list='.
.. option:: -fbinutils-version=<major.minor>
@ -1513,17 +1525,19 @@ Load the clang builtins module map file.
.. option:: -fcf-protection=<arg>, -fcf-protection (equivalent to -fcf-protection=full)
Instrument control-flow architecture protection. Options: return, branch, full, none.
Instrument control-flow architecture protection. <arg> must be 'return', 'branch', 'full' or 'none'.
.. option:: -fcf-runtime-abi=<arg>
<arg> must be 'unspecified', 'standalone', 'objc', 'swift', 'swift-5.0', 'swift-4.2' or 'swift-4.1'.
.. option:: -fchar8\_t, -fno-char8\_t
Enable C++ builtin type char8\_t
.. option:: -fclasspath=<arg>, --CLASSPATH <arg>, --CLASSPATH=<arg>, --classpath <arg>, --classpath=<arg>
.. option:: -fcolor-diagnostics, -fno-color-diagnostics
.. option:: -fcolor-diagnostics, -fdiagnostics-color, -fno-color-diagnostics
Enable colors in diagnostics
@ -1641,8 +1655,6 @@ Treat usage of null pointers as undefined behavior (default)
Print absolute paths in diagnostics
.. option:: -fdiagnostics-color, -fno-diagnostics-color
.. program:: clang1
.. option:: -fdiagnostics-color=<arg>
.. program:: clang
@ -1651,6 +1663,10 @@ Print absolute paths in diagnostics
Prevent optimization remarks from being output if they do not have at least this profile count. Use 'auto' to apply the threshold from profile summary
.. option:: -fdiagnostics-misexpect-tolerance=<value>
Prevent misexpect diagnostics from being output if the profile counts are within N% of the expected.
.. option:: -fdiagnostics-show-hotness, -fno-diagnostics-show-hotness
Enable profile hotness information in diagnostic line
@ -1675,6 +1691,8 @@ Enable alternative token representations '<:', ':>', '<%', '%>', '%:', '%:%:' (d
Don't use GOT indirection to reference external data symbols
.. option:: -fdirectives-only, -fno-directives-only
.. option:: -fdollars-in-identifiers, -fno-dollars-in-identifiers
Allow '$' in identifiers
@ -1699,7 +1717,7 @@ Do not emit debug info for defined but unused types
.. option:: -fembed-bitcode=<option>, -fembed-bitcode (equivalent to -fembed-bitcode=all), -fembed-bitcode-marker (equivalent to -fembed-bitcode=marker)
Embed LLVM bitcode (option: off, all, bitcode, marker)
Embed LLVM bitcode. <option> must be 'off', 'all', 'bitcode' or 'marker'.
.. option:: -fembed-offload-object=<arg>
@ -1737,7 +1755,7 @@ Enable the experimental new constant interpreter
.. option:: -fextend-arguments=<arg>
Controls how scalar integer arguments are extended in calls to unprototyped and varargs functions
Controls how scalar integer arguments are extended in calls to unprototyped and varargs functions. <arg> must be '32' or '64'.
.. option:: -ffast-math, -fno-fast-math
@ -1749,7 +1767,11 @@ The compilation directory to embed in the debug info and coverage mapping.
.. option:: -ffile-prefix-map=<arg>
remap file source paths in debug info, predefined preprocessor macros and \_\_builtin\_FILE()
remap file source paths in debug info, predefined preprocessor macros and \_\_builtin\_FILE(). Implies -ffile-reproducible.
.. option:: -ffile-reproducible, -fno-file-reproducible
Use the target's platform-specific path separator character when expanding the \_\_FILE\_\_ macro
.. option:: -ffinite-loops, -fno-finite-loops
@ -1777,11 +1799,15 @@ Enable support for int128\_t type
.. option:: -ffp-contract=<arg>
Form fused FP ops (e.g. FMAs): fast (fuses across statements disregarding pragmas) \| on (only fuses in the same statement unless dictated by pragmas) \| off (never fuses) \| fast-honor-pragmas (fuses across statements unless diectated by pragmas). Default is 'fast' for CUDA, 'fast-honor-pragmas' for HIP, and 'on' otherwise.
Form fused FP ops (e.g. FMAs): fast (fuses across statements disregarding pragmas) \| on (only fuses in the same statement unless dictated by pragmas) \| off (never fuses) \| fast-honor-pragmas (fuses across statements unless diectated by pragmas). Default is 'fast' for CUDA, 'fast-honor-pragmas' for HIP, and 'on' otherwise. <arg> must be 'fast', 'on', 'off' or 'fast-honor-pragmas'.
.. option:: -ffp-eval-method=<arg>
Specifies the evaluation method to use for floating-point arithmetic. <arg> must be 'source', 'double' or 'extended'.
.. option:: -ffp-exception-behavior=<arg>
Specifies the exception behavior of floating-point operations.
Specifies the exception behavior of floating-point operations. <arg> must be 'ignore', 'maytrap' or 'strict'.
.. option:: -ffp-model=<arg>
@ -1877,6 +1903,10 @@ Enable the integrated assembler
Run cc1 in-process
.. option:: -fjmc, -fno-jmc
Enable just-my-code debugging
.. option:: -fjump-tables, -fno-jump-tables
Use jump tables for lowering switches
@ -1887,7 +1917,7 @@ Keep static const variables if unused
.. option:: -flax-vector-conversions=<arg>, -flax-vector-conversions (equivalent to -flax-vector-conversions=integer), -fno-lax-vector-conversions (equivalent to -flax-vector-conversions=none)
Enable implicit vector bit-casts
Enable implicit vector bit-casts. <arg> must be 'none', 'integer' or 'all'.
.. option:: -flimited-precision=<arg>
@ -1897,13 +1927,13 @@ Controls the backend parallelism of -flto=thin (default of 0 means the number of
.. option:: -flto=<arg>, -flto (equivalent to -flto=full), -flto=auto (equivalent to -flto=full), -flto=jobserver (equivalent to -flto=full)
Set LTO mode to either 'full' or 'thin'
Set LTO mode. <arg> must be 'thin' or 'full'.
.. option:: -fmacro-backtrace-limit=<arg>
.. option:: -fmacro-prefix-map=<arg>
remap file source paths in predefined preprocessor macros and \_\_builtin\_FILE()
remap file source paths in predefined preprocessor macros and \_\_builtin\_FILE(). Implies -ffile-reproducible.
.. option:: -fmath-errno, -fno-math-errno
@ -1941,6 +1971,16 @@ Minimize whitespace when emitting preprocessor output
.. option:: -fmodule-file-deps, -fno-module-file-deps
.. option:: -fmodule-header
Build a C++20 Header Unit from a header.
.. program:: clang1
.. option:: -fmodule-header=<kind>
.. program:: clang
Build a C++20 Header Unit from a header that should be found in the user (fmodule-header=user) or system (fmodule-header=system) search path.
.. option:: -fmodule-map-file=<file>
Load this module map file
@ -1995,6 +2035,8 @@ Ensure that all functions can be hotpatched at runtime
.. option:: -fms-memptr-rep=<arg>
<arg> must be 'single', 'multiple' or 'virtual'.
.. option:: -fms-volatile
.. option:: -fmsc-version=<arg>
@ -2025,6 +2067,10 @@ Disable implicit builtin knowledge of a specific function
Do not elide types when printing diagnostics
.. option:: -fno-knr-functions
Disable support for K&R C function declarations
.. option:: -fno-max-type-align
.. option:: -fno-strict-modules-decluse
@ -2089,7 +2135,7 @@ Enable ARC-style weak references in Objective-C
.. option:: -foffload-lto=<arg>, -foffload-lto (equivalent to -foffload-lto=full)
Set LTO mode to either 'full' or 'thin' for offload compilation
Set LTO mode for offload compilation. <arg> must be 'thin' or 'full'.
.. option:: -fomit-frame-pointer, -fno-omit-frame-pointer
@ -2105,6 +2151,14 @@ Enable all Clang extensions for OpenMP directives and clauses
Set rpath on OpenMP executables
.. option:: -fopenmp-new-driver
Use the new driver for OpenMP offloading.
.. option:: -fopenmp-offload-mandatory
Do not create a host fallback if offloading to the device fails.
.. option:: -fopenmp-simd, -fno-openmp-simd
Emit OpenMP code only for SIMD-based constructs.
@ -2113,10 +2167,6 @@ Emit OpenMP code only for SIMD-based constructs.
Enable debugging in the OpenMP offloading device RTL
.. option:: -fopenmp-offload-mandatory
Indicate that offloading to the device is mandatory and do not generate host-fallback code.
.. option:: -fopenmp-version=<arg>
Set OpenMP version (e.g. 45 for OpenMP 4.5, 50 for OpenMP 5.0). Default value is 50.
@ -2278,7 +2328,7 @@ Enable sample-based profile guided optimizations
.. option:: -fprofile-update=<method>
Set update method of profile counters (atomic,prefer-atomic,single)
Set update method of profile counters. <method> must be 'atomic', 'prefer-atomic' or 'single'.
.. program:: clang1
.. option:: -fprofile-use=<pathname>
@ -2368,7 +2418,7 @@ Force wchar\_t to be a short unsigned int
.. option:: -fshow-overloads=<arg>
Which overload candidates to show when overload resolution fails: best\|all; defaults to all
Which overload candidates to show when overload resolution fails. Defaults to 'all'. <arg> must be 'best' or 'all'.
.. option:: -fshow-source-location, -fno-show-source-location
@ -2464,7 +2514,7 @@ Enable optimizations based on the strict rules for overwriting polymorphic C++ o
.. option:: -fswift-async-fp=<option>
Control emission of Swift async extended frame info (option: auto, always, never)
Control emission of Swift async extended frame info. <option> must be 'auto', 'always' or 'never'.
.. option:: -fsymbol-partition=<arg>
@ -2494,7 +2544,7 @@ Perform ThinLTO importing using provided function summary index
.. option:: -ftime-report=<arg>
.. program:: clang
(For new pass manager) "per-pass": one report for each pass; "per-pass-run": one report for each pass invocation
(For new pass manager) 'per-pass': one report for each pass; 'per-pass-run': one report for each pass invocation. <arg> must be 'per-pass' or 'per-pass-run'.
.. option:: -ftime-trace
@ -2509,6 +2559,8 @@ Minimum time granularity (in microseconds) traced by time profiler
.. option:: -ftls-model=<arg>
<arg> must be 'global-dynamic', 'local-dynamic', 'initial-exec' or 'local-exec'.
.. option:: -ftrap-function=<arg>
Issue call to specified function rather than a trap instruction
@ -2537,7 +2589,7 @@ Stop initializing trivial automatic stack variables after the specified number o
.. option:: -ftrivial-auto-var-init=<arg>
Initialize trivial automatic stack variables: uninitialized (default) \| pattern
Initialize trivial automatic stack variables. Defaults to 'uninitialized'. <arg> must be 'uninitialized', 'zero' or 'pattern'.
.. option:: -funique-basic-block-section-names, -fno-unique-basic-block-section-names
@ -2549,8 +2601,6 @@ Uniqueify Internal Linkage Symbol Names by appending the MD5 hash of the module
.. option:: -funique-section-names, -fno-unique-section-names
.. option:: -funit-at-a-time, -fno-unit-at-a-time
.. option:: -funroll-loops, -fno-unroll-loops
Turn on loop unroller
@ -2561,6 +2611,10 @@ Turn on loop unroller
.. option:: -funsigned-char, -fno-unsigned-char, --unsigned-char
.. option:: -funstable, -fno-unstable
Enable unstable and experimental features
.. option:: -funwind-tables, -fno-unwind-tables
.. option:: -fuse-cxa-atexit, -fno-use-cxa-atexit
@ -2579,7 +2633,7 @@ Compute and store the hash of input files used to build an AST. Files with misma
.. option:: -fveclib=<arg>
Use the given vector functions library
Use the given vector functions library. <arg> must be 'Accelerate', 'libmvec', 'MASSV', 'SVML', 'Darwin_libsystem_m' or 'none'.
.. option:: -fvectorize, -fno-vectorize, -ftree-vectorize
@ -2595,15 +2649,15 @@ Enables dead virtual function elimination optimization. Requires -flto=full
.. option:: -fvisibility-dllexport=<arg>
The visibility for dllexport definitions \[-fvisibility-from-dllstorageclass\]
The visibility for dllexport definitions \[-fvisibility-from-dllstorageclass\]. <arg> must be 'default', 'hidden', 'internal' or 'protected'.
.. option:: -fvisibility-externs-dllimport=<arg>
The visibility for dllimport external declarations \[-fvisibility-from-dllstorageclass\]
The visibility for dllimport external declarations \[-fvisibility-from-dllstorageclass\]. <arg> must be 'default', 'hidden', 'internal' or 'protected'.
.. option:: -fvisibility-externs-nodllstorageclass=<arg>
The visibility for external declarations without an explicit DLL dllstorageclass \[-fvisibility-from-dllstorageclass\]
The visibility for external declarations without an explicit DLL dllstorageclass \[-fvisibility-from-dllstorageclass\]. <arg> must be 'default', 'hidden', 'internal' or 'protected'.
.. option:: -fvisibility-from-dllstorageclass, -fno-visibility-from-dllstorageclass
@ -2627,11 +2681,11 @@ Give global types 'default' visibility and global functions and variables 'hidde
.. option:: -fvisibility-nodllstorageclass=<arg>
The visibility for defintiions without an explicit DLL export class \[-fvisibility-from-dllstorageclass\]
The visibility for definitions without an explicit DLL export class \[-fvisibility-from-dllstorageclass\]. <arg> must be 'default', 'hidden', 'internal' or 'protected'.
.. option:: -fvisibility=<arg>
Set the default symbol visibility for all global declarations
Set the default symbol visibility for all global declarations. <arg> must be 'hidden' or 'default'.
.. option:: -fwasm-exceptions
@ -2713,7 +2767,7 @@ When using -fxray-function-groups, select which group of functions to instrument
.. option:: -fzero-call-used-regs=<arg>
Clear call-used registers upon function return.
Clear call-used registers upon function return. <arg> must be 'skip', 'used-gpr-arg', 'used-gpr', 'used-arg', 'used', 'all-gpr-arg', 'all-gpr', 'all-arg' or 'all'.
.. option:: -fzero-initialized-in-bss, -fno-zero-initialized-in-bss
@ -2725,6 +2779,10 @@ Enable System z vector language extension
Bundle output files of HIP device compilation
.. option:: --offload-new-driver, --no-offload-new-driver
Use the new driver for offloading compilation.
.. option:: -pedantic, --pedantic, -no-pedantic, --no-pedantic
Warn on language extensions
@ -2775,7 +2833,7 @@ OpenCL only. Treat double precision floating-point constant as single precision
.. option:: -cl-std=<arg>
OpenCL language standard to compile for.
OpenCL language standard to compile for. <arg> must be 'cl', 'CL', 'cl1.0', 'CL1.0', 'cl1.1', 'CL1.1', 'cl1.2', 'CL1.2', 'cl2.0', 'CL2.0', 'cl3.0', 'CL3.0', 'clc++', 'CLC++', 'clc++1.0', 'CLC++1.0', 'clc++2021' or 'CLC++2021'.
.. option:: -cl-strict-aliasing
@ -2797,7 +2855,7 @@ Enables SYCL kernels compilation for device
.. option:: -sycl-std=<arg>
SYCL language standard to compile for.
SYCL language standard to compile for. <arg> must be '2020', '2017', '121', '1.2.1' or 'sycl-1.2.1'.
Target-dependent compilation options
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -2935,6 +2993,8 @@ Set Fuchsia API level
.. option:: -inline-asm=<arg>
<arg> must be 'att' or 'intel'.
.. option:: -m16
.. option:: -m32
@ -2983,6 +3043,10 @@ Sets the IEEE bit in the expected default floating point mode register. Floatin
Link stack frames through backchain on System Z
.. option:: -mbranch-protection=<arg>
Enforce targets of indirect branches and function returns
.. option:: -mbranches-within-32B-boundaries
Align selected branches (fused, jcc, jmp) within 32-byte boundary
@ -2995,7 +3059,7 @@ Legacy option to specify code object ABI V3 (AMDGPU only)
.. option:: -mcode-object-version=<arg>
Specify code object ABI version. Allowed values are 2, 3, 4, and 5. Defaults to 4. (AMDGPU only)
Specify code object ABI version. Defaults to 4. (AMDGPU only). <arg> must be 'none', '2', '3', '4' or '5'.
.. option:: -mconsole<arg>
@ -3011,15 +3075,15 @@ Allow use of CRC instructions (ARM/Mips only)
.. option:: -mdll<arg>
.. option:: -mdouble=<arg>
.. option:: -mdouble=<n
Force double to be 32 bits or 64 bits
Force double to be <n> bits. <n must be '32' or '64'.
.. option:: -mdynamic-no-pic<arg>
.. option:: -meabi <arg>
Set EABI type, e.g. 4, 5 or gnu (default depends on triple)
Set EABI type. Default depends on triple). <arg> must be 'default', '4', '5' or 'gnu'.
.. option:: -menable-experimental-extensions
@ -3031,6 +3095,8 @@ Insert calls to fentry at function entry (x86/SystemZ only)
.. option:: -mfloat-abi=<arg>
<arg> must be 'soft', 'softfp' or 'hard'.
.. option:: -mfpmath=<arg>
.. option:: -mfpu=<arg>
@ -3155,7 +3221,7 @@ Enable speculative execution side effect suppression (SESES). Includes LVI contr
.. option:: -msign-return-address=<arg>
Select return address signing scope
Select return address signing scope. <arg> must be 'none', 'all' or 'non-leaf'.
.. option:: -msim
@ -3207,7 +3273,7 @@ Set the deployment target to be the specified OS and OS version
.. option:: -mthread-model <arg>
The thread model to use, e.g. posix, single (posix by default)
The thread model to use. Defaults to 'posix'). <arg> must be 'posix' or 'single'.
.. option:: -mthreads<arg>
@ -3343,9 +3409,13 @@ Disallow generation of data access to code sections (ARM only)
Work around VLLDM erratum CVE-2021-35465 (ARM only)
.. option:: -mfix-cortex-a57-aes-1742098, -mfix-cortex-a72-aes-1655431, -mno-fix-cortex-a57-aes-1742098
Work around Cortex-A57 Erratum 1742098 (ARM only)
.. option:: -mno-bti-at-return-twice
Do not add a BTI instruction after a setjmp or other return-twice construct (AArch32/AArch64 only)
Do not add a BTI instruction after a setjmp or other return-twice construct (Arm/AArch64 only)
.. option:: -mno-movt
@ -3365,7 +3435,7 @@ Disallow generation of complex IT blocks.
.. option:: -mtp=<arg>
Thread pointer access method (AArch32/AArch64 only)
Thread pointer access method (AArch32/AArch64 only). <arg> must be 'soft', 'cp15', 'el0', 'el1', 'el2' or 'el3'.
.. option:: -munaligned-access, -mno-unaligned-access
@ -3403,7 +3473,7 @@ Enable Hexagon Vector eXtensions
.. option:: -mhvx-length=<arg>
Set Hexagon Vector Length
Set Hexagon Vector Length. <arg> must be '64B' or '128B'.
.. option:: -mhvx-qfloat, -mno-hvx-qfloat
@ -3575,8 +3645,6 @@ PowerPC
.. option:: -mcrbits, -mno-crbits
Control the CR-bit tracking feature on PowerPC. ``-mcrbits`` (the enablement of CR-bit tracking support) is the default for POWER8 and above, as well as for all other CPUs when optimization is applied (-O2 and above).
.. option:: -mcrypto, -mno-crypto
.. option:: -mdirect-move, -mno-direct-move
@ -3631,6 +3699,8 @@ WebAssembly
.. option:: -mexception-handling, -mno-exception-handling
.. option:: -mextended-const, -mno-extended-const
.. option:: -mmultivalue, -mno-multivalue
.. option:: -mmutable-globals, -mno-mutable-globals
@ -3647,13 +3717,11 @@ WebAssembly
.. option:: -mtail-call, -mno-tail-call
.. option:: -mextended-const, -mno-extended-const
WebAssembly Driver
------------------
.. option:: -mexec-model=<arg>
Execution model (WebAssembly only)
Execution model (WebAssembly only). <arg> must be 'command' or 'reactor'.
X86
---
@ -3978,7 +4046,7 @@ Embed source text in DWARF debug sections
.. option:: -gsplit-dwarf=<arg>
.. program:: clang
Set DWARF fission mode to either 'split' or 'single'
Set DWARF fission mode. <arg> must be 'split' or 'single'.
.. option:: -gstrict-dwarf, -gno-strict-dwarf
@ -4215,3 +4283,19 @@ undef all system defines
Pass -z <arg> to the linker
<clang-dxc options>
===================
dxc compatibility options
.. program:: clang2
.. option:: /T<profile>, -T<profile>
.. program:: clang
Set target profile. <profile> must be 'ps_6_0', ' ps_6_1', ' ps_6_2', ' ps_6_3', ' ps_6_4', ' ps_6_5', ' ps_6_6', ' ps_6_7', 'vs_6_0', ' vs_6_1', ' vs_6_2', ' vs_6_3', ' vs_6_4', ' vs_6_5', ' vs_6_6', ' vs_6_7', 'gs_6_0', ' gs_6_1', ' gs_6_2', ' gs_6_3', ' gs_6_4', ' gs_6_5', ' gs_6_6', ' gs_6_7', 'hs_6_0', ' hs_6_1', ' hs_6_2', ' hs_6_3', ' hs_6_4', ' hs_6_5', ' hs_6_6', ' hs_6_7', 'ds_6_0', ' ds_6_1', ' ds_6_2', ' ds_6_3', ' ds_6_4', ' ds_6_5', ' ds_6_6', ' ds_6_7', 'cs_6_0', ' cs_6_1', ' cs_6_2', ' cs_6_3', ' cs_6_4', ' cs_6_5', ' cs_6_6', ' cs_6_7', 'lib_6_3', ' lib_6_4', ' lib_6_5', ' lib_6_6', ' lib_6_7', ' lib_6_x', 'ms_6_5', ' ms_6_6', ' ms_6_7', 'as_6_5', ' as_6_6' or ' as_6_7'.
.. program:: clang3
.. option:: /emit-pristine-llvm, -emit-pristine-llvm, /fcgl, -fcgl
.. program:: clang
Emit pristine LLVM IR from the frontend by not running any LLVM passes at all.Same as -S + -emit-llvm + -disable-llvm-passes.