| 1 | The struct perf_event_attr test (attr tests) support |
| 2 | ==================================================== |
| 3 | This testing support is embedded into perf directly and is governed |
| 4 | by the PERF_TEST_ATTR environment variable and hook inside the |
| 5 | sys_perf_event_open function. |
| 6 | |
| 7 | The general idea is to store 'struct perf_event_attr' details for |
| 8 | each event created within single perf command. Each event details |
| 9 | are stored into separate text file. Once perf command is finished |
| 10 | these files are checked for values we expect for command. |
| 11 | |
| 12 | The attr tests consist of following parts: |
| 13 | |
| 14 | tests/attr.c |
| 15 | ------------ |
| 16 | This is the sys_perf_event_open hook implementation. The hook |
| 17 | is triggered when the PERF_TEST_ATTR environment variable is |
| 18 | defined. It must contain name of existing directory with access |
| 19 | and write permissions. |
| 20 | |
| 21 | For each sys_perf_event_open call event details are stored in |
| 22 | separate file. Besides 'struct perf_event_attr' values we also |
| 23 | store 'fd' and 'group_fd' values to allow checking for groups. |
| 24 | |
| 25 | tests/attr.py |
| 26 | ------------- |
| 27 | This is the python script that does all the hard work. It reads |
| 28 | the test definition, executes it and checks results. |
| 29 | |
| 30 | tests/attr/ |
| 31 | ----------- |
| 32 | Directory containing all attr test definitions. |
| 33 | Following tests are defined (with perf commands): |
| 34 | |
| 35 | perf record kill (test-record-basic) |
| 36 | perf record -b kill (test-record-branch-any) |
| 37 | perf record -j any kill (test-record-branch-filter-any) |
| 38 | perf record -j any_call kill (test-record-branch-filter-any_call) |
| 39 | perf record -j any_ret kill (test-record-branch-filter-any_ret) |
| 40 | perf record -j hv kill (test-record-branch-filter-hv) |
| 41 | perf record -j ind_call kill (test-record-branch-filter-ind_call) |
| 42 | perf record -j k kill (test-record-branch-filter-k) |
| 43 | perf record -j u kill (test-record-branch-filter-u) |
| 44 | perf record -c 123 kill (test-record-count) |
| 45 | perf record -d kill (test-record-data) |
| 46 | perf record -F 100 kill (test-record-freq) |
| 47 | perf record -g kill (test-record-graph-default) |
| 48 | perf record -g kill (test-record-graph-default-aarch64) |
| 49 | perf record --call-graph dwarf kill (test-record-graph-dwarf) |
| 50 | perf record --call-graph fp kill (test-record-graph-fp) |
| 51 | perf record --call-graph fp kill (test-record-graph-fp-aarch64) |
| 52 | perf record -e '{cycles,instructions}' kill (test-record-group1) |
| 53 | perf record -e '{cycles/period=1/,instructions/period=2/}:S' kill (test-record-group2) |
| 54 | perf record -e '{cycles,cache-misses}:S' kill (test-record-group-sampling1) |
| 55 | perf record -c 10000 -e '{cycles,cache-misses}:S' kill (test-record-group-sampling2) |
| 56 | perf record -D kill (test-record-no-delay) |
| 57 | perf record -i kill (test-record-no-inherit) |
| 58 | perf record -n kill (test-record-no-samples) |
| 59 | perf record -c 100 -P kill (test-record-period) |
| 60 | perf record -c 1 --pfm-events=cycles:period=2 (test-record-pfm-period) |
| 61 | perf record -R kill (test-record-raw) |
| 62 | perf record -c 2 -e arm_spe_0// -- kill (test-record-spe-period) |
| 63 | perf record -e arm_spe_0/period=3/ -- kill (test-record-spe-period-term) |
| 64 | perf record -e arm_spe_0/pa_enable=1/ -- kill (test-record-spe-physical-address) |
| 65 | perf stat -e cycles kill (test-stat-basic) |
| 66 | perf stat kill (test-stat-default) |
| 67 | perf stat -d kill (test-stat-detailed-1) |
| 68 | perf stat -dd kill (test-stat-detailed-2) |
| 69 | perf stat -ddd kill (test-stat-detailed-3) |
| 70 | perf stat -e '{cycles,instructions}' kill (test-stat-group1) |
| 71 | perf stat -i -e cycles kill (test-stat-no-inherit) |