tools/perf/util/dsos.h

File Facts

System

Linux kernel

Corpus path

tools/perf/util/dsos.h

Extension

.h

Size

1401 bytes

Lines

53

Domain

Support Tooling And Documentation

Bucket

tools

Inferred role

Support Tooling And Documentation: implementation source

Status

source implementation candidate

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

• Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• stdbool.h
• stdio.h
• linux/list.h
• linux/rbtree.h
• rwsem.h

Detected Declarations

• struct dso
• struct dso_id
• struct kmod_path
• struct machine
• struct dsos

Annotated Snippet

struct dsos {
	struct rw_semaphore lock;
	struct dso **dsos;
	unsigned int cnt;
	unsigned int allocated;
	bool sorted;
};

void dsos__init(struct dsos *dsos);
void dsos__exit(struct dsos *dsos);

int __dsos__add(struct dsos *dsos, struct dso *dso);
int dsos__add(struct dsos *dsos, struct dso *dso);
struct dso *dsos__find(struct dsos *dsos, const char *name, bool cmp_short);

struct dso *dsos__findnew_id(struct dsos *dsos, const char *name, const struct dso_id *id);
 
bool dsos__read_build_ids(struct dsos *dsos, bool with_hits);

size_t dsos__fprintf_buildid(struct dsos *dsos, FILE *fp,
			       bool (skip)(struct dso *dso, int parm), int parm);
size_t dsos__fprintf(struct dsos *dsos, FILE *fp);

int dsos__hit_all(struct dsos *dsos);

struct dso *dsos__findnew_module_dso(struct dsos *dsos, struct machine *machine,
				     struct kmod_path *m, const char *filename);

struct dso *dsos__find_kernel_dso(struct dsos *dsos);

int dsos__for_each_dso(struct dsos *dsos, int (*cb)(struct dso *dso, void *data), void *data);

#endif /* __PERF_DSOS */

Annotation

• Immediate include surface: `stdbool.h`, `stdio.h`, `linux/list.h`, `linux/rbtree.h`, `rwsem.h`.
• Detected declarations: `struct dso`, `struct dso_id`, `struct kmod_path`, `struct machine`, `struct dsos`.
• Atlas domain: Support Tooling And Documentation / tools.
• Implementation status: source implementation candidate.

Implementation Notes

• This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
• Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
• Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.