[clang] babbd96 - [docs] Re-generate ClangCommandLineReference.rst
Fangrui Song via cfe-commits
cfe-commits at lists.llvm.org
Mon May 16 10:34:06 PDT 2022
Author: Fangrui Song
Date: 2022-05-16T10:34:01-07:00
New Revision: babbd96f23d5e21712223ece8f6318e6bc93269b
URL: https://github.com/llvm/llvm-project/commit/babbd96f23d5e21712223ece8f6318e6bc93269b
DIFF: https://github.com/llvm/llvm-project/commit/babbd96f23d5e21712223ece8f6318e6bc93269b.diff
LOG: [docs] Re-generate ClangCommandLineReference.rst
Added:
Modified:
clang/docs/ClangCommandLineReference.rst
Removed:
################################################################################
diff --git a/clang/docs/ClangCommandLineReference.rst b/clang/docs/ClangCommandLineReference.rst
index d8fa4b33baf0..13e175a4e520 100644
--- a/clang/docs/ClangCommandLineReference.rst
+++ b/clang/docs/ClangCommandLineReference.rst
@@ -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
-
-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-feature=<arg>
-.. 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.
+
More information about the cfe-commits
mailing list