Man Linux: Main Page and Category List

NAME

       lcovrc - lcov configuration file

DESCRIPTION

       The  lcovrc  file  contains configuration information for the lcov code
       coverage tool (see lcov(1)).

       The system-wide configuration  file  is  located  at  /etc/lcovrc.   To
       change settings for a single user, place a customized copy of this file
       at location ~/.lcovrc.  Where available, command-line options  override
       configuration file settings.

       Lines in a configuration file can either be:

            * empty  lines or lines consisting only of white space characters.
              These lines are ignored.

            * comment lines which start with a  hash  sign  (’#’).  These  are
              treated like empty lines and will be ignored.

            * statements  in  the  form  ’key  =  value’.   A  list  of  valid
              statements  and  their  description  can  be  found  in  section
              ’OPTIONS’ below.

       Example configuration:

              #
              # Example LCOV configuration file
              #

              # External style sheet file
              #genhtml_css_file = gcov.css

              # Coverage rate limits
              genhtml_hi_limit = 90
              genhtml_med_limit = 75

              # 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 overview image
              genhtml_overview_width = 80

              # Resolution of overview navigation
              genhtml_nav_resolution = 4

              # Offset for source code navigation
              genhtml_nav_offset = 10

              # Do not remove unused test descriptions if non-zero
              genhtml_keep_descriptions = 0

              # Do not remove prefix from directory names if non-zero
              genhtml_no_prefix = 0

              # Do not create source code view if non-zero
              genhtml_no_source = 0

              # Specify size of tabs
              genhtml_num_spaces = 8

              # Highlight lines with converted-only data if non-zero
              genhtml_highlight = 0

              # Include color legend in HTML output if non-zero
              genhtml_legend = 0

              # Include HTML file at start of HTML output
              #genhtml_html_prolog = prolog.html

              # Include HTML file at end of HTML output
              #genhtml_html_epilog = epilog.html

              # Use custom HTML file extension
              #genhtml_html_extension = html

              # Compress all generated html files with gzip.
              #genhtml_html_gzip = 1

              # Include sorted overview pages
              genhtml_sort = 1

              # Include function coverage data display
              genhtml_function_coverage = 1

              # Include branch coverage data display
              genhtml_branch_coverage = 1

              # Location of the gcov tool
              #geninfo_gcov_tool = gcov

              # Adjust test names if non-zero
              #geninfo_adjust_testname = 0

              # Calculate a checksum for each line if non-zero
              geninfo_checksum = 0

              # Enable libtool compatibility mode if non-zero
              geninfo_compat_libtool = 0

              # Directory containing gcov kernel files
              lcov_gcov_dir = /proc/gcov

              # Location for temporary directories
              lcov_tmp_dir = /tmp

OPTIONS

       genhtml_css_file = filename

              Specify  an external style sheet file. Use this option to modify
              the appearance of the  HTML  output  as  generated  by  genhtml.
              During  output generation, a copy of this file will be placed in
              the output directory.

              This option corresponds to the --css-file command line option of
              genhtml.

              By default, a standard CSS file is generated.

       genhtml_hi_limit  = hi_limit
       genhtml_med_limit = med_limit

              Specify  coverage  rate limits for classifying file entries. Use
              this option to modify the coverage rates (in percent) for  line,
              function  and branch coverage at which a result is classified as
              high, medium or low coverage. This  classification  affects  the
              color  of the corresponding entries on the overview pages of the
              HTML output:

              High:   hi_limit  <= rate <= 100        default color: green
              Medium: med_limit <= rate < hi_limit    default color: orange
              Low:    0         <= rate < med_limit   default color: red

              Defaults are 90 and 75 percent.

       genhtml_line_field_width = number_of_characters

              Specify the width (in characters) of the source code view column
              containing line coverage information.

              Default is 12.

       genhtml_branch_field_width = number_of_characters

              Specify the width (in characters) of the source code view column
              containing branch coverage information.

              Default is 16.

       genhtml_overview_width = pixel_size

              Specify the width (in pixel) of the overview image created  when
              generating HTML output using the --frames option of genhtml.

              Default is 80.

       genhtml_nav_resolution = lines

              Specify  the  resolution  of overview navigation when generating
              HTML output using the --frames option of genhtml.   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.

              Default is 4.

       genhtml_nav_offset = lines

              Specify  the  overview  navigation  line  offset as applied when
              generating HTML output using the --frames option of genhtml.

              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.

              Default is 10.

       genhtml_keep_descriptions = 0|1

              If  non-zero, keep unused test descriptions when generating HTML
              output using genhtml.

              This option corresponds to  the  --keep-descriptions  option  of
              genhtml.

              Default is 0.

       genhtml_no_prefix = 0|1

              If  non-zero, do not try to find and remove a common prefix from
              directory names.

              This option corresponds to the --no-prefix option of genhtml.

              Default is 0.

       genhtml_no_source = 0|1

              If non-zero, do not create a source code  view  when  generating
              HTML output using genhtml.

              This option corresponds to the --no-source option of genhtml.

              Default is 0.

       genhtml_num_spaces = num

              Specify  the  number  of  spaces  to  use as replacement for tab
              characters in the HTML source code view as generated by genhtml.

              This option corresponds to the --num-spaces option of genthml.

              Default is 8.

       genhtml_highlight = 0|1

              If  non-zero,  highlight  lines with converted-only data in HTML
              output as generated by genhtml.

              This option corresponds to the --highlight option of genhtml.

              Default is 0.

       genhtml_legend = 0|1

              If non-zero, include a legend explaining the  meaning  of  color
              coding in the HTML output as generated by genhtml.

              This option corresponds to the --legend option of genhtml.

              Default is 0.

       genhtml_html_prolog = filename

              If  set,  include  the  contents  of  the  specified file at the
              beginning of HTML output.

              This option corresponds to the --html-prolog option of  genhtml.

              Default is to use no extra prolog.

       genhtml_html_epilog = filename

              If set, include the contents of the specified file at the end of
              HTML output.

              This option corresponds to the --html-epilog option of  genhtml.

              Default is to use no extra epilog.

       genhtml_html_extension = extension

              If  set,  use  the  specified  string  as filename extension for
              generated HTML files.

              This  option  corresponds  to  the  --html-extension  option  of
              genhtml.

              Default extension is "html".

       genhtml_html_gzip = 0|1

              If set, compress all html files using gzip.

              This option corresponds to the --html-gzip option of genhtml.

              Default extension is 0.

       genhtml_sort = 0|1

              If non-zero, create overview pages sorted by coverage rates when
              generating HTML output using genhtml.

              This option can be set to 0 by using  the  --no-sort  option  of
              genhtml.

              Default is 1.

       genhtml_function_coverage = 0|1

              If non-zero, include function coverage data when generating HTML
              output using genhtml.

              This option can be set to 0 by using the  --no-function-coverage
              option of genhtml.

              Default is 1.

       genhtml_branch_coverage = 0|1

              If  non-zero,  include branch coverage data when generating HTML
              output using genhtml.

              This option can be set to 0 by  using  the  --no-branch-coverage
              option of genhtml.

              Default is 1.

       geninfo_gcov_tool = path_to_gcov

              Specify  the  location  of  the gcov tool (see gcov(1)) which is
              used to generate coverage information from data files.

              Default is ’gcov’.

       geninfo_adjust_testname = 0|1

              If non-zero,  adjust test  names  to  include  operating  system
              information when capturing coverage data.

              Default is 0.

       geninfo_checksum = 0|1

              If  non-zero,  generate  source  code  checksums  when capturing
              coverage data.  Checksums are useful to prevent merging coverage
              data   from  incompatible  source  code  versions  but  checksum
              generation increases the size of coverage  files  and  the  time
              used to generate those files.

              This  option  corresponds  to  the  --checksum and --no-checksum
              command line option of geninfo.

              Default is 0.

       geninfo_compat_libtool = 0|1

              If non-zero, enable libtool  compatibility  mode.  When  libtool
              compatibility  mode is enabled, lcov will assume that the source
              code relating to a .da file located in a directory named ".libs"
              can be found in its parent directory.

              This    option   corresponds   to   the   --compat-libtool   and
              --no-compat-libtool command line option of geninfo.

              Default is 1.

       lcov_gcov_dir = path_to_kernel_coverage_data

              Specify the path to the directory where kernel coverage data can
              be found or leave undefined for auto-detection.

              Default is auto-detection.

       lcov_tmp_dir = temp

              Specify the location of a directory used for temporary files.

              Default is ’/tmp’.

FILES

       /etc/lcovrc
              The system-wide lcov configuration file.

       ~/.lcovrc
              The individual per-user configuration file.

SEE ALSO

       lcov(1), genhtml(1), geninfo(1), gcov(1)