163 lines · c
1/* SPDX-License-Identifier: GPL-2.0 */2#ifndef __PERF_CPUMAP_H3#define __PERF_CPUMAP_H4 5#include <stdbool.h>6#include <stdio.h>7#include <perf/cpumap.h>8 9/** Identify where counts are aggregated, -1 implies not to aggregate. */10struct aggr_cpu_id {11 /** A value in the range 0 to number of threads. */12 int thread_idx;13 /** The numa node X as read from /sys/devices/system/node/nodeX. */14 int node;15 /**16 * The socket number as read from17 * /sys/devices/system/cpu/cpuX/topology/physical_package_id.18 */19 int socket;20 /** The die id as read from /sys/devices/system/cpu/cpuX/topology/die_id. */21 int die;22 /** The cluster id as read from /sys/devices/system/cpu/cpuX/topology/cluster_id */23 int cluster;24 /** The cache level as read from /sys/devices/system/cpu/cpuX/cache/indexY/level */25 int cache_lvl;26 /**27 * The cache instance ID, which is the first CPU in the28 * /sys/devices/system/cpu/cpuX/cache/indexY/shared_cpu_list29 */30 int cache;31 /** The core id as read from /sys/devices/system/cpu/cpuX/topology/core_id. */32 int core;33 /** CPU aggregation, note there is one CPU for each SMT thread. */34 struct perf_cpu cpu;35};36 37/** A collection of aggr_cpu_id values, the "built" version is sorted and uniqued. */38struct cpu_aggr_map {39 /** Number of valid entries. */40 int nr;41 /** The entries. */42 struct aggr_cpu_id map[];43};44 45#define cpu_aggr_map__for_each_idx(idx, aggr_map) \46 for ((idx) = 0; (idx) < aggr_map->nr; (idx)++)47 48struct perf_record_cpu_map_data;49 50bool perf_record_cpu_map_data__test_bit(int i, const struct perf_record_cpu_map_data *data);51 52struct perf_cpu_map *perf_cpu_map__empty_new(int nr);53 54struct perf_cpu_map *cpu_map__new_data(const struct perf_record_cpu_map_data *data);55size_t cpu_map__snprint(struct perf_cpu_map *map, char *buf, size_t size);56size_t cpu_map__snprint_mask(struct perf_cpu_map *map, char *buf, size_t size);57size_t cpu_map__fprintf(struct perf_cpu_map *map, FILE *fp);58struct perf_cpu_map *cpu_map__online(void); /* thread unsafe */59 60int cpu__setup_cpunode_map(void);61 62int cpu__max_node(void);63struct perf_cpu cpu__max_cpu(void);64struct perf_cpu cpu__max_present_cpu(void);65 66/**67 * cpu_map__is_dummy - Events associated with a pid, rather than a CPU, use a single dummy map with an entry of -1.68 */69static inline bool cpu_map__is_dummy(const struct perf_cpu_map *cpus)70{71 return perf_cpu_map__nr(cpus) == 1 && perf_cpu_map__cpu(cpus, 0).cpu == -1;72}73 74/**75 * cpu__get_node - Returns the numa node X as read from76 * /sys/devices/system/node/nodeX for the given CPU.77 */78int cpu__get_node(struct perf_cpu cpu);79/**80 * cpu__get_socket_id - Returns the socket number as read from81 * /sys/devices/system/cpu/cpuX/topology/physical_package_id for the given CPU.82 */83int cpu__get_socket_id(struct perf_cpu cpu);84/**85 * cpu__get_die_id - Returns the die id as read from86 * /sys/devices/system/cpu/cpuX/topology/die_id for the given CPU.87 */88int cpu__get_die_id(struct perf_cpu cpu);89/**90 * cpu__get_cluster_id - Returns the cluster id as read from91 * /sys/devices/system/cpu/cpuX/topology/cluster_id for the given CPU92 */93int cpu__get_cluster_id(struct perf_cpu cpu);94/**95 * cpu__get_core_id - Returns the core id as read from96 * /sys/devices/system/cpu/cpuX/topology/core_id for the given CPU.97 */98int cpu__get_core_id(struct perf_cpu cpu);99 100/**101 * cpu_aggr_map__empty_new - Create a cpu_aggr_map of size nr with every entry102 * being empty.103 */104struct cpu_aggr_map *cpu_aggr_map__empty_new(int nr);105 106typedef struct aggr_cpu_id (*aggr_cpu_id_get_t)(struct perf_cpu cpu, void *data);107 108/**109 * cpu_aggr_map__new - Create a cpu_aggr_map with an aggr_cpu_id for each cpu in110 * cpus. The aggr_cpu_id is created with 'get_id' that may have a data value111 * passed to it. The cpu_aggr_map is sorted with duplicate values removed.112 */113struct cpu_aggr_map *cpu_aggr_map__new(const struct perf_cpu_map *cpus,114 aggr_cpu_id_get_t get_id,115 void *data, bool needs_sort);116 117bool aggr_cpu_id__equal(const struct aggr_cpu_id *a, const struct aggr_cpu_id *b);118bool aggr_cpu_id__is_empty(const struct aggr_cpu_id *a);119struct aggr_cpu_id aggr_cpu_id__empty(void);120 121 122/**123 * aggr_cpu_id__socket - Create an aggr_cpu_id with the socket populated with124 * the socket for cpu. The function signature is compatible with125 * aggr_cpu_id_get_t.126 */127struct aggr_cpu_id aggr_cpu_id__socket(struct perf_cpu cpu, void *data);128/**129 * aggr_cpu_id__die - Create an aggr_cpu_id with the die and socket populated130 * with the die and socket for cpu. The function signature is compatible with131 * aggr_cpu_id_get_t.132 */133struct aggr_cpu_id aggr_cpu_id__die(struct perf_cpu cpu, void *data);134/**135 * aggr_cpu_id__cluster - Create an aggr_cpu_id with cluster, die and socket136 * populated with the cluster, die and socket for cpu. The function signature137 * is compatible with aggr_cpu_id_get_t.138 */139struct aggr_cpu_id aggr_cpu_id__cluster(struct perf_cpu cpu, void *data);140/**141 * aggr_cpu_id__core - Create an aggr_cpu_id with the core, cluster, die and142 * socket populated with the core, die and socket for cpu. The function143 * signature is compatible with aggr_cpu_id_get_t.144 */145struct aggr_cpu_id aggr_cpu_id__core(struct perf_cpu cpu, void *data);146/**147 * aggr_cpu_id__core - Create an aggr_cpu_id with the cpu, core, die and socket148 * populated with the cpu, core, die and socket for cpu. The function signature149 * is compatible with aggr_cpu_id_get_t.150 */151struct aggr_cpu_id aggr_cpu_id__cpu(struct perf_cpu cpu, void *data);152/**153 * aggr_cpu_id__node - Create an aggr_cpu_id with the numa node populated for154 * cpu. The function signature is compatible with aggr_cpu_id_get_t.155 */156struct aggr_cpu_id aggr_cpu_id__node(struct perf_cpu cpu, void *data);157/**158 * aggr_cpu_id__global - Create an aggr_cpu_id for global aggregation.159 * The function signature is compatible with aggr_cpu_id_get_t.160 */161struct aggr_cpu_id aggr_cpu_id__global(struct perf_cpu cpu, void *data);162#endif /* __PERF_CPUMAP_H */163