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:
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.