From 368540f6ee070f4d2783c2ccf8b5ec3ea22f6efc Mon Sep 17 00:00:00 2001 From: Vedant Kumar Date: Thu, 23 Aug 2018 17:55:03 +0000 Subject: [PATCH] [docs] Regenerate ClangCommandLineReference.rst llvm-svn: 340559 --- clang/docs/ClangCommandLineReference.rst | 288 ++++++++++++++++++++----------- 1 file changed, 192 insertions(+), 96 deletions(-) diff --git a/clang/docs/ClangCommandLineReference.rst b/clang/docs/ClangCommandLineReference.rst index 5c15482..b60c4ed 100644 --- a/clang/docs/ClangCommandLineReference.rst +++ b/clang/docs/ClangCommandLineReference.rst @@ -36,7 +36,7 @@ Treat source input files as Objective-C inputs Treat source input files as Objective-C++ inputs -.. option:: -Qn +.. option:: -Qn, -fno-ident Do not emit metadata containing compiler name and version @@ -44,7 +44,7 @@ Do not emit metadata containing compiler name and version Don't emit warning for unused driver arguments -.. option:: -Qy +.. option:: -Qy, -fident Emit metadata containing compiler name and version @@ -214,9 +214,13 @@ Flush denormal floating point values to zero in CUDA device mode. Generate relocatable device code, also known as separate compilation mode. +.. option:: -fcuda-short-ptr, -fno-cuda-short-ptr + +Use 32-bit pointers for accessing const/local/shared address spaces. + .. option:: -ffixed-r19 -Reserve the r19 register (Hexagon only) +Reserve register r19 (Hexagon only) .. option:: -fheinous-gnu-extensions @@ -260,6 +264,10 @@ Display available options Display help for hidden options +.. option:: --hip-link + +Link clang-offload-bundler bundles for HIP + .. option:: -image\_base .. option:: -index-header-map @@ -452,6 +460,10 @@ Use pipes between commands, when possible .. option:: --print-diagnostic-categories +.. option:: -print-effective-triple, --print-effective-triple + +Print the effective target triple + .. option:: -print-file-name=, --print-file-name=, --print-file-name Print the full library path of @@ -480,6 +492,10 @@ Print the resource directory pathname Print the paths used for finding libraries and programs +.. option:: -print-target-triple, --print-target-triple + +Print the normalized target triple + .. option:: -private\_bundle .. option:: -pthread, -no-pthread @@ -558,6 +574,8 @@ Serialize compiler diagnostics to a file .. option:: -shared-libsan, -shared-libasan +Dynamically link the sanitizer runtime + .. option:: -single\_module .. option:: -specs=, --specs= @@ -568,6 +586,8 @@ Serialize compiler diagnostics to a file .. option:: -static-libsan +Statically link the sanitizer runtime + .. option:: -static-libstdc++ .. option:: -std-default= @@ -712,6 +732,12 @@ Attempt to match the ABI of Clang Treat each comma separated argument in as a documentation comment block command +.. option:: -fcomplete-member-pointers, -fno-complete-member-pointers + +Require member pointer base types to be complete if they would be significant under the Microsoft ABI + +.. option:: -fcrash-diagnostics-dir= + .. option:: -fdeclspec, -fno-declspec Allow \_\_declspec as a keyword @@ -746,7 +772,7 @@ Enables an experimental new pass manager in LLVM. .. option:: -ffine-grained-bitfield-accesses, -fno-fine-grained-bitfield-accesses -Use separate accesses for bitfields with legal widths and alignments. +Use separate accesses for consecutive bitfield runs with legal widths and alignments. .. option:: -finline-functions, -fno-inline-functions @@ -854,6 +880,10 @@ Strip (or keep only, if negative) a given number of path components when emittin Turn on runtime checks for various forms of undefined or suspicious behavior. See user manual for available checks +.. option:: -moutline, -mno-outline + +Enable function outlining (AArch64 only) + .. option:: --param , --param= .. option:: -std=, --std=, --std @@ -1151,6 +1181,10 @@ Target-independent compilation options .. option:: -faccess-control, -fno-access-control +.. option:: -faddrsig, -fno-addrsig + +Emit an address-significance table + .. option:: -falign-functions, -fno-align-functions .. program:: clang1 @@ -1223,12 +1257,20 @@ Accept non-standard constructs supported by the Borland compiler Load the clang builtins module map file. +.. option:: -fc++-static-destructors, -fno-c++-static-destructors + +Enable C++ static destructor registration (the default) + .. option:: -fcaret-diagnostics, -fno-caret-diagnostics .. option:: -fcf-protection=, -fcf-protection (equivalent to -fcf-protection=full) Instrument control-flow architecture protection. Options: return, branch, full, none. +.. option:: -fchar8\_t, -fno-char8\_t + +Enable C++ builtin type char8\_t + .. option:: -fclasspath=, --CLASSPATH , --CLASSPATH=, --classpath , --classpath= .. option:: -fcolor-diagnostics, -fno-color-diagnostics @@ -1293,6 +1335,10 @@ Place debug types in their own section (ELF Only) Parse templated function definitions at the end of the translation unit +.. option:: -fdelete-null-pointer-checks, -fno-delete-null-pointer-checks + +Treat usage of null pointers as undefined behavior. + .. option:: -fdenormal-fp-math= .. option:: -fdiagnostics-absolute-paths @@ -1325,6 +1371,10 @@ Print option name with mappable diagnostics Print a template comparison tree for differing templates +.. option:: -fdigraphs, -fno-digraphs + +Enable alternative token representations '<:', ':>', '<%', '%>', '%:', '%:%:' (default) + .. option:: -fdollars-in-identifiers, -fno-dollars-in-identifiers Allow '$' in identifiers @@ -1375,8 +1425,16 @@ Allow aggressive, lossy floating-point optimizations .. option:: -ffinite-math-only, -fno-finite-math-only +.. option:: -ffixed-point, -fno-fixed-point + +Enable fixed point types + .. option:: -ffor-scope, -fno-for-scope +.. option:: -fforce-emit-vtables, -fno-force-emit-vtables + +Emits more virtual tables to improve devirtualization + .. option:: -fforce-enable-int128, -fno-force-enable-int128 Enable support for int128\_t type @@ -1439,6 +1497,10 @@ Enable the integrated assembler .. option:: -fjump-tables, -fno-jump-tables +.. option:: -fkeep-static-consts + +Keep static const variables even if unused + .. option:: -flax-vector-conversions, -fno-lax-vector-conversions .. option:: -flimited-precision= @@ -1543,14 +1605,6 @@ Specifies the largest alignment guaranteed by '::operator new(size\_t)' Disable implicit builtin knowledge of a specific function -.. option:: -fdelete-null-pointer-checks, -fno-delete-null-pointer-checks - -When enabled, treat null pointer dereference, creation of a reference to null, -or passing a null pointer to a function parameter annotated with the "nonnull" -attribute as undefined behavior. (And, thus the optimizer may assume that any -pointer used in such a way must not have been null and optimize away the -branches accordingly.) On by default. - .. option:: -fno-elide-type Do not elide types when printing diagnostics @@ -1834,6 +1888,10 @@ Emit full debug info for all types used by the program Enable optimizations based on the strict definition of an enum's value range +.. option:: -fstrict-float-cast-overflow, -fno-strict-float-cast-overflow + +Assume that overflowing float-to-int casts are undefined (default) + .. option:: -fstrict-overflow, -fno-strict-overflow .. option:: -fstrict-return, -fno-strict-return @@ -1942,12 +2000,6 @@ Set the default symbol visibility for all global declarations Enables whole-program vtable optimization. Requires -flto -.. option:: -fforce-emit-vtables, -fno-force-emit-vtables - -In order to improve devirtualization, forces emitting of vtables even in -modules where it isn't necessary. It causes more inline virtual functions -to be emitted. - .. option:: -fwrapv, -fno-wrapv Treat signed integer overflow as two's complement @@ -2078,12 +2130,6 @@ Put objects of at most bytes into small data section (MIPS / Hexagon) .. option:: -mabi= -.. option:: -mabicalls, -mno-abicalls - -Enable SVR4-style position-independent code (Mips only) - -.. option:: -mabs= - .. option:: -malign-double Align doubles to two words in structs (x86 only) @@ -2096,25 +2142,19 @@ Align doubles to two words in structs (x86 only) Link stack frames through backchain on System Z -.. option:: -mcheck-zero-division, -mno-check-zero-division - .. option:: -mcmodel= -.. option:: -mcompact-branches= - .. option:: -mconsole .. option:: -mcpu=, -mv4 (equivalent to -mcpu=hexagonv4), -mv5 (equivalent to -mcpu=hexagonv5), -mv55 (equivalent to -mcpu=hexagonv55), -mv60 (equivalent to -mcpu=hexagonv60), -mv62 (equivalent to -mcpu=hexagonv62), -mv65 (equivalent to -mcpu=hexagonv65) -.. option:: -mdefault-build-attributes, -mno-default-build-attributes - -.. option:: -mdll +.. option:: -mcrc, -mno-crc -.. option:: -mdouble-float +Allow use of CRC instructions (ARM/Mips only) -.. option:: -mdsp, -mno-dsp +.. option:: -mdefault-build-attributes, -mno-default-build-attributes -.. option:: -mdspr2, -mno-dspr2 +.. option:: -mdll .. option:: -mdynamic-no-pic @@ -2122,28 +2162,12 @@ Link stack frames through backchain on System Z Set EABI type, e.g. 4, 5 or gnu (default depends on triple) -.. option:: -membedded-data, -mno-embedded-data - -Place constants in the .rodata section instead of the .sdata section even if they meet the -G threshold (MIPS) - -.. option:: -mextern-sdata, -mno-extern-sdata - -Assume that externally defined data is in the small data if it meets the -G threshold (MIPS) - .. option:: -mfentry Insert calls to fentry at function entry (x86 only) .. option:: -mfloat-abi= -.. option:: -mfp32 - -Use 32-bit floating point registers (MIPS only) - -.. option:: -mfp64 - -Use 64-bit floating point registers (MIPS only) - .. option:: -mfpmath= .. option:: -mfpu= @@ -2152,10 +2176,6 @@ Use 64-bit floating point registers (MIPS only) Enable merging of globals -.. option:: -mgpopt, -mno-gpopt - -Use GP relative accesses for symbols known to be in a small data section (MIPS) - .. option:: -mhard-float .. option:: -mhwdiv=, --mhwdiv , --mhwdiv= @@ -2172,22 +2192,10 @@ Use Intel MCU ABI (integrated-as) Emit an object file which can be used with an incremental linker -.. option:: -mindirect-jump= - -Change indirect jump instructions to inhibit speculation - .. option:: -miphoneos-version-min=, -mios-version-min= -.. option:: -mips16 - .. option:: -mkernel -.. option:: -mldc1-sdc1, -mno-ldc1-sdc1 - -.. option:: -mlocal-sdata, -mno-local-sdata - -Extend the -G behaviour to object local data (MIPS) - .. option:: -mlong-calls, -mno-long-calls Generate branches with extended addressability, usually via indirect jumps. @@ -2196,30 +2204,12 @@ Generate branches with extended addressability, usually via indirect jumps. Set Mac OS X deployment target -.. option:: -mmadd4, -mno-madd4 - -Enable the generation of 4-operand madd.s, madd.d and related instructions. - .. option:: -mmcu= -.. option:: -mmicromips, -mno-micromips - .. option:: -mms-bitfields, -mno-ms-bitfields Set the default structure layout to be compatible with the Microsoft compiler standard -.. option:: -mmsa, -mno-msa - -Enable MSA ASE (MIPS only) - -.. option:: -mmt, -mno-mt - -Enable MT ASE (MIPS only) - -.. option:: -mnan= - -.. option:: -mno-mips16 - .. option:: -momit-leaf-frame-pointer, -mno-omit-leaf-frame-pointer Omit frame pointer setup for leaf functions @@ -2252,11 +2242,15 @@ Enable hexagon-qdsp6 backward compatibility (integrated-as) Relax all machine instructions +.. option:: -mretpoline, -mno-retpoline + .. option:: -mrtd, -mno-rtd Make StdCall calling convention the default -.. option:: -msingle-float +.. option:: -msign-return-address= + +Select return address signing scope .. option:: -msoft-float, -mno-soft-float @@ -2302,8 +2296,6 @@ The thread model to use, e.g. posix, single (posix by default) .. option:: -mx32 -.. option:: -mxgot, -mno-xgot - AARCH64 ------- .. option:: -ffixed-x18 @@ -2334,10 +2326,6 @@ ARM Reserve the r9 register (ARM only) -.. option:: -mcrc - -Allow use of CRC instructions (ARM only) - .. option:: -mexecute-only, -mno-execute-only, -mpure-code Disallow generation of data access to code sections (ARM only) @@ -2370,6 +2358,18 @@ Hexagon ------- .. option:: -mieee-rnd-near +.. option:: -mmemops, -mno-memops + +Enable generation of memop instructions + +.. option:: -mnvj, -mno-nvj + +Enable generation of new-value jumps + +.. option:: -mnvs, -mno-nvs + +Enable generation of new-value stores + .. option:: -mpackets, -mno-packets Enable generation of instruction packets @@ -2390,6 +2390,82 @@ Set Hexagon Vector Length Enable Hexagon Vector eXtensions +MIPS +---- +.. option:: -mabicalls, -mno-abicalls + +Enable SVR4-style position-independent code (Mips only) + +.. option:: -mabs= + +.. option:: -mcheck-zero-division, -mno-check-zero-division + +.. option:: -mcompact-branches= + +.. option:: -mdouble-float + +.. option:: -mdsp, -mno-dsp + +.. option:: -mdspr2, -mno-dspr2 + +.. option:: -membedded-data, -mno-embedded-data + +Place constants in the .rodata section instead of the .sdata section even if they meet the -G threshold (MIPS) + +.. option:: -mextern-sdata, -mno-extern-sdata + +Assume that externally defined data is in the small data if it meets the -G threshold (MIPS) + +.. option:: -mfp32 + +Use 32-bit floating point registers (MIPS only) + +.. option:: -mfp64 + +Use 64-bit floating point registers (MIPS only) + +.. option:: -mginv, -mno-ginv + +.. option:: -mgpopt, -mno-gpopt + +Use GP relative accesses for symbols known to be in a small data section (MIPS) + +.. option:: -mindirect-jump= + +Change indirect jump instructions to inhibit speculation + +.. option:: -mips16 + +.. option:: -mldc1-sdc1, -mno-ldc1-sdc1 + +.. option:: -mlocal-sdata, -mno-local-sdata + +Extend the -G behaviour to object local data (MIPS) + +.. option:: -mmadd4, -mno-madd4 + +Enable the generation of 4-operand madd.s, madd.d and related instructions. + +.. option:: -mmicromips, -mno-micromips + +.. option:: -mmsa, -mno-msa + +Enable MSA ASE (MIPS only) + +.. option:: -mmt, -mno-mt + +Enable MT ASE (MIPS only) + +.. option:: -mnan= + +.. option:: -mno-mips16 + +.. option:: -msingle-float + +.. option:: -mvirt, -mno-virt + +.. option:: -mxgot, -mno-xgot + PowerPC ------- .. option:: -maltivec, -mno-altivec @@ -2504,6 +2580,8 @@ X86 .. option:: -mgfni, -mno-gfni +.. option:: -minvpcid, -mno-invpcid + .. option:: -mlwp, -mno-lwp .. option:: -mlzcnt, -mno-lzcnt @@ -2512,16 +2590,18 @@ X86 .. option:: -mmovbe, -mno-movbe -.. option:: -mmovdiri, -mno-movdiri - .. option:: -mmovdir64b, -mno-movdir64b +.. option:: -mmovdiri, -mno-movdiri + .. option:: -mmpx, -mno-mpx .. option:: -mmwaitx, -mno-mwaitx .. option:: -mpclmul, -mno-pclmul +.. option:: -mpconfig, -mno-pconfig + .. option:: -mpku, -mno-pku .. option:: -mpopcnt, -mno-popcnt @@ -2530,14 +2610,14 @@ X86 .. option:: -mprfchw, -mno-prfchw +.. option:: -mptwrite, -mno-ptwrite + .. option:: -mrdpid, -mno-rdpid .. option:: -mrdrnd, -mno-rdrnd .. option:: -mrdseed, -mno-rdseed -.. option:: -mretpoline, -mno-retpoline - .. option:: -mretpoline-external-thunk, -mno-retpoline-external-thunk .. option:: -mrtm, -mno-rtm @@ -2588,6 +2668,12 @@ X86 .. option:: -mxsaves, -mno-xsaves +RISCV +----- +.. option:: -mrelax, -mno-relax + +Enable linker relaxation + Optimization level ~~~~~~~~~~~~~~~~~~ @@ -2671,7 +2757,9 @@ Debug information flags Embed source text in DWARF debug sections -.. option:: -ggnu-pubnames +.. option:: -ggnu-pubnames, -gno-gnu-pubnames + +.. option:: -gpubnames, -gno-pubnames .. option:: -grecord-gcc-switches, -gno-record-gcc-switches @@ -2886,6 +2974,14 @@ Pass to the linker .. option:: -filelist +.. option:: --hip-device-lib-path= + +HIP device library path + +.. option:: --hip-device-lib= + +HIP device library + .. option:: -l .. option:: -r -- 2.7.4