linux.git/tools/lib/perf/include, branch master

libperf cpumap: Make index and nr types unsigned

2026-04-01T21:50:53+00:00

The index into the cpumap array and the number of entries within the
array can never be negative, so let's make them unsigned. This is
prompted by reports that gcc 13 with -O6 is giving a
alloc-size-larger-than errors. The change makes the cpumap changes and
then updates the declaration of index variables throughout perf and
libperf to be unsigned. The two things are hard to separate as
compiler warnings about mixing signed and unsigned types breaks the
build.

Reported-by: Chingbin Li 
Closes: https://lore.kernel.org/lkml/20260212025127.841090-1-liqb365@163.com/
Tested-by: Chingbin Li 
Signed-off-by: Ian Rogers 
Signed-off-by: Namhyung Kim

perf evlist: Special map propagation for tool events that read on 1 CPU

2026-02-10T12:33:28+00:00

Tool events like duration_time don't need a perf_cpu_map that contains
all online CPUs.

Having such a perf_cpu_map causes overheads when iterating between
events for CPU affinity.

During parsing mark events that just read on a single CPU map index as
such, then during map propagation set up the evsel's CPUs and thereby
the evlists accordingly.

The setting cannot be done early in parsing as user CPUs are only fully
known when evlist__create_maps is called.

Signed-off-by: Ian Rogers 
Cc: Adrian Hunter 
Cc: Alexander Shishkin 
Cc: Andi Kleen 
Cc: Andres Freund 
Cc: Dapeng Mi 
Cc: Dr. David Alan Gilbert 
Cc: Ingo Molnar 
Cc: James Clark 
Cc: Jiri Olsa 
Cc: Namhyung Kim 
Cc: Peter Zijlstra 
Cc: Thomas Falcon 
Cc: Thomas Richter 
Cc: Yang Li 
Signed-off-by: Arnaldo Carvalho de Melo

perf sched stats: Add schedstat v17 support

2026-01-22T15:31:51+00:00

The /proc/schedstat file output is standardized with version number.

Add support to record and raw dump v17 version layout.

Version 17 of schedstats removed 'lb_imbalance' field as it has no
significance anymore and instead added more relevant fields namely
'lb_imbalance_load', 'lb_imbalance_util', 'lb_imbalance_task' and
'lb_imbalance_misfit'.

The domain field prints the name of the corresponding sched domain from
this version onwards.

Co-developed-by: Ravi Bangoria 
Signed-off-by: Ravi Bangoria 
Signed-off-by: Swapnil Sapkal 
Tested-by: Chen Yu 
Acked-by: Ian Rogers 
Acked-by: Peter Zijlstra 
Cc: Adrian Hunter 
Cc: Alexander Shishkin 
Cc: Andi Kleen 
Cc: Anubhav Shelat 
Cc: Ben Gainey 
Cc: Blake Jones 
Cc: Chun-Tse Shao 
Cc: David Vernet 
Cc: Dmitriy Vyukov 
Cc: Dr. David Alan Gilbert 
Cc: Gautham Shenoy 
Cc: Graham Woodward 
Cc: Ingo Molnar 
Cc: James Clark 
Cc: Jiri Olsa 
Cc: Juri Lelli 
Cc: K Prateek Nayak 
Cc: Kan Liang 
Cc: Leo Yan 
Cc: Madadi Vineeth Reddy 
Cc: Mark Rutland 
Cc: Namhyung Kim 
Cc: Sandipan Das 
Cc: Santosh Shukla 
Cc: Shrikanth Hegde 
Cc: Steven Rostedt (VMware) 
Cc: Tejun Heo 
Cc: Thomas Falcon 
Cc: Tim Chen 
Cc: Vincent Guittot 
Cc: Yang Jihong 
Cc: Yujie Liu 
Cc: Zhongqiu Han 
Signed-off-by: Arnaldo Carvalho de Melo

perf sched stats: Add schedstat v16 support

2026-01-22T15:30:16+00:00

The /proc/schedstat file output is standardized with version number.

Add support to record and raw dump v16 version layout.

Version 16 of schedstats changed the order of definitions within 'enum
cpu_idle_type', which changed the order of [CPU_MAX_IDLE_TYPES] columns
in show_schedstat().

In particular the position of CPU_IDLE and __CPU_NOT_IDLE changed
places.

