aboutsummaryrefslogtreecommitdiff
path: root/llvm/docs/CommandGuide
AgeCommit message (Collapse)AuthorFilesLines
2016-10-25[llvm-cov] Add support for loading coverage from multiple objectsVedant Kumar1-11/+11
Differential Revision: https://reviews.llvm.org/D25086 llvm-svn: 285088
2016-08-04[llvm-cov] Add some documentation for the -tab-size optionVedant Kumar1-0/+5
Also, un-hide the cl::opt. llvm-svn: 277741
2016-07-26[docs] Fix a sphinx error in llvm-cov.rstVedant Kumar1-0/+4
Failing bot: http://lab.llvm.org:8011/builders/llvm-sphinx-docs/builds/12025 Fix tested with `ninja docs-llvm-html`. llvm-svn: 276820
2016-07-26Retry: [llvm-cov] Add support for exporting coverage data to JSONVedant Kumar1-0/+29
This enables users to export coverage information as portable JSON for use by analysis tools and storage in document based databases. The export sub-command is invoked just like the others: llvm-cov export -instr-profile path/to/foo.profdata path/to/foo.binary The resulting JSON contains a list of files and functions. Every file object contains a list of segments, expansions, and a summary of the file's region, function, and line coverage. Every function object contains the function's name and regions. There is also a total summary for the entire object file. Changes since the initial commit (r276813): - Fixed the regexes in the tests to handle Windows filepaths. Patch by Eddie Hurtig! Differential Revision: https://reviews.llvm.org/D22651 llvm-svn: 276818
2016-07-26Revert "[llvm-cov] Add support for exporting coverage data to JSON"Vedant Kumar1-29/+0
This reverts commit r276813. The Windows bots are complaining about some of the filename regexes in the tests: http://bb.pgr.jp/builders/ninja-clang-i686-msc19-R/builds/5299 llvm-svn: 276816
2016-07-26[llvm-cov] Add support for exporting coverage data to JSONVedant Kumar1-0/+29
This enables users to export coverage information as portable JSON for use by analysis tools and storage in document based databases. The export sub-command is invoked just like the others: llvm-cov export -instr-profile path/to/foo.profdata path/to/foo.binary The resulting JSON contains a list of files and functions. Every file object contains a list of segments, expansions, and a summary of the file's region, function, and line coverage. Every function object contains the function's name and regions. There is also a total summary for the entire object file. Patch by Eddie Hurtig! Differential Revision: https://reviews.llvm.org/D22651 llvm-svn: 276813
2016-07-26[lit] Document the 'available_features' member of the config object.Daniel Sanders1-0/+3
llvm-svn: 276744
2016-07-20[docs] Fixing Sphinx warnings to unclog the buildbotRenato Golin3-12/+12
Lots of blocks had "llvm" or "nasm" syntax types but either weren't following the syntax, or the syntax has changed (and sphinx hasn't keep up) or the type doesn't even exist (nasm?). Other documents had :options: what were invalid. I only removed those that had warnings, and left the ones that didn't, in order to follow the principle of least surprise. This is like this for ages, but the buildbot is now failing on errors. It may take a while to upgrade the buildbot's sphinx, if that's even possible, but that shouldn't stop us from getting docs updates (which seem down for quite a while). Also, we're not losing any syntax highlight, since when it doesn't parse, it doesn't colour. Ie. those blocks are not being highlighted anyway. I'm trying to get all docs in one go, so that it's easy to revert later if we do fix, or at least easy to know what's to fix. llvm-svn: 276109
2016-07-19Retry: [llvm-profdata] Speed up merging by using a thread poolVedant Kumar1-0/+5
Add a "-j" option to llvm-profdata to control the number of threads used. Auto-detect NumThreads when it isn't specified, and avoid spawning threads when they wouldn't be beneficial. I tested this patch using a raw profile produced by clang (147MB). Here is the time taken to merge 4 copies together on my laptop: No thread pool: 112.87s user 5.92s system 97% cpu 2:01.08 total With 2 threads: 134.99s user 26.54s system 164% cpu 1:33.31 total Changes since the initial commit: - When handling odd-length inputs, call ThreadPool::wait() before merging the last profile. Should fix a race/off-by-one (see r275937). Differential Revision: https://reviews.llvm.org/D22438 llvm-svn: 275938
2016-07-19Revert "[llvm-profdata] Speed up merging by using a thread pool"Vedant Kumar1-5/+0
This reverts commit r275921. It broke the ppc64be bot: http://lab.llvm.org:8011/builders/clang-ppc64be-linux-multistage/builds/3537 I'm not sure why it broke, but based on the output, it looks like an off-by-one (one profile left un-merged). llvm-svn: 275937
2016-07-18[llvm-profdata] Speed up merging by using a thread poolVedant Kumar1-0/+5
Add a "-j" option to llvm-profdata to control the number of threads used. Auto-detect NumThreads when it isn't specified, and avoid spawning threads when they wouldn't be beneficial. I tested this patch using a raw profile produced by clang (147MB). Here is the time taken to merge 4 copies together on my laptop: No thread pool: 112.87s user 5.92s system 97% cpu 2:01.08 total With 2 threads: 134.99s user 26.54s system 164% cpu 1:33.31 total Differential Revision: https://reviews.llvm.org/D22438 llvm-svn: 275921
2016-07-15bugpoint: add flag -verbose-errorsSebastian Pop1-0/+8
The default behavior of bugpoint is to print "<crash>" when it finds a reduced test that crashes compilation. With this flag we now can see the output of the crashing program. 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. Differential Revision: https://reviews.llvm.org/D22411 llvm-svn: 275646
2016-07-15[llvm-cov] Optionally use a symbol demangler when preparing reportsVedant Kumar1-0/+8
Add an option to specify a symbol demangler (as well as options to the demangler). This can be used to make reports more human-readable. This option is especially useful in -output-dir mode, since it isn't as easy to manually pipe reports into a demangler in this mode. llvm-svn: 275640
2016-07-06[llvm-cov] Add support for creating html reportsVedant Kumar1-1/+1
Based on a patch by Harlan Haskins! Differential Revision: http://reviews.llvm.org/D18278 llvm-svn: 274688
2016-06-28Reapply "[llvm-cov] Add an -output-dir option for the show sub-command""Vedant Kumar1-0/+8
Passing -output-dir path/to/dir to llvm-cov show creates path/to/dir if it doesn't already exist, and prints reports into that directory. In function view mode, all views are written into path/to/dir/functions.$EXTENSION. In file view mode, all views are written into path/to/dir/coverage/$PATH.$EXTENSION. Changes since the initial commit: - Avoid accidentally closing stdout twice. llvm-svn: 273985
2016-06-28Revert "[llvm-cov] Add an -output-dir option for the show sub-command"Vedant Kumar1-8/+0
This reverts commit r273971. test/profile/instrprof-visibility.cpp is failing because of an uncaught error in SafelyCloseFileDescriptor. llvm-svn: 273978
2016-06-28[llvm-cov] Add an -output-dir option for the show sub-commandVedant Kumar1-0/+8
Passing -output-dir path/to/dir to llvm-cov show creates path/to/dir if it doesn't already exist, and prints reports into that directory. In function view mode, all views are written into path/to/dir/functions.$EXTENSION. In file view mode, all views are written into path/to/dir/coverage/$PATH.$EXTENSION. llvm-svn: 273971
2016-06-28[llvm-cov] Add a format option for the 'show' sub-command (mostly NFC)Vedant Kumar1-0/+4
llvm-svn: 273968
2016-06-27Document the ability to perform multi-line pattern matching in FileCheck.Wolfgang Pieb1-0/+19
Differential review: http://reviews.llvm.org/D21522 llvm-svn: 273962
2016-06-14[FileCheck] Document --check-prefixes.Daniel Sanders1-0/+5
llvm-svn: 272683
2016-06-09[docs] Fix indentation for a tool optionVedant Kumar1-1/+1
llvm-svn: 272309
2016-06-07Retry^4 "[llvm-profdata] Add option to ingest filepaths from a file"Vedant Kumar1-0/+9
Changes since the initial commit: - Use echo instead of printf. This should side-step the character escaping issues on Windows. Differential Revision: http://reviews.llvm.org/D20980 llvm-svn: 272068
2016-06-06Revert "Retry^2 "[llvm-profdata] Add option to ingest filepaths from a file""Vedant Kumar1-9/+0
This reverts commit r271953. It's still breaking on Windows, though the list initialization issue is fixed: http://bb.pgr.jp/builders/ninja-clang-i686-msc19-R/builds/3751 llvm-svn: 271963
2016-06-06Retry^2 "[llvm-profdata] Add option to ingest filepaths from a file"Vedant Kumar1-0/+9
Changes since the initial commit: - Normalize file paths read from the file to prevent Windows path separators from escaping parts of the path. - Since we need to store the normalized file paths in WeightedFile, don't do tricky things to keep the source MemoryBuffer alive. - Don't use list-initialization for a std::string in WeightedFile. Differential Revision: http://reviews.llvm.org/D20980 llvm-svn: 271953
2016-06-06Revert "Retry "[llvm-profdata] Add option to ingest filepaths from a file"Vedant Kumar1-9/+0
This reverts commit r271949. It breaks the Windows build: http://lab.llvm.org:8011/builders/clang-x64-ninja-win7/builds/12796 llvm-svn: 271952
2016-06-06Retry "[llvm-profdata] Add option to ingest filepaths from a file"Vedant Kumar1-0/+9
Changes since the initial commit: - Normalize file paths read from the file to prevent Windows path separators from escaping parts of the path. - Since we need to store the normalized file paths in WeightedFile, don't do tricky things to keep the source MemoryBuffer alive. Differential Revision: http://reviews.llvm.org/D20980 llvm-svn: 271949
2016-06-04[llvm-profdata] Revert r271709 and the 3 subsequent commits - the codeChandler Carruth1-9/+0
and/or tests aren't working on Windows currently. There seems to be some problem with quoting the file paths. I don't understand the test structure here or the code well enough to try to come up with a way to correctly handle paths with back slashes in them, and this has caused the Windows builds to be failing for 7 hours now, so I'm reverting the whole thing to bring them back to life. Sorry for the disruption, but a couple of these were bug fixes anyways that can be folded into a fresh commit. Reverts the following patches: r271756: Clean up the way we create the input filenames buffer (NFC) r271748: Fix use-after-free from discarded MemoryBuffer (NFC) r271710: Fix option description (NFC) r271709: Add option to ingest filepaths from a file llvm-svn: 271760
2016-06-03[llvm-profdata] Add option to ingest filepaths from a fileVedant Kumar1-0/+9
Differential Revision: http://reviews.llvm.org/D20980 llvm-svn: 271709
2016-05-28[docs] Be a bit more precise.Sean Silva1-4/+5
llvm-svn: 271083
2016-04-04Document standard substitutions defined by lit.Paul Robinson1-0/+29
Patch by Guilherme Bufolo! Differential Revision: http://reviews.llvm.org/D18752 llvm-svn: 265314
2016-03-23[docs] Use reST link.Sean Silva1-1/+1
llvm-svn: 264121
2016-03-23[docs] Clarify the sense of --compile-commandSean Silva1-1/+6
In retrospect, it seems "obvious" that the sense of the return code is the same as if it crashed on "interesting" inputs. But that didn't stop me from spending more time than I care to admit verifying this. llvm-svn: 264119
2016-02-11Add -match-full-lines argument to FileCheck.James Y Knight1-0/+12
This is useful for some tests where more-exact matching is useful, such as clang's Preprocessor tests. llvm-svn: 260540
2016-02-10[llvm-nm] Add -radix optionHemant Kulkarni1-0/+5
Differential Revision: http://reviews.llvm.org/D16822 llvm-svn: 260392
2016-01-29[Profiling] Add a -sparse mode to llvm-profdata mergeVedant Kumar1-0/+6
Add an option to llvm-profdata merge for writing out sparse indexed profiles. These profiles omit InstrProfRecords for functions which are never executed. Differential Revision: http://reviews.llvm.org/D16727 llvm-svn: 259258
2016-01-26[llvm-readobj] Add -elf-section-groups optionHemant Kulkarni1-0/+4
Adds a way to inspect SHT_GROUP sections in ELF objects. Displays signature, member sections of these sections. Differential revision: http://reviews.llvm.org/D16555 llvm-svn: 258845
2016-01-07[llvm-symbolizer] Print out non-address lines verbatim.Mike Aizatsky1-3/+3
Differential Revision: http://reviews.llvm.org/D15876 llvm-svn: 257115
2015-12-15[llvm-profdata] Add support for weighted merge of profile data (2nd try)Nathan Slingerland1-1/+40
Summary: This change adds support for specifying a weight when merging profile data with the llvm-profdata tool. Weights are specified by using the --weighted-input=<weight>,<filename> option. Input files not specified with this option (normal positional list after options) are given a default weight of 1. Adding support for arbitrary weighting of input profile data allows for relative importance to be placed on the input data from multiple training runs. Both sampled and instrumented profiles are supported. Reviewers: davidxl, dnovillo, bogner, silvas Subscribers: silvas, davidxl, llvm-commits Differential Revision: http://reviews.llvm.org/D15306 llvm-svn: 255659
2015-12-04Revert "[llvm-profdata] Add support for weighted merge of profile data"Nathan Slingerland1-5/+1
This reverts commit b7250858d96b8ce567681214273ac0e62713c661. Reverting in order to investigate Windows test failure. llvm-svn: 254687
2015-12-04[llvm-profdata] Add support for weighted merge of profile dataNathan Slingerland1-1/+5
This change adds support for an optional weight when merging profile data with the llvm-profdata tool. Weights are specified by adding an option ':<weight>' suffix to the input file names. Adding support for arbitrary weighting of input profile data allows for relative importance to be placed on the input data from multiple training runs. Both sampled and instrumented profiles are supported. Reviewers: dnovillo, bogner, davidxl Subscribers: llvm-commits Differential Revision: http://reviews.llvm.org/D14547 llvm-svn: 254669
2015-11-24Fix sphinx-build error when building documentation.Xinliang David Li1-16/+10
Consolidate the description of -binary/-text option description to avoid duplicate ID error by sphinux-build. llvm-svn: 254018
2015-11-23[PGO] Add --text option for llvm-profdata show|merge commandsXinliang David Li1-1/+18
The new option is similar to the SampleProfile dump option. - dump raw/indexed format into text profile format - merge the profile and output into text profile format. Note that Value Profiling data text format is not yet designed. That functionality will be added later. Differential Revision: http://reviews.llvm.org/D14894 llvm-svn: 253913
2015-11-11Fix docs build break for revision r252798Hemant Kulkarni1-0/+2
llvm-svn: 252812
2015-11-11[Symbolizer]: Add -pretty-print optionHemant Kulkarni1-0/+12
Differential Revision: http://reviews.llvm.org/D13671 llvm-svn: 252798
2015-11-11Reverting r252760Colin LeMahieu1-12/+0
llvm-svn: 252770
2015-11-11[Symbolizer]: Add -pretty-print optionHemant Kulkarni1-0/+12
Differential Revision: http://reviews.llvm.org/D13671 llvm-svn: 252760
2015-11-09[EABI] Add LLVM support for -meabi flagRenato Golin1-0/+6
"GCC requires the freestanding environment provide memcpy, memmove, memset and memcmp": https://gcc.gnu.org/onlinedocs/gcc-5.2.0/gcc/Standards.html Hence in GNUEABI targets LLVM should not convert 'memops' to their equivalent '__aeabi_memops'. This convertion violates GCC contract. The -meabi flag controls whether or not LLVM will modify 'memops' in GNUEABI targets. Without -meabi: use the triple default EABI. With -meabi=default: use the triple default EABI. With -meabi=gnu: use 'memops'. With -meabi=4 or -meabi=5: use '__aeabi_memops'. With -meabi set to an unknown value: same as -meabi=default. Patch by Vinicius Tinti. llvm-svn: 252462
2015-11-06CommandGuide/lit.rst: Document the new commandline option -aMatthias Braun1-0/+5
llvm-svn: 252257
2015-10-12[llvm-symbolizer] Add -print-address optionHemant Kulkarni1-0/+2
Differential Revision: http://reviews.llvm.org/D13518 llvm-svn: 250086
2015-10-12[llvm-symbolizer] Reverting r250067Colin LeMahieu1-2/+0
llvm-svn: 250072