qemu-img

PROGRAMA:

NOME

qemu-img - utilitário de imagem de disco QEMU

SINOPSE

uso: comando qemu-img [opções de comando]

DESCRIÇÃO

qemu-img permite criar, converter e modificar imagens offline. Ele pode lidar com todas as imagens
formatos suportados pelo QEMU.

Atenção: Nunca use qemu-img para modificar imagens em uso por uma máquina virtual em execução ou qualquer
outro processo; isso pode destruir a imagem. Além disso, esteja ciente de que consultar uma imagem que é
ser modificado por outro processo pode encontrar um estado inconsistente.

OPÇÕES

Os seguintes comandos são suportados:

verificar [-Q] [-f fmt] [--output =frequentemente] [-r [vazamentos | tudo]] [-T src_cache] nome do arquivo
crio [-Q] [-f fmt] [-ou opções] nome do arquivo [tamanho]
commit [-Q] [-f fmt] [-t esconderijo] [-b base] [-d] [-p] nome do arquivo
comparar [-f fmt] [-F fmt] [-T src_cache] [-p] [-Q] [-s] nomedoarquivo1 nomedoarquivo2
convertem [-c] [-p] [-Q] [-n] [-f fmt] [-t esconderijo] [-T src_cache] [-O saída_fmt] [-ou
opções] [-s snapshot_id_or_name] [-eu snapshot_param] [-S tamanho_esparso] nome do arquivo [nomedoarquivo2
[...]] nome_do_arquivo_saída
info [-f fmt] [--output =frequentemente] [--cadeia de apoio] nome do arquivo
mapa, [-f fmt] [--output =frequentemente] nome do arquivo
instantâneo [-Q] [-eu | -a instantâneo | -c instantâneo | -d instantâneo] nome do arquivo
rebase [-Q] [-f fmt] [-t esconderijo] [-T src_cache] [-p] [-você] -b backup_file [-F backing_fmt]
nome do arquivo
redimensionar [-Q] nome do arquivo [+ | -]tamanho
emendar [-p] [-Q] [-f fmt] [-t esconderijo] -o opções nome do arquivo

Parâmetros de comando:

nome do arquivo
é um nome de arquivo de imagem de disco

fmt é o formato da imagem do disco. É adivinhado automaticamente na maioria dos casos. Veja abaixo um
descrição dos formatos de disco suportados.

--corrente de apoio
irá enumerar informações sobre arquivos de backup em uma cadeia de imagens de disco. Consulte abaixo para
descrição adicional.

tamanho
é o tamanho da imagem do disco em bytes. Sufixos opcionais "k" ou "K" (kilobyte, 1024) "M"
(megabyte, 1024k) e "G" (gigabyte, 1024M) e T (terabyte, 1024G) são suportados.
"b" é ignorado.

nome_do_arquivo_saída
é o nome do arquivo de destino da imagem do disco

saída_fmt
é o formato de destino

opções
é uma lista separada por vírgulas de opções específicas de formato em um formato name = value. Use "-o
? "para uma visão geral das opções suportadas pelo formato usado ou consulte o formato
descrições abaixo para detalhes.

snapshot_param
é o parâmetro usado para instantâneo interno, o formato é 'snapshot.id = [ID], snapshot.name = [NAME]'
ou '[ID_OR_NAME]'

snapshot_id_or_name
está obsoleto, use snapshot_param em vez disso

-c indica que a imagem alvo deve ser compactada (apenas formato qcow)

-h com ou sem um comando mostra a ajuda e lista os formatos suportados

-p exibe a barra de progresso (apenas comandos de comparação, conversão e rebase). Se o -p opção
não usado para um comando que o suporta, o progresso é relatado quando o processo
recebe um sinal "SIGUSR1".

-q Modo silencioso - não imprime nenhuma saída (exceto erros). Não há barra de progresso no caso
ambos -q e -p opções são usadas.

-S tamanho
indica o número consecutivo de bytes que devem conter apenas zeros para qemu-img para
crie uma imagem esparsa durante a conversão. Este valor é arredondado para baixo para os 512 mais próximos
bytes. Você pode usar os sufixos de tamanho comuns como "k" para kilobytes.

