How to submit an LLVM bug report

If you're working with LLVM and run into a bug, we definitely want to know about it. This document describes what you can do to increase the odds of @@ -76,12 +77,12 @@ information:

Crashing Bugs -

+ -

More often than not, bugs in the compiler cause it to crash—often due to an assertion failure of some sort. The most important @@ -109,14 +110,12 @@ with the following extra command line options:

- -

Front-end bugs -

+ -

If the problem is in the front-end, you should re-run the same llvm-gcc command that resulted in the crash, but add the @@ -137,11 +136,11 @@ has instructions on the best way to use delta.

Compile-time optimization bugs -

+ -

If you find that a bug crashes in the optimizer, compile your test-case to a .bc file by passing "-emit-llvm -O0 -c -o foo.bc". @@ -153,7 +152,7 @@ Then run:

This command should do two things: it should print out a list of passes, and -then it should crash in the same was as llvm-gcc. If it doesn't crash, please +then it should crash in the same way as llvm-gcc. If it doesn't crash, please follow the instructions for a front-end bug.

If this does crash, then you should be able to debug this with the following @@ -171,11 +170,11 @@ that bugpoint emits. If something goes wrong with bugpoint, please submit the

Code generator bugs -

+ -

If you find a bug that crashes llvm-gcc in the code generator, compile your source file to a .bc file by passing "-emit-llvm -c -o foo.bc" @@ -186,9 +185,6 @@ foo.bc, one of the following commands should fail:

llc foo.bc

llc foo.bc -relocation-model=pic

llc foo.bc -relocation-model=static

llc foo.bc -enable-eh

llc foo.bc -relocation-model=pic -enable-eh

llc foo.bc -relocation-model=static -enable-eh

If none of these crash, please follow the instructions for a @@ -202,11 +198,6 @@ the one corresponding to the command above that failed):

-relocation-model=pic

bugpoint -run-llc foo.bc --tool-args -relocation-model=static

bugpoint -run-llc foo.bc --tool-args -enable-eh

bugpoint -run-llc foo.bc --tool-args - -relocation-model=pic -enable-eh

bugpoint -run-llc foo.bc --tool-args - -relocation-model=static -enable-eh

Please run this, then file a bug with the instructions and reduced .bc file @@ -215,13 +206,15 @@ that bugpoint emits. If something goes wrong with bugpoint, please submit the

+ -

Miscompilations -

+ -

If llvm-gcc successfully produces an executable, but that executable doesn't run right, this is either a bug in the code or a bug in the @@ -249,12 +242,12 @@ error.

Incorrect code generation -

+ -

Similarly to debugging incorrect compilation by mis-behaving passes, you can debug incorrect code generation by either LLC or the JIT, using @@ -346,7 +339,7 @@ the following:

src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01"> Chris Lattner
- The LLVM Compiler Infrastructure + The LLVM Compiler Infrastructure
Last modified: $Date$