perf/Documentation/perf-kvm.txt

1 perf-kvm(1)
5 ----
6 perf-kvm - Tool to trace/measure kvm guest os
9 --------
11 'perf kvm' [--host] [--guest] [--guestmount=<path>
12 	[--guestkallsyms=<path> --guestmodules=<path> | --guestvmlinux=<path>]]
13 	{top|record|report|diff|buildid-list} [<options>]
14 'perf kvm' [--host] [--guest] [--guestkallsyms=<path> --guestmodules=<path>
15 	| --guestvmlinux=<path>] {top|record|report|diff|buildid-list|stat} [<options>]
19 -----------
28   default behavior of perf kvm as --guest, so if neither --host nor --guest
29   is input, the perf data file name is perf.data.guest. If --host is input,
31   perf.data.host, please input --host --no-guest. The behaviors are shown as
33     Default('')         ->  perf.data.guest
34     --host              ->  perf.data.kvm
35     --guest             ->  perf.data.guest
36     --host --guest      ->  perf.data.kvm
37     --host --no-guest   ->  perf.data.host
45   'perf kvm buildid-list' to  display the buildids found in a perf data file,
49   was captured with --guestmount in perf kvm record.
54   of KVM events. Currently, vmexit, mmio (x86 only) and ioport (x86 only)
68 -------
69 -i::
70 --input=<path>::
71         Input file name, for the 'report', 'diff' and 'buildid-list' subcommands.
72 -o::
73 --output=<path>::
76 --host::
77         Collect host side performance profile.
78 --guest::
81 :GMEXAMPLECMD: kvm --host --guest
83 include::guest-files.txt[]
85 --stdio:: Use the stdio interface.
87 -v::
88 --verbose::
92 -------------------
93 --vcpu=<value>::
96 --event=<value>::
97        event to be analyzed. Possible values: vmexit, mmio (x86 only),
98        ioport (x86 only). (default: vmexit)
99 -k::
100 --key=<value>::
106 -p::
107 --pid=::
108     Analyze events only for given process ID(s) (comma separated list).
111 -----------------
112 -d::
113 --display::
116 -m::
117 --mmap-pages=::
119         specification in bytes with appended unit character - B/K/M/G.
120         The size is rounded up to the nearest power-of-two page value.
122 -a::
123 --all-cpus::
124         System-wide collection from all CPUs.
126 -p::
127 --pid=::
128     Analyze events only for given process ID(s) (comma separated list).
130 --vcpu=<value>::
134 --event=<value>::
136        mmio (x86 only), ioport (x86 only).
139 -k::
140 --key=<value>::
144 --duration=<value>::
145        Show events other than HLT (x86 only) or Wait state (s390 only)
148 --proc-map-timeout::
149 	When processing pre-existing threads /proc/XXX/mmap, it may take
155 --------
156 linkperf:perf-top[1], linkperf:perf-record[1], linkperf:perf-report[1],
157 linkperf:perf-diff[1], linkperf:perf-buildid-list[1],
158 linkperf:perf-stat[1]