-t esconderijo
especifica o modo de cache que deve ser usado com o arquivo (destino). Veja o
documentação da opção "-drive cache = ..." do emulador para os valores permitidos.

-T src_cache
especifica o modo de cache que deve ser usado com os arquivos de origem. Veja o
documentação da opção "-drive cache = ..." do emulador para os valores permitidos.

Parâmetros para o subcomando de instantâneo:

instantâneo
é o nome do instantâneo a ser criado, aplicado ou excluído

-a aplica um instantâneo (reverter o disco para o estado salvo)

-c cria um instantâneo

-d apaga um instantâneo

-l lista todos os instantâneos na imagem dada

Parâmetros para comparar o subcomando:

-f Formato da primeira imagem

-F Segundo formato de imagem

-s Modo estrito - falha em diferentes tamanhos de imagem ou alocação de setor

Parâmetros para converter o subcomando:

-n Pule a criação do volume de destino

Descrição do comando:

verificar [-f fmt] [--output =frequentemente] [-r [vazamentos | tudo]] [-T src_cache] nome do arquivo
Execute uma verificação de consistência na imagem do disco nome do arquivo. O comando pode ser gerado no
formato frequentemente que é "humano" ou "json".

Se "-r" for especificado, qemu-img tenta reparar quaisquer inconsistências encontradas durante o
Verifica. "-r leaks" repara apenas vazamentos de cluster, enquanto "-r all" corrige todos os tipos de
erros, com um risco maior de escolher a correção errada ou ocultar a corrupção que tem
já ocorreu.

Apenas os formatos "qcow2", "qed" e "vdi" suportam verificações de consistência.

Caso a imagem não apresente inconsistências, marque as saídas com 0. Outra saída
códigos indicam o tipo de inconsistência encontrada ou se outro erro ocorreu. o
A tabela a seguir resume todos os códigos de saída do subcomando de verificação:

0 Verificação concluída, a imagem (agora) consistente

1 A verificação não foi concluída devido a erros internos

2 Verificação concluída, imagem corrompida

3 Verificação concluída, a imagem vazou clusters, mas não está corrompida

63 Os cheques não são suportados pelo formato da imagem

Se "-r" for especificado, os códigos de saída que representam o estado da imagem referem-se ao estado após
(a tentativa de) consertá-lo. Ou seja, um "-r all" bem-sucedido produzirá o código de saída
0, independentemente do estado da imagem anterior.

crio [-f fmt] [-ou opções] nome do arquivo [tamanho]
Crie a nova imagem de disco nome do arquivo do tamanho tamanho e formato fmt. Dependendo do arquivo
formato, você pode adicionar um ou mais opções que permitem recursos adicionais deste
formato.

Se a opção backup_file for especificado, a imagem gravará apenas o
diferenças de backup_file. Nenhum tamanho precisa ser especificado neste caso.
backup_file nunca será modificado a menos que você use o comando de monitor "commit" (ou
confirmação do qemu-img).

O tamanho também pode ser especificado usando o tamanho opção com "-o", não precisa ser
especificado separadamente neste caso.

commit [-Q] [-f fmt] [-t esconderijo] [-b base] [-d] [-p] nome do arquivo
Comprometa as mudanças registradas em nome do arquivo em sua imagem de base ou arquivo de apoio. Se o
arquivo de apoio é menor do que o instantâneo, então o arquivo de apoio será redimensionado para ser
do mesmo tamanho do instantâneo. Se o instantâneo for menor do que o arquivo de apoio, o
o arquivo de apoio não será truncado. Se você quiser que o arquivo de apoio corresponda ao tamanho de
o instantâneo menor, você pode truncá-lo com segurança uma vez que a operação de confirmação
é concluído com sucesso.

A imagem nome do arquivo é esvaziado após a operação ser bem-sucedida. Se você não precisa
nome do arquivo depois e com a intenção de descartá-lo, você pode pular o esvaziamento nome do arquivo by
especificando o sinalizador "-d".

