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.
61   handled sample, percent_sample, time, percent_time, max_t, min_t, mean_t.
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::
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>::
99 -k::
100 --key=<value>::
101        Sorting key. Possible values: sample (default, sort by samples
102        number), percent_sample (sort by sample percentage), time
103        (sort by average time), precent_time (sort by time percentage),
106 -p::
107 --pid=::
111 -----------------
112 -d::
113 --display::
116 -m::
117 --mmap-pages=::
118         Number of mmap data pages (must be a power of two) or size
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=::
130 --vcpu=<value>::
134 --event=<value>::
139 -k::
140 --key=<value>::
141        Sorting key. Possible values: sample (default, sort by samples
142        number), time (sort by average time).
144 --duration=<value>::
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]