Skip to content

Commit a163cdf

Browse files
committed
[docs] Re-generate ClangCommandLineReference.rst
1 parent c6a6b57 commit a163cdf

File tree

1 file changed

+41
-19
lines changed

1 file changed

+41
-19
lines changed

clang/docs/ClangCommandLineReference.rst

Lines changed: 41 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ GCC-compatible ``clang`` and ``clang++`` drivers.
2020
.. program:: clang
2121
.. option:: -B<prefix>, --prefix <arg>, --prefix=<arg>
2222

23-
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
23+
Search $prefix$file for executables, libraries, and data files. If $prefix is a directory, search $prefix/$file
2424

2525
.. option:: -F<arg>
2626

@@ -513,7 +513,7 @@ CUDA offloading device architecture (e.g. sm\_35), or HIP offloading target ID i
513513

514514
.. option:: --offload=<arg1>,<arg2>...
515515

516-
Specify comma-separated list of offloading target triples (HIP only)
516+
Specify comma-separated list of offloading target triples (CUDA and HIP only)
517517

518518
.. option:: -p, --profile
519519

@@ -797,6 +797,14 @@ Use the LLVM representation for assembler and object files
797797

798798
Generate Interface Stub Files, emit merged text not binary.
799799

800+
.. option:: -extract-api
801+
802+
Extract API information
803+
804+
.. option:: -fopenmp-new-driver
805+
806+
Use the new driver for OpenMP offloading.
807+
800808
.. option:: -fsyntax-only
801809

802810
.. option:: -module-file-info
@@ -899,7 +907,7 @@ Inline suitable functions
899907

900908
Inline functions which are (explicitly or implicitly) marked inline
901909

902-
.. option:: -flegacy-pass-manager, -fno-experimental-new-pass-manager, -fno-legacy-pass-manager
910+
.. option:: -flegacy-pass-manager, -fno-legacy-pass-manager
903911

904912
Use the legacy pass manager in LLVM (deprecated, to be removed in a future release)
905913

@@ -1232,9 +1240,9 @@ Set directory to include search path with prefix
12321240

12331241
Add directory to SYSTEM include search path, absolute paths are relative to -isysroot
12341242

1235-
.. option:: --libomptarget-amdgpu-bc-path=<arg>
1243+
.. option:: --libomptarget-amdgpu-bc-path=<arg>, --libomptarget-amdgcn-bc-path=<arg>
12361244

1237-
Path to libomptarget-amdgpu bitcode library
1245+
Path to libomptarget-amdgcn bitcode library
12381246

12391247
.. option:: --libomptarget-nvptx-bc-path=<arg>
12401248

@@ -1673,6 +1681,10 @@ Do not emit debug info for defined but unused types
16731681

16741682
Embed LLVM bitcode (option: off, all, bitcode, marker)
16751683

1684+
.. option:: -fembed-offload-object=<arg>
1685+
1686+
Embed Offloading device-side binary into host object file as a section.
1687+
16761688
.. option:: -femit-all-decls
16771689

16781690
Emit all declarations, even if unused
@@ -1725,8 +1737,6 @@ Assume all loops are finite.
17251737

17261738
.. option:: -ffinite-math-only, -fno-finite-math-only
17271739

1728-
Allow floating-point optimizations that assume arguments and results are not NaNs or +-inf. This defines the \_\_FINITE\_MATH\_ONLY\_\_ preprocessor macro.
1729-
17301740
.. option:: -ffixed-point, -fno-fixed-point
17311741

17321742
Enable fixed point types
@@ -1807,14 +1817,10 @@ Specify that single precision floating-point divide and sqrt used in the program
18071817

18081818
Use new kernel launching API for HIP
18091819

1810-
.. option:: -fhonor-infinities, -fhonor-infinites, -fno-honor-infinities, -fno-honor-infinites
1811-
1812-
Specify that floating-point optimizations are not allowed that assume arguments and results are not +-inf.
1820+
.. option:: -fhonor-infinities, -fhonor-infinites, -fno-honor-infinities
18131821