Se a cadeia de apoio do arquivo de imagem fornecido nome do arquivo tem mais de uma camada, o
arquivo de apoio no qual as alterações serão confirmadas pode ser especificado como base (qual
tem que ser parte de nome do arquivocorrente de apoio de). Se base não é especificado, o imediato
arquivo de apoio da imagem superior (que é nome do arquivo) será usado. Por razões de
consistência, especificando explicitamente base sempre implicará "-d" (uma vez que esvaziar um
imagem depois de se comprometer com um arquivo de apoio indireto levaria a diferentes dados sendo
lido a partir da imagem devido ao conteúdo na cadeia intermediária de apoio anulando o
alvo de confirmação).

comparar [-f fmt] [-F fmt] [-T src_cache] [-p] [-s] [-Q] nomedoarquivo1 nomedoarquivo2
Verifique se duas imagens têm o mesmo conteúdo. Você pode comparar imagens com diferentes
formato ou configurações.

O formato é testado, a menos que você o especifique por -f (usado para nomedoarquivo1) e / ou -F (usava
for nomedoarquivo2) opção.

Por padrão, imagens com tamanhos diferentes são consideradas idênticas se a imagem maior
contém apenas setores não alocados e / ou zerados na área após o final do outro
imagem. Além disso, se algum setor não estiver alocado em uma imagem e contiver apenas zero
bytes no segundo, é avaliado como igual. Você pode usar o modo estrito
especificando o -s opção. Quando a comparação é executada no modo Estrito, falha na imagem do caso
o tamanho difere ou um setor é alocado em uma imagem e não é alocado na segunda
um.

Por padrão, compare imprime uma mensagem de resultado. Esta mensagem exibe informações
que ambas as imagens são iguais ou a posição do primeiro byte diferente. Além disso,
a mensagem de resultado pode relatar diferentes tamanhos de imagem caso o modo estrito seja usado.

Compare as saídas com 0 no caso de as imagens serem iguais e com 1 no caso das imagens
diferem. Outros códigos de saída significam que ocorreu um erro durante a execução e erro padrão
a saída deve conter uma mensagem de erro. A tabela a seguir resume todos os códigos de saída
do subcomando compare:

0 As imagens são idênticas

1 Imagens diferem

2 Erro ao abrir uma imagem

3 Erro ao verificar uma alocação de setor

4 Erro na leitura de dados

convertem [-c] [-p] [-n] [-f fmt] [-t esconderijo] [-T src_cache] [-O saída_fmt] [-ou opções] [-s
snapshot_id_or_name] [-eu snapshot_param] [-S tamanho_esparso] nome do arquivo [nomedoarquivo2 [...]]
nome_do_arquivo_saída
Converta a imagem do disco nome do arquivo ou um instantâneo snapshot_param(snapshot_id_or_name is
obsoleto) para imagem de disco nome_do_arquivo_saída usando formato saída_fmt. Pode ser
opcionalmente compactado (opção "-c") ou use qualquer opção de formato específico, como criptografia
(opção "-o").

Apenas os formatos "qcow" e "qcow2" suportam compressão. A compactação é somente leitura.
Isso significa que se um setor compactado for reescrito, ele será reescrito como
dados não compactados.

A conversão de imagem também é útil para obter uma imagem menor ao usar um formato expansível como
como "qcow": os setores vazios são detectados e suprimidos da imagem de destino.

tamanho_esparso indica o número consecutivo de bytes (o padrão é 4k) que deve
conter apenas zeros para qemu-img para criar uma imagem esparsa durante a conversão. Se
tamanho_esparso for 0, a fonte não será verificada em busca de setores não alocados ou nulos, e
a imagem de destino sempre estará totalmente alocada.

Você pode usar o backup_file opção para forçar a imagem de saída a ser criada como uma cópia
na imagem de gravação da imagem de base especificada; a backup_file deveria ter o mesmo
conteúdo como a imagem de base da entrada, porém o caminho, formato da imagem, etc. podem ser diferentes.

Se a opção "-n" for especificada, a criação do volume de destino será ignorada. Isto é
útil para formatos como "rbd" se o volume alvo já tiver sido criado com
opções específicas do site que não podem ser fornecidas por meio de qemu-img.

