llvm-project/clang
Fangrui Song 80a4e6fd31 [Driver] Error for -gsplit-dwarf with RISC-V linker relaxation
-gsplit-dwarf produces a .dwo file which will not be processed by the linker. If
.dwo files contain relocations, they will not be resolved. Therefore the
practice is that .dwo files do not contain relocations.

Address ranges and location description need to use forms/entry kinds indexing
into .debug_addr (DW_FORM_addrx/DW_RLE_startx_endx/etc), which is currently not
implemented.

There is a difficult-to-read MC error with -gsplit-dwarf with RISC-V for both -mrelax and -mno-relax.
```
% clang --target=riscv64-linux-gnu -g -gsplit-dwarf -c a.c
error: A dwo section may not contain relocations
```

We expect to fix -mno-relax soon, so report a driver error for -mrelax for now.

Link: https://github.com/llvm/llvm-project/issues/56642

Reviewed By: compnerd, kito-cheng

Differential Revision: https://reviews.llvm.org/D130190
2022-07-22 17:16:41 -07:00
..
bindings Strengthen -Wint-conversion to default to an error 2022-07-22 15:24:54 -04:00
cmake Revert "[lldb/Fuzzer] Add fuzzer for expression evaluator" 2022-07-22 15:24:40 -07:00
docs Strengthen -Wint-conversion to default to an error 2022-07-22 15:24:54 -04:00
examples
include [Driver] Error for -gsplit-dwarf with RISC-V linker relaxation 2022-07-22 17:16:41 -07:00
lib [Driver] Error for -gsplit-dwarf with RISC-V linker relaxation 2022-07-22 17:16:41 -07:00
runtime Fix running orc-rt tests with LLVM_BUILD_EXTERNAL_COMPILER_RT (again). 2022-07-05 15:20:08 -07:00
test [Driver] Error for -gsplit-dwarf with RISC-V linker relaxation 2022-07-22 17:16:41 -07:00
tools Revert "[lldb/Fuzzer] Add fuzzer for expression evaluator" 2022-07-22 15:24:40 -07:00
unittests [clang][dataflow] Add DataflowEnvironment::dump() 2022-07-23 01:31:53 +02:00
utils [Flang] Generate documentation for compiler flags 2022-07-22 17:05:04 +00:00
www [DOC] Add DR1734 and DR1496 Clang's cxx_dr_status as not implemented 2022-07-14 00:48:35 +03:00
.clang-format
.clang-tidy
.gitignore
CMakeLists.txt [cmake] Don't export `LLVM_TOOLS_INSTALL_DIR` anymore 2022-07-21 19:04:00 +00: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/