libvirt/src
Laine Stump 58320848d2 util: do a better job of matching up pids with their binaries
This patch resolves: https://bugzilla.redhat.com/show_bug.cgi?id=871201

If libvirt is restarted after updating the dnsmasq or radvd packages,
a subsequent "virsh net-destroy" will fail to kill the dnsmasq/radvd
process.

The problem is that when libvirtd restarts, it re-reads the dnsmasq
and radvd pidfiles, then does a sanity check on each pid it finds,
including checking that the symbolic link in /proc/$pid/exe actually
points to the same file as the path used by libvirt to execute the
binary in the first place. If this fails, libvirt assumes that the
process is no longer alive.

But if the original binary has been replaced, the link in /proc is set
to "$binarypath (deleted)" (it literally has the string " (deleted)"
appended to the link text stored in the filesystem), so even if a new
binary exists in the same location, attempts to resolve the link will
fail.

In the end, not only is the old dnsmasq/radvd not terminated when the
network is stopped, but a new dnsmasq can't be started when the
network is later restarted (because the original process is still
listening on the ports that the new process wants).

The solution is, when the initial "use stat to check for identical
inodes" check for identity between /proc/$pid/exe and $binpath fails,
to check /proc/$pid/exe for a link ending with " (deleted)" and if so,
truncate that part of the link and compare what's left with the
original binarypath.

A twist to this problem is that on systems with "merged" /sbin and
/usr/sbin (i.e. /sbin is really just a symlink to /usr/sbin; Fedora
17+ is an example of this), libvirt may have started the process using
one path, but /proc/$pid/exe lists a different path (indeed, on F17
this is the case - libvirtd uses /sbin/dnsmasq, but /proc/$pid/exe
shows "/usr/sbin/dnsmasq"). The further bit of code to resolve this is
to call virFileResolveAllLinks() on both the original binarypath and
on the truncated link we read from /proc/$pid/exe, and compare the
results.

The resulting code still succeeds in all the same cases it did before,
but also succeeds if the binary was deleted or replaced after it was
started.
(cherry picked from commit 7bafe009d9)
2012-12-09 16:07:04 -05:00
..
conf conf: fix virDomainNetGetActualDirect*() and BridgeName() 2012-12-03 14:16:39 -05:00
cpu maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
esx esx: Fix connection to ESX 5.1 2012-12-09 15:35:05 -05:00
hyperv maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
interface maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
libxl maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
locking locking: Remove README file in favor of internals/locking.html 2012-09-21 12:23:01 +02:00
lxc lxc: Correctly report active cgroups 2012-10-18 13:10:43 -04:00
network network: use dnsmasq --bind-dynamic when available 2012-11-29 15:14:20 -05:00
node_device maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
nwfilter maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
openvz maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
parallels parallels: fix build for some older compilers 2012-10-27 15:16:53 -04:00
phyp maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
qemu qemu: pass -usb and usb hubs earlier, so USB disks with static address are handled properly 2012-12-09 15:43:01 -05:00
remote Fix crash accessing a NULL URI when looking up auth credentials 2012-09-21 10:13:53 +01:00
rpc Simplify some redundant locking while unref'ing objects 2012-10-17 16:41:24 -04:00
secret maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
security selinux: Don't fail RestoreAll if file doesn't have a default label 2012-10-27 15:14:31 -04:00
storage storage: don't shadow global 'wait' declaration 2012-10-27 15:14:22 -04:00
test maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
uml network: fix dnsmasq/radvd binding to IPv6 on recent kernels 2012-10-23 18:00:14 -04:00
util util: do a better job of matching up pids with their binaries 2012-12-09 16:07:04 -05:00
vbox maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
vmware maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
vmx maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
xen Fix detection of Xen sysctl version 9 2012-10-27 15:14:34 -04:00
xenapi Call curl_global_init from virInitialize to avoid thread-safety issues 2012-10-18 13:15:00 -04:00
xenxs maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
check-symfile.pl build: avoid tabs that failed syntax-check 2012-09-06 09:43:46 -06:00
datatypes.c maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
datatypes.h maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
driver.c maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
driver.h network: define new API virNetworkUpdate 2012-09-18 04:21:32 -04:00
dtrace2systemtap.pl maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
fdstream.c maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
fdstream.h maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
gnutls_1_0_compat.h maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
internal.h build: improved handling of <execinfo.h>, BSD <net/if.h> 2012-09-06 10:08:47 -06:00
libvirt_atomic.syms Rewrite virAtomic APIs using GLib's atomic ops code 2012-08-02 11:50:59 +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 maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
libvirt_libssh2.syms libssh2_transport: add main libssh2 transport implementation 2012-08-21 14:47:09 +02:00
libvirt_linux.syms build: Don't export xenLinuxDomainBlockStats symbol 2012-07-31 11:28:32 +02:00
libvirt_openvz.syms openvz: Add openvzVEGetStringParam 2012-07-20 21:54:35 +02:00
libvirt_private.syms util: new virSocketAddrIsPrivate function 2012-11-29 15:14:20 -05:00
libvirt_probes.d Turn virNetClient* into virObject instances 2012-08-07 11:47:55 +01:00
libvirt_public.syms network: define new API virNetworkUpdate 2012-09-18 04:21:32 -04:00
libvirt_qemu_probes.d build: fix binary location in stap files --with-driver-modules 2012-08-10 23:11:26 -04:00
libvirt_qemu.syms qemu-agent: available in 0.10.0 2012-08-23 13:05:52 -06:00
libvirt_sasl.syms Move some SASL symbols into libvirt_sasl.syms 2012-08-15 21:41:42 +01:00
libvirt_vmx.syms
libvirt_xenxs.syms
libvirt-qemu.c maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
libvirt.c Call curl_global_init from virInitialize to avoid thread-safety issues 2012-10-18 13:15:00 -04:00
libvirt.conf
Makefile.am Move virProcessKill into virprocess.{h,c} 2012-10-17 16:41:03 -04:00
nodeinfo.c nodeinfo: Fully convert to new virReportError 2012-10-18 13:15:40 -04:00
nodeinfo.h maint: fix up copyright notice inconsistencies 2012-09-20 16:30:55 -06:00
qemu_protocol-structs agent: add remote driver support 2012-08-23 19:05:50 +08:00
README
remote_protocol-structs rpc: Fix name of member in remote_protocol-structs 2012-09-18 11:47:12 +02: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:

 * 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