PERF-KVM(1)                       perf Manual                      PERF-KVM(1)

<?><?><?> (NAME)
       perf-kvm - <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> kvm

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       perf kvm [--host] [--guest] [--guestmount=<path>
               [--guestkallsyms=<path> --guestmodules=<path> | --guestvmlinux=<path>]]
               {top|record|report|diff|buildid-list} [<options>]
       perf kvm [--host] [--guest] [--guestkallsyms=<path> --guestmodules=<path>
               | --guestvmlinux=<path>] {top|record|report|diff|buildid-list|stat} [<options>]
       'perf kvm stat [record|report|live] [<options>]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> perf kvm <?><?><?><?> <?><?><?><?>:

           <?><?><?><?><?> 'perf kvm [options] top <command>' <?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?> 'perf kvm record <command>' <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> perf. <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> perf kvm <?><?><?><?><?><?><?> --guest <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           --host <?><?> --guest <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> perf <?><?><?><?><?> <?><?> perf.data.guest <?><?><?><?><?> <?><?><?>.
           <?><?><?> --host <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> perf.data.kvm <?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> perf.data.host <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> --host --no-guest <?><?> <?><?><?><?> <?><?><?><?>.
           <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>:
             Default('')         ->  perf.data.guest
             --host              ->  perf.data.kvm
             --guest             ->  perf.data.guest
             --host --guest      ->  perf.data.kvm
             --host --no-guest   ->  perf.data.host

           <?><?><?><?><?> 'perf kvm report' <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> perf kvm record.

           <?><?><?><?><?> 'perf kvm diff' <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> perf.data
           <?><?><?><?><?><?><?> <?><?><?><?> perf record.

           <?><?><?><?><?> 'perf kvm buildid-list' <?><?><?><?> <?><?><?><?><?> buildid<?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> perf<?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> perf report <?><?><?><?><?><?> <?><?><?><?>. <?><?> <?><?><?><?> <?><?> buildid <?><?> <?><?><?><?> /sys/kernel/notes
           <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> buildid <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> perf <?><?><?> <?><?> <?><?><?><?><?><?> --guestmount <?><?> perf kvm record
           <?><?><?> <?><?><?> <?><?><?><?>.

           <?><?><?><?><?> 'perf kvm stat <command>' <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> 'perf kvm stat record/report' <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> KVM
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> vmexit<?> mmio (<?><?><?> x86) <?> ioport
           (<?><?><?> x86) <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?> 'perf kvm stat record <command>'
           <?><?><?><?><?><?><?><?><?> kvm <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?> <command> <?><?> <?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> kvm <?><?><?>.

           <?><?><?><?><?> 'perf kvm stat report' <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
           sample<?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> percent_sample<?> time<?> percent_time<?> max_t<?> min_t <?> mean_t <?><?><?>.

           <?><?><?><?><?> 'perf kvm stat live' <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?>
           record + report <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>).

       -i, --input=<path>
           <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> report<?> diff <?>
           buildid-list.

       -o, --output=<path>
           <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> record.  <?><?> report <?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?> report <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       --host
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?> <?><?><?><?><?><?> (host).

       --guest
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?> <?><?><?><?><?> (guest).

       --guestmount=<path>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>.
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> sshfs<?> <?><?> <path> <?><?><?><?>
           <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> pid <?><?><?> 8888 <?> <?><?><?><?><?> 9999
           <?><?><?>:

               $ mkdir ~/guestmount
               $ cd ~/guestmount
               $ sshfs -o allow_other,direct_io -p 5551 localhost:/ 8888/
               $ sshfs -o allow_other,direct_io -p 5552 localhost:/ 9999/
               $ perf kvm --host --guest --guestmount=~/guestmount top

       --guestkallsyms=<path>
           <?><?><?><?><?><?> <?><?><?><?> /proc/kallsyms
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?>
           perf <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?>.

       --guestmodules=<path>
           <?><?><?><?><?><?> <?><?><?><?> /proc/modules
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?>
           perf <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?>
           <?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?> <?><?><?><?><?><?><?>.

       --guestvmlinux=<path>
           <?><?><?><?> vmlinux <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?>.

       --guest-code
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?><?> (hypervisor) <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> KVM <?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?>.

       --stdio
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> stdio.

       -v, --verbose
           <?><?><?><?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?>
           <?><?><?><?>).

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (STAT REPORT
       OPTIONS)
       --vcpu=<value>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?> vcpu <?><?> <?><?><?><?><?><?><?>.
           (<?><?><?><?><?><?><?>: <?><?><?><?> vcpu<?><?>)

       --event=<value>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?>. <?><?><?><?><?><?> <?><?><?><?>: vmexit<?> mmio
           (<?><?><?> <?><?> x86)<?> ioport (<?><?><?> <?><?> x86).
           (<?><?><?><?><?><?><?>: vmexit)

       -k, --key=<value>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?>
           <?><?><?><?>: sample (<?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?>)<?> percent_sample
           (<?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?>)<?> time (<?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>)<?> precent_time
           (<?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?>)<?> max_t (<?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>)<?> min_t
           (<?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?>)<?> mean_t (<?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>).

       -p, --pid=
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?>(<?><?><?>) <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> (<?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?>).

           -d, --display
               <?><?><?><?> <?><?><?>
               <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
               <?><?> <?><?><?> <?><?><?><?><?>.

           -m, --mmap-pages=
               <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> mmap (<?><?><?><?>
               <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>) <?><?>
               <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
               <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?><?><?><?><?> - B/K/M/G. <?><?><?>
               <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
               <?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
               <?><?><?><?><?><?>.

           -a, --all-cpus
               <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
               <?><?><?><?><?> <?><?> <?><?><?><?> CPU<?><?>.

           -p, --pid=
               <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
               <?><?><?><?> <?><?><?><?><?>(<?><?><?>) <?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?> (<?><?><?><?><?> <?><?><?><?><?><?>
               <?><?> <?><?><?><?><?><?>).

           --vcpu=<value>
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
               <?><?><?> vcpu <?><?> <?><?><?><?><?><?><?>.
               (<?><?><?><?><?><?><?>: <?><?><?><?> vcpu<?><?>)

           --event=<value>
               <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?>. <?><?><?><?><?><?> <?><?><?><?>: vmexit<?> mmio
               (<?><?><?> x86)<?> ioport (<?><?><?> x86).
               (<?><?><?><?><?><?><?>: vmexit)

           -k, --key=<value>
               <?><?><?><?> <?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?>
               <?><?><?><?>: sample (<?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?><?>)<?> time (<?><?><?><?><?><?><?><?><?>
               <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>).

           --duration=<value>
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
               HLT (<?><?><?> x86) <?><?> <?><?><?><?> Wait (<?><?><?> s390)
               <?><?> <?><?><?> <?><?> duration <?><?><?><?><?><?><?><?><?><?>
               <?><?><?> <?><?><?><?><?><?><?>.

           --proc-map-timeout
               <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
               <?><?> <?><?><?> <?><?><?><?><?> <?><?> /proc/XXX/mmap<?>
               <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
               <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?><?><?> <?><?><?><?>. <?><?> <?><?><?><?>
               <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
               (timeout) <?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?>
               <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
               <?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?> <?><?><?><?><?><?><?><?><?><?> (500 ms) <?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       perf-top(1), perf-record(1), perf-report(1), perf-diff(1), perf-
       buildid-list(1), perf-stat(1)

perf                              09/04/2026                       PERF-KVM(1)