]>
Commit | Line | Data |
---|---|---|
cdd059d7 JO |
1 | #ifndef __PERF_DSO |
2 | #define __PERF_DSO | |
3 | ||
d3a7c489 | 4 | #include <linux/atomic.h> |
cdd059d7 JO |
5 | #include <linux/types.h> |
6 | #include <linux/rbtree.h> | |
39b12f78 | 7 | #include <stdbool.h> |
e8807844 | 8 | #include <pthread.h> |
d944c4ee | 9 | #include <linux/types.h> |
2b5b8bb2 | 10 | #include <linux/bitops.h> |
cdd059d7 | 11 | #include "map.h" |
86c98cab | 12 | #include "build-id.h" |
cdd059d7 JO |
13 | |
14 | enum dso_binary_type { | |
15 | DSO_BINARY_TYPE__KALLSYMS = 0, | |
16 | DSO_BINARY_TYPE__GUEST_KALLSYMS, | |
17 | DSO_BINARY_TYPE__VMLINUX, | |
18 | DSO_BINARY_TYPE__GUEST_VMLINUX, | |
19 | DSO_BINARY_TYPE__JAVA_JIT, | |
20 | DSO_BINARY_TYPE__DEBUGLINK, | |
21 | DSO_BINARY_TYPE__BUILD_ID_CACHE, | |
22 | DSO_BINARY_TYPE__FEDORA_DEBUGINFO, | |
23 | DSO_BINARY_TYPE__UBUNTU_DEBUGINFO, | |
24 | DSO_BINARY_TYPE__BUILDID_DEBUGINFO, | |
25 | DSO_BINARY_TYPE__SYSTEM_PATH_DSO, | |
26 | DSO_BINARY_TYPE__GUEST_KMODULE, | |
c00c48fc | 27 | DSO_BINARY_TYPE__GUEST_KMODULE_COMP, |
cdd059d7 | 28 | DSO_BINARY_TYPE__SYSTEM_PATH_KMODULE, |
c00c48fc | 29 | DSO_BINARY_TYPE__SYSTEM_PATH_KMODULE_COMP, |
8e0cf965 AH |
30 | DSO_BINARY_TYPE__KCORE, |
31 | DSO_BINARY_TYPE__GUEST_KCORE, | |
9cd00941 | 32 | DSO_BINARY_TYPE__OPENEMBEDDED_DEBUGINFO, |
cdd059d7 JO |
33 | DSO_BINARY_TYPE__NOT_FOUND, |
34 | }; | |
35 | ||
36 | enum dso_kernel_type { | |
37 | DSO_TYPE_USER = 0, | |
38 | DSO_TYPE_KERNEL, | |
39 | DSO_TYPE_GUEST_KERNEL | |
40 | }; | |
41 | ||
42 | enum dso_swap_type { | |
43 | DSO_SWAP__UNSET, | |
44 | DSO_SWAP__NO, | |
45 | DSO_SWAP__YES, | |
46 | }; | |
47 | ||
c27697d6 AH |
48 | enum dso_data_status { |
49 | DSO_DATA_STATUS_ERROR = -1, | |
50 | DSO_DATA_STATUS_UNKNOWN = 0, | |
51 | DSO_DATA_STATUS_OK = 1, | |
52 | }; | |
53 | ||
288be943 AH |
54 | enum dso_data_status_seen { |
55 | DSO_DATA_STATUS_SEEN_ITRACE, | |
56 | }; | |
57 | ||
2b5b8bb2 AH |
58 | enum dso_type { |
59 | DSO__TYPE_UNKNOWN, | |
60 | DSO__TYPE_64BIT, | |
61 | DSO__TYPE_32BIT, | |
62 | DSO__TYPE_X32BIT, | |
63 | }; | |
64 | ||
18425f13 ACM |
65 | enum dso_load_errno { |
66 | DSO_LOAD_ERRNO__SUCCESS = 0, | |
67 | ||
68 | /* | |
69 | * Choose an arbitrary negative big number not to clash with standard | |
70 | * errno since SUS requires the errno has distinct positive values. | |
71 | * See 'Issue 6' in the link below. | |
72 | * | |
73 | * http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/errno.h.html | |
74 | */ | |
75 | __DSO_LOAD_ERRNO__START = -10000, | |
76 | ||
77 | DSO_LOAD_ERRNO__INTERNAL_ERROR = __DSO_LOAD_ERRNO__START, | |
78 | ||
79 | /* for symsrc__init() */ | |
80 | DSO_LOAD_ERRNO__INVALID_ELF, | |
81 | DSO_LOAD_ERRNO__CANNOT_READ_BUILDID, | |
82 | DSO_LOAD_ERRNO__MISMATCHING_BUILDID, | |
83 | ||
84 | /* for decompress_kmodule */ | |
85 | DSO_LOAD_ERRNO__DECOMPRESSION_FAILURE, | |
86 | ||
87 | __DSO_LOAD_ERRNO__END, | |
88 | }; | |
89 | ||
cdd059d7 JO |
90 | #define DSO__SWAP(dso, type, val) \ |
91 | ({ \ | |
92 | type ____r = val; \ | |
93 | BUG_ON(dso->needs_swap == DSO_SWAP__UNSET); \ | |
94 | if (dso->needs_swap == DSO_SWAP__YES) { \ | |
95 | switch (sizeof(____r)) { \ | |
96 | case 2: \ | |
97 | ____r = bswap_16(val); \ | |
98 | break; \ | |
99 | case 4: \ | |
100 | ____r = bswap_32(val); \ | |
101 | break; \ | |
102 | case 8: \ | |
103 | ____r = bswap_64(val); \ | |
104 | break; \ | |
105 | default: \ | |
106 | BUG_ON(1); \ | |
107 | } \ | |
108 | } \ | |
109 | ____r; \ | |
110 | }) | |
111 | ||
112 | #define DSO__DATA_CACHE_SIZE 4096 | |
113 | #define DSO__DATA_CACHE_MASK ~(DSO__DATA_CACHE_SIZE - 1) | |
114 | ||
115 | struct dso_cache { | |
116 | struct rb_node rb_node; | |
117 | u64 offset; | |
118 | u64 size; | |
119 | char data[0]; | |
120 | }; | |
121 | ||
8fa7d87f | 122 | /* |
4598a0a6 WL |
123 | * DSOs are put into both a list for fast iteration and rbtree for fast |
124 | * long name lookup. | |
8fa7d87f WL |
125 | */ |
126 | struct dsos { | |
127 | struct list_head head; | |
4598a0a6 | 128 | struct rb_root root; /* rbtree root sorted by long name */ |
e8807844 | 129 | pthread_rwlock_t lock; |
8fa7d87f WL |
130 | }; |
131 | ||
cfe9174f AH |
132 | struct auxtrace_cache; |
133 | ||
cdd059d7 | 134 | struct dso { |
4a936edc | 135 | pthread_mutex_t lock; |
cdd059d7 | 136 | struct list_head node; |
4598a0a6 | 137 | struct rb_node rb_node; /* rbtree node sorted by long name */ |
e266a753 | 138 | struct rb_root *root; /* root of rbtree that rb_node is in */ |
cdd059d7 JO |
139 | struct rb_root symbols[MAP__NR_TYPES]; |
140 | struct rb_root symbol_names[MAP__NR_TYPES]; | |
b685ac22 ACM |
141 | struct { |
142 | u64 addr; | |
143 | struct symbol *symbol; | |
144 | } last_find_result[MAP__NR_TYPES]; | |
454ff00f | 145 | void *a2l; |
0058aef6 | 146 | char *symsrc_filename; |
906049c8 | 147 | unsigned int a2l_fails; |
cdd059d7 JO |
148 | enum dso_kernel_type kernel; |
149 | enum dso_swap_type needs_swap; | |
150 | enum dso_binary_type symtab_type; | |
5f70619d | 151 | enum dso_binary_type binary_type; |
18425f13 | 152 | enum dso_load_errno load_errno; |
cdd059d7 JO |
153 | u8 adjust_symbols:1; |
154 | u8 has_build_id:1; | |
2cc9d0ef | 155 | u8 has_srcline:1; |
cdd059d7 JO |
156 | u8 hit:1; |
157 | u8 annotate_warned:1; | |
c7282f2e ACM |
158 | u8 short_name_allocated:1; |
159 | u8 long_name_allocated:1; | |
c6d8f2a4 | 160 | u8 is_64_bit:1; |
cdd059d7 JO |
161 | u8 sorted_by_name; |
162 | u8 loaded; | |
0131c4ec | 163 | u8 rel; |
cdd059d7 | 164 | u8 build_id[BUILD_ID_SIZE]; |
73cdf0c6 | 165 | u64 text_offset; |
cdd059d7 | 166 | const char *short_name; |
bf4414ae | 167 | const char *long_name; |
cdd059d7 JO |
168 | u16 long_name_len; |
169 | u16 short_name_len; | |
7d073b33 | 170 | void *dwfl; /* DWARF debug info */ |
cfe9174f | 171 | struct auxtrace_cache *auxtrace_cache; |
ca40e2af JO |
172 | |
173 | /* dso data file */ | |
174 | struct { | |
175 | struct rb_root cache; | |
53fa8eaa | 176 | int fd; |
c27697d6 | 177 | int status; |
288be943 | 178 | u32 status_seen; |
c3fbd2a6 | 179 | size_t file_size; |
eba5102d | 180 | struct list_head open_entry; |
303cb89a WN |
181 | u64 debug_frame_offset; |
182 | u64 eh_frame_hdr_offset; | |
ca40e2af JO |
183 | } data; |
184 | ||
0db15b1e AH |
185 | union { /* Tool specific area */ |
186 | void *priv; | |
187 | u64 db_id; | |
188 | }; | |
d3a7c489 | 189 | atomic_t refcnt; |
cdd059d7 JO |
190 | char name[0]; |
191 | }; | |
192 | ||
eb948e50 MH |
193 | /* dso__for_each_symbol - iterate over the symbols of given type |
194 | * | |
195 | * @dso: the 'struct dso *' in which symbols itereated | |
196 | * @pos: the 'struct symbol *' to use as a loop cursor | |
197 | * @n: the 'struct rb_node *' to use as a temporary storage | |
198 | * @type: the 'enum map_type' type of symbols | |
199 | */ | |
200 | #define dso__for_each_symbol(dso, pos, n, type) \ | |
201 | symbols__for_each_entry(&(dso)->symbols[(type)], pos, n) | |
202 | ||
cdd059d7 JO |
203 | static inline void dso__set_loaded(struct dso *dso, enum map_type type) |
204 | { | |
205 | dso->loaded |= (1 << type); | |
206 | } | |
207 | ||
208 | struct dso *dso__new(const char *name); | |
209 | void dso__delete(struct dso *dso); | |
210 | ||
58a98c9c | 211 | void dso__set_short_name(struct dso *dso, const char *name, bool name_allocated); |
bf4414ae | 212 | void dso__set_long_name(struct dso *dso, const char *name, bool name_allocated); |
cdd059d7 JO |
213 | |
214 | int dso__name_len(const struct dso *dso); | |
215 | ||
d3a7c489 ACM |
216 | struct dso *dso__get(struct dso *dso); |
217 | void dso__put(struct dso *dso); | |
218 | ||
219 | static inline void __dso__zput(struct dso **dso) | |
220 | { | |
221 | dso__put(*dso); | |
222 | *dso = NULL; | |
223 | } | |
224 | ||
225 | #define dso__zput(dso) __dso__zput(&dso) | |
226 | ||
cdd059d7 JO |
227 | bool dso__loaded(const struct dso *dso, enum map_type type); |
228 | ||
229 | bool dso__sorted_by_name(const struct dso *dso, enum map_type type); | |
230 | void dso__set_sorted_by_name(struct dso *dso, enum map_type type); | |
231 | void dso__sort_by_name(struct dso *dso, enum map_type type); | |
232 | ||
233 | void dso__set_build_id(struct dso *dso, void *build_id); | |
234 | bool dso__build_id_equal(const struct dso *dso, u8 *build_id); | |
235 | void dso__read_running_kernel_build_id(struct dso *dso, | |
236 | struct machine *machine); | |
237 | int dso__kernel_module_get_build_id(struct dso *dso, const char *root_dir); | |
238 | ||
239 | char dso__symtab_origin(const struct dso *dso); | |
ee4e9625 ACM |
240 | int dso__read_binary_type_filename(const struct dso *dso, enum dso_binary_type type, |
241 | char *root_dir, char *filename, size_t size); | |
c00c48fc | 242 | bool is_supported_compression(const char *ext); |
1f121b03 | 243 | bool is_kernel_module(const char *pathname, int cpumode); |
c00c48fc NK |
244 | bool decompress_to_file(const char *ext, const char *filename, int output_fd); |
245 | bool dso__needs_decompress(struct dso *dso); | |
cdd059d7 | 246 | |
3c8a67f5 JO |
247 | struct kmod_path { |
248 | char *name; | |
249 | char *ext; | |
250 | bool comp; | |
251 | bool kmod; | |
252 | }; | |
253 | ||
254 | int __kmod_path__parse(struct kmod_path *m, const char *path, | |
255 | bool alloc_name, bool alloc_ext); | |
256 | ||
257 | #define kmod_path__parse(__m, __p) __kmod_path__parse(__m, __p, false, false) | |
258 | #define kmod_path__parse_name(__m, __p) __kmod_path__parse(__m, __p, true , false) | |
259 | #define kmod_path__parse_ext(__m, __p) __kmod_path__parse(__m, __p, false, true) | |
260 | ||
c1f9aa0a JO |
261 | /* |
262 | * The dso__data_* external interface provides following functions: | |
4bb11d01 NK |
263 | * dso__data_get_fd |
264 | * dso__data_put_fd | |
c1f9aa0a | 265 | * dso__data_close |
6d363459 | 266 | * dso__data_size |
c1f9aa0a JO |
267 | * dso__data_read_offset |
268 | * dso__data_read_addr | |
269 | * | |
270 | * Please refer to the dso.c object code for each function and | |
271 | * arguments documentation. Following text tries to explain the | |
272 | * dso file descriptor caching. | |
273 | * | |
274 | * The dso__data* interface allows caching of opened file descriptors | |
275 | * to speed up the dso data accesses. The idea is to leave the file | |
276 | * descriptor opened ideally for the whole life of the dso object. | |
277 | * | |
278 | * The current usage of the dso__data_* interface is as follows: | |
279 | * | |
280 | * Get DSO's fd: | |
4bb11d01 NK |
281 | * int fd = dso__data_get_fd(dso, machine); |
282 | * if (fd >= 0) { | |
283 | * USE 'fd' SOMEHOW | |
284 | * dso__data_put_fd(dso); | |
285 | * } | |
c1f9aa0a JO |
286 | * |
287 | * Read DSO's data: | |
288 | * n = dso__data_read_offset(dso_0, &machine, 0, buf, BUFSIZE); | |
289 | * n = dso__data_read_addr(dso_0, &machine, 0, buf, BUFSIZE); | |
290 | * | |
291 | * Eventually close DSO's fd: | |
292 | * dso__data_close(dso); | |
293 | * | |
294 | * It is not necessary to close the DSO object data file. Each time new | |
295 | * DSO data file is opened, the limit (RLIMIT_NOFILE/2) is checked. Once | |
296 | * it is crossed, the oldest opened DSO object is closed. | |
297 | * | |
298 | * The dso__delete function calls close_dso function to ensure the | |
299 | * data file descriptor gets closed/unmapped before the dso object | |
300 | * is freed. | |
301 | * | |
302 | * TODO | |
303 | */ | |
4bb11d01 NK |
304 | int dso__data_get_fd(struct dso *dso, struct machine *machine); |
305 | void dso__data_put_fd(struct dso *dso __maybe_unused); | |
53fa8eaa JO |
306 | void dso__data_close(struct dso *dso); |
307 | ||
6d363459 | 308 | off_t dso__data_size(struct dso *dso, struct machine *machine); |
cdd059d7 JO |
309 | ssize_t dso__data_read_offset(struct dso *dso, struct machine *machine, |
310 | u64 offset, u8 *data, ssize_t size); | |
311 | ssize_t dso__data_read_addr(struct dso *dso, struct map *map, | |
312 | struct machine *machine, u64 addr, | |
313 | u8 *data, ssize_t size); | |
288be943 | 314 | bool dso__data_status_seen(struct dso *dso, enum dso_data_status_seen by); |
cdd059d7 JO |
315 | |
316 | struct map *dso__new_map(const char *name); | |
459ce518 ACM |
317 | struct dso *machine__findnew_kernel(struct machine *machine, const char *name, |
318 | const char *short_name, int dso_type); | |
cdd059d7 | 319 | |
e8807844 | 320 | void __dsos__add(struct dsos *dsos, struct dso *dso); |
8fa7d87f | 321 | void dsos__add(struct dsos *dsos, struct dso *dso); |
e8807844 ACM |
322 | struct dso *__dsos__addnew(struct dsos *dsos, const char *name); |
323 | struct dso *__dsos__find(struct dsos *dsos, const char *name, bool cmp_short); | |
324 | struct dso *dsos__find(struct dsos *dsos, const char *name, bool cmp_short); | |
8fa7d87f | 325 | struct dso *__dsos__findnew(struct dsos *dsos, const char *name); |
e8807844 | 326 | struct dso *dsos__findnew(struct dsos *dsos, const char *name); |
cdd059d7 JO |
327 | bool __dsos__read_build_ids(struct list_head *head, bool with_hits); |
328 | ||
c0b4dffb ACM |
329 | void dso__reset_find_symbol_cache(struct dso *dso); |
330 | ||
cdd059d7 | 331 | size_t __dsos__fprintf_buildid(struct list_head *head, FILE *fp, |
417c2ff6 | 332 | bool (skip)(struct dso *dso, int parm), int parm); |
cdd059d7 JO |
333 | size_t __dsos__fprintf(struct list_head *head, FILE *fp); |
334 | ||
335 | size_t dso__fprintf_buildid(struct dso *dso, FILE *fp); | |
336 | size_t dso__fprintf_symbols_by_name(struct dso *dso, | |
337 | enum map_type type, FILE *fp); | |
338 | size_t dso__fprintf(struct dso *dso, enum map_type type, FILE *fp); | |
39b12f78 AH |
339 | |
340 | static inline bool dso__is_vmlinux(struct dso *dso) | |
341 | { | |
5f70619d ACM |
342 | return dso->binary_type == DSO_BINARY_TYPE__VMLINUX || |
343 | dso->binary_type == DSO_BINARY_TYPE__GUEST_VMLINUX; | |
39b12f78 AH |
344 | } |
345 | ||
8e0cf965 AH |
346 | static inline bool dso__is_kcore(struct dso *dso) |
347 | { | |
5f70619d ACM |
348 | return dso->binary_type == DSO_BINARY_TYPE__KCORE || |
349 | dso->binary_type == DSO_BINARY_TYPE__GUEST_KCORE; | |
8e0cf965 AH |
350 | } |
351 | ||
454ff00f AH |
352 | void dso__free_a2l(struct dso *dso); |
353 | ||
2b5b8bb2 AH |
354 | enum dso_type dso__type(struct dso *dso, struct machine *machine); |
355 | ||
18425f13 ACM |
356 | int dso__strerror_load(struct dso *dso, char *buf, size_t buflen); |
357 | ||
cdd059d7 | 358 | #endif /* __PERF_DSO */ |