perf/util/dso.h

103 #define DSO__SWAP(dso, type, val)			\
106 	BUG_ON(dso->needs_swap == DSO_SWAP__UNSET);	\
107 	if (dso->needs_swap == DSO_SWAP__YES) {		\
147 struct dso {
196 	/* dso data file */
228  * @dso: the 'struct dso *' in which symbols are iterated
232 #define dso__for_each_symbol(dso, pos, n)	\
233 	symbols__for_each_entry(&(dso)->symbols, pos, n)
241 static inline void dso__set_loaded(struct dso *dso)
243 	dso->loaded = true;
246 struct dso *dso__new_id(const char *name, struct dso_id *id);
247 struct dso *dso__new(const char *name);
248 void dso__delete(struct dso *dso);
250 int dso__cmp_id(struct dso *a, struct dso *b);
251 void dso__set_short_name(struct dso *dso, const char *name, bool name_allocated);
252 void dso__set_long_name(struct dso *dso, const char *name, bool name_allocated);
254 int dso__name_len(const struct dso *dso);
256 struct dso *dso__get(struct dso *dso);
257 void dso__put(struct dso *dso);
259 static inline void __dso__zput(struct dso **dso)
261 	dso__put(*dso);
262 	*dso = NULL;
265 #define dso__zput(dso) __dso__zput(&dso)
267 bool dso__loaded(const struct dso *dso);
269 static inline bool dso__has_symbols(const struct dso *dso)
271 	return !RB_EMPTY_ROOT(&dso->symbols.rb_root);
274 char *dso__filename_with_chroot(const struct dso *dso, const char *filename);
276 bool dso__sorted_by_name(const struct dso *dso);
277 void dso__set_sorted_by_name(struct dso *dso);
278 void dso__sort_by_name(struct dso *dso);
280 void dso__set_build_id(struct dso *dso, struct build_id *bid);
281 bool dso__build_id_equal(const struct dso *dso, struct build_id *bid);
282 void dso__read_running_kernel_build_id(struct dso *dso,
284 int dso__kernel_module_get_build_id(struct dso *dso, const char *root_dir);
286 char dso__symtab_origin(const struct dso *dso);
287 int dso__read_binary_type_filename(const struct dso *dso, enum dso_binary_type type,
290 bool dso__needs_decompress(struct dso *dso);
291 int dso__decompress_kmodule_fd(struct dso *dso, const char *name);
292 int dso__decompress_kmodule_path(struct dso *dso, const char *name,
312 void dso__set_module_info(struct dso *dso, struct kmod_path *m,
326  * Please refer to the dso.c object code for each function and
328  * dso file descriptor caching.
331  * to speed up the dso data accesses. The idea is to leave the file
332  * descriptor opened ideally for the whole life of the dso object.
337  *   int fd = dso__data_get_fd(dso, machine);
340  *       dso__data_put_fd(dso);
348  *   dso__data_close(dso);
355  * data file descriptor gets closed/unmapped before the dso object
360 int dso__data_get_fd(struct dso *dso, struct machine *machine);
361 void dso__data_put_fd(struct dso *dso);
362 void dso__data_close(struct dso *dso);
364 int dso__data_file_size(struct dso *dso, struct machine *machine);
365 off_t dso__data_size(struct dso *dso, struct machine *machine);
366 ssize_t dso__data_read_offset(struct dso *dso, struct machine *machine,
368 ssize_t dso__data_read_addr(struct dso *dso, struct map *map,
371 bool dso__data_status_seen(struct dso *dso, enum dso_data_status_seen by);
372 ssize_t dso__data_write_cache_offs(struct dso *dso, struct machine *machine,
374 ssize_t dso__data_write_cache_addr(struct dso *dso, struct map *map,
379 struct dso *machine__findnew_kernel(struct machine *machine, const char *name,
382 void dso__reset_find_symbol_cache(struct dso *dso);
384 size_t dso__fprintf_symbols_by_name(struct dso *dso, FILE *fp);
385 size_t dso__fprintf(struct dso *dso, FILE *fp);
387 static inline bool dso__is_vmlinux(const struct dso *dso)
389 	return dso->binary_type == DSO_BINARY_TYPE__VMLINUX ||
390 	       dso->binary_type == DSO_BINARY_TYPE__GUEST_VMLINUX;
393 static inline bool dso__is_kcore(const struct dso *dso)
395 	return dso->binary_type == DSO_BINARY_TYPE__KCORE ||
396 	       dso->binary_type == DSO_BINARY_TYPE__GUEST_KCORE;
399 static inline bool dso__is_kallsyms(const struct dso *dso)
401 	return dso->kernel && dso->long_name[0] != '/';
404 bool dso__is_object_file(const struct dso *dso);
406 void dso__free_a2l(struct dso *dso);
408 enum dso_type dso__type(struct dso *dso, struct machine *machine);
410 int dso__strerror_load(struct dso *dso, char *buf, size_t buflen);