]>
Commit | Line | Data |
---|---|---|
4977bab6 | 1 | /* File format for coverage information |
ca29da43 | 2 | Copyright (C) 1996, 1997, 1998, 2000, 2002, |
66647d44 | 3 | 2003, 2004, 2005, 2008, 2009 Free Software Foundation, Inc. |
86144b75 | 4 | Contributed by Bob Manson <manson@cygnus.com>. |
4977bab6 | 5 | Completely remangled by Nathan Sidwell <nathan@codesourcery.com>. |
86144b75 | 6 | |
1322177d | 7 | This file is part of GCC. |
86144b75 | 8 | |
1322177d LB |
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 | |
748086b7 | 11 | Software Foundation; either version 3, or (at your option) any later |
1322177d | 12 | version. |
86144b75 | 13 | |
1322177d LB |
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 | |
17 | for more details. | |
86144b75 | 18 | |
748086b7 JJ |
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. | |
22 | ||
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/>. */ | |
27 | ||
77c915d8 | 28 | |
160e2e4f | 29 | /* Coverage information is held in two files. A notes file, which is |
00cf2913 NS |
30 | generated by the compiler, and a data file, which is generated by |
31 | the program under test. Both files use a similar structure. We do | |
32 | not attempt to make these files backwards compatible with previous | |
33 | versions, as you only need coverage information when developing a | |
34 | program. We do hold version information, so that mismatches can be | |
35 | detected, and we use a format that allows tools to skip information | |
36 | they do not understand or are not interested in. | |
160e2e4f NS |
37 | |
38 | Numbers are recorded in the 32 bit unsigned binary form of the | |
39 | endianness of the machine generating the file. 64 bit numbers are | |
40 | stored as two 32 bit numbers, the low part first. Strings are | |
330d2e2a NS |
41 | padded with 1 to 4 NUL bytes, to bring the length up to a multiple |
42 | of 4. The number of 4 bytes is stored, followed by the padded | |
00cf2913 NS |
43 | string. Zero length and NULL strings are simply stored as a length |
44 | of zero (they have no trailing NUL or padding). | |
160e2e4f NS |
45 | |
46 | int32: byte3 byte2 byte1 byte0 | byte0 byte1 byte2 byte3 | |
47 | int64: int32:low int32:high | |
4977bab6 ZW |
48 | string: int32:0 | int32:length char* char:0 padding |
49 | padding: | char:0 | char:0 char:0 | char:0 char:0 char:0 | |
50 | item: int32 | int64 | string | |
51 | ||
52 | The basic format of the files is | |
53 | ||
dd486eb2 | 54 | file : int32:magic int32:version int32:stamp record* |
4977bab6 | 55 | |
160e2e4f NS |
56 | The magic ident is different for the notes and the data files. The |
57 | magic ident is used to determine the endianness of the file, when | |
58 | reading. The version is the same for both files and is derived | |
59 | from gcc's version number. The stamp value is used to synchronize | |
60 | note and data files and to synchronize merging within a data | |
61 | file. It need not be an absolute time stamp, merely a ticker that | |
62 | increments fast enough and cycles slow enough to distinguish | |
63 | different compile/run/compile cycles. | |
b8698a0f | 64 | |
160e2e4f NS |
65 | Although the ident and version are formally 32 bit numbers, they |
66 | are derived from 4 character ASCII strings. The version number | |
67 | consists of the single character major version number, a two | |
68 | character minor version number (leading zero for versions less than | |
69 | 10), and a single character indicating the status of the release. | |
70 | That will be 'e' experimental, 'p' prerelease and 'r' for release. | |
71 | Because, by good fortune, these are in alphabetical order, string | |
72 | collating can be used to compare version strings. Be aware that | |
73 | the 'e' designation will (naturally) be unstable and might be | |
4977bab6 | 74 | incompatible with itself. For gcc 3.4 experimental, it would be |
160e2e4f NS |
75 | '304e' (0x33303465). When the major version reaches 10, the |
76 | letters A-Z will be used. Assuming minor increments releases every | |
77 | 6 months, we have to make a major increment every 50 years. | |
78 | Assuming major increments releases every 5 years, we're ok for the | |
79 | next 155 years -- good enough for me. | |
4977bab6 ZW |
80 | |
81 | A record has a tag, length and variable amount of data. | |
82 | ||
83 | record: header data | |
84 | header: int32:tag int32:length | |
85 | data: item* | |
86 | ||
87 | Records are not nested, but there is a record hierarchy. Tag | |
160e2e4f NS |
88 | numbers reflect this hierarchy. Tags are unique across note and |
89 | data files. Some record types have a varying amount of data. The | |
330d2e2a NS |
90 | LENGTH is the number of 4bytes that follow and is usually used to |
91 | determine how much data. The tag value is split into 4 8-bit | |
92 | fields, one for each of four possible levels. The most significant | |
93 | is allocated first. Unused levels are zero. Active levels are | |
94 | odd-valued, so that the LSB of the level is one. A sub-level | |
95 | incorporates the values of its superlevels. This formatting allows | |
96 | you to determine the tag hierarchy, without understanding the tags | |
97 | themselves, and is similar to the standard section numbering used | |
98 | in technical documents. Level values [1..3f] are used for common | |
99 | tags, values [41..9f] for the notes file and [a1..ff] for the data | |
100 | file. | |
4977bab6 | 101 | |
efbb59b2 | 102 | The notes file contains the following records |
160e2e4f | 103 | note: unit function-graph* |
796621e8 | 104 | unit: header int32:checksum string:source |
4977bab6 | 105 | function-graph: announce_function basic_blocks {arcs | lines}* |
10adac51 XDL |
106 | announce_function: header int32:ident |
107 | int32:lineno_checksum int32:cfg_checksum | |
796621e8 | 108 | string:name string:source int32:lineno |
4977bab6 ZW |
109 | basic_block: header int32:flags* |
110 | arcs: header int32:block_no arc* | |
111 | arc: int32:dest_block int32:flags | |
112 | lines: header int32:block_no line* | |
113 | int32:0 string:NULL | |
114 | line: int32:line_no | int32:0 string:filename | |
115 | ||
116 | The BASIC_BLOCK record holds per-bb flags. The number of blocks | |
117 | can be inferred from its data length. There is one ARCS record per | |
118 | basic block. The number of arcs from a bb is implicit from the | |
119 | data length. It enumerates the destination bb and per-arc flags. | |
120 | There is one LINES record per basic block, it enumerates the source | |
121 | lines which belong to that basic block. Source file names are | |
122 | introduced by a line number of 0, following lines are from the new | |
123 | source file. The initial source file for the function is NULL, but | |
124 | the current source file should be remembered from one LINES record | |
125 | to the next. The end of a block is indicated by an empty filename | |
126 | - this does not reset the current source file. Note there is no | |
127 | ordering of the ARCS and LINES records: they may be in any order, | |
128 | interleaved in any manner. The current filename follows the order | |
129 | the LINES records are stored in the file, *not* the ordering of the | |
130 | blocks they are for. | |
131 | ||
132 | The data file contains the following records. | |
5366b186 | 133 | data: {unit summary:object summary:program* function-data*}* |
796621e8 | 134 | unit: header int32:checksum |
5366b186 | 135 | function-data: announce_function present counts |
10adac51 XDL |
136 | announce_function: header int32:ident |
137 | int32:lineno_checksum int32:cfg_checksum | |
5366b186 NS |
138 | present: header int32:present |
139 | counts: header int64:count* | |
140 | summary: int32:checksum {count-summary}GCOV_COUNTERS_SUMMABLE | |
cdb23767 NS |
141 | count-summary: int32:num int32:runs int64:sum |
142 | int64:max int64:sum_max | |
4977bab6 | 143 | |
160e2e4f | 144 | The ANNOUNCE_FUNCTION record is the same as that in the note file, |
5366b186 NS |
145 | but without the source location. The COUNTS gives the |
146 | counter values for instrumented features. The about the whole | |
160e2e4f NS |
147 | program. The checksum is used for whole program summaries, and |
148 | disambiguates different programs which include the same | |
149 | instrumented object file. There may be several program summaries, | |
5366b186 NS |
150 | each with a unique checksum. The object summary's checksum is |
151 | zero. Note that the data file might contain information from | |
152 | several runs concatenated, or the data might be merged. | |
4977bab6 ZW |
153 | |
154 | This file is included by both the compiler, gcov tools and the | |
546d2adb | 155 | runtime support library libgcov. IN_LIBGCOV and IN_GCOV are used to |
6356f892 KH |
156 | distinguish which case is which. If IN_LIBGCOV is nonzero, |
157 | libgcov is being built. If IN_GCOV is nonzero, the gcov tools are | |
546d2adb NS |
158 | being built. Otherwise the compiler is being built. IN_GCOV may be |
159 | positive or negative. If positive, we are compiling a tool that | |
160 | requires additional functions (see the code for knowledge of what | |
161 | those functions are). */ | |
4977bab6 | 162 | |
88657302 RH |
163 | #ifndef GCC_GCOV_IO_H |
164 | #define GCC_GCOV_IO_H | |
86144b75 | 165 | |
546d2adb | 166 | #if IN_LIBGCOV |
9b514d25 NS |
167 | /* About the target */ |
168 | ||
fc45d351 | 169 | #if BITS_PER_UNIT == 8 |
9b514d25 NS |
170 | typedef unsigned gcov_unsigned_t __attribute__ ((mode (SI))); |
171 | typedef unsigned gcov_position_t __attribute__ ((mode (SI))); | |
172 | #if LONG_LONG_TYPE_SIZE > 32 | |
173 | typedef signed gcov_type __attribute__ ((mode (DI))); | |
4977bab6 | 174 | #else |
9b514d25 | 175 | typedef signed gcov_type __attribute__ ((mode (SI))); |
4977bab6 | 176 | #endif |
fc45d351 HB |
177 | #else |
178 | #if BITS_PER_UNIT == 16 | |
179 | typedef unsigned gcov_unsigned_t __attribute__ ((mode (HI))); | |
180 | typedef unsigned gcov_position_t __attribute__ ((mode (HI))); | |
181 | #if LONG_LONG_TYPE_SIZE > 32 | |
182 | typedef signed gcov_type __attribute__ ((mode (SI))); | |
183 | #else | |
184 | typedef signed gcov_type __attribute__ ((mode (HI))); | |
185 | #endif | |
186 | #else | |
187 | typedef unsigned gcov_unsigned_t __attribute__ ((mode (QI))); | |
188 | typedef unsigned gcov_position_t __attribute__ ((mode (QI))); | |
189 | #if LONG_LONG_TYPE_SIZE > 32 | |
190 | typedef signed gcov_type __attribute__ ((mode (HI))); | |
191 | #else | |
192 | typedef signed gcov_type __attribute__ ((mode (QI))); | |
193 | #endif | |
194 | #endif | |
195 | #endif | |
196 | ||
9b514d25 | 197 | |
4969c0d8 | 198 | #if defined (TARGET_POSIX_IO) |
cdb23767 NS |
199 | #define GCOV_LOCKED 1 |
200 | #else | |
201 | #define GCOV_LOCKED 0 | |
202 | #endif | |
9b514d25 | 203 | |
474f141e | 204 | #else /* !IN_LIBGCOV */ |
9b514d25 NS |
205 | /* About the host */ |
206 | ||
207 | typedef unsigned gcov_unsigned_t; | |
208 | typedef unsigned gcov_position_t; | |
209 | /* gcov_type is typedef'd elsewhere for the compiler */ | |
546d2adb | 210 | #if IN_GCOV |
474f141e | 211 | #define GCOV_LINKAGE static |
546d2adb NS |
212 | typedef HOST_WIDEST_INT gcov_type; |
213 | #if IN_GCOV > 0 | |
214 | #include <sys/types.h> | |
215 | #endif | |
9b514d25 | 216 | #else /*!IN_GCOV */ |
251e2ff2 | 217 | #define GCOV_TYPE_SIZE (LONG_LONG_TYPE_SIZE > 32 ? 64 : 32) |
546d2adb | 218 | #endif |
9b514d25 NS |
219 | |
220 | #if defined (HOST_HAS_F_SETLKW) | |
221 | #define GCOV_LOCKED 1 | |
222 | #else | |
223 | #define GCOV_LOCKED 0 | |
224 | #endif | |
225 | ||
474f141e | 226 | #endif /* !IN_LIBGCOV */ |
4977bab6 | 227 | |
cbbf9403 JJ |
228 | /* In gcov we want function linkage to be static. In the compiler we want |
229 | it extern, so that they can be accessed from elsewhere. In libgcov we | |
230 | need these functions to be extern, so prefix them with __gcov. In | |
231 | libgcov they must also be hidden so that the instance in the executable | |
232 | is not also used in a DSO. */ | |
09780dfb | 233 | #if IN_LIBGCOV |
cbbf9403 | 234 | |
232b67d9 | 235 | #include "tconfig.h" |
cbbf9403 | 236 | |
09780dfb ZD |
237 | #define gcov_var __gcov_var |
238 | #define gcov_open __gcov_open | |
239 | #define gcov_close __gcov_close | |
7d63a2fa NS |
240 | #define gcov_write_tag_length __gcov_write_tag_length |
241 | #define gcov_position __gcov_position | |
242 | #define gcov_seek __gcov_seek | |
243 | #define gcov_rewrite __gcov_rewrite | |
244 | #define gcov_is_error __gcov_is_error | |
09780dfb ZD |
245 | #define gcov_write_unsigned __gcov_write_unsigned |
246 | #define gcov_write_counter __gcov_write_counter | |
09780dfb | 247 | #define gcov_write_summary __gcov_write_summary |
09780dfb ZD |
248 | #define gcov_read_unsigned __gcov_read_unsigned |
249 | #define gcov_read_counter __gcov_read_counter | |
09780dfb | 250 | #define gcov_read_summary __gcov_read_summary |
7d63a2fa | 251 | |
71c0e7fc | 252 | /* Poison these, so they don't accidentally slip in. */ |
7d63a2fa | 253 | #pragma GCC poison gcov_write_string gcov_write_tag gcov_write_length |
160e2e4f | 254 | #pragma GCC poison gcov_read_string gcov_sync gcov_time gcov_magic |
7d63a2fa | 255 | |
cbbf9403 JJ |
256 | #ifdef HAVE_GAS_HIDDEN |
257 | #define ATTRIBUTE_HIDDEN __attribute__ ((__visibility__ ("hidden"))) | |
258 | #else | |
259 | #define ATTRIBUTE_HIDDEN | |
260 | #endif | |
261 | ||
262 | #else | |
263 | ||
264 | #define ATTRIBUTE_HIDDEN | |
265 | ||
474f141e | 266 | #endif |
09780dfb | 267 | |
ca29da43 NS |
268 | #ifndef GCOV_LINKAGE |
269 | #define GCOV_LINKAGE extern | |
270 | #endif | |
09780dfb | 271 | |
4977bab6 | 272 | /* File suffixes. */ |
160e2e4f NS |
273 | #define GCOV_DATA_SUFFIX ".gcda" |
274 | #define GCOV_NOTE_SUFFIX ".gcno" | |
4977bab6 | 275 | |
160e2e4f NS |
276 | /* File magic. Must not be palindromes. */ |
277 | #define GCOV_DATA_MAGIC ((gcov_unsigned_t)0x67636461) /* "gcda" */ | |
278 | #define GCOV_NOTE_MAGIC ((gcov_unsigned_t)0x67636e6f) /* "gcno" */ | |
4977bab6 ZW |
279 | |
280 | /* gcov-iov.h is automatically generated by the makefile from | |
281 | version.c, it looks like | |
160e2e4f | 282 | #define GCOV_VERSION ((gcov_unsigned_t)0x89abcdef) |
4977bab6 ZW |
283 | */ |
284 | #include "gcov-iov.h" | |
285 | ||
330d2e2a NS |
286 | /* Convert a magic or version number to a 4 character string. */ |
287 | #define GCOV_UNSIGNED2STRING(ARRAY,VALUE) \ | |
288 | ((ARRAY)[0] = (char)((VALUE) >> 24), \ | |
289 | (ARRAY)[1] = (char)((VALUE) >> 16), \ | |
290 | (ARRAY)[2] = (char)((VALUE) >> 8), \ | |
291 | (ARRAY)[3] = (char)((VALUE) >> 0)) | |
292 | ||
4977bab6 | 293 | /* The record tags. Values [1..3f] are for tags which may be in either |
160e2e4f | 294 | file. Values [41..9f] for those in the note file and [a1..ff] for |
00cf2913 NS |
295 | the data file. The tag value zero is used as an explicit end of |
296 | file marker -- it is not required to be present. */ | |
4977bab6 | 297 | |
7d63a2fa | 298 | #define GCOV_TAG_FUNCTION ((gcov_unsigned_t)0x01000000) |
10adac51 | 299 | #define GCOV_TAG_FUNCTION_LENGTH (3) |
7d63a2fa | 300 | #define GCOV_TAG_BLOCKS ((gcov_unsigned_t)0x01410000) |
330d2e2a NS |
301 | #define GCOV_TAG_BLOCKS_LENGTH(NUM) (NUM) |
302 | #define GCOV_TAG_BLOCKS_NUM(LENGTH) (LENGTH) | |
7d63a2fa | 303 | #define GCOV_TAG_ARCS ((gcov_unsigned_t)0x01430000) |
330d2e2a NS |
304 | #define GCOV_TAG_ARCS_LENGTH(NUM) (1 + (NUM) * 2) |
305 | #define GCOV_TAG_ARCS_NUM(LENGTH) (((LENGTH) - 1) / 2) | |
7d63a2fa NS |
306 | #define GCOV_TAG_LINES ((gcov_unsigned_t)0x01450000) |
307 | #define GCOV_TAG_COUNTER_BASE ((gcov_unsigned_t)0x01a10000) | |
330d2e2a NS |
308 | #define GCOV_TAG_COUNTER_LENGTH(NUM) ((NUM) * 2) |
309 | #define GCOV_TAG_COUNTER_NUM(LENGTH) ((LENGTH) / 2) | |
5366b186 | 310 | #define GCOV_TAG_OBJECT_SUMMARY ((gcov_unsigned_t)0xa1000000) /* Obsolete */ |
7d63a2fa NS |
311 | #define GCOV_TAG_PROGRAM_SUMMARY ((gcov_unsigned_t)0xa3000000) |
312 | #define GCOV_TAG_SUMMARY_LENGTH \ | |
330d2e2a | 313 | (1 + GCOV_COUNTERS_SUMMABLE * (2 + 3 * 2)) |
cdb23767 NS |
314 | |
315 | /* Counters that are collected. */ | |
316 | #define GCOV_COUNTER_ARCS 0 /* Arc transitions. */ | |
9b514d25 | 317 | #define GCOV_COUNTERS_SUMMABLE 1 /* Counters which can be |
71c0e7fc | 318 | summaried. */ |
6e885ee3 ZD |
319 | #define GCOV_FIRST_VALUE_COUNTER 1 /* The first of counters used for value |
320 | profiling. They must form a consecutive | |
321 | interval and their order must match | |
322 | the order of HIST_TYPEs in | |
323 | value-prof.h. */ | |
af166e5d ZD |
324 | #define GCOV_COUNTER_V_INTERVAL 1 /* Histogram of value inside an interval. */ |
325 | #define GCOV_COUNTER_V_POW2 2 /* Histogram of exact power2 logarithm | |
326 | of a value. */ | |
327 | #define GCOV_COUNTER_V_SINGLE 3 /* The most common value of expression. */ | |
328 | #define GCOV_COUNTER_V_DELTA 4 /* The most common difference between | |
329 | consecutive values of expression. */ | |
6bad2617 TB |
330 | |
331 | #define GCOV_COUNTER_V_INDIR 5 /* The most common indirect address */ | |
3855c807 JH |
332 | #define GCOV_COUNTER_AVERAGE 6 /* Compute average value passed to the |
333 | counter. */ | |
334 | #define GCOV_COUNTER_IOR 7 /* IOR of the all values passed to | |
335 | counter. */ | |
079a182e | 336 | #define GCOV_LAST_VALUE_COUNTER 7 /* The last of counters used for value |
6e885ee3 | 337 | profiling. */ |
079a182e | 338 | #define GCOV_COUNTERS 8 |
6e885ee3 ZD |
339 | |
340 | /* Number of counters used for value profiling. */ | |
341 | #define GCOV_N_VALUE_COUNTERS \ | |
342 | (GCOV_LAST_VALUE_COUNTER - GCOV_FIRST_VALUE_COUNTER + 1) | |
b8698a0f | 343 | |
af166e5d | 344 | /* A list of human readable names of the counters */ |
079a182e | 345 | #define GCOV_COUNTER_NAMES {"arcs", "interval", "pow2", "single", \ |
5366b186 | 346 | "delta", "indirect_call", "average", "ior"} |
b8698a0f | 347 | |
af166e5d ZD |
348 | /* Names of merge functions for counters. */ |
349 | #define GCOV_MERGE_FUNCTIONS {"__gcov_merge_add", \ | |
350 | "__gcov_merge_add", \ | |
351 | "__gcov_merge_add", \ | |
352 | "__gcov_merge_single", \ | |
6bad2617 | 353 | "__gcov_merge_delta", \ |
079a182e JH |
354 | "__gcov_merge_single", \ |
355 | "__gcov_merge_add", \ | |
356 | "__gcov_merge_ior"} | |
b8698a0f | 357 | |
71c0e7fc | 358 | /* Convert a counter index to a tag. */ |
cdb23767 | 359 | #define GCOV_TAG_FOR_COUNTER(COUNT) \ |
7d63a2fa | 360 | (GCOV_TAG_COUNTER_BASE + ((gcov_unsigned_t)(COUNT) << 17)) |
cdb23767 NS |
361 | /* Convert a tag to a counter. */ |
362 | #define GCOV_COUNTER_FOR_TAG(TAG) \ | |
7d63a2fa | 363 | ((unsigned)(((TAG) - GCOV_TAG_COUNTER_BASE) >> 17)) |
cdb23767 NS |
364 | /* Check whether a tag is a counter tag. */ |
365 | #define GCOV_TAG_IS_COUNTER(TAG) \ | |
366 | (!((TAG) & 0xFFFF) && GCOV_COUNTER_FOR_TAG (TAG) < GCOV_COUNTERS) | |
4977bab6 ZW |
367 | |
368 | /* The tag level mask has 1's in the position of the inner levels, & | |
369 | the lsb of the current level, and zero on the current and outer | |
370 | levels. */ | |
371 | #define GCOV_TAG_MASK(TAG) (((TAG) - 1) ^ (TAG)) | |
372 | ||
373 | /* Return nonzero if SUB is an immediate subtag of TAG. */ | |
374 | #define GCOV_TAG_IS_SUBTAG(TAG,SUB) \ | |
375 | (GCOV_TAG_MASK (TAG) >> 8 == GCOV_TAG_MASK (SUB) \ | |
376 | && !(((SUB) ^ (TAG)) & ~GCOV_TAG_MASK(TAG))) | |
377 | ||
378 | /* Return nonzero if SUB is at a sublevel to TAG. */ | |
379 | #define GCOV_TAG_IS_SUBLEVEL(TAG,SUB) \ | |
380 | (GCOV_TAG_MASK (TAG) > GCOV_TAG_MASK (SUB)) | |
381 | ||
382 | /* Basic block flags. */ | |
27283c73 | 383 | #define GCOV_BLOCK_UNEXPECTED (1 << 1) |
4977bab6 ZW |
384 | |
385 | /* Arc flags. */ | |
386 | #define GCOV_ARC_ON_TREE (1 << 0) | |
387 | #define GCOV_ARC_FAKE (1 << 1) | |
388 | #define GCOV_ARC_FALLTHROUGH (1 << 2) | |
389 | ||
390 | /* Structured records. */ | |
391 | ||
f9da5064 | 392 | /* Cumulative counter data. */ |
cdb23767 NS |
393 | struct gcov_ctr_summary |
394 | { | |
9b514d25 NS |
395 | gcov_unsigned_t num; /* number of counters. */ |
396 | gcov_unsigned_t runs; /* number of program runs */ | |
71c0e7fc | 397 | gcov_type sum_all; /* sum of all counters accumulated. */ |
9b514d25 | 398 | gcov_type run_max; /* maximum value on a single run. */ |
71c0e7fc | 399 | gcov_type sum_max; /* sum of individual run max values. */ |
cdb23767 NS |
400 | }; |
401 | ||
4977bab6 ZW |
402 | /* Object & program summary record. */ |
403 | struct gcov_summary | |
86144b75 | 404 | { |
9b514d25 NS |
405 | gcov_unsigned_t checksum; /* checksum of program */ |
406 | struct gcov_ctr_summary ctrs[GCOV_COUNTERS_SUMMABLE]; | |
4977bab6 ZW |
407 | }; |
408 | ||
4977bab6 ZW |
409 | /* Structures embedded in coveraged program. The structures generated |
410 | by write_profile must match these. */ | |
411 | ||
546d2adb | 412 | #if IN_LIBGCOV |
5366b186 NS |
413 | /* Information about counters for a single function. */ |
414 | struct gcov_ctr_info | |
415 | { | |
416 | gcov_unsigned_t num; /* number of counters. */ | |
417 | gcov_type *values; /* their values. */ | |
418 | }; | |
419 | ||
cdb23767 | 420 | /* Information about a single function. This uses the trailing array |
5366b186 NS |
421 | idiom. The number of counters is determined from the merge pointer |
422 | array in gcov_info. The key is used to detect which of a set of | |
423 | comdat functions was selected -- it points to the gcov_info object | |
424 | of the object file containing the selected comdat function. */ | |
10adac51 | 425 | |
cdb23767 | 426 | struct gcov_fn_info |
cb9e4555 | 427 | { |
5366b186 NS |
428 | const struct gcov_info *key; /* comdat key */ |
429 | gcov_unsigned_t ident; /* unique ident of function */ | |
10adac51 | 430 | gcov_unsigned_t lineno_checksum; /* function lineo_checksum */ |
5366b186 NS |
431 | gcov_unsigned_t cfg_checksum; /* function cfg checksum */ |
432 | struct gcov_ctr_info ctrs[0]; /* instrumented counters */ | |
cb9e4555 ZD |
433 | }; |
434 | ||
09780dfb | 435 | /* Type of function used to merge counters. */ |
9b514d25 | 436 | typedef void (*gcov_merge_fn) (gcov_type *, gcov_unsigned_t); |
09780dfb | 437 | |
4977bab6 ZW |
438 | /* Information about a single object file. */ |
439 | struct gcov_info | |
86144b75 | 440 | { |
9b514d25 | 441 | gcov_unsigned_t version; /* expected version number */ |
160e2e4f | 442 | struct gcov_info *next; /* link to next, used by libgcov */ |
4977bab6 | 443 | |
dd486eb2 | 444 | gcov_unsigned_t stamp; /* uniquifying time stamp */ |
4977bab6 | 445 | const char *filename; /* output file name */ |
b8698a0f | 446 | |
5366b186 NS |
447 | gcov_merge_fn merge[GCOV_COUNTERS]; /* merge functions (null for |
448 | unused) */ | |
449 | ||
9b514d25 | 450 | unsigned n_functions; /* number of functions */ |
b724567e NS |
451 | const struct gcov_fn_info *const *functions; /* pointer to pointers |
452 | to function information */ | |
4977bab6 ZW |
453 | }; |
454 | ||
455 | /* Register a new object file module. */ | |
cbbf9403 | 456 | extern void __gcov_init (struct gcov_info *) ATTRIBUTE_HIDDEN; |
4977bab6 ZW |
457 | |
458 | /* Called before fork, to avoid double counting. */ | |
cbbf9403 | 459 | extern void __gcov_flush (void) ATTRIBUTE_HIDDEN; |
4977bab6 | 460 | |
4e8ee9cb TJ |
461 | /* Function to reset all counters to 0. */ |
462 | extern void __gcov_reset (void); | |
463 | ||
464 | /* Function to enable early write of profile information so far. */ | |
465 | extern void __gcov_dump (void); | |
466 | ||
09780dfb | 467 | /* The merge function that just sums the counters. */ |
cbbf9403 | 468 | extern void __gcov_merge_add (gcov_type *, unsigned) ATTRIBUTE_HIDDEN; |
af166e5d | 469 | |
160e2e4f | 470 | /* The merge function to choose the most common value. */ |
cbbf9403 | 471 | extern void __gcov_merge_single (gcov_type *, unsigned) ATTRIBUTE_HIDDEN; |
af166e5d | 472 | |
160e2e4f NS |
473 | /* The merge function to choose the most common difference between |
474 | consecutive values. */ | |
cbbf9403 | 475 | extern void __gcov_merge_delta (gcov_type *, unsigned) ATTRIBUTE_HIDDEN; |
d1c38823 | 476 | |
52f1c7ed MM |
477 | /* The merge function that just ors the counters together. */ |
478 | extern void __gcov_merge_ior (gcov_type *, unsigned) ATTRIBUTE_HIDDEN; | |
479 | ||
9885da8e | 480 | /* The profiler functions. */ |
b8698a0f | 481 | extern void __gcov_interval_profiler (gcov_type *, gcov_type, int, unsigned); |
9885da8e ZD |
482 | extern void __gcov_pow2_profiler (gcov_type *, gcov_type); |
483 | extern void __gcov_one_value_profiler (gcov_type *, gcov_type); | |
098b68ad BE |
484 | extern void __gcov_indirect_call_profiler (gcov_type *, gcov_type, void *, void *); |
485 | extern void __gcov_average_profiler (gcov_type *, gcov_type); | |
486 | extern void __gcov_ior_profiler (gcov_type *, gcov_type); | |
9885da8e | 487 | |
060c5f00 | 488 | #ifndef inhibit_libc |
d1c38823 | 489 | /* The wrappers around some library functions.. */ |
52f1c7ed | 490 | extern pid_t __gcov_fork (void) ATTRIBUTE_HIDDEN; |
cbb8dee3 BE |
491 | extern int __gcov_execl (const char *, char *, ...) ATTRIBUTE_HIDDEN; |
492 | extern int __gcov_execlp (const char *, char *, ...) ATTRIBUTE_HIDDEN; | |
493 | extern int __gcov_execle (const char *, char *, ...) ATTRIBUTE_HIDDEN; | |
cbbf9403 JJ |
494 | extern int __gcov_execv (const char *, char *const []) ATTRIBUTE_HIDDEN; |
495 | extern int __gcov_execvp (const char *, char *const []) ATTRIBUTE_HIDDEN; | |
496 | extern int __gcov_execve (const char *, char *const [], char *const []) | |
497 | ATTRIBUTE_HIDDEN; | |
060c5f00 | 498 | #endif |
d1c38823 | 499 | |
546d2adb NS |
500 | #endif /* IN_LIBGCOV */ |
501 | ||
474f141e NS |
502 | #if IN_LIBGCOV >= 0 |
503 | ||
330d2e2a NS |
504 | /* Optimum number of gcov_unsigned_t's read from or written to disk. */ |
505 | #define GCOV_BLOCK_SIZE (1 << 10) | |
546d2adb | 506 | |
ca29da43 | 507 | GCOV_LINKAGE struct gcov_var |
94de45d9 NS |
508 | { |
509 | FILE *file; | |
7d63a2fa | 510 | gcov_position_t start; /* Position of first byte of block */ |
71c0e7fc KH |
511 | unsigned offset; /* Read/write position within the block. */ |
512 | unsigned length; /* Read limit in the block. */ | |
330d2e2a | 513 | unsigned overread; /* Number of words overread. */ |
7d63a2fa NS |
514 | int error; /* < 0 overflow, > 0 disk error. */ |
515 | int mode; /* < 0 writing, > 0 reading */ | |
516 | #if IN_LIBGCOV | |
517 | /* Holds one block plus 4 bytes, thus all coverage reads & writes | |
518 | fit within this buffer and we always can transfer GCOV_BLOCK_SIZE | |
519 | to and from the disk. libgcov never backtracks and only writes 4 | |
520 | or 8 byte objects. */ | |
330d2e2a | 521 | gcov_unsigned_t buffer[GCOV_BLOCK_SIZE + 1]; |
7d63a2fa | 522 | #else |
160e2e4f | 523 | int endian; /* Swap endianness. */ |
7d63a2fa NS |
524 | /* Holds a variable length block, as the compiler can write |
525 | strings and needs to backtrack. */ | |
94de45d9 | 526 | size_t alloc; |
330d2e2a | 527 | gcov_unsigned_t *buffer; |
7d63a2fa | 528 | #endif |
cbbf9403 | 529 | } gcov_var ATTRIBUTE_HIDDEN; |
4977bab6 | 530 | |
160e2e4f NS |
531 | /* Functions for reading and writing gcov files. In libgcov you can |
532 | open the file for reading then writing. Elsewhere you can open the | |
533 | file either for reading or for writing. When reading a file you may | |
534 | use the gcov_read_* functions, gcov_sync, gcov_position, & | |
535 | gcov_error. When writing a file you may use the gcov_write | |
536 | functions, gcov_seek & gcov_error. When a file is to be rewritten | |
537 | you use the functions for reading, then gcov_rewrite then the | |
538 | functions for writing. Your file may become corrupted if you break | |
4ed43216 | 539 | these invariants. */ |
160e2e4f | 540 | #if IN_LIBGCOV |
cbbf9403 | 541 | GCOV_LINKAGE int gcov_open (const char */*name*/) ATTRIBUTE_HIDDEN; |
160e2e4f NS |
542 | #else |
543 | GCOV_LINKAGE int gcov_open (const char */*name*/, int /*direction*/); | |
544 | GCOV_LINKAGE int gcov_magic (gcov_unsigned_t, gcov_unsigned_t); | |
545 | #endif | |
cbbf9403 | 546 | GCOV_LINKAGE int gcov_close (void) ATTRIBUTE_HIDDEN; |
7d63a2fa NS |
547 | |
548 | /* Available everywhere. */ | |
549 | static gcov_position_t gcov_position (void); | |
550 | static int gcov_is_error (void); | |
7d63a2fa | 551 | |
cbbf9403 JJ |
552 | GCOV_LINKAGE gcov_unsigned_t gcov_read_unsigned (void) ATTRIBUTE_HIDDEN; |
553 | GCOV_LINKAGE gcov_type gcov_read_counter (void) ATTRIBUTE_HIDDEN; | |
554 | GCOV_LINKAGE void gcov_read_summary (struct gcov_summary *) ATTRIBUTE_HIDDEN; | |
7d63a2fa | 555 | |
546d2adb | 556 | #if IN_LIBGCOV |
7d63a2fa | 557 | /* Available only in libgcov */ |
cbbf9403 JJ |
558 | GCOV_LINKAGE void gcov_write_counter (gcov_type) ATTRIBUTE_HIDDEN; |
559 | GCOV_LINKAGE void gcov_write_tag_length (gcov_unsigned_t, gcov_unsigned_t) | |
560 | ATTRIBUTE_HIDDEN; | |
9b514d25 | 561 | GCOV_LINKAGE void gcov_write_summary (gcov_unsigned_t /*tag*/, |
cbbf9403 JJ |
562 | const struct gcov_summary *) |
563 | ATTRIBUTE_HIDDEN; | |
7d63a2fa | 564 | static void gcov_rewrite (void); |
cbbf9403 | 565 | GCOV_LINKAGE void gcov_seek (gcov_position_t /*position*/) ATTRIBUTE_HIDDEN; |
7d63a2fa NS |
566 | #else |
567 | /* Available outside libgcov */ | |
ca29da43 | 568 | GCOV_LINKAGE const char *gcov_read_string (void); |
7d63a2fa NS |
569 | GCOV_LINKAGE void gcov_sync (gcov_position_t /*base*/, |
570 | gcov_unsigned_t /*length */); | |
796621e8 | 571 | #endif |
7d63a2fa NS |
572 | |
573 | #if !IN_GCOV | |
574 | /* Available outside gcov */ | |
cbbf9403 | 575 | GCOV_LINKAGE void gcov_write_unsigned (gcov_unsigned_t) ATTRIBUTE_HIDDEN; |
7d63a2fa NS |
576 | #endif |
577 | ||
578 | #if !IN_GCOV && !IN_LIBGCOV | |
579 | /* Available only in compiler */ | |
580 | GCOV_LINKAGE void gcov_write_string (const char *); | |
581 | GCOV_LINKAGE gcov_position_t gcov_write_tag (gcov_unsigned_t); | |
582 | GCOV_LINKAGE void gcov_write_length (gcov_position_t /*position*/); | |
583 | #endif | |
584 | ||
546d2adb | 585 | #if IN_GCOV > 0 |
7d63a2fa | 586 | /* Available in gcov */ |
ca29da43 | 587 | GCOV_LINKAGE time_t gcov_time (void); |
94de45d9 | 588 | #endif |
b7c9bf28 | 589 | |
546d2adb | 590 | /* Save the current position in the gcov file. */ |
b7c9bf28 | 591 | |
9b514d25 | 592 | static inline gcov_position_t |
94de45d9 | 593 | gcov_position (void) |
ec4a0419 | 594 | { |
cccd217d | 595 | gcc_assert (gcov_var.mode > 0); |
7d63a2fa | 596 | return gcov_var.start + gcov_var.offset; |
ec4a0419 ZD |
597 | } |
598 | ||
6356f892 | 599 | /* Return nonzero if the error flag is set. */ |
ec4a0419 | 600 | |
7d63a2fa | 601 | static inline int |
82a30d6f | 602 | gcov_is_error (void) |
ec4a0419 | 603 | { |
7d63a2fa | 604 | return gcov_var.file ? gcov_var.error : 1; |
474f141e NS |
605 | } |
606 | ||
7d63a2fa | 607 | #if IN_LIBGCOV |
e0bb17a8 | 608 | /* Move to beginning of file and initialize for writing. */ |
474f141e NS |
609 | |
610 | static inline void | |
611 | gcov_rewrite (void) | |
612 | { | |
cccd217d | 613 | gcc_assert (gcov_var.mode > 0); |
7d63a2fa NS |
614 | gcov_var.mode = -1; |
615 | gcov_var.start = 0; | |
616 | gcov_var.offset = 0; | |
617 | fseek (gcov_var.file, 0L, SEEK_SET); | |
ec4a0419 | 618 | } |
7d63a2fa | 619 | #endif |
ec4a0419 | 620 | |
474f141e NS |
621 | #endif /* IN_LIBGCOV >= 0 */ |
622 | ||
4977bab6 | 623 | #endif /* GCC_GCOV_IO_H */ |