cpumap.h (4714B)
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 <internal/cpumap.h> 8#include <perf/cpumap.h> 9 10/** Identify where counts are aggregated, -1 implies not to aggregate. */ 11struct aggr_cpu_id { 12 /** A value in the range 0 to number of threads. */ 13 int thread; 14 /** The numa node X as read from /sys/devices/system/node/nodeX. */ 15 int node; 16 /** 17 * The socket number as read from 18 * /sys/devices/system/cpu/cpuX/topology/physical_package_id. 19 */ 20 int socket; 21 /** The die id as read from /sys/devices/system/cpu/cpuX/topology/die_id. */ 22 int die; 23 /** The core id as read from /sys/devices/system/cpu/cpuX/topology/core_id. */ 24 int core; 25 /** CPU aggregation, note there is one CPU for each SMT thread. */ 26 struct perf_cpu cpu; 27}; 28 29/** A collection of aggr_cpu_id values, the "built" version is sorted and uniqued. */ 30struct cpu_aggr_map { 31 refcount_t refcnt; 32 /** Number of valid entries. */ 33 int nr; 34 /** The entries. */ 35 struct aggr_cpu_id map[]; 36}; 37 38struct perf_record_cpu_map_data; 39 40struct perf_cpu_map *perf_cpu_map__empty_new(int nr); 41 42struct perf_cpu_map *cpu_map__new_data(struct perf_record_cpu_map_data *data); 43size_t cpu_map__snprint(struct perf_cpu_map *map, char *buf, size_t size); 44size_t cpu_map__snprint_mask(struct perf_cpu_map *map, char *buf, size_t size); 45size_t cpu_map__fprintf(struct perf_cpu_map *map, FILE *fp); 46const struct perf_cpu_map *cpu_map__online(void); /* thread unsafe */ 47 48int cpu__setup_cpunode_map(void); 49 50int cpu__max_node(void); 51struct perf_cpu cpu__max_cpu(void); 52struct perf_cpu cpu__max_present_cpu(void); 53 54/** 55 * cpu_map__is_dummy - Events associated with a pid, rather than a CPU, use a single dummy map with an entry of -1. 56 */ 57static inline bool cpu_map__is_dummy(struct perf_cpu_map *cpus) 58{ 59 return perf_cpu_map__nr(cpus) == 1 && perf_cpu_map__cpu(cpus, 0).cpu == -1; 60} 61 62/** 63 * cpu__get_node - Returns the numa node X as read from 64 * /sys/devices/system/node/nodeX for the given CPU. 65 */ 66int cpu__get_node(struct perf_cpu cpu); 67/** 68 * cpu__get_socket_id - Returns the socket number as read from 69 * /sys/devices/system/cpu/cpuX/topology/physical_package_id for the given CPU. 70 */ 71int cpu__get_socket_id(struct perf_cpu cpu); 72/** 73 * cpu__get_die_id - Returns the die id as read from 74 * /sys/devices/system/cpu/cpuX/topology/die_id for the given CPU. 75 */ 76int cpu__get_die_id(struct perf_cpu cpu); 77/** 78 * cpu__get_core_id - Returns the core id as read from 79 * /sys/devices/system/cpu/cpuX/topology/core_id for the given CPU. 80 */ 81int cpu__get_core_id(struct perf_cpu cpu); 82 83/** 84 * cpu_aggr_map__empty_new - Create a cpu_aggr_map of size nr with every entry 85 * being empty. 86 */ 87struct cpu_aggr_map *cpu_aggr_map__empty_new(int nr); 88 89typedef struct aggr_cpu_id (*aggr_cpu_id_get_t)(struct perf_cpu cpu, void *data); 90 91/** 92 * cpu_aggr_map__new - Create a cpu_aggr_map with an aggr_cpu_id for each cpu in 93 * cpus. The aggr_cpu_id is created with 'get_id' that may have a data value 94 * passed to it. The cpu_aggr_map is sorted with duplicate values removed. 95 */ 96struct cpu_aggr_map *cpu_aggr_map__new(const struct perf_cpu_map *cpus, 97 aggr_cpu_id_get_t get_id, 98 void *data); 99 100bool aggr_cpu_id__equal(const struct aggr_cpu_id *a, const struct aggr_cpu_id *b); 101bool aggr_cpu_id__is_empty(const struct aggr_cpu_id *a); 102struct aggr_cpu_id aggr_cpu_id__empty(void); 103 104 105/** 106 * aggr_cpu_id__socket - Create an aggr_cpu_id with the socket populated with 107 * the socket for cpu. The function signature is compatible with 108 * aggr_cpu_id_get_t. 109 */ 110struct aggr_cpu_id aggr_cpu_id__socket(struct perf_cpu cpu, void *data); 111/** 112 * aggr_cpu_id__die - Create an aggr_cpu_id with the die and socket populated 113 * with the die and socket for cpu. The function signature is compatible with 114 * aggr_cpu_id_get_t. 115 */ 116struct aggr_cpu_id aggr_cpu_id__die(struct perf_cpu cpu, void *data); 117/** 118 * aggr_cpu_id__core - Create an aggr_cpu_id with the core, die and socket 119 * populated with the core, die and socket for cpu. The function signature is 120 * compatible with aggr_cpu_id_get_t. 121 */ 122struct aggr_cpu_id aggr_cpu_id__core(struct perf_cpu cpu, void *data); 123/** 124 * aggr_cpu_id__core - Create an aggr_cpu_id with the cpu, core, die and socket 125 * populated with the cpu, core, die and socket for cpu. The function signature 126 * is compatible with aggr_cpu_id_get_t. 127 */ 128struct aggr_cpu_id aggr_cpu_id__cpu(struct perf_cpu cpu, void *data); 129/** 130 * aggr_cpu_id__node - Create an aggr_cpu_id with the numa node populated for 131 * cpu. The function signature is compatible with aggr_cpu_id_get_t. 132 */ 133struct aggr_cpu_id aggr_cpu_id__node(struct perf_cpu cpu, void *data); 134 135#endif /* __PERF_CPUMAP_H */