info [-f fmt] [--output =frequentemente] [--cadeia de apoio] nome do arquivo
Dê informações sobre a imagem do disco nome do arquivo. Use-o em particular para saber o tamanho
reservado no disco, que pode ser diferente do tamanho exibido. Se os instantâneos da VM forem
armazenados na imagem do disco, eles também são exibidos. O comando pode ser gerado no formato
frequentemente que é "humano" ou "json".

Se uma imagem de disco tiver uma cadeia de arquivos de apoio, informações sobre cada imagem de disco no
cadeia pode ser enumerada recursivamente usando a opção "--backing-chain".

Por exemplo, se você tiver uma cadeia de imagens como:

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

Para enumerar informações sobre cada imagem de disco na cadeia acima, começando do topo
para basear, faça:

qemu-img info - backing-chain snap2.qcow2

mapa, [-f fmt] [--output =frequentemente] nome do arquivo
Despejar os metadados da imagem nome do arquivo e sua cadeia de arquivos de apoio. Em particular, este
comandos despeja o estado de alocação de cada setor de nome do arquivo, Juntamente com o
arquivo de nível superior que o aloca na cadeia de arquivos de apoio.

Dois formatos de opção são possíveis. O formato padrão ("humano") apenas despeja conhecidos-
áreas diferentes de zero do arquivo. Partes conhecidas de zero do arquivo são omitidas completamente, e
da mesma forma para peças que não estão alocadas em toda a cadeia. qemu-img saída vai
identificar um arquivo de onde os dados podem ser lidos e o deslocamento no arquivo. Cada
linha incluirá quatro campos, os três primeiros dos quais são números hexadecimais. Para
exemplo a primeira linha de:

Comprimento de deslocamento mapeado para arquivo
0 0x20000 0x50000 /tmp/overlay.qcow2
0x100000 0x10000 0x95380000 /tmp/backing.qcow2

significa que 0x20000 (131072) bytes começando no deslocamento 0 na imagem estão disponíveis em
/tmp/overlay.qcow2 (aberto no formato "bruto") começando no deslocamento 0x50000 (327680). Dados
que é compactado, criptografado ou não disponível em formato bruto causará um
erro se o formato "humano" estiver em uso. Observe que os nomes dos arquivos podem incluir novas linhas, portanto,
não é seguro analisar este formato de saída em scripts.

O formato alternativo "json" retornará uma série de dicionários no formato JSON. Isto
incluirá informações semelhantes nos campos "início", "comprimento" e "deslocamento"; será
também inclui outras informações mais específicas:

- se os setores contêm dados reais ou não (campo booleano "dados"; se falso,
os setores são não alocados ou armazenados como clusters otimizados totalmente zero);

- se os dados são lidos como zero (campo booleano "zero");

- para tornar a saída mais curta, o arquivo de destino é expresso como uma "profundidade";
por exemplo, uma profundidade de 2 se refere ao arquivo de apoio do arquivo de apoio de
nome do arquivo.

No formato JSON, o campo "deslocamento" é opcional; está ausente nos casos em que "humano"
formato omitiria a entrada ou sairia com um erro. Se "dados" for falso e o
campo "offset" está presente, os setores correspondentes no arquivo ainda não estão em uso,
mas eles são pré-alocados.

Para mais informações, consulte incluir / bloquear / bloquear.h no código-fonte do QEMU.

instantâneo [-eu | -a instantâneo | -c instantâneo | -d instantâneo ] nome do arquivo
Listar, aplicar, criar ou excluir instantâneos na imagem nome do arquivo.

rebase [-f fmt] [-t esconderijo] [-T src_cache] [-p] [-você] -b backup_file [-F backing_fmt]
nome do arquivo
Altera o arquivo de apoio de uma imagem. Apenas os formatos "qcow2" e "qed" são compatíveis
alterando o arquivo de apoio.

O arquivo de apoio é alterado para backup_file e (se o formato de imagem de nome do arquivo
suporta isso) o formato do arquivo de apoio é alterado para backing_fmt. Se backup_file is
especificado como "" (a string vazia), então a imagem é realocada em nenhum arquivo de apoio
(ou seja, ele existirá independentemente de qualquer arquivo de apoio).

esconderijo especifica o modo de cache a ser usado para nome do arquivo, enquanto que src_cache especifica
o modo de cache para leitura de arquivos de apoio.

