diff --git a/clang/docs/ClangCommandLineReference.rst b/clang/docs/ClangCommandLineReference.rst index 6b86dd6ea9f3..fefce3391f06 100644 --- a/clang/docs/ClangCommandLineReference.rst +++ b/clang/docs/ClangCommandLineReference.rst @@ -144,14 +144,14 @@ Compile CUDA code for device only CUDA GPU architecture (e.g. sm\_35). May be specified more than once. -.. option:: --cuda-include-ptx=, --no-cuda-include-ptx= - -Include (or not) PTX along with CUDA GPU binary for the given architecture (e.g. sm\_35). Argument may be 'all'. The option may be specified more than once. Default: --cuda-include-ptx=all - .. option:: --cuda-host-only Compile CUDA code for host only. Has no effect on non-CUDA compilations. +.. option:: --cuda-include-ptx=, --no-cuda-include-ptx= + +Include PTX for the follwing GPU architecture (e.g. sm\_35) or 'all'. May be specified more than once. + .. option:: --cuda-noopt-device-debug, --no-cuda-noopt-device-debug Enable device-side debug info generation. Disables ptxas optimizations. @@ -202,6 +202,10 @@ Use approximate transcendental functions Flush denormal floating point values to zero in CUDA device mode. +.. option:: -ffixed-r19 + +Reserve the r19 register (Hexagon only) + .. option:: -fheinous-gnu-extensions .. option:: -flat\_namespace @@ -242,6 +246,8 @@ Display available options .. option:: --help-hidden +Display help for hidden options + .. option:: -image\_base .. option:: -index-header-map @@ -940,7 +946,7 @@ Specify the module user build path Don't verify input files for the modules if the module has been successfully validated or loaded during this build session -.. option:: -fmodules-validate-system-headers +.. option:: -fmodules-validate-system-headers, -fno-modules-validate-system-headers Validate the system headers that a module depends on when loading the module @@ -948,8 +954,6 @@ Validate the system headers that a module depends on when loading the module Specify the prebuilt module path -.. option:: -i - .. option:: -idirafter, --include-directory-after , --include-directory-after= Add directory to AFTER include search path @@ -1135,6 +1139,12 @@ Target-independent compilation options .. option:: -faccess-control, -fno-access-control +.. option:: -falign-functions, -fno-align-functions + +.. program:: clang1 +.. option:: -falign-functions= +.. program:: clang + .. program:: clang1 .. option:: -faligned-allocation, -faligned-new, -fno-aligned-allocation .. program:: clang @@ -1337,6 +1347,8 @@ Use emutls functions to access thread\_local variables .. option:: -ferror-limit= +.. option:: -fescaping-block-tail-calls, -fno-escaping-block-tail-calls + .. option:: -fexceptions, -fno-exceptions Enable support for exception handling @@ -1353,6 +1365,10 @@ Allow aggressive, lossy floating-point optimizations .. option:: -ffor-scope, -fno-for-scope +.. option:: -fforce-enable-int128, -fno-force-enable-int128 + +Enable support for int128\_t type + .. option:: -ffp-contract= Form fused FP ops (e.g. FMAs): fast (everywhere) \| on (according to FP\_CONTRACT pragma, default) \| off (never fuse) @@ -1441,6 +1457,8 @@ Specify the maximum alignment to enforce on pointers lacking an explicit alignme .. option:: -fmerge-all-constants, -fno-merge-all-constants +Allow merging of constants + .. option:: -fmessage-length= .. option:: -fmodule-file-deps, -fno-module-file-deps @@ -1523,10 +1541,16 @@ Do not elide types when printing diagnostics Do not treat C++ operator name keywords as synonyms for operators +.. option:: -fno-rtti-data + +Control emission of RTTI data + .. option:: -fno-strict-modules-decluse .. option:: -fno-working-directory +.. option:: -fnoxray-link-deps + .. option:: -fobjc-abi-version= .. option:: -fobjc-arc, -fno-objc-arc @@ -1680,6 +1704,10 @@ Allow division operations to be reassociated Override the default ABI to return small structs in registers +.. option:: -fregister-global-dtors-with-atexit, -fno-register-global-dtors-with-atexit + +Use atexit or \_\_cxa\_atexit to register global destructors + .. option:: -frelaxed-template-template-args, -fno-relaxed-template-template-args Enable C++17 relaxed template template argument matching @@ -1906,9 +1934,17 @@ Store string literals as writable data Determine whether to always emit \_\_xray\_customevent(...) calls even if the function it appears in is not always instrumented. +.. option:: -fxray-always-emit-typedevents, -fno-xray-always-emit-typedevents + +Determine whether to always emit \_\_xray\_typedevent(...) calls even if the function it appears in is not always instrumented. + .. option:: -fxray-always-instrument= -Filename defining the whitelist for imbuing the 'always instrument' XRay attribute. +DEPRECATED: Filename defining the whitelist for imbuing the 'always instrument' XRay attribute. + +.. option:: -fxray-attr-list= + +Filename defining the list of functions/types for imbuing XRay attributes. .. option:: -fxray-instruction-threshold @@ -1922,9 +1958,21 @@ Sets the minimum function size to instrument with XRay Generate XRay instrumentation sleds on function entry and exit +.. option:: -fxray-instrumentation-bundle= + +Select which XRay instrumentation points to emit. Options: all, none, function, custom. Default is 'all'. + +.. option:: -fxray-link-deps + +Tells clang to add the link dependencies for XRay. + +.. option:: -fxray-modes= + +List of modes to link in by default into XRay instrumented binaries. + .. option:: -fxray-never-instrument= -Filename defining the whitelist for imbuing the 'never instrument' XRay attribute. +DEPRECATED: Filename defining the whitelist for imbuing the 'never instrument' XRay attribute. .. option:: -fzero-initialized-in-bss, -fno-zero-initialized-in-bss @@ -2192,14 +2240,14 @@ Use software floating point Set the stack alignment +.. option:: -mstack-arg-probe, -mno-stack-arg-probe + +Enable stack probes + .. option:: -mstack-probe-size= Set the stack probe size -.. option:: -mstack-arg-probe, -mno-stack-arg-probe - -Disable stack probes - .. option:: -mstackrealign, -mno-stackrealign Force realign the stack at entry to every function @@ -2292,6 +2340,10 @@ Hexagon ------- .. option:: -mieee-rnd-near +.. option:: -mpackets, -mno-packets + +Enable generation of instruction packets + Hexagon ------- .. option:: -mhvx, -mno-hvx @@ -2342,18 +2394,20 @@ PowerPC .. option:: -mqpx, -mno-qpx +.. option:: -msecure-plt + .. option:: -mvsx, -mno-vsx WebAssembly ----------- +.. option:: -mexception-handling, -mno-exception-handling + .. option:: -mnontrapping-fptoint, -mno-nontrapping-fptoint .. option:: -msign-ext, -mno-sign-ext .. option:: -msimd128, -mno-simd128 -.. option:: -mexception-handling, -mno-exception-handling - X86 --- .. option:: -m3dnow, -mno-3dnow @@ -2398,6 +2452,8 @@ X86 .. option:: -mbmi2, -mno-bmi2 +.. option:: -mcldemote, -mno-cldemote + .. option:: -mclflushopt, -mno-clflushopt .. option:: -mclwb, -mno-clwb @@ -2577,9 +2633,9 @@ Debug information flags .. option:: -gdwarf-aranges -.. option:: -gembed-source +.. option:: -gembed-source, -gno-embed-source -.. option:: -gno-embed-source +Embed source text in DWARF debug sections .. option:: -ggnu-pubnames @@ -2746,6 +2802,8 @@ a Fortran input. .. option:: -fwhole-file, -fno-whole-file +.. option:: -imultilib + .. option:: -nocpp .. option:: -static-libgfortran @@ -2770,11 +2828,11 @@ Set starting address of BSS to .. option:: -Tdata -Set starting address of BSS to +Set starting address of DATA to .. option:: -Ttext -Set starting address of BSS to +Set starting address of TEXT to .. option:: -Wl,,...