diff options
author | Stefan Hajnoczi <stefanha@redhat.com> | 2015-03-02 17:29:07 -0600 |
---|---|---|
committer | Paolo Bonzini <pbonzini@redhat.com> | 2015-03-10 10:49:25 +0100 |
commit | 811c5727765eba00824c29a696350d4780d86c19 (patch) | |
tree | a05f27b46f8eabb638bd435f7d95ffeeeaa7c4a9 /scripts | |
parent | 9a7dcb711bdaf4082bf333dbecfeb729bbff1f8e (diff) | |
download | qemu-811c5727765eba00824c29a696350d4780d86c19.tar.gz qemu-811c5727765eba00824c29a696350d4780d86c19.tar.bz2 qemu-811c5727765eba00824c29a696350d4780d86c19.zip |
kvm_stat: add kvm_stat.1 man page
Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
Reviewed-by: Ademar Reis <areis@redhat.com>
Reviewed-by: Wei Huang <wei@redhat.com>
Message-Id: <1425338947-10296-3-git-send-email-stefanha@redhat.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Diffstat (limited to 'scripts')
-rw-r--r-- | scripts/kvm/kvm_stat.texi | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/scripts/kvm/kvm_stat.texi b/scripts/kvm/kvm_stat.texi new file mode 100644 index 0000000000..6ce00d80e7 --- /dev/null +++ b/scripts/kvm/kvm_stat.texi @@ -0,0 +1,55 @@ +@example +@c man begin SYNOPSIS +usage: kvm_stat [OPTION]... +@c man end +@end example + +@c man begin DESCRIPTION + +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 +output. + +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. + +@c man end + +@c man begin OPTIONS +@table @option +@item -1, --once, --batch + run in batch mode for one second +@item -l, --log + run in logging mode (like vmstat) +@item -t, --tracepoints + retrieve statistics from tracepoints +@item -d, --debugfs + retrieve statistics from debugfs +@item -f, --fields=@var{fields} + fields to display (regex) +@item -h, --help + show help message +@end table + +@c man end + +@ignore + +@setfilename kvm_stat +@settitle Report KVM kernel module event counters. + +@c man begin AUTHOR +Stefan Hajnoczi <stefanha@redhat.com> +@c man end + +@c man begin SEEALSO +perf(1), trace-cmd(1) +@c man end + +@end ignore |