Lines Matching +full:- +full:- +full:add +full:- +full:architecture

4 .nr rst2man-indent-level 0
7 \\$1 \\n[an-margin]
8 level \\n[rst2man-indent-level]
9 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
10 -
11 \\n[rst2man-indent0]
12 \\n[rst2man-indent1]
13 \\n[rst2man-indent2]
18 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
19 . nr rst2man-indent-level +1
24 .\" indent \\n[an-margin]
25 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
26 .nr rst2man-indent-level -1
27 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
30 .TH "LLVM-COV" "1" "2023-05-24" "16" "LLVM"
32 llvm-cov \- emit coverage information
35 \fBllvm\-cov\fP \fIcommand\fP [\fIargs...\fP]
38 The \fBllvm\-cov\fP tool shows code coverage information for
40 work with \fBgcov\fP\-style coverage or with \fBclang\fP\(aqs instrumentation
44 the \fBllvm\-cov gcov\fP command were called. Otherwise, a command should
60 \fBllvm\-cov gcov\fP [\fIoptions\fP] \fISOURCEFILE\fP
63 The \fBllvm\-cov gcov\fP tool reads code coverage data files and displays
68 To use \fBllvm\-cov gcov\fP, you must first build an instrumented version
70 \fB\-fprofile\-arcs\fP and \fB\-ftest\-coverage\fP options to add the
71 instrumentation. (Alternatively, you can use the \fB\-\-coverage\fP option, which
91 where \fBllvm\-cov gcov\fP expects to find them.
93 Once you have generated the coverage data files, run \fBllvm\-cov gcov\fP
102 count is shown as \fB\-\fP if a line does not contain any executable code. If
108 .B \-a, \-\-all\-blocks
110 source code, this option causes llvm\-cov to show the count for each block
115 .B \-b, \-\-branch\-probabilities
120 .B \-c, \-\-branch\-counts
121 Display branch counts instead of probabilities (requires \-b).
125 .B \-m, \-\-demangled\-names
130 .B \-f, \-\-function\-summaries
136 .B \-\-help
137 Display available options (\-\-help\-hidden for more).
141 .B \-l, \-\-long\-file\-names
142 For coverage output of files included from the main source file, add the
144 can be combined with the \-\-preserve\-paths option to use complete paths for
149 .B \-n, \-\-no\-output
155 .B \-o <DIR|FILE>, \-\-object\-directory=<DIR>, \-\-object\-file=<FILE>
164 .B \-p, \-\-preserve\-paths
169 the \-\-long\-file\-names option, this applies to both the main file name and the
174 .B \-r
176 by \fB\-s\fP\&.
180 .B \-s <string>
185 .B \-t, \-\-stdout
190 .B \-u, \-\-unconditional\-branches
191 Include unconditional branches in the output for the \-\-branch\-probabilities
196 .B \-version
197 Display the version of llvm\-cov.
201 .B \-x, \-\-hash\-filenames
207 \fBllvm\-cov gcov\fP returns 1 if it cannot read input files.  Otherwise,
212 \fBllvm\-cov show\fP [\fIoptions\fP] \-instr\-profile \fIPROFILE\fP [\fIBIN\fP] [\fI\-object BIN\fP…
215 The \fBllvm\-cov show\fP command shows line by line coverage of the
222 To use \fBllvm\-cov show\fP, you need a program that is compiled with
224 \fBclang\fP use the \fB\-fprofile\-instr\-generate\fP and \fB\-fcoverage\-mapping\fP
225 flags. If linking with the \fBclang\fP driver, pass \fB\-fprofile\-instr\-generate\fP
229 and this is what you should pass to \fBllvm\-cov show\fP as a \fIBIN\fP
233 is suitable for the \fIPROFILE\fP argument using the \fBllvm\-profdata merge\fP
238 .B \-show\-branches=<VIEW>
244 .B \-show\-line\-counts
246 \fB\-show\fP option is used.
250 .B \-show\-expansions
256 .B \-show\-instantiations
263 .B \-show\-regions
269 .B \-show\-line\-counts\-or\-regions
276 .B \-use\-color
281 .B \-arch=[*NAMES*]
284 binary, this specifies the architecture to use. It is an error to specify an
285 architecture that is not included in the universal binary or to use an
286 architecture that does not match a non\-universal binary.
290 .B \-name=<NAME>
295 .B \-name\-allowlist=<FILE>
302 .B \-name\-regex=<PATTERN>
307 .B \-ignore\-filename\-regex=<PATTERN>
312 .B \-format=<FORMAT>
317 .B \-tab\-size=<TABSIZE>
323 .B \-output\-dir=PATH
325 exist, it is created. When used in function view mode (i.e when \-name or
326 \-name\-regex are used to select specific functions), the report is written to
332 .B \-Xdemangler=<TOOL>|<TOOL\-OPTION>
334 human\-readable. This option can be specified multiple times to supply
335 arguments to the demangler (e.g \fI\-Xdemangler c++filt \-Xdemangler \-n\fP for C++).
336 The demangler is expected to read a newline\-separated list of symbols from
337 stdin and write a newline\-separated list of the same length to stdout.
341 .B \-num\-threads=N, \-j=N
342 Use N threads to write file reports (only applicable when \-output\-dir is
343 specified). When N=0, llvm\-cov auto\-detects an appropriate number of threads to
348 .B \-compilation\-dir=<dir>
350 when binaries have been compiled with one of \fI\-fcoverage\-prefix\-map\fP
351 \fI\-fcoverage\-compilation\-dir\fP, or \fI\-ffile\-compilation\-dir\fP\&.
355 .B \-line\-coverage\-gt=<N>
361 .B \-line\-coverage\-lt=<N>
367 .B \-region\-coverage\-gt=<N>
373 .B \-region\-coverage\-lt=<N>
379 .B \-path\-equivalence=<from>,<to>
381 to generate the coverage data on one machine, and then use llvm\-cov on a
386 .B \-coverage\-watermark=<high>,<low>
390 low should be between 0\-100 and high > low.
394 .B \-debuginfod
402 .B \-debug\-file\-directory=<dir>
410 \fBllvm\-cov report\fP [\fIoptions\fP] \-instr\-profile \fIPROFILE\fP [\fIBIN\fP] [\fI\-object BIN\…
413 The \fBllvm\-cov report\fP command displays a summary of the coverage of
422 function in the listed files if the \fB\-show\-functions\fP option is enabled.
429 .B \-use\-color[=VALUE]
434 .B \-arch=<name>
435 If the covered binary is a universal binary, select the architecture to use.
436 It is an error to specify an architecture that is not included in the
437 universal binary or to use an architecture that does not match a
438 non\-universal binary.
442 .B \-show\-region\-summary
447 .B \-show\-branch\-summary
452 .B \-show\-functions
457 .B \-show\-instantiation\-summary
462 .B \-ignore\-filename\-regex=<PATTERN>
467 .B \-compilation\-dir=<dir>
469 when binaries have been compiled with one of \fI\-fcoverage\-prefix\-map\fP
470 \fI\-fcoverage\-compilation\-dir\fP, or \fI\-ffile\-compilation\-dir\fP\&.
474 .B \-debuginfod
483 .B \-debug\-file\-directory=<dir>
491 \fBllvm\-cov export\fP [\fIoptions\fP] \-instr\-profile \fIPROFILE\fP [\fIBIN\fP] [\fI\-object BIN\…
494 The \fBllvm\-cov export\fP command exports coverage data of the binaries
500 file, the line\-based coverage, branch coverage, and summaries will be exported.
510 .B \-arch=<name>
511 If the covered binary is a universal binary, select the architecture to use.
512 It is an error to specify an architecture that is not included in the
513 universal binary or to use an architecture that does not match a
514 non\-universal binary.
518 .B \-format=<FORMAT>
524 .B \-summary\-only
528 by the \fBllvm\-cov report\fP command, but presented in JSON or lcov
533 .B \-ignore\-filename\-regex=<PATTERN>
537 .B \-skip\-expansions
543 .B \-skip\-functions
546 Skip exporting per\-function coverage data.
549 .B \-num\-threads=N, \-j=N
552 Use N threads to export coverage data. When N=0, llvm\-cov auto\-detects an
557 .B \-compilation\-dir=<dir>
559 when binaries have been compiled with one of \fI\-fcoverage\-prefix\-map\fP
560 \fI\-fcoverage\-compilation\-dir\fP, or \fI\-ffile\-compilation\-dir\fP\&.
564 .B \-debuginfod
573 .B \-debug\-file\-directory=<dir>
581 2003-2023, LLVM Project