Existem dois modos diferentes nos quais o "rebase" pode operar:

Seguro modo
Este é o modo padrão e executa uma operação real de rebase. O novo apoio
arquivo pode ser diferente do antigo e qemu-img rebase cuidará de manter o
conteúdo visível do convidado de nome do arquivo inalterado.

Para conseguir isso, quaisquer clusters que diferem entre backup_file e os votos de
arquivo de apoio antigo de nome do arquivo são fundidos em nome do arquivo antes de realmente mudar o
arquivo de apoio.

Observe que o modo de segurança é uma operação cara, comparável à conversão de um
imagem. Ele só funciona se o arquivo de backup antigo ainda existir.

Inseguro modo
qemu-img usa o modo não seguro se "-u" for especificado. Neste modo, apenas o apoio
nome do arquivo e formato de nome do arquivo é alterado sem qualquer verificação no arquivo
conteúdo. O usuário deve ter o cuidado de especificar o novo arquivo de apoio correto, ou
o conteúdo visível do convidado da imagem será corrompido.

Este modo é útil para renomear ou mover o arquivo de backup para outro lugar. Isto
pode ser usado sem um arquivo de apoio antigo acessível, ou seja, você pode usá-lo para corrigir um
imagem cujo arquivo de apoio já foi movido / renomeado.

Você pode usar "rebase" para realizar uma operação "diff" em duas imagens de disco. Isso pode ser
útil quando você copiou ou clonou um convidado e deseja voltar para um thin
imagem em cima de um modelo ou imagem de base.

Digamos que "base.img" foi clonado como "modificado.img" ao copiá-lo, e que o
O convidado "modificado.img" foi executado, então agora existem algumas mudanças em comparação com "base.img". Para
construir uma imagem fina chamada "diff.qcow2" que contém apenas as diferenças, faça:

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

Neste ponto, "modify.img" pode ser descartado, uma vez que "base.img + diff.qcow2" contém
as mesmas informações.

redimensionar nome do arquivo [+ | -]tamanho
Altere a imagem do disco como se tivesse sido criada com tamanho.

Antes de usar este comando para reduzir uma imagem de disco, você DEVE usar o sistema de arquivos e
ferramentas de particionamento dentro da VM para reduzir sistemas de arquivos alocados e tamanhos de partição
adequadamente. Não fazer isso resultará em perda de dados!

Depois de usar este comando para aumentar uma imagem de disco, você deve usar o sistema de arquivos e
ferramentas de particionamento dentro da VM para realmente começar a usar o novo espaço no dispositivo.

emendar [-p] [-f fmt] [-t esconderijo] -o opções nome do arquivo
Altera o formato de imagem específico opções para o arquivo de imagem nome do arquivo. Nem todos os arquivos
formatos suportam esta operação.

NOTAS

Formatos de arquivo de imagem suportados:

cru Formato de imagem de disco bruto (padrão). Este formato tem a vantagem de ser simples e
facilmente exportável para todos os outros emuladores. Se o seu sistema de arquivos suportar buracos (Por
exemplo em ext2 ou ext3 no Linux ou NTFS no Windows), então apenas os setores escritos
vai reservar espaço. Use "qemu-img info" para saber o tamanho real usado pela imagem ou "ls
-ls "no Unix / Linux.

Opções com suporte:

"pré-alocação"
Modo de pré-alocação (valores permitidos: "off", "falloc", "full"). modo "falloc"
pré-aloca espaço para imagem chamando posix_fallocate (). modo "completo"
pré-aloca espaço para imagem escrevendo zeros no armazenamento subjacente.

qcow2
Formato de imagem QEMU, o formato mais versátil. Use-o para ter imagens menores (útil se
seu sistema de arquivos não suporta buracos, por exemplo no Windows), opcional AES
criptografia, compactação baseada em zlib e suporte a vários instantâneos de VM.

Opções com suporte:

"compat"
Determina a versão qcow2 a ser usada. "compat = 0.10" usa a imagem tradicional
formato que pode ser lido por qualquer QEMU desde 0.10. "compat = 1.1" ativa o formato de imagem
extensões que apenas o QEMU 1.1 e mais recentes entendem (este é o padrão). Entre
outros, isso inclui zero clusters, que permitem cópia na leitura eficiente para esparsos
imagens.

