Root/
1 | perf-kvm(1) |
2 | =========== |
3 | |
4 | NAME |
5 | ---- |
6 | perf-kvm - Tool to trace/measure kvm guest os |
7 | |
8 | SYNOPSIS |
9 | -------- |
10 | [verse] |
11 | 'perf kvm' [--host] [--guest] [--guestmount=<path> |
12 | [--guestkallsyms=<path> --guestmodules=<path> | --guestvmlinux=<path>]] |
13 | {top|record|report|diff|buildid-list} |
14 | 'perf kvm' [--host] [--guest] [--guestkallsyms=<path> --guestmodules=<path> |
15 | | --guestvmlinux=<path>] {top|record|report|diff|buildid-list} |
16 | |
17 | DESCRIPTION |
18 | ----------- |
19 | There are a couple of variants of perf kvm: |
20 | |
21 | 'perf kvm [options] top <command>' to generates and displays |
22 | a performance counter profile of guest os in realtime |
23 | of an arbitrary workload. |
24 | |
25 | 'perf kvm record <command>' to record the performance counter profile |
26 | of an arbitrary workload and save it into a perf data file. If both |
27 | --host and --guest are input, the perf data file name is perf.data.kvm. |
28 | If there is no --host but --guest, the file name is perf.data.guest. |
29 | If there is no --guest but --host, the file name is perf.data.host. |
30 | |
31 | 'perf kvm report' to display the performance counter profile information |
32 | recorded via perf kvm record. |
33 | |
34 | 'perf kvm diff' to displays the performance difference amongst two perf.data |
35 | files captured via perf record. |
36 | |
37 | 'perf kvm buildid-list' to display the buildids found in a perf data file, |
38 | so that other tools can be used to fetch packages with matching symbol tables |
39 | for use by perf report. |
40 | |
41 | OPTIONS |
42 | ------- |
43 | -i:: |
44 | --input=:: |
45 | Input file name. |
46 | -o:: |
47 | --output:: |
48 | Output file name. |
49 | --host=:: |
50 | Collect host side performance profile. |
51 | --guest=:: |
52 | Collect guest side performance profile. |
53 | --guestmount=<path>:: |
54 | Guest os root file system mount directory. Users mounts guest os |
55 | root directories under <path> by a specific filesystem access method, |
56 | typically, sshfs. For example, start 2 guest os. The one's pid is 8888 |
57 | and the other's is 9999. |
58 | #mkdir ~/guestmount; cd ~/guestmount |
59 | #sshfs -o allow_other,direct_io -p 5551 localhost:/ 8888/ |
60 | #sshfs -o allow_other,direct_io -p 5552 localhost:/ 9999/ |
61 | #perf kvm --host --guest --guestmount=~/guestmount top |
62 | --guestkallsyms=<path>:: |
63 | Guest os /proc/kallsyms file copy. 'perf' kvm' reads it to get guest |
64 | kernel symbols. Users copy it out from guest os. |
65 | --guestmodules=<path>:: |
66 | Guest os /proc/modules file copy. 'perf' kvm' reads it to get guest |
67 | kernel module information. Users copy it out from guest os. |
68 | --guestvmlinux=<path>:: |
69 | Guest os kernel vmlinux. |
70 | |
71 | SEE ALSO |
72 | -------- |
73 | linkperf:perf-top[1], linkperf:perf-record[1], linkperf:perf-report[1], |
74 | linkperf:perf-diff[1], linkperf:perf-buildid-list[1] |
75 |
Branches:
ben-wpan
ben-wpan-stefan
javiroman/ks7010
jz-2.6.34
jz-2.6.34-rc5
jz-2.6.34-rc6
jz-2.6.34-rc7
jz-2.6.35
jz-2.6.36
jz-2.6.37
jz-2.6.38
jz-2.6.39
jz-3.0
jz-3.1
jz-3.11
jz-3.12
jz-3.13
jz-3.15
jz-3.16
jz-3.18-dt
jz-3.2
jz-3.3
jz-3.4
jz-3.5
jz-3.6
jz-3.6-rc2-pwm
jz-3.9
jz-3.9-clk
jz-3.9-rc8
jz47xx
jz47xx-2.6.38
master
Tags:
od-2011-09-04
od-2011-09-18
v2.6.34-rc5
v2.6.34-rc6
v2.6.34-rc7
v3.9