/* Gcov.c: prepend line execution counts and branch probabilities to a source file. Copyright (C) 1990, 1991, 1992, 1993, 1994, 1996, 1997, 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc. Contributed by James E. Wilson of Cygnus Support. Mangled by Bob Manson of Cygnus Support. Gcov is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. Gcov is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with Gcov; see the file COPYING. If not, write to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ /* ??? The code in final.c that produces the struct bb assumes that there is no padding between the fields. This is not necessary true. The current code can only be trusted if longs and pointers are the same size. */ /* ??? No need to print an execution count on every line, could just print it on the first line of each block, and only print it on a subsequent line in the same block if the count changes. */ /* ??? Print a list of the ten blocks with the highest execution counts, and list the line numbers corresponding to those blocks. Also, perhaps list the line numbers with the highest execution counts, only printing the first if there are several which are all listed in the same block. */ /* ??? Should have an option to print the number of basic blocks, and the percent of them that are covered. */ /* ??? Does not correctly handle the case where two .bb files refer to the same included source file. For example, if one has a short file containing only inline functions, which is then included in two other files, then there will be two .bb files which refer to the include file, but there is no way to get the total execution counts for the included file, can only get execution counts for one or the other of the including files. */ #include "config.h" #include "system.h" #include "intl.h" #include "version.h" #undef abort #include typedef HOST_WIDEST_INT gcov_type; #include "gcov-io.h" /* The .bb file format consists of several lists of 4-byte integers which are the line numbers of each basic block in the file. Each list is terminated by a zero. These lists correspond to the basic blocks in the reconstructed program flow graph. A line number of -1 indicates that a source file name (padded to a long boundary) follows. The padded file name is followed by another -1 to make it easy to scan past file names. A -2 indicates that a function name (padded to a long boundary) follows; the name is followed by another -2 to make it easy to scan past the function name. The .bbg file contains enough info to enable gcov to reconstruct the program flow graph. The first word is the number of basic blocks, the second word is the number of arcs, followed by the list of arcs (source bb, dest bb pairs), then a -1, then the number of instrumented arcs followed by the instrumented arcs, followed by another -1. This is repeated for each function. The .da file contains the execution count for each instrumented branch. The .bb and .bbg files are created by giving GCC the -ftest-coverage option, and the .da files are created when an executable compiled with -fprofile-arcs is run. */ /* The functions in this file for creating and solution program flow graphs are very similar to functions in the gcc source file profile.c. */ /* This is the size of the buffer used to read in source file lines. */ #define STRING_SIZE 200 /* One copy of this structure is created for each source file mentioned in the .bb file. */ struct sourcefile { char *name; int maxlineno; struct sourcefile *next; }; /* This points to the head of the sourcefile structure list. */ struct sourcefile *sources; /* One of these is dynamically created whenever we identify an arc in the function. */ struct adj_list { int source; int target; gcov_type arc_count; unsigned int count_valid : 1; unsigned int on_tree : 1; unsigned int fake : 1; unsigned int fall_through : 1; #if 0 /* Not needed for gcov, but defined in profile.c. */ rtx branch_insn; #endif struct adj_list *pred_next; struct adj_list *succ_next; }; /* Count the number of basic blocks, and create an array of these structures, one for each bb in the function. */ struct bb_info { struct adj_list *succ; struct adj_list *pred; gcov_type succ_count; gcov_type pred_count; gcov_type exec_count; unsigned int count_valid : 1; unsigned int on_tree : 1; #if 0 /* Not needed for gcov, but defined in profile.c. */ rtx first_insn; #endif }; /* When outputting branch probabilities, one of these structures is created for each branch/call. */ struct arcdata { gcov_type hits; gcov_type total; int call_insn; struct arcdata *next; }; /* Used to save the list of bb_graphs, one per function. */ struct bb_info_list { /* Indexed by block number, holds the basic block graph for one function. */ struct bb_info *bb_graph; int num_blocks; struct bb_info_list *next; }; /* Used to hold information about each line. */ struct line_info { gcov_type count; /* execution count */ struct arcdata *branches; /* list of branch probabilities for line. */ unsigned exists : 1; /* has code associated with it. */ }; struct coverage { int lines; int lines_executed; int branches; int branches_executed; int branches_taken; int calls; int calls_executed; char *name; }; /* Holds a list of function basic block graphs. */ static struct bb_info_list *bb_graph_list = 0; /* Modification time of data files. */ static time_t bb_file_time; /* Name and file pointer of the input file for the basic block graph. */ static char *bbg_file_name; static FILE *bbg_file; /* Name and file pointer of the input file for the arc count data. */ static char *da_file_name; static FILE *da_file; /* Name and file pointer of the input file for the basic block line counts. */ static char *bb_file_name; static FILE *bb_file; /* Holds the entire contents of the bb_file read into memory. */ static char *bb_data; /* Size of bb_data array in longs. */ static long bb_data_size; /* Name of the file mentioned on the command line. */ static char *input_file_name = 0; /* Output branch probabilities if true. */ static int output_branch_probs = 0; /* Output a gcov file if this is true. This is on by default, and can be turned off by the -n option. */ static int output_gcov_file = 1; /* For included files, make the gcov output file name include the name of the input source file. For example, if x.h is included in a.c, then the output file name is a.c.x.h.gcov instead of x.h.gcov. This works only when a single source file is specified. */ static int output_long_names = 0; /* Output summary info for each function. */ static int output_function_summary = 0; /* Object directory file prefix. This is the directory/file where .bb and .bbg files are looked for, if non-zero. */ static char *object_directory = 0; /* Preserve all pathname components. Needed when object files and source files are in subdirectories. */ static int preserve_paths = 0; /* Output the number of times a branch was taken as opposed to the percentage of times it was taken. Turned on by the -c option */ static int output_branch_counts = 0; /* Forward declarations. */ static void process_args PARAMS ((int, char **)); static void open_files PARAMS ((void)); static void read_files PARAMS ((void)); static void scan_for_source_files PARAMS ((void)); static void output_data PARAMS ((struct sourcefile *)); static void print_usage PARAMS ((int)) ATTRIBUTE_NORETURN; static void print_version PARAMS ((void)) ATTRIBUTE_NORETURN; static void init_arc PARAMS ((struct adj_list *, int, int, struct bb_info *)); static struct adj_list *reverse_arcs PARAMS ((struct adj_list *)); static gcov_type *read_profile PARAMS ((char *, long, int)); static void create_program_flow_graph PARAMS ((struct bb_info_list *)); static void solve_program_flow_graph PARAMS ((struct bb_info_list *)); static void accumulate_branch_counts PARAMS ((struct coverage *, struct arcdata *)); static void calculate_branch_probs PARAMS ((struct bb_info *, struct line_info *, struct coverage *)); static void function_summary PARAMS ((struct coverage *, const char *)); static void init_line_info PARAMS ((struct line_info *, struct coverage *, long)); static void output_line_info PARAMS ((FILE *, const struct line_info *, const struct coverage *, long)); static char *make_gcov_file_name PARAMS ((char *)); static const char *format_hwint PARAMS ((HOST_WIDEST_INT, HOST_WIDEST_INT, int)); extern int main PARAMS ((int, char **)); int main (argc, argv) int argc; char **argv; { struct sourcefile *s_ptr; gcc_init_libintl (); process_args (argc, argv); open_files (); read_files (); scan_for_source_files (); for (s_ptr = sources; s_ptr; s_ptr = s_ptr->next) output_data (s_ptr); return 0; } static void fnotice PARAMS ((FILE *, const char *, ...)) ATTRIBUTE_PRINTF_2; static void fnotice VPARAMS ((FILE *file, const char *msgid, ...)) { VA_OPEN (ap, msgid); VA_FIXEDARG (ap, FILE *, file); VA_FIXEDARG (ap, const char *, msgid); vfprintf (file, _(msgid), ap); VA_CLOSE (ap); } /* More 'friendly' abort that prints the line and file. config.h can #define abort fancy_abort if you like that sort of thing. */ extern void fancy_abort PARAMS ((void)) ATTRIBUTE_NORETURN; void fancy_abort () { fnotice (stderr, "Internal gcov abort.\n"); exit (FATAL_EXIT_CODE); } /* Print a usage message and exit. If ERROR_P is nonzero, this is an error, otherwise the output of --help. */ static void print_usage (error_p) int error_p; { FILE *file = error_p ? stderr : stdout; int status = error_p ? FATAL_EXIT_CODE : SUCCESS_EXIT_CODE; fnotice (file, "Usage: gcov [OPTION]... SOURCEFILE\n\n"); fnotice (file, "Print code coverage information.\n\n"); fnotice (file, " -h, --help Print this help, then exit\n"); fnotice (file, " -v, --version Print version number, then exit\n"); fnotice (file, " -b, --branch-probabilities Include branch probabilities in output\n"); fnotice (file, " -c, --branch-counts Given counts of branches taken\n\ rather than percentages\n"); fnotice (file, " -n, --no-output Do not create an output file\n"); fnotice (file, " -l, --long-file-names Use long output file names for included\n\ source files\n"); fnotice (file, " -f, --function-summaries Output summaries for each function\n"); fnotice (file, " -o, --object-directory DIR|FILE Search for object files in DIR or called FILE\n"); fnotice (file, " -p, --preserve-paths Preserve all pathname components\n"); fnotice (file, "\nFor bug reporting instructions, please see:\n%s.\n", GCCBUGURL); exit (status); } /* Print version information and exit. */ static void print_version () { fnotice (stdout, "gcov (GCC) %s\n", version_string); fnotice (stdout, "Copyright (C) 2001 Free Software Foundation, Inc.\n"); fnotice (stdout, "This is free software; see the source for copying conditions. There is NO\n\ warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n\n"); exit (SUCCESS_EXIT_CODE); } static const struct option options[] = { { "help", no_argument, NULL, 'h' }, { "version", no_argument, NULL, 'v' }, { "branch-probabilities", no_argument, NULL, 'b' }, { "branch-counts", no_argument, NULL, 'c' }, { "no-output", no_argument, NULL, 'n' }, { "long-file-names", no_argument, NULL, 'l' }, { "function-summaries", no_argument, NULL, 'f' }, { "preserve-paths", no_argument, NULL, 'p' }, { "object-directory", required_argument, NULL, 'o' }, { "object-file", required_argument, NULL, 'o' }, }; /* Parse the command line. */ static void process_args (argc, argv) int argc; char **argv; { int opt; while ((opt = getopt_long (argc, argv, "hvbclnfo:p", options, NULL)) != -1) { switch (opt) { case 'h': print_usage (false); /* print_usage will exit. */ case 'v': print_version (); /* print_version will exit. */ case 'b': output_branch_probs = 1; break; case 'c': output_branch_counts = 1; break; case 'n': output_gcov_file = 0; break; case 'l': output_long_names = 1; break; case 'f': output_function_summary = 1; break; case 'o': object_directory = optarg; break; case 'p': preserve_paths = 1; break; default: print_usage (true); /* print_usage will exit. */ } } if (optind != argc - 1) print_usage (true); input_file_name = argv[optind]; } /* Find and open the .bb, .da, and .bbg files. If OBJECT_DIRECTORY is not specified, these are looked for in the current directory, and named from the basename of the input_file_name sans extension. If OBJECT_DIRECTORY is specified and is a directory, the files are in that directory, but named from the basename of the input_file_name, sans extension. Otherwise OBJECT_DIRECTORY is taken to be the name of the object *file*, and the data files are named from that. */ static void open_files () { char *cptr; char *name; int length = strlen (input_file_name); int base; if (object_directory && object_directory[0]) { struct stat status; length += strlen (object_directory) + 2; name = xmalloc (length); name[0] = 0; base = !stat (object_directory, &status) && S_ISDIR (status.st_mode); strcat (name, object_directory); if (base && name[strlen (name) - 1] != '/') strcat (name, "/"); } else { name = xmalloc (length + 1); name[0] = 0; base = 1; } if (base) { /* Append source file name */ cptr = strrchr (input_file_name, '/'); cptr = cptr ? cptr + 1 : input_file_name; strcat (name, cptr); } /* Remove the extension. */ cptr = strrchr (name, '.'); if (cptr) *cptr = 0; length = strlen (name); da_file_name = xmalloc (length + 4); bb_file_name = xmalloc (length + 4); bbg_file_name = xmalloc (length + 5); strcpy (da_file_name, name); strcpy (bb_file_name, name); strcpy (bbg_file_name, name); strcpy (da_file_name + length, ".da"); strcpy (bb_file_name + length, ".bb"); strcpy (bbg_file_name + length, ".bbg"); bb_file = fopen (bb_file_name, "rb"); if (bb_file == NULL) { fnotice (stderr, "Could not open basic block file %s.\n", bb_file_name); exit (FATAL_EXIT_CODE); } bbg_file = fopen (bbg_file_name, "rb"); if (bbg_file == NULL) { fnotice (stderr, "Could not open program flow graph file %s.\n", bbg_file_name); exit (FATAL_EXIT_CODE); } { struct stat status; if (!fstat (fileno (bb_file), &status)) bb_file_time = status.st_mtime; } /* If none of the functions in the file were executed, then there won't be a .da file. Just assume that all counts are zero in this case. */ da_file = fopen (da_file_name, "rb"); if (da_file == NULL) { fnotice (stderr, "Could not open data file %s.\n", da_file_name); fnotice (stderr, "Assuming that all execution counts are zero.\n"); } /* Check for empty .bbg file. This indicates that there is no executable code in this source file. */ /* Set the EOF condition if at the end of file. */ ungetc (getc (bbg_file), bbg_file); if (feof (bbg_file)) { fnotice (stderr, "No executable code associated with file %s.\n", input_file_name); exit (FATAL_EXIT_CODE); } } /* Initialize a new arc. */ static void init_arc (arcptr, source, target, bb_graph) struct adj_list *arcptr; int source, target; struct bb_info *bb_graph; { arcptr->target = target; arcptr->source = source; arcptr->arc_count = 0; arcptr->count_valid = 0; arcptr->on_tree = 0; arcptr->fake = 0; arcptr->fall_through = 0; arcptr->succ_next = bb_graph[source].succ; bb_graph[source].succ = arcptr; bb_graph[source].succ_count++; arcptr->pred_next = bb_graph[target].pred; bb_graph[target].pred = arcptr; bb_graph[target].pred_count++; } /* Reverse the arcs on an arc list. */ static struct adj_list * reverse_arcs (arcptr) struct adj_list *arcptr; { struct adj_list *prev = 0; struct adj_list *next; for ( ; arcptr; arcptr = next) { next = arcptr->succ_next; arcptr->succ_next = prev; prev = arcptr; } return prev; } /* Reads profiles from the .da file and compute a hybrid profile. */ static gcov_type * read_profile (function_name, cfg_checksum, instr_arcs) char *function_name; long cfg_checksum; int instr_arcs; { int i; int okay = 1; gcov_type *profile; char *function_name_buffer; int function_name_buffer_len; profile = xmalloc (sizeof (gcov_type) * instr_arcs); function_name_buffer_len = strlen (function_name) + 1; function_name_buffer = xmalloc (function_name_buffer_len + 1); for (i = 0; i < instr_arcs; i++) profile[i] = 0; if (!da_file) return profile; rewind (da_file); while (1) { long magic, extra_bytes; long func_count; int i; if (__read_long (&magic, da_file, 4) != 0) break; if (magic != -123) { okay = 0; break; } if (__read_long (&func_count, da_file, 4) != 0) { okay = 0; break; } if (__read_long (&extra_bytes, da_file, 4) != 0) { okay = 0; break; } /* skip extra data emited by __bb_exit_func. */ fseek (da_file, extra_bytes, SEEK_CUR); for (i = 0; i < func_count; i++) { long arc_count; long chksum; int j; if (__read_gcov_string (function_name_buffer, function_name_buffer_len, da_file, -1) != 0) { okay = 0; break; } if (__read_long (&chksum, da_file, 4) != 0) { okay = 0; break; } if (__read_long (&arc_count, da_file, 4) != 0) { okay = 0; break; } if (strcmp (function_name_buffer, function_name) != 0 || arc_count != instr_arcs || chksum != cfg_checksum) { /* skip */ if (fseek (da_file, arc_count * 8, SEEK_CUR) < 0) { okay = 0; break; } } else { gcov_type tmp; for (j = 0; j < arc_count; j++) if (__read_gcov_type (&tmp, da_file, 8) != 0) { okay = 0; break; } else { profile[j] += tmp; } } } if (!okay) break; } free (function_name_buffer); if (!okay) { fprintf (stderr, ".da file corrupted!\n"); free (profile); abort (); } return profile; } /* Construct the program flow graph from the .bbg file, and read in the data in the .da file. */ static void create_program_flow_graph (bptr) struct bb_info_list *bptr; { long num_blocks, number_arcs, src, dest, flag_bits, num_arcs_per_block; int i; struct adj_list *arcptr; struct bb_info *bb_graph; long cfg_checksum; long instr_arcs = 0; gcov_type *profile; int profile_pos = 0; char *function_name; long function_name_len, tmp; /* Read function name. */ __read_long (&tmp, bbg_file, 4); /* ignore -1. */ __read_long (&function_name_len, bbg_file, 4); function_name = xmalloc (function_name_len + 1); fread (function_name, 1, function_name_len + 1, bbg_file); /* Skip padding. */ tmp = (function_name_len + 1) % 4; if (tmp) fseek (bbg_file, 4 - tmp, SEEK_CUR); __read_long (&tmp, bbg_file, 4); /* ignore -1. */ /* Read the cfg checksum. */ __read_long (&cfg_checksum, bbg_file, 4); /* Read the number of blocks. */ __read_long (&num_blocks, bbg_file, 4); /* Create an array of size bb number of bb_info structs. */ bb_graph = (struct bb_info *) xcalloc (num_blocks, sizeof (struct bb_info)); bptr->bb_graph = bb_graph; bptr->num_blocks = num_blocks; /* Read and create each arc from the .bbg file. */ __read_long (&number_arcs, bbg_file, 4); for (i = 0; i < num_blocks; i++) { int j; __read_long (&num_arcs_per_block, bbg_file, 4); for (j = 0; j < num_arcs_per_block; j++) { if (number_arcs-- < 0) abort (); src = i; __read_long (&dest, bbg_file, 4); arcptr = (struct adj_list *) xmalloc (sizeof (struct adj_list)); init_arc (arcptr, src, dest, bb_graph); __read_long (&flag_bits, bbg_file, 4); if (flag_bits & 0x1) arcptr->on_tree++; else instr_arcs++; arcptr->fake = !! (flag_bits & 0x2); arcptr->fall_through = !! (flag_bits & 0x4); } } if (number_arcs) abort (); /* Read and ignore the -1 separating the arc list from the arc list of the next function. */ __read_long (&src, bbg_file, 4); if (src != -1) abort (); /* Must reverse the order of all succ arcs, to ensure that they match the order of the data in the .da file. */ for (i = 0; i < num_blocks; i++) if (bb_graph[i].succ) bb_graph[i].succ = reverse_arcs (bb_graph[i].succ); /* Read profile from the .da file. */ profile = read_profile (function_name, cfg_checksum, instr_arcs); /* For each arc not on the spanning tree, set its execution count from the .da file. */ /* The first count in the .da file is the number of times that the function was entered. This is the exec_count for block zero. */ /* This duplicates code in branch_prob in profile.c. */ for (i = 0; i < num_blocks; i++) for (arcptr = bb_graph[i].succ; arcptr; arcptr = arcptr->succ_next) if (! arcptr->on_tree) { arcptr->arc_count = profile[profile_pos++]; arcptr->count_valid = 1; bb_graph[i].succ_count--; bb_graph[arcptr->target].pred_count--; } free (profile); free (function_name); } static void solve_program_flow_graph (bptr) struct bb_info_list *bptr; { int passes, changes; gcov_type total; int i; struct adj_list *arcptr; struct bb_info *bb_graph; int num_blocks; num_blocks = bptr->num_blocks; bb_graph = bptr->bb_graph; /* For every block in the file, - if every exit/entrance arc has a known count, then set the block count - if the block count is known, and every exit/entrance arc but one has a known execution count, then set the count of the remaining arc As arc counts are set, decrement the succ/pred count, but don't delete the arc, that way we can easily tell when all arcs are known, or only one arc is unknown. */ /* The order that the basic blocks are iterated through is important. Since the code that finds spanning trees starts with block 0, low numbered arcs are put on the spanning tree in preference to high numbered arcs. Hence, most instrumented arcs are at the end. Graph solving works much faster if we propagate numbers from the end to the start. This takes an average of slightly more than 3 passes. */ changes = 1; passes = 0; while (changes) { passes++; changes = 0; for (i = num_blocks - 1; i >= 0; i--) { if (! bb_graph[i].count_valid) { if (bb_graph[i].succ_count == 0) { total = 0; for (arcptr = bb_graph[i].succ; arcptr; arcptr = arcptr->succ_next) total += arcptr->arc_count; bb_graph[i].exec_count = total; bb_graph[i].count_valid = 1; changes = 1; } else if (bb_graph[i].pred_count == 0) { total = 0; for (arcptr = bb_graph[i].pred; arcptr; arcptr = arcptr->pred_next) total += arcptr->arc_count; bb_graph[i].exec_count = total; bb_graph[i].count_valid = 1; changes = 1; } } if (bb_graph[i].count_valid) { if (bb_graph[i].succ_count == 1) { total = 0; /* One of the counts will be invalid, but it is zero, so adding it in also doesn't hurt. */ for (arcptr = bb_graph[i].succ; arcptr; arcptr = arcptr->succ_next) total += arcptr->arc_count; /* Calculate count for remaining arc by conservation. */ total = bb_graph[i].exec_count - total; /* Search for the invalid arc, and set its count. */ for (arcptr = bb_graph[i].succ; arcptr; arcptr = arcptr->succ_next) if (! arcptr->count_valid) break; if (! arcptr) abort (); arcptr->count_valid = 1; arcptr->arc_count = total; bb_graph[i].succ_count--; bb_graph[arcptr->target].pred_count--; changes = 1; } if (bb_graph[i].pred_count == 1) { total = 0; /* One of the counts will be invalid, but it is zero, so adding it in also doesn't hurt. */ for (arcptr = bb_graph[i].pred; arcptr; arcptr = arcptr->pred_next) total += arcptr->arc_count; /* Calculate count for remaining arc by conservation. */ total = bb_graph[i].exec_count - total; /* Search for the invalid arc, and set its count. */ for (arcptr = bb_graph[i].pred; arcptr; arcptr = arcptr->pred_next) if (! arcptr->count_valid) break; if (! arcptr) abort (); arcptr->count_valid = 1; arcptr->arc_count = total; bb_graph[i].pred_count--; bb_graph[arcptr->source].succ_count--; changes = 1; } } } } /* If the graph has been correctly solved, every block will have a succ and pred count of zero. */ for (i = 0; i < num_blocks; i++) if (bb_graph[i].succ_count || bb_graph[i].pred_count) abort (); } static void read_files () { struct stat buf; struct bb_info_list *list_end = 0; struct bb_info_list *b_ptr; while (! feof (bbg_file)) { b_ptr = (struct bb_info_list *) xmalloc (sizeof (struct bb_info_list)); b_ptr->next = 0; if (list_end) list_end->next = b_ptr; else bb_graph_list = b_ptr; list_end = b_ptr; /* Read in the data in the .bbg file and reconstruct the program flow graph for one function. */ create_program_flow_graph (b_ptr); /* Set the EOF condition if at the end of file. */ ungetc (getc (bbg_file), bbg_file); } /* Calculate all of the basic block execution counts and branch taken probabilities. */ for (b_ptr = bb_graph_list; b_ptr; b_ptr = b_ptr->next) solve_program_flow_graph (b_ptr); /* Read in all of the data from the .bb file. This info will be accessed sequentially twice. */ stat (bb_file_name, &buf); bb_data_size = buf.st_size / 4; bb_data = (char *) xmalloc ((unsigned) buf.st_size); fread (bb_data, sizeof (char), buf.st_size, bb_file); fclose (bb_file); if (da_file) fclose (da_file); fclose (bbg_file); } /* Scan the data in the .bb file to find all source files referenced, and the largest line number mentioned in each one. */ static void scan_for_source_files () { struct sourcefile *s_ptr = NULL; char *ptr; long count; long line_num; /* Search the bb_data to find: 1) The number of sources files contained herein, and 2) The largest line number for each source file. */ ptr = bb_data; sources = 0; for (count = 0; count < bb_data_size; count++) { __fetch_long (&line_num, ptr, 4); ptr += 4; if (line_num == -1) { /* A source file name follows. Check to see if we already have a sourcefile structure for this file. */ s_ptr = sources; while (s_ptr && strcmp (s_ptr->name, ptr)) s_ptr = s_ptr->next; if (s_ptr == 0) { /* No sourcefile structure for this file name exists, create a new one, and append it to the front of the sources list. */ s_ptr = (struct sourcefile *) xmalloc (sizeof(struct sourcefile)); s_ptr->name = xstrdup (ptr); s_ptr->maxlineno = 0; s_ptr->next = sources; sources = s_ptr; } /* Scan past the file name. */ { long delim; do { count++; __fetch_long (&delim, ptr, 4); ptr += 4; } while (delim != line_num); } } else if (line_num == -2) { long delim; /* A function name follows. Ignore it. */ do { count++; __fetch_long (&delim, ptr, 4); ptr += 4; } while (delim != line_num); } /* There will be a zero before the first file name, in which case s_ptr will still be uninitialized. So, only try to set the maxlineno field if line_num is non-zero. */ else if (line_num > 0) { if (s_ptr->maxlineno <= line_num) s_ptr->maxlineno = line_num + 1; } else if (line_num < 0) { /* Don't know what this is, but it's garbage. */ abort (); } } } /* Increment totals in FUNCTION according to arc A_PTR. */ static void accumulate_branch_counts (function, a_ptr) struct coverage *function; struct arcdata *a_ptr; { if (a_ptr->call_insn) { function->calls++; if (a_ptr->total) function->calls_executed++; } else { function->branches++; if (a_ptr->total) function->branches_executed++; if (a_ptr->hits) function->branches_taken++; } } /* Calculate the branch taken probabilities for all arcs branches at the end of this block. */ static void calculate_branch_probs (block_ptr, line_info, function) struct bb_info *block_ptr; struct line_info *line_info; struct coverage *function; { gcov_type total; struct adj_list *arcptr; total = block_ptr->exec_count; for (arcptr = block_ptr->succ; arcptr; arcptr = arcptr->succ_next) { struct arcdata *a_ptr; /* Ignore fall through arcs as they aren't really branches. */ if (arcptr->fall_through) continue; a_ptr = (struct arcdata *) xmalloc (sizeof (struct arcdata)); a_ptr->total = total; a_ptr->hits = total ? arcptr->arc_count : 0; a_ptr->call_insn = arcptr->fake; if (function) accumulate_branch_counts (function, a_ptr); /* Prepend the new branch to the list. */ a_ptr->next = line_info->branches; line_info->branches = a_ptr; } } /* Format a HOST_WIDE_INT as either a percent ratio, or absolute count. If dp >= 0, format TOP/BOTTOM * 100 to DP decimal places. If DP is zero, no decimal point is printed. Only print 100% when TOP==BOTTOM and only print 0% when TOP=0. If dp < 0, then simply format TOP. Return pointer to a static string. */ static char const * format_hwint (top, bottom, dp) HOST_WIDEST_INT top, bottom; int dp; { static char buffer[20]; if (dp >= 0) { float ratio = bottom ? (float)top / bottom : 0; int ix; unsigned limit = 100; unsigned percent; for (ix = dp; ix--; ) limit *= 10; percent = (unsigned) (ratio * limit + (float)0.5); if (percent <= 0 && top) percent = 1; else if (percent >= limit && top != bottom) percent = limit - 1; ix = sprintf (buffer, "%.*u%%", dp + 1, percent); if (dp) { dp++; do { buffer[ix+1] = buffer[ix]; ix--; } while (dp--); buffer[ix + 1] = '.'; } } else sprintf (buffer, HOST_WIDEST_INT_PRINT_DEC, top); return buffer; } /* Output summary info for a function. */ static void function_summary (function, title) struct coverage *function; const char *title; { if (function->lines) fnotice (stdout, "%s of %d lines executed in %s %s\n", format_hwint (function->lines_executed, function->lines, 2), function->lines, title, function->name); else fnotice (stdout, "No executable lines in %s %s\n", title, function->name); if (output_branch_probs) { if (function->branches) { fnotice (stdout, "%s of %d branches executed in %s %s\n", format_hwint (function->branches_executed, function->branches, 2), function->branches, title, function->name); fnotice (stdout, "%s of %d branches taken at least once in %s %s\n", format_hwint (function->branches_taken, function->branches, 2), function->branches, title, function->name); } else fnotice (stdout, "No branches in %s %s\n", title, function->name); if (function->calls) fnotice (stdout, "%s of %d calls executed in %s %s\n", format_hwint (function->calls_executed, function->calls, 2), function->calls, title, function->name); else fnotice (stdout, "No calls in %s %s\n", title, function->name); } } /* Generate an output file name. LONG_OUTPUT_NAMES and PRESERVE_PATHS affect name generation. With preserve_paths we create a filename from all path components of the source file, replacing '/' with '#', without it we simply take the basename component. With long_output_names we prepend the processed name of the input file to each output name (except when the current source file is the input file, so you don't get a double concatenation). The two components are separated by '##'. Also '.' filename components are removed and '..' components are renamed to '^'. */ static char * make_gcov_file_name (src_name) char *src_name; { char *cptr; char *name = xmalloc (strlen (src_name) + strlen (input_file_name) + 10); name[0] = 0; if (output_long_names && strcmp (src_name, input_file_name)) { /* Generate the input filename part. */ cptr = preserve_paths ? NULL : strrchr (input_file_name, '/'); cptr = cptr ? cptr + 1 : input_file_name; strcat (name, cptr); strcat (name, "##"); } /* Generate the source filename part. */ cptr = preserve_paths ? NULL : strrchr (src_name, '/'); cptr = cptr ? cptr + 1 : src_name; strcat (name, cptr); if (preserve_paths) { /* Convert '/' to '#', remove '/./', convert '/../' to '/^/' */ char *prev; for (cptr = name; (cptr = strchr ((prev = cptr), '/'));) { unsigned shift = 0; if (prev + 1 == cptr && prev[0] == '.') { /* Remove '.' */ shift = 2; } else if (prev + 2 == cptr && prev[0] == '.' && prev[1] == '.') { /* Convert '..' */ shift = 1; prev[1] = '^'; } else *cptr++ = '#'; if (shift) { cptr = prev; do prev[0] = prev[shift]; while (*prev++); } } } /* Don't strip off the ending for compatibility with tcov, since this results in confusion if there is more than one file with the same basename, e.g. tmp.c and tmp.h. */ strcat (name, ".gcov"); return name; } /* Scan through the bb_data, and when the file name matches the source file name, then for each following line number, increment the line number execution count indicated by the execution count of the appropriate basic block. */ static void init_line_info (line_info, total, maxlineno) struct line_info *line_info; struct coverage *total; long maxlineno; { long block_num = 0; /* current block number */ struct bb_info *block_ptr = NULL; /* current block ptr */ struct coverage function; struct coverage *func_ptr = NULL; struct bb_info_list *current_graph = NULL; /* Graph for current function. */ int is_this_file = 0; /* We're scanning a block from the desired file. */ char *ptr = bb_data; long count; long line_num; struct line_info *line_ptr = 0; /* line info ptr. */ memset (&function, 0, sizeof (function)); if (output_function_summary) func_ptr = &function; for (count = 0; count < bb_data_size; count++) { __fetch_long (&line_num, ptr, 4); ptr += 4; if (line_num < 0) { long delim; if (line_num == -1) { /* Marks the beginning of a file name. Check to see whether this is the filename we are currently collecting data for. */ is_this_file = !strcmp (total->name, ptr); } else if (line_num == -2) { /* Marks the start of a new function. Advance to the next program flow graph. */ if (!current_graph) current_graph = bb_graph_list; else { if (block_num == current_graph->num_blocks - 1) /* Last block falls through to exit. */ ; else if (block_num == current_graph->num_blocks - 2) { if (output_branch_probs && is_this_file) calculate_branch_probs (block_ptr, line_ptr, func_ptr); } else { fnotice (stderr, "didn't use all bb entries of graph, function %s\n", function.name); fnotice (stderr, "block_num = %ld, num_blocks = %d\n", block_num, current_graph->num_blocks); } if (func_ptr && is_this_file) function_summary (func_ptr, "function"); current_graph = current_graph->next; } block_num = 0; block_ptr = current_graph->bb_graph; memset (&function, 0, sizeof (function)); function.name = ptr; } else { fnotice (stderr, "ERROR: unexpected line number %ld\n", line_num); abort (); } /* Scan past the string. */ for (delim = 0; delim != line_num; count++) { __fetch_long (&delim, ptr, 4); ptr += 4; } } else if (!line_num) { /* Marks the end of a block. */ if (block_num >= current_graph->num_blocks) { fnotice (stderr, "ERROR: too many basic blocks in function %s\n", function.name); abort (); } if (output_branch_probs && is_this_file) calculate_branch_probs (block_ptr, line_ptr, func_ptr); block_num++; block_ptr++; } else if (is_this_file) { if (line_num >= maxlineno) { fnotice (stderr, "ERROR: out of range line number in function %s\n", function.name); abort (); } line_ptr = &line_info[line_num]; if (func_ptr) { if (!line_ptr->exists) func_ptr->lines++; if (!line_ptr->count && block_ptr->exec_count) func_ptr->lines_executed++; } /* Accumulate execution data for this line number. */ line_ptr->count += block_ptr->exec_count; line_ptr->exists = 1; } } if (func_ptr && is_this_file) function_summary (func_ptr, "function"); /* Calculate summary test coverage statistics. */ for (line_num = 1, line_ptr = &line_info[line_num]; line_num < maxlineno; line_num++, line_ptr++) { struct arcdata *a_ptr, *prev, *next; if (line_ptr->exists) { total->lines++; if (line_ptr->count) total->lines_executed++; } /* Total and reverse the branch information. */ for (a_ptr = line_ptr->branches, prev = NULL; a_ptr; a_ptr = next) { next = a_ptr->next; a_ptr->next = prev; prev = a_ptr; accumulate_branch_counts (total, a_ptr); } line_ptr->branches = prev; } } /* Read in the source file one line at a time, and output that line to the gcov file preceded by its execution count and other information. */ static void output_line_info (gcov_file, line_info, total, maxlineno) FILE *gcov_file; const struct line_info *line_info; const struct coverage *total; long maxlineno; { FILE *source_file; long line_num; /* current line number */ const struct line_info *line_ptr; /* current line info ptr. */ char string[STRING_SIZE]; /* line buffer. */ char const *retval = ""; /* status of source file reading. */ fprintf (gcov_file, "%9s:%5d:Source:%s\n", "-", 0, total->name); fprintf (gcov_file, "%9s:%5d:Object:%s\n", "-", 0, bb_file_name); source_file = fopen (total->name, "r"); if (!source_file) { fnotice (stderr, "Could not open source file %s.\n", total->name); retval = NULL; } else { struct stat status; if (!fstat (fileno (source_file), &status) && status.st_mtime > bb_file_time) { fnotice (stderr, "Warning: source file %s is newer than %s\n", total->name, bb_file_name); fprintf (gcov_file, "%9s:%5d:Source is newer than compiler output\n", "-", 0); } } for (line_num = 1, line_ptr = &line_info[line_num]; line_num < maxlineno; line_num++, line_ptr++) { /* For lines which don't exist in the .bb file, print '-' before the source line. For lines which exist but were never executed, print '#####' before the source line. Otherwise, print the execution count before the source line. There are 16 spaces of indentation added before the source line so that tabs won't be messed up. */ fprintf (gcov_file, "%9s:%5ld:", !line_ptr->exists ? "-" : !line_ptr->count ? "#####" : format_hwint (line_ptr->count, 0, -1), line_num); if (retval) { /* Copy source line. */ do { retval = fgets (string, STRING_SIZE, source_file); if (!retval) { fnotice (stderr, "Unexpected EOF while reading source file %s.\n", total->name); break; } fputs (retval, gcov_file); } while (!retval[0] || retval[strlen (retval) - 1] != '\n'); } if (!retval) fputs ("??\n", gcov_file); if (output_branch_probs) { int i; struct arcdata *a_ptr; for (i = 0, a_ptr = line_ptr->branches; a_ptr; a_ptr = a_ptr->next, i++) { if (a_ptr->call_insn) { if (a_ptr->total == 0) fnotice (gcov_file, "call %2d never executed\n", i); else fnotice (gcov_file, "call %2d returns %s\n", i, format_hwint (a_ptr->total - a_ptr->hits, a_ptr->total, -output_branch_counts)); } else { if (a_ptr->total == 0) fnotice (gcov_file, "branch %2d never executed\n", i); else fnotice (gcov_file, "branch %2d taken %s\n", i, format_hwint (a_ptr->hits, a_ptr->total, -output_branch_counts)); } } } } /* Handle all remaining source lines. There may be lines after the last line of code. */ if (retval) { for (; (retval = fgets (string, STRING_SIZE, source_file)); line_num++) { fprintf (gcov_file, "%9s:%5ld:%s", "-", line_num, retval); while (!retval[0] || retval[strlen (retval) - 1] != '\n') { retval = fgets (string, STRING_SIZE, source_file); if (!retval) break; fputs (retval, gcov_file); } } } if (source_file) fclose (source_file); } /* Calculate line execution counts, and output a .gcov file for source file S_PTR. Allocate an array big enough to hold a count for each line. Scan through the bb_data, and when the file name matches the current file name, then for each following line number, increment the line number execution count indicated by the execution count of the appropriate basic block. */ static void output_data (s_ptr) struct sourcefile *s_ptr; { struct line_info *line_info /* line info data */ = (struct line_info *) xcalloc (s_ptr->maxlineno, sizeof (struct line_info)); long line_num; struct coverage total; memset (&total, 0, sizeof (total)); total.name = s_ptr->name; init_line_info (line_info, &total, s_ptr->maxlineno); function_summary (&total, "file"); if (output_gcov_file) { /* Now the statistics are ready. Read in the source file one line at a time, and output that line to the gcov file preceded by its execution information. */ char *gcov_file_name = make_gcov_file_name (total.name); FILE *gcov_file = fopen (gcov_file_name, "w"); if (gcov_file) { fnotice (stdout, "Creating %s.\n", gcov_file_name); output_line_info (gcov_file, line_info, &total, s_ptr->maxlineno); if (ferror (gcov_file)) fnotice (stderr, "Error writing output file %s.\n", gcov_file_name); fclose (gcov_file); } else fnotice (stderr, "Could not open output file %s.\n", gcov_file_name); free (gcov_file_name); } /* Free data. */ for (line_num = 1; line_num != s_ptr->maxlineno; line_num++) { struct arcdata *branch, *next; for (branch = line_info[line_num].branches; branch; branch = next) { next = branch->next; free (branch); } } free (line_info); }