Co-developed-by: Ravi Bangoria 
Signed-off-by: Ravi Bangoria 
Signed-off-by: Swapnil Sapkal 
Tested-by: Chen Yu 
Tested-by: James Clark 
Acked-by: Ian Rogers 
Acked-by: Peter Zijlstra 
Cc: Adrian Hunter 
Cc: Alexander Shishkin 
Cc: Andi Kleen 
Cc: Anubhav Shelat 
Cc: Ben Gainey 
Cc: Blake Jones 
Cc: Chun-Tse Shao 
Cc: David Vernet 
Cc: Dmitriy Vyukov 
Cc: Dr. David Alan Gilbert 
Cc: Gautham Shenoy 
Cc: Graham Woodward 
Cc: Ingo Molnar 
Cc: James Clark 
Cc: Jiri Olsa 
Cc: Juri Lelli 
Cc: K Prateek Nayak 
Cc: Kan Liang 
Cc: Leo Yan 
Cc: Madadi Vineeth Reddy 
Cc: Mark Rutland 
Cc: Namhyung Kim 
Cc: Sandipan Das 
Cc: Santosh Shukla 
Cc: Shrikanth Hegde 
Cc: Steven Rostedt (VMware) 
Cc: Tejun Heo 
Cc: Thomas Falcon 
Cc: Tim Chen 
Cc: Vincent Guittot 
Cc: Yang Jihong 
Cc: Yujie Liu 
Cc: Zhongqiu Han 
Signed-off-by: Arnaldo Carvalho de Melo

perf sched stats: Add record and rawdump support

2026-01-22T15:29:28+00:00

Define new, perf tool only, sample types and their layouts. Add logic
to parse /proc/schedstat, convert it to perf sample format and save
samples to perf.data file with `perf sched stats record` command.

Also add logic to read perf.data file, interpret schedstat samples and
print rawdump of samples with `perf script -D`.

Note that, /proc/schedstat file output is standardized with version
number. The patch supports v15 but older or newer version can be added
easily.

Co-developed-by: Ravi Bangoria 
Signed-off-by: Ravi Bangoria 
Signed-off-by: Swapnil Sapkal 
Tested-by: Chen Yu 
Tested-by: James Clark 
Acked-by: Ian Rogers 
Acked-by: Peter Zijlstra 
Cc: Adrian Hunter 
Cc: Alexander Shishkin 
Cc: Andi Kleen 
Cc: Anubhav Shelat 
Cc: Ben Gainey 
Cc: Blake Jones 
Cc: Chun-Tse Shao 
Cc: David Vernet 
Cc: Dmitriy Vyukov 
Cc: Dr. David Alan Gilbert 
Cc: Gautham Shenoy 
Cc: Graham Woodward 
Cc: Ingo Molnar 
Cc: James Clark 
Cc: Jiri Olsa 
Cc: Juri Lelli 
Cc: K Prateek Nayak 
Cc: Kan Liang 
Cc: Leo Yan 
Cc: Madadi Vineeth Reddy 
Cc: Mark Rutland 
Cc: Namhyung Kim 
Cc: Sandipan Das 
Cc: Santosh Shukla 
Cc: Shrikanth Hegde 
Cc: Steven Rostedt (VMware) 
Cc: Tejun Heo 
Cc: Thomas Falcon 
Cc: Tim Chen 
Cc: Vincent Guittot 
Cc: Yang Jihong 
Cc: Yujie Liu 
Cc: Zhongqiu Han 
[ PRIu64 needs uint64_t, not 'unsigned long' to work on both 32-bit and 64-bit ]
Signed-off-by: Arnaldo Carvalho de Melo

libperf: Use 'extern' in LIBPERF_API visibility macro

2025-12-05T18:31:32+00:00

Use 'extern' on LIBPERF_API to address this issue that started appearing
with gcc 15, first seen in ubuntu 25.10:

  evlist.c: In function 'perf_evlist__purge':
  evlist.c:202:17: error: implicit declaration of function 'perf_evsel__delete'; did you mean 'perf_evsel__exit'? [-Wimplicit-function-declaration]
    202 |                 perf_evsel__delete(pos);
        |                 ^~~~~~~~~~~~~~~~~~
        |                 perf_evsel__exit
  evlist.c:202:17: error: nested extern declaration of 'perf_evsel__delete' [-Werror=nested-externs]
  evlist.c: In function 'perf_evlist__open':
  evlist.c:261:23: error: implicit declaration of function 'perf_evsel__open'; did you mean 'perf_evsel__exit'? [-Wimplicit-function-declaration]
    261 |                 err = perf_evsel__open(evsel, evsel->cpus, evsel->threads);
        |                       ^~~~~~~~~~~~~~~~
        |                       perf_evsel__exit
  evlist.c:261:23: error: nested extern declaration of 'perf_evsel__open' [-Werror=nested-externs]

