From a163cdf6b50c0b7706fcf7805fd29736ad4eb9c2 Mon Sep 17 00:00:00 2001 From: Fangrui Song Date: Tue, 8 Feb 2022 20:54:52 -0800 Subject: [PATCH] [docs] Re-generate ClangCommandLineReference.rst --- clang/docs/ClangCommandLineReference.rst | 60 ++++++++++++++++++++++---------- 1 file changed, 41 insertions(+), 19 deletions(-) diff --git a/clang/docs/ClangCommandLineReference.rst b/clang/docs/ClangCommandLineReference.rst index e4b5c1a..c03a4c2 100644 --- a/clang/docs/ClangCommandLineReference.rst +++ b/clang/docs/ClangCommandLineReference.rst @@ -20,7 +20,7 @@ GCC-compatible ``clang`` and ``clang++`` drivers. .. program:: clang .. option:: -B, --prefix , --prefix= -Search $prefix/$triple-$file and $prefix$file for executables, libraries, includes, and data files used by the compiler. $prefix may or may not be a directory +Search $prefix$file for executables, libraries, and data files. If $prefix is a directory, search $prefix/$file .. option:: -F @@ -513,7 +513,7 @@ CUDA offloading device architecture (e.g. sm\_35), or HIP offloading target ID i .. option:: --offload=,... -Specify comma-separated list of offloading target triples (HIP only) +Specify comma-separated list of offloading target triples (CUDA and HIP only) .. option:: -p, --profile @@ -797,6 +797,14 @@ Use the LLVM representation for assembler and object files Generate Interface Stub Files, emit merged text not binary. +.. option:: -extract-api + +Extract API information + +.. option:: -fopenmp-new-driver + +Use the new driver for OpenMP offloading. + .. option:: -fsyntax-only .. option:: -module-file-info @@ -899,7 +907,7 @@ Inline suitable functions Inline functions which are (explicitly or implicitly) marked inline -.. option:: -flegacy-pass-manager, -fno-experimental-new-pass-manager, -fno-legacy-pass-manager +.. option:: -flegacy-pass-manager, -fno-legacy-pass-manager Use the legacy pass manager in LLVM (deprecated, to be removed in a future release) @@ -1232,9 +1240,9 @@ Set directory to include search path with prefix Add directory to SYSTEM include search path, absolute paths are relative to -isysroot -.. option:: --libomptarget-amdgpu-bc-path= +.. option:: --libomptarget-amdgpu-bc-path=, --libomptarget-amdgcn-bc-path= -Path to libomptarget-amdgpu bitcode library +Path to libomptarget-amdgcn bitcode library .. option:: --libomptarget-nvptx-bc-path= @@ -1673,6 +1681,10 @@ Do not emit debug info for defined but unused types Embed LLVM bitcode (option: off, all, bitcode, marker) +.. option:: -fembed-offload-object= + +Embed Offloading device-side binary into host object file as a section. + .. option:: -femit-all-decls Emit all declarations, even if unused @@ -1725,8 +1737,6 @@ Assume all loops are finite. .. option:: -ffinite-math-only, -fno-finite-math-only -Allow floating-point optimizations that assume arguments and results are not NaNs or +-inf. This defines the \_\_FINITE\_MATH\_ONLY\_\_ preprocessor macro. - .. option:: -ffixed-point, -fno-fixed-point Enable fixed point types @@ -1807,14 +1817,10 @@ Specify that single precision floating-point divide and sqrt used in the program Use new kernel launching API for HIP -.. option:: -fhonor-infinities, -fhonor-infinites, -fno-honor-infinities, -fno-honor-infinites - -Specify that floating-point optimizations are not allowed that assume arguments and results are not +-inf. +.. option:: -fhonor-infinities, -fhonor-infinites, -fno-honor-infinities .. option:: -fhonor-nans, -fno-honor-nans -Specify that floating-point optimizations are not allowed that assume arguments and results are not NANs. - .. option:: -fhosted .. option:: -fignore-exceptions @@ -1963,6 +1969,10 @@ Dot-separated value representing the Microsoft compiler version number to report Accept some non-standard constructs supported by the Microsoft compiler +.. option:: -fms-hotpatch + +Ensure that all functions can be hotpatched at runtime + .. option:: -fms-memptr-rep= .. option:: -fms-volatile @@ -2071,6 +2081,10 @@ Parse OpenMP pragmas and generate parallel code. Enable all Clang extensions for OpenMP directives and clauses +.. option:: -fopenmp-implicit-rpath, -fno-openmp-implicit-rpath + +Set rpath on OpenMP executables + .. option:: -fopenmp-simd, -fno-openmp-simd Emit OpenMP code only for SIMD-based constructs. @@ -2083,10 +2097,6 @@ Enable debugging in the OpenMP offloading device RTL Use the new bitcode library for OpenMP offloading -.. option:: -fopenmp-new-driver - -Use the new scheme for creating and linking OpenMP offloading code - .. option:: -fopenmp-version= Set OpenMP version (e.g. 45 for OpenMP 4.5, 50 for OpenMP 5.0). Default value is 50. @@ -2306,6 +2316,10 @@ Generate read-only position independent code (ARM only) Generate read-write position independent code (ARM only) +.. option:: -fsanitize-memory-param-retval, -fno-sanitize-memory-param-retval + +Enable detection of uninitialized parameters and return values + .. option:: -fsave-optimization-record, -fno-save-optimization-record Generate a YAML optimization record file @@ -2677,6 +2691,10 @@ DEPRECATED: Filename defining the whitelist for imbuing the 'never instrument' X When using -fxray-function-groups, select which group of functions to instrument. Valid range is 0 to fxray-function-groups - 1 +.. option:: -fzero-call-used-regs= + +Clear call-used registers upon function return. + .. option:: -fzero-initialized-in-bss, -fno-zero-initialized-in-bss .. option:: -fzvector, -fno-zvector, -mzvector @@ -2955,9 +2973,9 @@ Align selected branches (fused, jcc, jmp) within 32-byte boundary Legacy option to specify code object ABI V3 (AMDGPU only) -.. option:: -mcode-object-version= +.. option:: -mcode-object-version= -Specify code object ABI version. Defaults to 3. (AMDGPU only) +Specify code object ABI version. Allowed values are 2, 3, 4, and 5. Defaults to 4. (AMDGPU only) .. option:: -mconsole @@ -3015,6 +3033,10 @@ Enable merging of globals Use Intel MCU ABI +.. option:: -mibt-seal + +Optimize fcf-protection=branch/full (requires LTO). + .. option:: -mignore-xcoff-visibility Not emit the visibility attribute for asm in AIX OS or give all symbols 'unspecified' visibility in XCOFF object file @@ -3319,7 +3341,7 @@ Disallow use of CRC instructions (ARM only) .. option:: -mrestrict-it, -mno-restrict-it -Disallow generation of complex IT blocks. It is off by default. +Disallow generation of complex IT blocks. .. option:: -mtp= -- 2.7.4