libvirt/src
Eric Blake 3937ef9cf4 getstats: crawl backing chain for qemu
Wire up backing chain recursion.  For the first time, it is now
possible to get libvirt to expose that qemu tracks read statistics
on backing files, as well as report maximum extent written on a
backing file during a block-commit operation.

For a running domain, where one of the two images has a backing
file, I see the traditional output:

$ virsh domstats --block testvm2
Domain: 'testvm2'
  block.count=2
  block.0.name=vda
  block.0.path=/tmp/wrapper.qcow2
  block.0.rd.reqs=1
  block.0.rd.bytes=512
  block.0.rd.times=28858
  block.0.wr.reqs=0
  block.0.wr.bytes=0
  block.0.wr.times=0
  block.0.fl.reqs=0
  block.0.fl.times=0
  block.0.allocation=0
  block.0.capacity=1310720000
  block.0.physical=200704
  block.1.name=vdb
  block.1.path=/dev/sda7
  block.1.rd.reqs=0
  block.1.rd.bytes=0
  block.1.rd.times=0
  block.1.wr.reqs=0
  block.1.wr.bytes=0
  block.1.wr.times=0
  block.1.fl.reqs=0
  block.1.fl.times=0
  block.1.allocation=0
  block.1.capacity=1310720000

vs. the new output:

$ virsh domstats --block --backing testvm2
Domain: 'testvm2'
  block.count=3
  block.0.name=vda
  block.0.path=/tmp/wrapper.qcow2
  block.0.rd.reqs=1
  block.0.rd.bytes=512
  block.0.rd.times=28858
  block.0.wr.reqs=0
  block.0.wr.bytes=0
  block.0.wr.times=0
  block.0.fl.reqs=0
  block.0.fl.times=0
  block.0.allocation=0
  block.0.capacity=1310720000
  block.0.physical=200704
  block.1.name=vda
  block.1.path=/dev/sda6
  block.1.backingIndex=1
  block.1.rd.reqs=0
  block.1.rd.bytes=0
  block.1.rd.times=0
  block.1.wr.reqs=0
  block.1.wr.bytes=0
  block.1.wr.times=0
  block.1.fl.reqs=0
  block.1.fl.times=0
  block.1.allocation=327680
  block.1.capacity=786432000
  block.2.name=vdb
  block.2.path=/dev/sda7
  block.2.rd.reqs=0
  block.2.rd.bytes=0
  block.2.rd.times=0
  block.2.wr.reqs=0
  block.2.wr.bytes=0
  block.2.wr.times=0
  block.2.fl.reqs=0
  block.2.fl.times=0
  block.2.allocation=0
  block.2.capacity=1310720000

I may later do a patch that trims the output to avoid 0 stats,
particularly for backing files (which are more likely to have
0 stats, at least for write statistics when no block-commit
is performed).  Also, I still plan to expose physical size
information (qemu doesn't expose it yet, so it requires a stat,
and for block devices, a further open/seek operation).  But
this patch is good enough without worrying about that yet.

* src/qemu/qemu_driver.c (QEMU_DOMAIN_STATS_BACKING): New internal
enum bit.
(qemuConnectGetAllDomainStats): Recognize new user flag, and pass
details to...
(qemuDomainGetStatsBlock): ...here, where we can do longer recursion.
(qemuDomainGetStatsOneBlock): Output new field.

