On 05/05/2010 04:15 PM, David Ehle wrote: > > Hello, > > Does anyone know where full documentation for virsh can be found? Or if > the there are any plans to update the man page? > > The man page lists far fewer commands than virsh lists from its > interactive mode when you type help. > > I noticed this when I was trying to figure out the difference between > pool-destroy, and pool-delete. The help entries in the virsh shell are not > very informative: > virsh # help pool-destroy > NAME > pool-destroy - destroy a pool > > SYNOPSIS > pool-destroy <pool> > > DESCRIPTION > Destroy a given pool. > > OPTIONS > <pool> pool name or uuid > > virsh # help pool-delete > NAME > pool-delete - delete a pool > > SYNOPSIS > pool-delete <pool> > > DESCRIPTION > Delete a given pool. > > OPTIONS > <pool> pool name or uuid > > ... unless you already know how virsh defines delete vs destroy. In libvirt terminology, 'destroy' means 'force shutdown'. This has different meanings for different things. For a VM, it is like pulling out the power plug. For a directory pool, it just marks the pool as 'inactive'. For an NFS pool, it will actually unmount the NFS share from the host running libvirt. pool-delete will actually delete the underlying storage, so for a directory pool this will actually remove the directory from the disk. If you just want to tell libvirt to 'forget' about a pool and not list it anymore, use pool-undefine. This is a safe operation and will not harm any of your underlying storage. - Cole
