X-Git-Url: http://plrg.eecs.uci.edu/git/?a=blobdiff_plain;f=docs%2FHowToSubmitABug.html;h=0815b88cf73271f6e8e28a6cbe785c86b7da5cb2;hb=321333e51ef8411c00d3df83d95a875c1fc75874;hp=b170aa1e85c88442a07bd6a8c7a583a80014e2e9;hpb=1a5ed97f35a149bcaaefb3b436cdaf9627b55a8b;p=oota-llvm.git diff --git a/docs/HowToSubmitABug.html b/docs/HowToSubmitABug.html index b170aa1e85c..0815b88cf73 100644 --- a/docs/HowToSubmitABug.html +++ b/docs/HowToSubmitABug.html @@ -60,14 +60,14 @@ more easily.

Once you have a reduced test-case, go to the LLVM Bug Tracking System and fill out the form with the necessary details (note that you don't -need to pick a catagory, just use the "new-bugs" catagory if you're not sure). +need to pick a category, just use the "new-bugs" category if you're not sure). The bug description should contain the following information:

@@ -183,9 +183,12 @@ to llvm-gcc (in addition to the options you already pass). Once your have foo.bc, one of the following commands should fail:

    -
  1. llc foo.bc -f
  2. -
  3. llc foo.bc -f -relocation-model=pic
  4. -
  5. llc foo.bc -f -relocation-model=static
  6. +
  7. llc foo.bc
  8. +
  9. llc foo.bc -relocation-model=pic
  10. +
  11. llc foo.bc -relocation-model=static
  12. +
  13. llc foo.bc -enable-eh
  14. +
  15. llc foo.bc -relocation-model=pic -enable-eh
  16. +
  17. llc foo.bc -relocation-model=static -enable-eh

If none of these crash, please follow the instructions for a @@ -194,11 +197,16 @@ be able to reduce this with one of the following bugpoint command lines (use the one corresponding to the command above that failed):

    -
  1. bugpoint -run-llc foo.bc --tool-args
  2. +
  3. bugpoint -run-llc foo.bc
  4. bugpoint -run-llc foo.bc --tool-args -relocation-model=pic
  5. bugpoint -run-llc foo.bc --tool-args -relocation-model=static
  6. +
  7. bugpoint -run-llc foo.bc --tool-args -enable-eh
  8. +
  9. bugpoint -run-llc foo.bc --tool-args + -relocation-model=pic -enable-eh
  10. +
  11. 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 @@ -234,7 +242,7 @@ JIT, or LLC) and optionally a series of LLVM passes to run. For example:

bugpoint will try to narrow down your list of passes to the one pass -that causes an error, and simplify the bytecode file as much as it can to assist +that causes an error, and simplify the bitcode file as much as it can to assist you. It will print a message letting you know how to reproduce the resulting error.

@@ -260,8 +268,8 @@ Backend, and then link in the shared object it generates.

-bugpoint -run-jit -output=[correct output file] [bytecode file]  \
-         --tool-args -- [arguments to pass to lli]               \
+bugpoint -run-jit -output=[correct output file] [bitcode file]  \
+         --tool-args -- [arguments to pass to lli]              \
          --args -- [program arguments]
 
@@ -270,8 +278,8 @@ bugpoint -run-jit -output=[correct output file] [bytecode file] \
-bugpoint -run-llc -output=[correct output file] [bytecode file]  \
-         --tool-args -- [arguments to pass to llc]               \
+bugpoint -run-llc -output=[correct output file] [bitcode file]  \
+         --tool-args -- [arguments to pass to llc]              \
          --args -- [program arguments]
 
@@ -289,7 +297,7 @@ make bugpoint-jit

At the end of a successful bugpoint run, you will be presented -with two bytecode files: a safe file which can be compiled with the C +with two bitcode files: a safe file which can be compiled with the C backend and the test file which either LLC or the JIT mis-codegenerates, and thus causes the error.

@@ -298,7 +306,7 @@ the following:

    -
  1. Regenerate the shared object from the safe bytecode file:

    +
  2. Regenerate the shared object from the safe bitcode file:

    @@ -307,19 +315,19 @@ the following:

  3. -
  4. If debugging LLC, compile test bytecode native and link with the shared +

  5. If debugging LLC, compile test bitcode native and link with the shared object:

    -llc test.bc -o test.s -f
    +llc test.bc -o test.s
    gcc test.s safe.so -o test.llc
    ./test.llc [program options]

  6. If debugging the JIT, load the shared object and supply the test - bytecode:

    + bitcode:

    lli -load=safe.so test.bc [program options]

    @@ -333,9 +341,9 @@ the following:


    Valid CSS! + src="http://jigsaw.w3.org/css-validator/images/vcss-blue" alt="Valid CSS"> Valid HTML 4.01! + src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01"> Chris Lattner
    The LLVM Compiler Infrastructure