Author: Konstantin Zhuravlyov Date: 2020-10-09T08:29:53-04:00 New Revision: b581c5a42f052d4d02f1152d0e1ff2d54668e6a0
URL: https://github.com/llvm/llvm-project/commit/b581c5a42f052d4d02f1152d0e1ff2d54668e6a0 DIFF: https://github.com/llvm/llvm-project/commit/b581c5a42f052d4d02f1152d0e1ff2d54668e6a0.diff LOG: Regenerate ClangCommandLineReference.rst Differential Revision: https://reviews.llvm.org/D89091 Added: Modified: clang/docs/ClangCommandLineReference.rst Removed: ################################################################################ diff --git a/clang/docs/ClangCommandLineReference.rst b/clang/docs/ClangCommandLineReference.rst index 135495668e2d..10e0203ce241 100644 --- a/clang/docs/ClangCommandLineReference.rst +++ b/clang/docs/ClangCommandLineReference.rst @@ -144,8 +144,6 @@ Specifies configuration file .. option:: --constant-cfstrings -.. option:: -coverage, --coverage - .. option:: --cuda-compile-host-device Compile CUDA code for both host and device (default). Has no effect on non-CUDA compilations. @@ -178,6 +176,10 @@ Filename to write DOT-formatted header dependencies to Filename (or -) to write dependency output to +.. option:: -dsym-dir<dir> + +Directory to output dSYM's (if any) to + .. option:: -dumpmachine .. option:: -dumpversion @@ -200,6 +202,10 @@ Filename (or -) to write dependency output to Emit Clang AST files for source inputs +.. option:: --emit-static-lib + +Enable linker job to emit a static library. + .. option:: -enable-trivial-auto-var-init-zero-knowing-it-will-be-removed-from-clang Trivial automatic variable initialization to zero is only here for benchmarks, it'll eventually be removed, and I'm OK with that because I'm only using it to benchmark @@ -262,6 +268,10 @@ Emit type record hashes in a .debug$H section .. option:: -ginline-line-tables, -gno-inline-line-tables +.. option:: --gpu-instrument-lib=<arg> + +Instrument device library for HIP, which is a LLVM bitcode containing \_\_cyg\_profile\_func\_enter and \_\_cyg\_profile\_func\_exit + .. option:: --gpu-max-threads-per-block=<arg> Default max threads per block for kernel launch bounds for HIP @@ -280,6 +290,10 @@ Display help for hidden options Link clang-offload-bundler bundles for HIP +.. option:: --hip-version=<arg> + +HIP version in the format of major.minor.patch + .. option:: -ibuiltininc Enable builtin #include directories even when -nostdinc is used before or after -ibuiltininc. Using -nobuiltininc after the option disables it @@ -310,6 +324,10 @@ Make the next included directory (-I or -F) an indexer header map Enforce targets of indirect branches and function returns +.. option:: -mharden-sls=<arg> + +Select straight-line speculation hardening scope + .. option:: --migrate Run the migrator @@ -374,8 +392,6 @@ Do not link device library for CUDA/HIP device compilation .. option:: -noseglinkedit -.. option:: -nostartfiles - .. option:: -nostdinc, --no-standard-includes .. program:: clang1 @@ -384,11 +400,7 @@ Do not link device library for CUDA/HIP device compilation Disable standard #include directories for the C++ standard library -.. option:: -nostdlib, --no-standard-libraries - -.. program:: clang1 .. option:: -nostdlib++ -.. program:: clang .. option:: -nostdlibinc @@ -464,7 +476,7 @@ Only modify files with a filename contained in the provided directory path .. option:: --offload-arch=<arg>, --cuda-gpu-arch=<arg>, --no-offload-arch=<arg> -CUDA/HIP offloading device architecture (e.g. sm\_35, gfx906). May be specified more than once. +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+:sram-ecc-). May be specified more than once. .. option:: -p, --profile @@ -474,8 +486,6 @@ CUDA/HIP offloading device architecture (e.g. sm\_35, gfx906). May be specified Enable mcount instrumentation -.. option:: -pie - .. option:: -pipe, --pipe Use pipes between commands, when possible @@ -538,8 +548,6 @@ Support POSIX threads in generated code .. option:: -pthreads -.. option:: -rdynamic - .. option:: -read\_only\_relocs <arg> .. option:: -relocatable-pch, --relocatable-pch @@ -602,8 +610,6 @@ Save intermediate compilation results. Serialize compiler diagnostics to a file -.. option:: -shared, --shared - .. option:: -shared-libgcc .. option:: -shared-libsan, -shared-libasan @@ -612,10 +618,6 @@ Dynamically link the sanitizer runtime .. option:: -single\_module -.. option:: -specs=<arg>, --specs=<arg> - -.. option:: -static, --static - .. option:: -static-libgcc .. option:: -static-libsan @@ -628,8 +630,6 @@ Statically link the sanitizer runtime Use the static host OpenMP runtime while linking. -.. option:: -static-pie - .. option:: -std-default=<arg> .. option:: -stdlib=<arg>, --stdlib=<arg>, --stdlib <arg> @@ -734,7 +734,7 @@ Only run preprocess, compile, and assemble steps .. option:: -emit-interface-stubs -Generate Inteface Stub Files. +Generate Interface Stub Files. .. option:: -emit-llvm @@ -820,7 +820,7 @@ Enables an experimental new pass manager in LLVM. .. option:: -fexperimental-strict-floating-point -Enables the use of non-default rounding modes and non-default exception handling on targets that are not currently ready. +Enables experimental strict floating point in LLVM. .. option:: -ffine-grained-bitfield-accesses, -fno-fine-grained-bitfield-accesses @@ -886,11 +886,11 @@ Enable control flow integrity (CFI) checks for cross-DSO calls. Generalize pointers in CFI indirect call type signature checks -.. option:: -fsanitize-coverage-allowlist=<arg> +.. option:: -fsanitize-coverage-allowlist=<arg>, -fsanitize-coverage-whitelist=<arg> Restrict sanitizer coverage instrumentation exclusively to modules and functions that match the provided special case list, except the blocked ones -.. option:: -fsanitize-coverage-blocklist=<arg> +.. option:: -fsanitize-coverage-blocklist=<arg>, -fsanitize-coverage-blacklist=<arg> Disable sanitizer coverage instrumentation for modules and functions that match the provided special case list, even the allowed ones @@ -1529,6 +1529,10 @@ Use DWARF style exceptions .. option:: -feliminate-unused-debug-symbols, -fno-eliminate-unused-debug-symbols +.. option:: -feliminate-unused-debug-types, -fno-eliminate-unused-debug-types + +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) @@ -1725,6 +1729,10 @@ Max total number of preprocessed tokens for -Wmax-tokens. Specify the maximum alignment to enforce on pointers lacking an explicit alignment +.. option:: -fmemory-profile, -fno-memory-profile + +Enable heap memory profiling + .. option:: -fmerge-all-constants, -fno-merge-all-constants Allow merging of constants @@ -1833,10 +1841,6 @@ Directly create compilation output files. This may lead to incorrect incremental .. option:: -fno\_pch-validate-input-files-content .. program:: clang -.. option:: -fnostack-clash-protection - -Disable stack clash protection - .. option:: -fnoxray-link-deps .. option:: -fobjc-abi-version=<arg> @@ -1933,6 +1937,18 @@ Generate M NOPs before function entry and N-M NOPs after function entry Override the default ABI to return all structs on the stack +.. option:: -fpch-codegen, -fno-pch-codegen + +Generate code for uses of this PCH that assumes an explicit object file will be built for the PCH + +.. option:: -fpch-debuginfo, -fno-pch-debuginfo + +Generate debug info for types in an object file built from this PCH and do not generate them elsewhere + +.. option:: -fpch-instantiate-templates, -fno-pch-instantiate-templates + +Instantiate templates already while building a PCH + .. option:: -fpch-preprocess .. option:: -fpch-validate-input-files-content @@ -2010,6 +2026,10 @@ Specifies that the sample profile is accurate. If the sample Enable sample-based profile guided optimizations +.. option:: -fprofile-update=<method> + +Set update method of profile counters (atomic,prefer-atomic,single) + .. program:: clang1 .. option:: -fprofile-use=<pathname> .. program:: clang @@ -2128,15 +2148,19 @@ Provide minimal debug info in the object/executable to facilitate online symboli Enables splitting of the LTO unit +.. option:: -fsplit-machine-functions, -fno-split-machine-functions + +Enable late function splitting using profile information (x86 ELF) + .. option:: -fsplit-stack -.. option:: -fstack-clash-protection +.. option:: -fstack-clash-protection, -fno-stack-clash-protection Enable stack clash protection .. option:: -fstack-protector, -fno-stack-protector -Enable stack protectors for some functions vulnerable to stack smashing. This uses a loose heuristic which considers functions vulnerable if they contain a char (or 8bit integer) array or constant sized calls to alloca , which are of greater size than ssp-buffer-size (default: 8 bytes). All variable sized calls to alloca are considered vulnerable. A function witha stack protector has a guard value added to the stack frame that is checked on function exit. The guard value must be positioned in the stack frame such that a buffer overflow from a vulnerable variable will overwrite the guard value before overwriting the function's return address. The reference stack guard value is stored in a global variable. +Enable stack protectors for some functions vulnerable to stack smashing. This uses a loose heuristic which considers functions vulnerable if they contain a char (or 8bit integer) array or constant sized calls to alloca , which are of greater size than ssp-buffer-size (default: 8 bytes). All variable sized calls to alloca are considered vulnerable. A function with a stack protector has a guard value added to the stack frame that is checked on function exit. The guard value must be positioned in the stack frame such that a buffer overflow from a vulnerable variable will overwrite the guard value before overwriting the function's return address. The reference stack guard value is stored in a global variable. .. option:: -fstack-protector-all @@ -2154,10 +2178,6 @@ Emit section containing metadata on function stack sizes Emit full debug info for all types used by the program -.. option:: -feliminate-unused-debug-types, -fno-eliminate-unused-debug-types - -Suppress (or emit) debug info for types that are unused but defined by the program. - .. option:: -fstrict-aliasing, -fno-strict-aliasing .. option:: -fstrict-enums, -fno-strict-enums @@ -2307,6 +2327,10 @@ Give global C++ operator new and delete declarations hidden visibility Give inline C++ member functions hidden visibility by default +.. option:: -fvisibility-inlines-hidden-static-local-var, -fno-visibility-inlines-hidden-static-local-var + +When -fvisibility-inlines-hidden is enabled, static variables in inline C++ member functions will also be given hidden visibility by default + .. option:: -fvisibility-ms-compat Give global types 'default' visibility and global functions and variables 'hidden' visibility by default @@ -2347,6 +2371,10 @@ DEPRECATED: Filename defining the whitelist for imbuing the 'always instrument' Filename defining the list of functions/types for imbuing XRay attributes. +.. option:: -fxray-function-groups=<arg> + +Only instrument 1 of N groups + .. option:: -fxray-function-index, -fno-xray-function-index .. option:: -fxray-ignore-loops, -fno-xray-ignore-loops @@ -2381,6 +2409,10 @@ List of modes to link in by default into XRay instrumented binaries. DEPRECATED: Filename defining the whitelist for imbuing the 'never instrument' XRay attribute. +.. option:: -fxray-selected-function-group=<arg> + +When using -fxray-function-groups, select which group of functions to instrument. Valid range is 0 to fxray-function-groups - 1 + .. option:: -fzero-initialized-in-bss, -fno-zero-initialized-in-bss .. option:: -fzvector, -fno-zvector, -mzvector @@ -2617,16 +2649,16 @@ Align doubles to two words in structs (x86 only) Link stack frames through backchain on System Z -.. option:: -mignore-xcoff-visibility - -Do not emit any visibility attribute for asm on AIX or give all symbols 'unspecified' visibility in XCOFF object file (XCOFF only) - .. option:: -mbranches-within-32B-boundaries Align selected branches (fused, jcc, jmp) within 32-byte boundary .. option:: -mcmodel=<arg>, -mcmodel=medany (equivalent to -mcmodel=medium), -mcmodel=medlow (equivalent to -mcmodel=small) +.. option:: -mcode-object-v3, -mno-code-object-v3 + +Enable code object v3 (AMDGPU only) + .. option:: -mconsole<arg> .. program:: clang1 @@ -2679,6 +2711,10 @@ Enable merging of globals Use Intel MCU ABI +.. option:: -mignore-xcoff-visibility + +Not emit the visibility attribute for asm in AIX OS or give all symbols 'unspecified' visibility in XCOFF object file + .. option:: -mimplicit-float, -mno-implicit-float .. option:: -mimplicit-it=<arg> @@ -2757,6 +2793,10 @@ Generate a \_\_mcount\_loc section entry for each \_\_fentry\_\_ call. .. option:: -mregparm=<arg> +.. option:: -mrelax, -mno-relax + +Enable linker relaxation + .. option:: -mrelax-all, -mno-relax-all (integrated-as) Relax all machine instructions @@ -2775,6 +2815,8 @@ Enable speculative execution side effect suppression (SESES). Includes LVI contr Select return address signing scope +.. option:: -msim + .. option:: -msoft-float, -mno-soft-float Use software floating point @@ -2821,7 +2863,7 @@ Specify bit size of immediate TLS offsets (AArch64 ELF only): 12 (for 4KB) \| 24 .. option:: -mtune=<arg> .. program:: clang -Accepted for compatibility with GCC. Currently has no effect. +Only supported on X86. Otherwise accepted for compatibility with GCC. .. option:: -mtvos-version-min=<arg>, -mappletvos-version-min=<arg> @@ -2887,12 +2929,16 @@ Workaround Cortex-A53 erratum 835769 (AArch64 only) Generate code which only uses the general purpose registers (AArch64 only) -AMDGPU ------- -.. option:: -mcode-object-v3, -mno-code-object-v3 +.. option:: -mmark-bti-property -Enable code object v3 (AMDGPU only) +Add .note.gnu.property with BTI to assembly files (AArch64 only) + +.. option:: -msve-vector-bits=<arg> + +Specify the size in bits of an SVE vector register. Defaults to the vector length agnostic value of "scalable". (AArch64 only) +AMDGPU +------ .. option:: -mcumode, -mno-cumode CU wavefront execution mode is used (AMDGPU only) @@ -3085,6 +3131,10 @@ PowerPC .. option:: -mmfocrf, -mmfcrf, -mno-mfocrf +.. option:: -mmma, -mno-mma + +.. option:: -mpaired-vector-memops, -mno-paired-vector-memops + .. option:: -mpcrel, -mno-pcrel .. option:: -mpopcntd, -mno-popcntd @@ -3213,6 +3263,8 @@ X86 .. option:: -minvpcid, -mno-invpcid +.. option:: -mkl, -mno-kl + .. option:: -mlwp, -mno-lwp .. option:: -mlzcnt, -mno-lzcnt @@ -3291,6 +3343,8 @@ X86 .. option:: -mwbnoinvd, -mno-wbnoinvd +.. option:: -mwidekl, -mno-widekl + .. option:: -mx87, -m80387, -mno-x87 .. option:: -mxop, -mno-xop @@ -3305,10 +3359,6 @@ X86 RISCV ----- -.. option:: -mrelax, -mno-relax - -Enable linker relaxation - .. option:: -msave-restore, -mno-save-restore Enable using library calls for save and restore @@ -3639,26 +3689,48 @@ Pass <arg> to the linker .. option:: -Z .. program:: clang +.. option:: -coverage, --coverage + .. option:: -e<arg>, --entry .. option:: -filelist <arg> -.. option:: --hip-device-lib-path=<arg> - -HIP device library path. Alternative to rocm-path. - .. option:: --hip-device-lib=<arg> HIP device library .. option:: -l<arg> +.. option:: --ld-path=<arg> + +.. option:: -nostartfiles + +.. program:: clang1 +.. option:: -nostdlib, --no-standard-libraries +.. program:: clang + +.. option:: -pie + .. option:: -r +.. option:: -rdynamic + +.. option:: --rocm-device-lib-path=<arg>, --hip-device-lib-path=<arg> + +ROCm device library path. Alternative to rocm-path. + .. option:: -rpath <arg> .. option:: -s +.. option:: -shared, --shared + +.. option:: -specs=<arg>, --specs=<arg> + +.. option:: -static, --static + +.. option:: -static-pie + .. option:: -t .. option:: -u<arg>, --force-link <arg>, --force-link=<arg> _______________________________________________ cfe-commits mailing list cfe-commits@lists.llvm.org https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
