Date: Sun, 24 Dec 2017 13:02:43 +0000 (UTC) From: Dimitry Andric <dim@FreeBSD.org> To: src-committers@freebsd.org, svn-src-projects@freebsd.org Subject: svn commit: r327147 - in projects/clang600-import/usr.bin/clang: bugpoint llc lli llvm-ar llvm-as llvm-bcanalyzer llvm-cov llvm-diff llvm-dis llvm-dwarfdump llvm-extract llvm-link llvm-nm llvm-pdbu... Message-ID: <201712241302.vBOD2hRd080860@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: dim Date: Sun Dec 24 13:02:43 2017 New Revision: 327147 URL: https://svnweb.freebsd.org/changeset/base/327147 Log: Regenerate llvm tools manpages, and add one for llvm-pbdutil. Added: projects/clang600-import/usr.bin/clang/llvm-pdbutil/llvm-pdbutil.1 (contents, props changed) Modified: projects/clang600-import/usr.bin/clang/bugpoint/bugpoint.1 projects/clang600-import/usr.bin/clang/llc/llc.1 projects/clang600-import/usr.bin/clang/lli/lli.1 projects/clang600-import/usr.bin/clang/llvm-ar/llvm-ar.1 projects/clang600-import/usr.bin/clang/llvm-as/llvm-as.1 projects/clang600-import/usr.bin/clang/llvm-bcanalyzer/llvm-bcanalyzer.1 projects/clang600-import/usr.bin/clang/llvm-cov/llvm-cov.1 projects/clang600-import/usr.bin/clang/llvm-diff/llvm-diff.1 projects/clang600-import/usr.bin/clang/llvm-dis/llvm-dis.1 projects/clang600-import/usr.bin/clang/llvm-dwarfdump/llvm-dwarfdump.1 projects/clang600-import/usr.bin/clang/llvm-extract/llvm-extract.1 projects/clang600-import/usr.bin/clang/llvm-link/llvm-link.1 projects/clang600-import/usr.bin/clang/llvm-nm/llvm-nm.1 projects/clang600-import/usr.bin/clang/llvm-pdbutil/Makefile projects/clang600-import/usr.bin/clang/llvm-profdata/llvm-profdata.1 projects/clang600-import/usr.bin/clang/llvm-symbolizer/llvm-symbolizer.1 projects/clang600-import/usr.bin/clang/opt/opt.1 Modified: projects/clang600-import/usr.bin/clang/bugpoint/bugpoint.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/bugpoint/bugpoint.1 Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/bugpoint/bugpoint.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -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: optimize 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 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. . Modified: projects/clang600-import/usr.bin/clang/llc/llc.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/llc/llc.1 Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/llc/llc.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "LLC" "1" "2016-03-03" "3.8" "LLVM" +.TH "LLC" "1" "2017-12-24" "6" "LLVM" .SH NAME llc \- LLVM static compiler . @@ -182,6 +182,15 @@ the \fB\-march\fP option so that code can be generated Specify which EABI version should conform to. Valid EABI versions are \fIgnu\fP, \fI4\fP and \fI5\fP\&. Default value (\fIdefault\fP) depends on the triple. .UNINDENT +.INDENT 0.0 +.TP +.B \-stack\-size\-section +Emit the .stack_sizes section which contains stack size metadata. The section +contains an array of pairs of function symbol references (8 byte) and stack +sizes (unsigned LEB128). The stack size values only include the space allocated +in the function prologue. Functions with dynamic stack allocations are not +included. +.UNINDENT .SS Tuning/Configuration Options .INDENT 0.0 .TP @@ -260,6 +269,6 @@ lli .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. . Modified: projects/clang600-import/usr.bin/clang/lli/lli.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/lli/lli.1 Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/lli/lli.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "LLI" "1" "2016-03-03" "3.8" "LLVM" +.TH "LLI" "1" "2017-12-24" "6" "LLVM" .SH NAME lli \- directly execute programs from LLVM bitcode . @@ -293,6 +293,6 @@ Otherwise, it will return the exit code of the program .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. . Modified: projects/clang600-import/usr.bin/clang/llvm-ar/llvm-ar.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/llvm-ar/llvm-ar.1 Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/llvm-ar/llvm-ar.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "LLVM-AR" "1" "2016-03-03" "3.8" "LLVM" +.TH "LLVM-AR" "1" "2017-12-24" "6" "LLVM" .SH NAME llvm-ar \- LLVM archiver . @@ -385,6 +385,6 @@ ar(1) .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. . Modified: projects/clang600-import/usr.bin/clang/llvm-as/llvm-as.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/llvm-as/llvm-as.1 Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/llvm-as/llvm-as.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "LLVM-AS" "1" "2016-03-03" "3.8" "LLVM" +.TH "LLVM-AS" "1" "2017-12-24" "6" "LLVM" .SH NAME llvm-as \- LLVM assembler . @@ -60,15 +60,15 @@ suffix is appended. .SH OPTIONS .INDENT 0.0 .TP -.B \fB\-f\fP +\fB\-f\fP Enable binary output on terminals. Normally, \fBllvm\-as\fP will refuse to write raw bitcode output if the output stream is a terminal. With this option, \fBllvm\-as\fP will write raw bitcode regardless of the output device. .TP -.B \fB\-help\fP +\fB\-help\fP Print a summary of command line options. .TP -.B \fB\-o\fP \fIfilename\fP +\fB\-o\fP \fIfilename\fP Specify the output file name. If \fIfilename\fP is \fB\-\fP, then \fBllvm\-as\fP sends its output to standard output. .UNINDENT @@ -82,6 +82,6 @@ llvm\-dis|llvm\-dis, gccas|gccas .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. . Modified: projects/clang600-import/usr.bin/clang/llvm-bcanalyzer/llvm-bcanalyzer.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/llvm-bcanalyzer/llvm-bcanalyzer.1 Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/llvm-bcanalyzer/llvm-bcanalyzer.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "LLVM-BCANALYZER" "1" "2016-03-03" "3.8" "LLVM" +.TH "LLVM-BCANALYZER" "1" "2017-12-24" "6" "LLVM" .SH NAME llvm-bcanalyzer \- LLVM bitcode analyzer . @@ -467,10 +467,10 @@ Rate encoding scheme. The percentage is relative to # .UNINDENT .SH SEE ALSO .sp -\fB/CommandGuide/llvm\-dis\fP, \fB/BitCodeFormat\fP +/CommandGuide/llvm\-dis, /BitCodeFormat .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. . Modified: projects/clang600-import/usr.bin/clang/llvm-cov/llvm-cov.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/llvm-cov/llvm-cov.1 Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/llvm-cov/llvm-cov.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "LLVM-COV" "1" "2016-03-03" "3.8" "LLVM" +.TH "LLVM-COV" "1" "2017-12-24" "6" "LLVM" .SH NAME llvm-cov \- emit coverage information . @@ -52,6 +52,8 @@ be provided. \fI\%show\fP .IP \(bu 2 \fI\%report\fP +.IP \(bu 2 +\fI\%export\fP .UNINDENT .SH GCOV COMMAND .SS SYNOPSIS @@ -183,12 +185,12 @@ it exits with zero. .SH SHOW COMMAND .SS SYNOPSIS .sp -\fBllvm\-cov show\fP [\fIoptions\fP] \-instr\-profile \fIPROFILE\fP \fIBIN\fP [\fISOURCES\fP] +\fBllvm\-cov show\fP [\fIoptions\fP] \-instr\-profile \fIPROFILE\fP \fIBIN\fP [\fI\-object BIN,...\fP] [[\fI\-object BIN\fP]] [\fISOURCES\fP] .SS DESCRIPTION .sp -The \fBllvm\-cov show\fP command shows line by line coverage of a binary -\fIBIN\fP using the profile data \fIPROFILE\fP\&. It can optionally be filtered to only -show the coverage for the files listed in \fISOURCES\fP\&. +The \fBllvm\-cov show\fP command shows line by line coverage of the +binaries \fIBIN\fP,... using the profile data \fIPROFILE\fP\&. It can optionally be +filtered to only show the coverage for the files listed in \fISOURCES\fP\&. .sp To use \fBllvm\-cov show\fP, you need a program that is compiled with instrumentation to emit profile and coverage data. To build such a program with @@ -197,7 +199,7 @@ flags. If linking with the \fBclang\fP driver, pass \f to the link stage to make sure the necessary runtime libraries are linked in. .sp The coverage information is stored in the built executable or library itself, -and this is what you should pass to \fBllvm\-cov show\fP as the \fIBIN\fP +and this is what you should pass to \fBllvm\-cov show\fP as a \fIBIN\fP argument. The profile data is generated by running this instrumented program normally. When the program exits it will write out a raw profile file, typically called \fBdefault.profraw\fP, which can be converted to a format that @@ -207,45 +209,48 @@ tool. .INDENT 0.0 .TP .B \-show\-line\-counts -Show the execution counts for each line. This is enabled by default, unless -another \fB\-show\fP option is used. +Show the execution counts for each line. Defaults to true, unless another +\fB\-show\fP option is used. .UNINDENT .INDENT 0.0 .TP .B \-show\-expansions Expand inclusions, such as preprocessor macros or textual inclusions, inline -in the display of the source file. +in the display of the source file. Defaults to false. .UNINDENT .INDENT 0.0 .TP .B \-show\-instantiations For source regions that are instantiated multiple times, such as templates in \fBC++\fP, show each instantiation separately as well as the combined summary. +Defaults to true. .UNINDENT .INDENT 0.0 .TP .B \-show\-regions Show the execution counts for each region by displaying a caret that points to -the character where the region starts. +the character where the region starts. Defaults to false. .UNINDENT .INDENT 0.0 .TP .B \-show\-line\-counts\-or\-regions Show the execution counts for each line if there is only one region on the line, but show the individual regions if there are multiple on the line. +Defaults to false. .UNINDENT .INDENT 0.0 .TP -.B \-use\-color[=VALUE] +.B \-use\-color Enable or disable color output. By default this is autodetected. .UNINDENT .INDENT 0.0 .TP -.B \-arch=<name> -If the covered binary is a universal binary, select the architecture to use. -It is an error to specify an architecture that is not included in the -universal binary or to use an architecture that does not match a -non\-universal binary. +.B \-arch=[*NAMES*] +Specify a list of architectures such that the Nth entry in the list +corresponds to the Nth specified binary. If the covered object is a universal +binary, this specifies the architecture to use. It is an error to specify an +architecture that is not included in the universal binary or to use an +architecture that does not match a non\-universal binary. .UNINDENT .INDENT 0.0 .TP @@ -254,11 +259,54 @@ Show code coverage only for functions with the given n .UNINDENT .INDENT 0.0 .TP +.B \-name\-whitelist=<FILE> +Show code coverage only for functions listed in the given file. Each line in +the file should start with \fIwhitelist_fun:\fP, immediately followed by the name +of the function to accept. This name can be a wildcard expression. +.UNINDENT +.INDENT 0.0 +.TP .B \-name\-regex=<PATTERN> Show code coverage only for functions that match the given regular expression. .UNINDENT .INDENT 0.0 .TP +.B \-format=<FORMAT> +Use the specified output format. The supported formats are: "text", "html". +.UNINDENT +.INDENT 0.0 +.TP +.B \-tab\-size=<TABSIZE> +Replace tabs with <TABSIZE> spaces when preparing reports. Currently, this is +only supported for the html format. +.UNINDENT +.INDENT 0.0 +.TP +.B \-output\-dir=PATH +Specify a directory to write coverage reports into. If the directory does not +exist, it is created. When used in function view mode (i.e when \-name or +\-name\-regex are used to select specific functions), the report is written to +PATH/functions.EXTENSION. When used in file view mode, a report for each file +is written to PATH/REL_PATH_TO_FILE.EXTENSION. +.UNINDENT +.INDENT 0.0 +.TP +.B \-Xdemangler=<TOOL>|<TOOL\-OPTION> +Specify a symbol demangler. This can be used to make reports more +human\-readable. This option can be specified multiple times to supply +arguments to the demangler (e.g \fI\-Xdemangler c++filt \-Xdemangler \-n\fP for C++). +The demangler is expected to read a newline\-separated list of symbols from +stdin and write a newline\-separated list of the same length to stdout. +.UNINDENT +.INDENT 0.0 +.TP +.B \-num\-threads=N, \-j=N +Use N threads to write file reports (only applicable when \-output\-dir is +specified). When N=0, llvm\-cov auto\-detects an appropriate number of threads to +use. This is the default. +.UNINDENT +.INDENT 0.0 +.TP .B \-line\-coverage\-gt=<N> Show code coverage only for functions with line coverage greater than the given threshold. @@ -281,15 +329,22 @@ given threshold. Show code coverage only for functions with region coverage less than the given threshold. .UNINDENT +.INDENT 0.0 +.TP +.B \-path\-equivalence=<from>,<to> +Map the paths in the coverage data to local source file paths. This allows you +to generate the coverage data on one machine, and then use llvm\-cov on a +different machine where you have the same files on a different path. +.UNINDENT .SH REPORT COMMAND .SS SYNOPSIS .sp -\fBllvm\-cov report\fP [\fIoptions\fP] \-instr\-profile \fIPROFILE\fP \fIBIN\fP [\fISOURCES\fP] +\fBllvm\-cov report\fP [\fIoptions\fP] \-instr\-profile \fIPROFILE\fP \fIBIN\fP [\fI\-object BIN,...\fP] [[\fI\-object BIN\fP]] [\fISOURCES\fP] .SS DESCRIPTION .sp -The \fBllvm\-cov report\fP command displays a summary of the coverage of a -binary \fIBIN\fP using the profile data \fIPROFILE\fP\&. It can optionally be filtered to -only show the coverage for the files listed in \fISOURCES\fP\&. +The \fBllvm\-cov report\fP command displays a summary of the coverage of +the binaries \fIBIN\fP,... using the profile data \fIPROFILE\fP\&. It can optionally be +filtered to only show the coverage for the files listed in \fISOURCES\fP\&. .sp If no source files are provided, a summary line is printed for each file in the coverage data. If any files are provided, summaries are shown for each function @@ -311,9 +366,48 @@ It is an error to specify an architecture that is not universal binary or to use an architecture that does not match a non\-universal binary. .UNINDENT +.INDENT 0.0 +.TP +.B \-show\-functions +Show coverage summaries for each function. Defaults to false. +.UNINDENT +.INDENT 0.0 +.TP +.B \-show\-instantiation\-summary +Show statistics for all function instantiations. Defaults to false. +.UNINDENT +.SH EXPORT COMMAND +.SS SYNOPSIS +.sp +\fBllvm\-cov export\fP [\fIoptions\fP] \-instr\-profile \fIPROFILE\fP \fIBIN\fP [\fI\-object BIN,...\fP] [[\fI\-object BIN\fP]] +.SS DESCRIPTION +.sp +The \fBllvm\-cov export\fP command exports regions, functions, expansions, +and summaries of the coverage of the binaries \fIBIN\fP,... using the profile data +\fIPROFILE\fP as JSON. +.sp +For information on compiling programs for coverage and generating profile data, +see \fI\%SHOW COMMAND\fP\&. +.SS OPTIONS +.INDENT 0.0 +.TP +.B \-arch=<name> +If the covered binary is a universal binary, select the architecture to use. +It is an error to specify an architecture that is not included in the +universal binary or to use an architecture that does not match a +non\-universal binary. +.UNINDENT +.INDENT 0.0 +.TP +.B \-summary\-only +Export only summary information for each file in the coverage data. This mode +will not export coverage information for smaller units such as individual +functions or regions. The result will be the same as produced by :program: +\fIllvm\-cov report\fP command, but presented in JSON format rather than text. +.UNINDENT .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. . Modified: projects/clang600-import/usr.bin/clang/llvm-diff/llvm-diff.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/llvm-diff/llvm-diff.1 Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/llvm-diff/llvm-diff.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "LLVM-DIFF" "1" "2016-03-03" "3.8" "LLVM" +.TH "LLVM-DIFF" "1" "2017-12-24" "6" "LLVM" .SH NAME llvm-diff \- LLVM structural 'diff' . @@ -72,6 +72,6 @@ massive detected differences in blocks. .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. . Modified: projects/clang600-import/usr.bin/clang/llvm-dis/llvm-dis.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/llvm-dis/llvm-dis.1 Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/llvm-dis/llvm-dis.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "LLVM-DIS" "1" "2016-03-03" "3.8" "LLVM" +.TH "LLVM-DIS" "1" "2017-12-24" "6" "LLVM" .SH NAME llvm-dis \- LLVM disassembler . @@ -83,6 +83,6 @@ llvm\-as|llvm\-as .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. . Modified: projects/clang600-import/usr.bin/clang/llvm-dwarfdump/llvm-dwarfdump.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/llvm-dwarfdump/llvm-dwarfdump.1 Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/llvm-dwarfdump/llvm-dwarfdump.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -1,9 +1,9 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "LLVM-DWARFDUMP" "1" "2016-03-03" "3.8" "LLVM" +.TH "LLVM-DWARFDUMP" "1" "2017-12-24" "6" "LLVM" .SH NAME -llvm-dwarfdump \- print contents of DWARF sections +llvm-dwarfdump \- dump and verify DWARF debug information . .nr rst2man-indent-level 0 . @@ -33,28 +33,157 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-lev .. .SH SYNOPSIS .sp -\fBllvm\-dwarfdump\fP [\fIoptions\fP] [\fIfilenames...\fP] +\fBllvm\-dwarfdump\fP [\fIoptions\fP] [\fIfilename ...\fP] .SH DESCRIPTION .sp -\fBllvm\-dwarfdump\fP parses DWARF sections in the object files -and prints their contents in human\-readable form. +\fBllvm\-dwarfdump\fP parses DWARF sections in object files, +archives, and \fI\&.dSYM\fP bundles and prints their contents in +human\-readable form. Only the .debug_info section is printed unless one of +the section\-specific options or \fI\%\-\-all\fP is specified. .SH OPTIONS .INDENT 0.0 .TP -.B \-debug\-dump=section -Specify the DWARF section to dump. -For example, use \fBabbrev\fP to dump the contents of \fB\&.debug_abbrev\fP section, -\fBloc.dwo\fP to dump the contents of \fB\&.debug_loc.dwo\fP etc. -See \fBllvm\-dwarfdump \-\-help\fP for the complete list of supported sections. -Use \fBall\fP to dump all DWARF sections. It is the default. +.B \-a, \-\-all +Disassemble all supported DWARF sections. .UNINDENT +.INDENT 0.0 +.TP +.B \-\-arch=<arch> +Dump DWARF debug information for the specified CPU architecture. +Architectures may be specified by name or by number. This +option can be specified multiple times, once for each desired +architecture. All CPU architectures will be printed by +default. +.UNINDENT +.INDENT 0.0 +.TP +.B \-c, \-\-show\-children +Show a debug info entry\(aqs children when using +the \fI\%\-\-debug\-info\fP, \fI\%\-\-find\fP, +and \fI\%\-\-name\fP options. +.UNINDENT +.INDENT 0.0 +.TP +.B \-f <name>, \-\-find=<name> +Search for the exact text <name> in the accelerator tables +and print the matching debug information entries. +When there is no accelerator tables or the name of the DIE +you are looking for is not found in the accelerator tables, +try using the slower but more complete \fI\%\-\-name\fP option. +.UNINDENT +.INDENT 0.0 +.TP +.B \-F, \-\-show\-form +Show DWARF form types after the DWARF attribute types. +.UNINDENT +.INDENT 0.0 +.TP +.B \-h, \-\-help +Show help and usage for this command. +.UNINDENT +.INDENT 0.0 +.TP +.B \-i, \-\-ignore\-case +Ignore case distinctions in when searching entries by name +or by regular expression. +.UNINDENT +.INDENT 0.0 +.TP +.B \-n <pattern>, \-\-name=<pattern> +Find and print all debug info entries whose name +(\fIDW_AT_name\fP attribute) matches the exact text in +<pattern>. Use the \fI\%\-\-regex\fP option to have +<pattern> become a regular expression for more flexible +pattern matching. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-lookup=<address> +Lookup <address> in the debug information and print out the file, +function, block, and line table details. +.UNINDENT +.INDENT 0.0 +.TP +.B \-o <path>, \-\-out\-file=<path> +Redirect output to a file specified by <path>. +.UNINDENT +.INDENT 0.0 +.TP +.B \-p, \-\-show\-parents +Show a debug info entry\(aqs parent objects when using the +\fI\%\-\-debug\-info\fP, \fI\%\-\-find\fP, and +\fI\%\-\-name\fP options. +.UNINDENT +.INDENT 0.0 +.TP +.B \-r <n>, \-\-recurse\-depth=<n> +Only recurse to a maximum depth of <n> when dumping debug info +entries. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-statistics +Collect debug info quality metrics and print the results +as machine\-readable single\-line JSON output. +.UNINDENT +.INDENT 0.0 +.TP +.B \-x, \-\-regex +Treat any <pattern> strings as regular expressions when searching +instead of just as an exact string match. +.UNINDENT +.INDENT 0.0 +.TP +.B \-u, \-\-uuid +Show the UUID for each architecture. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-diff +Dump the output in a format that is more friendly for comparing +DWARF output from two different files. +.UNINDENT +.INDENT 0.0 +.TP +.B \-v, \-\-verbose +Display verbose information when dumping. This can help to debug +DWARF issues. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-verify +Verify the structure of the DWARF information by verifying the +compile unit chains, DIE relationships graph, address +ranges, and more. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-version +Display the version of the tool. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-debug\-abbrev, \-\-debug\-aranges, \-\-debug\-cu\-index, \-\-debug\-frame [=<offset>], \-\-debug\-gnu\-pubnames, \-\-debug\-gnu\-pubtypes, \-\-debug\-info [=<offset>], \-\-debug\-line [=<offset>], \-\-debug\-loc [=<offset>], \-\-debug\-macro, \-\-debug\-pubnames, \-\-debug\-pubtypes, \-\-debug\-ranges, \-\-debug\-str, \-\-debug\-str\-offsets, \-\-debug\-tu\-index, \-\-debug\-types, \-\-eh\-frame, \-\-gdb\-index, \-\-apple\-names, \-\-apple\-types, \-\-apple\-namespaces, \-\-apple\-objc +Dump the specified DWARF section by name. Only the +\fI\&.debug_info\fP section is shown by default. Some entries +support adding an \fI=<offset>\fP as a way to provide an +optional offset of the exact entry to dump within the +respective section. When an offset is provided, only the +entry at that offset will be dumped, else the entire +section will be dumped. Children of items at a specific +offset can be dumped by also using the +\fI\%\-\-show\-children\fP option where applicable. +.UNINDENT .SH EXIT STATUS .sp \fBllvm\-dwarfdump\fP returns 0 if the input files were parsed and dumped successfully. Otherwise, it returns 1. +.SH SEE ALSO +.sp +\fBdsymutil(1)\fP .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. . Modified: projects/clang600-import/usr.bin/clang/llvm-extract/llvm-extract.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/llvm-extract/llvm-extract.1 Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/llvm-extract/llvm-extract.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "LLVM-EXTRACT" "1" "2016-03-03" "3.8" "LLVM" +.TH "LLVM-EXTRACT" "1" "2017-12-24" "6" "LLVM" .SH NAME llvm-extract \- extract a function from an LLVM module . @@ -124,6 +124,6 @@ bugpoint .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. . Modified: projects/clang600-import/usr.bin/clang/llvm-link/llvm-link.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/llvm-link/llvm-link.1 Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/llvm-link/llvm-link.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "LLVM-LINK" "1" "2016-03-03" "3.8" "LLVM" +.TH "LLVM-LINK" "1" "2017-12-24" "6" "LLVM" .SH NAME llvm-link \- LLVM bitcode linker . @@ -84,6 +84,6 @@ occurs, it will exit with a non\-zero value. .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. . Modified: projects/clang600-import/usr.bin/clang/llvm-nm/llvm-nm.1 ============================================================================== --- projects/clang600-import/usr.bin/clang/llvm-nm/llvm-nm.1 Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/llvm-nm/llvm-nm.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -1,7 +1,7 @@ .\" $FreeBSD$ .\" Man page generated from reStructuredText. . -.TH "LLVM-NM" "1" "2016-03-03" "3.8" "LLVM" +.TH "LLVM-NM" "1" "2017-12-24" "6" "LLVM" .SH NAME llvm-nm \- list LLVM bitcode and object file's symbol table . @@ -115,12 +115,12 @@ file. .INDENT 0.0 .TP .B \-B (default) -Use BSD output format. Alias for \fB\-\-format=bsd\fP\&. +Use BSD output format. Alias for \fI\-\-format=bsd\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-P -Use POSIX.2 output format. Alias for \fB\-\-format=posix\fP\&. +Use POSIX.2 output format. Alias for \fI\-\-format=posix\fP\&. .UNINDENT .INDENT 0.0 .TP @@ -186,14 +186,17 @@ Sort symbols by size. .B \-\-undefined\-only, \-u Print only symbols referenced but not defined in this file. .UNINDENT +.INDENT 0.0 +.TP +.B \-\-radix=RADIX, \-t +Specify the radix of the symbol address(es). Values accepted d(decimal), +x(hexadecomal) and o(octal). +.UNINDENT .SH BUGS .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP \(bu 2 -\fBllvm\-nm\fP cannot demangle C++ mangled names, like GNU \fBnm\fP -can. -.IP \(bu 2 \fBllvm\-nm\fP does not support the full set of arguments that GNU \fBnm\fP does. .UNINDENT @@ -208,6 +211,6 @@ llvm\-dis, ar(1), nm(1) .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. . Modified: projects/clang600-import/usr.bin/clang/llvm-pdbutil/Makefile ============================================================================== --- projects/clang600-import/usr.bin/clang/llvm-pdbutil/Makefile Sun Dec 24 12:46:28 2017 (r327146) +++ projects/clang600-import/usr.bin/clang/llvm-pdbutil/Makefile Sun Dec 24 13:02:43 2017 (r327147) @@ -1,7 +1,6 @@ # $FreeBSD$ PROG_CXX= llvm-pdbutil -MAN= SRCDIR= tools/llvm-pdbutil SRCS+= Analyze.cpp Added: projects/clang600-import/usr.bin/clang/llvm-pdbutil/llvm-pdbutil.1 ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ projects/clang600-import/usr.bin/clang/llvm-pdbutil/llvm-pdbutil.1 Sun Dec 24 13:02:43 2017 (r327147) @@ -0,0 +1,745 @@ +.\" $FreeBSD$ +.\" Man page generated from reStructuredText. +. +.TH "LLVM-PDBUTIL" "1" "2017-12-24" "6" "LLVM" +.SH NAME +llvm-pdbutil \- PDB File forensics and diagnostics +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.INDENT 0.0 +.IP \(bu 2 +\fI\%Synopsis\fP +.IP \(bu 2 +\fI\%Description\fP +.IP \(bu 2 +\fI\%Subcommands\fP +.INDENT 2.0 +.IP \(bu 2 +\fI\%pretty\fP +.INDENT 2.0 +.IP \(bu 2 +\fI\%Summary\fP +.IP \(bu 2 +\fI\%Options\fP +.INDENT 2.0 +.IP \(bu 2 +\fI\%Filtering and Sorting Options\fP +.IP \(bu 2 +\fI\%Symbol Type Options\fP +.IP \(bu 2 +\fI\%Other Options\fP +.UNINDENT +.UNINDENT +.IP \(bu 2 +\fI\%dump\fP +.INDENT 2.0 +.IP \(bu 2 +\fI\%Summary\fP +.IP \(bu 2 +\fI\%Options\fP +.INDENT 2.0 +.IP \(bu 2 +\fI\%MSF Container Options\fP +.IP \(bu 2 +\fI\%Module & File Options\fP +.IP \(bu 2 +\fI\%Symbol Options\fP +.IP \(bu 2 +\fI\%Type Record Options\fP +.IP \(bu 2 +\fI\%Miscellaneous Options\fP +.UNINDENT +.UNINDENT +.IP \(bu 2 +\fI\%bytes\fP +.INDENT 2.0 +.IP \(bu 2 +\fI\%Summary\fP +.IP \(bu 2 +\fI\%Options\fP +.INDENT 2.0 +.IP \(bu 2 +\fI\%MSF File Options\fP +.IP \(bu 2 +\fI\%PDB Stream Options\fP +.IP \(bu 2 +\fI\%DBI Stream Options\fP +.IP \(bu 2 +\fI\%Module Options\fP +.IP \(bu 2 +\fI\%Type Record Options\fP +.UNINDENT +.UNINDENT +.IP \(bu 2 +\fI\%pdb2yaml\fP +.INDENT 2.0 +.IP \(bu 2 +\fI\%Summary\fP +.IP \(bu 2 +\fI\%Options\fP +.UNINDENT +.IP \(bu 2 +\fI\%yaml2pdb\fP +.INDENT 2.0 +.IP \(bu 2 +\fI\%Summary\fP +.IP \(bu 2 +\fI\%Options\fP +.UNINDENT +.IP \(bu 2 +\fI\%merge\fP +.INDENT 2.0 +.IP \(bu 2 +\fI\%Summary\fP +.IP \(bu 2 +\fI\%Options\fP +.UNINDENT +.UNINDENT +.UNINDENT +.SH SYNOPSIS +.sp +\fBllvm\-pdbutil\fP [\fIsubcommand\fP] [\fIoptions\fP] +.SH DESCRIPTION +.sp +Display types, symbols, CodeView records, and other information from a +PDB file, as well as manipulate and create PDB files. \fBllvm\-pdbutil\fP +is normally used by FileCheck\-based tests to test LLVM\(aqs PDB reading and +writing functionality, but can also be used for general PDB file investigation +and forensics, or as a replacement for cvdump. +.SH SUBCOMMANDS +.sp +\fBllvm\-pdbutil\fP is separated into several subcommands each tailored to +a different purpose. A brief summary of each command follows, with more detail +in the sections that follow. +.INDENT 0.0 +.INDENT 3.5 +.INDENT 0.0 +.IP \(bu 2 +\fI\%pretty\fP \- Dump symbol and type information in a format that +tries to look as much like the original source code as possible. +.IP \(bu 2 +\fI\%dump\fP \- Dump low level types and structures from the PDB +file, including CodeView records, hash tables, PDB streams, etc. +.IP \(bu 2 +\fI\%bytes\fP \- Dump data from the PDB file\(aqs streams, records, +types, symbols, etc as raw bytes. +.IP \(bu 2 +\fI\%yaml2pdb\fP \- Given a yaml description of a PDB file, produce +a valid PDB file that matches that description. +.IP \(bu 2 +\fI\%pdb2yaml\fP \- For a given PDB file, produce a YAML +description of some or all of the file in a way that the PDB can be +reconstructed. +.IP \(bu 2 +\fI\%merge\fP \- Given two PDBs, produce a third PDB that is the +result of merging the two input PDBs. +.UNINDENT +.UNINDENT +.UNINDENT +.SS pretty +.sp +\fBIMPORTANT:\fP +.INDENT 0.0 +.INDENT 3.5 +The \fBpretty\fP subcommand is built on the Windows DIA SDK, and as such is not +supported on non\-Windows platforms. +.UNINDENT +.UNINDENT +.sp +USAGE: \fBllvm\-pdbutil\fP pretty [\fIoptions\fP] <input PDB file> +.SS Summary +.sp +The \fIpretty\fP subcommand displays a very high level representation of your +program\(aqs debug info. Since it is built on the Windows DIA SDK which is the +standard API that Windows tools and debuggers query debug information, it +presents a more authoritative view of how a debugger is going to interpret your +debug information than a mode which displays low\-level CodeView records. +.SS Options +.SS Filtering and Sorting Options +.sp +\fBNOTE:\fP +.INDENT 0.0 +.INDENT 3.5 +\fIexclude\fP filters take priority over \fIinclude\fP filters. So if a filter +matches both an include and an exclude rule, then it is excluded. +.UNINDENT +.UNINDENT +.INDENT 0.0 +.TP +.B \-exclude\-compilands=<string> +When dumping compilands, compiland source\-file contributions, or per\-compiland +symbols, this option instructs \fBllvm\-pdbutil\fP to omit any compilands that +match the specified regular expression. +.UNINDENT +.INDENT 0.0 +.TP +.B \-exclude\-symbols=<string> +When dumping global, public, or per\-compiland symbols, this option instructs +\fBllvm\-pdbutil\fP to omit any symbols that match the specified regular +expression. +.UNINDENT +.INDENT 0.0 +.TP +.B \-exclude\-types=<string> +When dumping types, this option instructs \fBllvm\-pdbutil\fP to omit any types +that match the specified regular expression. +.UNINDENT +.INDENT 0.0 +.TP +.B \-include\-compilands=<string> +When dumping compilands, compiland source\-file contributions, or per\-compiland +symbols, limit the initial search to only those compilands that match the +specified regular expression. +.UNINDENT +.INDENT 0.0 +.TP +.B \-include\-symbols=<string> +When dumping global, public, or per\-compiland symbols, limit the initial +search to only those symbols that match the specified regular expression. +.UNINDENT +.INDENT 0.0 +.TP +.B \-include\-types=<string> +When dumping types, limit the initial search to only those types that match +the specified regular expression. +.UNINDENT +.INDENT 0.0 +.TP +.B \-min\-class\-padding=<uint> +Only display types that have at least the specified amount of alignment +padding, accounting for padding in base classes and aggregate field members. +.UNINDENT +.INDENT 0.0 +.TP +.B \-min\-class\-padding\-imm=<uint> +Only display types that have at least the specified amount of alignment +padding, ignoring padding in base classes and aggregate field members. +.UNINDENT *** DIFF OUTPUT TRUNCATED AT 1000 LINES ***
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201712241302.vBOD2hRd080860>