Signed-off-by: Eric Blake <eblake@redhat.com>
2014-12-17 02:07:44 -07:00
..
access build: fix mingw printing of pid 2014-12-08 15:01:24 -07:00
bhyve drvbhyve: Automatically tear down guest domains on shutdown 2014-12-04 11:03:13 +01:00
conf conf: Fix invalid condition when parsing storage owner 2014-12-16 19:51:34 +01:00
cpu cpu: fix possible crash in getModels 2014-12-03 19:17:05 +01:00
esx Replace virDomainFree with virObjectUnref 2014-12-02 11:03:40 -05:00
hyperv Replace virDomainFree with virObjectUnref 2014-12-02 11:03:40 -05:00
interface Replace virInterfaceFree with virObjectUnref 2014-12-02 11:03:41 -05:00
libxl Replace virNetworkFree with virObjectUnref 2014-12-02 11:03:40 -05:00
locking virstoragefile: Have virStorageFileResize use safezero 2014-12-16 13:11:35 -05:00
lxc virconf: Introduce VIR_CONF_ULONG 2014-12-15 10:34:18 +01:00
network network: setup bridge devices for macTableManager='libvirt' 2014-12-08 14:47:06 -05:00
node_device avoid using deprecated udev logging functions 2014-12-15 18:08:45 +00:00
nwfilter Replace virNWFilterFree with virObjectUnref 2014-12-02 11:03:41 -05:00
openvz Fix usage of virReportSystemError 2014-11-28 09:42:13 +01:00
parallels parallels: fix usage of disk->info.addr.drive structure 2014-12-15 17:20:45 +01:00
phyp Remove unnecessary curly brackets in rest of src/[o-u]*/ 2014-11-14 17:13:36 +01:00
qemu getstats: crawl backing chain for qemu 2014-12-17 02:07:44 -07:00
remote Replace virDomainSnapshotFree with virObjectUnref 2014-12-02 11:03:41 -05:00
rpc rpc: Report proper close reason 2014-12-08 13:03:49 +01:00
secret Replace virSecretFree with virObjectUnref 2014-12-02 11:03:41 -05:00
security Fix build on mingw 2014-12-11 11:13:43 +01:00
storage virstoragefile: Have virStorageFileResize use safezero 2014-12-16 13:11:35 -05:00
test maint: forbid 'int foo = true' 2014-11-19 08:20:39 -07:00
uml Replace virNetworkFree with virObjectUnref 2014-12-02 11:03:40 -05:00
util qemu: let blockinfo reuse virStorageSource 2014-12-16 16:05:47 -07:00
vbox Replace virDomainFree with virObjectUnref 2014-12-02 11:03:40 -05:00
vmware Remove unnecessary curly brackets in rest of src/ 2014-11-14 17:13:36 +01:00
vmx Remove unnecessary curly brackets in src/vmx/vmx.c 2014-11-14 17:13:00 +01:00
xen video: cleanup usage of vram attribute and update documentation 2014-11-24 22:05:55 +01:00
xenapi Remove unnecessary curly brackets in rest of src/ 2014-11-14 17:13:36 +01:00
xenconfig xenconfig: fix boot device parsing 2014-12-15 08:42:02 -05:00
check-aclperms.pl
check-aclrules.pl maint: fix line numbers in check-aclrules reports 2014-02-10 14:07:22 -07:00
check-driverimpls.pl
check-drivername.pl
check-symfile.pl
check-symsorting.pl
datatypes.c Remove unnecessary curly brackets in rest of src/[a-n]*/ 2014-11-14 17:13:36 +01:00
datatypes.h Move virDomainSnapshot related APIs out of libvirt.c 2014-10-24 15:59:22 +01:00
driver-hypervisor.h Implement public API for virDomainGetFSInfo 2014-11-24 10:02:08 -05:00
driver-interface.h Split driver.h into multiple parts 2014-10-23 11:10:05 +01:00
driver-network.h Split driver.h into multiple parts 2014-10-23 11:10:05 +01:00
driver-nodedev.h Split driver.h into multiple parts 2014-10-23 11:10:05 +01:00
driver-nwfilter.h Split driver.h into multiple parts 2014-10-23 11:10:05 +01:00
driver-secret.h Split driver.h into multiple parts 2014-10-23 11:10:05 +01:00
driver-state.h Split driver.h into multiple parts 2014-10-23 11:10:05 +01:00
driver-storage.h Split driver.h into multiple parts 2014-10-23 11:10:05 +01:00
driver-stream.h Split driver.h into multiple parts 2014-10-23 11:10:05 +01:00
driver.c Remove unnecessary curly brackets in rest of src/[a-n]*/ 2014-11-14 17:13:36 +01:00
driver.h Split driver.h into multiple parts 2014-10-23 11:10:05 +01:00
dtrace2systemtap.pl
fdstream.c Replace virStreamFree with virObjectUnref 2014-12-02 11:03:41 -05:00
fdstream.h fdstream: introduce virFDStreamOpenBlockDevice 2014-08-25 10:46:13 +04:00
gnutls_1_0_compat.h
internal.h internal: add macro to round value to the next closest power of 2 2014-11-24 22:05:55 +01:00
libvirt_atomic.syms
libvirt_daemon.syms
libvirt_driver_modules.syms Use virFileFindResource to locate driver plugins 2014-04-25 11:59:46 +01:00
libvirt_esx.syms
libvirt_gnutls.syms
libvirt_internal.h Make virTypedParameterValidateSet non-static 2014-10-24 16:54:48 +01:00
libvirt_libssh2.syms
libvirt_linux.syms util: virstatslinux: make more generic 2014-07-15 22:00:59 +04:00
libvirt_lxc.syms
libvirt_openvz.syms
libvirt_private.syms conf: Rework virDomainObjListFindByUUID to allow more concurrent APIs 2014-12-16 15:50:49 +01:00
libvirt_probes.d
libvirt_public.syms Implement public API for virDomainGetFSInfo 2014-11-24 10:02:08 -05:00
libvirt_qemu_probes.d
libvirt_qemu.syms qemu: new API for tracking arbitrary monitor events 2014-03-20 11:25:37 -06:00
libvirt_remote.syms remote: create virNetServerServiceNewFDOrUNIX() wrapper 2014-08-22 09:12:13 +02:00
libvirt_sasl.syms
libvirt_vmware.syms
libvirt_vmx.syms
libvirt_xenconfig.syms xen: rename xenxs to xenconfig 2014-08-18 20:36:24 -06:00
libvirt-domain-snapshot.c Move virDomainSnapshot related APIs out of libvirt.c 2014-10-24 15:59:22 +01:00
libvirt-domain.c getstats: add new flag for block backing chain 2014-12-17 01:41:38 -07:00
libvirt-host.c Move virConnect/virNode related APIs out of libvirt.c 2014-10-24 16:59:58 +01:00
libvirt-interface.c Move virInterface related APIs out of libvirt.c 2014-10-24 16:08:28 +01:00
libvirt-lxc.c Remove unnecessary curly brackets in rest of src/[a-n]*/ 2014-11-14 17:13:36 +01:00
libvirt-lxc.pc.in Fix build-time pkg-config files in VPATH 2014-11-06 15:59:28 +01:00
libvirt-network.c Move virNetwork related APIs out of libvirt.c 2014-10-24 16:00:21 +01:00
libvirt-nodedev.c Remove unnecessary curly brackets in rest of src/[a-n]*/ 2014-11-14 17:13:36 +01:00
libvirt-nwfilter.c Move virNWFilter related APIs out of libvirt.c 2014-10-24 16:15:46 +01:00
libvirt-qemu.c Indent top-level labels by one space in the rest of src/ 2014-03-25 14:58:40 +01:00
libvirt-qemu.pc.in Fix build-time pkg-config files in VPATH 2014-11-06 15:59:28 +01:00
libvirt-secret.c Move virSecret related APIs out of libvirt.c 2014-10-24 16:39:05 +01:00
libvirt-storage.c Remove unnecessary curly brackets in rest of src/[a-n]*/ 2014-11-14 17:13:36 +01:00
libvirt-stream.c Move virStream related APIs out of libvirt.c 2014-10-24 16:42:49 +01:00
libvirt.c libvirt.c: Move virDomainGetFSInfo to libvirt-domain.c 2014-12-02 13:49:50 +01:00
libvirt.conf
libvirt.pc.in Fix build-time pkg-config files in VPATH 2014-11-06 15:59:28 +01:00
lock_protocol-structs
lxc_monitor_protocol-structs
lxc_protocol-structs
Makefile.am network: Bring netdevs online later 2014-12-10 15:09:01 -05:00
nodeinfo.c nodeinfo: report error when failure in nodeSetMemoryParameters 2014-11-10 15:06:57 +01:00
nodeinfo.h nodeinfo: Implement nodeAllocPages 2014-09-25 10:24:45 +02:00
nodeinfopriv.h nodeinfo: Introduce @arch to linuxNodeInfoCPUPopulate 2014-06-20 15:46:52 +02:00
qemu_protocol-structs qemu: wire up RPC for qemu monitor events 2014-03-20 11:25:37 -06:00
README bhyve: add basic documentation 2014-03-01 23:44:58 +04:00
remote_protocol-structs remote: Implement the remote protocol for virDomainGetFSInfo 2014-11-24 10:04:32 -05:00
virkeepaliveprotocol-structs
virnetprotocol-structs

       libvirt library code README
       ===========================

