1 /* SPDX-License-Identifier: GPL-2.0 */ 1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __PERF_CPUMAP_H 2 #ifndef __PERF_CPUMAP_H
3 #define __PERF_CPUMAP_H 3 #define __PERF_CPUMAP_H
4 4
5 #include <stdbool.h> 5 #include <stdbool.h>
6 #include <stdio.h> 6 #include <stdio.h>
7 #include <perf/cpumap.h> 7 #include <perf/cpumap.h>
>> 8 #include <linux/refcount.h>
8 9
9 /** Identify where counts are aggregated, -1 i 10 /** Identify where counts are aggregated, -1 implies not to aggregate. */
10 struct aggr_cpu_id { 11 struct aggr_cpu_id {
11 /** A value in the range 0 to number o 12 /** A value in the range 0 to number of threads. */
12 int thread_idx; 13 int thread_idx;
13 /** The numa node X as read from /sys/ 14 /** The numa node X as read from /sys/devices/system/node/nodeX. */
14 int node; 15 int node;
15 /** 16 /**
16 * The socket number as read from 17 * The socket number as read from
17 * /sys/devices/system/cpu/cpuX/topolo 18 * /sys/devices/system/cpu/cpuX/topology/physical_package_id.
18 */ 19 */
19 int socket; 20 int socket;
20 /** The die id as read from /sys/devic 21 /** The die id as read from /sys/devices/system/cpu/cpuX/topology/die_id. */
21 int die; 22 int die;
22 /** The cluster id as read from /sys/d 23 /** The cluster id as read from /sys/devices/system/cpu/cpuX/topology/cluster_id */
23 int cluster; 24 int cluster;
24 /** The cache level as read from /sys/ 25 /** The cache level as read from /sys/devices/system/cpu/cpuX/cache/indexY/level */
25 int cache_lvl; 26 int cache_lvl;
26 /** 27 /**
27 * The cache instance ID, which is the 28 * The cache instance ID, which is the first CPU in the
28 * /sys/devices/system/cpu/cpuX/cache/ 29 * /sys/devices/system/cpu/cpuX/cache/indexY/shared_cpu_list
29 */ 30 */
30 int cache; 31 int cache;
31 /** The core id as read from /sys/devi 32 /** The core id as read from /sys/devices/system/cpu/cpuX/topology/core_id. */
32 int core; 33 int core;
33 /** CPU aggregation, note there is one 34 /** CPU aggregation, note there is one CPU for each SMT thread. */
34 struct perf_cpu cpu; 35 struct perf_cpu cpu;
35 }; 36 };
36 37
37 /** A collection of aggr_cpu_id values, the "b 38 /** A collection of aggr_cpu_id values, the "built" version is sorted and uniqued. */
38 struct cpu_aggr_map { 39 struct cpu_aggr_map {
>> 40 refcount_t refcnt;
39 /** Number of valid entries. */ 41 /** Number of valid entries. */
40 int nr; 42 int nr;
41 /** The entries. */ 43 /** The entries. */
42 struct aggr_cpu_id map[]; 44 struct aggr_cpu_id map[];
43 }; 45 };
44 46
45 #define cpu_aggr_map__for_each_idx(idx, aggr_m 47 #define cpu_aggr_map__for_each_idx(idx, aggr_map) \
46 for ((idx) = 0; (idx) < aggr_map->nr; 48 for ((idx) = 0; (idx) < aggr_map->nr; (idx)++)
47 49
48 struct perf_record_cpu_map_data; 50 struct perf_record_cpu_map_data;
49 51
50 bool perf_record_cpu_map_data__test_bit(int i, 52 bool perf_record_cpu_map_data__test_bit(int i, const struct perf_record_cpu_map_data *data);
51 53
52 struct perf_cpu_map *perf_cpu_map__empty_new(i 54 struct perf_cpu_map *perf_cpu_map__empty_new(int nr);
53 55
54 struct perf_cpu_map *cpu_map__new_data(const s 56 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 *m 57 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_m 58 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 *m 59 size_t cpu_map__fprintf(struct perf_cpu_map *map, FILE *fp);
58 struct perf_cpu_map *cpu_map__online(void); /* 60 struct perf_cpu_map *cpu_map__online(void); /* thread unsafe */
59 61
60 int cpu__setup_cpunode_map(void); 62 int cpu__setup_cpunode_map(void);
61 63
62 int cpu__max_node(void); 64 int cpu__max_node(void);
63 struct perf_cpu cpu__max_cpu(void); 65 struct perf_cpu cpu__max_cpu(void);
64 struct perf_cpu cpu__max_present_cpu(void); 66 struct perf_cpu cpu__max_present_cpu(void);
65 67
66 /** 68 /**
67 * cpu_map__is_dummy - Events associated with 69 * cpu_map__is_dummy - Events associated with a pid, rather than a CPU, use a single dummy map with an entry of -1.
68 */ 70 */
69 static inline bool cpu_map__is_dummy(const str 71 static inline bool cpu_map__is_dummy(const struct perf_cpu_map *cpus)
70 { 72 {
71 return perf_cpu_map__nr(cpus) == 1 && 73 return perf_cpu_map__nr(cpus) == 1 && perf_cpu_map__cpu(cpus, 0).cpu == -1;
72 } 74 }
73 75
74 /** 76 /**
75 * cpu__get_node - Returns the numa node X as 77 * cpu__get_node - Returns the numa node X as read from
76 * /sys/devices/system/node/nodeX for the give 78 * /sys/devices/system/node/nodeX for the given CPU.
77 */ 79 */
78 int cpu__get_node(struct perf_cpu cpu); 80 int cpu__get_node(struct perf_cpu cpu);
79 /** 81 /**
80 * cpu__get_socket_id - Returns the socket num 82 * cpu__get_socket_id - Returns the socket number as read from
81 * /sys/devices/system/cpu/cpuX/topology/physi 83 * /sys/devices/system/cpu/cpuX/topology/physical_package_id for the given CPU.
82 */ 84 */
83 int cpu__get_socket_id(struct perf_cpu cpu); 85 int cpu__get_socket_id(struct perf_cpu cpu);
84 /** 86 /**
85 * cpu__get_die_id - Returns the die id as rea 87 * cpu__get_die_id - Returns the die id as read from
86 * /sys/devices/system/cpu/cpuX/topology/die_i 88 * /sys/devices/system/cpu/cpuX/topology/die_id for the given CPU.
87 */ 89 */
88 int cpu__get_die_id(struct perf_cpu cpu); 90 int cpu__get_die_id(struct perf_cpu cpu);
89 /** 91 /**
90 * cpu__get_cluster_id - Returns the cluster i 92 * cpu__get_cluster_id - Returns the cluster id as read from
91 * /sys/devices/system/cpu/cpuX/topology/clust 93 * /sys/devices/system/cpu/cpuX/topology/cluster_id for the given CPU
92 */ 94 */
93 int cpu__get_cluster_id(struct perf_cpu cpu); 95 int cpu__get_cluster_id(struct perf_cpu cpu);
94 /** 96 /**
95 * cpu__get_core_id - Returns the core id as r 97 * cpu__get_core_id - Returns the core id as read from
96 * /sys/devices/system/cpu/cpuX/topology/core_ 98 * /sys/devices/system/cpu/cpuX/topology/core_id for the given CPU.
97 */ 99 */
98 int cpu__get_core_id(struct perf_cpu cpu); 100 int cpu__get_core_id(struct perf_cpu cpu);
99 101
100 /** 102 /**
101 * cpu_aggr_map__empty_new - Create a cpu_aggr 103 * cpu_aggr_map__empty_new - Create a cpu_aggr_map of size nr with every entry
102 * being empty. 104 * being empty.
103 */ 105 */
104 struct cpu_aggr_map *cpu_aggr_map__empty_new(i 106 struct cpu_aggr_map *cpu_aggr_map__empty_new(int nr);
105 107
106 typedef struct aggr_cpu_id (*aggr_cpu_id_get_t 108 typedef struct aggr_cpu_id (*aggr_cpu_id_get_t)(struct perf_cpu cpu, void *data);
107 109
108 /** 110 /**
109 * cpu_aggr_map__new - Create a cpu_aggr_map w 111 * 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_ 112 * 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 wi 113 * passed to it. The cpu_aggr_map is sorted with duplicate values removed.
112 */ 114 */
113 struct cpu_aggr_map *cpu_aggr_map__new(const s 115 struct cpu_aggr_map *cpu_aggr_map__new(const struct perf_cpu_map *cpus,
114 aggr_cp 116 aggr_cpu_id_get_t get_id,
115 void *d 117 void *data, bool needs_sort);
116 118
117 bool aggr_cpu_id__equal(const struct aggr_cpu_ 119 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_c 120 bool aggr_cpu_id__is_empty(const struct aggr_cpu_id *a);
119 struct aggr_cpu_id aggr_cpu_id__empty(void); 121 struct aggr_cpu_id aggr_cpu_id__empty(void);
120 122
121 123
122 /** 124 /**
123 * aggr_cpu_id__socket - Create an aggr_cpu_id 125 * aggr_cpu_id__socket - Create an aggr_cpu_id with the socket populated with
124 * the socket for cpu. The function signature 126 * the socket for cpu. The function signature is compatible with
125 * aggr_cpu_id_get_t. 127 * aggr_cpu_id_get_t.
126 */ 128 */
127 struct aggr_cpu_id aggr_cpu_id__socket(struct 129 struct aggr_cpu_id aggr_cpu_id__socket(struct perf_cpu cpu, void *data);
128 /** 130 /**
129 * aggr_cpu_id__die - Create an aggr_cpu_id wi 131 * aggr_cpu_id__die - Create an aggr_cpu_id with the die and socket populated
130 * with the die and socket for cpu. The functi 132 * with the die and socket for cpu. The function signature is compatible with
131 * aggr_cpu_id_get_t. 133 * aggr_cpu_id_get_t.
132 */ 134 */
133 struct aggr_cpu_id aggr_cpu_id__die(struct per 135 struct aggr_cpu_id aggr_cpu_id__die(struct perf_cpu cpu, void *data);
134 /** 136 /**
135 * aggr_cpu_id__cluster - Create an aggr_cpu_i 137 * aggr_cpu_id__cluster - Create an aggr_cpu_id with cluster, die and socket
136 * populated with the cluster, die and socket 138 * populated with the cluster, die and socket for cpu. The function signature
137 * is compatible with aggr_cpu_id_get_t. 139 * is compatible with aggr_cpu_id_get_t.
138 */ 140 */
139 struct aggr_cpu_id aggr_cpu_id__cluster(struct 141 struct aggr_cpu_id aggr_cpu_id__cluster(struct perf_cpu cpu, void *data);
140 /** 142 /**
141 * aggr_cpu_id__core - Create an aggr_cpu_id w 143 * aggr_cpu_id__core - Create an aggr_cpu_id with the core, cluster, die and
142 * socket populated with the core, die and soc 144 * socket populated with the core, die and socket for cpu. The function
143 * signature is compatible with aggr_cpu_id_ge 145 * signature is compatible with aggr_cpu_id_get_t.
144 */ 146 */
145 struct aggr_cpu_id aggr_cpu_id__core(struct pe 147 struct aggr_cpu_id aggr_cpu_id__core(struct perf_cpu cpu, void *data);
146 /** 148 /**
147 * aggr_cpu_id__core - Create an aggr_cpu_id w 149 * aggr_cpu_id__core - Create an aggr_cpu_id with the cpu, core, die and socket
148 * populated with the cpu, core, die and socke 150 * populated with the cpu, core, die and socket for cpu. The function signature
149 * is compatible with aggr_cpu_id_get_t. 151 * is compatible with aggr_cpu_id_get_t.
150 */ 152 */
151 struct aggr_cpu_id aggr_cpu_id__cpu(struct per 153 struct aggr_cpu_id aggr_cpu_id__cpu(struct perf_cpu cpu, void *data);
152 /** 154 /**
153 * aggr_cpu_id__node - Create an aggr_cpu_id w 155 * aggr_cpu_id__node - Create an aggr_cpu_id with the numa node populated for
154 * cpu. The function signature is compatible w 156 * cpu. The function signature is compatible with aggr_cpu_id_get_t.
155 */ 157 */
156 struct aggr_cpu_id aggr_cpu_id__node(struct pe 158 struct aggr_cpu_id aggr_cpu_id__node(struct perf_cpu cpu, void *data);
157 /** 159 /**
158 * aggr_cpu_id__global - Create an aggr_cpu_id 160 * aggr_cpu_id__global - Create an aggr_cpu_id for global aggregation.
159 * The function signature is compatible with a 161 * The function signature is compatible with aggr_cpu_id_get_t.
160 */ 162 */
161 struct aggr_cpu_id aggr_cpu_id__global(struct 163 struct aggr_cpu_id aggr_cpu_id__global(struct perf_cpu cpu, void *data);
162 #endif /* __PERF_CPUMAP_H */ 164 #endif /* __PERF_CPUMAP_H */
163 165
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.