Rechercher une page de manuel
Sys::Virt::StorageVol.3pm
Langue: en
Version: 2009-03-27 (fedora - 05/07/09)
Section: 3 (Bibliothèques de fonctions)
NAME
Sys::Virt::StorageVol - Represent & manage a libvirt storage volumeDESCRIPTION
The "Sys::Virt::StorageVol" module represents a storage volume managed by libvirt. A storage volume is always associated with a containing storage pool ("Sys::Virt::StoragePool").METHODS
- my $name = $vol->get_name()
- Returns a string with a locally unique name of the storage vol
- my $name = $vol->get_key()
- Returns a string with a globally unique key for the storage vol
- my $name = $vol->get_path()
- Returns a string with a locally unique file path of the storage vol
- my $xml = $vol->get_xml_description()
- Returns an XML document containing a complete description of the storage vol's configuration
- $vol->delete($flags)
- Immediately delete the storage volume freeing its storage resources. The "flags" parameter indicates any special action to be taken when deleting the volume.
- my %info = $vol->get_info()
- Retrieve live information about the storage volume. The returned %info hash contains three keys. "type" indicates whether the volume is a file or block device. "capacity" provides the maximum logical size of the volume. "allocation" provides the current physical usage of the volume. The allocation may be less than the capacity for sparse, or grow-on-demand volumes. The allocation may also be larger than the capacity, if there is a metadata overhead for the volume format.
CONSTANTS
The following sets of constants are useful when dealing with storage volumesVOLUME TYPES
The following constants are useful for interpreting the "type" field in the hash returned by the "get_info" method
- Sys::Virt::StorageVol::TYPE_FILE
- The volume is a plain file
- Sys::Virt::StorageVol::TYPE_BLOCK
- The volume is a block device
DELETE MODES
The following constants are useful for the "flags" parameter of the "delete" method
- Sys::Virt::StorageVol::DELETE_NORMAL
- Do a plain delete without any attempt to scrub data.
- Sys::Virt::StorageVol::DELETE_ZEROED
- Zero out current allocated blocks when deleteing the volume
AUTHORS
Daniel P. Berrange <berrange@redhat.com>COPYRIGHT
Copyright (C) 2006-2009 Red Hat Copyright (C) 2006-2009 Daniel P. BerrangeLICENSE
This program is free software; you can redistribute it and/or modify it under the terms of either the GNU General Public License as published by the Free Software Foundation (either version 2 of the License, or at your option any later version), or, the Artistic License, as specified in the Perl README file.SEE ALSO
Sys::Virt, Sys::Virt::Error, "http://libvirt.org"Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre