1 /* Dump a gcov file, for debugging use.
2 Copyright (C) 2002-2019 Free Software Foundation, Inc.
3 Contributed by Nathan Sidwell <nathan@codesourcery.com>
5 Gcov is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 3, or (at your option)
10 Gcov is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with Gcov; see the file COPYING3. If not see
17 <http://www.gnu.org/licenses/>. */
21 #include "coretypes.h"
25 #include "diagnostic.h"
31 static void dump_gcov_file (const char *);
32 static void print_prefix (const char *, unsigned, gcov_position_t
);
33 static void print_usage (void);
34 static void print_version (void);
35 static void tag_function (const char *, unsigned, unsigned, unsigned);
36 static void tag_blocks (const char *, unsigned, unsigned, unsigned);
37 static void tag_arcs (const char *, unsigned, unsigned, unsigned);
38 static void tag_lines (const char *, unsigned, unsigned, unsigned);
39 static void tag_counters (const char *, unsigned, unsigned, unsigned);
40 static void tag_summary (const char *, unsigned, unsigned, unsigned);
41 extern int main (int, char **);
43 typedef struct tag_format
47 void (*proc
) (const char *, unsigned, unsigned, unsigned);
50 static int flag_dump_contents
= 0;
51 static int flag_dump_positions
= 0;
53 static const struct option options
[] =
55 { "help", no_argument
, NULL
, 'h' },
56 { "version", no_argument
, NULL
, 'v' },
57 { "long", no_argument
, NULL
, 'l' },
58 { "positions", no_argument
, NULL
, 'o' },
62 #define VALUE_PADDING_PREFIX " "
63 #define VALUE_PREFIX "%2d: "
65 static const tag_format_t tag_table
[] =
69 {0, "COUNTERS", tag_counters
},
70 {GCOV_TAG_FUNCTION
, "FUNCTION", tag_function
},
71 {GCOV_TAG_BLOCKS
, "BLOCKS", tag_blocks
},
72 {GCOV_TAG_ARCS
, "ARCS", tag_arcs
},
73 {GCOV_TAG_LINES
, "LINES", tag_lines
},
74 {GCOV_TAG_OBJECT_SUMMARY
, "OBJECT_SUMMARY", tag_summary
},
79 main (int argc ATTRIBUTE_UNUSED
, char **argv
)
84 p
= argv
[0] + strlen (argv
[0]);
85 while (p
!= argv
[0] && !IS_DIR_SEPARATOR (p
[-1]))
89 xmalloc_set_program_name (progname
);
91 /* Unlock the stdio streams. */
92 unlock_std_streams ();
96 diagnostic_initialize (global_dc
, 0);
98 while ((opt
= getopt_long (argc
, argv
, "hlpvw", options
, NULL
)) != -1)
109 flag_dump_contents
= 1;
112 flag_dump_positions
= 1;
115 fprintf (stderr
, "unknown flag `%c'\n", opt
);
120 dump_gcov_file (argv
[optind
++]);
127 printf ("Usage: gcov-dump [OPTION] ... gcovfiles\n");
128 printf ("Print coverage file contents\n");
129 printf (" -h, --help Print this help\n");
130 printf (" -l, --long Dump record contents too\n");
131 printf (" -p, --positions Dump record positions\n");
132 printf (" -v, --version Print version number\n");
133 printf ("\nFor bug reporting instructions, please see:\n%s.\n",
140 printf ("gcov-dump %s%s\n", pkgversion_string
, version_string
);
141 printf ("Copyright (C) 2019 Free Software Foundation, Inc.\n");
142 printf ("This is free software; see the source for copying conditions.\n"
143 "There is NO warranty; not even for MERCHANTABILITY or \n"
144 "FITNESS FOR A PARTICULAR PURPOSE.\n\n");
148 print_prefix (const char *filename
, unsigned depth
, gcov_position_t position
)
150 static const char prefix
[] = " ";
152 printf ("%s:", filename
);
153 if (flag_dump_positions
)
154 printf ("%5lu:", (unsigned long) position
);
155 printf ("%.*s", (int) 2 * depth
, prefix
);
159 dump_gcov_file (const char *filename
)
165 if (!gcov_open (filename
, 1))
167 fprintf (stderr
, "%s:cannot open\n", filename
);
173 unsigned magic
= gcov_read_unsigned ();
178 if ((endianness
= gcov_magic (magic
, GCOV_DATA_MAGIC
)))
180 else if ((endianness
= gcov_magic (magic
, GCOV_NOTE_MAGIC
)))
181 is_data_type
= false;
184 printf ("%s:not a gcov file\n", filename
);
188 version
= gcov_read_unsigned ();
189 GCOV_UNSIGNED2STRING (v
, version
);
190 GCOV_UNSIGNED2STRING (m
, magic
);
192 printf ("%s:%s:magic `%.4s':version `%.4s'%s\n", filename
,
193 is_data_type
? "data" : "note",
194 m
, v
, endianness
< 0 ? " (swapped endianness)" : "");
195 if (version
!= GCOV_VERSION
)
199 GCOV_UNSIGNED2STRING (e
, GCOV_VERSION
);
200 printf ("%s:warning:current version is `%.4s'\n", filename
, e
);
206 unsigned stamp
= gcov_read_unsigned ();
208 printf ("%s:stamp %lu\n", filename
, (unsigned long)stamp
);
213 printf ("%s:cwd: %s\n", filename
, gcov_read_string ());
215 /* Support for unexecuted basic blocks. */
216 unsigned support_unexecuted_blocks
= gcov_read_unsigned ();
217 if (!support_unexecuted_blocks
)
218 printf ("%s: has_unexecuted_block is not supported\n", filename
);
223 gcov_position_t base
, position
= gcov_position ();
224 unsigned tag
, length
;
225 tag_format_t
const *format
;
230 tag
= gcov_read_unsigned ();
233 length
= gcov_read_unsigned ();
234 base
= gcov_position ();
235 mask
= GCOV_TAG_MASK (tag
) >> 1;
236 for (tag_depth
= 4; mask
; mask
>>= 8)
238 if ((mask
& 0xff) != 0xff)
240 printf ("%s:tag `%08x' is invalid\n", filename
, tag
);
245 for (format
= tag_table
; format
->name
; format
++)
246 if (format
->tag
== tag
)
248 format
= &tag_table
[GCOV_TAG_IS_COUNTER (tag
) ? 2 : 1];
252 if (depth
&& depth
< tag_depth
)
254 if (!GCOV_TAG_IS_SUBTAG (tags
[depth
- 1], tag
))
255 printf ("%s:tag `%08x' is incorrectly nested\n",
259 tags
[depth
- 1] = tag
;
262 print_prefix (filename
, tag_depth
, position
);
263 printf ("%08x:%4u:%s", tag
, length
, format
->name
);
265 (*format
->proc
) (filename
, tag
, length
, depth
);
268 if (flag_dump_contents
&& format
->proc
)
270 unsigned long actual_length
= gcov_position () - base
;
272 if (actual_length
> length
)
273 printf ("%s:record size mismatch %lu bytes overread\n",
274 filename
, actual_length
- length
);
275 else if (length
> actual_length
)
276 printf ("%s:record size mismatch %lu bytes unread\n",
277 filename
, length
- actual_length
);
279 gcov_sync (base
, length
);
280 if ((error
= gcov_is_error ()))
282 printf (error
< 0 ? "%s:counter overflow at %lu\n" :
283 "%s:read error at %lu\n", filename
,
284 (long unsigned) gcov_position ());
292 tag_function (const char *filename ATTRIBUTE_UNUSED
,
293 unsigned tag ATTRIBUTE_UNUSED
, unsigned length
,
294 unsigned depth ATTRIBUTE_UNUSED
)
296 unsigned long pos
= gcov_position ();
299 printf (" placeholder");
302 printf (" ident=%u", gcov_read_unsigned ());
303 printf (", lineno_checksum=0x%08x", gcov_read_unsigned ());
304 printf (", cfg_checksum=0x%08x", gcov_read_unsigned ());
306 if (gcov_position () - pos
< length
)
310 name
= gcov_read_string ();
311 printf (", `%s'", name
? name
: "NULL");
312 unsigned artificial
= gcov_read_unsigned ();
313 name
= gcov_read_string ();
314 printf (" %s", name
? name
: "NULL");
315 unsigned line_start
= gcov_read_unsigned ();
316 unsigned column_start
= gcov_read_unsigned ();
317 unsigned line_end
= gcov_read_unsigned ();
318 printf (":%u:%u:%u", line_start
, column_start
, line_end
);
320 printf (", artificial");
326 tag_blocks (const char *filename ATTRIBUTE_UNUSED
,
327 unsigned tag ATTRIBUTE_UNUSED
, unsigned length ATTRIBUTE_UNUSED
,
328 unsigned depth ATTRIBUTE_UNUSED
)
330 printf (" %u blocks", gcov_read_unsigned ());
334 tag_arcs (const char *filename ATTRIBUTE_UNUSED
,
335 unsigned tag ATTRIBUTE_UNUSED
, unsigned length ATTRIBUTE_UNUSED
,
338 unsigned n_arcs
= GCOV_TAG_ARCS_NUM (length
);
340 printf (" %u arcs", n_arcs
);
341 if (flag_dump_contents
)
344 unsigned blockno
= gcov_read_unsigned ();
346 for (ix
= 0; ix
!= n_arcs
; ix
++)
353 print_prefix (filename
, depth
, gcov_position ());
354 printf (VALUE_PADDING_PREFIX
"block %u:", blockno
);
356 dst
= gcov_read_unsigned ();
357 flags
= gcov_read_unsigned ();
358 printf (" %u:%04x", dst
, flags
);
363 if (flags
& GCOV_ARC_ON_TREE
)
364 printf ("%ctree", c
), c
= ',';
365 if (flags
& GCOV_ARC_FAKE
)
366 printf ("%cfake", c
), c
= ',';
367 if (flags
& GCOV_ARC_FALLTHROUGH
)
368 printf ("%cfall", c
), c
= ',';
376 tag_lines (const char *filename ATTRIBUTE_UNUSED
,
377 unsigned tag ATTRIBUTE_UNUSED
, unsigned length ATTRIBUTE_UNUSED
,
380 if (flag_dump_contents
)
382 unsigned blockno
= gcov_read_unsigned ();
383 char const *sep
= NULL
;
387 gcov_position_t position
= gcov_position ();
388 const char *source
= NULL
;
389 unsigned lineno
= gcov_read_unsigned ();
393 source
= gcov_read_string ();
402 print_prefix (filename
, depth
, position
);
403 printf (VALUE_PADDING_PREFIX
"block %u:", blockno
);
408 printf ("%s%u", sep
, lineno
);
413 printf ("%s`%s'", sep
, source
);
421 tag_counters (const char *filename ATTRIBUTE_UNUSED
,
422 unsigned tag ATTRIBUTE_UNUSED
, unsigned length ATTRIBUTE_UNUSED
,
425 #define DEF_GCOV_COUNTER(COUNTER, NAME, MERGE_FN) NAME,
426 static const char *const counter_names
[] = {
427 #include "gcov-counter.def"
429 #undef DEF_GCOV_COUNTER
430 unsigned n_counts
= GCOV_TAG_COUNTER_NUM (length
);
432 printf (" %s %u counts",
433 counter_names
[GCOV_COUNTER_FOR_TAG (tag
)], n_counts
);
434 if (flag_dump_contents
)
438 for (ix
= 0; ix
!= n_counts
; ix
++)
445 print_prefix (filename
, depth
, gcov_position ());
446 printf (VALUE_PADDING_PREFIX VALUE_PREFIX
, ix
);
449 count
= gcov_read_counter ();
450 printf ("%" PRId64
" ", count
);
456 tag_summary (const char *filename ATTRIBUTE_UNUSED
,
457 unsigned tag ATTRIBUTE_UNUSED
, unsigned length ATTRIBUTE_UNUSED
,
458 unsigned depth ATTRIBUTE_UNUSED
)
460 gcov_summary summary
;
461 gcov_read_summary (&summary
);
462 printf (" runs=%d, sum_max=%" PRId64
,
463 summary
.runs
, summary
.sum_max
);