qemu-img

PROGRAMA:

NOMBRE

qemu-img: utilidad de imagen de disco QEMU

SINOPSIS

uso: comando qemu-img [opciones de comando]

DESCRIPCIÓN

qemu-img le permite crear, convertir y modificar imágenes sin conexión. Puede manejar todas las imágenes.
formatos compatibles con QEMU.

Advertencia: Nunca use qemu-img para modificar imágenes en uso por una máquina virtual en ejecución o cualquier
otro proceso; esto puede destruir la imagen. Además, tenga en cuenta que consultar una imagen que es
ser modificado por otro proceso puede encontrar un estado inconsistente.

OPCIONES

Se admiten los siguientes comandos:

check [-Q] [-F fmt] [--salida =ofmt] [-r [fugas | todos]] [-T src_cache] nombre de archivo
Para crear [-Q] [-F fmt] [-o opciones] nombre de archivo [tamaño]
hacer [-Q] [-F fmt] [-t cache] [-B bases] [-D] [-pag] nombre de archivo
comparar [-F fmt] [-F fmt] [-T src_cache] [-pag] [-Q] [-s] nombrearchivo1 nombrearchivo2
convertir [-C] [-pag] [-Q] [-norte] [-F fmt] [-t cache] [-T src_cache] [-O salida_fmt] [-o
opciones] [-s instantánea_id_o_nombre] [-l instantánea_param] [-S tamaño_disperso] nombre de archivo [nombrearchivo2
[...]] Nombre del archivo de salida
info [-F fmt] [--salida =ofmt] [--cadena-trasera] nombre de archivo
mapa [-F fmt] [--salida =ofmt] nombre de archivo
instantánea [-Q] [-l | -a instantánea | -c instantánea | -d instantánea] nombre de archivo
rebase [-Q] [-F fmt] [-t cache] [-T src_cache] [-pag] [-u] -b archivo_de_espalda [-F respaldo_fmt]
nombre de archivo
cambiar el tamaño [-Q] nombre de archivo [+ | -]tamaño
enmendar [-pag] [-Q] [-F fmt] [-t cache] -o opciones nombre de archivo

Parámetros de comando:

nombre de archivo
es un nombre de archivo de imagen de disco

fmt es el formato de imagen de disco. Se adivina automáticamente en la mayoría de los casos. Vea a continuación una
descripción de los formatos de disco admitidos.

--cadena trasera
enumerará información sobre la copia de seguridad de archivos en una cadena de imágenes de disco. Consulte a continuación para
descripción adicional.

tamaño
es el tamaño de la imagen del disco en bytes. Sufijos opcionales "k" o "K" (kilobyte, 1024) "M"
(megabyte, 1024k) y "G" (gigabyte, 1024M) y T (terabyte, 1024G) son compatibles.
"b" se ignora.

Nombre del archivo de salida
es el nombre de archivo de la imagen del disco de destino

salida_fmt
es el formato de destino

opciones
es una lista separada por comas de opciones específicas de formato en un formato de nombre = valor. Utilice "-o
? "para obtener una descripción general de las opciones admitidas por el formato utilizado o consulte el formato
descripciones a continuación para obtener más detalles.

instantánea_param
es un parámetro utilizado para la instantánea interna, el formato es 'snapshot.id = [ID], snapshot.name = [NAME]'
o '[ID_OR_NAME]'

instantánea_id_o_nombre
está en desuso, use snapshot_param en su lugar

-c indica que la imagen de destino debe estar comprimida (solo formato qcow)

-h con o sin un comando muestra ayuda y enumera los formatos compatibles

-p mostrar la barra de progreso (solo comparar, convertir y reajustar los comandos). Si el -p opción es
no se utiliza para un comando que lo admite, el progreso se informa cuando el proceso
recibe una señal "SIGUSR1".

-q Modo silencioso: no imprima ninguna salida (excepto errores). No hay barra de progreso en caso de
ambas -q -p se utilizan opciones.

-S tamaño
indica el número consecutivo de bytes que deben contener solo ceros para qemu-img para
crea una imagen escasa durante la conversión. Este valor se redondea hacia abajo al 512 más cercano.
bytes. Puede utilizar los sufijos de tamaño comunes como "k" para kilobytes.

