s390x: add 2.6 compat machine
[qemu.git] / scripts / kvm / kvm_stat.texi
blob6ce00d80e7a0c4379894818e9f9675e4058bf1b4
1 @example
2 @c man begin SYNOPSIS
3 usage: kvm_stat [OPTION]...
4 @c man end
5 @end example
7 @c man begin DESCRIPTION
9 kvm_stat prints counts of KVM kernel module trace events.  These events signify
10 state transitions such as guest mode entry and exit.
12 This tool is useful for observing guest behavior from the host perspective.
13 Often conclusions about performance or buggy behavior can be drawn from the
14 output.
16 The set of KVM kernel module trace events may be specific to the kernel version
17 or architecture.  It is best to check the KVM kernel module source code for the
18 meaning of events.
20 Note that trace events are counted globally across all running guests.
22 @c man end
24 @c man begin OPTIONS
25 @table @option
26 @item -1, --once, --batch
27   run in batch mode for one second
28 @item -l, --log
29   run in logging mode (like vmstat)
30 @item -t, --tracepoints
31   retrieve statistics from tracepoints
32 @item -d, --debugfs
33   retrieve statistics from debugfs
34 @item -f, --fields=@var{fields}
35   fields to display (regex)
36 @item -h, --help
37   show help message
38 @end table
40 @c man end
42 @ignore
44 @setfilename kvm_stat
45 @settitle Report KVM kernel module event counters.
47 @c man begin AUTHOR
48 Stefan Hajnoczi <stefanha@redhat.com>
49 @c man end
51 @c man begin SEEALSO
52 perf(1), trace-cmd(1)
53 @c man end
55 @end ignore