第 4 页 基本读取函数 gcov_read_words 2.4 基本读取函数 gcov_read_words
对 .gcda/.gcno 文件的读取 / 写入,均以 4 字节 (1 个 words) 为单位进行。下面分析从 .gcda/.gcno 文件中读取 words 的基本读取函数 gcov_read_words 。代码如下。其中的注释为笔者所加。
/ * Return a pointer to read BYTES bytes from the gcov file. Returns
NULL on failure (read past EOF). */
static const gcov_unsigned_t *
gcov_read_words ( unsigned words )
{
const gcov_unsigned_t * result ;
/**excess is the number of words which can be excessed*/
unsigned excess = gcov_var .length - gcov_var .offset ;
gcc_assert ( gcov_var .mode > 0 );
if ( excess < words )
{
gcov_var .start += gcov_var .offset ;
#if IN_LIBGCOV
if ( excess )
{
gcc_assert ( excess == 1 );
memcpy ( gcov_var .buffer , gcov_var .buffer + gcov_var .offset , 4 );
}
#else
// 在 gcov-dump 程序中,执行 memmove
memmove ( gcov_var .buffer , gcov_var .buffer + gcov_var .offset , excess * 4 );
#endif
gcov_var .offset = 0 ;
gcov_var .length = excess ;
#if IN_LIBGCOV
gcc_assert ( ! gcov_var .length || gcov_var .length == 1 );
excess = GCOV_BLOCK_SIZE ;
#else
// 在 gcov-dump 程序中,执行 gcov_allocate
if ( gcov_var .length + words > gcov_var .alloc )
/** allocate space, the space pointer is saved in gcov_var.buffer */
gcov_allocate ( gcov_var .length + words );
excess = gcov_var .alloc - gcov_var .length ; /** if program can run here, then, excess = 2050 */
#endif
/*****
* >>2, that is, divided by 4, it is for 4 Bytes as a unit.
* for example, a file with 168B, then, will read 168B, but excess is 168/ 4=42.
* gcov_var.buffer will save the file content.
*/
excess = fread ( gcov_var .buffer + gcov_var .length , 1 , excess << 2="" gcov_var="">> 2 ;
gcov_var .length += excess ;
if ( gcov_var .length < words )
{
gcov_var .overread += words - gcov_var .length ;
gcov_var .length = 0 ;
return 0 ;
}
}
/***** then, return an unsigned word */
result = & gcov_var .buffer [ gcov_var .offset ]; gcov_var .offset += words ;
return result ;
}
第一次调用该函数时, gcov_var.alloc=0 ,然后一定会调用 gcov_allocate ,调用 gcov_allocate 后, gcov_var.alloc=2050 。跟踪执行发现,第一次调用 fread 之前, excess = gcov_var.alloc - gcov_var.length = 2050 ,调用 fread 后,仍以 test.c 产生的 test.gcda 为例 ( 可参考前面的文章 ) , excess=168/4=42 。因为 test.gcda 较小,只有 168 字节,故调用 fread 后, gcov_var.buffer 中就存放了整个文件的内容 (168 字节 ) ,如下所示,虽然为 gcov_var.buffer 分配了 8200 自己的空间。