[PATCH v16 00/16] perf, tools: Add support for PMU events in JSON format

From: Sukadev Bhattiprolu
Date: Wed Aug 26 2015 - 02:07:51 EST

CPUs support a large number of performance monitoring events (PMU events)
and often these events are very specific to an architecture/model of the
CPU. To use most of these PMU events with perf, we currently have to identify
them by their raw codes:

perf stat -e r100f2 sleep 1

This patchset allows architectures to specify these PMU events in JSON
files located in 'tools/perf/pmu-events/arch/' of the mainline tree.
The events from the JSON files for the architecture are then built into
the perf binary.

At run time, perf identifies the specific set of events for the CPU and
creates "event aliases". These aliases allow users to specify events by
"name" as:

perf stat -e pm_1plus_ppc_cmpl sleep 1

The file, 'tools/perf/pmu-events/README' in [PATCH 16/16] gives more

- All known events tables for the architecture are included in the
perf binary.

- For architectures that don't have any JSON files, an empty mapping
table is created and they should continue to build.

Thanks to input from Andi Kleen, Jiri Olsa, Namhyung Kim and Ingo Molnar.

These patches are available from:


Branch Description
json-v16 Source Code only
json-files-6 x86 and Powerpc datafiles only
json-v16-with-data Both code and data (for build/test)

NOTE: Only "source code" patches (i.e those in json-v16) are being emailed.
Please pull the "data files" from the json-files-6 branch.

Rebase to recent perf/core; fix minor merge conflicts; drop 3 patches
that were merged into perf/core.

Code changes:
- Fix 'perf list' usage string and update man page.
- Remove a redundant __maybe_unused tag.
- Rebase to recent perf/core branch.

Data files updates: json-files-5 branch
- Rebase to perf/intel-json-files-5 from Andi Kleen
- Add patch from Madhavan Srinivasan for couple more Powerpc models

Comments from Jiri Olsa:
- Change parameter name/type for pmu_add_cpu_aliases (from void *data
to list_head *head)
- Use asprintf() in file_name_to_tablename() and simplify/reorg code.
- Use __weak definition from <linux/compile.h>
- Use fopen() with mode "w" and eliminate unlink()
- Remove minor TODO.
- Add error check for return value from strdup() in print_pmu_events().
- Move independent changes from patches 3,11,12 .. to separate patches
for easier review/backport.
- Clarify mapfile's "header line support" in patch description.
- Fix build failure with DEBUG=1

Comment from Andi Kleen:
- In tools/perf/pmu-events/Build, check for 'mapfile.csv' rather than

- Minor changes/clarifications to tools/perf/pmu-events/README.

Version: Individual patches have their own history :-) that I am
preserving. Patchset version (v13) is for overall patchset and is
somewhat arbitrary.

- Added support for "categories" of events to perf
- Add mapfile, jevents build dependency on pmu-events.c
- Silence jevents when parsing JSON files unless V=1 is specified
- Cleanup error messages
- Fix memory leak with ->cpuid
- Rebase to Arnaldo's tree
- Allow overriding CPUID via environment variable
- Support long descriptions for events
- Handle header line in mapfile.csv
- Cleanup JSON files (trim PublicDescription if identical to/prefix of
BriefDescription field)

Andi Kleen (9):
perf, tools: Add jsmn `jasmine' JSON parser
perf, tools, jevents: Program to convert JSON file to C style file
perf, tools: Support CPU id matching for x86 v2
perf, tools: Support alias descriptions
perf, tools: Query terminal width and use in perf list
perf, tools: Add a --no-desc flag to perf list
perf, tools: Add override support for event list CPUID
perf, tools: Add support for event list topics
perf, tools: Handle header line in mapfile

Sukadev Bhattiprolu (7):
perf, tools: Use pmu_events table to create aliases
perf, tools: Support CPU ID matching for Powerpc
perf, tools, jevents: Add support for long descriptions
perf, tools: Add alias support for long descriptions
perf, tools: Support long descriptions with perf list
perf, tools, jevents: Add support for event topics
perf, tools: Add README for info on parsing JSON/map files

tools/perf/Documentation/perf-list.txt | 12 +-
tools/perf/Makefile.perf | 26 +-
tools/perf/arch/powerpc/util/header.c | 11 +
tools/perf/arch/x86/util/header.c | 24 +-
tools/perf/builtin-list.c | 17 +-
tools/perf/pmu-events/Build | 11 +
tools/perf/pmu-events/README | 122 ++++++
tools/perf/pmu-events/jevents.c | 712 ++++++++++++++++++++++++++++++++
tools/perf/pmu-events/jevents.h | 18 +
tools/perf/pmu-events/jsmn.c | 313 ++++++++++++++
tools/perf/pmu-events/jsmn.h | 67 +++
tools/perf/pmu-events/json.c | 162 ++++++++
tools/perf/pmu-events/json.h | 39 ++
tools/perf/pmu-events/pmu-events.h | 37 ++
tools/perf/util/cache.h | 1 +
tools/perf/util/header.h | 1 +
tools/perf/util/pager.c | 15 +
tools/perf/util/parse-events.c | 5 +-
tools/perf/util/parse-events.h | 3 +-
tools/perf/util/pmu.c | 176 +++++++-
tools/perf/util/pmu.h | 6 +-
21 files changed, 1744 insertions(+), 34 deletions(-)
create mode 100644 tools/perf/pmu-events/Build
create mode 100644 tools/perf/pmu-events/README
create mode 100644 tools/perf/pmu-events/jevents.c
create mode 100644 tools/perf/pmu-events/jevents.h
create mode 100644 tools/perf/pmu-events/jsmn.c
create mode 100644 tools/perf/pmu-events/jsmn.h
create mode 100644 tools/perf/pmu-events/json.c
create mode 100644 tools/perf/pmu-events/json.h
create mode 100644 tools/perf/pmu-events/pmu-events.h


To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/