-t cache
especifica el modo de caché que se debe utilizar con el archivo (de destino). Ver el
documentación de la opción "-drive cache = ..." del emulador para los valores permitidos.

-T src_cache
especifica el modo de caché que se debe utilizar con los archivos de origen. Ver el
documentación de la opción "-drive cache = ..." del emulador para los valores permitidos.

Parámetros del subcomando de instantánea:

instantánea
es el nombre de la instantánea para crear, aplicar o eliminar

-a aplica una instantánea (revertir el disco al estado guardado)

-c crea una instantánea

-d elimina una instantánea

-l enumera todas las instantáneas en la imagen dada

Parámetros para comparar el subcomando:

-f Formato de primera imagen

-F Segundo formato de imagen

-s Modo estricto: falla en diferentes tamaños de imagen o asignación de sectores

Parámetros para convertir subcomando:

-n Omitir la creación del volumen de destino

Descripción del comando:

check [-F fmt] [--salida =ofmt] [-r [fugas | todos]] [-T src_cache] nombre de archivo
Realice una verificación de coherencia en la imagen del disco nombre de archivo. El comando puede salir en el
formato ofmt que es "humano" o "json".

Si se especifica "-r", qemu-img intenta reparar cualquier inconsistencia encontrada durante el
cheque. "-r leaks" repara solo las fugas de grupo, mientras que "-r all" corrige todo tipo de
errores, con un mayor riesgo de elegir la solución incorrecta u ocultar la corrupción que ha
ya ocurrió.

Solo los formatos "qcow2", "qed" y "vdi" admiten controles de coherencia.

En caso de que la imagen no tenga inconsistencias, marque las salidas con 0. Otra salida
Los códigos indican el tipo de inconsistencia encontrada o si ocurrió otro error. los
La siguiente tabla resume todos los códigos de salida del subcomando check:

0 Verificación completada, la imagen es (ahora) consistente

1 Verificación no completada debido a errores internos

2 Verificación completa, la imagen está dañada

3 Verificación completada, la imagen ha filtrado clústeres, pero no está dañada

63 Los cheques no son compatibles con el formato de imagen.

Si se especifica "-r", los códigos de salida que representan el estado de la imagen se refieren al estado después de
(el intento de) repararlo. Es decir, un "-r todo" exitoso producirá el código de salida
0, independientemente del estado de la imagen anterior.

Para crear [-F fmt] [-o opciones] nombre de archivo [tamaño]
Crea la nueva imagen de disco nombre de archivo de tamaño tamaño y formato fmt. Dependiendo del archivo
formato, puede agregar uno o más opciones que habilitan características adicionales de este
formato.

Si la opcion archivo_de_espalda se especifica, entonces la imagen grabará solo el
diferencias de archivo_de_espalda. En este caso, no es necesario especificar ningún tamaño.
archivo_de_espalda nunca se modificará a menos que utilice el comando de monitor "commit" (o
qemu-img confirmar).

El tamaño también se puede especificar utilizando el tamaño opción con "-o", no es necesario
especificado por separado en este caso.

hacer [-Q] [-F fmt] [-t cache] [-B bases] [-D] [-pag] nombre de archivo
Confirmar los cambios registrados en nombre de archivo en su imagen base o archivo de respaldo. Si el
archivo de respaldo es más pequeño que la instantánea, entonces el archivo de respaldo cambiará de tamaño para ser
del mismo tamaño que la instantánea. Si la instantánea es más pequeña que el archivo de respaldo, el
El archivo de respaldo no se truncará. Si desea que el archivo de respaldo coincida con el tamaño de
la instantánea más pequeña, puede truncarla de forma segura usted mismo una vez que la operación de confirmación
completa con éxito.

La imagen nombre de archivo se vacía después de que la operación se haya realizado correctamente. Si no necesitas
nombre de archivo después y tiene la intención de dejarlo, puede omitir el vaciado nombre de archivo by
especificando la bandera "-d".

