1 /* SPDX-License-Identifier: GPL-2.0 */ 2 #ifndef __PERF_CPUMAP_H 3 #define __PERF_CPUMAP_H 4 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. */ 10 struct 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 from 17 * /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 the 28 * /sys/devices/system/cpu/cpuX/cache/indexY/shared_cpu_list 29 */ 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. */ 38 struct 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 48 struct perf_record_cpu_map_data; 49 50 bool perf_record_cpu_map_data__test_bit(int i, const struct perf_record_cpu_map_data *data); 51 52 struct perf_cpu_map *perf_cpu_map__empty_new(int nr); 53 54 struct perf_cpu_map *cpu_map__new_data(const struct perf_record_cpu_map_data *data); 55 size_t cpu_map__snprint(struct perf_cpu_map *map, char *buf, size_t size); 56 size_t cpu_map__snprint_mask(struct perf_cpu_map *map, char *buf, size_t size); 57 size_t cpu_map__fprintf(struct perf_cpu_map *map, FILE *fp); 58 struct perf_cpu_map *cpu_map__online(void); /* thread unsafe */ 59 60 int cpu__setup_cpunode_map(void); 61 62 int cpu__max_node(void); 63 struct perf_cpu cpu__max_cpu(void); 64 struct 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 */ 69 static 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 from 76 * /sys/devices/system/node/nodeX for the given CPU. 77 */ 78 int cpu__get_node(struct perf_cpu cpu); 79 /** 80 * cpu__get_socket_id - Returns the socket number as read from 81 * /sys/devices/system/cpu/cpuX/topology/physical_package_id for the given CPU. 82 */ 83 int cpu__get_socket_id(struct perf_cpu cpu); 84 /** 85 * cpu__get_die_id - Returns the die id as read from 86 * /sys/devices/system/cpu/cpuX/topology/die_id for the given CPU. 87 */ 88 int cpu__get_die_id(struct perf_cpu cpu); 89 /** 90 * cpu__get_cluster_id - Returns the cluster id as read from 91 * /sys/devices/system/cpu/cpuX/topology/cluster_id for the given CPU 92 */ 93 int cpu__get_cluster_id(struct perf_cpu cpu); 94 /** 95 * cpu__get_core_id - Returns the core id as read from 96 * /sys/devices/system/cpu/cpuX/topology/core_id for the given CPU. 97 */ 98 int 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 entry 102 * being empty. 103 */ 104 struct cpu_aggr_map *cpu_aggr_map__empty_new(int nr); 105 106 typedef 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 in 110 * cpus. The aggr_cpu_id is created with 'get_id' that may have a data value 111 * passed to it. The cpu_aggr_map is sorted with duplicate values removed. 112 */ 113 struct 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 117 bool aggr_cpu_id__equal(const struct aggr_cpu_id *a, const struct aggr_cpu_id *b); 118 bool aggr_cpu_id__is_empty(const struct aggr_cpu_id *a); 119 struct 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 with 124 * the socket for cpu. The function signature is compatible with 125 * aggr_cpu_id_get_t. 126 */ 127 struct 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 populated 130 * with the die and socket for cpu. The function signature is compatible with 131 * aggr_cpu_id_get_t. 132 */ 133 struct 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 socket 136 * populated with the cluster, die and socket for cpu. The function signature 137 * is compatible with aggr_cpu_id_get_t. 138 */ 139 struct 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 and 142 * socket populated with the core, die and socket for cpu. The function 143 * signature is compatible with aggr_cpu_id_get_t. 144 */ 145 struct 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 socket 148 * populated with the cpu, core, die and socket for cpu. The function signature 149 * is compatible with aggr_cpu_id_get_t. 150 */ 151 struct 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 for 154 * cpu. The function signature is compatible with aggr_cpu_id_get_t. 155 */ 156 struct 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 */ 161 struct aggr_cpu_id aggr_cpu_id__global(struct perf_cpu cpu, void *data); 162 #endif /* __PERF_CPUMAP_H */ 163