1 kvm_stat(1) 1 kvm_stat(1)
2 =========== 2 ===========
3 3
4 NAME 4 NAME
5 ---- 5 ----
6 kvm_stat - Report KVM kernel module event coun 6 kvm_stat - Report KVM kernel module event counters
7 7
8 SYNOPSIS 8 SYNOPSIS
9 -------- 9 --------
10 [verse] 10 [verse]
11 'kvm_stat' [OPTION]... 11 'kvm_stat' [OPTION]...
12 12
13 DESCRIPTION 13 DESCRIPTION
14 ----------- 14 -----------
15 kvm_stat prints counts of KVM kernel module tr 15 kvm_stat prints counts of KVM kernel module trace events. These events signify
16 state transitions such as guest mode entry and 16 state transitions such as guest mode entry and exit.
17 17
18 This tool is useful for observing guest behavi 18 This tool is useful for observing guest behavior from the host perspective.
19 Often conclusions about performance or buggy b 19 Often conclusions about performance or buggy behavior can be drawn from the
20 output. 20 output.
21 While running in regular mode, use any of the <<
22 'Interactive Commands' below. <<
23 Use batch and logging modes for scripting purp <<
24 21
25 The set of KVM kernel module trace events may 22 The set of KVM kernel module trace events may be specific to the kernel version
26 or architecture. It is best to check the KVM 23 or architecture. It is best to check the KVM kernel module source code for the
27 meaning of events. 24 meaning of events.
28 25
29 INTERACTIVE COMMANDS <<
30 -------------------- <<
31 [horizontal] <<
32 *b*:: toggle events by guests (debugfs only, <<
33 <<
34 *c*:: clear filter <<
35 <<
36 *f*:: filter by regular expression <<
37 :: *Note*: Child events pull in their par <<
38 all child events, not just the <<
39 <<
40 *g*:: filter by guest name/PID <<
41 <<
42 *h*:: display interactive commands reference <<
43 <<
44 *o*:: toggle sorting order (Total vs CurAvg/ <<
45 <<
46 *p*:: filter by guest name/PID <<
47 <<
48 *q*:: quit <<
49 <<
50 *r*:: reset stats <<
51 <<
52 *s*:: set delay between refreshs <<
53 <<
54 *x*:: toggle reporting of stats for child tr <<
55 :: *Note*: The stats for the parents summ <<
56 events <<
57 <<
58 Press any other key to refresh statistics imme <<
59 <<
60 OPTIONS 26 OPTIONS
61 ------- 27 -------
62 -1:: 28 -1::
63 --once:: 29 --once::
64 --batch:: 30 --batch::
65 run in batch mode for one second 31 run in batch mode for one second
66 32
67 -c:: <<
68 --csv:: <<
69 log in csv format. Requires option -l/ <<
70 When used with option -L/--log-to-file <<
71 written to start of file to preserve t <<
72 <<
73 -d:: <<
74 --debugfs:: <<
75 retrieve statistics from debugfs <<
76 <<
77 -f<fields>:: <<
78 --fields=<fields>:: <<
79 fields to display (regex), "-f help" f <<
80 <<
81 -g<guest>:: <<
82 --guest=<guest_name>:: <<
83 limit statistics to one virtual machin <<
84 <<
85 -h:: <<
86 --help:: <<
87 show help message <<
88 <<
89 -i:: <<
90 --debugfs-include-past:: <<
91 include all available data on past eve <<
92 <<
93 -l:: 33 -l::
94 --log:: 34 --log::
95 run in logging mode (like vmstat) !! 35 run in logging mode (like vmstat)
96 36
>> 37 -t::
>> 38 --tracepoints::
>> 39 retrieve statistics from tracepoints
97 40
98 -L<file>:: !! 41 -d::
99 --log-to-file=<file>:: !! 42 --debugfs::
100 like -l/--log, but logging to a file. !! 43 retrieve statistics from debugfs
101 44
102 -p<pid>:: 45 -p<pid>::
103 --pid=<pid>:: 46 --pid=<pid>::
104 limit statistics to one virtual machin 47 limit statistics to one virtual machine (pid)
105 48
106 -s:: !! 49 -f<fields>::
107 --set-delay:: !! 50 --fields=<fields>::
108 set delay between refreshs (value rang !! 51 fields to display (regex)
109 <<
110 -t:: <<
111 --tracepoints:: <<
112 retrieve statistics from tracepoints <<
113 52
114 -z:: !! 53 -h::
115 --skip-zero-records:: !! 54 --help::
116 omit records with all zeros in logging !! 55 show help message
117 56
118 SEE ALSO 57 SEE ALSO
119 -------- 58 --------
120 'perf'(1), 'trace-cmd'(1) 59 'perf'(1), 'trace-cmd'(1)
121 60
122 AUTHOR 61 AUTHOR
123 ------ 62 ------
124 Stefan Hajnoczi <stefanha@redhat.com> 63 Stefan Hajnoczi <stefanha@redhat.com>
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.