Signed-off-by: Arnaldo Carvalho de Melo 
Signed-off-by: Namhyung Kim

perf tools: Minimal DEFERRED_CALLCHAIN support

2025-12-03T00:13:32+00:00

Add a new event type for deferred callchains and a new callback for the
struct perf_tool.  For now it doesn't actually handle the deferred
callchains but it just marks the sample if it has the PERF_CONTEXT_
USER_DEFFERED in the callchain array.

At least, perf report can dump the raw data with this change.  Actually
this requires the next commit to enable attr.defer_callchain, but if you
already have a data file, it'll show the following result.

  $ perf report -D
  ...
  0x2158@perf.data [0x40]: event: 22
  .
  . ... raw event: size 64 bytes
  .  0000:  16 00 00 00 02 00 40 00 06 00 00 00 0b 00 00 00  ......@.........
  .  0010:  03 00 00 00 00 00 00 00 a7 7f 33 fe 18 7f 00 00  ..........3.....
  .  0020:  0f 0e 33 fe 18 7f 00 00 48 14 33 fe 18 7f 00 00  ..3.....H.3.....
  .  0030:  08 09 00 00 08 09 00 00 e6 7a e7 35 1c 00 00 00  .........z.5....

  121163447014 0x2158 [0x40]: PERF_RECORD_CALLCHAIN_DEFERRED(IP, 0x2): 2312/2312: 0xb00000006
  ... FP chain: nr:3
  .....  0: 00007f18fe337fa7
  .....  1: 00007f18fe330e0f
  .....  2: 00007f18fe331448
  : unhandled!

Reviewed-by: Ian Rogers 
Signed-off-by: Namhyung Kim

libperf event: Ensure tracing data is multiple of 8 sized

2025-09-03T15:34:54+00:00

Perf's synthetic-events.c will ensure 8-byte alignment of tracing
data, writing it after a perf_record_header_tracing_data event.

Add padding to struct perf_record_header_tracing_data to make it 16-byte
rather than 12-byte sized.

Fixes: 055c67ed39887c55 ("perf tools: Move event synthesizing routines to separate .c file")
Reviewed-by: James Clark 
Signed-off-by: Ian Rogers 
Acked-by: Namhyung Kim 
Tested-by: Arnaldo Carvalho de Melo 
Cc: Adrian Hunter 
Cc: Alexander Shishkin 
Cc: Athira Rajeev 
Cc: Blake Jones 
Cc: Chun-Tse Shao 
Cc: Collin Funk 
Cc: Howard Chu 
Cc: Ingo Molnar 
Cc: Jan Polensky 
Cc: Jiri Olsa 
Cc: Kan Liang 
Cc: Li Huafei 
Cc: Mark Rutland 
Cc: Nam Cao 
Cc: Peter Zijlstra 
Cc: Steinar H. Gunderson 
Cc: Thomas Gleixner 
Link: https://lore.kernel.org/r/20250821163820.1132977-6-irogers@google.com
Signed-off-by: Arnaldo Carvalho de Melo

libperf evsel: Factor perf_evsel__exit out of perf_evsel__delete

2025-07-24T20:41:35+00:00

This allows the perf_evsel__exit to be called when the struct
perf_evsel is embedded inside another struct, such as struct evsel in
perf.

Reviewed-by: Thomas Falcon 
Signed-off-by: Ian Rogers 
Tested-by: James Clark 
Link: https://lore.kernel.org/r/20250719030517.1990983-8-irogers@google.com
Signed-off-by: Namhyung Kim

libperf evsel: Rename own_cpus to pmu_cpus

2025-07-24T20:41:35+00:00

own_cpus is generally the cpumask from the PMU. Rename to pmu_cpus to
try to make this clearer. Variable rename with no other changes.

Reviewed-by: Thomas Falcon 
Signed-off-by: Ian Rogers 
Tested-by: James Clark 
Link: https://lore.kernel.org/r/20250719030517.1990983-7-irogers@google.com
Signed-off-by: Namhyung Kim