Si la cadena de respaldo del archivo de imagen dado nombre de archivo tiene más de una capa, el
El archivo de respaldo en el que se confirmarán los cambios se puede especificar como bases (cual
tiene que ser parte de nombre de archivocadena de respaldo). Si bases no se especifica, el inmediato
archivo de respaldo de la imagen superior (que es nombre de archivo) se utilizará. Por razones de
consistencia, especificando explícitamente bases siempre implicará "-d" (ya que vaciar un
imagen después de comprometerse con un archivo de respaldo indirecto conduciría a que se
leer de la imagen debido al contenido en la cadena de respaldo intermedia que anula el
cometer objetivo).

comparar [-F fmt] [-F fmt] [-T src_cache] [-pag] [-s] [-Q] nombrearchivo1 nombrearchivo2
Compruebe si dos imágenes tienen el mismo contenido. Puede comparar imágenes con diferentes
formato o configuración.

El formato se prueba a menos que lo especifique -f (usado para nombrearchivo1) y / o -F (usó
for nombrearchivo2) opción.

De forma predeterminada, las imágenes con tamaño diferente se consideran idénticas si la imagen más grande
contiene solo sectores no asignados y / o puestos a cero en el área después del final de la otra
imagen. Además, si algún sector no está asignado en una imagen y contiene solo cero
bytes en el segundo, se evalúa como igual. Puede utilizar el modo estricto
especificando el -s opción. Cuando la comparación se ejecuta en modo estricto, falla en caso de que la imagen
el tamaño es diferente o un sector se asigna en una imagen y no se asigna en la segunda
uno.

De forma predeterminada, comparar imprime un mensaje de resultado. Este mensaje muestra información
que ambas imágenes son iguales o la posición del primer byte diferente. Además,
El mensaje de resultado puede informar de un tamaño de imagen diferente en caso de que se utilice el modo estricto.

Compare las salidas con 0 en caso de que las imágenes sean iguales y con 1 en caso de que las imágenes
diferir de. Otros códigos de salida significan que ocurrió un error durante la ejecución y un error estándar
la salida debe contener un mensaje de error. La siguiente tabla resume todos los códigos de salida
del subcomando comparar:

0 Las imágenes son idénticas

1 Las imágenes difieren

2 Error al abrir una imagen

3 Error al verificar la asignación de un sector

4 Error al leer datos

convertir [-C] [-pag] [-norte] [-F fmt] [-t cache] [-T src_cache] [-O salida_fmt] [-o opciones] [-s
instantánea_id_o_nombre] [-l instantánea_param] [-S tamaño_disperso] nombre de archivo [nombrearchivo2 [...]]
Nombre del archivo de salida
Convertir la imagen del disco nombre de archivo o una instantánea instantánea_param(instantánea_id_o_nombre is
obsoleto) a la imagen del disco Nombre del archivo de salida usando formato salida_fmt. Puede ser
opcionalmente comprimido (opción "-c") o use cualquier formato de opciones específicas como cifrado
(opción "-o").

Sólo los formatos "qcow" y "qcow2" admiten la compresión. La compresión es de solo lectura.
Significa que si se reescribe un sector comprimido, entonces se reescribe como
datos sin comprimir.

La conversión de imágenes también es útil para obtener imágenes más pequeñas cuando se usa un formato que se puede crecer como
como "qcow": los sectores vacíos se detectan y se suprimen de la imagen de destino.

tamaño_disperso indica el número consecutivo de bytes (predeterminado en 4k) que debe
contienen solo ceros para qemu-img para crear una imagen dispersa durante la conversión. Si
tamaño_disperso es 0, la fuente no se escaneará en busca de sectores no asignados o cero, y
la imagen de destino siempre se asignará por completo.

Puede utilizar el archivo_de_espalda opción para forzar la creación de la imagen de salida como una copia
al escribir la imagen de la imagen base especificada; los archivo_de_espalda debería tener lo mismo
contenido como la imagen base de la entrada, sin embargo, la ruta, el formato de imagen, etc. pueden diferir.

Si se especifica la opción "-n", se omitirá la creación del volumen de destino. Este es
útil para formatos como "rbd" si el volumen de destino ya se ha creado con
opciones específicas del sitio que no se pueden proporcionar a través de qemu-img.

info [-F fmt] [--salida =ofmt] [--cadena-trasera] nombre de archivo
Dar información sobre la imagen del disco nombre de archivo. Úselo en particular para conocer el tamaño
reservado en el disco que puede ser diferente del tamaño mostrado. Si las instantáneas de VM son
almacenados en la imagen del disco, también se muestran. El comando puede generar en el formato
ofmt que es "humano" o "json".

