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