OpenCloudOS-Kernel/tools/perf/tests/attr
Ian Rogers 5f8f95673f perf evlist: Remove group option.
The group option predates grouping events using curly braces added in
commit 89efb02950 ("perf tools: Add support to parse event group
syntax").

The --group option was retained for legacy support (in August
2012) but keeping it adds complexity.

Signed-off-by: Ian Rogers <irogers@google.com>
Cc: Adrian Hunter <adrian.hunter@intel.com>
Cc: Alexander Shishkin <alexander.shishkin@linux.intel.com>
Cc: Alexey Bayduraev <alexey.v.bayduraev@linux.intel.com>
Cc: Andi Kleen <ak@linux.intel.com>
Cc: Anshuman Khandual <anshuman.khandual@arm.com>
Cc: Athira Jajeev <atrajeev@linux.vnet.ibm.com>
Cc: Eelco Chaudron <echaudro@redhat.com>
Cc: German Gomez <german.gomez@arm.com>
Cc: Ingo Molnar <mingo@redhat.com>
Cc: James Clark <james.clark@arm.com>
Cc: Jiri Olsa <jolsa@kernel.org>
Cc: Kan Liang <kan.liang@linux.intel.com>
Cc: Kim Phillips <kim.phillips@amd.com>
Cc: Leo Yan <leo.yan@linaro.org>
Cc: Mark Rutland <mark.rutland@arm.com>
Cc: Namhyung Kim <namhyung@kernel.org>
Cc: Peter Zijlstra <peterz@infradead.org>
Cc: Riccardo Mancini <rickyman7@gmail.com>
Cc: Sandipan Das <sandipan.das@amd.com>
Cc: Sean Christopherson <seanjc@google.com>
Cc: Shaomin Deng <dengshaomin@cdjrlc.com>
Cc: Stephane Eranian <eranian@google.com>
Cc: Timothy Hayes <timothy.hayes@arm.com>
Cc: Xing Zhengjun <zhengjun.xing@linux.intel.com>
Cc: bpf@vger.kernel.org
Link: https://lore.kernel.org/r/20221213232651.1269909-6-irogers@google.com
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
2022-12-14 15:28:18 -03:00
..
README perf evlist: Remove group option. 2022-12-14 15:28:18 -03:00
base-record perf test: Fix attr tests for PERF_FORMAT_LOST 2022-10-15 10:13:16 -03:00
base-record-spe perf test: Add perf_event_attr tests for the arm_spe event 2022-03-05 16:00:12 -03:00
base-stat tools headers UAPI: Sync perf_event.h with the kernel sources 2021-05-10 09:01:01 -03:00
system-wide-dummy perf test: Fix attr tests for PERF_FORMAT_LOST 2022-10-15 10:13:16 -03:00
test-record-C0 perf record: Add dummy event during system wide synthesis 2020-05-28 10:03:25 -03:00
test-record-basic perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-branch-any perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-branch-filter-any perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-branch-filter-any_call perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-branch-filter-any_ret perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-branch-filter-hv perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-branch-filter-ind_call perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-branch-filter-k perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-branch-filter-u perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-count perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-data perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-freq perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-graph-default perf test: Fix arm64 perf_event_attr tests wrt --call-graph initialization 2022-02-16 13:51:47 -03:00
test-record-graph-default-aarch64 perf test: Fix arm64 perf_event_attr tests wrt --call-graph initialization 2022-02-16 13:51:47 -03:00
test-record-graph-dwarf perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-graph-fp perf test: Fix arm64 perf_event_attr tests wrt --call-graph initialization 2022-02-16 13:51:47 -03:00
test-record-graph-fp-aarch64 perf test: Fix arm64 perf_event_attr tests wrt --call-graph initialization 2022-02-16 13:51:47 -03:00
test-record-group-sampling perf test: Fix attr tests for PERF_FORMAT_LOST 2022-10-15 10:13:16 -03:00
test-record-group1 perf test: Fix attr tests for PERF_FORMAT_LOST 2022-10-15 10:13:16 -03:00
test-record-group2 perf test: Fix attr tests for PERF_FORMAT_LOST 2022-10-15 10:13:16 -03:00
test-record-no-buffering perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-no-inherit perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-no-samples perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-period perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-pfm-period perf test: Ensure sample_period is set libpfm4 events 2020-07-30 07:01:49 -03:00
test-record-raw perf tools: Save bpf_prog_info and BTF of new BPF programs 2019-03-21 11:27:04 -03:00
test-record-spe-period perf test: Add perf_event_attr tests for the arm_spe event 2022-03-05 16:00:12 -03:00
test-record-spe-period-term perf test: Add perf_event_attr tests for the arm_spe event 2022-03-05 16:00:12 -03:00
test-record-spe-physical-address perf test: Add perf_event_attr test for Arm SPE 2022-04-28 10:40:49 -03:00
test-record-user-regs-no-sve-aarch64 perf test arm64: Add attr tests for new VG register 2022-12-14 11:24:32 -03:00
test-record-user-regs-old-sve-aarch64 perf test arm64: Add attr tests for new VG register 2022-12-14 11:24:32 -03:00
test-record-user-regs-sve-aarch64 perf test arm64: Add attr tests for new VG register 2022-12-14 11:24:32 -03:00
test-stat-C0 perf tests attr: Make hw events optional 2017-10-23 11:20:54 -03:00
test-stat-basic perf tests attr: Make hw events optional 2017-10-23 11:20:54 -03:00
test-stat-default perf tests attr: Add missing topdown metrics events 2021-10-05 14:55:38 -03:00
test-stat-detailed-1 perf tests attr: Add missing topdown metrics events 2021-10-05 14:55:38 -03:00
test-stat-detailed-2 perf tests attr: Add missing topdown metrics events 2021-10-05 14:55:38 -03:00
test-stat-detailed-3 perf tests attr: Add missing topdown metrics events 2021-10-05 14:55:38 -03:00
test-stat-group1 perf tests attr: Fix group stat tests 2017-10-03 09:41:45 -03:00
test-stat-no-inherit perf tests attr: Make hw events optional 2017-10-23 11:20:54 -03:00

README

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)