diff options
Diffstat (limited to 'usr.bin/clang/bugpoint/bugpoint.1')
| -rw-r--r-- | usr.bin/clang/bugpoint/bugpoint.1 | 24 |
1 files changed, 20 insertions, 4 deletions
diff --git a/usr.bin/clang/bugpoint/bugpoint.1 b/usr.bin/clang/bugpoint/bugpoint.1 index 36b0aed..cc93a97 100644 --- a/usr.bin/clang/bugpoint/bugpoint.1 +++ b/usr.bin/clang/bugpoint/bugpoint.1 @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "BUGPOINT" "1" "2016-03-03" "3.8" "LLVM" +.TH "BUGPOINT" "1" "2017-12-24" "6" "LLVM" .SH NAME bugpoint \- automatic test case reduction tool . @@ -42,7 +42,7 @@ can be used to debug three types of failures: optimizer crashes, miscompilations by optimizers, or bad native code generation (including problems in the static and JIT compilers). It aims to reduce large test cases to small, useful ones. For more information on the design and inner workings of \fBbugpoint\fP, as well as -advice for using bugpoint, see \fIllvm/docs/Bugpoint.html\fP in the LLVM +advice for using bugpoint, see /Bugpoint in the LLVM distribution. .SH OPTIONS .sp @@ -248,7 +248,12 @@ be useful for cross\-compilation. .INDENT 0.0 .INDENT 3.5 This option defines the command to use with the \fB\-\-compile\-custom\fP -option to compile the bitcode testcase. This can be useful for +option to compile the bitcode testcase. The command should exit with a +failure exit code if the file is "interesting" and should exit with a +success exit code (i.e. 0) otherwise (this is the same as if it crashed on +"interesting" inputs). +.sp +This can be useful for testing compiler output without running any link or execute stages. To generate a reduced unit test, you may add CHECK directives to the testcase and pass the name of an executable compile\-command script in this form: @@ -278,6 +283,17 @@ This option defines the path to the command to execute with the option. .UNINDENT .UNINDENT +.sp +\fB\-\-verbose\-errors\fP=\fI{true,false}\fP +.INDENT 0.0 +.INDENT 3.5 +The default behavior of bugpoint is to print "<crash>" when it finds a reduced +test that crashes compilation. This flag prints the output of the crashing +program to stderr. This is useful to make sure it is the same error being +tracked down and not a different error that happens to crash the compiler as +well. Defaults to false. +.UNINDENT +.UNINDENT .SH EXIT STATUS .sp If \fBbugpoint\fP succeeds in finding a problem, it will exit with 0. Otherwise, @@ -288,6 +304,6 @@ opt|opt .SH AUTHOR Maintained by The LLVM Team (http://llvm.org/). .SH COPYRIGHT -2003-2016, LLVM Project +2003-2017, LLVM Project .\" Generated by docutils manpage writer. . |
