Commit | Line | Data |
---|---|---|
b84800a3 JO |
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) | |
46d525ea ACM |
47 | perf record -g kill (test-record-graph-default) |
48 | perf record --call-graph dwarf kill (test-record-graph-dwarf) | |
49 | perf record --call-graph fp kill (test-record-graph-fp) | |
b84800a3 JO |
50 | perf record --group -e cycles,instructions kill (test-record-group) |
51 | perf record -e '{cycles,instructions}' kill (test-record-group1) | |
880a7843 | 52 | perf record -e '{cycles/period=1/,instructions/period=2/}:S' kill (test-record-group2) |
b84800a3 JO |
53 | perf record -D kill (test-record-no-delay) |
54 | perf record -i kill (test-record-no-inherit) | |
55 | perf record -n kill (test-record-no-samples) | |
56 | perf record -c 100 -P kill (test-record-period) | |
1b98c6e3 | 57 | perf record -c 1 --pfm-events=cycles:period=2 (test-record-pfm-period) |
b84800a3 JO |
58 | perf record -R kill (test-record-raw) |
59 | perf stat -e cycles kill (test-stat-basic) | |
60 | perf stat kill (test-stat-default) | |
61 | perf stat -d kill (test-stat-detailed-1) | |
62 | perf stat -dd kill (test-stat-detailed-2) | |
63 | perf stat -ddd kill (test-stat-detailed-3) | |
64 | perf stat --group -e cycles,instructions kill (test-stat-group) | |
65 | perf stat -e '{cycles,instructions}' kill (test-stat-group1) | |
66 | perf stat -i -e cycles kill (test-stat-no-inherit) |