第 16 页 LINES tag: tag_lines() 函数
3.4 LINES tag: tag_lines() 函数static void
tag_lines ( const char * filename ATTRIBUTE_UNUSED ,
unsigned tag ATTRIBUTE_UNUSED , unsigned length ATTRIBUTE_UNUSED )
{
if ( flag_dump_contents )
{
unsigned blockno = gcov_read_unsigned ();
char const * sep = NULL ;
while ( 1 )
{
gcov_position_t position = gcov_position ();
const char * source = NULL ;
unsigned lineno = gcov_read_unsigned ();
if ( ! lineno )//lineno=0 时才会执行该 clause ,因此 lineno=0 即为以后的新的文件的标志
{
source = gcov_read_string ();// 该函数读取 length(4 字节 ) 和 length 个 words(4*length 字节 )
if ( ! source )//source 即为文件名,没有源文件了,就退出
break ;
sep = NULL ;
}
if ( ! sep )//sep=NULL 才会执行该 clause ,那么什么时候会为 NULL 呢?——就是新的文件开始,实际上就是 lineno=0
{
printf ( "/n" );
print_prefix ( filename , 0 , position );
printf ( "/tblock %u:" , blockno );
sep = "" ;
}
if ( lineno )
{
printf ( "%s%u" , sep , lineno );
sep = ", " ;
}
else
{
printf ( "%s`%s'" , sep , source );//lineno=0 时,输出该文件名,之后 sep= " : "
sep = ":" ;
}
}
}
}
输出格式:
block blockno:'filename':lineno1, lineno2, ...
例如: block 1:'test.c':4, 7, 9
其中,前面的 block 为提示信息。同上,需要注意前导符或者输出位置。
3.5 COUNTER tag: tag_counters() 函数static void
tag_counters ( const char * filename ATTRIBUTE_UNUSED ,
unsigned tag ATTRIBUTE_UNUSED , unsigned length ATTRIBUTE_UNUSED )
{
static const char *const counter_names [] = GCOV_COUNTER_NAMES ;
unsigned n_counts = GCOV_TAG_COUNTER_NUM ( length );
printf ( " %s %u counts" ,
counter_names [ GCOV_COUNTER_FOR_TAG ( tag )], n_counts );
if ( flag_dump_contents )
{
unsigned ix ;
for ( ix = 0 ; ix != n_counts ; ix ++ )
{
gcov_type count ;
if ( ! ( ix & 7 ))// 如果 counter 较多,则每 8 个 1 行输出,且按 0 , 8 , 16 , ... 输出序号
{
printf ( "/n" );
print_prefix ( filename , 0 , gcov_position ());
printf ( "/t/t%u" , ix );// 输出序号
}
count = gcov_read_counter ();// 读取该 counter ,读取 8 字节,但返回 4 字节
printf ( " " );
printf ( HOST_WIDEST_INT_PRINT_DEC , count );
}
}
}
关于 GCOV_TAG_COUNTER_NUM 和 GCOV_COUNTER_FOR_TAG ,请参考源代码。
counter 的名字定义如下。/* A list of human readable names of the counters */
#define GCOV_COUNTER_NAMES {"arcs ", "interval", "pow2", "single", "delta"}
输出格式:
arcs n counts //arcs 即为 counter 的名字,如上
0 counter0 counter1 ... counter7// 每 8 个 1 行输出,前面的 0 表示序号
8 counter8 counter9 ... counter15// 前面的 8 表示序号
...
同上,需要注意前导符或者输出位置。
3.6 OBJECT/PROGRAM SUMMARY tag: tag_summary() 函数static void
tag_summary ( const char * filename ATTRIBUTE_UNUSED ,
unsigned tag ATTRIBUTE_UNUSED , unsigned length ATTRIBUTE_UNUSED )
{
struct gcov_summary summary ;
unsigned ix ;
/***** initialize all members with 0 *****/
memset( & summary , 0 , sizeof ( summary ));
unsigned count = gcov_read_summary ( & summary );// 读取该 summary
printf ( " checksum=0x%08x" , summary .checksum );
/* for (ix = 0; ix ! = GCOV_COUNTERS; ix++) *//* 原来的代码 */
for ( ix = 0 ; ix < count ; ix ++ )/* 应该如此修改 */
{
printf ( "/n" );
print_prefix ( filename , 0 , 0 );
printf ( "/t/tcounts=%u, runs=%u" , summary .ctrs [ ix ] .num , summary .ctrs [ ix ] .runs );
printf ( ", sum_all=" HOST_WIDEST_INT_PRINT_DEC , ( HOST_WIDEST_INT ) summary .ctrs [ ix ] .sum_all );
printf ( ", run_max=" HOST_WIDEST_INT_PRINT_DEC , ( HOST_WIDEST_INT ) summary .ctrs [ ix ] .run_max );
printf ( ", sum_max=" HOST_WIDEST_INT_PRINT_DEC , ( HOST_WIDEST_INT ) summary .ctrs [ ix ] .sum_max );
}
}
输出格式:
checksum=0x51924f98
counts=5, runs=1, sum_all=12, run_max=10, sum_max=10
同上,也需要注意前导符或者输出位置。
其中, gcov_read_summary 函数是修改后的函数,在 " Linux 平台代码覆盖率测试 -GCC 如何编译生成 gcov/gcov-dump 程序及其 bug 分析 " 一文没有列出该修改后的函数,其实这篇文章中的 bug 与该函数有关。此处列出其代码。GCOV_LINKAGE unsigned
gcov_read_summary ( struct gcov_summary * summary )
{
unsigned ix ;
struct gcov_ctr_summary * csum ;
summary - >checksum = gcov_read_unsigned (); /***** checksum is a words (4Bytes) *****/
/***** that is, a summry is 32Bytes (sizeof(gcov_type)=4) or 20Bytes (sizeof(gcov_type)=8) *****/
for ( csum = summary - >ctrs , ix = GCOV_COUNTERS_SUMMABLE ; ix -- ; csum ++ )
{
csum - >num = gcov_read_unsigned (); /***** 4Bytes *****/
csum - >runs = gcov_read_unsigned (); /***** 4Bytes *****/
csum - >sum_all = gcov_read_counter (); /***** 8Bytes , but return 4Bytes *****/
csum - >run_max = gcov_read_counter (); /***** 8Bytes , but return 4Bytes *****/
csum - >sum_max = gcov_read_counter (); /***** 8Bytes , but return 4Bytes *****/
}
return GCOV_COUNTERS_SUMMABLE ; /* zubo modified to return the nubmer */
}
gcov_summary 及 gcov_ctr_summary 结构的定义可参考源代码或者 " Linux 平台代码覆盖率测试工具 GCOV 相关文件分析 " 。
4. 小结
本文详细叙述了 gcov-dump 程序的结构和实现原理。也从中学习了其处理各种 tag 用到的 callback 方法,如果你想深入跟踪或学习 gcc 源码,请注意 callback 的使用,因为 gcc 源码中大量地使用了 callback 。