COT.helpers.qemu_img module¶
Give COT access to qemu-img for manipulating disk image formats.
- class QEMUImg[source]¶
Bases: COT.helpers.helper.Helper
Helper provider for qemu-img (http://www.qemu.org).
Methods
install_helper Install qemu-img. get_disk_format Get the major disk image format of the given file. get_disk_capacity Get the storage capacity of the given disk image. convert_disk_image Convert the given disk image to the requested format/subformat. create_blank_disk Create an unformatted disk image at the requested location. - convert_disk_image(file_path, output_dir, new_format, new_subformat=None)[source]¶
Convert the given disk image to the requested format/subformat.
If the disk is already in this format then it is unchanged; otherwise, will convert to a new disk in the specified output_dir and return its path.
Current supported conversions:
- .vmdk (any format) to .vmdk (streamOptimized)
- .img to .vmdk (streamOptimized)
Parameters: - file_path (str) – Disk image file to inspect/convert
- output_dir (str) – Directory to place converted image into, if needed
- new_format (str) – Desired final format
- new_subformat (str) – Desired final subformat
Returns: - file_path, if no conversion was required
- or a file path in output_dir containing the converted image
Raises NotImplementedError: if the new_format and/or new_subformat are not supported conversion targets.
- create_blank_disk(file_path, capacity, file_format=None)[source]¶
Create an unformatted disk image at the requested location.
Parameters: - file_path (str) – Desired location of new disk image
- capacity – Disk capacity. A string like ‘16M’ or ‘1G’.
- file_format (str) – Desired image format (if not specified, this will be derived from the file extension of file_path)
- get_disk_capacity(file_path)[source]¶
Get the storage capacity of the given disk image.
Parameters: file_path (str) – Path to disk image file to inspect Returns: Disk capacity, in bytes
- get_disk_format(file_path)[source]¶
Get the major disk image format of the given file.
Warning
If file_path refers to a file which is not a disk image at all, this function will return 'raw'.
Parameters: file_path (str) – Path to disk image file to inspect. Returns: Disk image format ('vmdk', 'raw', 'qcow2', etc.)