tools/lib/perf/include/internal/cpumap.h

Source file repositories/reference/linux-study-clean/tools/lib/perf/include/internal/cpumap.h

File Facts

System
Linux kernel
Corpus path
tools/lib/perf/include/internal/cpumap.h
Extension
.h
Size
1190 bytes
Lines
35
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.

Dependency Surface

Detected Declarations

Annotated Snippet

#ifndef __LIBPERF_INTERNAL_CPUMAP_H
#define __LIBPERF_INTERNAL_CPUMAP_H

#include <linux/refcount.h>
#include <perf/cpumap.h>
#include <internal/rc_check.h>

/**
 * A sized, reference counted, sorted array of integers representing CPU
 * numbers. This is commonly used to capture which CPUs a PMU is associated
 * with. The indices into the cpumap are frequently used as they avoid having
 * gaps if CPU numbers were used. For events associated with a pid, rather than
 * a CPU, a single dummy map with an entry of -1 is used.
 */
DECLARE_RC_STRUCT(perf_cpu_map) {
	refcount_t	refcnt;
	/** Length of the map array. */
	unsigned int	nr;
	/** The CPU values. */
	struct perf_cpu	map[];
};

struct perf_cpu_map *perf_cpu_map__alloc(unsigned int nr_cpus);
int perf_cpu_map__idx(const struct perf_cpu_map *cpus, struct perf_cpu cpu);
bool perf_cpu_map__is_subset(const struct perf_cpu_map *a, const struct perf_cpu_map *b);

void perf_cpu_map__set_nr(struct perf_cpu_map *map, unsigned int nr_cpus);

static inline refcount_t *perf_cpu_map__refcnt(struct perf_cpu_map *map)
{
	return &RC_CHK_ACCESS(map)->refcnt;
}
#endif /* __LIBPERF_INTERNAL_CPUMAP_H */

Annotation

Implementation Notes