The directory provides the bulk of the libvirt codebase. Everything
except for the libvirtd daemon and client tools. The build uses a
large number of libtool convenience libraries - one for each child
directory, and then links them together for the final libvirt.so,
although some bits get linked directly to libvirtd daemon instead.

The files directly in this directory are supporting the public API
entry points & data structures.

There are two core shared modules to be aware of:

 * util/  - a collection of shared APIs that can be used by any
            code. This directory is always in the include path
            for all things built

 * conf/  - APIs for parsing / manipulating all the official XML
            files used by the public API. This directory is only
            in the include path for driver implementation modules

 * vmx/   - VMware VMX config handling (used by esx/ and vmware/)


Then there are the hypervisor implementations:

 * bhyve         - bhyve - The BSD Hypervisor
 * esx/          - VMware ESX and GSX support using vSphere API over SOAP
 * hyperv/       - Microsoft Hyper-V support using WinRM
 * lxc/          - Linux Native Containers
 * openvz/       - OpenVZ containers using cli tools
 * phyp/         - IBM Power Hypervisor using CLI tools over SSH
 * qemu/         - QEMU / KVM using qemu CLI/monitor
 * remote/       - Generic libvirt native RPC client
 * test/         - A "mock" driver for testing
 * uml/          - User Mode Linux
 * vbox/         - Virtual Box using native API
 * vmware/       - VMware Workstation and Player using the vmrun tool
 * xen/          - Xen using hypercalls, XenD SEXPR & XenStore
 * xenapi/       - Xen using libxenserver


Finally some secondary drivers that are shared for several HVs.
Currently these are used by LXC, OpenVZ, QEMU, UML and Xen drivers.
The ESX, Hyper-V, Power Hypervisor, Remote, Test & VirtualBox drivers all
implement the secondary drivers directly

 * cpu/          - CPU feature management
 * interface/    - Host network interface management
 * network/      - Virtual NAT networking
 * nwfilter/     - Network traffic filtering rules
 * node_device/  - Host device enumeration
 * secret/       - Secret management
 * security/     - Mandatory access control drivers
 * storage/      - Storage management drivers


Since both the hypervisor and secondary drivers can be built as
dlopen()able modules, it is *FORBIDDEN* to have build dependencies
between these directories. Drivers are only allowed to depend on
the public API, and the internal APIs in the util/ and conf/
directories