-
Notifications
You must be signed in to change notification settings - Fork 242
/
lcovrc
510 lines (385 loc) · 17.6 KB
/
lcovrc
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
#
# /etc/lcovrc - system-wide defaults for LCOV
#
# To change settings for a single user, place a customized copy of this file
# at location ~/.lcovrc
#
# Note that this example script does not include all configuration options
# see 'man lcovrc(5) for a complete list and usage description.
# Specify an external style sheet file (same as --css-file option of genhtml)
#genhtml_css_file = gcov.css
# use 'dark' mode display (light foreground, dark background) instead of default
# same as 'genhtml --dark-mode ....'
#genhtml_dark_mode = 1
# Header text to use at top of each page
# Default is "LCOV - (differential )? coverage report"
#genhtml_header = Coverage report for my project
# Footer text to use at the bottom of each page
# Default is LCOV tool version
#genhtml_footer = My footer text
# Specify global coverage rate limits (in %) for classifying file entries
# HI: hi_limit <= rate <= 100 graph color: green
# MED: med_limit <= rate < hi_limit graph color: orange
# LO: 0 <= rate < med_limit graph color: red
genhtml_hi_limit = 90
genhtml_med_limit = 75
# Specify line coverage rate limits (in %) for classifying file entries
# HI: ln_hi_limit <= rate <= 100 graph color: green
# MED: ln_med_limit <= rate < ln_hi_limit graph color: orange
# LO: 0 <= rate < ln_med_limit graph color: red
# genhtml_line_hi_limit = 90
# genhtml_line_med_limit = 75
# Specify function coverage rate limits (in %) for classifying file entries
# HI: fn_hi_limit <= rate <= 100 graph color: green
# MED: fn_med_limit <= rate < fn_hi_limit graph color: orange
# LO: 0 <= rate < fn_med_limit graph color: red
# genhtml_function_hi_limit = 90
# genhtml_function_med_limit = 75
# Specify branch coverage rate limits (in %) for classifying file entries
# HI: br_hi_limit <= rate <= 100 graph color: green
# MED: br_med_limit <= rate < br_hi_limit graph color: orange
# LO: 0 <= rate < br_med_limit graph color: red
# genhtml_branch_hi_limit = 90
# genhtml_branch_med_limit = 75
# Ignore some errors during geninfo/lcov/genhtml processing - comma-separated
# string. Same as using "--ignore-errors a,b,c" command line option.
# See man pages for list of ignorable messages
#ignore_errors = empty,mismatch
# Stop emitting message after this number have been printed
# 0 == no limit
max_message_count = 100
# If set, do not stop when an 'ignorable error' occurs - try to generate
# a result, however flawed. This is equivalent to the '--keep-going'
# command line switch.
# Default is 1: stop when error occurs
# See the man pages for more detail
#stop_on_error = 1
# If nonzero, treat warnings as error
# note that ignored messages will still appear as warnings
# Default is 0
#treat_warning_as_error = 1
# If set to non-zero, only issue particluar warning once per file
# Default is 1
#warn_once_per_file = 1
# extension associated with lcov trace files - glob match pattern
# used as argument to 'find' - to find coverage files contained in
# a directory argument
#info_file_pattern = *.info
# List of file extensions which should be treated as RTL code (e.g., Verilog)
# Comma-separated list. Default is "v,vh,sv,vhd?"
#rtl_file_extensions = v,vh,sv,vhd?
# list of file extensions which should be treated as C/C++ code
# (comma-separated list)
#c_file_extensions = h,c,i,C,H,I,cpp,hpp,icc,cc,hh,cxx,hxx
# list of file extensions which should be treated as Java code
#java_file_extensions = java
# list of file extensions which should be treated as perl code
#perl_file_extensions = pl,pm
# list of file extensions which should be treated as python code
#python_file_extensions = py
# maximum number of lines to look at, when filtering bogus branch expressions
#filter_lookahead = 5
# if nonzero, bitwise operators '|', '&', '~' indicate conditional expressions
#filter_bitwise_conditional = 1
# if nonzero, '--filter blank' is applied to blank lines, regardless
# of their hit count
#filter_blank_aggressive = 1
# Width of line coverage field in source code view
genhtml_line_field_width = 12
# Width of branch coverage field in source code view
genhtml_branch_field_width = 16
# Width of MC/DC coverage field in source code view
genhtml_mcdc_field_width = 16
# width of 'owner' field in source code view - default is 20
#genhtml_owner_field_width = 20
# width of 'age' field in source code view - default is 5
#genhtml_age_field_width = 5
# Width of overview image (used by --frames option of genhtml)
genhtml_overview_width = 80
# Resolution of overview navigation: this number specifies the maximum
# difference in lines between the position a user selected from the overview
# and the position the source code window is scrolled to (used by --frames
# option of genhtml)
genhtml_nav_resolution = 4
# Clicking a line in the overview image should show the source code view at
# a position a bit further up so that the requested line is not the first
# line in the window. This number specifies that offset in lines (used by
# --frames option of genhtml)
genhtml_nav_offset = 10
# Do not remove unused test descriptions if non-zero (same as
# --keep-descriptions option of genhtml)
genhtml_keep_descriptions = 0
# Do not remove prefix from directory names if non-zero (same as --no-prefix
# option of genhtml)
genhtml_no_prefix = 0
# Do not create source code view if non-zero (same as --no-source option of
# genhtml)
genhtml_no_source = 0
# Replace tabs with number of spaces in source view (same as --num-spaces
# option of genhtml)
genhtml_num_spaces = 8
# Include color legend in HTML output if non-zero (same as --legend option of
# genhtml)
genhtml_legend = 0
# Use FILE as HTML prolog for generated pages (same as --html-prolog option of
# genhtml)
#genhtml_html_prolog = FILE
# Use FILE as HTML epilog for generated pages (same as --html-epilog option of
# genhtml)
#genhtml_html_epilog = FILE
# Use custom filename extension for pages (same as --html-extension option of
# genhtml)
#genhtml_html_extension = html
# Compress all generated html files with gzip.
#genhtml_html_gzip = 1
# Include sorted overview pages (can be disabled by the --no-sort option of
# genhtml)
genhtml_sort = 1
# Display coverage idata in hierarchical directory structure rather than
# top/directory/source
#genhtml_hierarchical = 1
# Display coverage data using 'flat' view: top-level table holds all
# files with no intermediate directory pages.
#genhtml_flat_view = 1
# Enable hyperlinks from coverage summary table to first source code line
# in corresponding category ('Hit' or "Missed') in non-differential report.
# Feature is always enabled in differential coverage report.
#genhtml_show_navigation = 1
# If nonzero, add column to "function coverage detail" table to show the proportion of lines and branches within the function which are exercised.
#genhtml_show_function_proportion = 0
# Specify the character set of all generated HTML pages
genhtml_charset=UTF-8
# Allow HTML markup in test case description text if non-zero
genhtml_desc_html=0
# Specify the precision for coverage rates
#genhtml_precision=1
# Show missed counts instead of hit counts
#genhtml_missed=1
# group function aliases in report - see '--merge' section in man(1) genhtml
#merge_function_aliasess = 1
# If set, suppress list of aliases in function detail table
#suppress_function_aliases = 1
# If set, derive function end line from line coverpoint data - default ON
#derive_function_end_line = 1
# If set, derive function end lines for all file types.
# By default, we derive end lines for C/C++ files only
#derive_end_line_all_files = 0
# Maximum size of function (number lines) which will be checked by '--filter trivial'
#trivial_function_threshold = 5
# Set threshold for hit count which tool should deem likely to indicate
# a toolchain bug (corrupt coverage data)
# excessive_count_theshold = number
# Demangle C++ symbols
# Call multiple times to specify command and command line arguments
# ('-Xlinker'-like behaviour)
#demangle_cpp = c++filt
# Name of the tool used for demangling C++ function names
# This argument is deprecated - please use 'demangle_cpp' instead
#genhtml_demangle_cpp_tool = c++filt
# Specify extra parameters to be passed to the demangling tool
# This argument is deprecated - please use 'demangle_cpp' instead
#genhtml_demangle_cpp_params = ""
# Location of the gcov tool (same as --gcov-info option of geninfo)
#geninfo_gcov_tool = gcov
# Adjust test names to include operating system information if non-zero
#geninfo_adjust_testname = 0
# Ignore testcase names in .info file
#forget_testcase_names = 0
# Calculate checksum for each source code line if non-zero (same as --checksum
# option of geninfo if non-zero, same as --no-checksum if zero)
#checksum = 1
# Specify whether to capture coverage data for external source files (can
# be overridden by the --external and --no-external options of geninfo/lcov)
#geninfo_external = 1
# Specify whether to capture coverage data from compile-time data files
# which have no corresponding runtime data.
#geninfo_capture_all = 1
# Enable libtool compatibility mode if non-zero (same as --compat-libtool option
# of geninfo if non-zero, same as --no-compat-libtool if zero)
#geninfo_compat_libtool = 0
# Use gcov's --all-blocks option if non-zero
#geninfo_gcov_all_blocks = 1
# Adjust 'executed' non-zero hit count of lines which contain no branches
# and have attribute '"unexecuted_blocks": true'
#geninfo_unexecuted_blocks = 0
# Specify compatibility modes (same as --compat option of geninfo).
#geninfo_compat = libtool=on, hammer=auto, split_crc=auto
# Adjust path to source files by removing or changing path components that
# match the specified pattern (Perl regular expression format)
#geninfo_adjust_src_path = /tmp/build => /usr/src
# Specify if geninfo should try to automatically determine the base-directory
# when collecting coverage data.
geninfo_auto_base = 1
# Use gcov intermediate format? Valid values are 0, 1, auto
geninfo_intermediate = auto
# Specify if exception branches should be excluded from branch coverage.
no_exception_branch = 0
# Directory containing gcov kernel files
# lcov_gcov_dir = /proc/gcov
# Location of the insmod tool
lcov_insmod_tool = /sbin/insmod
# Location of the modprobe tool
lcov_modprobe_tool = /sbin/modprobe
# Location of the rmmod tool
lcov_rmmod_tool = /sbin/rmmod
# Location for temporary directories
lcov_tmp_dir = /tmp
# Show full paths during list operation if non-zero (same as --list-full-path
# option of lcov)
lcov_list_full_path = 0
# Specify the maximum width for list output. This value is ignored when
# lcov_list_full_path is non-zero.
lcov_list_width = 80
# Specify the maximum percentage of file names which may be truncated when
# choosing a directory prefix in list output. This value is ignored when
# lcov_list_full_path is non-zero.
lcov_list_truncate_max = 20
# Specify if function coverage data should be collected, processed, and displayed
function_coverage = 1
# Specify if branch coverage data should be collected, processed, and displayed
branch_coverage = 0
# Specify if MC/DC coverage data should be collected, processed, and displayed
mcdc_coverage = 0
# Ask lcov/genhtml/geninfo to return non-zero exit code if branch coverage is below
# threshold
# Default is 0.0 - i.e., do not check threshold.
#fail_under_branches = 75.0
# Ask lcov/genhtml/geninfo to return non-zero exit code if line coverage is below
# threshold
# Default is 0.0 - i.e., do not check threshold.
#fail_under_lines = 97.5
# specify revision control annotation script for genhtml
#genhtml_annotate_script = path_to_my_executable
# specify the annotation popup that will appear if user hovers over source code
# set to empty to elide tooltip
# Substitutions:
# %d: line number
# %C: commit ID (from annotate callback - see --anotate-script entry in
# genhtml documentation)
# %U: commit author abbreviated name
# %F: commit author full name
# %D: commit date (as returned by annotate callback)
# %d: simplified commit date - yyyy-mm-dd part only (remove time of day)
# %A: commit age
# %l: line number
#genhtml_annotate_tooltip = Commit ID: %C by %F on %D
# specify coverage criteria script for genhtml/lcov/geninfo
#criteria_script = path_to_my_executable_or_module
# specify whether you want date and/or owner information passed to your criteria
# callback - in addition to summary information, which is always returned
#criteria_callback_data = date,owner
# specify when the criteria callback will be executed
#criteria_callback_levels = top,directory,file
# specify callback to decide whether particular source line should be
# included or suppresses
# select_script = path_to_exe | callback_parameter
# specify number of lines of context to include around each selected
# source line
# num_context_lines = 5
# specify age cutpoints for genhtml date bins
# can call option multiple times or use comma-separted list (or both)
#genhtml_date_bins = 7
#genhtml_date_bins = 30,180
# if enabled, show 'author' coverpoint summary table in page headers
# if not 'all', then show only authors who are responsible for coverpoints
# which are not hit
#genhtml_show_owner_table = 0 | 1 | all
# truncate owner table to show at most this many authors -
# subset will be those with the highest count of un-exercised code
# owner_table_entries = 5
# truncate the owner table at this level/these levels only
# possible values are 'file', 'directory', 'top' (without quotes)
# option may be specified multiple times and/or as a comma-separated list
# truncate_owner_table = top,directory,file
# if enabled, show author of non-code source lines (e.g., comments)
# in 'source' detail column
#genhtml_show_noncode_owners = 0 | 1
# if enabled, generate fake source code for missing files and out-of-range
# lines
#genhtml_synthesize_missing = 0 | 1
# ask geninfo/lcov/genhtml to include only certain files (glob match pattern)
# call multiple times to specify multiple patterns
#include = my/files/*.c
#include = my/files/*.h
# ask geninfo/lcov/genhtml to exclude certain files (glob match pattern)
# call multiple times to specify multiple patterns
#exclude = your/files/*.c
#exclude = your/files/*.h
# ask geninfo/lcov/genhtml to munge file pathnames when reading/writing .info files
# call multiple times to specify multiple patterns
# this pattern removes "/.lib" from the pathname (see the lcov man page for details)
#substitute = s#/.libs##g
# this pattern changes "/tmp/build" to "/usr/src" (see the lcov man page for details)
#substitute = s#/tmp/build#/usr/src#g
# ask geninfo/lcov/genhtml to exclude coverpoints associated with lines which match
# the regexp. Call multiple times to specify multiple patterns
# omit lines which end with "// MY_LINE_EXCLUDE_MARKER
#omit_lines = .+?//\s*MY_LINE_EXCLUDE_MARKER\s*
# add another exclusion marker
#omit_lines = .+?//\s*MY_PROJECT_EXCLUDE_MARKER\s*
# ask geninfo/lcov/genhtml to exclude coverpoints whose lines are within
# the start/end of a function matching the regexp.
#Call multiple times to specify multiple patterns
#erase_functions = main
# and another - note that this looks like a demangled C++ function
# that the argument is a regexp - so special characters need to be escaped
#erase_functions = debug)_.*\(int,\s*int\)
# check that source file exists before calling version-script, annotate-script
# or other callback. If set and file does not exist, 'source' error is
# generated. Default: 1 (check for existence).
#check_existence_before_callback = 1
# specify path to version identification script
#version_script = path_to_my_executable
# tell the tool to generate missing file version information when
# readind coverage DB file
# compute_file_version = 0 | 1
# specify path to file pathname resolution script
#resolve_script = path_to_my_executable
# Specify JSON module to use, or choose best available if set to auto
lcov_json_module = auto
# Specify maximum number of parallel slaves
# default: 1 (no parallelism)
#parallel = 1
# Specify maximum memory to use during parallel processing, in Mb.
# Do not fork if estimated memory consumption exceeds this number.
# default: 0 (no limit)
#memory = 1024
# Specify the number of consecutive fork() failures to allow before
# giving up
# max_fork_fails = 5
# Throttling control: the maximum number of files that genhtml will
# handle in a single (parallel) thread
# max_tasks_per_core = 20
# Seconds to wait after failing to fork() before retrying
# fork_fail_timeout = 10
# Throttling control: specify a percentage of system memory to use as
# maximum during parallel processing.
# Do not fork if estimated memory consumption exceeds the maximum.
# this value is used only if the maximum memory is not set.
# default: not set
#memory_percentage = 1024
# Character used to split list-type parameters
# - for example, the list of "--ignore_errors source,mismatch"
# default: , (comma)
#split_char = ,
# use case insensitive compare to find matching files, for include/exclude
# directives, etc
#case_insensitive = 0
# override line default line exclusion regexp
#lcov_excl_line = LCOV_EXCL_LINE
# override branch exclusion regexp
#lcov_excl_br_line = LCOV_EXCL_BR_LINE
# override exception branch exclusion regexp
#lcov_excl_exception_br_line = LCOV_EXCL_EXCEPTION_BR_LINE
# override start of exclude region regexp
#lcov_excl_start = LCOV_EXCL_START
# override end of exclude region regexp
#lcov_excl_stop = LCOV_EXCL_STOP
# override start of branch exclude region regexp
#lcov_excl_br_start = LCOV_EXCL_BR_START
# override start of exclude region regexp
#lcov_excl_br_stop = LCOV_EXCL_BR_STOP
# override start of exclude region regexp
#lcov_excl_exception_br_start = LCOV_EXCL_EXCEPTION_BR_START
# override start of exclude region regexp
#lcov_excl_exception_br_stop = LCOV_EXCL_EXCEPTION_BR_STOP