path: root/tools/kvm/kvm_stat/kvm_stat.txt
diff options
authorPaolo Bonzini <>2016-05-24 10:41:15 +0200
committerPaolo Bonzini <>2016-05-25 16:12:03 +0200
commitfd41b5a96948f67785458c04e9ddb5ef619251d5 (patch)
treeeb7b748e7f11ec14656544fed9f1fd2a386c2a92 /tools/kvm/kvm_stat/kvm_stat.txt
parentf9bc9e65fbec1781f64effc6bcc3b6edc57f8d19 (diff)
tools: Add kvm_stat man page
Converted from the Texinfo source in QEMU to asciidoc. The a2x incantation was provided by Janosch Frank. Signed-off-by: Paolo Bonzini <>
Diffstat (limited to 'tools/kvm/kvm_stat/kvm_stat.txt')
1 files changed, 61 insertions, 0 deletions
diff --git a/tools/kvm/kvm_stat/kvm_stat.txt b/tools/kvm/kvm_stat/kvm_stat.txt
new file mode 100644
index 000000000000..8dcb48aaca50
--- /dev/null
+++ b/tools/kvm/kvm_stat/kvm_stat.txt
@@ -0,0 +1,61 @@
+kvm_stat - Report KVM kernel module event counters
+'kvm_stat' [OPTION]...
+kvm_stat prints counts of KVM kernel module trace events. These events signify
+state transitions such as guest mode entry and exit.
+This tool is useful for observing guest behavior from the host perspective.
+Often conclusions about performance or buggy behavior can be drawn from the
+The set of KVM kernel module trace events may be specific to the kernel version
+or architecture. It is best to check the KVM kernel module source code for the
+meaning of events.
+Note that trace events are counted globally across all running guests.
+ run in batch mode for one second
+ run in logging mode (like vmstat)
+ retrieve statistics from tracepoints
+ retrieve statistics from debugfs
+ fields to display (regex)
+ show help message
+'perf'(1), 'trace-cmd'(1)
+Stefan Hajnoczi <>