Si una imagen de disco tiene una cadena de archivos de respaldo, la información sobre cada imagen de disco en el
La cadena se puede enumerar de forma recursiva mediante la opción "--backing-chain".

Por ejemplo, si tiene una cadena de imágenes como:

base.qcow2 <- snap1.qcow2 <- snap2.qcow2

Para enumerar información sobre cada imagen de disco en la cadena anterior, comenzando desde arriba
a la base, haz:

qemu-img info --cadena trasera snap2.qcow2

mapa [-F fmt] [--salida =ofmt] nombre de archivo
Volcar los metadatos de la imagen nombre de archivo y su cadena de archivos de respaldo. En particular, este
comandos vuelca el estado de asignación de cada sector de nombre de archivo, Junto con el
archivo superior que lo asigna en la cadena de archivos de respaldo.

Son posibles dos formatos opcionales. El formato predeterminado ("humano") solo realiza volcados conocidos-
áreas distintas de cero del archivo. Las partes de cero conocidas del archivo se omiten por completo, y
lo mismo ocurre con las piezas que no se encuentran asignadas a lo largo de la cadena. qemu-img la salida será
identificar un archivo desde donde se pueden leer los datos y el desplazamiento en el archivo. Cada
La línea incluirá cuatro campos, los primeros tres de los cuales son números hexadecimales. Para
ejemplo la primera línea de:

Longitud de desplazamiento asignada al archivo
0 0x20000 0x50000 /tmp/superposición.qcow2
0x100000 0x10000 0x95380000 /tmp/backing.qcow2

significa que 0x20000 (131072) bytes que comienzan en el desplazamiento 0 en la imagen están disponibles en
/tmp/overlay.qcow2 (abierto en formato "sin procesar") comenzando en el desplazamiento 0x50000 (327680). Datos
que esté comprimido, cifrado o que no esté disponible en formato sin procesar provocará una
error si se utiliza el formato "humano". Tenga en cuenta que los nombres de archivo pueden incluir nuevas líneas, por lo que
no es seguro analizar este formato de salida en scripts.

El formato alternativo "json" devolverá una matriz de diccionarios en formato JSON. Eso
incluirá información similar en los campos "inicio", "longitud", "desplazamiento"; va a
incluir también otra información más específica:

- si los sectores contienen datos reales o no (campo booleano "datos"; si es falso,
los sectores no están asignados o se almacenan como clústeres optimizados todo cero);

- si se sabe que los datos se leen como cero (campo booleano "cero");

- para acortar la salida, el archivo de destino se expresa como una "profundidad";
por ejemplo, una profundidad de 2 se refiere al archivo de respaldo del archivo de respaldo de
nombre de archivo.

En formato JSON, el campo "desplazamiento" es opcional; está ausente en los casos en que "humano"
el formato omitiría la entrada o saldría con un error. Si "datos" es falso y el
El campo "offset" está presente, los sectores correspondientes del archivo aún no están en uso,
pero están preasignados.

Para más información, consulte incluir / block / block.h en el código fuente de QEMU.

instantánea [-l | -a instantánea | -c instantánea | -d instantánea ] nombre de archivo
Enumere, aplique, cree o elimine instantáneas en la imagen nombre de archivo.

rebase [-F fmt] [-t cache] [-T src_cache] [-pag] [-u] -b archivo_de_espalda [-F respaldo_fmt]
nombre de archivo
Cambia el archivo de respaldo de una imagen. Solo los formatos "qcow2" y "qed" son compatibles
cambiando el archivo de respaldo.

El archivo de respaldo se cambia a archivo_de_espalda y (si el formato de imagen de nombre de archivo
admite esto) el formato del archivo de respaldo se cambia a respaldo_fmt. Si archivo_de_espalda is
especificado como "" (la cadena vacía), la imagen se vuelve a basar en un archivo sin respaldo
(es decir, existirá independientemente de cualquier archivo de respaldo).

cache especifica el modo de caché que se utilizará para nombre de archivo, mientras que src_cache especifica
el modo de caché para leer archivos de respaldo.

Hay dos modos diferentes en los que puede funcionar "rebase":

