]> git.proxmox.com Git - mirror_qemu.git/blob - scripts/kvm/kvm_stat.texi
Merge remote-tracking branch 'remotes/mst/tags/for_upstream' into staging
[mirror_qemu.git] / scripts / kvm / kvm_stat.texi
1 @example
2 @c man begin SYNOPSIS
3 usage: kvm_stat [OPTION]...
4 @c man end
5 @end example
6
7 @c man begin DESCRIPTION
8
9 kvm_stat prints counts of KVM kernel module trace events. These events signify
10 state transitions such as guest mode entry and exit.
11
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.
15
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.
19
20 Note that trace events are counted globally across all running guests.
21
22 @c man end
23
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
39
40 @c man end
41
42 @ignore
43
44 @setfilename kvm_stat
45 @settitle Report KVM kernel module event counters.
46
47 @c man begin AUTHOR
48 Stefan Hajnoczi <stefanha@redhat.com>
49 @c man end
50
51 @c man begin SEEALSO
52 perf(1), trace-cmd(1)
53 @c man end
54
55 @end ignore