Hide Forgot
This bug exists to track the fact that nodedev-* commands of virsh are completely undocumented, including the fact that nodedev-reattach must be used to give a pci passthrough device back to the host after it is no longer needed by any guests.
Upstream patches proposed: https://www.redhat.com/archives/libvir-list/2011-September/msg00971.html https://www.redhat.com/archives/libvir-list/2011-September/msg01083.html
In POST: http://post-office.corp.redhat.com/archives/rhvirt-patches/2011-September/msg00909.html
tested with libvirt-0.9.4-13.el6.x86_64 libvirt-0.9.4-14.el6.x86_64 man virsh in -13 build ,there is no nodedev doc, and in -14, nodedev doc is added. Checked libvirt.org, Node devices XML format page has been created under Documentation -> XML format -> Node Devices . All of the patch has streamed into -14 build . So set bug status to VERIFIED
Verified the new patch with libvirt-0.9.4-21.el6.x86_64. Domain XML format page has been updated under Documentation -> XML format -> Domains: ... "and reattached to the host after the guest exits. If managed is omitted or "no", and for USB devices, the user is responsible to call virNodeDeviceDettach (or virsh nodedev-dettach) before starting the guest or hot-plugging the device, and virNodeDeviceReAttach (or virsh nodedev-reattach) after hot-unplug or stopping the guest." And in virsh manual,all content in patch has been updated.
Since the problem described in this bug report should be resolved in a recent advisory, it has been closed with a resolution of ERRATA. For information on the advisory, and where to find the updated files, follow the link below. If the solution does not work for you, open a new bug report. http://rhn.redhat.com/errata/RHBA-2011-1513.html