diff options
author | Steven Bosscher <steven@gcc.gnu.org> | 2012-07-23 11:59:15 +0000 |
---|---|---|
committer | Steven Bosscher <steven@gcc.gnu.org> | 2012-07-23 11:59:15 +0000 |
commit | efbb59b21bcb70426f49e39b01c3aa0021f6a32c (patch) | |
tree | 6f165840c56b203cb68dd725d9235cd67b425d70 /gcc/doc/gcov.texi | |
parent | fa0f4017753805e73898a46abdf8ffb72a9977c0 (diff) | |
download | gcc-efbb59b21bcb70426f49e39b01c3aa0021f6a32c.zip gcc-efbb59b21bcb70426f49e39b01c3aa0021f6a32c.tar.gz gcc-efbb59b21bcb70426f49e39b01c3aa0021f6a32c.tar.bz2 |
coverage.c: Refer to "notes file" instead of "graph file" in all comments.
gcc/
* coverage.c: Refer to "notes file" instead of "graph file"
in all comments. Explain history of bbg prefix.
* gcov-io.h: Likewise.
* gcov.c: Likewise.
(find_source): Likewise in fnotice.
(read_graph_file): Likewise.
(read_count_file): Likewise.
* doc/gcov.texi: Document -fprofile-dir flag. Add "notes file"
and "data file" explicitly in the explanation of the files.
libgcc/
* libgcov.c (__gcov_ior_profiler): Benign comment fix.
From-SVN: r189781
Diffstat (limited to 'gcc/doc/gcov.texi')
-rw-r--r-- | gcc/doc/gcov.texi | 25 |
1 files changed, 14 insertions, 11 deletions
diff --git a/gcc/doc/gcov.texi b/gcc/doc/gcov.texi index 7256664..307137a 100644 --- a/gcc/doc/gcov.texi +++ b/gcc/doc/gcov.texi @@ -551,20 +551,23 @@ collected at that point to be dumped to @file{.gcda} output files. @command{gcov} uses two files for profiling. The names of these files are derived from the original @emph{object} file by substituting the -file suffix with either @file{.gcno}, or @file{.gcda}. All of these files -are placed in the same directory as the object file, and contain data -stored in a platform-independent format. - -The @file{.gcno} file is generated when the source file is compiled with -the GCC @option{-ftest-coverage} option. It contains information to +file suffix with either @file{.gcno}, or @file{.gcda}. The files +contain coverage and profile data stored in a platform-independent format. +The @file{.gcno} files are placed in the same directory as the object +file. By default, the @file{.gcda} files are also stored in the same +directory as the object file, but the GCC @option{-profile-dir} option +may be used to store the @file{.gcda} files in a separate directory. + +The @file{.gcno} notes file is generated when the source file is compiled +with the GCC @option{-ftest-coverage} option. It contains information to reconstruct the basic block graphs and assign source line numbers to blocks. -The @file{.gcda} file is generated when a program containing object files -built with the GCC @option{-fprofile-arcs} option is executed. A -separate @file{.gcda} file is created for each object file compiled with -this option. It contains arc transition counts, and some summary -information. +The @file{.gcda} count data file is generated when a program containing +object files built with the GCC @option{-fprofile-arcs} option is executed. +A separate @file{.gcda} file is created for each object file compiled with +this option. It contains arc transition counts, value profile counts, and +some summary information. The full details of the file format is specified in @file{gcov-io.h}, and functions provided in that header file should be used to access the |