qemu-img convert create commit info kvm-img vmdk qcow2 sparse file, readme howto manual help documentation
(Link zu dieser Seite als [[QEMU-KVM-Buch/ Anhang/ qemu-img]])
Inhaltsverzeichnis |
[bearbeiten] qemu-img
qemu-img (kvm-img) ist ein Tool zum Generieren und Konvertieren von Image-Dateien.
Host ~$ qemu-img command [options]
-h
Zeigt eine Hilfestellung an.
Für command können folgende Befehle mit den entsprechenden Optionen verwendet werden.
[bearbeiten] check
check [-f fmt] filename
Überprüft eine Image-Datei (filename). Optional kann das Format mit -f angegeben werden. Derzeit wird nur das Format qcow2 unterstützt. Beispiel:
Host ~$ qemu-img check Datei.img No errors were found on the image.
[bearbeiten] create
create [-e] [-6] [-F base_fmt] [-b base_image] \''' [-f fmt] [-o options] filename [size]
Generiert ein Image mit dem Dateinamen filename und der Größe size.
filename
Name der zu generierenden Image-Datei.
size
Definiert die Größe der Image-Datei in Kilobyte. Optional können die Suffixes M (Megabyte=1024*1024) und G (Gigabyte=1024*1024*1024) angegeben werden. Wird die Größe der Image-Datei mit der Option -o vorgegeben, entfällt die Größenangabe mit size.
-f fmt
Definiert das Format der Image-Datei.
-e
Verschlüsselt das Image. Dies ist nur beim qcow- und qcow2-Format möglich. Die Verschlüsselung erfolgt mit AES (128 Bit Schlüssel) und ist dadurch sehr sicher. Für maximale Sicherheit ist ein Passwort mit 16 Zeichen zu verwenden.
-6
Erzwingt beim vmdk-Format den Kompatibilitäts-Level 6 für die Ziel-Imagedatei.
-b base_image
Wird mit base_image eine vorhandene Image-Datei angegeben, dann speichert das generierte Image nur die Unterschiede zu dieser vorhandenen Image-Datei. Das generierte Image nennt man Overlay-Datei. Eine Größenangabe ist für die Overlay-Datei nicht erforderlich. Das Basis-Image (base_image) wird nicht verändert, solange kein commit eingegeben wurde.
-F base_fmt
Gibt das Format der Basis-Datei an. Normalerweise ist diese Option nicht notwendig, da qemu-img das Format in der Regel erkennt.
-o options
Ermöglicht die Angabe von weiteren Optionen. Das Format ist name=value. Mehrere Optionen werden mit Kommas getrennt. Mit -o ? erhält man eine Liste der unterstützten Optionen.
Host ~$ qemu-img create -o ? Supported options: size Virtual disk size
Beispiel:
Host ~$ qemu-img create -f qcow2 -o size=1G Datei.img
[bearbeiten] convert
convert [-c] [-e] [-6] [-f fmt] [-O output_fmt] [-o options] \ [-B output_base_image] filename [filename2 [...]] \ output_filename
Kopiert ein Image in ein neues Image mit einem anderen Format.
filename
Name der Quell-Datei.
output_filename
Name der zu generierenden Image-Datei.
-f fmt
Gibt das Format der Quell-Datei an.
-O output_fmt
Definiert das Ziel-Format.
-B output_base_image
Es ist möglich ein Base-Image mit dem identischen Inhalt in das Image output_base_image zu kopieren. Der Pfad, das Image-Format und anderes können in der Datei base_image gegenüber dem Original geändert werden.
-c
Ermöglicht Kompression beim qcow- und qcow2-Format. Werden nach dem Komprimieren Sektoren neu geschrieben, sind diese nicht komprimiert.
-e
Ermöglicht Verschlüsselung beim qcow- und qcow2-Format. Die Verschlüsselung erfolgt mit AES (128 Bit Schlüssel) und ist dadurch sehr sicher. Für maximale Sicherheit ist ein Passwort mit 16 Zeichen zu verwenden.
-6
Erzwingt beim vmdk-Format den Kompatibilitäts-Level 6 für die Ziel-Imagedatei.
-o options
Ermöglicht die Angabe von weiteren Optionen. Das Format ist name=value. Mehrere Optionen werden mit Kommas getrennt. Mit -o ? erhält man eine Liste der unterstützten Optionen.
Host ~$ qemu-img convert -o ? Datei.img KonvertierteDatei.img Supported options: size Virtual disk size
Beispiel:
Host ~$ qemu-img convert -O qcow -o size=1G Datei.img \
KonvertierteDatei.img
[bearbeiten] commit
commit [-f fmt] filename
Speichert Änderungen in das Base-Image.
-f fmt
Gibt das Format des Images an.
filename
Name der Image-Datei.
[bearbeiten] snapshot
snapshot [-l | -a snapshot | -c snapshot | -d snapshot] filename
Verwaltet VM-Snapshots.
snapshot
Ist der Name des VM-Snapshots.
-a snapshot
Den Zustand des angegebenen VM-Snapshot snapshot wiederherstellen.
-c snapshot
Anlegen eines VM-Snapshots mit dem Namen snapshot.
-d snapshot
Löschen des VM-Snapshots mit den Namen snapshot.
-l
Auflisten aller VM-Snapshots eines Images.
filename
Name der Image-Datei.
[bearbeiten] info
info [-f fmt] filename
Zeigt Informationen (Größe, VM-Snapshots, ...) zu einem Image an.
-f fmt
Gibt das Format des Images an.
filename
Name der Image-Datei.
[bearbeiten] Unterstützte Image-Formate
| raw | Das raw-Format ist das Default-Format. Es ist einfach aufgebaut und lässt sich leicht konvertieren. Wird ein neues, leeres Image im raw-Format in einer bestimmten Größe, zum Beispiel 10 GByte erzeugt, belegt es bei älteren Dateisystemen genau diese Größe (hier 10 GByte). Neuere Dateisysteme unterstützen eine effektivere Verwaltung von Dateien, die unbelegte Blöcke enthalten. Solche Dateien belegen in diesen Dateisystemen etwa nur den Platz, den sie an Blöcken belegen. Eine Datei mit unbelegten Blöcken heißt Sparse-Datei. Images im Format raw können als Sparse-Dateien angelegt werden. |
| qcow2 | Das Format qcow2 ist das vielseitigste Format und löst das alte Format qcow ab. Images im qcow2-Format sind dynamisch. Ihre Größe hängt von ihrem Füllstand ab. Beim Format qcow2 ist die Dateigröße unabhängig davon, ob das Dateisystem eine effiziente Verwaltung von Sparse-Dateien unterstützt. qcow2 unterstützt das mehrfache Abspeichern von Systemzuständen der virtuellen Maschine (VM-Snapshots). Außerdem ist Verschlüsselung (AES) und Kompression (zlib) möglich. Bei qcow2 wird der Inhalt in Clustern gespeichert. Jedes Cluster enthält eine Anzahl von 512 Byte großen Sektoren. |
| qcow | qcow ist das alte QEMU-Image-Format. Images im qcow-Format sind dynamisch. Ihre Größen hängen von deren Füllstand ab. Bei qcow hängt die Dateigröße nicht davon ab, ob das Dateisystem eine effiziente Verwaltung von Sparse-Dateien erlaubt. Weiterhin unterstützt qcow Verschlüsselung und Kompression. |
| cow | Das alte Format Copy-on-Write ist nur noch aufgrund der Kompatibilität mit älteren QEMU-Versionen vorhanden. Es funktioniert nicht unter Microsoft Windows. |
| vmdk | vmdk ist das Standardformat von VMware Workstation. |
| vdi | vdi ist das Standardformat von VirtualBox. |
| cloop | Das Format Compressed Loop wird für komprimierte CD-ROM-Images verwendet, beispielsweise für Knoppix-CD/DVD-ROMs. |
| nbd | nbd ist das Format des NBD-Protokolls (Network Block Device). |
| parallels | parallels ist das Standardformat der Virtualisierungslösungen der Firma Parallels, Inc. |
| vvfat | Mit vvfat sind virtuelle FAT-Festplatten gemeint. |
| vpc | vpc ist das Standardformat für Images von Microsoft Virtual PC. |
| bochs | bochs ist das Format des freien x86- und AMD64-Emulators Bochs. |
| dmg | dmg ist das Format der Installationsmedien von Mac OS X. |