kernel/tools/perf/tests/attr
2025-07-14 21:26:21 +00:00
..
base-record Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
base-record-spe Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
base-stat Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
README Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
system-wide-dummy Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-basic Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-branch-any Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-branch-filter-any Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-branch-filter-any_call Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-branch-filter-any_ret Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-branch-filter-hv Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-branch-filter-ind_call Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-branch-filter-k Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-branch-filter-u Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-C0 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-count Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-data Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-dummy-C0 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-freq Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-graph-default Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-graph-default-aarch64 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-graph-dwarf Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-graph-fp Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-graph-fp-aarch64 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-group1 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-group2 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-group-sampling Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-no-buffering Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-no-inherit Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-no-samples Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-period Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-pfm-period Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-raw Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-spe-period Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-spe-period-term Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-spe-physical-address Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-user-regs-no-sve-aarch64 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-user-regs-old-sve-aarch64 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-record-user-regs-sve-aarch64 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-stat-basic Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-stat-C0 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-stat-default Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-stat-detailed-1 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-stat-detailed-2 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-stat-detailed-3 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-stat-group1 Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00
test-stat-no-inherit Initial import of 6.12.0-55.20.1.el10_0 2025-07-14 21:26:21 +00:00

The struct perf_event_attr test (attr tests) support
====================================================
This testing support is embedded into perf directly and is governed
by the PERF_TEST_ATTR environment variable and hook inside the
sys_perf_event_open function.

The general idea is to store 'struct perf_event_attr' details for
each event created within single perf command. Each event details
are stored into separate text file. Once perf command is finished
these files are checked for values we expect for command.

The attr tests consist of following parts:

tests/attr.c
------------
This is the sys_perf_event_open hook implementation. The hook
is triggered when the PERF_TEST_ATTR environment variable is
defined. It must contain name of existing directory with access
and write permissions.

For each sys_perf_event_open call event details are stored in
separate file. Besides 'struct perf_event_attr' values we also
store 'fd' and 'group_fd' values to allow checking for groups.

tests/attr.py
-------------
This is the python script that does all the hard work. It reads
the test definition, executes it and checks results.

tests/attr/
-----------
Directory containing all attr test definitions.
Following tests are defined (with perf commands):

  perf record kill                              (test-record-basic)
  perf record -b kill                           (test-record-branch-any)
  perf record -j any kill                       (test-record-branch-filter-any)
  perf record -j any_call kill                  (test-record-branch-filter-any_call)
  perf record -j any_ret kill                   (test-record-branch-filter-any_ret)
  perf record -j hv kill                        (test-record-branch-filter-hv)
  perf record -j ind_call kill                  (test-record-branch-filter-ind_call)
  perf record -j k kill                         (test-record-branch-filter-k)
  perf record -j u kill                         (test-record-branch-filter-u)
  perf record -c 123 kill                       (test-record-count)
  perf record -d kill                           (test-record-data)
  perf record -F 100 kill                       (test-record-freq)
  perf record -g kill                           (test-record-graph-default)
  perf record -g kill                           (test-record-graph-default-aarch64)
  perf record --call-graph dwarf kill		(test-record-graph-dwarf)
  perf record --call-graph fp kill              (test-record-graph-fp)
  perf record --call-graph fp kill              (test-record-graph-fp-aarch64)
  perf record -e '{cycles,instructions}' kill   (test-record-group1)
  perf record -e '{cycles/period=1/,instructions/period=2/}:S' kill (test-record-group2)
  perf record -D kill                           (test-record-no-delay)
  perf record -i kill                           (test-record-no-inherit)
  perf record -n kill                           (test-record-no-samples)
  perf record -c 100 -P kill                    (test-record-period)
  perf record -c 1 --pfm-events=cycles:period=2 (test-record-pfm-period)
  perf record -R kill                           (test-record-raw)
  perf record -c 2 -e arm_spe_0// -- kill       (test-record-spe-period)
  perf record -e arm_spe_0/period=3/ -- kill    (test-record-spe-period-term)
  perf record -e arm_spe_0/pa_enable=1/ -- kill (test-record-spe-physical-address)
  perf stat -e cycles kill                      (test-stat-basic)
  perf stat kill                                (test-stat-default)
  perf stat -d kill                             (test-stat-detailed-1)
  perf stat -dd kill                            (test-stat-detailed-2)
  perf stat -ddd kill                           (test-stat-detailed-3)
  perf stat -e '{cycles,instructions}' kill     (test-stat-group1)
  perf stat -i -e cycles kill                   (test-stat-no-inherit)