1 /* File format for coverage information
2 Copyright (C) 1996, 1997, 1998, 2000, 2002, 2003, 2004, 2005, 2007,
3 2008 Free Software Foundation, Inc.
4 Contributed by Bob Manson <manson@cygnus.com>.
5 Completely remangled by Nathan Sidwell <nathan@codesourcery.com>.
7 This file is part of GCC.
9 GCC is free software; you can redistribute it and/or modify it under
10 the terms of the GNU General Public License as published by the Free
11 Software Foundation; either version 3, or (at your option) any later
14 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
15 WARRANTY; without even the implied warranty of MERCHANTABILITY or
16 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
19 Under Section 7 of GPL version 3, you are granted additional
20 permissions described in the GCC Runtime Library Exception, version
21 3.1, as published by the Free Software Foundation.
23 You should have received a copy of the GNU General Public License and
24 a copy of the GCC Runtime Library Exception along with this program;
25 see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
26 <http://www.gnu.org/licenses/>. */
28 /* Routines declared in gcov-io.h. This file should be #included by
29 another source file, after having #included gcov-io.h. */
32 static void gcov_write_block (unsigned);
33 static gcov_unsigned_t
*gcov_write_words (unsigned);
35 static const gcov_unsigned_t
*gcov_read_words (unsigned);
37 static void gcov_allocate (unsigned);
40 static inline gcov_unsigned_t
from_file (gcov_unsigned_t value
)
45 value
= (value
>> 16) | (value
<< 16);
46 value
= ((value
& 0xff00ff) << 8) | ((value
>> 8) & 0xff00ff);
52 /* Open a gcov file. NAME is the name of the file to open and MODE
53 indicates whether a new file should be created, or an existing file
54 opened. If MODE is >= 0 an existing file will be opened, if
55 possible, and if MODE is <= 0, a new file will be created. Use
56 MODE=0 to attempt to reopen an existing file and then fall back on
57 creating a new one. If MODE < 0, the file will be opened in
58 read-only mode. Otherwise it will be opened for modification.
59 Return zero on failure, >0 on opening an existing file and <0 on
60 creating a new one. */
64 gcov_open (const char *name
)
66 gcov_open (const char *name
, int mode
)
76 s_flock
.l_whence
= SEEK_SET
;
78 s_flock
.l_len
= 0; /* Until EOF. */
79 s_flock
.l_pid
= getpid ();
82 gcc_assert (!gcov_var
.file
);
84 gcov_var
.offset
= gcov_var
.length
= 0;
85 gcov_var
.overread
= -1u;
93 /* Read-only mode - acquire a read-lock. */
94 s_flock
.l_type
= F_RDLCK
;
95 fd
= open (name
, O_RDONLY
);
99 /* Write mode - acquire a write-lock. */
100 s_flock
.l_type
= F_WRLCK
;
101 fd
= open (name
, O_RDWR
| O_CREAT
, 0666);
106 while (fcntl (fd
, F_SETLKW
, &s_flock
) && errno
== EINTR
)
109 gcov_var
.file
= fdopen (fd
, (mode
> 0) ? "rb" : "r+b");
123 if (fstat (fd
, &st
) < 0)
125 fclose (gcov_var
.file
);
132 gcov_var
.mode
= mode
* 2 + 1;
135 gcov_var
.mode
= mode
* 2 + 1;
138 gcov_var
.file
= fopen (name
, (mode
> 0) ? "rb" : "r+b");
144 gcov_var
.file
= fopen (name
, "w+b");
146 gcov_var
.mode
= mode
* 2 + 1;
152 setbuf (gcov_var
.file
, (char *)0);
157 /* Close the current gcov file. Flushes data to disk. Returns nonzero
158 on failure or error flag set. */
166 if (gcov_var
.offset
&& gcov_var
.mode
< 0)
167 gcov_write_block (gcov_var
.offset
);
169 fclose (gcov_var
.file
);
174 free (gcov_var
.buffer
);
179 return gcov_var
.error
;
183 /* Check if MAGIC is EXPECTED. Use it to determine endianness of the
184 file. Returns +1 for same endian, -1 for other endian and zero for
188 gcov_magic (gcov_unsigned_t magic
, gcov_unsigned_t expected
)
190 if (magic
== expected
)
192 magic
= (magic
>> 16) | (magic
<< 16);
193 magic
= ((magic
& 0xff00ff) << 8) | ((magic
>> 8) & 0xff00ff);
194 if (magic
== expected
)
205 gcov_allocate (unsigned length
)
207 size_t new_size
= gcov_var
.alloc
;
210 new_size
= GCOV_BLOCK_SIZE
;
214 gcov_var
.alloc
= new_size
;
215 gcov_var
.buffer
= XRESIZEVAR (gcov_unsigned_t
, gcov_var
.buffer
, new_size
<< 2);
220 /* Write out the current block, if needs be. */
223 gcov_write_block (unsigned size
)
225 if (fwrite (gcov_var
.buffer
, size
<< 2, 1, gcov_var
.file
) != 1)
227 gcov_var
.start
+= size
;
228 gcov_var
.offset
-= size
;
231 /* Allocate space to write BYTES bytes to the gcov file. Return a
232 pointer to those bytes, or NULL on failure. */
234 static gcov_unsigned_t
*
235 gcov_write_words (unsigned words
)
237 gcov_unsigned_t
*result
;
239 gcc_assert (gcov_var
.mode
< 0);
241 if (gcov_var
.offset
>= GCOV_BLOCK_SIZE
)
243 gcov_write_block (GCOV_BLOCK_SIZE
);
246 gcc_assert (gcov_var
.offset
== 1);
247 memcpy (gcov_var
.buffer
, gcov_var
.buffer
+ GCOV_BLOCK_SIZE
, 4);
251 if (gcov_var
.offset
+ words
> gcov_var
.alloc
)
252 gcov_allocate (gcov_var
.offset
+ words
);
254 result
= &gcov_var
.buffer
[gcov_var
.offset
];
255 gcov_var
.offset
+= words
;
260 /* Write unsigned VALUE to coverage file. Sets error flag
264 gcov_write_unsigned (gcov_unsigned_t value
)
266 gcov_unsigned_t
*buffer
= gcov_write_words (1);
271 /* Write counter VALUE to coverage file. Sets error flag
276 gcov_write_counter (gcov_type value
)
278 gcov_unsigned_t
*buffer
= gcov_write_words (2);
280 buffer
[0] = (gcov_unsigned_t
) value
;
281 if (sizeof (value
) > sizeof (gcov_unsigned_t
))
282 buffer
[1] = (gcov_unsigned_t
) (value
>> 32);
286 #endif /* IN_LIBGCOV */
289 /* Write STRING to coverage file. Sets error flag on file
290 error, overflow flag on overflow */
293 gcov_write_string (const char *string
)
297 gcov_unsigned_t
*buffer
;
301 length
= strlen (string
);
302 alloc
= (length
+ 4) >> 2;
305 buffer
= gcov_write_words (1 + alloc
);
309 memcpy (&buffer
[1], string
, length
);
314 /* Write a tag TAG and reserve space for the record length. Return a
315 value to be used for gcov_write_length. */
317 GCOV_LINKAGE gcov_position_t
318 gcov_write_tag (gcov_unsigned_t tag
)
320 gcov_position_t result
= gcov_var
.start
+ gcov_var
.offset
;
321 gcov_unsigned_t
*buffer
= gcov_write_words (2);
329 /* Write a record length using POSITION, which was returned by
330 gcov_write_tag. The current file position is the end of the
331 record, and is restored before returning. Returns nonzero on
335 gcov_write_length (gcov_position_t position
)
338 gcov_unsigned_t length
;
339 gcov_unsigned_t
*buffer
;
341 gcc_assert (gcov_var
.mode
< 0);
342 gcc_assert (position
+ 2 <= gcov_var
.start
+ gcov_var
.offset
);
343 gcc_assert (position
>= gcov_var
.start
);
344 offset
= position
- gcov_var
.start
;
345 length
= gcov_var
.offset
- offset
- 2;
346 buffer
= (gcov_unsigned_t
*) &gcov_var
.buffer
[offset
];
348 if (gcov_var
.offset
>= GCOV_BLOCK_SIZE
)
349 gcov_write_block (gcov_var
.offset
);
352 #else /* IN_LIBGCOV */
354 /* Write a tag TAG and length LENGTH. */
357 gcov_write_tag_length (gcov_unsigned_t tag
, gcov_unsigned_t length
)
359 gcov_unsigned_t
*buffer
= gcov_write_words (2);
365 /* Write a summary structure to the gcov file. Return nonzero on
369 gcov_write_summary (gcov_unsigned_t tag
, const struct gcov_summary
*summary
)
371 unsigned ix
, h_ix
, bv_ix
, h_cnt
= 0;
372 const struct gcov_ctr_summary
*csum
;
373 unsigned histo_bitvector
[GCOV_HISTOGRAM_BITVECTOR_SIZE
];
375 /* Count number of non-zero histogram entries, and fill in a bit vector
376 of non-zero indices. The histogram is only currently computed for arc
378 for (bv_ix
= 0; bv_ix
< GCOV_HISTOGRAM_BITVECTOR_SIZE
; bv_ix
++)
379 histo_bitvector
[bv_ix
] = 0;
380 csum
= &summary
->ctrs
[GCOV_COUNTER_ARCS
];
381 for (h_ix
= 0; h_ix
< GCOV_HISTOGRAM_SIZE
; h_ix
++)
383 if (csum
->histogram
[h_ix
].num_counters
> 0)
385 histo_bitvector
[h_ix
/ 32] |= 1 << (h_ix
% 32);
389 gcov_write_tag_length (tag
, GCOV_TAG_SUMMARY_LENGTH(h_cnt
));
390 gcov_write_unsigned (summary
->checksum
);
391 for (csum
= summary
->ctrs
, ix
= GCOV_COUNTERS_SUMMABLE
; ix
--; csum
++)
393 gcov_write_unsigned (csum
->num
);
394 gcov_write_unsigned (csum
->runs
);
395 gcov_write_counter (csum
->sum_all
);
396 gcov_write_counter (csum
->run_max
);
397 gcov_write_counter (csum
->sum_max
);
398 if (ix
!= GCOV_COUNTER_ARCS
)
400 for (bv_ix
= 0; bv_ix
< GCOV_HISTOGRAM_BITVECTOR_SIZE
; bv_ix
++)
401 gcov_write_unsigned (0);
404 for (bv_ix
= 0; bv_ix
< GCOV_HISTOGRAM_BITVECTOR_SIZE
; bv_ix
++)
405 gcov_write_unsigned (histo_bitvector
[bv_ix
]);
406 for (h_ix
= 0; h_ix
< GCOV_HISTOGRAM_SIZE
; h_ix
++)
408 if (!csum
->histogram
[h_ix
].num_counters
)
410 gcov_write_unsigned (csum
->histogram
[h_ix
].num_counters
);
411 gcov_write_counter (csum
->histogram
[h_ix
].min_value
);
412 gcov_write_counter (csum
->histogram
[h_ix
].cum_value
);
416 #endif /* IN_LIBGCOV */
420 /* Return a pointer to read BYTES bytes from the gcov file. Returns
421 NULL on failure (read past EOF). */
423 static const gcov_unsigned_t
*
424 gcov_read_words (unsigned words
)
426 const gcov_unsigned_t
*result
;
427 unsigned excess
= gcov_var
.length
- gcov_var
.offset
;
429 gcc_assert (gcov_var
.mode
> 0);
432 gcov_var
.start
+= gcov_var
.offset
;
436 gcc_assert (excess
== 1);
437 memcpy (gcov_var
.buffer
, gcov_var
.buffer
+ gcov_var
.offset
, 4);
440 memmove (gcov_var
.buffer
, gcov_var
.buffer
+ gcov_var
.offset
, excess
* 4);
443 gcov_var
.length
= excess
;
445 gcc_assert (!gcov_var
.length
|| gcov_var
.length
== 1);
446 excess
= GCOV_BLOCK_SIZE
;
448 if (gcov_var
.length
+ words
> gcov_var
.alloc
)
449 gcov_allocate (gcov_var
.length
+ words
);
450 excess
= gcov_var
.alloc
- gcov_var
.length
;
452 excess
= fread (gcov_var
.buffer
+ gcov_var
.length
,
453 1, excess
<< 2, gcov_var
.file
) >> 2;
454 gcov_var
.length
+= excess
;
455 if (gcov_var
.length
< words
)
457 gcov_var
.overread
+= words
- gcov_var
.length
;
462 result
= &gcov_var
.buffer
[gcov_var
.offset
];
463 gcov_var
.offset
+= words
;
467 /* Read unsigned value from a coverage file. Sets error flag on file
468 error, overflow flag on overflow */
470 GCOV_LINKAGE gcov_unsigned_t
471 gcov_read_unsigned (void)
473 gcov_unsigned_t value
;
474 const gcov_unsigned_t
*buffer
= gcov_read_words (1);
478 value
= from_file (buffer
[0]);
482 /* Read counter value from a coverage file. Sets error flag on file
483 error, overflow flag on overflow */
485 GCOV_LINKAGE gcov_type
486 gcov_read_counter (void)
489 const gcov_unsigned_t
*buffer
= gcov_read_words (2);
493 value
= from_file (buffer
[0]);
494 if (sizeof (value
) > sizeof (gcov_unsigned_t
))
495 value
|= ((gcov_type
) from_file (buffer
[1])) << 32;
502 /* Read string from coverage file. Returns a pointer to a static
503 buffer, or NULL on empty string. You must copy the string before
504 calling another gcov function. */
507 GCOV_LINKAGE
const char *
508 gcov_read_string (void)
510 unsigned length
= gcov_read_unsigned ();
515 return (const char *) gcov_read_words (length
);
520 gcov_read_summary (struct gcov_summary
*summary
)
522 unsigned ix
, h_ix
, bv_ix
, h_cnt
= 0;
523 struct gcov_ctr_summary
*csum
;
524 unsigned histo_bitvector
[GCOV_HISTOGRAM_BITVECTOR_SIZE
];
525 unsigned cur_bitvector
;
527 summary
->checksum
= gcov_read_unsigned ();
528 for (csum
= summary
->ctrs
, ix
= GCOV_COUNTERS_SUMMABLE
; ix
--; csum
++)
530 csum
->num
= gcov_read_unsigned ();
531 csum
->runs
= gcov_read_unsigned ();
532 csum
->sum_all
= gcov_read_counter ();
533 csum
->run_max
= gcov_read_counter ();
534 csum
->sum_max
= gcov_read_counter ();
535 memset (csum
->histogram
, 0,
536 sizeof (gcov_bucket_type
) * GCOV_HISTOGRAM_SIZE
);
537 for (bv_ix
= 0; bv_ix
< GCOV_HISTOGRAM_BITVECTOR_SIZE
; bv_ix
++)
539 histo_bitvector
[bv_ix
] = gcov_read_unsigned ();
540 h_cnt
+= __builtin_popcountll (histo_bitvector
[bv_ix
]);
547 /* Find the index corresponding to the next entry we will read in.
548 First find the next non-zero bitvector and re-initialize
549 the histogram index accordingly, then right shift and increment
550 the index until we find a set bit. */
551 while (!cur_bitvector
)
554 cur_bitvector
= histo_bitvector
[bv_ix
++];
555 gcc_assert(bv_ix
<= GCOV_HISTOGRAM_BITVECTOR_SIZE
);
557 while (!(cur_bitvector
& 0x1))
562 gcc_assert(h_ix
< GCOV_HISTOGRAM_SIZE
);
564 csum
->histogram
[h_ix
].num_counters
= gcov_read_unsigned ();
565 csum
->histogram
[h_ix
].min_value
= gcov_read_counter ();
566 csum
->histogram
[h_ix
].cum_value
= gcov_read_counter ();
567 /* Shift off the index we are done with and increment to the
568 corresponding next histogram entry. */
576 /* Reset to a known position. BASE should have been obtained from
577 gcov_position, LENGTH should be a record length. */
580 gcov_sync (gcov_position_t base
, gcov_unsigned_t length
)
582 gcc_assert (gcov_var
.mode
> 0);
584 if (base
- gcov_var
.start
<= gcov_var
.length
)
585 gcov_var
.offset
= base
- gcov_var
.start
;
588 gcov_var
.offset
= gcov_var
.length
= 0;
589 fseek (gcov_var
.file
, base
<< 2, SEEK_SET
);
590 gcov_var
.start
= ftell (gcov_var
.file
) >> 2;
596 /* Move to a given position in a gcov file. */
599 gcov_seek (gcov_position_t base
)
601 gcc_assert (gcov_var
.mode
< 0);
603 gcov_write_block (gcov_var
.offset
);
604 fseek (gcov_var
.file
, base
<< 2, SEEK_SET
);
605 gcov_var
.start
= ftell (gcov_var
.file
) >> 2;
610 /* Return the modification time of the current gcov file. */
617 if (fstat (fileno (gcov_var
.file
), &status
))
620 return status
.st_mtime
;
624 #if IN_LIBGCOV || !IN_GCOV
625 /* Determine the index into histogram for VALUE. */
628 gcov_histo_index(gcov_type value
)
630 gcov_type_unsigned v
= (gcov_type_unsigned
)value
;
632 unsigned prev2bits
= 0;
634 /* Find index into log2 scale histogram, where each of the log2
635 sized buckets is divided into 4 linear sub-buckets for better
636 focus in the higher buckets. */
638 /* Find the place of the most-significant bit set. */
640 r
= 63 - __builtin_clzll (v
);
642 /* If at most the 2 least significant bits are set (value is
643 0 - 3) then that value is our index into the lowest set of
646 return (unsigned)value
;
650 /* Find the two next most significant bits to determine which
651 of the four linear sub-buckets to select. */
652 prev2bits
= (v
>> (r
- 2)) & 0x3;
653 /* Finally, compose the final bucket index from the log2 index and
654 the next 2 bits. The minimum r value at this point is 2 since we
655 returned above if r was 2 or more, so the minimum bucket at this
657 return (r
- 1) * 4 + prev2bits
;
660 /* Merge SRC_HISTO into TGT_HISTO. The counters are assumed to be in
661 the same relative order in both histograms, and are matched up
662 and merged in reverse order. Each counter is assigned an equal portion of
663 its entry's original cumulative counter value when computing the
664 new merged cum_value. */
666 static void gcov_histogram_merge(gcov_bucket_type
*tgt_histo
,
667 gcov_bucket_type
*src_histo
)
669 int src_i
, tgt_i
, tmp_i
= 0;
670 unsigned src_num
, tgt_num
, merge_num
;
671 gcov_type src_cum
, tgt_cum
, merge_src_cum
, merge_tgt_cum
, merge_cum
;
673 gcov_bucket_type tmp_histo
[GCOV_HISTOGRAM_SIZE
];
676 memset(tmp_histo
, 0, sizeof (gcov_bucket_type
) * GCOV_HISTOGRAM_SIZE
);
678 /* Assume that the counters are in the same relative order in both
679 histograms. Walk the histograms from largest to smallest entry,
680 matching up and combining counters in order. */
683 src_i
= GCOV_HISTOGRAM_SIZE
- 1;
684 for (tgt_i
= GCOV_HISTOGRAM_SIZE
- 1; tgt_i
>= 0 && !src_done
; tgt_i
--)
686 tgt_num
= tgt_histo
[tgt_i
].num_counters
;
687 tgt_cum
= tgt_histo
[tgt_i
].cum_value
;
688 /* Keep going until all of the target histogram's counters at this
689 position have been matched and merged with counters from the
691 while (tgt_num
> 0 && !src_done
)
693 /* If this is either the first time through this loop or we just
694 exhausted the previous non-zero source histogram entry, look
695 for the next non-zero source histogram entry. */
698 /* Locate the next non-zero entry. */
699 while (src_i
>= 0 && !src_histo
[src_i
].num_counters
)
701 /* If source histogram has fewer counters, then just copy over the
702 remaining target counters and quit. */
705 tmp_histo
[tgt_i
].num_counters
+= tgt_num
;
706 tmp_histo
[tgt_i
].cum_value
+= tgt_cum
;
707 if (!tmp_histo
[tgt_i
].min_value
||
708 tgt_histo
[tgt_i
].min_value
< tmp_histo
[tgt_i
].min_value
)
709 tmp_histo
[tgt_i
].min_value
= tgt_histo
[tgt_i
].min_value
;
712 tmp_histo
[tgt_i
].num_counters
713 += tgt_histo
[tgt_i
].num_counters
;
714 tmp_histo
[tgt_i
].cum_value
+= tgt_histo
[tgt_i
].cum_value
;
715 if (!tmp_histo
[tgt_i
].min_value
||
716 tgt_histo
[tgt_i
].min_value
717 < tmp_histo
[tgt_i
].min_value
)
718 tmp_histo
[tgt_i
].min_value
= tgt_histo
[tgt_i
].min_value
;
725 src_num
= src_histo
[src_i
].num_counters
;
726 src_cum
= src_histo
[src_i
].cum_value
;
729 /* The number of counters to merge on this pass is the minimum
730 of the remaining counters from the current target and source
731 histogram entries. */
733 if (src_num
< merge_num
)
736 /* The merged min_value is the sum of the min_values from target
738 merge_min
= tgt_histo
[tgt_i
].min_value
+ src_histo
[src_i
].min_value
;
740 /* Compute the portion of source and target entries' cum_value
741 that will be apportioned to the counters being merged.
742 The total remaining cum_value from each entry is divided
743 equally among the counters from that histogram entry if we
744 are not merging all of them. */
745 merge_src_cum
= src_cum
;
746 if (merge_num
< src_num
)
747 merge_src_cum
= merge_num
* src_cum
/ src_num
;
748 merge_tgt_cum
= tgt_cum
;
749 if (merge_num
< tgt_num
)
750 merge_tgt_cum
= merge_num
* tgt_cum
/ tgt_num
;
751 /* The merged cum_value is the sum of the source and target
753 merge_cum
= merge_src_cum
+ merge_tgt_cum
;
755 /* Update the remaining number of counters and cum_value left
756 to be merged from this source and target entry. */
757 src_cum
-= merge_src_cum
;
758 tgt_cum
-= merge_tgt_cum
;
759 src_num
-= merge_num
;
760 tgt_num
-= merge_num
;
762 /* The merged counters get placed in the new merged histogram
763 at the entry for the merged min_value. */
764 tmp_i
= gcov_histo_index(merge_min
);
765 gcc_assert (tmp_i
< GCOV_HISTOGRAM_SIZE
);
766 tmp_histo
[tmp_i
].num_counters
+= merge_num
;
767 tmp_histo
[tmp_i
].cum_value
+= merge_cum
;
768 if (!tmp_histo
[tmp_i
].min_value
||
769 merge_min
< tmp_histo
[tmp_i
].min_value
)
770 tmp_histo
[tmp_i
].min_value
= merge_min
;
772 /* Ensure the search for the next non-zero src_histo entry starts
773 at the next smallest histogram bucket. */
779 gcc_assert (tgt_i
< 0);
781 /* In the case where there were more counters in the source histogram,
782 accumulate the remaining unmerged cumulative counter values. Add
783 those to the smallest non-zero target histogram entry. Otherwise,
784 the total cumulative counter values in the histogram will be smaller
785 than the sum_all stored in the summary, which will complicate
786 computing the working set information from the histogram later on. */
791 src_cum
+= src_histo
[src_i
].cum_value
;
794 /* At this point, tmp_i should be the smallest non-zero entry in the
796 gcc_assert(tmp_i
>= 0 && tmp_i
< GCOV_HISTOGRAM_SIZE
797 && tmp_histo
[tmp_i
].num_counters
> 0);
798 tmp_histo
[tmp_i
].cum_value
+= src_cum
;
800 /* Finally, copy the merged histogram into tgt_histo. */
801 memcpy(tgt_histo
, tmp_histo
, sizeof (gcov_bucket_type
) * GCOV_HISTOGRAM_SIZE
);
803 #endif /* IN_LIBGCOV || !IN_GCOV */