libvirt/src
Eric Blake ca02b101d7 build: fix build of fresh checkout
Commit 7bff56a worked in an incremental build, but fails for a
fresh clone; apparently, if make sees both an actual file
spelling and an inference rule, only the exact spelling is used.

  CCLD   libvirt_driver_test.la
  CC     libvirt_driver_remote_la-remote_driver.lo
remote/remote_driver.c:4707:34: fatal error: remote_client_bodies.h: No such file or directory
compilation terminated.

BUILT_SOURCES to the rescue, instead of trying to mess with .lo
dependencies directly.

* src/Makefile.am (REMOTE_DRIVER_PREREQS, %remote_driver.lo): Drop...
(BUILT_SOURCES): ...and add here instead.
2012-06-06 14:49:27 -06:00
..
conf nwfilter: move code for IP address map into separate file 2012-06-01 19:32:06 -04:00
cpu cpu: Improve error reporting on incompatible CPUs 2012-04-23 10:59:51 +02:00
esx esx: Fix memory leaks in error paths related to transferred ownership 2012-05-13 16:20:35 +02:00
hyperv Consistent style for usage of sizeof operator 2012-03-30 11:47:24 +01:00
interface Cleanup for a return statement in source files 2012-03-26 14:45:22 -06:00
libxl build: fix unused variable after last patch 2012-05-21 12:36:50 -06:00
locking Autogenerate augeas test case from default config files 2012-05-28 11:07:12 +01:00
lxc lxc: return correct number of CPUs 2012-05-30 12:51:44 +02:00
network Remove uid param from directory lookup APIs 2012-05-28 10:55:06 +01:00
node_device node_device: fix possible non-terminated string 2012-05-04 13:22:22 -04:00
nwfilter nwfilter: Add multiple IP address support to DHCP snooping 2012-06-01 19:32:06 -04:00
openvz openvz: add quota argument when creating container 2012-05-24 11:35:02 +02:00
phyp Remove uid param from directory lookup APIs 2012-05-28 10:55:06 +01:00
qemu Fix for parallel port passthrough for QEMU 2012-06-04 16:46:23 -06:00
remote rpc: Size up RPC limits 2012-06-05 17:48:40 +02:00
rpc rpc: Size up RPC limits 2012-06-05 17:48:40 +02:00
secret Remove uid param from directory lookup APIs 2012-05-28 10:55:06 +01:00
security Remove last usage of PATH_MAX and ban its future use 2012-05-28 10:43:01 +01:00
storage Remove uid param from directory lookup APIs 2012-05-28 10:55:06 +01:00
test Coverity: Fix resource leak in test driver 2012-05-04 10:27:13 +08:00
uml Remove uid param from directory lookup APIs 2012-05-28 10:55:06 +01:00
util maint: command.c whitespace cleanups 2012-06-04 16:32:43 -06:00
vbox vbox: Fix passing an empty IMedium* array to IMachine::Delete 2012-04-23 21:44:51 +02:00
vmware build: use correct type for pid and similar types 2012-03-02 06:57:43 -07:00
vmx vmx: fix resource leak 2012-05-04 10:42:09 -04:00
xen Coverity: Fix resource leak in xen driver 2012-05-04 10:26:54 +08:00
xenapi Consistent style for usage of sizeof operator 2012-03-30 11:47:24 +01:00
xenxs Remove last usage of PATH_MAX and ban its future use 2012-05-28 10:43:01 +01:00
datatypes.c Santize the reporting of VIR_ERR_INVALID_ERROR 2012-05-28 16:47:25 +01:00
datatypes.h Fixed URI parsing 2012-02-24 16:49:21 -07:00
driver.c Override default driver dir when running from GIT 2012-05-24 13:18:01 +01:00
driver.h Override default driver dir when running from GIT 2012-05-24 13:18:01 +01:00
dtrace2systemtap.pl Add a systemtap script for watching QEMU monitor interactions 2011-10-27 10:42:14 +01:00
fdstream.c fdstream: avoid double close bug 2012-05-30 21:41:46 -06:00
fdstream.h fdstream: Add internal callback on stream close 2012-02-27 15:05:17 +01:00
gnutls_1_0_compat.h Fix detection of GnuTLS 1.x.y 2011-08-03 19:22:29 +02:00
internal.h Santize the reporting of VIR_ERR_INVALID_ERROR 2012-05-28 16:47:25 +01:00
libvirt_daemon.syms
libvirt_driver_modules.syms Override default driver dir when running from GIT 2012-05-24 13:18:01 +01:00
libvirt_esx.syms Remove libvirt_test.la library 2012-05-24 13:18:00 +01:00
libvirt_internal.h Introduce virConnectSetKeepAlive 2011-11-24 11:44:08 +01:00
libvirt_linux.syms Add linuxNodeInfoCPUPopulate to src/libvirt_linux.syms 2012-04-04 14:33:27 +01:00
libvirt_network.syms network: provide internal API to return IP of a network 2011-07-25 13:48:55 +08:00
libvirt_nwfilter.syms
libvirt_openvz.syms Remove libvirt_test.la library 2012-05-24 13:18:00 +01:00
libvirt_private.syms nwfilter: move code for IP address map into separate file 2012-06-01 19:32:06 -04:00
libvirt_probes.d Split QEMU dtrace probes into separate file 2012-05-24 13:18:01 +01:00
libvirt_public.syms Introduce virDomainPMWakeup API 2012-02-27 11:43:59 +01:00
libvirt_qemu_probes.d Split QEMU dtrace probes into separate file 2012-05-24 13:18:01 +01:00
libvirt_qemu.syms Define a QEMU specific API to attach to a running QEMU process 2011-07-12 15:39:03 +01:00
libvirt_sasl.syms build: fix mingw build without sasl 2011-10-11 16:30:25 -06:00
libvirt_vmx.syms
libvirt_xenxs.syms
libvirt-qemu.c Santize the reporting of VIR_ERR_INVALID_ERROR 2012-05-28 16:47:25 +01:00
libvirt.c rpc: Size up RPC limits 2012-06-05 17:48:40 +02:00
libvirt.conf Allow overriding default URI in config file 2012-03-15 11:20:17 +00:00
Makefile.am build: fix build of fresh checkout 2012-06-06 14:49:27 -06:00
nodeinfo.c Santize the reporting of VIR_ERR_INVALID_ERROR 2012-05-28 16:47:25 +01:00
nodeinfo.h add nodeGetCPUmap() for getting available CPU IDs in a cpumap. 2012-03-06 21:54:48 -07:00
qemu_protocol-structs build: use correct type for pid and similar types 2012-03-02 06:57:43 -07:00
README hyperv: Add basic documentation 2011-08-26 17:52:55 +02:00
remote_protocol-structs build: fix incorrect enum declaration 2012-03-23 14:29:00 -06:00
virkeepaliveprotocol-structs build: Properly generate and check virkeepaliveprotocol-structs 2011-11-24 14:44:04 +01:00
virnetprotocol-structs Extend RPC protocol to allow FD passing 2011-10-28 10:27:15 +01:00

       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:

 * 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