1 // SPDX-License-Identifier: GPL-2.0
3 * This code provides functions to handle gcc's profiling data format
4 * introduced with gcc 4.7.
6 * This file is based heavily on gcc_3_4.c file.
8 * For a better understanding, refer to gcc source:
12 * Uses gcc-internal data definitions.
15 #include <linux/errno.h>
16 #include <linux/slab.h>
17 #include <linux/string.h>
18 #include <linux/seq_file.h>
19 #include <linux/vmalloc.h>
23 #define GCOV_COUNTERS 8
25 #define GCOV_COUNTERS 9
26 #elif (__GNUC__ > 5) || (__GNUC__ == 5 && __GNUC_MINOR__ >= 1)
27 #define GCOV_COUNTERS 10
29 #define GCOV_COUNTERS 9
32 #define GCOV_TAG_FUNCTION_LENGTH 3
34 static struct gcov_info
*gcov_info_head
;
37 * struct gcov_ctr_info - information about counters for a single function
38 * @num: number of counter values for this type
39 * @values: array of counter values for this type
41 * This data is generated by gcc during compilation and doesn't change
42 * at run-time with the exception of the values array.
44 struct gcov_ctr_info
{
50 * struct gcov_fn_info - profiling meta data per function
52 * @ident: unique ident of function
53 * @lineno_checksum: function lineo_checksum
54 * @cfg_checksum: function cfg checksum
55 * @ctrs: instrumented counters
57 * This data is generated by gcc during compilation and doesn't change
60 * Information about a single function. This uses the trailing array
61 * idiom. The number of counters is determined from the merge pointer
62 * array in gcov_info. The key is used to detect which of a set of
63 * comdat functions was selected -- it points to the gcov_info object
64 * of the object file containing the selected comdat function.
67 const struct gcov_info
*key
;
69 unsigned int lineno_checksum
;
70 unsigned int cfg_checksum
;
71 struct gcov_ctr_info ctrs
[];
75 * struct gcov_info - profiling data per object file
76 * @version: gcov version magic indicating the gcc version used for compilation
77 * @next: list head for a singly-linked list
78 * @stamp: uniquifying time stamp
79 * @filename: name of the associated gcov data file
80 * @merge: merge functions (null for unused counter type)
81 * @n_functions: number of instrumented functions
82 * @functions: pointer to pointers to function information
84 * This data is generated by gcc during compilation and doesn't change
85 * at run-time with the exception of the next pointer.
89 struct gcov_info
*next
;
92 void (*merge
[GCOV_COUNTERS
])(gcov_type
*, unsigned int);
93 unsigned int n_functions
;
94 struct gcov_fn_info
**functions
;
98 * gcov_info_filename - return info filename
99 * @info: profiling data set
101 const char *gcov_info_filename(struct gcov_info
*info
)
103 return info
->filename
;
107 * gcov_info_version - return info version
108 * @info: profiling data set
110 unsigned int gcov_info_version(struct gcov_info
*info
)
112 return info
->version
;
116 * gcov_info_next - return next profiling data set
117 * @info: profiling data set
119 * Returns next gcov_info following @info or first gcov_info in the chain if
122 struct gcov_info
*gcov_info_next(struct gcov_info
*info
)
125 return gcov_info_head
;
131 * gcov_info_link - link/add profiling data set to the list
132 * @info: profiling data set
134 void gcov_info_link(struct gcov_info
*info
)
136 info
->next
= gcov_info_head
;
137 gcov_info_head
= info
;
141 * gcov_info_unlink - unlink/remove profiling data set from the list
142 * @prev: previous profiling data set
143 * @info: profiling data set
145 void gcov_info_unlink(struct gcov_info
*prev
, struct gcov_info
*info
)
148 prev
->next
= info
->next
;
150 gcov_info_head
= info
->next
;
154 * gcov_info_within_module - check if a profiling data set belongs to a module
155 * @info: profiling data set
158 * Returns true if profiling data belongs module, false otherwise.
160 bool gcov_info_within_module(struct gcov_info
*info
, struct module
*mod
)
162 return within_module((unsigned long)info
, mod
);
165 /* Symbolic links to be created for each profiling data file. */
166 const struct gcov_link gcov_link
[] = {
167 { OBJ_TREE
, "gcno" }, /* Link to .gcno file in $(objtree). */
172 * Determine whether a counter is active. Doesn't change at run-time.
174 static int counter_active(struct gcov_info
*info
, unsigned int type
)
176 return info
->merge
[type
] ? 1 : 0;
179 /* Determine number of active counters. Based on gcc magic. */
180 static unsigned int num_counter_active(struct gcov_info
*info
)
183 unsigned int result
= 0;
185 for (i
= 0; i
< GCOV_COUNTERS
; i
++) {
186 if (counter_active(info
, i
))
193 * gcov_info_reset - reset profiling data to zero
194 * @info: profiling data set
196 void gcov_info_reset(struct gcov_info
*info
)
198 struct gcov_ctr_info
*ci_ptr
;
202 for (fi_idx
= 0; fi_idx
< info
->n_functions
; fi_idx
++) {
203 ci_ptr
= info
->functions
[fi_idx
]->ctrs
;
205 for (ct_idx
= 0; ct_idx
< GCOV_COUNTERS
; ct_idx
++) {
206 if (!counter_active(info
, ct_idx
))
209 memset(ci_ptr
->values
, 0,
210 sizeof(gcov_type
) * ci_ptr
->num
);
217 * gcov_info_is_compatible - check if profiling data can be added
218 * @info1: first profiling data set
219 * @info2: second profiling data set
221 * Returns non-zero if profiling data can be added, zero otherwise.
223 int gcov_info_is_compatible(struct gcov_info
*info1
, struct gcov_info
*info2
)
225 return (info1
->stamp
== info2
->stamp
);
229 * gcov_info_add - add up profiling data
230 * @dst: profiling data set to which data is added
231 * @src: profiling data set which is added
233 * Adds profiling counts of @src to @dst.
235 void gcov_info_add(struct gcov_info
*dst
, struct gcov_info
*src
)
237 struct gcov_ctr_info
*dci_ptr
;
238 struct gcov_ctr_info
*sci_ptr
;
241 unsigned int val_idx
;
243 for (fi_idx
= 0; fi_idx
< src
->n_functions
; fi_idx
++) {
244 dci_ptr
= dst
->functions
[fi_idx
]->ctrs
;
245 sci_ptr
= src
->functions
[fi_idx
]->ctrs
;
247 for (ct_idx
= 0; ct_idx
< GCOV_COUNTERS
; ct_idx
++) {
248 if (!counter_active(src
, ct_idx
))
251 for (val_idx
= 0; val_idx
< sci_ptr
->num
; val_idx
++)
252 dci_ptr
->values
[val_idx
] +=
253 sci_ptr
->values
[val_idx
];
262 * gcov_info_dup - duplicate profiling data set
263 * @info: profiling data set to duplicate
265 * Return newly allocated duplicate on success, %NULL on error.
267 struct gcov_info
*gcov_info_dup(struct gcov_info
*info
)
269 struct gcov_info
*dup
;
270 struct gcov_ctr_info
*dci_ptr
; /* dst counter info */
271 struct gcov_ctr_info
*sci_ptr
; /* src counter info */
273 unsigned int fi_idx
; /* function info idx */
274 unsigned int ct_idx
; /* counter type idx */
275 size_t fi_size
; /* function info size */
276 size_t cv_size
; /* counter values size */
278 dup
= kmemdup(info
, sizeof(*dup
), GFP_KERNEL
);
283 dup
->filename
= NULL
;
284 dup
->functions
= NULL
;
286 dup
->filename
= kstrdup(info
->filename
, GFP_KERNEL
);
290 dup
->functions
= kcalloc(info
->n_functions
,
291 sizeof(struct gcov_fn_info
*), GFP_KERNEL
);
295 active
= num_counter_active(info
);
296 fi_size
= sizeof(struct gcov_fn_info
);
297 fi_size
+= sizeof(struct gcov_ctr_info
) * active
;
299 for (fi_idx
= 0; fi_idx
< info
->n_functions
; fi_idx
++) {
300 dup
->functions
[fi_idx
] = kzalloc(fi_size
, GFP_KERNEL
);
301 if (!dup
->functions
[fi_idx
])
304 *(dup
->functions
[fi_idx
]) = *(info
->functions
[fi_idx
]);
306 sci_ptr
= info
->functions
[fi_idx
]->ctrs
;
307 dci_ptr
= dup
->functions
[fi_idx
]->ctrs
;
309 for (ct_idx
= 0; ct_idx
< active
; ct_idx
++) {
311 cv_size
= sizeof(gcov_type
) * sci_ptr
->num
;
313 dci_ptr
->values
= vmalloc(cv_size
);
315 if (!dci_ptr
->values
)
318 dci_ptr
->num
= sci_ptr
->num
;
319 memcpy(dci_ptr
->values
, sci_ptr
->values
, cv_size
);
333 * gcov_info_free - release memory for profiling data set duplicate
334 * @info: profiling data set duplicate to free
336 void gcov_info_free(struct gcov_info
*info
)
341 struct gcov_ctr_info
*ci_ptr
;
343 if (!info
->functions
)
346 active
= num_counter_active(info
);
348 for (fi_idx
= 0; fi_idx
< info
->n_functions
; fi_idx
++) {
349 if (!info
->functions
[fi_idx
])
352 ci_ptr
= info
->functions
[fi_idx
]->ctrs
;
354 for (ct_idx
= 0; ct_idx
< active
; ct_idx
++, ci_ptr
++)
355 vfree(ci_ptr
->values
);
357 kfree(info
->functions
[fi_idx
]);
361 kfree(info
->functions
);
362 kfree(info
->filename
);
366 #define ITER_STRIDE PAGE_SIZE
369 * struct gcov_iterator - specifies current file position in logical records
370 * @info: associated profiling data
371 * @buffer: buffer containing file data
372 * @size: size of buffer
373 * @pos: current position in file
375 struct gcov_iterator
{
376 struct gcov_info
*info
;
383 * store_gcov_u32 - store 32 bit number in gcov format to buffer
384 * @buffer: target buffer or NULL
385 * @off: offset into the buffer
386 * @v: value to be stored
388 * Number format defined by gcc: numbers are recorded in the 32 bit
389 * unsigned binary form of the endianness of the machine generating the
390 * file. Returns the number of bytes stored. If @buffer is %NULL, doesn't
393 static size_t store_gcov_u32(void *buffer
, size_t off
, u32 v
)
402 return sizeof(*data
);
406 * store_gcov_u64 - store 64 bit number in gcov format to buffer
407 * @buffer: target buffer or NULL
408 * @off: offset into the buffer
409 * @v: value to be stored
411 * Number format defined by gcc: numbers are recorded in the 32 bit
412 * unsigned binary form of the endianness of the machine generating the
413 * file. 64 bit numbers are stored as two 32 bit numbers, the low part
414 * first. Returns the number of bytes stored. If @buffer is %NULL, doesn't store
417 static size_t store_gcov_u64(void *buffer
, size_t off
, u64 v
)
424 data
[0] = (v
& 0xffffffffUL
);
428 return sizeof(*data
) * 2;
432 * convert_to_gcda - convert profiling data set to gcda file format
433 * @buffer: the buffer to store file data or %NULL if no data should be stored
434 * @info: profiling data set to be converted
436 * Returns the number of bytes that were/would have been stored into the buffer.
438 static size_t convert_to_gcda(char *buffer
, struct gcov_info
*info
)
440 struct gcov_fn_info
*fi_ptr
;
441 struct gcov_ctr_info
*ci_ptr
;
448 pos
+= store_gcov_u32(buffer
, pos
, GCOV_DATA_MAGIC
);
449 pos
+= store_gcov_u32(buffer
, pos
, info
->version
);
450 pos
+= store_gcov_u32(buffer
, pos
, info
->stamp
);
452 for (fi_idx
= 0; fi_idx
< info
->n_functions
; fi_idx
++) {
453 fi_ptr
= info
->functions
[fi_idx
];
455 /* Function record. */
456 pos
+= store_gcov_u32(buffer
, pos
, GCOV_TAG_FUNCTION
);
457 pos
+= store_gcov_u32(buffer
, pos
, GCOV_TAG_FUNCTION_LENGTH
);
458 pos
+= store_gcov_u32(buffer
, pos
, fi_ptr
->ident
);
459 pos
+= store_gcov_u32(buffer
, pos
, fi_ptr
->lineno_checksum
);
460 pos
+= store_gcov_u32(buffer
, pos
, fi_ptr
->cfg_checksum
);
462 ci_ptr
= fi_ptr
->ctrs
;
464 for (ct_idx
= 0; ct_idx
< GCOV_COUNTERS
; ct_idx
++) {
465 if (!counter_active(info
, ct_idx
))
468 /* Counter record. */
469 pos
+= store_gcov_u32(buffer
, pos
,
470 GCOV_TAG_FOR_COUNTER(ct_idx
));
471 pos
+= store_gcov_u32(buffer
, pos
, ci_ptr
->num
* 2);
473 for (cv_idx
= 0; cv_idx
< ci_ptr
->num
; cv_idx
++) {
474 pos
+= store_gcov_u64(buffer
, pos
,
475 ci_ptr
->values
[cv_idx
]);
486 * gcov_iter_new - allocate and initialize profiling data iterator
487 * @info: profiling data set to be iterated
489 * Return file iterator on success, %NULL otherwise.
491 struct gcov_iterator
*gcov_iter_new(struct gcov_info
*info
)
493 struct gcov_iterator
*iter
;
495 iter
= kzalloc(sizeof(struct gcov_iterator
), GFP_KERNEL
);
500 /* Dry-run to get the actual buffer size. */
501 iter
->size
= convert_to_gcda(NULL
, info
);
502 iter
->buffer
= vmalloc(iter
->size
);
506 convert_to_gcda(iter
->buffer
, info
);
517 * gcov_iter_get_info - return profiling data set for given file iterator
518 * @iter: file iterator
520 void gcov_iter_free(struct gcov_iterator
*iter
)
527 * gcov_iter_get_info - return profiling data set for given file iterator
528 * @iter: file iterator
530 struct gcov_info
*gcov_iter_get_info(struct gcov_iterator
*iter
)
536 * gcov_iter_start - reset file iterator to starting position
537 * @iter: file iterator
539 void gcov_iter_start(struct gcov_iterator
*iter
)
545 * gcov_iter_next - advance file iterator to next logical record
546 * @iter: file iterator
548 * Return zero if new position is valid, non-zero if iterator has reached end.
550 int gcov_iter_next(struct gcov_iterator
*iter
)
552 if (iter
->pos
< iter
->size
)
553 iter
->pos
+= ITER_STRIDE
;
555 if (iter
->pos
>= iter
->size
)
562 * gcov_iter_write - write data for current pos to seq_file
563 * @iter: file iterator
564 * @seq: seq_file handle
566 * Return zero on success, non-zero otherwise.
568 int gcov_iter_write(struct gcov_iterator
*iter
, struct seq_file
*seq
)
572 if (iter
->pos
>= iter
->size
)
576 if (iter
->pos
+ len
> iter
->size
)
577 len
= iter
->size
- iter
->pos
;
579 seq_write(seq
, iter
->buffer
+ iter
->pos
, len
);