NAME

DESCRIPTION

METHODS

my $uuid = $pool->get_uuid()

Returns a 16 byte long string containing the raw globally unique identifier (UUID) for the storage pool.

my $uuid = $pool->get_uuid_string()

Returns a printable string representation of the raw UUID, in the format 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'.

my $name = $pool->get_name()

Returns a string with a locally unique name of the storage pool

$pool->is_active()

Returns a true value if the storage pool is currently running

$pool->is_persistent()

Returns a true value if the storage pool has a persistent configuration file defined

my $xml = $pool->get_xml_description()

Returns an XML document containing a complete description of the storage pool's configuration

$pool->create()

Start a storage pool whose configuration was previously defined using the "define_storage_pool" method in Sys::Virt.

$pool->undefine()

Remove the configuration associated with a storage pool previously defined with the "define_storage pool" method in Sys::Virt. If the storage pool is running, you probably want to use the "shutdown" or "destroy" methods instead.

$pool->destroy()

Immediately terminate the machine, and remove it from the virtual machine monitor. The $pool handle is invalid after this call completes and should not be used again.

$flag = $pool->get_autostart();

Return a true value if the storage pool is configured to automatically start upon boot. Return false, otherwise

$pool->set_autostart($flag)

Set the state of the autostart flag, which determines whether the storage pool will automatically start upon boot of the host OS

$pool->refresh([$flags]);

Refresh the storage pool state. Typically this will rescan the list of storage volumes. The $flags parameter is currently unused and if omitted defaults to zero.

$pool->build([$flags]);

Construct the storage pool if it does not exist. As an example, for a disk based storage pool this would ensure a partition table exists. The $flags parameter allows control over the build operation and if omitted defaults to zero.

$pool->delete([$flags]);

Delete the storage pool. The $flags parameter allows the data to be optionally wiped during delete and if omitted defaults to zero.

$info = $pool->get_info()

Retrieve information about the current storage pool state. The returned hash reference has the following keys

my $nnames = $pool->num_of_storage_volumes()

Return the number of running volumes in this storage pool. The value can be used as the "maxnames" parameter to "list_storage_vol_names".

my @volNames = $pool->list_storage_vol_names($maxnames)

Return a list of all volume names in this storage pool. The names can be used with the "get_volume_by_name" method.

my @vols = $pool->list_volumes()

Return a list of all volumes in the storage pool. The elements in the returned list are instances of the Sys::Virt::StorageVol class. This method requires O(n) RPC calls, so the "list_all_volumes" method is recommended as a more efficient alternative.

my @volumes = $pool->list_all_volumes($flags)

Return a list of all storage volumes associated with this pool. The elements in the returned list are instances of the Sys::Virt::StorageVol class. The $flags parameter can be used to filter the list of return storage volumes.

my $vol = $pool->get_volume_by_name($name)

Return the volume with a name of $name. The returned object is an instance of the Sys::Virt::StorageVol class.

my $vol = $pool->create_volume($xml)

Create a new volume based on the XML description passed into the $xml parameter. The returned object is an instance of the Sys::Virt::StorageVol class. If the optional "clonevol" is provided, data will be copied from that source volume

my $vol = $pool->clone_volume($xml, $clonevol);

Create a new volume based on the XML description passed into the $xml parameter. The returned object is an instance of the Sys::Virt::StorageVol class. The new volume will be populated with data from the specified clone source volume.

CONSTANTS

LIST FILTERING

Sys::Virt::StoragePool::LIST_ACTIVE

Include storage pools which are active

Sys::Virt::StoragePool::LIST_INACTIVE

Include storage pools which are inactive

Sys::Virt::StoragePool::LIST_AUTOSTART

Include storage pools which are marked for autostart

Sys::Virt::StoragePool::LIST_NO_AUTOSTART

Include storage pools which are not marked for autostart

Sys::Virt::StoragePool::LIST_PERSISTENT

Include storage pools which are persistent

Sys::Virt::StoragePool::LIST_TRANSIENT

Include storage pools which are transient

Sys::Virt::StoragePool::LIST_DIR

Include directory storage pools

Sys::Virt::StoragePool::LIST_DISK

Include disk storage pools

Sys::Virt::StoragePool::LIST_FS

Include filesytem storage pools

Sys::Virt::StoragePool::LIST_ISCSI

Include iSCSI storage pools

Sys::Virt::StoragePool::LIST_LOGICAL

Include LVM storage pools

Sys::Virt::StoragePool::LIST_MPATH

Include multipath storage pools

Sys::Virt::StoragePool::LIST_NETFS

Include network filesystem storage pools

Sys::Virt::StoragePool::LIST_RBD

Include RBD storage pools

Sys::Virt::StoragePool::LIST_SCSI

Include SCSI storage pools

Sys::Virt::StoragePool::LIST_SHEEPDOG

Include sheepdog storage pools

AUTHORS

COPYRIGHT

LICENSE

SEE ALSO