xref: /illumos-gate/usr/src/man/man1/kvmstat.1 (revision bbf21555)
1.\"
2.\" This file and its contents are supplied under the terms of the
3.\" Common Development and Distribution License ("CDDL"), version 1.0.
4.\" You may only use this file in accordance with the terms of version
5.\" 1.0 of the CDDL.
6.\"
7.\" A full copy of the text of the CDDL should have accompanied this
8.\" source.  A copy of the CDDL is also available via the Internet at
9.\" http://www.illumos.org/license/CDDL.
10.\"
11.\"
12.\" Copyright (c) 2014, Joyent, Inc.
13.\"
14.Dd Dec 20, 2014
15.Dt KVMSTAT 1
16.Os
17.Sh NAME
18.Nm kvmstat
19.Nd report KVM statistics
20.Sh SYNOPSIS
21.Nm kvmstat
22.Oo
23.Ar interval
24.Op Ar count
25.Oc
26.Sh DESCRIPTION
27.Nm
28reports the activity of running KVM virtual machines and their exit activity,
29injected interrupts, emulations, and more, on a per virtual CPU basis.
30.Lp
31.Nm
32should be used when trying to get a rough sense of guest activity from the
33hypervisor's perspective, and allows one to understand from a low-level
34perspective, what kind of activity is going on inside of the virtual machine.
35In addition,
36.Nm
37is useful for diagnosing reports of pathological or faulty behavior inside of
38guests.
39While there is no expected range of values for the fields displayed as that
40varies with the use of virtual machines, if all of the virtual CPUs for a given
41virtual machine are consistently zero, then that may indicate that a problem has
42occurred, for example, a panic inside of the guest or a bug in the hypervisor.
43.Lp
44If no operands are specified, then
45.Nm
46will display statistics every second until the program is terminated.
47.Ss Output Fields
48Every
49.Ar interval
50.Nm
51will report data with the following fields:
52.Bl -tag -width Ds
53.It Nm pid
54Identifier of the process controlling the virtual CPU.
55.It Nm vcpu
56Virtual CPU identifier relative to its virtual machine.
57.It Nm exits
58Count of all virtual machine exits for the virtual CPU over
59.Ar interval .
60.It Nm haltx
61Count of virtual machine exits due to the guest executing the
62.Sy HLT
63instruction for the virtual CPU over
64.Ar interval .
65.It Nm irqx
66Count of virtual machine exits due to a pending external interrupt arriving
67on the physical CPU that the virtual CPU was actively running on over
68.Ar interval .
69.It Nm irqwx
70Count of virtual machine exits due to an open interrupt window on the
71virtual CPU over
72.Ar interval .
73.It Nm iox
74Count of virtual machine exits due to the execution of an I/O instruction,
75such as
76.Sy inb ,
77on the virtual CPU over
78.Ar interval .
79.It Nm mmiox
80Count of virtual machine exits due to performing memory mapped I/O on the
81virtual CPU over
82.Ar interval .
83.It Nm irqs
84Count of interrupts injected into the virtual CPU over
85.Ar interval .
86.It Nm emul
87Count of instructions the hypervisor had to emulate on behalf of the guest
88virtual CPU over
89.Ar interval .
90.It Nm eptv
91Count of extended page table violations serviced on the virtual CPU over
92.Ar interval .
93.El
94.Sh OPERANDS
95The following operands are supported:
96.Bl -hang -width Ds
97.It Ar count
98.Bd -filled -compact
99Specifies the number of times that the statistics are repeated.
100If not specified,
101.Nm
102will continue until it is terminated.
103.Ed
104.It Ar interval
105.Bd -filled -compact
106Specifies the number of seconds between reports of statistics.
107If not specified, reports are generated every second.
108.Ed
109.El
110.Sh STABILITY
111The arguments are
112.Sy committed ,
113while the output format is
114.Sy Not an interface .
115.Sh SEE ALSO
116.Xr attributes 7 ,
117.Xr iostat 8 ,
118.Xr mpstat 8
119