| Paolo Bonzini | fd41b5a | 2016-05-24 10:41:15 +0200 | [diff] [blame] | 1 | kvm_stat(1) |
| 2 | =========== |
| 3 | |
| 4 | NAME |
| 5 | ---- |
| 6 | kvm_stat - Report KVM kernel module event counters |
| 7 | |
| 8 | SYNOPSIS |
| 9 | -------- |
| 10 | [verse] |
| 11 | 'kvm_stat' [OPTION]... |
| 12 | |
| 13 | DESCRIPTION |
| 14 | ----------- |
| 15 | kvm_stat prints counts of KVM kernel module trace events. These events signify |
| 16 | state transitions such as guest mode entry and exit. |
| 17 | |
| 18 | This tool is useful for observing guest behavior from the host perspective. |
| 19 | Often conclusions about performance or buggy behavior can be drawn from the |
| 20 | output. |
| 21 | |
| 22 | The set of KVM kernel module trace events may be specific to the kernel version |
| 23 | or architecture. It is best to check the KVM kernel module source code for the |
| 24 | meaning of events. |
| 25 | |
| Paolo Bonzini | fd41b5a | 2016-05-24 10:41:15 +0200 | [diff] [blame] | 26 | OPTIONS |
| 27 | ------- |
| 28 | -1:: |
| 29 | --once:: |
| 30 | --batch:: |
| 31 | run in batch mode for one second |
| 32 | |
| 33 | -l:: |
| 34 | --log:: |
| 35 | run in logging mode (like vmstat) |
| 36 | |
| 37 | -t:: |
| 38 | --tracepoints:: |
| 39 | retrieve statistics from tracepoints |
| 40 | |
| 41 | -d:: |
| 42 | --debugfs:: |
| 43 | retrieve statistics from debugfs |
| 44 | |
| Janosch Frank | f0cf040 | 2016-05-18 13:26:24 +0200 | [diff] [blame] | 45 | -p<pid>:: |
| 46 | --pid=<pid>:: |
| 47 | limit statistics to one virtual machine (pid) |
| 48 | |
| Paolo Bonzini | fd41b5a | 2016-05-24 10:41:15 +0200 | [diff] [blame] | 49 | -f<fields>:: |
| 50 | --fields=<fields>:: |
| 51 | fields to display (regex) |
| 52 | |
| 53 | -h:: |
| 54 | --help:: |
| 55 | show help message |
| 56 | |
| 57 | SEE ALSO |
| 58 | -------- |
| 59 | 'perf'(1), 'trace-cmd'(1) |
| 60 | |
| 61 | AUTHOR |
| 62 | ------ |
| 63 | Stefan Hajnoczi <stefanha@redhat.com> |