1 kvm_stat(1)
2 ===========
3
4 NAME
5 ----
6 kvm_stat - Report KVM kernel module event coun
7
8 SYNOPSIS
9 --------
10 [verse]
11 'kvm_stat' [OPTION]...
12
13 DESCRIPTION
14 -----------
15 kvm_stat prints counts of KVM kernel module tr
16 state transitions such as guest mode entry and
17
18 This tool is useful for observing guest behavi
19 Often conclusions about performance or buggy b
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
25 The set of KVM kernel module trace events may
26 or architecture. It is best to check the KVM
27 meaning of events.
28
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
61 -------
62 -1::
63 --once::
64 --batch::
65 run in batch mode for one second
66
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::
94 --log::
95 run in logging mode (like vmstat)
96
97
98 -L<file>::
99 --log-to-file=<file>::
100 like -l/--log, but logging to a file.
101
102 -p<pid>::
103 --pid=<pid>::
104 limit statistics to one virtual machin
105
106 -s::
107 --set-delay::
108 set delay between refreshs (value rang
109
110 -t::
111 --tracepoints::
112 retrieve statistics from tracepoints
113
114 -z::
115 --skip-zero-records::
116 omit records with all zeros in logging
117
118 SEE ALSO
119 --------
120 'perf'(1), 'trace-cmd'(1)
121
122 AUTHOR
123 ------
124 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.