"backing_file"
Nome do arquivo de uma imagem de base (ver crio subcomando)

"backing_fmt"
Formato de imagem da imagem base

"criptografia"
Se essa opção for definida como "on", a imagem será criptografada com AES-CBC de 128 bits.

O uso de criptografia em imagens qcow e qcow2 é considerado falha por
padrões de criptografia modernos, sofrendo de uma série de problemas de design:

-
no número do setor. Isso o torna vulnerável a ataques de texto simples escolhidos
que pode revelar a existência de dados criptografados.

-
a senha escolhida ou curta comprometerá a segurança da criptografia.

-
mude a senha para proteger os dados em qualquer imagem qcow. Os arquivos devem ser
clonado, usando uma senha de criptografia diferente no novo arquivo. O original
o arquivo deve ser apagado com segurança usando um programa como o shred, embora mesmo este
é ineficaz com muitas tecnologias de armazenamento modernas.

O uso da criptografia qcow / qcow2 é, portanto, fortemente desencorajado. Usuários são recomendados
para usar uma tecnologia de criptografia alternativa, como o Linux dm-crypt / LUKS
sistema.

"cluster_size"
Altera o tamanho do cluster qcow2 (deve estar entre 512 e 2M). Tamanhos de cluster menores
pode melhorar o tamanho do arquivo de imagem, enquanto os tamanhos de cluster maiores geralmente fornecem
melhor performance.

"pré-alocação"
Modo de pré-alocação (valores permitidos: "off", "metadata", "falloc", "full"). Uma imagem
com metadados pré-alocados é inicialmente maior, mas pode melhorar o desempenho quando
a imagem precisa crescer. pré-alocações "falloc" e "full" são iguais
opções de formato "bruto", mas também configura metadados.

"lazy_refcounts"
Se esta opção for definida como "ativada", as atualizações da contagem de referência serão adiadas com a meta
de evitar E / S de metadados e melhorar o desempenho. Isto é particularmente
interessante com cache = writeethrough que não agrupa atualizações de metadados. o
compensação é que, após uma falha do host, as tabelas de contagem de referência devem ser reconstruídas,
ou seja, na próxima abertura, um "qemu-img check -r all" (automático) é necessário, o que
pode levar algum tempo.

Esta opção só pode ser ativada se "compat = 1.1" for especificado.

"nocow"
Se esta opção for configurada para "on", irá desligar o COW do arquivo. Só é válido
no btrfs, nenhum efeito em outros sistemas de arquivos.

Btrfs tem baixo desempenho ao hospedar um arquivo de imagem VM, ainda mais quando o convidado
na VM também usando btrfs como sistema de arquivos. Desligar COW é uma forma de mitigar
este mau desempenho. Geralmente, existem duas maneiras de desligar o COW no btrfs: a)
Desative-o montando com nodatacow, então todos os arquivos recém-criados serão NOCOW.
b) Para um arquivo vazio, adicione o atributo de arquivo NOCOW. É isso que essa opção faz.

Nota: esta opção só é válida para arquivos novos ou vazios. Se houver um existente
arquivo que é COW e já tem blocos de dados, não poderia ser alterado para NOCOW por
definindo "nocow = on". Pode-se emitir "nome do arquivo lsattr" para verificar se o sinalizador NOCOW é
definido ou não ('C' maiúsculo é a bandeira NOCOW).

Outros
QEMU também suporta vários outros formatos de arquivo de imagem para compatibilidade com QEMU mais antigo
versões ou outros hipervisores, incluindo VMDK, VDI, VHD (vpc), VHDX, qcow1 e QED.
Para uma lista completa dos formatos suportados, consulte "qemu-img --help". Para um mais detalhado
descrição desses formatos, consulte a documentação do usuário da emulação QEMU.

O principal objetivo dos drivers de bloco para esses formatos é a conversão de imagens. Para
executando VMs, é recomendável converter as imagens de disco em raw ou qcow2 em
a fim de alcançar um bom desempenho.

Use qemu-img online usando serviços onworks.net