gcov是一个可用于C/C++的代码覆盖工具,是gcc的内建工具。下面介绍一下如何利用gcov来收集代码覆盖信息。
想要用gcov收集代码覆盖信息,需要在gcc编译代码的时候加上这2个选项 “-fprofile-arcs -ftest-coverage”,把这个简单的程序编译一下
gcc -fprofile-arcs -ftest-coverage hello.c -o hello
编译后会得到一个可执行文件hello和hello.gcno文件,当用gcc编译文件的时候,如果带有“-ftest-coverage”参数,就会生成这个.gcno文件,它包含了程序块和行号等信息
接下来可以运行这个hello的程序
./hello 5
./hello 12
运行结束以后会生成一个hello.gcda文件,如果一个可执行文件带有“-fprofile-arcs”参数编译出来,并且运行过至少一次,就会生成。这个文件包含了程序基本块跳转的信息。接下来可以用gcov生成代码覆盖信息:
gcov hello.c
运行结束以后会生成2个文件hello.c.gcov和myfunc.c.gcov。打开看里面的信息:
-: 0:Source:myfunc.c
-: 0:Graph:hello.gcno
-: 0:Data:hello.gcda
-: 0:Runs:1
-: 0:Programs:1
-: 1:#include
-: 2:
-: 3:void test(int count)
1: 4:{
-: 5: int i;
10: 6: for (i = 1; i < count; i++)
-: 7: {
9: 8: if (i % 3 == 0)
3: 9: printf (“%d is divisible by 3 \n”, i);
9: 10: if (i % 11 == 0)
#####: 11: printf (“%d is divisible by 11 \n”, i);
9: 12: if (i % 13 == 0)
#####: 13: printf (“%d is divisible by 13 \n”, i);
-: 14: }
1: 15:}
被标记为#####的代码行就是没有被执行过的,代码覆盖的信息是正确的,但是让人去读这些文字,实在是一个杯具。不用担心,有另外一个工具叫lcov,可以用程序解析这些晦涩的字符,最终输出成html格式的报告,很好吧!
lcov -d . -t ‘Hello test’ -o ‘hello_test.info’ -b . -c
指定lcov在当前目录“.”去找代码覆盖的信息,输出为’hello_test.info’ ,这个hello_test.info是一个中间结果,需要把它用genhtml来处理一下,genhtml是lcov里面的一个工具。
genhtml -o result hello_test.info
指定输出目录是 result。一个完整的html报告就生成了,做一个连接,把这个目录连到随便一个web server的目录下,就可以看报告了。
本人的工程是使用了lcov,并使用makefile,主要的用法如下:
在makefile中定义宏文件:
PROFILE
- ifeq ($(PROFILE),1)
- CFLAGS += -fprofile-arcs
- CFLAGS += -ftest-coverage
- CXXFLAGS += -fprofile-arcs
- CXXFLAGS += -ftest-coverage
- LDFLAGS += -fprofile-arcs
- LDFLAGS += -ftest-coverage
- LDFLAGS += -lgcov
- LIBLDFLAGS += -fprofile-arcs
- LIBLDFLAGS += -ftest-coverage
- LIBLDFLAGS += -lgcov
- endif
在编译的时候打开此宏:PROFILE=1 make rtm DEBUG=0
然后运行后生成*.gcda文件。
使用下面命令生成report:
- lcov -d . -b . -c -o $rtmcovfile >/dev/null
- #sed -i -e ‘s#/home/mac_ci/hudson/home/jobs/trunk_RTM/workspace/trunk#\.#g‘ $rtmcovfile
- # - only keep ssTddPs folders in the report
- lcov -r $rtmcovfile "*/SS_MacData/*" -o $rtmcovfile
- lcov -r $rtmcovfile "*/SS_MacPsWmp/*" -o $rtmcovfile
- lcov -r $rtmcovfile "*/ssCommon/*" -o $rtmcovfile
- lcov -r $rtmcovfile "*/ssData/*" -o $rtmcovfile
- lcov -r $rtmcovfile "*/ssDcmPs/*" -o $rtmcovfile
- lcov -r $rtmcovfile "*/ssPsCommon/*" -o $rtmcovfile
- lcov -r $rtmcovfile "*/ssTestModel/*" -o $rtmcovfile
- # - Remove unneeded paths from coverage
- lcov -r $rtmcovfile "/build/ltesdkroot/*" -o $rtmcovfile
- lcov -r $rtmcovfile "*/SC_DSP_Common/*" -o $rtmcovfile
- lcov -r $rtmcovfile "*/C_Test/*" -o $rtmcovfile
- lcov -r $rtmcovfile "*/T_Tools/*" -o $rtmcovfile
- lcov -r $rtmcovfile "*/ENV/*" -o $rtmcovfile
- lcov -r $rtmcovfile "*/I_Interface/*" -o $rtmcovfile
- lcov -r $rtmcovfile "/usr/*" -o $rtmcovfile
- lcov -r $rtmcovfile "/opt/*" -o $rtmcovfile
- mv $rtmcovfile $PROJECT_ROOT/C_Test/SC_MAC/MacLinuxRtm/logs
- cd $PROJECT_ROOT/C_Test/SC_MAC/MacLinuxRtm/logs
- genhtml -o tdd_ut_rtm_tests_coverage $rtmcovfile >/dev/null
测试结果概览
具体某个文件的覆盖率