2 * This code exports profiling data as debugfs files to userspace.
4 * Copyright IBM Corp. 2009
5 * Author(s): Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
7 * Uses gcc-internal data definitions.
8 * Based on the gcov-kernel patch by:
9 * Hubertus Franke <frankeh@us.ibm.com>
10 * Nigel Hinds <nhinds@us.ibm.com>
11 * Rajan Ravindran <rajancr@us.ibm.com>
12 * Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
17 #define pr_fmt(fmt) "gcov: " fmt
19 #include <linux/init.h>
20 #include <linux/module.h>
21 #include <linux/debugfs.h>
23 #include <linux/list.h>
24 #include <linux/string.h>
25 #include <linux/slab.h>
26 #include <linux/mutex.h>
27 #include <linux/seq_file.h>
31 * struct gcov_node - represents a debugfs entry
32 * @list: list head for child node list
33 * @children: child nodes
34 * @all: list head for list of all nodes
35 * @parent: parent node
36 * @loaded_info: array of pointers to profiling data sets for loaded object
38 * @num_loaded: number of profiling data sets for loaded object files.
39 * @unloaded_info: accumulated copy of profiling data sets for unloaded
40 * object files. Used only when gcov_persist=1.
41 * @dentry: main debugfs entry, either a directory or data file
42 * @links: associated symbolic links
43 * @name: data file basename
45 * struct gcov_node represents an entity within the gcov/ subdirectory
46 * of debugfs. There are directory and data file nodes. The latter represent
47 * the actual synthesized data file plus any associated symbolic links which
48 * are needed by the gcov tool to work correctly.
51 struct list_head list
;
52 struct list_head children
;
54 struct gcov_node
*parent
;
55 struct gcov_info
**loaded_info
;
56 struct gcov_info
*unloaded_info
;
57 struct dentry
*dentry
;
58 struct dentry
**links
;
63 static const char objtree
[] = OBJTREE
;
64 static const char srctree
[] = SRCTREE
;
65 static struct gcov_node root_node
;
66 static struct dentry
*reset_dentry
;
67 static LIST_HEAD(all_head
);
68 static DEFINE_MUTEX(node_lock
);
70 /* If non-zero, keep copies of profiling data for unloaded modules. */
71 static int gcov_persist
= 1;
73 static int __init
gcov_persist_setup(char *str
)
77 if (strict_strtoul(str
, 0, &val
)) {
78 pr_warning("invalid gcov_persist parameter '%s'\n", str
);
82 pr_info("setting gcov_persist to %d\n", gcov_persist
);
86 __setup("gcov_persist=", gcov_persist_setup
);
89 * seq_file.start() implementation for gcov data files. Note that the
90 * gcov_iterator interface is designed to be more restrictive than seq_file
91 * (no start from arbitrary position, etc.), to simplify the iterator
94 static void *gcov_seq_start(struct seq_file
*seq
, loff_t
*pos
)
98 gcov_iter_start(seq
->private);
99 for (i
= 0; i
< *pos
; i
++) {
100 if (gcov_iter_next(seq
->private))
106 /* seq_file.next() implementation for gcov data files. */
107 static void *gcov_seq_next(struct seq_file
*seq
, void *data
, loff_t
*pos
)
109 struct gcov_iterator
*iter
= data
;
111 if (gcov_iter_next(iter
))
118 /* seq_file.show() implementation for gcov data files. */
119 static int gcov_seq_show(struct seq_file
*seq
, void *data
)
121 struct gcov_iterator
*iter
= data
;
123 if (gcov_iter_write(iter
, seq
))
128 static void gcov_seq_stop(struct seq_file
*seq
, void *data
)
133 static const struct seq_operations gcov_seq_ops
= {
134 .start
= gcov_seq_start
,
135 .next
= gcov_seq_next
,
136 .show
= gcov_seq_show
,
137 .stop
= gcov_seq_stop
,
141 * Return a profiling data set associated with the given node. This is
142 * either a data set for a loaded object file or a data set copy in case
143 * all associated object files have been unloaded.
145 static struct gcov_info
*get_node_info(struct gcov_node
*node
)
147 if (node
->num_loaded
> 0)
148 return node
->loaded_info
[0];
150 return node
->unloaded_info
;
154 * Return a newly allocated profiling data set which contains the sum of
155 * all profiling data associated with the given node.
157 static struct gcov_info
*get_accumulated_info(struct gcov_node
*node
)
159 struct gcov_info
*info
;
162 if (node
->unloaded_info
)
163 info
= gcov_info_dup(node
->unloaded_info
);
165 info
= gcov_info_dup(node
->loaded_info
[i
++]);
168 for (; i
< node
->num_loaded
; i
++)
169 gcov_info_add(info
, node
->loaded_info
[i
]);
175 * open() implementation for gcov data files. Create a copy of the profiling
176 * data set and initialize the iterator and seq_file interface.
178 static int gcov_seq_open(struct inode
*inode
, struct file
*file
)
180 struct gcov_node
*node
= inode
->i_private
;
181 struct gcov_iterator
*iter
;
182 struct seq_file
*seq
;
183 struct gcov_info
*info
;
186 mutex_lock(&node_lock
);
188 * Read from a profiling data copy to minimize reference tracking
189 * complexity and concurrent access and to keep accumulating multiple
190 * profiling data sets associated with one node simple.
192 info
= get_accumulated_info(node
);
195 iter
= gcov_iter_new(info
);
198 rc
= seq_open(file
, &gcov_seq_ops
);
200 goto err_free_iter_info
;
201 seq
= file
->private_data
;
204 mutex_unlock(&node_lock
);
208 gcov_iter_free(iter
);
210 gcov_info_free(info
);
215 * release() implementation for gcov data files. Release resources allocated
218 static int gcov_seq_release(struct inode
*inode
, struct file
*file
)
220 struct gcov_iterator
*iter
;
221 struct gcov_info
*info
;
222 struct seq_file
*seq
;
224 seq
= file
->private_data
;
226 info
= gcov_iter_get_info(iter
);
227 gcov_iter_free(iter
);
228 gcov_info_free(info
);
229 seq_release(inode
, file
);
235 * Find a node by the associated data file name. Needs to be called with
238 static struct gcov_node
*get_node_by_name(const char *name
)
240 struct gcov_node
*node
;
241 struct gcov_info
*info
;
243 list_for_each_entry(node
, &all_head
, all
) {
244 info
= get_node_info(node
);
245 if (info
&& (strcmp(info
->filename
, name
) == 0))
253 * Reset all profiling data associated with the specified node.
255 static void reset_node(struct gcov_node
*node
)
259 if (node
->unloaded_info
)
260 gcov_info_reset(node
->unloaded_info
);
261 for (i
= 0; i
< node
->num_loaded
; i
++)
262 gcov_info_reset(node
->loaded_info
[i
]);
265 static void remove_node(struct gcov_node
*node
);
268 * write() implementation for gcov data files. Reset profiling data for the
269 * corresponding file. If all associated object files have been unloaded,
270 * remove the debug fs node as well.
272 static ssize_t
gcov_seq_write(struct file
*file
, const char __user
*addr
,
273 size_t len
, loff_t
*pos
)
275 struct seq_file
*seq
;
276 struct gcov_info
*info
;
277 struct gcov_node
*node
;
279 seq
= file
->private_data
;
280 info
= gcov_iter_get_info(seq
->private);
281 mutex_lock(&node_lock
);
282 node
= get_node_by_name(info
->filename
);
284 /* Reset counts or remove node for unloaded modules. */
285 if (node
->num_loaded
== 0)
290 /* Reset counts for open file. */
291 gcov_info_reset(info
);
292 mutex_unlock(&node_lock
);
298 * Given a string <path> representing a file path of format:
300 * construct and return a new string:
301 * <dir/>path/to/file.<ext>
303 static char *link_target(const char *dir
, const char *path
, const char *ext
)
309 copy
= kstrdup(path
, GFP_KERNEL
);
312 old_ext
= strrchr(copy
, '.');
316 target
= kasprintf(GFP_KERNEL
, "%s/%s.%s", dir
, copy
, ext
);
318 target
= kasprintf(GFP_KERNEL
, "%s.%s", copy
, ext
);
325 * Construct a string representing the symbolic link target for the given
326 * gcov data file name and link type. Depending on the link type and the
327 * location of the data file, the link target can either point to a
328 * subdirectory of srctree, objtree or in an external location.
330 static char *get_link_target(const char *filename
, const struct gcov_link
*ext
)
335 if (strncmp(filename
, objtree
, strlen(objtree
)) == 0) {
336 rel
= filename
+ strlen(objtree
) + 1;
337 if (ext
->dir
== SRC_TREE
)
338 result
= link_target(srctree
, rel
, ext
->ext
);
340 result
= link_target(objtree
, rel
, ext
->ext
);
342 /* External compilation. */
343 result
= link_target(NULL
, filename
, ext
->ext
);
349 #define SKEW_PREFIX ".tmp_"
352 * For a filename .tmp_filename.ext return filename.ext. Needed to compensate
353 * for filename skewing caused by the mod-versioning mechanism.
355 static const char *deskew(const char *basename
)
357 if (strncmp(basename
, SKEW_PREFIX
, sizeof(SKEW_PREFIX
) - 1) == 0)
358 return basename
+ sizeof(SKEW_PREFIX
) - 1;
363 * Create links to additional files (usually .c and .gcno files) which the
364 * gcov tool expects to find in the same directory as the gcov data file.
366 static void add_links(struct gcov_node
*node
, struct dentry
*parent
)
373 for (num
= 0; gcov_link
[num
].ext
; num
++)
375 node
->links
= kcalloc(num
, sizeof(struct dentry
*), GFP_KERNEL
);
378 for (i
= 0; i
< num
; i
++) {
379 target
= get_link_target(get_node_info(node
)->filename
,
383 basename
= strrchr(target
, '/');
387 node
->links
[i
] = debugfs_create_symlink(deskew(basename
),
398 debugfs_remove(node
->links
[i
]);
403 static const struct file_operations gcov_data_fops
= {
404 .open
= gcov_seq_open
,
405 .release
= gcov_seq_release
,
408 .write
= gcov_seq_write
,
411 /* Basic initialization of a new node. */
412 static void init_node(struct gcov_node
*node
, struct gcov_info
*info
,
413 const char *name
, struct gcov_node
*parent
)
415 INIT_LIST_HEAD(&node
->list
);
416 INIT_LIST_HEAD(&node
->children
);
417 INIT_LIST_HEAD(&node
->all
);
418 if (node
->loaded_info
) {
419 node
->loaded_info
[0] = info
;
420 node
->num_loaded
= 1;
422 node
->parent
= parent
;
424 strcpy(node
->name
, name
);
428 * Create a new node and associated debugfs entry. Needs to be called with
431 static struct gcov_node
*new_node(struct gcov_node
*parent
,
432 struct gcov_info
*info
, const char *name
)
434 struct gcov_node
*node
;
436 node
= kzalloc(sizeof(struct gcov_node
) + strlen(name
) + 1, GFP_KERNEL
);
440 node
->loaded_info
= kcalloc(1, sizeof(struct gcov_info
*),
442 if (!node
->loaded_info
)
445 init_node(node
, info
, name
, parent
);
446 /* Differentiate between gcov data file nodes and directory nodes. */
448 node
->dentry
= debugfs_create_file(deskew(node
->name
), 0600,
449 parent
->dentry
, node
, &gcov_data_fops
);
451 node
->dentry
= debugfs_create_dir(node
->name
, parent
->dentry
);
453 pr_warning("could not create file\n");
458 add_links(node
, parent
->dentry
);
459 list_add(&node
->list
, &parent
->children
);
460 list_add(&node
->all
, &all_head
);
466 pr_warning("out of memory\n");
470 /* Remove symbolic links associated with node. */
471 static void remove_links(struct gcov_node
*node
)
477 for (i
= 0; gcov_link
[i
].ext
; i
++)
478 debugfs_remove(node
->links
[i
]);
484 * Remove node from all lists and debugfs and release associated resources.
485 * Needs to be called with node_lock held.
487 static void release_node(struct gcov_node
*node
)
489 list_del(&node
->list
);
490 list_del(&node
->all
);
491 debugfs_remove(node
->dentry
);
493 kfree(node
->loaded_info
);
494 if (node
->unloaded_info
)
495 gcov_info_free(node
->unloaded_info
);
499 /* Release node and empty parents. Needs to be called with node_lock held. */
500 static void remove_node(struct gcov_node
*node
)
502 struct gcov_node
*parent
;
504 while ((node
!= &root_node
) && list_empty(&node
->children
)) {
505 parent
= node
->parent
;
512 * Find child node with given basename. Needs to be called with node_lock
515 static struct gcov_node
*get_child_by_name(struct gcov_node
*parent
,
518 struct gcov_node
*node
;
520 list_for_each_entry(node
, &parent
->children
, list
) {
521 if (strcmp(node
->name
, name
) == 0)
529 * write() implementation for reset file. Reset all profiling data to zero
530 * and remove nodes for which all associated object files are unloaded.
532 static ssize_t
reset_write(struct file
*file
, const char __user
*addr
,
533 size_t len
, loff_t
*pos
)
535 struct gcov_node
*node
;
537 mutex_lock(&node_lock
);
539 list_for_each_entry(node
, &all_head
, all
) {
540 if (node
->num_loaded
> 0)
542 else if (list_empty(&node
->children
)) {
544 /* Several nodes may have gone - restart loop. */
548 mutex_unlock(&node_lock
);
553 /* read() implementation for reset file. Unused. */
554 static ssize_t
reset_read(struct file
*file
, char __user
*addr
, size_t len
,
557 /* Allow read operation so that a recursive copy won't fail. */
561 static const struct file_operations gcov_reset_fops
= {
562 .write
= reset_write
,
567 * Create a node for a given profiling data set and add it to all lists and
568 * debugfs. Needs to be called with node_lock held.
570 static void add_node(struct gcov_info
*info
)
575 struct gcov_node
*parent
;
576 struct gcov_node
*node
;
578 filename
= kstrdup(info
->filename
, GFP_KERNEL
);
582 /* Create directory nodes along the path. */
583 for (curr
= filename
; (next
= strchr(curr
, '/')); curr
= next
+ 1) {
587 if (strcmp(curr
, ".") == 0)
589 if (strcmp(curr
, "..") == 0) {
592 parent
= parent
->parent
;
595 node
= get_child_by_name(parent
, curr
);
597 node
= new_node(parent
, NULL
, curr
);
603 /* Create file node. */
604 node
= new_node(parent
, info
, curr
);
617 * Associate a profiling data set with an existing node. Needs to be called
618 * with node_lock held.
620 static void add_info(struct gcov_node
*node
, struct gcov_info
*info
)
622 struct gcov_info
**loaded_info
;
623 int num
= node
->num_loaded
;
626 * Prepare new array. This is done first to simplify cleanup in
627 * case the new data set is incompatible, the node only contains
628 * unloaded data sets and there's not enough memory for the array.
630 loaded_info
= kcalloc(num
+ 1, sizeof(struct gcov_info
*), GFP_KERNEL
);
632 pr_warning("could not add '%s' (out of memory)\n",
636 memcpy(loaded_info
, node
->loaded_info
,
637 num
* sizeof(struct gcov_info
*));
638 loaded_info
[num
] = info
;
639 /* Check if the new data set is compatible. */
642 * A module was unloaded, modified and reloaded. The new
643 * data set replaces the copy of the last one.
645 if (!gcov_info_is_compatible(node
->unloaded_info
, info
)) {
646 pr_warning("discarding saved data for %s "
647 "(incompatible version)\n", info
->filename
);
648 gcov_info_free(node
->unloaded_info
);
649 node
->unloaded_info
= NULL
;
653 * Two different versions of the same object file are loaded.
654 * The initial one takes precedence.
656 if (!gcov_info_is_compatible(node
->loaded_info
[0], info
)) {
657 pr_warning("could not add '%s' (incompatible "
658 "version)\n", info
->filename
);
663 /* Overwrite previous array. */
664 kfree(node
->loaded_info
);
665 node
->loaded_info
= loaded_info
;
666 node
->num_loaded
= num
+ 1;
670 * Return the index of a profiling data set associated with a node.
672 static int get_info_index(struct gcov_node
*node
, struct gcov_info
*info
)
676 for (i
= 0; i
< node
->num_loaded
; i
++) {
677 if (node
->loaded_info
[i
] == info
)
684 * Save the data of a profiling data set which is being unloaded.
686 static void save_info(struct gcov_node
*node
, struct gcov_info
*info
)
688 if (node
->unloaded_info
)
689 gcov_info_add(node
->unloaded_info
, info
);
691 node
->unloaded_info
= gcov_info_dup(info
);
692 if (!node
->unloaded_info
) {
693 pr_warning("could not save data for '%s' "
694 "(out of memory)\n", info
->filename
);
700 * Disassociate a profiling data set from a node. Needs to be called with
703 static void remove_info(struct gcov_node
*node
, struct gcov_info
*info
)
707 i
= get_info_index(node
, info
);
709 pr_warning("could not remove '%s' (not found)\n",
714 save_info(node
, info
);
716 node
->loaded_info
[i
] = node
->loaded_info
[node
->num_loaded
- 1];
718 if (node
->num_loaded
> 0)
720 /* Last loaded data set was removed. */
721 kfree(node
->loaded_info
);
722 node
->loaded_info
= NULL
;
723 node
->num_loaded
= 0;
724 if (!node
->unloaded_info
)
729 * Callback to create/remove profiling files when code compiled with
730 * -fprofile-arcs is loaded/unloaded.
732 void gcov_event(enum gcov_action action
, struct gcov_info
*info
)
734 struct gcov_node
*node
;
736 mutex_lock(&node_lock
);
737 node
= get_node_by_name(info
->filename
);
741 add_info(node
, info
);
747 remove_info(node
, info
);
749 pr_warning("could not remove '%s' (not found)\n",
754 mutex_unlock(&node_lock
);
757 /* Create debugfs entries. */
758 static __init
int gcov_fs_init(void)
762 init_node(&root_node
, NULL
, NULL
, NULL
);
764 * /sys/kernel/debug/gcov will be parent for the reset control file
765 * and all profiling files.
767 root_node
.dentry
= debugfs_create_dir("gcov", NULL
);
768 if (!root_node
.dentry
)
771 * Create reset file which resets all profiling counts when written
774 reset_dentry
= debugfs_create_file("reset", 0600, root_node
.dentry
,
775 NULL
, &gcov_reset_fops
);
778 /* Replay previous events to get our fs hierarchy up-to-date. */
779 gcov_enable_events();
783 pr_err("init failed\n");
784 if (root_node
.dentry
)
785 debugfs_remove(root_node
.dentry
);
789 device_initcall(gcov_fs_init
);