diff --git a/clang/docs/ClangCommandLineReference.rst b/clang/docs/ClangCommandLineReference.rst --- a/clang/docs/ClangCommandLineReference.rst +++ b/clang/docs/ClangCommandLineReference.rst @@ -281,6 +281,10 @@ Emit type record hashes in a .debug$H section +.. option:: -gen-reproducer=, -fno-crash-diagnostics (equivalent to -gen-reproducer=off) + +Emit reproducer on (option: off, crash (default), error, always) + .. option:: --gpu-instrument-lib= Instrument device library for HIP, which is a LLVM bitcode containing \_\_cyg\_profile\_func\_enter and \_\_cyg\_profile\_func\_exit @@ -339,7 +343,7 @@ .. option:: -mharden-sls= -Select straight-line speculation hardening scope +Select straight-line speculation hardening scope (ARM/AArch64/X86 only). must be: all, none, retbr(ARM/AArch64), blr(ARM/AArch64), comdat(ARM/AArch64), nocomdat(ARM/AArch64), return(X86), indirect-jmp(X86) .. option:: --migrate @@ -551,6 +555,10 @@ .. option:: --print-diagnostic-categories +.. option:: -print-diagnostic-options, --print-diagnostic-options + +Print all of Clang's warning options + .. option:: -print-effective-triple, --print-effective-triple Print the effective target triple @@ -817,6 +825,10 @@ Extract API information +.. option:: -fdriver-only + +Only run the driver. + .. option:: -fsyntax-only .. option:: -module-file-info @@ -929,10 +941,6 @@ Inline functions which are (explicitly or implicitly) marked inline -.. 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 @@ -1106,7 +1114,9 @@ Include comments from within macros in preprocessed output -.. option:: -D=, --define-macro , --define-macro= +.. program:: clang2 +.. option:: -D=, --D, /D, -D, --define-macro , --define-macro= +.. program:: clang Define to (or 1 if omitted) @@ -1727,6 +1737,10 @@ Emit all declarations, even if unused +.. option:: -femit-dwarf-unwind= + +When to emit DWARF unwind (EH frame) info. must be 'always', 'no-compact-unwind' or 'default'. + .. option:: -femulated-tls, -fno-emulated-tls Use emutls functions to access thread\_local variables @@ -1903,6 +1917,10 @@ Run cc1 in-process +.. option:: -fintegrated-objemitter, -fno-integrated-objemitter + +Use internal machine object code emitter. + .. option:: -fjmc, -fno-jmc Enable just-my-code debugging @@ -2767,7 +2785,7 @@ .. option:: -fzero-call-used-regs= -Clear call-used registers upon function return. must be 'skip', 'used-gpr-arg', 'used-gpr', 'used-arg', 'used', 'all-gpr-arg', 'all-gpr', 'all-arg' or 'all'. +Clear call-used registers upon function return (AArch64/x86 only). 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 @@ -2795,6 +2813,10 @@ OpenCL only. Allow denormals to be flushed to zero. +.. option:: -cl-ext=,... + +OpenCL only. Enable or disable OpenCL extensions/optional features. The argument is a comma-separated sequence of one or more extension names, each prefixed by '+' or '-'. + .. option:: -cl-fast-relaxed-math OpenCL only. Sets -cl-finite-math-only and -cl-unsafe-math-optimizations, and defines \_\_FAST\_RELAXED\_MATH\_\_. @@ -3073,6 +3095,10 @@ .. option:: -mdefault-build-attributes, -mno-default-build-attributes +.. option:: -mdefault-visibility-export-mapping= + +Mapping between default visibility and export. must be 'none', 'explicit' or 'all'. + .. option:: -mdll .. option:: -mdouble= to the linker -.. option:: --offload-link - -Use the linker supporting offloading device linking. - .. option:: -X .. option:: -Xlinker , --for-linker , --for-linker= Pass to the linker -.. option:: -Xoffload-linker , -Xoffload-linker- +.. option:: -Xoffload-linker -Pass to all the device linking jobs, or for only if specified. +Pass to the offload linkers or the ones idenfied by - .. program:: clang1 .. option:: -Z @@ -4255,6 +4277,10 @@ .. option:: -nostdlib, --no-standard-libraries .. program:: clang +.. option:: --offload-link + +Use the new offloading linker to perform the link job. + .. option:: -pie .. option:: -r @@ -4295,15 +4321,21 @@ =================== dxc compatibility options -.. program:: clang2 +.. program:: clang3 .. option:: /T, -T .. program:: clang Set target 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 +.. program:: clang4 .. 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. +.. program:: clang5 +.. option:: /hlsl-no-stdinc, -hlsl-no-stdinc +.. program:: clang + +HLSL only. Disables all standard includes containing non-native compiler types and functions. +