xref: /linux/tools/perf/util/build-id.h (revision f9bff0e31881d03badf191d3b0005839391f5f2b)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef PERF_BUILD_ID_H_
3 #define PERF_BUILD_ID_H_ 1
4 
5 #define BUILD_ID_SIZE	20 /* SHA-1 length in bytes */
6 #define BUILD_ID_MIN_SIZE	16 /* MD5/UUID/GUID length in bytes */
7 #define SBUILD_ID_SIZE	(BUILD_ID_SIZE * 2 + 1)
8 #define SBUILD_ID_MIN_SIZE	(BUILD_ID_MIN_SIZE * 2 + 1)
9 
10 #include "machine.h"
11 #include "tool.h"
12 #include <linux/types.h>
13 
14 struct build_id {
15 	u8	data[BUILD_ID_SIZE];
16 	size_t	size;
17 };
18 
19 struct nsinfo;
20 
21 extern struct perf_tool build_id__mark_dso_hit_ops;
22 struct dso;
23 struct feat_fd;
24 
25 void build_id__init(struct build_id *bid, const u8 *data, size_t size);
26 int build_id__sprintf(const struct build_id *build_id, char *bf);
27 bool build_id__is_defined(const struct build_id *bid);
28 int sysfs__sprintf_build_id(const char *root_dir, char *sbuild_id);
29 int filename__sprintf_build_id(const char *pathname, char *sbuild_id);
30 char *build_id_cache__kallsyms_path(const char *sbuild_id, char *bf,
31 				    size_t size);
32 
33 char *dso__build_id_filename(const struct dso *dso, char *bf, size_t size,
34 			     bool is_debug);
35 char *__dso__build_id_filename(const struct dso *dso, char *bf, size_t size,
36 			       bool is_debug, bool is_kallsyms);
37 
38 int build_id__mark_dso_hit(struct perf_tool *tool, union perf_event *event,
39 			   struct perf_sample *sample, struct evsel *evsel,
40 			   struct machine *machine);
41 
42 int dsos__hit_all(struct perf_session *session);
43 
44 int perf_event__inject_buildid(struct perf_tool *tool, union perf_event *event,
45 			       struct perf_sample *sample, struct evsel *evsel,
46 			       struct machine *machine);
47 
48 bool perf_session__read_build_ids(struct perf_session *session, bool with_hits);
49 int perf_session__write_buildid_table(struct perf_session *session,
50 				      struct feat_fd *fd);
51 int perf_session__cache_build_ids(struct perf_session *session);
52 int __perf_session__cache_build_ids(struct perf_session *session,
53 				    machine__dso_t fn, void *priv);
54 
55 char *build_id_cache__origname(const char *sbuild_id);
56 char *build_id_cache__linkname(const char *sbuild_id, char *bf, size_t size);
57 char *build_id_cache__cachedir(const char *sbuild_id, const char *name,
58 			       struct nsinfo *nsi, bool is_kallsyms,
59 			       bool is_vdso);
60 
61 struct strlist;
62 
63 struct strlist *build_id_cache__list_all(bool validonly);
64 char *build_id_cache__complement(const char *incomplete_sbuild_id);
65 int build_id_cache__list_build_ids(const char *pathname, struct nsinfo *nsi,
66 				   struct strlist **result);
67 bool build_id_cache__cached(const char *sbuild_id);
68 int build_id_cache__add(const char *sbuild_id, const char *name, const char *realname,
69 			struct nsinfo *nsi, bool is_kallsyms, bool is_vdso,
70 			const char *proper_name, const char *root_dir);
71 int __build_id_cache__add_s(const char *sbuild_id,
72 			    const char *name, struct nsinfo *nsi,
73 			    bool is_kallsyms, bool is_vdso,
74 			    const char *proper_name, const char *root_dir);
75 static inline int build_id_cache__add_s(const char *sbuild_id,
76 					const char *name, struct nsinfo *nsi,
77 					bool is_kallsyms, bool is_vdso)
78 {
79 	return __build_id_cache__add_s(sbuild_id, name, nsi, is_kallsyms, is_vdso, NULL, NULL);
80 }
81 int build_id_cache__remove_s(const char *sbuild_id);
82 
83 extern char buildid_dir[];
84 
85 void set_buildid_dir(const char *dir);
86 void disable_buildid_cache(void);
87 
88 #endif
89