Segura modo
Este es el modo predeterminado y realiza una operación de rebase real. El nuevo respaldo
El archivo puede diferir del anterior y qemu-img rebase se encargará de mantener el
contenido visible para invitados de nombre de archivo sin alterar.

Para lograr esto, cualquier clúster que difiera entre archivo_de_espalda y el
antiguo archivo de respaldo de nombre de archivo se fusionan en nombre de archivo antes de cambiar el
archivo de respaldo.

Tenga en cuenta que el modo seguro es una operación costosa, comparable a convertir un
imagen. Solo funciona si el archivo de respaldo anterior aún existe.

Inseguro modo
qemu-img usa el modo inseguro si se especifica "-u". En este modo, solo el respaldo
nombre de archivo y formato de nombre de archivo se cambia sin ningún control en el archivo
contenido. El usuario debe encargarse de especificar el nuevo archivo de respaldo correcto, o
el contenido visible de la imagen para los invitados se dañará.

Este modo es útil para cambiar el nombre o mover el archivo de respaldo a otro lugar. Eso
se puede usar sin un archivo de respaldo antiguo accesible, es decir, puede usarlo para arreglar un
imagen cuyo archivo de respaldo ya ha sido movido / renombrado.

Puede utilizar "rebase" para realizar una operación "diff" en dos imágenes de disco. Esto puede ser
útil cuando ha copiado o clonado un invitado, y desea volver a una delgada
imagen encima de una plantilla o imagen base.

Digamos que "base.img" se ha clonado como "modified.img" copiándolo, y que el
El invitado "modified.img" se ha ejecutado, por lo que ahora hay algunos cambios en comparación con "base.img". Para
construya una imagen delgada llamada "diff.qcow2" que contenga solo las diferencias, haga:

qemu-img crear -f qcow2 -b modificado.img diff.qcow2
qemu-img rebase -b base.img diff.qcow2

En este punto, "modified.img" puede descartarse, ya que "base.img + diff.qcow2" contiene
la misma información.

cambiar el tamaño nombre de archivo [+ | -]tamaño
Cambie la imagen del disco como si se hubiera creado con tamaño.

Antes de usar este comando para reducir una imagen de disco, DEBE usar el sistema de archivos y
herramientas de partición dentro de la máquina virtual para reducir los sistemas de archivos asignados y los tamaños de partición
respectivamente. ¡Si no lo hace, se perderán los datos!

Después de usar este comando para hacer crecer una imagen de disco, debe usar el sistema de archivos y
herramientas de partición dentro de la máquina virtual para comenzar a usar el nuevo espacio en el dispositivo.

enmendar [-pag] [-F fmt] [-t cache] -o opciones nombre de archivo
Modifica el formato de imagen específico opciones para el archivo de imagen nombre de archivo. No todos los archivos
Los formatos admiten esta operación.

NOTAS

Formatos de archivo de imagen admitidos:

crudo Formato de imagen de disco sin procesar (predeterminado). Este formato tiene la ventaja de ser sencillo y
fácilmente exportable a todos los demás emuladores. Si su sistema de archivos admite agujeros (solo para
ejemplo en ext2 o ext3 en Linux o NTFS en Windows), entonces solo los sectores escritos
reservará espacio. Utilice "qemu-img info" para conocer el tamaño real utilizado por la imagen o "ls
-ls "en Unix / Linux.

Opciones admitidas:

"preasignación"
Modo de preasignación (valores permitidos: "off", "falloc", "full"). modo "falloc"
preasigna espacio para la imagen llamando posix_fallocate (). modo "completo"
preasigna espacio para la imagen escribiendo ceros en el almacenamiento subyacente.

qvaca2
Formato de imagen QEMU, el formato más versátil. Úselo para tener imágenes más pequeñas (útil si
su sistema de archivos no admite agujeros, por ejemplo en Windows), AES opcional
cifrado, compresión basada en zlib y soporte de múltiples instantáneas de VM.

Opciones admitidas:

"compat"
Determina la versión de qcow2 que se utilizará. "compat = 0.10" usa la imagen tradicional
formato que puede ser leído por cualquier QEMU desde 0.10. "compat = 1.1" habilita el formato de imagen
extensiones que solo QEMU 1.1 y versiones posteriores comprenden (este es el valor predeterminado). Entre
otros, esto incluye cero clústeres, lo que permite una copia en lectura eficiente para escasa
imágenes.

