commit d8ec244c6513b7c44956a547e56c228a4c38fbbe Author: Jim Fehlig Date: Wed Jan 13 18:24:51 2010 -0700 doc: restrict virDomain{Attach,Detach}Device to active domains virDomain{Attach,Detach}Device is now only permitted on active domains. Explicitly state this restriction in the API documentation. V2: Only change doc, dropping the hunk that forced the restriction in libvirt frontend. Index: libvirt-0.7.6/src/libvirt.c =================================================================== --- libvirt-0.7.6.orig/src/libvirt.c +++ libvirt-0.7.6/src/libvirt.c @@ -5121,7 +5121,8 @@ error: * @domain: pointer to domain object * @xml: pointer to XML description of one device * - * Create a virtual device attachment to backend. + * Create a virtual device attachment to backend. This function, + * having hotplug semantics, is only allowed on an active domain. * * Returns 0 in case of success, -1 in case of failure. */ @@ -5164,7 +5165,8 @@ error: * @domain: pointer to domain object * @xml: pointer to XML description of one device * - * Destroy a virtual device attachment to backend. + * Destroy a virtual device attachment to backend. This function, + * having hot-unplug semantics, is only allowed on an active domain. * * Returns 0 in case of success, -1 in case of failure. */