Package org.libvirt

Class StorageVol

java.lang.Object
org.libvirt.StorageVol

public class StorageVol extends Object
An acutal storage bucket.
  • Field Details

    • virConnect

      protected Connect virConnect
      The VirConnect Object that represents the Hypervisor of this Domain
    • libvirt

      protected Libvirt libvirt
      the libvirt instance
  • Method Details

    • delete

      public void delete(int flags) throws LibvirtException
      Delete the storage volume from the pool
      Parameters:
      flags - future flags, use 0 for now
      Throws:
      LibvirtException
    • finalize

      public void finalize() throws LibvirtException
      Overrides:
      finalize in class Object
      Throws:
      LibvirtException
    • free

      public int free() throws LibvirtException
      Release the storage volume handle. The underlying storage volume contains to exist
      Returns:
      number of references left (>= 0) for success, -1 for failure.
      Throws:
      LibvirtException
    • getConnect

      public Connect getConnect()
      Provides the connection object associated with a storage volume. The reference counter on the connection is not increased by this call.
      Returns:
      the Connect object
    • getInfo

      public StorageVolInfo getInfo() throws LibvirtException
      Fetches volatile information about the storage volume such as its current allocation
      Returns:
      StorageVolInfo object
      Throws:
      LibvirtException
    • getKey

      public String getKey() throws LibvirtException
      Fetch the storage volume key. This is globally unique, so the same volume will have the same key no matter what host it is accessed from
      Returns:
      the key
      Throws:
      LibvirtException
    • getName

      public String getName() throws LibvirtException
      Fetch the storage volume name. This is unique within the scope of a pool
      Returns:
      the name
      Throws:
      LibvirtException
    • getPath

      public String getPath() throws LibvirtException
      Fetch the storage volume path. Depending on the pool configuration this is either persistent across hosts, or dynamically assigned at pool startup. Consult pool documentation for information on getting the persistent naming
      Returns:
      the storage volume path
      Throws:
      LibvirtException
    • getXMLDesc

      public String getXMLDesc(int flags) throws LibvirtException
      Fetch an XML document describing all aspects of this storage volume
      Parameters:
      flags - flags for XML generation (unused, pass 0)
      Returns:
      the XML document
      Throws:
      LibvirtException
    • processError

      protected void processError() throws LibvirtException
      Error handling logic which should be called after every libvirt call
      Throws:
      LibvirtException
    • storagePoolLookupByVolume

      public StoragePool storagePoolLookupByVolume() throws LibvirtException
      Fetch a storage pool which contains this volume
      Returns:
      StoragePool object,
      Throws:
      LibvirtException
    • wipe

      public int wipe() throws LibvirtException
      Ensure data previously on a volume is not accessible to future reads
      Returns:
      0 on success, or -1 on error
      Throws:
      LibvirtException
      See Also: