GCOV&LCOV&GCOVR入门
索引
一、概述
代码覆盖率(Code coverage)是衡量软件测试质量的一个重要指标。
它描述了当一个特定的测试套件(test suite)运行时,程序源代码被执行的程度。例如,一些更具体的覆盖率指标有:
- Statement Coverage:描述源代码中有哪些代码行被执行,各自被执行了多少次
- Branch coverage:一般用于描述if语句/或其它条件语句的各分支的执行情况
- Function coverage:顾名思义,描述源代码中有哪些函数被执行了
- ······
代码覆盖率测试工具可以帮助我们发现代码中未被测试的部分,
而gcov则是一款和GCC配套发布的[经典]代码覆盖率分析工具(仅仅是对覆盖率信息文件进行分析)。
同为代码覆盖率分析工具,GCOV&LCOV&GCOVR之间的差异:
- GCOV:与GCC配套,不需要安装,生成纯文本文件
- LCOV:需要安装,跨平台麻烦,生成HTML页面
- GCOVR:需要安装,跨平台容易,且指令比LCOV少,生成HTML页面
PS. 不仅仅是C或者C++,GCC所支持的语言它们应该都是支持的,例如说Fortran
二、关于gcov的安装
gcov是随gcc一起发布的,并不需要独立安装,设法装上gcc就OK了。对于WINDOWS系统,通过MinGW安装gcc相关的组件即可使用gcov。而对于Linux系统而言,通常会默认安装gcc,因此一般不需要自己安装。
三、代码覆盖率测试(以GCOV为例)
首先,我们需要通过gcc的编译选项获取覆盖率信息文件(例如每行代码被执行了多少次啊),
这里的“生成覆盖率信息”的步骤对任何一个覆盖率分析工具都是完全一样的,
然后,用gcov收集、分析覆盖率信息文件并生成代码覆盖率报告。
用于演示的C程序源代码(包含一个计算阶乘的函数):
#include <stdio.h> int factorial(int n); int main()
{
int result0 = factorial();
int result1 = factorial();
int result2 = factorial(); if (result0 != ) printf("test0 failed, actual=%d.\n", result0);
if (result1 != ) printf("test1 failed, actual=%d.\n", result1);
if (result2 != ) printf("test2 failed, actual=%d.\n", result2); return ;
} int factorial(int n)
{
if (n < ) {
printf("Factorial is defined only for non-negative integer numbers.");
return -;
} if (n > ) {
return n * factorial(n - );
} else {
return ;
}
}
factorial.c
1、编译源代码
要生成覆盖率信息文件,必须添加以下编译选项:
gcc -fprofile-arcs -ftest-coverage factorial.c
将factorial.c编译之后,我们将得到一个被“改造”过的可执行程序a.exe,该程序中包含了一些额外的指令,用于记录程序中每一行被执行的次数。以及一个后缀为.gcno的factorial.gcno文件,它是即将被gcov引用的关键数据文件。
编译选项说明:
- -ftest-coverage选项:添加记录单行代码执行次数的指令
- -fprofile-arc选项:添加程序每个分支的检测代码(if或者其它条件语句)
2、运行可执行程序
./a.exe
运行可执行程序之后,我们会得到一个factorial.gcda的文件,它和factorial.gcno一样是即将被gcov引用的数据文件(代码覆盖率信息文件)。
3、通过gcov命令生成代码覆盖率报告
gcov factorial.c
File 'factorial.c'
Lines executed:86.67% of
Creating 'factorial.c.gcov'
执行指令后,gcov会引用之前的数据文件生成一个代码覆盖率报告factorial.c.gcov:
$ cat factorial.c.gcov
-: :Source:factorial.c
-: :Graph:factorial.gcno
-: :Data:factorial.gcda
-: :Runs:
-: :Programs:
-: :#include <stdio.h>
-: :
-: :int factorial(int n);
-: :
: :int main()
-: :{
: : int result0 = factorial();
: : int result1 = factorial();
: : int result2 = factorial();
-: :
: : if (result0 != ) printf("test0 failed, actual=%d.\n", result0);
: : if (result1 != ) printf("test1 failed, actual=%d.\n", result1);
: : if (result2 != ) printf("test2 failed, actual=%d.\n", result2);
-: :
: : return ;
-: :}
-: :
: :int factorial(int n)
-: :{
: : if (n < ) {
#####: 21: printf("Factorial is defined only for non-negative integer numbers.");
#####: 22: return -1;
-: : }
-: :
: : if (n > ) {
: : return n * factorial(n - );
-: : } else {
: : return ;
-: : }
-: :}
“#####”所标记的是未被执行的语句。
四、生成更全面、直观的代码覆盖率报告
直接用gcov生成的代码覆盖率报告并不是很直观,因此一般应该都是用以下两款。
1、LCOV
Lcov是gcov的图形化前端,它和GCOV做的工作是差不多的,只不过最后输出的是HTML页面形式的代码覆盖率报告。
Ubuntu系统下安装LCOV:
sudo apt-get install lcov
依然用之前的factorial.c演示。首先,按之前的步骤生成相关数据文件,例如xxx.gcda、xxx.gcno(PS. 不需要用gcov生成xxx.c.gcov文件)。然后,用LCOV收集相关数据并生成一个.info文件(方便起见直接在当前目录执行该命令):
lcov --capture --directory . --output-file coverage.info
最后,通过genhtml将coverage.info转化为HTML文件(genhtml是lcov自带的工具):
genhtml coverage.info --output-directory out
生成的OUT目录里包含了HTML版的代码覆盖率报告。
在WINDOWS上安装LCOV比较繁琐,有人专门写了Windows上可运行的LCOV脚本[LCOV for Windows],但是我下载下来后没弄懂怎么用。
2、GCOVR
相比于LCOV,gcovr可能更方便一点。LCOV有的功能gcovr都有,并且gcovr也是开源的:https://github.com/gcovr/gcovr。它是用Python写的,这意味着只要有Python环境都可以使用gcovr,无论是WINDOWS还是LINUX。直接通过pip(Python的包管理工具)安装GCOVR:
pip install gcovr
还是和之前一样的步骤生成相关的代码覆盖率信息文件,然后直接用gcovr生成HTML代码覆盖率报告就行了:
gcovr -r . --html --html-details -o coverage.html
五、参考
- 代码覆盖工具(gcov、lcov)的使用 - 步孤天 - 博客园
- [整理] gcov lcov 覆盖c/c++项目入门 - turtle_fly - 博客园
- Using the GNU Compiler Collection (GCC): Gcov
- Gcov - Wikipedia
GCOV&LCOV&GCOVR入门的更多相关文章
- 【转】gcov lcov 覆盖c/c++项目入门
原文: http://www.cnblogs.com/turtle-fly/archive/2013/01/09/2851474.html ------------------------------ ...
- Eclipse C++,Cygwin 64,gcov,lcov 单体&覆盖率测试环境搭建笔记
1.下载并安装 Eclipse IDE for C/C++ Developers https://eclipse.org/downloads/packages/eclipse-ide-cc-devel ...
- Jenkins中集成Gcov代码覆盖率报告
最近终于把gcov代码覆盖报告集成到jenkins中了,总算是完成工作,写篇博客总结下. 我循序渐进地用了三个工具:gcov, lcov, gcovr 这三个工具原理(其实gcovr依赖于GNU的gc ...
- 代码覆盖工具(gcov、lcov)的使用
一.安装 gcov:是随gcc一起发布的,并不需要独立安装:lcov:其他博客说是随ltp发布的,结果下载下ltp之后编译了10多分钟,最后也没见lcov,最后到sourceforge下载了lcov单 ...
- 嵌入式平台组件白盒测试gcov、lcov和genhtml 使用指导
在嵌入式平台上使用了gtest白盒测试工具,覆盖了被测函数,但是不知道自己测试的效果如何,测试行覆盖率.函数覆盖率,分支覆盖率的数据. 便开始研究gcov这个代码覆盖率工具能否使用,来检查白盒测试的效 ...
- C/C++代码覆盖率统计工具:gcov&&gcovr安装和简单使用
gcov安装 Linux ver: gcov是gcc的自带功能 属于GNU 不用特别安装 Windows ver: 在windows下安装可以使用gcov的gcc 之前试过mingw和Cygwin64 ...
- 覆盖率测试工具gcov的前端工具_LCOV
http://my.oschina.net/alphajay/blog/33725 1.Gcov是进行代码运行的覆盖率统计的工具,它随着gcc的发布一起发布的,它的使用也很简单,需要在编译和链接的时候 ...
- GCOV 使用用例
1.GCOV查看arm-linux代码覆盖率 一. 关于gcov工具 gcov伴随gcc 发布.gcc编译加入-fprofile-arcs -ftest-coverage 参数 ...
- 【C++】统计代码覆盖率(三)
报告集成到jenkins才是最终目的,因此又进行了部分资料查找,得到html和xml报告集成jenkins的配置如下: 一 集成html报告 这种方式集成在你已经用gcov+lcov生成了html报告 ...
随机推荐
- js中级6
1.动画 (1)Css样式提供了运动 过渡属性transition 从一种情况到另一种情况叫过渡 transition:time linear de ...
- yii2 gridview checkbox
给checkbox(在GridView里的)添加一个value 控制器:$dataProvidermStu->key = "student_no"; view:[ 'clas ...
- Multi-Projector Based Display Code ---- Calibration
Overview As mentioned previously, there are two main steps in generating a seamless display. The fir ...
- 如何追踪产生大量REDO的来源
从10点到12点数据库中对象块变化排名靠前的对象 select to_char(begin_interval_time,'YYYY_MM_DD HH24:MI') snap_time, dhsso.o ...
- c++第三次实验
第一题: 先把代码贴上来 main.cpp #include <iostream> #include <cstdlib> #include<conio.h> #in ...
- vue中用ajax上传文件
直接上代码 <input class="file-btn" type="file" @change="uploadCompany($event) ...
- Linux 磁盘介绍(磁盘、分区、MBR、GPT)
原文:https://www.linuxidc.com/Linux/2013-06/85717.htm 1. CHS(Cylinder-Head-Sector): was an early metho ...
- Python---Models 模型
#Models 模型 数据结构 + 算法 = 程序 ---> URL ---> VIEW ---> Temple ---> DB:分类---关系 Teacher Stude ...
- Java 基础 IO流之序列化
一,前言 在前面的IO中,我们都是讲数据以字符串的形式保存.能不能将一个数组保存到文件呢,当取出数据时也是一个数组,如果能够实现那就完美了.我们都知道比较通用的有JSON格式的序列化,那java中也有 ...
- AIX 7.1 RAC 11.2.0.4.0升级至11.2.0.4.6(一个patch跑了3个小时)
1.环境 DB:两节点RAC 11.2.0.4.0升级至11.2.0.4.6 OS:AIX 7.1(205G内存 16C) 2.节点1.节点2(未建库) 2.1.patch 20420937居然用了3 ...