llvm-project/clang
Paul Kirth 46774df307 [misexpect] Re-implement MisExpect Diagnostics
Reimplements MisExpect diagnostics from D66324 to reconstruct its
original checking methodology only using MD_prof branch_weights
metadata.

New checks rely on 2 invariants:

1) For frontend instrumentation, MD_prof branch_weights will always be
   populated before llvm.expect intrinsics are lowered.

2) for IR and sample profiling, llvm.expect intrinsics will always be
   lowered before branch_weights are populated from the IR profiles.

These invariants allow the checking to assume how the existing branch
weights are populated depending on the profiling method used, and emit
the correct diagnostics. If these invariants are ever invalidated, the
MisExpect related checks would need to be updated, potentially by
re-introducing MD_misexpect metadata, and ensuring it always will be
transformed the same way as branch_weights in other optimization passes.

Frontend based profiling is now enabled without using LLVM Args, by
introducing a new CodeGen option, and checking if the -Wmisexpect flag
has been passed on the command line.

Reviewed By: tejohnson

Differential Revision: https://reviews.llvm.org/D115907
2022-03-31 17:38:21 +00:00
..
bindings
cmake [CMake][Fuchsia] Switch to lld on Apple platforms 2022-03-22 01:06:30 -07:00
docs [misexpect] Re-implement MisExpect Diagnostics 2022-03-31 17:38:21 +00:00
examples clang-analyzer plugins require LLVM_ENABLE_PLUGINS also 2022-02-16 11:59:09 -05:00
include [misexpect] Re-implement MisExpect Diagnostics 2022-03-31 17:38:21 +00:00
lib [misexpect] Re-implement MisExpect Diagnostics 2022-03-31 17:38:21 +00:00
runtime Fix running orc-rt tests with LLVM_BUILD_EXTERNAL_COMPILER_RT 2022-01-25 08:27:40 -08:00
test [misexpect] Re-implement MisExpect Diagnostics 2022-03-31 17:38:21 +00:00
tools [Clang] Implement __builtin_source_location. 2022-03-28 18:29:02 -04:00
unittests [clang][dataflow] Add support for `value_or` in a comparison. 2022-03-31 13:21:39 +00:00
utils Revert D121984 "[RISCV][NFC] Moving RVV intrinsic type related util to llvm/Support" 2022-03-28 01:17:37 -07:00
www [clang][DR] Add test for DR1227 and mark it as complete 2022-03-30 09:25:52 +02:00
.clang-format
.clang-tidy
.gitignore
CMakeLists.txt [CMake][Clang] Skip host link version detection for lld on Darwin 2022-03-21 18:32:03 -07:00
CODE_OWNERS.TXT
INSTALL.txt
LICENSE.TXT
ModuleInfo.txt
NOTES.txt
README.txt Replace links to archived mailing lists by links to Discourse forums 2022-03-23 10:10:20 -04:00

README.txt

//===----------------------------------------------------------------------===//
// C Language Family Front-end
//===----------------------------------------------------------------------===//

Welcome to Clang.  This is a compiler front-end for the C family of languages
(C, C++, Objective-C, and Objective-C++) which is built as part of the LLVM
compiler infrastructure project.

Unlike many other compiler frontends, Clang is useful for a number of things
beyond just compiling code: we intend for Clang to be host to a number of
different source-level tools.  One example of this is the Clang Static Analyzer.

If you're interested in more (including how to build Clang) it is best to read
the relevant web sites.  Here are some pointers:

Information on Clang:             http://clang.llvm.org/
Building and using Clang:         http://clang.llvm.org/get_started.html
Clang Static Analyzer:            http://clang-analyzer.llvm.org/
Information on the LLVM project:  http://llvm.org/

If you have questions or comments about Clang, a great place to discuss them is
on the Clang forums:
  https://discourse.llvm.org/c/clang/

If you find a bug in Clang, please file it in the LLVM bug tracker:
  http://llvm.org/bugs/