18141822
.. option:: -fhonor-nans, -fno-honor-nans
18151823

1816-
Specify that floating-point optimizations are not allowed that assume arguments and results are not NANs.
1817-
18181824
.. option:: -fhosted
18191825

18201826
.. option:: -fignore-exceptions
@@ -1963,6 +1969,10 @@ Dot-separated value representing the Microsoft compiler version number to report
19631969

19641970
Accept some non-standard constructs supported by the Microsoft compiler
19651971

1972+
.. option:: -fms-hotpatch
1973+
1974+
Ensure that all functions can be hotpatched at runtime
1975+
19661976
.. option:: -fms-memptr-rep=<arg>
19671977

19681978
.. option:: -fms-volatile
@@ -2071,6 +2081,10 @@ Parse OpenMP pragmas and generate parallel code.
20712081

20722082
Enable all Clang extensions for OpenMP directives and clauses
20732083

2084+
.. option:: -fopenmp-implicit-rpath, -fno-openmp-implicit-rpath
2085+
2086+
Set rpath on OpenMP executables
2087+
20742088
.. option:: -fopenmp-simd, -fno-openmp-simd
20752089

20762090
Emit OpenMP code only for SIMD-based constructs.
@@ -2083,10 +2097,6 @@ Enable debugging in the OpenMP offloading device RTL
20832097

20842098
Use the new bitcode library for OpenMP offloading
20852099

2086-
.. option:: -fopenmp-new-driver
2087-
2088-
Use the new scheme for creating and linking OpenMP offloading code
2089-
20902100
.. option:: -fopenmp-version=<arg>
20912101

20922102
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)
23062316

23072317
Generate read-write position independent code (ARM only)
23082318

2319+
.. option:: -fsanitize-memory-param-retval, -fno-sanitize-memory-param-retval
2320+
2321+
Enable detection of uninitialized parameters and return values
2322+
23092323
.. option:: -fsave-optimization-record, -fno-save-optimization-record
23102324

23112325
Generate a YAML optimization record file
@@ -2677,6 +2691,10 @@ DEPRECATED: Filename defining the whitelist for imbuing the 'never instrument' X
26772691

26782692
When using -fxray-function-groups, select which group of functions to instrument. Valid range is 0 to fxray-function-groups - 1
26792693

2694+
.. option:: -fzero-call-used-regs=<arg>
2695+
2696+
Clear call-used registers upon function return.
2697+
26802698
.. option:: -fzero-initialized-in-bss, -fno-zero-initialized-in-bss
26812699

26822700
.. option:: -fzvector, -fno-zvector, -mzvector
@@ -2955,9 +2973,9 @@ Align selected branches (fused, jcc, jmp) within 32-byte boundary
29552973

29562974
Legacy option to specify code object ABI V3 (AMDGPU only)
29572975

2958-
.. option:: -mcode-object-version=<version>
2976+
.. option:: -mcode-object-version=<arg>
29592977

2960-
Specify code object ABI version. Defaults to 3. (AMDGPU only)
2978+
Specify code object ABI version. Allowed values are 2, 3, 4, and 5. Defaults to 4. (AMDGPU only)
29612979

29622980
.. option:: -mconsole<arg>
29632981

@@ -3015,6 +3033,10 @@ Enable merging of globals
30153033

30163034
Use Intel MCU ABI
30173035

3036+
.. option:: -mibt-seal
3037+
3038+
Optimize fcf-protection=branch/full (requires LTO).
3039+
30183040
.. option:: -mignore-xcoff-visibility
30193041

30203042
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)
33193341

33203342
.. option:: -mrestrict-it, -mno-restrict-it
33213343

3322-
Disallow generation of complex IT blocks. It is off by default.
3344+
Disallow generation of complex IT blocks.
33233345

33243346
.. option:: -mtp=<arg>
33253347

0 commit comments

Comments
 (0)