diff options
author | Konstantin Khlebnikov <khlebnikov@openvz.org> | 2012-01-10 18:07:10 -0500 |
---|---|---|
committer | Linus Torvalds <torvalds@linux-foundation.org> | 2012-01-10 19:30:41 -0500 |
commit | 90a5d5af74f6570af063fb6bff33c6b2f8361bbc (patch) | |
tree | 3165cde652d1c8cf3c8817b34ba880fc35fa6c96 | |
parent | b413d48aa70605701c0b395b2e350ca15f5d643a (diff) |
mm-tracepoint: fix documentation and examples
We renamed the page-free mm tracepoints.
Signed-off-by: Konstantin Khlebnikov <khlebnikov@openvz.org>
Cc: Mel Gorman <mel@csn.ul.ie>
Cc: KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
Reviewed-by: Minchan Kim <minchan.kim@gmail.com>
Cc: Hugh Dickins <hughd@google.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
-rw-r--r-- | Documentation/trace/tracepoint-analysis.txt | 40 | ||||
-rw-r--r-- | tools/perf/Documentation/examples.txt | 34 |
2 files changed, 37 insertions, 37 deletions
diff --git a/Documentation/trace/tracepoint-analysis.txt b/Documentation/trace/tracepoint-analysis.txt index 87bee3c129ba..058cc6c9dc56 100644 --- a/Documentation/trace/tracepoint-analysis.txt +++ b/Documentation/trace/tracepoint-analysis.txt | |||
@@ -93,14 +93,14 @@ By specifying the -a switch and analysing sleep, the system-wide events | |||
93 | for a duration of time can be examined. | 93 | for a duration of time can be examined. |
94 | 94 | ||
95 | $ perf stat -a \ | 95 | $ perf stat -a \ |
96 | -e kmem:mm_page_alloc -e kmem:mm_page_free_direct \ | 96 | -e kmem:mm_page_alloc -e kmem:mm_page_free \ |
97 | -e kmem:mm_pagevec_free \ | 97 | -e kmem:mm_page_free_batched \ |
98 | sleep 10 | 98 | sleep 10 |
99 | Performance counter stats for 'sleep 10': | 99 | Performance counter stats for 'sleep 10': |
100 | 100 | ||
101 | 9630 kmem:mm_page_alloc | 101 | 9630 kmem:mm_page_alloc |
102 | 2143 kmem:mm_page_free_direct | 102 | 2143 kmem:mm_page_free |
103 | 7424 kmem:mm_pagevec_free | 103 | 7424 kmem:mm_page_free_batched |
104 | 104 | ||
105 | 10.002577764 seconds time elapsed | 105 | 10.002577764 seconds time elapsed |
106 | 106 | ||
@@ -119,15 +119,15 @@ basis using set_ftrace_pid. | |||
119 | Events can be activated and tracked for the duration of a process on a local | 119 | Events can be activated and tracked for the duration of a process on a local |
120 | basis using PCL such as follows. | 120 | basis using PCL such as follows. |
121 | 121 | ||
122 | $ perf stat -e kmem:mm_page_alloc -e kmem:mm_page_free_direct \ | 122 | $ perf stat -e kmem:mm_page_alloc -e kmem:mm_page_free \ |
123 | -e kmem:mm_pagevec_free ./hackbench 10 | 123 | -e kmem:mm_page_free_batched ./hackbench 10 |
124 | Time: 0.909 | 124 | Time: 0.909 |
125 | 125 | ||
126 | Performance counter stats for './hackbench 10': | 126 | Performance counter stats for './hackbench 10': |
127 | 127 | ||
128 | 17803 kmem:mm_page_alloc | 128 | 17803 kmem:mm_page_alloc |
129 | 12398 kmem:mm_page_free_direct | 129 | 12398 kmem:mm_page_free |
130 | 4827 kmem:mm_pagevec_free | 130 | 4827 kmem:mm_page_free_batched |
131 | 131 | ||
132 | 0.973913387 seconds time elapsed | 132 | 0.973913387 seconds time elapsed |
133 | 133 | ||
@@ -146,8 +146,8 @@ to know what the standard deviation is. By and large, this is left to the | |||
146 | performance analyst to do it by hand. In the event that the discrete event | 146 | performance analyst to do it by hand. In the event that the discrete event |
147 | occurrences are useful to the performance analyst, then perf can be used. | 147 | occurrences are useful to the performance analyst, then perf can be used. |
148 | 148 | ||
149 | $ perf stat --repeat 5 -e kmem:mm_page_alloc -e kmem:mm_page_free_direct | 149 | $ perf stat --repeat 5 -e kmem:mm_page_alloc -e kmem:mm_page_free |
150 | -e kmem:mm_pagevec_free ./hackbench 10 | 150 | -e kmem:mm_page_free_batched ./hackbench 10 |
151 | Time: 0.890 | 151 | Time: 0.890 |
152 | Time: 0.895 | 152 | Time: 0.895 |
153 | Time: 0.915 | 153 | Time: 0.915 |
@@ -157,8 +157,8 @@ occurrences are useful to the performance analyst, then perf can be used. | |||
157 | Performance counter stats for './hackbench 10' (5 runs): | 157 | Performance counter stats for './hackbench 10' (5 runs): |
158 | 158 | ||
159 | 16630 kmem:mm_page_alloc ( +- 3.542% ) | 159 | 16630 kmem:mm_page_alloc ( +- 3.542% ) |
160 | 11486 kmem:mm_page_free_direct ( +- 4.771% ) | 160 | 11486 kmem:mm_page_free ( +- 4.771% ) |
161 | 4730 kmem:mm_pagevec_free ( +- 2.325% ) | 161 | 4730 kmem:mm_page_free_batched ( +- 2.325% ) |
162 | 162 | ||
163 | 0.982653002 seconds time elapsed ( +- 1.448% ) | 163 | 0.982653002 seconds time elapsed ( +- 1.448% ) |
164 | 164 | ||
@@ -168,15 +168,15 @@ aggregation of discrete events, then a script would need to be developed. | |||
168 | Using --repeat, it is also possible to view how events are fluctuating over | 168 | Using --repeat, it is also possible to view how events are fluctuating over |
169 | time on a system-wide basis using -a and sleep. | 169 | time on a system-wide basis using -a and sleep. |
170 | 170 | ||
171 | $ perf stat -e kmem:mm_page_alloc -e kmem:mm_page_free_direct \ | 171 | $ perf stat -e kmem:mm_page_alloc -e kmem:mm_page_free \ |
172 | -e kmem:mm_pagevec_free \ | 172 | -e kmem:mm_page_free_batched \ |
173 | -a --repeat 10 \ | 173 | -a --repeat 10 \ |
174 | sleep 1 | 174 | sleep 1 |
175 | Performance counter stats for 'sleep 1' (10 runs): | 175 | Performance counter stats for 'sleep 1' (10 runs): |
176 | 176 | ||
177 | 1066 kmem:mm_page_alloc ( +- 26.148% ) | 177 | 1066 kmem:mm_page_alloc ( +- 26.148% ) |
178 | 182 kmem:mm_page_free_direct ( +- 5.464% ) | 178 | 182 kmem:mm_page_free ( +- 5.464% ) |
179 | 890 kmem:mm_pagevec_free ( +- 30.079% ) | 179 | 890 kmem:mm_page_free_batched ( +- 30.079% ) |
180 | 180 | ||
181 | 1.002251757 seconds time elapsed ( +- 0.005% ) | 181 | 1.002251757 seconds time elapsed ( +- 0.005% ) |
182 | 182 | ||
@@ -220,8 +220,8 @@ were generating events within the kernel. To begin this sort of analysis, the | |||
220 | data must be recorded. At the time of writing, this required root: | 220 | data must be recorded. At the time of writing, this required root: |
221 | 221 | ||
222 | $ perf record -c 1 \ | 222 | $ perf record -c 1 \ |
223 | -e kmem:mm_page_alloc -e kmem:mm_page_free_direct \ | 223 | -e kmem:mm_page_alloc -e kmem:mm_page_free \ |
224 | -e kmem:mm_pagevec_free \ | 224 | -e kmem:mm_page_free_batched \ |
225 | ./hackbench 10 | 225 | ./hackbench 10 |
226 | Time: 0.894 | 226 | Time: 0.894 |
227 | [ perf record: Captured and wrote 0.733 MB perf.data (~32010 samples) ] | 227 | [ perf record: Captured and wrote 0.733 MB perf.data (~32010 samples) ] |
@@ -260,8 +260,8 @@ noticed that X was generating an insane amount of page allocations so let's look | |||
260 | at it: | 260 | at it: |
261 | 261 | ||
262 | $ perf record -c 1 -f \ | 262 | $ perf record -c 1 -f \ |
263 | -e kmem:mm_page_alloc -e kmem:mm_page_free_direct \ | 263 | -e kmem:mm_page_alloc -e kmem:mm_page_free \ |
264 | -e kmem:mm_pagevec_free \ | 264 | -e kmem:mm_page_free_batched \ |
265 | -p `pidof X` | 265 | -p `pidof X` |
266 | 266 | ||
267 | This was interrupted after a few seconds and | 267 | This was interrupted after a few seconds and |
diff --git a/tools/perf/Documentation/examples.txt b/tools/perf/Documentation/examples.txt index 8eb6c489fb15..77f952762426 100644 --- a/tools/perf/Documentation/examples.txt +++ b/tools/perf/Documentation/examples.txt | |||
@@ -17,8 +17,8 @@ titan:~> perf list | |||
17 | kmem:kmem_cache_alloc_node [Tracepoint event] | 17 | kmem:kmem_cache_alloc_node [Tracepoint event] |
18 | kmem:kfree [Tracepoint event] | 18 | kmem:kfree [Tracepoint event] |
19 | kmem:kmem_cache_free [Tracepoint event] | 19 | kmem:kmem_cache_free [Tracepoint event] |
20 | kmem:mm_page_free_direct [Tracepoint event] | 20 | kmem:mm_page_free [Tracepoint event] |
21 | kmem:mm_pagevec_free [Tracepoint event] | 21 | kmem:mm_page_free_batched [Tracepoint event] |
22 | kmem:mm_page_alloc [Tracepoint event] | 22 | kmem:mm_page_alloc [Tracepoint event] |
23 | kmem:mm_page_alloc_zone_locked [Tracepoint event] | 23 | kmem:mm_page_alloc_zone_locked [Tracepoint event] |
24 | kmem:mm_page_pcpu_drain [Tracepoint event] | 24 | kmem:mm_page_pcpu_drain [Tracepoint event] |
@@ -29,15 +29,15 @@ measured. For example the page alloc/free properties of a 'hackbench | |||
29 | run' are: | 29 | run' are: |
30 | 30 | ||
31 | titan:~> perf stat -e kmem:mm_page_pcpu_drain -e kmem:mm_page_alloc | 31 | titan:~> perf stat -e kmem:mm_page_pcpu_drain -e kmem:mm_page_alloc |
32 | -e kmem:mm_pagevec_free -e kmem:mm_page_free_direct ./hackbench 10 | 32 | -e kmem:mm_page_free_batched -e kmem:mm_page_free ./hackbench 10 |
33 | Time: 0.575 | 33 | Time: 0.575 |
34 | 34 | ||
35 | Performance counter stats for './hackbench 10': | 35 | Performance counter stats for './hackbench 10': |
36 | 36 | ||
37 | 13857 kmem:mm_page_pcpu_drain | 37 | 13857 kmem:mm_page_pcpu_drain |
38 | 27576 kmem:mm_page_alloc | 38 | 27576 kmem:mm_page_alloc |
39 | 6025 kmem:mm_pagevec_free | 39 | 6025 kmem:mm_page_free_batched |
40 | 20934 kmem:mm_page_free_direct | 40 | 20934 kmem:mm_page_free |
41 | 41 | ||
42 | 0.613972165 seconds time elapsed | 42 | 0.613972165 seconds time elapsed |
43 | 43 | ||
@@ -45,8 +45,8 @@ You can observe the statistical properties as well, by using the | |||
45 | 'repeat the workload N times' feature of perf stat: | 45 | 'repeat the workload N times' feature of perf stat: |
46 | 46 | ||
47 | titan:~> perf stat --repeat 5 -e kmem:mm_page_pcpu_drain -e | 47 | titan:~> perf stat --repeat 5 -e kmem:mm_page_pcpu_drain -e |
48 | kmem:mm_page_alloc -e kmem:mm_pagevec_free -e | 48 | kmem:mm_page_alloc -e kmem:mm_page_free_batched -e |
49 | kmem:mm_page_free_direct ./hackbench 10 | 49 | kmem:mm_page_free ./hackbench 10 |
50 | Time: 0.627 | 50 | Time: 0.627 |
51 | Time: 0.644 | 51 | Time: 0.644 |
52 | Time: 0.564 | 52 | Time: 0.564 |
@@ -57,8 +57,8 @@ You can observe the statistical properties as well, by using the | |||
57 | 57 | ||
58 | 12920 kmem:mm_page_pcpu_drain ( +- 3.359% ) | 58 | 12920 kmem:mm_page_pcpu_drain ( +- 3.359% ) |
59 | 25035 kmem:mm_page_alloc ( +- 3.783% ) | 59 | 25035 kmem:mm_page_alloc ( +- 3.783% ) |
60 | 6104 kmem:mm_pagevec_free ( +- 0.934% ) | 60 | 6104 kmem:mm_page_free_batched ( +- 0.934% ) |
61 | 18376 kmem:mm_page_free_direct ( +- 4.941% ) | 61 | 18376 kmem:mm_page_free ( +- 4.941% ) |
62 | 62 | ||
63 | 0.643954516 seconds time elapsed ( +- 2.363% ) | 63 | 0.643954516 seconds time elapsed ( +- 2.363% ) |
64 | 64 | ||
@@ -158,15 +158,15 @@ Or you can observe the whole system's page allocations for 10 | |||
158 | seconds: | 158 | seconds: |
159 | 159 | ||
160 | titan:~/git> perf stat -a -e kmem:mm_page_pcpu_drain -e | 160 | titan:~/git> perf stat -a -e kmem:mm_page_pcpu_drain -e |
161 | kmem:mm_page_alloc -e kmem:mm_pagevec_free -e | 161 | kmem:mm_page_alloc -e kmem:mm_page_free_batched -e |
162 | kmem:mm_page_free_direct sleep 10 | 162 | kmem:mm_page_free sleep 10 |
163 | 163 | ||
164 | Performance counter stats for 'sleep 10': | 164 | Performance counter stats for 'sleep 10': |
165 | 165 | ||
166 | 171585 kmem:mm_page_pcpu_drain | 166 | 171585 kmem:mm_page_pcpu_drain |
167 | 322114 kmem:mm_page_alloc | 167 | 322114 kmem:mm_page_alloc |
168 | 73623 kmem:mm_pagevec_free | 168 | 73623 kmem:mm_page_free_batched |
169 | 254115 kmem:mm_page_free_direct | 169 | 254115 kmem:mm_page_free |
170 | 170 | ||
171 | 10.000591410 seconds time elapsed | 171 | 10.000591410 seconds time elapsed |
172 | 172 | ||
@@ -174,15 +174,15 @@ Or observe how fluctuating the page allocations are, via statistical | |||
174 | analysis done over ten 1-second intervals: | 174 | analysis done over ten 1-second intervals: |
175 | 175 | ||
176 | titan:~/git> perf stat --repeat 10 -a -e kmem:mm_page_pcpu_drain -e | 176 | titan:~/git> perf stat --repeat 10 -a -e kmem:mm_page_pcpu_drain -e |
177 | kmem:mm_page_alloc -e kmem:mm_pagevec_free -e | 177 | kmem:mm_page_alloc -e kmem:mm_page_free_batched -e |
178 | kmem:mm_page_free_direct sleep 1 | 178 | kmem:mm_page_free sleep 1 |
179 | 179 | ||
180 | Performance counter stats for 'sleep 1' (10 runs): | 180 | Performance counter stats for 'sleep 1' (10 runs): |
181 | 181 | ||
182 | 17254 kmem:mm_page_pcpu_drain ( +- 3.709% ) | 182 | 17254 kmem:mm_page_pcpu_drain ( +- 3.709% ) |
183 | 34394 kmem:mm_page_alloc ( +- 4.617% ) | 183 | 34394 kmem:mm_page_alloc ( +- 4.617% ) |
184 | 7509 kmem:mm_pagevec_free ( +- 4.820% ) | 184 | 7509 kmem:mm_page_free_batched ( +- 4.820% ) |
185 | 25653 kmem:mm_page_free_direct ( +- 3.672% ) | 185 | 25653 kmem:mm_page_free ( +- 3.672% ) |
186 | 186 | ||
187 | 1.058135029 seconds time elapsed ( +- 3.089% ) | 187 | 1.058135029 seconds time elapsed ( +- 3.089% ) |
188 | 188 | ||