56 lines
1.2 KiB
Plaintext
56 lines
1.2 KiB
Plaintext
|
@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
|