第 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 。