"backing_file"
Nombre de archivo de una imagen base (consulte Para crear subcomando)

"backing_fmt"
Formato de imagen de la imagen base

"cifrado"
Si esta opción está activada, la imagen se cifra con AES-CBC de 128 bits.

El uso de cifrado en imágenes qcow y qcow2 se considera defectuoso por
estándares modernos de criptografía, que sufren una serie de problemas de diseño:

-
en el número de sector. Esto lo hace vulnerable a los ataques de texto sin formato elegidos.
que puede revelar la existencia de datos cifrados.

-
La contraseña elegida o corta comprometerá la seguridad del cifrado.

-
cambie la frase de contraseña para proteger los datos en cualquier imagen de qcow. Los archivos deben ser
clonado, utilizando una contraseña de cifrado diferente en el nuevo archivo. El original
El archivo debe borrarse de forma segura con un programa como shred, aunque incluso este
es ineficaz con muchas tecnologías de almacenamiento modernas.

Por tanto, se desaconseja encarecidamente el uso del cifrado qcow / qcow2. Se recomiendan los usuarios
utilizar una tecnología de cifrado alternativa como Linux dm-crypt / LUKS
.

"tamaño de cluster"
Cambia el tamaño del clúster qcow2 (debe estar entre 512 y 2M). Tamaños de clúster más pequeños
puede mejorar el tamaño del archivo de imagen, mientras que los tamaños de clúster más grandes generalmente proporcionan
mejor interpretación.

"preasignación"
Modo de preasignación (valores permitidos: "desactivado", "metadatos", "falloc", "completo"). Una imagen
con metadatos preasignados es inicialmente más grande, pero puede mejorar el rendimiento cuando
la imagen necesita crecer. las preasignaciones "Falloc" y "completas" son iguales
opciones de formato "sin procesar", pero también configura metadatos.

"lazy_refcounts"
Si esta opción está activada, las actualizaciones del recuento de referencias se posponen con el objetivo
de evitar la E / S de metadatos y mejorar el rendimiento. Esto es particularmente
interesante con caché = escritura directa que no realiza actualizaciones de metadatos por lotes. los
La compensación es que después de un bloqueo del host, las tablas de recuento de referencias deben reconstruirse,
es decir, en la siguiente apertura se requiere un (automático) "qemu-img check -r all", que
puede llevar algún tiempo.

Esta opción solo se puede habilitar si se especifica "compat = 1.1".

"nocow"
Si esta opción está "activada", desactivará la VACA del archivo. Solo es valido
en btrfs, ningún efecto en otros sistemas de archivos.

Btrfs tiene un rendimiento bajo cuando aloja un archivo de imagen de VM, incluso más cuando el invitado
en la VM también usando btrfs como sistema de archivos. Apagar COW es una forma de mitigar
esta mala actuación. Generalmente hay dos formas de desactivar COW en btrfs: a)
Deshabilítelo montando con nodatacow, entonces todos los archivos recién creados serán NOCOW.
b) Para un archivo vacío, agregue el atributo de archivo NOCOW. Eso es lo que hace esta opción.

Nota: esta opción solo es válida para archivos nuevos o vacíos. Si hay un
archivo que es COW y ya tiene bloques de datos, no se pudo cambiar a NOCOW por
configurando "nocow = on". Se puede emitir "lsattr filename" para comprobar si la bandera NOCOW está
establecido o no (la 'C' mayúscula es la bandera NOCOW).

Otros
QEMU también admite varios otros formatos de archivo de imagen para compatibilidad con QEMU más antiguos
versiones u otros hipervisores, incluidos VMDK, VDI, VHD (vpc), VHDX, qcow1 y QED.
Para obtener una lista completa de los formatos compatibles, consulte "qemu-img --help". Para un más detallado
descripción de estos formatos, consulte la documentación del usuario de emulación QEMU.

El propósito principal de los controladores de bloque para estos formatos es la conversión de imágenes. Para
ejecutando VM, se recomienda convertir las imágenes de disco a raw o qcow2 en
para lograr un buen desempeño.

Use qemu-img en línea usando los servicios de onworks.net