perf/Documentation/perf-kvm.txt

1 perf-kvm(1)
6 perf-kvm - Tool to trace/measure kvm guest os
11 'perf kvm' [--host] [--guest] [--guestmount=<path>
14 'perf kvm' [--host] [--guest] [--guestkallsyms=<path> --guestmodules=<path>
16 'perf kvm stat [record|report|live] [<options>]
20 There are a couple of variants of perf kvm:
22   'perf kvm [options] top <command>' to generates and displays
26   'perf kvm record <command>' to record the performance counter profile
27   of an arbitrary workload and save it into a perf data file. We set the
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,
30   the perf data file name is perf.data.kvm. If you want to record data into
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
39   'perf kvm report' to display the performance counter profile information
40   recorded via perf kvm record.
42   'perf kvm diff' to displays the performance difference amongst two perf.data
43   files captured via perf record.
45   'perf kvm buildid-list' to  display the buildids found in a perf data file,
47   for use by perf report. As buildid is read from /sys/kernel/notes in os, then
48   if you want to list the buildid for guest, please make sure your perf data file
49   was captured with --guestmount in perf kvm record.
51   'perf kvm stat <command>' to run a command and gather performance counter
53   Especially, perf 'kvm stat record/report' generates a statistical analysis
55   events are supported. 'perf kvm stat record <command>' records kvm events
60   'perf kvm stat report' reports statistical data which includes events
63   'perf kvm stat live' reports statistical data in a live mode (similar to
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]