virsh - On-line na nuvem

PROGRAMA:

NOME

virsh – interface de usuário de gerenciamento

SINOPSE

Virsh [OPÇÃO] ... [COMMAND_STRING]

Virsh [OPÇÃO] ... COMANDO [ARG] ...

DESCRIÇÃO

O Virsh programa é a interface principal para gerenciar domínios convidados virsh. O programa pode
ser usado para criar, pausar e encerrar domínios. Também pode ser usado para listar os atuais
domínios. Libvirt é um kit de ferramentas C para interagir com os recursos de virtualização de tecnologias recentes.
versões do Linux (e outros sistemas operacionais). É um software livre disponível sob a licença GNU Lesser
Licença Pública Geral. Virtualização do sistema operacional Linux significa a capacidade de
executar múltiplas instâncias de sistemas operacionais simultaneamente em um único sistema de hardware onde
os recursos básicos são controlados por uma instância Linux. A biblioteca tem como objetivo proporcionar um longo
API C estável a prazo. Atualmente suporta Xen, QEMU, KVM, LXC, OpenVZ, VirtualBox e
VMware ESX.

A estrutura básica da maior parte do uso do virsh é:

virsh [OPÇÃO]... [ARG]...

Onde comando é um dos comandos listados abaixo; domínio é o ID numérico do domínio ou o
nome de domínio ou UUID do domínio; e ARGS são opções específicas de comando. Existem alguns
exceções a esta regra nos casos em que o comando em questão atue em todos os domínios,
toda a máquina ou diretamente no hipervisor xen. Essas exceções ficarão claras para
cada um desses comandos. Nota: é permitido dar nomes numéricos aos domínios,
no entanto, isso resultará em um domínio que só pode ser identificado pelo ID do domínio. Em
outras palavras, se um valor numérico for fornecido, ele será interpretado como um ID de domínio, não como
um nome.

O Virsh programa pode ser usado para executar um COMANDO dando o comando e seu
argumentos na linha de comando do shell, ou um COMMAND_STRING que é um único argumento de shell
consistindo em múltiplos COMANDO ações e seus argumentos unidos com espaços em branco, e
separados por ponto e vírgula entre os comandos. Dentro de COMMAND_STRING, virsh entende o
mesmos escapes simples, duplos e de barra invertida do shell, embora você deva adicionar outro
camada de shell escapando ao criar o único argumento de shell. Se nenhum comando for dado em
a linha de comando, Virsh irá então iniciar um intérprete mínimo aguardando seus comandos,
e desistir o comando sairá do programa.

O Virsh programa entende o seguinte OPÇÕES.

-c, --conectar URI
Conecte-se ao especificado URI, como se pelo connect comando, em vez do padrão
conexão.

-d, --depurar NÍVEL
Habilitar mensagens de depuração em número inteiro NÍVEL e acima. NÍVEL pode variar de 0 a 4
(predefinição). Veja a documentação de VIRSH_DEBUG variável de ambiente abaixo para o
descrição de cada NÍVEL.

-e, --fuga corda
Definir sequência de escape alternativa para consolá comando. Por padrão, o telnet ^] é usado.
Os caracteres permitidos ao usar a notação hat são: caractere alfabético, @, [, ], \, ^,
_.

-h, --Socorro
Ignore todos os outros argumentos e se comporte como se o ajudar comando foi dado em vez disso.

-k, --keepalive-intervalo INTERVALO
Defina um INTERVALO (em segundos) para enviar mensagens de manutenção de atividade para verificar se
a conexão com o servidor ainda está ativa. Definir o intervalo como 0 desativa o cliente
mecanismo de manutenção de atividade.

-K, --keepalive-count CONTAGEM
Defina um número de vezes que a mensagem keepalive pode ser enviada sem obter uma resposta do
servidor sem marcar a conexão como morta. Não há efeito nesta configuração em
caso o INTERVALO está definido para 0.

-l, --registro ARQUIVO
Detalhes de registro de saída para ARQUIVO.

-q, --quieto
Evite mensagens informativas extras.

-r, --somente leitura
Torne a conexão inicial somente leitura, como se fosse pelo --somente leitura opção do connect
comando.

-t, --cronometragem
Gere informações de tempo decorrido para cada comando.

-v, --version [= short]
Ignore todos os outros argumentos e imprima a versão da biblioteca libvirt que virsh é
vindo de

-V, --version = long
Ignore todos os outros argumentos e imprima a versão da biblioteca libvirt que virsh é
vindo e quais opções e driver são compilados.

NOTAS

Os mais Virsh operações dependem da biblioteca libvirt ser capaz de se conectar a um já
executando o serviço libvirtd. Geralmente isso pode ser feito usando o comando invocar-rc.d libvirtd
começo.

Os mais Virsh comandos requerem privilégios de root para serem executados devido aos canais de comunicação usados
para falar com o hipervisor. Executar como não root retornará um erro.

Os mais Virsh os comandos agem de forma síncrona, exceto talvez shutdown, setvcpus e setmem. Em
nesses casos o facto de o Virsh programa retornado, pode não significar que a ação foi concluída
e você deve pesquisar periodicamente para detectar se o convidado concluiu a operação.

Virsh busca compatibilidade com versões anteriores. Apesar de ajudar comando lista apenas o
uso preferencial de um comando, se uma versão mais antiga do Virsh apoiou uma grafia alternativa
de um comando ou opção (como --túnel em vez de --túnel), então scripts usando
essa ortografia antiga continuará a funcionar.

Vários Virsh os comandos recebem um número inteiro escalado opcionalmente; se nenhuma escala for fornecida, então
o padrão está listado no comando (por razões históricas, alguns comandos são padronizados para
bytes, enquanto outros comandos são padronizados para kibibytes). O seguinte não diferencia maiúsculas de minúsculas
sufixos podem ser usados ​​para selecionar uma escala específica:
b, byte byte 1
KB quilobyte 1,000
k, KiB kibibyte 1,024
MB megabyte 1,000,000
M, MiB mebibyte 1,048,576
GB gigabyte 1,000,000,000
G, GiB gibibyte 1,073,741,824
TB terabyte 1,000,000,000,000
T, TiB tebibyte 1,099,511,627,776
PB petabyte 1,000,000,000,000,000
P, PiB pebibyte 1,125,899,906,842,624
EB exabyte 1,000,000,000,000,000,000
E, EiB exbibyte 1,152,921,504,606,846,976

GENÉRICO COMANDOS

Os comandos a seguir são genéricos, ou seja, não específicos de um domínio.

ajudar [comando ou grupo]
Isso lista cada um dos comandos virsh. Quando usados ​​sem opções, todos os comandos são
listados, um por linha, agrupados em categorias relacionadas, exibindo a palavra-chave para cada
grupo.

Para exibir apenas comandos para um grupo específico, forneça a palavra-chave desse grupo como um
opção. Por exemplo:

virsh # ajuda o host

Host e hipervisor (palavra-chave de ajuda 'host'):
capacidades capacidades
cpu-models mostram os modelos de CPU para uma arquitetura
conectar (re)conectar ao hipervisor
memória livre NUMA freecell
nome do host imprime o nome do host do hipervisor
qemu-attach Anexar ao processo QEMU existente
qemu-monitor-command Comando de monitoramento QEMU
qemu-agent-command Comando do agente convidado QEMU
sysinfo imprime o hipervisor sysinfo
uri imprime o URI canônico do hipervisor

Para exibir informações detalhadas de um comando específico, forneça seu nome como opção
em vez de. Por exemplo:

virsh # lista de ajuda
NOME
lista - lista domínios

SINOPSE
lista [--inativo] [--todos]

DESCRIÇÃO
Retorna lista de domínios.

OPÇÕES
--inactive lista domínios inativos
--all lista domínios inativos e ativos

desistir, saída
saia deste terminal interativo

versão [--daemon]
Irá imprimir as informações da versão principal sobre a partir da qual foi construído. Se --daemon is
especificado, então a versão do daemon libvirt será incluída na saída.

Exemplo

$ virsh versão
Compilado com a biblioteca: libvirt 1.2.3
Usando a biblioteca: libvirt 1.2.3
Usando API: QEMU 1.2.3
Executando hipervisor: QEMU 2.0.50

$ virsh versão --daemon
Compilado com a biblioteca: libvirt 1.2.3
Usando a biblioteca: libvirt 1.2.3
Usando API: QEMU 1.2.3
Executando hipervisor: QEMU 2.0.50
Executando contra daemon: 1.2.6

cd [anuário]
Irá mudar o diretório atual para anuário. O diretório padrão para o cd comando
é o diretório inicial ou, se não houver INICIO variável no ambiente, a raiz
diretório.

Este comando está disponível apenas no modo interativo.

pwd Irá imprimir o diretório atual.

connect [URI] [--somente leitura]
(Re)-Conecte-se ao hipervisor. Quando o shell é iniciado pela primeira vez, isso é automaticamente
correr com o URI parâmetro solicitado pela opção "-c" na linha de comando. O URI
parâmetro especifica como se conectar ao hipervisor. A página de documentação em
<http://libvirt.org/uri.html> liste os valores suportados, mas os mais comuns são:

xen: ///
isso é usado para conectar-se ao hipervisor Xen local

qemu: /// system
conectar-se localmente como root ao daemon que supervisiona os domínios QEMU e KVM

qemu: /// sessão
conectar-se localmente como um usuário normal ao seu próprio conjunto de domínios QEMU e KVM

lxc: ///
conectar-se a um contêiner Linux local

Para encontrar o URI usado atualmente, verifique o Ligações comando documentado abaixo.

Para acesso remoto, consulte a página de documentação emhttp://libvirt.org/uri.html> sobre como
para fazer URIs. O --somente leitura opção permite conexão somente leitura

Ligações Imprime o URI canônico do hipervisor, pode ser útil no modo shell.

hostname
Imprima o nome do host do hipervisor.

Sysinfo
Imprima a representação XML do hipervisor sysinfo, se disponível.

informações do nó
Retorna informações básicas sobre o nó, como número e tipo de CPU e tamanho do
memória física. A saída corresponde à estrutura virNodeInfo. Especificamente, o
O campo "soquete(s) de CPU" significa o número de soquetes de CPU por célula NUMA. A informação
A exibição da libvirt depende do que cada arquitetura pode fornecer.

nodecpumap [--bonito]
Exibe o número total de CPUs do nó, o número de CPUs online e a lista de
CPUs on-line.

Com --bonito as CPUs online são impressas como um intervalo em vez de uma lista.

nodecpustats [cpu] [--por cento]
Retorna estatísticas de CPU do nó. Se cpu é especificado, isso imprimirá a CPU especificada
apenas estatísticas. Se --por cento é especificado, isso imprimirá a porcentagem de cada tipo
de estatísticas da CPU durante 1 segundo.

nodememstats [célula]
Retorna estatísticas de memória do nó. Se célula é especificado, isso imprimirá especificado
apenas estatísticas de células.

nós suspender [alvo] [duração]
Coloca o nó (máquina host) em um estado de suspensão em todo o sistema e agenda o
Interrupção Real-Time-Clock para retomar o nó após o tempo especificado por
duração está fora. alvo especifica o estado para o qual o host será suspenso,
pode ser "mem" (suspender para RAM), "disco" (suspender para disco) ou "híbrido" (suspender para
RAM e disco). duração especifica o tempo de duração em segundos durante o qual o
host deve ser suspenso, deve levar pelo menos 60 segundos.

ajuste de memória de nó [shm-páginas para digitalizar] [shm-sleep-milissegundos] [shm-mesclagem entre nós]
Permite exibir ou definir os parâmetros de memória do nó. shm-páginas para digitalizar pode ser
usado para definir o número de páginas a serem digitalizadas antes que o serviço de memória compartilhada vá para
dormir shm-sleep-milissegundos pode ser usado para definir o número de milissegundos que o compartilhamento
o serviço de memória deve dormir antes da próxima varredura; shm-mesclagem entre nós especifica se
páginas de diferentes nós numa podem ser mescladas. Quando definido como 0, apenas as páginas que
residir fisicamente na área de memória do mesmo nó NUMA pode ser mesclado. Quando definido como 1,
páginas de todos os nós podem ser mescladas. Padrão para 1.

Observação: Atualmente, o "serviço de memória compartilhada" significa apenas KSM (Kernel Samepage Merging).

capacidades
Imprima um documento XML descrevendo os recursos do hipervisor que estamos atualmente
conectado a. Isto inclui uma seção sobre as capacidades do host em termos de CPU e
recursos e um conjunto de descrições para cada tipo de convidado que pode ser virtualizado.
Para uma descrição mais completa consulte:
<http://libvirt.org/formatcaps.html> O XML também mostra as informações da topologia NUMA
se disponível.

domcapacidades [virttype] [emuladorbin] [arco] [máquina]
Imprima um documento XML descrevendo os recursos de domínio do hipervisor que estamos
conectado ao uso de informações provenientes de um domínio existente ou retiradas de
da Virsh capacidades saída. Isto pode ser útil se você pretende criar um novo domínio
e está curioso para saber se, por exemplo, poderia fazer uso do VFIO criando um domínio para o
hipervisor com emulador e arquitetura específicos.

Cada hipervisor terá requisitos diferentes em relação às opções necessárias
e quais são opcionais. Um hipervisor pode oferecer suporte ao fornecimento de um valor padrão para qualquer um dos
as opções.

O virttype A opção especifica o tipo de virtualização usado. O valor a ser utilizado é
seja do atributo 'type' do elemento de nível superior do domínio
XML ou o atributo 'type' encontrado em cada elemento do Virsh
capacidades saída. o emuladorbin opção especifica o caminho para o emulador. O
valor a ser usado é o elemento no domínio XML ou no Virsh
capacidades saída. o arco opção especifica a arquitetura a ser usada para o
domínio. O valor a ser usado é o atributo "arch" do XML do domínio
elemento e subelemento ou o atributo "nome" de um elemento
do Virsh capacidades saída. o máquina especifica o tipo de máquina para o
emulador. O valor a ser usado é o atributo "máquina" do XML do domínio
elemento e subelemento ou um de uma lista de máquinas do Virsh
capacidades saída para uma arquitetura e tipo de domínio específicos.

Para o hipervisor qemu, um virttype de 'qemu' ou 'kvm' deve ser fornecido junto
com o emuladorbin or arco para gerar saída para o padrão
máquina. Fornecendo um máquina valor gerará saída para a máquina específica.

injetar-nmi domínio
Injete NMI no convidado.

Lista [--inativo | --tudo] [--gerenciado-salvar] [--título] {[--tabela] --nome | --uuid }
[--persistente] [--transitório] [--com-salvamento gerenciado] [--sem-salvamento gerenciado] [--começo automático]
[--no-autostart] [--com-instantâneo] [--sem instantâneo] [--estado em execução] [--estado pausado]
[--state-shutoff] [--estado-outro]
Imprime informações sobre domínios existentes. Se nenhuma opção for especificada, ele imprimirá
informações sobre a execução de domínios.

Um exemplo de formato para a lista é o seguinte:

Virsh Lista
Id Nome Estado
-------------------------------------------------- -
0 Domínio-0 em execução
2 fedora pausado

Nome é o nome do domínio. ID o ID numérico do domínio. Estado é o estado de execução
(ver abaixo).

ESTADOS

O campo Estado lista 8 estados para um domínio e em quais deles o domínio atual está.

que ocorre
O domínio está atualmente em execução em uma CPU

inativo
O domínio está inativo e não está em execução nem pode ser executado. Isto pode ser causado porque o
domínio está aguardando IO (um estado de espera tradicional) ou entrou em suspensão porque
não havia mais nada para fazer.

pausada
O domínio foi pausado, geralmente ocorrendo por meio do administrador executando
Virsh suspender. Quando estiver em estado de pausa, o domínio ainda consumirá
recursos como memória, mas não serão elegíveis para agendamento pelo hipervisor.

encerramento
O domínio está em processo de encerramento, ou seja, o sistema operacional convidado foi
foi notificado e deverá estar em processo de interromper suas operações normalmente.

fechar WOW!
O domínio não está em execução. Geralmente isso indica que o domínio foi encerrado
completamente ou não foi iniciado.

caiu
O domínio caiu, o que é sempre um final violento. Normalmente, este estado pode
ocorrerá apenas se o domínio tiver sido configurado para não reiniciar em caso de falha.

morte
O domínio está em processo de extinção, mas não foi encerrado ou travado completamente.

pmsuspenso
O domínio foi suspenso pelo gerenciamento de energia do convidado, por exemplo, inserido no s3
Estado.

Normalmente, apenas os domínios ativos são listados. Para listar domínios inativos especifique --inativo
or --tudo para listar domínios ativos e inativos.

Para filtrar ainda mais a lista de domínios, você pode especificar um ou mais sinalizadores de filtragem
suportado pela Lista comando. Esses sinalizadores são agrupados por função. Especificando um ou
mais sinalizadores de um grupo ativam o grupo de filtros. Observe que algumas combinações de sinalizadores
pode não produzir resultados. Sinalizadores e grupos de filtragem suportados:

Persistência
Bandeira --persistente é usado para incluir domínios persistentes na lista retornada. Para
incluir domínios transitórios especificar --transitório.

Existência of gerenciados salvar imagem
Para listar domínios com uma imagem salva gerenciada, especifique o sinalizador --com-salvamento gerenciado. Para
domínios que não possuem uma imagem de salvamento gerenciada especificam --sem-salvamento gerenciado.

Domínio estado
Os seguintes sinalizadores de filtro selecionam um domínio por seu estado: --estado em execução for
executando domínios, --estado pausado para domínios pausados, --state-shutoff para virado
fora de domínios e --estado-outro para todos os outros estados como alternativa.

Inicialização automática domínios
Para listar domínios de inicialização automática, use o sinalizador --começo automático. Para listar domínios com este
recurso desativado uso --no-autostart.

Instantâneo existência
Domínios que possuem imagens instantâneas podem ser listados usando sinalizador --com-instantâneo,
domínios sem snapshot --sem instantâneo.

Ao conversar com servidores mais antigos, este comando é forçado a usar uma série de chamadas de API
com uma corrida inerente, onde um domínio pode não estar listado ou pode aparecer mais de
uma vez se mudasse de estado entre as chamadas enquanto a lista estava sendo coletada. Mais recente
servidores não têm esse problema.

If --gerenciado-salvar é especificado, então os domínios que gerenciam o estado de salvamento (somente
possível se eles estiverem no fechar WOW! estado, então você precisa especificar --inativo or --tudo
para realmente listá-los) será exibido como salvo na listagem. Esta bandeira é utilizável
somente com o padrão --tabela saída. Observe que este sinalizador não filtra a lista de
domínios.

If --nome é especificado, os nomes de domínio são impressos em vez do formato de tabela
por linha. Se --uuid é especificado que os UUIDs do domínio são impressos em vez de nomes. Bandeira
--tabela especifica que a saída formatada em tabela herdada deve ser usada. Isto é o
padrão. Todos estes são mutuamente exclusivos.

If --título é especificado, então a breve descrição do domínio (título) é impressa em um
coluna extra. Este sinalizador é utilizável apenas com o padrão --tabela saída.

Exemplo:

Virsh lista --título
Id Nome Estado Título
-------------------------------------------------- ------------------------
0 Domínio-0 executando Mailserver 1
2 fedora pausado

freecell [{[--cellno] celular | --tudo }]
Imprime a quantidade de memória disponível na máquina ou em uma célula NUMA. O
O comando freecell pode fornecer uma das três exibições diferentes de memória disponível em
a máquina dependendo das opções especificadas. Sem opções, ele exibe o
memória livre total na máquina. Com a opção --all, exibe a memória livre
em cada célula e o total de memória livre na máquina. Finalmente, com um número
argumento ou com --cellno mais um número de célula exibirá a memória livre para o
apenas célula especificada.

páginas gratuitas [{[--cellno] celular [--tamanho da página] tamanho da página | --tudo }]
Imprime a quantidade disponível de páginas em uma célula NUMA. celular refere-se ao NUMA
celular em que você está interessado. tamanho da página é um número inteiro escalonado (veja NOTAS acima).
Alternativamente, se --tudo é usado, informações sobre cada combinação possível de célula NUMA e
o tamanho da página é impresso.

alocações [--tamanho da página] tamanho da página [--contagem de páginas] contagem de páginas [[--cellno] celular] [--adicionar]
[--tudo]
Alterar o tamanho do conjunto de páginas de tamanho da página no host. Se --adicionar é especificado, então
contagem de páginas páginas são adicionadas ao pool. No entanto, se --adicionar não foi especificado, então o
contagem de páginas é considerado o novo tamanho absoluto do pool (isso pode ser usado para liberar alguns
páginas e dimensionar o pool para baixo). O celular modificador pode ser usado para restringir o
modificação para uma única célula NUMA hospedeira. No outro extremo do espectro está --tudo
que executa a modificação em todas as células NUMA.

linha de base da CPU ARQUIVO [--recursos] [--migratável]
Calcule a CPU de linha de base que será suportada por todas as CPUs host fornecidas em . O
lista de CPUs host é construída extraindo todos elementos do . Assim, o
pode conter um conjunto de elementos separados por novas linhas ou mesmo um conjunto
de completo elementos impressos por capacidades comando. Se --recursos is
especificado, a descrição XML resultante incluirá explicitamente todos os recursos que
compõem a CPU, sem esta opção os recursos que fazem parte do modelo da CPU não serão
ser listado na descrição XML. Se --migratável é especificado, recursos que bloqueiam
a migração não será incluída na CPU resultante.

comparação de CPU ARQUIVO [--erro]
Compare a definição de CPU do XML com CPU host. O XML pode conter
definição de CPU host ou convidada. A definição da CPU host é a elemento e
seu conteúdo conforme impresso por capacidades comando. A definição da CPU convidada é a
elemento e seu conteúdo da definição XML do domínio. Para obter mais informações sobre CPU convidada
definição veja:http://libvirt.org/formatdomain.html#elementsCPU>. Se --erro is
especificado, o comando retornará um erro quando a CPU fornecida for incompatível com
CPU host e uma mensagem fornecendo mais detalhes sobre a incompatibilidade será
impresso.

modelos de CPU arco
Imprima a lista de modelos de CPU conhecidos para a arquitetura especificada.

eco [- concha] [--xml] [arg...]
Ecoe de volta cada arg, separados por espaço. Se - concha é especificado, então a saída será
estar entre aspas simples quando necessário, para que seja adequado para reutilização em um contexto de shell.
If --xml for especificado, a saída terá escape para uso em XML.

DOMÍNIO COMANDOS

Os comandos a seguir manipulam domínios diretamente, conforme declarado anteriormente, a maioria dos comandos
tome domínio como o primeiro parâmetro. O domínio pode ser especificado como um número inteiro curto, um nome
ou um UUID completo.

começo automático [--desativar] domínio
Configure um domínio para ser iniciado automaticamente na inicialização.

A opção --desativar desativa a inicialização automática.

consolá domínio [nome do desenvolvedor] [--seguro] [--força]
Conecte o console serial virtual para o convidado. O opcional nome do desenvolvedor parâmetro
refere-se ao alias do dispositivo de um console alternativo, dispositivo serial ou paralelo
configurado para o convidado. Se omitido, o console principal será aberto.

Se a bandeira --seguro for especificado, a conexão só será tentada se o driver
suporta manuseio seguro do console. Este sinalizador especifica que o servidor deve garantir
acesso exclusivo a dispositivos de console. Opcionalmente o --força bandeira pode ser especificada,
solicitando a desconexão de quaisquer sessões existentes, como no caso de uma interrupção
conexão.

crio ARQUIVO [--console] [--pausado] [--autodestruir] [--pass-fds N,M,...]
Crie um domínio a partir de um XML . Uma maneira fácil de criar o XML é usar o
dumpxml comando para obter a definição de um convidado pré-existente. O domínio será
pausado se o --pausado opção é usada e suportada pelo driver; caso contrário, será
estar correndo. Se --console for solicitado, anexe ao console após a criação. Se
--autodestruir for solicitado, o convidado será automaticamente destruído quando virsh
fecha sua conexão com a libvirt ou sai de outra forma.

If --pass-fds é especificado, o argumento é uma lista separada por vírgula de arquivos abertos
descritores que devem ser repassados ​​ao hóspede. Os descritores de arquivo serão re-
numerado no convidado, começando em 3. Isso só é suportado com base em contêiner
virtualização.

Exemplo

virsh dumpxml > domínio.xml
vi domain.xml (ou faça alterações com seu outro editor de texto)
virsh criar domínio.xml

definir ARQUIVO
Defina um domínio a partir de um XML . A definição de domínio está registrada, mas não
iniciado. Se o domínio já estiver em execução, as alterações entrarão em vigor na próxima inicialização.

desc domínio [[--viver] [--config] | [--atual]] [--título] [--editar] [--new-desc Novo
descrição ou mensagem de título]
Mostre ou modifique a descrição e o título de um domínio. Esses valores são campos de usuário que
permitem armazenar dados textuais arbitrários para permitir fácil identificação de domínios. Título
deve ser curto, embora não seja obrigatório. (Veja também metadados que funciona com XML
metadados de domínio baseados.)

Bandeiras --viver or --config selecione se este comando funciona em tempo real ou persistente
definições do domínio. Se ambos --viver e --config são especificados, o --config
opção tem precedência na obtenção da descrição atual e da configuração ao vivo
e a configuração são atualizadas ao definir a descrição. --atual é exclusivo e
implícito se nada disso foi especificado.

Bandeira --editar especifica que um editor com o conteúdo da descrição ou título atual
deve ser aberto e o conteúdo salvo posteriormente.

Bandeira --título seleciona a operação no campo de título em vez da descrição.

Se nenhum de --editar e --new-desc são especificados a nota ou descrição é exibida
em vez de ser modificado.

destruir domínio [--gracioso]
Encerrar imediatamente o domínio domínio. Isso não dá nenhuma chance ao sistema operacional do domínio
reagir, e é o equivalente a arrancar o cabo de alimentação de uma máquina física.
Na maioria dos casos você vai querer usar o encerramento comando em vez disso. No entanto, isso faz
não exclua nenhum volume de armazenamento usado pelo convidado e, se o domínio for persistente,
pode ser reiniciado mais tarde.

If domínio for transitório, os metadados de quaisquer instantâneos serão perdidos assim que o convidado
para de ser executado, mas o conteúdo do snapshot ainda existe e um novo domínio com o mesmo
nome e UUID podem restaurar os metadados do instantâneo com criação de instantâneo.

If --gracioso é especificado, não recorra a medidas extremas (por exemplo, SIGKILL) quando o
o convidado não para após um tempo limite razoável; retornar um erro.

domblkstat domínio [dispositivo de bloco] [--humano]
Obtenha estatísticas de bloqueio de dispositivos para um domínio em execução. A dispositivo de bloco corresponde a um único
nome do destino ( ) ou arquivo de origem ( ) para um dos
os dispositivos de disco conectados a domínio (Ver também lista domblk para listar esses nomes). Sobre
um domínio lxc ou qemu, omitindo o dispositivo de bloco produz estatísticas de bloqueio de dispositivo resumidamente
para todo o domínio.

Uso --humano para uma saída mais legível por humanos.

A disponibilidade desses campos depende do hipervisor. Campos não suportados estão faltando
da saída. Outros campos podem aparecer se você estiver se comunicando com uma versão mais recente do
libvirtd.

Explicação of Campos (os campos aparecem na seguinte ordem):
rd_req - contagem de operações de leitura
rd_bytes - contagem de bytes lidos
wr_req - contagem de operações de gravação
wr_bytes - contagem de bytes gravados
erra - contagem de erros
flush_operações - contagem de operações de liberação
rd_total_times - tempo total que as operações de leitura levaram (ns)
wr_total_times - tempo total que as operações de gravação levaram (ns)
flush_total_times - tempo total que as operações de liberação levaram (ns)
<-- outros campos fornecidos pelo hipervisor -->

domifaddr domínio [interface] [--cheio] [--fonte locatário | agente]
Obtenha uma lista de interfaces de um domínio em execução junto com seus endereços IP e MAC, ou
saída limitada apenas para uma interface se interface é especificado. Observe que interface
pode depender do driver, pode ser o nome no sistema operacional convidado ou o nome que você veria
no domínio XML. Além disso, todo o comando pode exigir que um agente convidado seja configurado
para o domínio consultado em alguns drivers, principalmente qemu. Se --cheio é especificado, o
o nome da interface é sempre exibido quando a interface tem vários endereços ou alias,
caso contrário, ele exibirá apenas o nome da interface para o primeiro endereço e "-" para o
outros. o --fonte argumento especifica qual fonte de dados usar para os endereços,
atualmente um de 'lease' para ler concessões de DHCP ou 'agente' para consultar o sistema operacional convidado por meio de um
agente. Se não for especificado, 'lease' será o padrão.

domifstat domínio dispositivo de interface
Obtenha estatísticas de interface de rede para um domínio em execução.

domif-setlink domínio dispositivo de interface estado [--config]
Modifique o estado do link da interface virtual do domínio. Os valores possíveis para o estado são
"para cima e para baixo". Se --config é especificado, apenas a configuração persistente do
domínio é modificado, para fins de compatibilidade, --persistente é apelido de --config.
dispositivo de interface pode ser o nome de destino da interface ou o endereço MAC.

domif-getlink domínio dispositivo de interface [--config]
Consultar o estado do link da interface virtual do domínio. Se --config é especificado, consulta
a configuração persistente, para fins de compatibilidade, --persistente é apelido de
--config.

dispositivo de interface pode ser o nome de destino da interface ou o endereço MAC.

domínio domínio dispositivo de interface [[--config] [--viver] | [--atual]] [--entrada
média, pico, explosão, piso] [--saída média, pico, explosão]
Defina ou consulte os parâmetros de largura de banda da interface de rede do domínio. dispositivo de interface
pode ser o nome de destino da interface ( ) ou o endereço MAC.

Se nenhum --entrada or --saída é especificado, este comando irá consultar e mostrar o
configurações de largura de banda. Caso contrário, definirá a largura de banda de entrada ou saída.
média, pico, explosão, piso é o mesmo que no comando interface de anexação. Valores para
média, pico e andar são expressos em kilobytes por segundo, enquanto explosão is
expresso em kilobytes em uma única explosão em pico velocidade conforme descrito no XML da rede
documentação emhttp://libvirt.org/formatnetwork.html#elementoQoS>.

Para limpar as configurações de entrada ou saída, use --entrada or --saída respeitosamente com
valor médio de zero.

If --viver é especificado, afeta um convidado em execução. Se --config é especificado, afeta o
próxima inicialização de um convidado persistente. Se --atual é especificado, afeta o convidado atual
estado. Ambos --viver e --config bandeiras podem ser dadas, mas --atual é exclusivo. Se não
sinalizador é especificado, o comportamento é diferente dependendo do hipervisor.

dommemstat domínio [--período segundo] [[--config] [--viver] | [--atual]]
Obtenha estatísticas de memória para um domínio em execução.

Dependendo do hipervisor, uma variedade de estatísticas podem ser retornadas

Para QEMU/KVM com balão de memória, configurando o opcional --período para um valor maior
que 0 em segundos permitirá que o balão driver retorne estatísticas adicionais que
será exibido nos próximos dommemstat comandos. Configurando o --período para 0 vai
interrompe a coleta do driver do balão, mas não limpa as estatísticas do balão
motorista. Requer pelo menos QEMU/KVM 1.5 em execução no host.

O --viver, --config e --atual sinalizadores são válidos apenas ao usar o --período
opção para definir o período de coleta do balão driver. Se --viver is
especificado, apenas o período de coleta de convidados em execução será afetado. Se --config is
especificado, afetará a próxima inicialização de um convidado persistente. Se --atual é especificado,
afetar o estado atual do convidado.

Ambos --viver e --config bandeiras podem ser dadas, mas --atual é exclusivo. Se nenhuma bandeira for
especificado, o comportamento é diferente dependendo do estado do convidado.

domblkerror domínio
Mostrar erros em dispositivos de bloco. Este comando geralmente é útil quando estado dom comando
diz que um domínio foi pausado devido a um erro de E/S. O domblkerror comando lista tudo
bloquear dispositivos em estado de erro e o erro visto em cada um deles.

domblkinfo domínio dispositivo de bloco
Obtenha informações sobre o tamanho do dispositivo de bloco para um domínio. A dispositivo de bloco corresponde a um único
nome do destino ( ) ou arquivo de origem ( ) para um dos
os dispositivos de disco conectados a domínio (Ver também lista domblk para listar esses nomes).

lista domblk domínio [--inativo] [--detalhes]
Imprima uma tabela mostrando as informações resumidas de todos os dispositivos de bloco associados
domínio. Se --inativo for especificado, consulte os dispositivos de bloco que serão usados ​​no
próxima inicialização, em vez daqueles atualmente em uso por um domínio em execução. Se --detalhes is
especificado, o tipo de disco e o valor do dispositivo também serão impressos. Outros contextos que
requerem um nome de dispositivo de bloco (como domblkinfo or criação de instantâneo para instantâneos de disco)
aceitará nomes de destino ou de origem exclusivos impressos por este comando.

domstats [--cru] [--impor] [--apoio] [--Estado] [--cpu-total] [--balão] [--vcpu]
[--interface] [--bloquear] [[--list-ativo] [--list-inativo] [--list-persistente]
[--list-transitório] [--list-executando] [--list-pausado] [--list-shutoff] [--lista-outro]] |
[domínio ...]
Obtenha estatísticas para vários ou todos os domínios. Sem qualquer argumento este comando imprime
todas as estatísticas disponíveis para todos os domínios.

A lista de domínios para os quais coletar estatísticas pode ser limitada listando os domínios
como uma lista separada por espaços ou especificando um dos sinalizadores de filtragem --Lista-*. (O
abordagens não podem ser combinadas.)

Por padrão alguns dos campos retornados podem ser convertidos para valores mais amigáveis
por um conjunto de impressoras bonitas. Para suprimir esse comportamento, use o --cru bandeira.

Os grupos de estatísticas individuais podem ser selecionados através de sinalizadores específicos. Por padrão, todos
grupos de estatísticas suportados são retornados. Os sinalizadores de grupos de estatísticas suportados são:
--Estado, --cpu-total, --balão, --vcpu, --interface, --bloquear.

Ao selecionar o --Estado grupo os seguintes campos são retornados: "state.state" -
estado da VM, retornado como número do enum virDomainState, "state.reason" - motivo
para entrar em determinado estado, retornado como int de virDomain*Reason enum correspondente a
determinado estado.

--cpu-total retorna: "cpu.time" - tempo total de CPU gasto para este domínio em nanossegundos,
"cpu.user" - tempo de CPU do usuário gasto em nanossegundos, "cpu.system" - tempo de CPU do sistema gasto
em nanossegundos

--balão retorna: "balloon.current" - a memória em kiB usada atualmente,
"balloon.maximum" - a memória máxima permitida em kiB

--vcpu retorna: "vcpu.current" - número atual de CPUs virtuais online, "vcpu.maximum"
- número máximo de CPUs virtuais online, "vcpu. .state" - estado da CPU virtual
, como número de virVcpuState enum, "vcpu. .time" - tempo de CPU virtual gasto por
CPU virtual

--interface retorna: "net.count" - número de interfaces de rede neste domínio,
"líquido. .name" - nome da interface , "líquido. .rx.bytes" - número de bytes
recebido, "líquido. .rx.pkts" - número de pacotes recebidos, "net. .rx.errs" -
número de erros de recebimento, "net. .rx.drop" - número de pacotes recebidos descartados,
"líquido. .tx.bytes" - número de bytes transmitidos, "net. .tx.pkts" - número de
pacotes transmitidos, "net. .tx.errs" - número de erros de transmissão,
"líquido. .tx.drop" - número de pacotes de transmissão descartados

--bloquear retorna informações sobre discos associados a cada domínio. Usando o
--apoio flag estende essas informações para cobrir todos os recursos na cadeia de apoio,
em vez do padrão de limitar as informações à camada ativa para cada convidado
disco. As informações listadas incluem: "block.count" - número de dispositivos de bloco sendo
listado, "bloquear. .name" - nome do alvo do dispositivo de bloco (o mesmo
nome para múltiplas entradas se --apoio está presente), "bloquear. .backingIndex" - quando
--apoio está presente, corresponde ao índice listado no domínio XML
para fazer backup de arquivos, "block. .path" - fonte do arquivo do dispositivo de bloco , se for um
arquivo local ou dispositivo de bloco, "block. .rd.reqs" - número de solicitações de leitura,
"bloquear. .rd.bytes" - número de bytes lidos, "block. .rd.times" - tempo total
(ns) gastos em leituras, "block. .wr.reqs" - número de solicitações de gravação,
"bloquear. .wr.bytes" - número de bytes gravados, "block. .wr.times" - tempo total
(ns) gastos em gravações, "block. .fl.reqs" - total de solicitações de liberação,
"bloquear. .fl.times" - tempo total (ns) gasto na limpeza do cache, "block. .erros"
- Somente Xen: o valor 'oo_req', "block. .allocation" - deslocamento do valor mais alto escrito
setor em bytes, "bloco. .capacity" - tamanho lógico do arquivo de origem em bytes,
"bloquear. .physical" - tamanho físico do arquivo de origem em bytes

Selecionar um grupo de estatísticas específico não garante que o daemon suporte o
grupo selecionado de estatísticas. Bandeira --impor força o comando a falhar se o daemon
não suporta o grupo selecionado.

lista domiflista domínio [--inativo]
Imprima uma tabela mostrando as informações resumidas de todas as interfaces virtuais associadas ao
domínio. Se --inativo for especificado, consulte as interfaces virtuais que serão usadas em
na próxima inicialização, em vez daqueles atualmente em uso por um domínio em execução. Outros contextos
que requerem um endereço MAC de interface virtual (como interface de desanexação or domif-
link de configuração) aceitará o endereço MAC impresso por este comando.

confirmação de bloco domínio caminho [largura de banda] [base] [--raso] [topo] [--excluir] [--keep-relativo]
[--esperar [--assíncrono] [--verbose]] [--tempo esgotado segundo] [--ativo] [{--pivô | --keep-overlay}]
Reduza o comprimento de uma cadeia de imagens de apoio, confirmando as alterações no topo da
cadeia (instantâneo ou arquivos delta) em imagens de apoio. Por padrão, este comando
tenta achatar toda a cadeia. Se base e / ou topo são especificados como arquivos
dentro da cadeia de apoio, então a operação é limitada a cometer exatamente isso
parte da cadeia; --raso pode ser usado em vez de base para especificar o imediato
arquivo de backup da imagem superior resultante a ser confirmada. Os arquivos sendo confirmados
são invalidados, possivelmente assim que a operação for iniciada; usando o --excluir
flag tentará remover esses arquivos invalidados após a conclusão bem-sucedida do
a operação de confirmação. Quando o --keep-relativo flag é usado, os caminhos do arquivo de apoio
será mantido relativo.

Quando topo for omitido ou especificado como imagem ativa, também é possível especificar
--ativo para acionar um commit ativo de duas fases. Na primeira fase, topo é copiado para
base e o trabalho só pode ser cancelado, com top ainda contendo dados que ainda não estão na base.
Na segunda fase, topo e base permanecem idênticos até que uma chamada para trabalho de bloco com o
--abortar sinalizador (mantendo top como a imagem ativa que rastreia as alterações daquele ponto em
tempo) ou o --pivô flag (tornando base a nova imagem ativa e invalidando top).

Por padrão, este comando retorna o mais rápido possível e os dados de todo o disco são
cometido em segundo plano; o andamento da operação pode ser verificado com
trabalho de bloco. No entanto, se --esperar for especificado, então este comando será bloqueado até que o
a operação for concluída (ou para --ativo, entra na segunda fase), ou até que a operação
é cancelado porque o opcional tempo limite em segundos ou SIGINT é enviado (geralmente
com "Ctrl-C"). Usando --verbose e o --esperar produzirá status periódico
atualizações. Se o cancelamento do trabalho for acionado, --assíncrono retornará o controle ao usuário como
o mais rápido possível, caso contrário o comando pode continuar bloqueando por mais algum tempo
até que o trabalho de limpeza esteja concluído. Usando --pivô é uma abreviatura para combinar --ativo
--esperar com um automático trabalho de bloco --pivô; e usando --keep-overlay é uma abreviatura para
combinando --ativo --esperar com um automático trabalho de bloco --abortar.

caminho especifica o caminho totalmente qualificado do disco; corresponde a um alvo único
nome ( ) ou arquivo de origem ( ) para um dos discos
dispositivos conectados a domínio (Ver também lista domblk para listar esses nomes). largura de banda
especifica o limite de largura de banda de cópia em MiB/s, embora para qemu possa ser diferente de zero apenas
para um domínio online. Especificar um valor negativo é interpretado como um valor longo sem sinal
valor longo ou essencialmente ilimitado. O hipervisor pode escolher se deseja rejeitar o
valor ou convertê-lo para o valor máximo permitido.

cópia em bloco domínio caminho { dest [formato] [--blockdev] --xml lima } [--raso]
[--reuse-externo] [largura de banda] [--esperar [--assíncrono] [--verbose]] [{--pivô | --Finalizar}]
[--tempo esgotado segundo] [granularidade] [tamanho buff]
Copie uma cadeia de imagens de suporte de disco para um destino. Qualquer dest como o arquivo de destino
nome, ou --xml com o nome de um arquivo XML contendo um nível superior elemento
descrevendo o destino, deve estar presente. Além disso, se dest é dada, formato
deve ser especificado para declarar o formato do destino (se formato é omitido,
então a libvirt reutilizará o formato da fonte, ou com --reuse-externo será
forçado a investigar o formato de destino, o que poderia ser uma potencial falha de segurança).
O comando suporta --cru como um sinalizador booleano sinônimo de --format = raw. Ao usar
dest, o destino será tratado como um arquivo normal, a menos que --blockdev é usado para sinalizar
que é um dispositivo de bloco. Por padrão, este comando nivela toda a cadeia; mas se
--raso é especificado, a cópia compartilha a cadeia de apoio.

If --reuse-externo é especificado, então o destino deve existir e ter suficiente
espaço para guardar a cópia. Se --raso é usado em conjunto com --reuse-externo então
a imagem pré-criada deve ter conteúdo visível para convidado idêntico ao visível para convidado
conteúdo do arquivo de apoio da imagem original. Isto pode ser usado para modificar o
fazendo backup de nomes de arquivos no destino.

Por padrão, o trabalho de cópia é executado em segundo plano e consiste em duas fases.
Inicialmente, o trabalho deve copiar todos os dados da origem e, durante esta fase, o trabalho
só pode ser cancelado para reverter para o disco de origem, sem garantias sobre o
destino. Após a conclusão desta fase, tanto a origem quanto o destino permanecem
espelhado até que uma chamada para trabalho de bloco com o --abortar e --pivô bandeiras giram para
a cópia ou uma ligação sem --pivô deixa o destino como uma cópia fiel daquele
ponto no tempo. No entanto, se --esperar for especificado, então este comando será bloqueado até
a fase de espelhamento começa ou cancele a operação se o opcional tempo limite em segundos
decorre ou SIGINT é enviado (geralmente com "Ctrl-C"). Usando --verbose e o --esperar
produzirá atualizações periódicas de status. Usando --pivô (igual a trabalho de bloco --pivô) ou
--Finalizar (igual a trabalho de bloco --abortar) implica --esperar, e também encerrará o
trabalho de forma limpa, em vez de deixar as coisas na fase de espelhamento. Se o cancelamento do trabalho for
acionado por tempo limite ou por --Finalizar, --assíncrono devolverá o controle ao usuário o mais rápido
possível, caso contrário o comando pode continuar a bloquear por mais algum tempo até
o trabalho foi realmente cancelado.

caminho especifica o caminho totalmente qualificado do disco. largura de banda especifica cópia
limite de largura de banda em MiB/s. Especificar um valor negativo é interpretado como um valor não assinado
valor longo longo que pode ser essencialmente ilimitado, mas que provavelmente transbordaria;
é mais seguro usar 0 para esse propósito. Especificando granularidade permite o ajuste fino de
a granularidade que será copiada quando uma região suja for detectada; valores maiores
aciona menos sobrecarga de E/S, mas pode acabar copiando mais dados em geral (o valor padrão
geralmente está correto); hipervisores podem restringir isso a uma potência de dois ou cair dentro
um determinado intervalo. Especificando tamanho buff controlará a quantidade de dados que podem ser simultaneamente
em voo durante a cópia; valores maiores usam mais memória, mas podem permitir
conclusão (o valor padrão geralmente está correto).

puxar bloco domínio caminho [largura de banda] [base] [--esperar [--verbose] [--tempo esgotado segundo]
[--assíncrono]] [--keep-relativo]
Preencha um disco a partir de sua cadeia de imagens de apoio. Por padrão, este comando nivela o
cadeia inteira; mas se base é especificado, contendo o nome de um dos backing
arquivos na cadeia, então esse arquivo se torna o novo arquivo de apoio e somente o
a parte intermediária da corrente é puxada. Depois que todos os dados solicitados do suporte
a cadeia de imagens foi puxada, o disco não depende mais daquela parte do suporte
corrente.

Por padrão, este comando retorna o mais rápido possível e os dados de todo o disco são
puxado para segundo plano; o andamento da operação pode ser verificado com trabalho de bloco.
No entanto, se --esperar for especificado, então este comando será bloqueado até que a operação
for concluído ou cancele a operação se o opcional tempo limite em segundos decorre ou
SIGINT é enviado (geralmente com "Ctrl-C"). Usando --verbose e o --esperar precisarão
produzir atualizações periódicas de status. Se o cancelamento do trabalho for acionado, --assíncrono precisarão
devolver o controle ao usuário o mais rápido possível, caso contrário o comando poderá continuar a
bloqueie um pouco mais até que o trabalho de limpeza seja concluído.

Com o --keep-relativo flag manterá os nomes da cadeia de apoio relativos.

caminho especifica o caminho totalmente qualificado do disco; corresponde a um alvo único
nome ( ) ou arquivo de origem ( ) para um dos discos
dispositivos conectados a domínio (Ver também lista domblk para listar esses nomes). largura de banda
especifica o limite de largura de banda de cópia em MiB/s. Especificar um valor negativo é interpretado
como um valor longo e não assinado ou essencialmente ilimitado. O hipervisor pode escolher
se deve rejeitar o valor ou convertê-lo para o valor máximo permitido.

blkdeviotune domínio dispositivo [[--config] [--viver] | [--atual]] [[total de bytes por segundo] | [ler-
bytes-s] [gravação-bytes-s]] [[total-iops-sec] | [leitura-iops-sec] [write-iops-sec]]
[[total-bytes-sec-max] | [leitura-bytes-sec-max] [escrever-bytes-sec-max]] [[total-iops-sec-max]
| [leitura-iops-sec-max] [escrever-iops-sec-max]] [tamanho-iops-sec]
Defina ou consulte os parâmetros do disco de bloco io para um dispositivo de bloco de domínio. dispositivo
especifica um nome de destino exclusivo ( ) ou arquivo de origem (
file='name'/>) para um dos dispositivos de disco conectados ao domínio (Ver também lista domblk for
listando esses nomes).

Se nenhum limite for especificado, ele consultará a configuração atual dos limites de E/S. Caso contrário, altere
os limites com estes sinalizadores: --total-bytes-seg especifica o limite de rendimento total em
bytes por segundo. --read-bytes-sec especifica o limite de taxa de transferência de leitura em bytes por
segundo. --write-bytes-sec especifica o limite de taxa de transferência de gravação em bytes por segundo.
--total-iops-sec especifica o limite total de operações de E/S por segundo. --read-iops-sec
especifica o limite de operações de E/S de leitura por segundo. --write-iops-sec especifica E/S de gravação
limite de operações por segundo. --total-bytes-sec-máx. especifica o rendimento total máximo
limite em bytes por segundo. --read-bytes-sec-max especifica a taxa de transferência máxima de leitura
limite em bytes por segundo. --write-bytes-sec-max especifica a taxa de transferência máxima de gravação
limite em bytes por segundo. --total-iops-sec-max especifica E/S total máximo
limite de operações por segundo. --read-iops-sec-max especifica E/S de leitura máxima
limite de operações por segundo. --write-iops-sec-max especifica E/S de gravação máxima
limite de operações por segundo. --size-iops-sec especifica o tamanho do limite de operações de E/S por
segundo.

Versões mais antigas do virsh aceitavam apenas essas opções com sublinhado em vez de traço,
como em --total_bytes_sec.

Os valores de bytes e iops são independentes, mas definir apenas um valor (como
--read-bytes-sec) redefine os outros dois dessa categoria para ilimitados. Um 0 explícito
também limpa qualquer limite. Um valor diferente de zero para um determinado total não pode ser misturado com valores diferentes de zero.
valores zero para leitura ou gravação.

If --viver é especificado, afeta um convidado em execução. Se --config é especificado, afeta o
próxima inicialização de um convidado persistente. Se --atual é especificado, afeta o convidado atual
estado. Ao definir os parâmetros do disco io, ambos --viver e --config bandeiras podem ser
dado, mas --atual é exclusivo. Para consultar apenas um dos --viver, --config or
--atual pode ser especificado. Se nenhum sinalizador for especificado, o comportamento será diferente dependendo
no hipervisor.

trabalho de bloco domínio caminho {[--abortar] [--assíncrono] [--pivô] | [--informações] [--cru] [--bytes]
[largura de banda]}
Gerenciar operações de bloco ativo. Existem três modos mutuamente exclusivos: --informações,
largura de banda e --abortar. --assíncrono e --pivô implica modo de aborto; --cru implica informação
modo; e se nenhum modo foi fornecido, --informações modo é assumido.

caminho especifica o caminho totalmente qualificado do disco; corresponde a um alvo único
nome ( ) ou arquivo de origem ( ) para um dos discos
dispositivos conectados a domínio (Ver também lista domblk para listar esses nomes).

In --abortar modo, o trabalho ativo no disco especificado será abortado. Se --assíncrono is
também especificado, este comando retornará imediatamente, em vez de esperar pelo
cancelamento para ser concluído. Se --pivô é especificado, isso solicita que uma cópia ativa
ou trabalho de commit ativo seja transferido para a nova imagem.

In --informações modo, as informações do trabalho ativo no disco especificado serão impressas. Por
padrão, a saída é uma única linha de resumo legível; este formato pode mudar em
versões futuras. Adicionando --cru lista cada campo da estrutura, em um formato estável. Se
da --bytes sinalizador estiver definido, o comando apresentará erros se o servidor não puder fornecer
resolução de bytes/s; ao omitir o sinalizador, a saída bruta é listada em MiB/s e humano-
a saída legível seleciona automaticamente a melhor resolução suportada pelo servidor.

largura de banda pode ser usado para definir o limite de largura de banda para o trabalho ativo. Especificando um
o valor negativo é interpretado como um valor longo sem sinal ou essencialmente ilimitado.
O hipervisor pode escolher se deseja rejeitar o valor ou convertê-lo para o máximo
valor permitido.

redimensionar bloco domínio caminho tamanho
Redimensionar um dispositivo de bloco do domínio enquanto o domínio está em execução, caminho especifica o
caminho absoluto do dispositivo de bloco; corresponde a um nome de destino exclusivo (
dev='name'/>) ou arquivo de origem ( ) para um dos dispositivos de disco
anexado a domínio (Ver também lista domblk para listar esses nomes).

tamanho é um número inteiro escalonado (veja NOTAS acima) cujo padrão é KiB (blocos de 1024
bytes) se não houver sufixo. Você deve usar um sufixo "B" para obter bytes (observe que
por razões históricas, isso difere de vol-redimensionar cujo padrão é bytes sem um
sufixo).

domdisplay domínio [--include-senha] [[--modelo] tipo]
Produza um URI que pode ser usado para conectar-se à exibição gráfica do domínio via
VNC, SPICE ou RDP. O tipo de exibição gráfica específico pode ser selecionado usando o
tipo parâmetro (por exemplo, "vnc", "spice", "rdp"). Se --include-senha é especificado, o
A senha do canal SPICE será incluída no URI.

domfsinfo domínio
Mostra uma lista de sistemas de arquivos montados no domínio em execução. A lista contém
pontos de montagem, nomes de um dispositivo montado no convidado, tipos de sistema de arquivos e exclusivos
nomes de destino usados ​​no domínio XML ( ).

Observe que este comando requer um agente convidado configurado e em execução no domínio
sistema operacional convidado.

domfsfreeze domínio [[--ponto de montagem] ponto de montagem...]
Congelar sistemas de arquivos montados em um domínio em execução para se preparar para operações consistentes
instantâneos.

O --ponto de montagem opção leva um parâmetro ponto de montagem, que é um caminho do ponto de montagem de
o sistema de arquivos a ser congelado. Esta opção pode ocorrer diversas vezes. Se isso não for
especificado, todo sistema de arquivos montado será congelado.

Nota: criação de instantâneo comando tem um --quiescer opção de congelar e descongelar o
sistemas de arquivos automaticamente para manter os instantâneos consistentes. domfsfreeze comando é apenas
necessário quando um usuário deseja utilizar os recursos nativos de instantâneo de dispositivos de armazenamento
não é suportado pela libvirt.

domfsthaw domínio [[--ponto de montagem] ponto de montagem...]
Descongelar sistemas de arquivos montados em um domínio em execução, que foram congelados por
Comando domfsfreeze.

O --ponto de montagem opção leva um parâmetro ponto de montagem, que é um caminho do ponto de montagem de
o sistema de arquivos a ser descongelado. Esta opção pode ocorrer diversas vezes. Se isso não for
especificado, todo sistema de arquivos montado é descongelado.

domfstrim domínio [--mínimo bytes] [--ponto de montagem ponto de montagem]
Emita um comando fstrim em todos os sistemas de arquivos montados em um domínio em execução. Ele descarta
blocos que não estão em uso pelo sistema de arquivos. Se --mínimo bytes é especificado,
informa ao kernel convidado o comprimento da faixa livre contígua. Menor que isso pode ser ignorado
(isso é uma dica e o hóspede pode não respeitar). Ao aumentar este valor, o
A operação fstrim será concluída mais rapidamente para sistemas de arquivos com arquivos livres mal fragmentados
espaço, embora nem todos os blocos sejam descartados. O valor padrão é zero, o que significa
"descarte todos os blocos livres". Além disso, se o usuário quiser cortar apenas um ponto de montagem,
pode ser especificado via opcional --ponto de montagem parâmetro.

nomedomhost domínio
Retorna o nome do host de um domínio, se o hipervisor o disponibilizar.

dominfo domínio
Retorna informações básicas sobre o domínio.

domuuid nome-ou-id de domínio
Converter um nome de domínio ou id em UUID de domínio

domid nome de domínio ou uuid
Converter um nome de domínio (ou UUID) em um ID de domínio

domjobabort domínio
Anule o trabalho de domínio atualmente em execução.

domjobinfo domínio [--completo]
Retorna informações sobre trabalhos em execução em um domínio. --completo diz ao virsh para retornar
informações sobre um trabalho recentemente concluído. As estatísticas de um trabalho concluído são
destruído automaticamente após a leitura ou quando o libvirtd é reiniciado. Observe esse tempo
as informações retornadas para migrações concluídas podem ser completamente irrelevantes, a menos que ambas
hosts de origem e destino sincronizaram o tempo (ou seja, o daemon NTP está sendo executado em
ambos).

nome de domínio ID de domínio ou uuid
Converter um ID de domínio (ou UUID) em nome de domínio

domrenome domínio novo nome
Renomeie um domínio. Este comando altera o nome de domínio atual para o novo nome especificado em
o segundo argumento.

Observação: o domínio deve estar inativo e sem snapshots.

estado dom domínio [--razão]
Retorna o estado sobre um domínio. --razão diz ao virsh para também imprimir o motivo do
Estado.

controle de domínio domínio
Retorna o estado de uma interface para o VMM usada para controlar um domínio. Para outros estados que não
"ok" ou "error" o comando também imprime o número de segundos decorridos desde o controle
interface entrou em seu estado atual.

horário de trabalho domínio {[--agora] [--bonito] [--sincronizar] [--Tempo tempo]}
Obtém ou define a hora do sistema do domínio. Quando executado sem quaisquer argumentos (mas domínio),
a hora do sistema do domínio atual é impressa. O --bonito modificador pode ser usado para
imprima a hora em uma forma mais legível.

Quando --Tempo tempo é especificado, o tempo do domínio não é obtido, mas definido. O
--agora modificador age como se fosse um apelido para --Tempo $ agora, o que significa que define o
hora que está atualmente no host em que o virsh está sendo executado. Em ambos os casos (configuração e
obtendo), o tempo está em segundos em relação à época de 1970/01/01 em UTC. O --sincronizar
modifica um pouco o comportamento do set: O tempo decorrido é ignorado, mas o tempo para set é
leia o RTC do domínio. Observe que alguns hipervisores podem exigir um convidado
agente a ser configurado para obter ou definir o horário do convidado.

domxml-do-nativo formato configuração
Converta o arquivo configuração no formato de configuração de convidado nativo nomeado por formato para uma
formato XML de domínio. Para hipervisor QEMU/KVM, o formato argumento deve ser qemu-argv. Para
Hipervisor Xen, o formato argumento pode ser xen-xm, xen-xl, ou xen-sxpr. Para LXC
hipervisor, o formato argumento deve ser ferramentas lxc.

domxml para nativo formato xml
Converta o arquivo xml no formato XML de domínio para o formato de configuração de convidado nativo
nomeado por formato. Para hipervisor QEMU/KVM, o formato argumento deve ser qemu-argv. Para
Hipervisor Xen, o formato argumento pode ser xen-xm, xen-xl, ou xen-sxpr. Para LXC
hipervisor, o formato argumento deve ser ferramentas lxc.

despejar domínio caminho do arquivo principal [--bypass-cache] {[--viver] | [--batida] | [--Redefinir] } [--verbose]
[--somente memória] [--formato corda]
Despeja o núcleo de um domínio em um arquivo para análise. Se --viver é especificado, o domínio
continua a ser executado até que o core dump seja concluído, em vez de fazer uma pausa inicial. Se
--batida for especificado, o domínio será interrompido com um status de falha, em vez de apenas
deixado em um estado de pausa. Se --Redefinir é especificado, o domínio é redefinido após sucesso
jogar fora. Observe que essas três opções são mutuamente exclusivas. Se --bypass-cache is
especificado, o salvamento evitará o cache do sistema de arquivos, embora isso possa retardar o
Operação. Se --somente memória for especificado, o arquivo será um arquivo elf e incluirá apenas
memória do domínio e valor de registro comum da CPU. É muito útil se o domínio usar
hospedar dispositivos diretamente. --formato corda é usado para especificar o formato de 'somente memória'
despejar, e corda pode ser um deles: elf, kdump-zlib(formato compactado kdump com
compactado zlib), kdump-lzo(formato compactado kdump com compactado lzo),
kdump-snappy(formato compactado kdump com compactado snappy).

O progresso pode ser monitorado usando domjobinfo comando virsh e cancelado com
domjobabort comando (enviado por outra instância virsh). Outra opção é enviar SIGINT
(geralmente com "Ctrl-C") para o processo virsh em execução despejar comando. --verbose monitores
o progresso do despejo.

NOTA: Alguns hipervisores podem exigir que o usuário garanta manualmente as permissões adequadas em
arquivo e caminho especificado pelo argumento caminho do arquivo principal.

dumpxml domínio [--inativo] [--Informação de segurança] [--update-cpu] [--migratável]
Produza as informações do domínio como um dump XML para stdout, este formato pode ser usado pelo
crio comando. Opções adicionais que afetam o dump XML podem ser usadas. --inativo
diz ao virsh para descartar a configuração do domínio que será usada na próxima inicialização do domínio
em oposição à configuração de domínio atual. Usando --Informação de segurança também vai
inclua informações confidenciais de segurança no dump XML. --update-cpu atualiza domínio
Requisitos de CPU de acordo com a CPU do host. Com --migratável pode-se solicitar um XML que
é adequado para migrações, ou seja, compatível com versões mais antigas da libvirt e possivelmente
alterado com opções de tempo de execução interno. Esta opção pode ativar automaticamente outros
opções (--update-cpu, --Informação de segurança, ...) como necessário.

editar domínio
Edite o arquivo de configuração XML de um domínio, o que afetará a próxima inicialização do
convidado.

Isso é equivalente a:

virsh dumpxml --inactive --security-info domínio > domínio.xml
vi domain.xml (ou faça alterações com seu outro editor de texto)
virsh define domínio.xml

exceto que faz alguma verificação de erros.

O editor utilizado pode ser fornecido pelas variáveis ​​de ambiente $VISUAL ou $EDITOR, e
o padrão é "vi".

evento {[domínio] { evento | --tudo } [--ciclo] [--tempo esgotado segundo] [--timestamp] --Lista}
Aguarde a ocorrência de uma classe de eventos de domínio e imprima os detalhes apropriados dos eventos como
eles acontecem. Os eventos podem opcionalmente ser filtrados por domínio. Usando --Lista como o
único argumento fornecerá uma lista de possíveis evento valores conhecidos por este cliente,
embora a conexão possa não permitir o registro para todos esses eventos. Isso é também
possível usar --tudo em vez de evento para se inscrever em todos os tipos de eventos possíveis em
uma vez.

Por padrão, esse comando é único e retorna sucesso quando um evento ocorre; você
pode enviar SIGINT (geralmente via "Ctrl-C") para sair imediatamente. Se --tempo esgotado is
especificado, o comando desiste de esperar por eventos após segundo já decorreram. Com
--ciclo, o comando imprime todos os eventos até um tempo limite ou tecla de interrupção.

Quando --timestamp for usado, um carimbo de data e hora legível será impresso antes do evento.

iothreadinfo domínio [[--viver] [--config] | [--atual]]
Exibir informações básicas de IOThreads de domínio, incluindo o ID de IOThread e a CPU
Afinidade para cada IOThread.

If --viver for especificado, obtenha os dados IOThreads do convidado em execução. Se o convidado estiver
não estiver em execução, um erro será retornado. Se --config é especificado, obtenha os dados IOThreads
da próxima inicialização de um convidado persistente. Se --atual é especificado ou --viver e
--config não são especificados, então obtenha os dados IOThread com base no convidado atual
Estado.

iothreadpin domínio iothread cpulista [[--viver] [--config] | [--atual]]
Altere a fixação de um IOThread de domínio para hospedar CPUs físicas. Para recuperar um
lista de todos os IOThreads, use iothreadinfo. Para fixar um iothread especifique o cpulista
desejado para o ID IOThread conforme listado no iothreadinfo saída.

cpulista é uma lista de números físicos de CPU. Sua sintaxe é uma lista separada por vírgulas e um
marcação especial usando '-' e '^' (ex. '0-4', '0-3,^2') também pode ser permitida. O '-'
denota o intervalo e '^' denota exclusivo. Se você deseja redefinir o iothreadpin
configuração, ou seja, fixar um iothread para todos os cpus físicos, simplesmente especifique 'r' como um
cpulista.

If --viver é especificado, afeta um convidado em execução. Se o convidado não estiver em execução, um erro
é devolvido. Se --config for especificado, afetará a próxima inicialização de um convidado persistente.
If --atual é especificado ou --viver e --config não são especificados, afetam o atual
estado convidado. Ambos --viver e --config bandeiras podem ser dadas se cpulista está presente, mas
--atual é exclusivo. Se nenhum sinalizador for especificado, o comportamento será diferente dependendo
hipervisor.

Observação: a expressão é avaliada sequencialmente, então "0-15,^8" é idêntico a
"9-14,0-7,15" mas não idêntico a "^8,0-15".

iothreadadd domínio idthread_id [[--config] [--viver] | [--atual]]
Adicione um novo IOThread ao domínio usando o especificado idthread_id. Se o idthread_id
já existe, o comando falhará. O idthread_id deve ser maior que zero.

If --viver é especificado, afeta um convidado em execução. Se o convidado não estiver executando um erro
é devolvido. Se --config for especificado, afetará a próxima inicialização de um convidado persistente.
If --atual é especificado ou --viver e --config não são especificados, afetam o atual
estado convidado.

iothreaddel domínio idthread_id [[--config] [--viver] | [--atual]]
Exclua um IOThread do domínio usando o especificado idthread_id. Se um IOThread for
atualmente atribuído a um recurso de disco, como por meio do anexar disco comando, então o
tentativa de remover o IOThread falhará. Se o idthread_id não existe um erro
Vai acontecer.

If --viver é especificado, afeta um convidado em execução. Se o convidado não estiver executando um erro
é devolvido. Se --config for especificado, afetará a próxima inicialização de um convidado persistente.
If --atual é especificado ou --viver e --config não são especificados, afetam o atual
estado convidado.

gerenciado salvar domínio [--bypass-cache] [{--correndo | --pausado}] [--verbose]
Salvar e destruir (parar) um domínio em execução, para que ele possa ser reiniciado do mesmo estado
Mais tarde. Quando o virsh começo comando for a próxima execução para o domínio, ele irá
será iniciado automaticamente a partir deste estado salvo. Se --bypass-cache é especificado, o
salvar evitará o cache do sistema de arquivos, embora isso possa retardar a operação.

O progresso pode ser monitorado usando domjobinfo comando virsh e cancelado com
domjobabort comando (enviado por outra instância virsh). Outra opção é enviar SIGINT
(geralmente com "Ctrl-C") para o processo virsh em execução gerenciado salvar comando. --verbose
exibe o progresso do salvamento.

Normalmente, iniciar um salvamento gerenciado decidirá entre executar ou pausar com base no
indique o domínio em que o domínio estava quando o salvamento foi feito; passando ou o --correndo or
--pausado sinalizador permitirá substituir qual estado o começo Deveria usar.

O dominfo O comando pode ser usado para consultar se um domínio possui atualmente algum gerenciamento
salvar imagem.

gerenciado, salvar-remover domínio
Remover o gerenciado salvar arquivo de estado para um domínio, se existir. Isso garante o domínio
fará uma inicialização completa na próxima vez que for iniciado.

maxvcpus [tipo]
Forneça o número máximo de CPUs virtuais suportadas por uma VM convidada neste
conexão. Se fornecido, o tipo parâmetro deve ser um atributo de tipo válido para o
elemento de XML.

estatísticas da CPU domínio [--total] [começo] [contar]
Fornece informações estatísticas de CPU de um domínio. O domínio deve estar em execução. Padrão
mostra estatísticas de todas as CPUs e um total. Usar --total apenas para as estatísticas totais, começo
apenas para as estatísticas por CPU das CPUs de começo, contar para apenas contar Estatísticas das CPUs.

metadados domínio [[--viver] [--config] | [--atual]] [--editar] [Ligações] [chave] [conjunto] [--retirar]
Mostre ou modifique metadados XML personalizados de um domínio. Os metadados são um XML definido pelo usuário
que permite armazenar dados XML arbitrários na definição de domínio. Vários separados
pedaços de metadados personalizados podem ser armazenados no XML do domínio. As peças são identificadas por
um namespace XML privado fornecido por meio do Ligações argumento. (Veja também desc que funciona com
metadados textuais de um domínio.)

Bandeiras --viver or --config selecione se este comando funciona em tempo real ou persistente
definições do domínio. Se ambos --viver e --config são especificados, o --config
opção tem precedência na obtenção da descrição atual e da configuração ao vivo
e a configuração são atualizadas ao definir a descrição. --atual é exclusivo e
implícito se nada disso foi especificado.

Bandeira --retirar especifica que o elemento de metadados especificado pelo Ligações argumento deveria
ser removido em vez de atualizado.

Bandeira --editar especifica que um editor com os metadados identificados pelo Ligações argumento
deve ser aberto e o conteúdo salvo posteriormente. Caso contrário, o novo conteúdo
pode ser fornecido através do conjunto argumento.

Ao definir metadados via --editar or conjunto da chave argumento deve ser especificado e é usado
para prefixar os elementos personalizados para vinculá-los ao namespace privado.

Se nenhum de --editar e conjunto são especificados os metadados XML correspondentes ao Ligações
namespace é exibido em vez de ser modificado.

migrado [--viver] [--desligada] [--direto] [--p2p [--túnel]] [--persistente]
[--undefinesource] [--suspender] [--copiar-armazenamento-tudo] [--copy-storage-inc]
[--proteção contra alterações] [--inseguro] [--verbose] [--comprimido] [--abortar em caso de erro]
[--auto-convergência] domínio desturi [migratório] [gráficos] [endereço de escuta] [nome]
[--tempo esgotado segundo] [--xml lima] [--migrate-discos lista de discos]
Migre o domínio para outro host. Adicionar --viver para migração viva; <--p2p> para
migração ponto a ponto; --direto para migração direta; ou --túnel para túnel
migração. --desligada migra a definição de domínio sem iniciar o domínio em
destino e sem pará-lo no host de origem. A migração offline pode ser usada
com domínios inativos e deve ser usado com --persistente opção. --persistente
deixa o domínio persistente no host de destino, --undefinesource indefine o
domínio no host de origem e --suspender deixa o domínio pausado no destino
hospedeiro. --copiar-armazenamento-tudo indica migração com armazenamento não compartilhado com disco cheio
cópia de, --copy-storage-inc indica migração com armazenamento não compartilhado com incremental
cópia (mesma imagem base compartilhada entre origem e destino). Em ambos os casos o disco
as imagens devem existir no host de destino, o --copiar-armazenamento-... opções apenas dizem
libvirt para transferir dados das imagens no host de origem para as imagens encontradas no
mesmo local no host de destino. Por padrão, apenas imagens não compartilhadas e não somente leitura são
transferido. Usar --migrate-discos para especificar explicitamente uma lista de destinos de disco para
transferência através de separado por vírgula lista de discos argumento. --proteção contra alterações impõe isso
nenhuma alteração de configuração incompatível será feita no domínio durante a migração
está à caminho; este sinalizador é habilitado implicitamente quando suportado pelo hipervisor, mas pode
ser usado explicitamente para rejeitar a migração se o hipervisor não tiver proteção contra alterações
. --verbose exibe o progresso da migração. --comprimido ativa
compactação de páginas de memória que precisam ser transferidas repetidamente durante o live
migração. --abortar em caso de erro cancela a migração se um erro leve (por exemplo, E/S
erro) acontece durante a migração. --auto-convergência convergência de forças durante ao vivo
migração.

Observação: hipervisores individuais geralmente não oferecem suporte a todos os tipos possíveis de migração.
Por exemplo, o QEMU não apoia a migração direta.

Em alguns casos, a libvirt pode recusar-se a migrar o domínio porque isso pode levar a
problemas potenciais, como corrupção de dados, e, portanto, a migração é considerada
inseguro. Para o domínio QEMU, isso pode acontecer se o domínio usar discos sem explicitamente
definindo o modo de cache como "nenhum". A migração desses domínios não é segura, a menos que as imagens de disco
são armazenados em sistemas de arquivos em cluster coerentes, como GFS2 ou GPFS. Se você tem certeza
a migração é segura ou você simplesmente não se importa, use --inseguro para forçar a migração.

nome é usado para renomear o domínio para um novo nome durante a migração, o que também geralmente
pode ser omitida. Da mesma maneira, --xml lima geralmente é omitido, mas pode ser usado para fornecer um
arquivo XML alternativo para uso no destino para fornecer um conjunto maior de alterações para
quaisquer partes específicas do host do XML do domínio, como contabilização de nomenclatura
diferenças entre origem e destino no acesso ao armazenamento subjacente.

--tempo esgotado segundo força o convidado a suspender quando a migração ao vivo excede esse número
segundos e a migração será concluída off-line. Só pode ser usado com
--viver.

A migração em execução pode ser cancelada interrompendo o virsh (geralmente usando "Ctrl-C") ou
domjobabort comando enviado de outra instância virsh.

O desturi e migratório parâmetros podem ser usados ​​para controlar qual destino o
utilizações da migração. desturi é importante para a migração gerenciada, mas não é utilizado para migração direta.
migração; migratório é necessário para a migração direta, mas geralmente pode ser
determinado automaticamente para migração gerenciada.

Observação: O desturi parâmetro para migração normal e migração peer2peer tem diferentes
semântica:

· migração normal: o desturi é um endereço do host de destino visto do
máquina cliente.

· migração peer2peer: o desturi é um endereço do host de destino visto do
máquina de origem.

Quando migratório não for especificado, libvirt determinará automaticamente o hipervisor
URI específico. Alguns hipervisores, incluindo QEMU, possuem um "migration_host" opcional
parâmetro de configuração (útil quando o host possui múltiplas interfaces de rede). Se
isso não é especificado, libvirt determina um nome procurando o host de destino
nome de host configurado.

Existem alguns cenários em que a especificação migratório pode ajudar:

· O nome do host configurado está incorreto ou o DNS está quebrado. Se um host tiver um nome de host
que não resolverá corresponder a um de seus endereços IP públicos, então a libvirt irá
gerar um URI incorreto. Nesse caso migratório deveria ser explicitamente
especificado, usando um endereço IP ou um nome de host correto.

· O host possui múltiplas interfaces de rede. Se um host tiver várias redes
interfaces, pode ser desejável que o fluxo de dados de migração seja enviado através de um
interface específica por motivos de segurança ou desempenho. Nesse caso
migratório deve ser especificado explicitamente, usando um endereço IP associado ao
rede a ser usada.

· O firewall restringe quais portas estão disponíveis. Quando libvirt gera um
URI de migração, ele escolherá um número de porta usando regras específicas do hipervisor. Alguns
hipervisores exigem apenas que uma única porta esteja aberta nos firewalls, enquanto outros
exigem uma grande variedade de números de porta. No último caso migratório pode ser
especificado para escolher um número de porta específico fora do intervalo padrão para
cumprir as políticas de firewall locais.

Vejohttp://libvirt.org/migration.html#uris> para obter mais detalhes sobre URIs de migração.

Opcional gráficos substitui os parâmetros de conexão usados ​​automaticamente
reconectar clientes gráficos no final da migração. Se omitido, libvirt irá
calcule os parâmetros com base no endereço IP do host de destino. Caso o cliente não
ter acesso direto aos hosts de virtualização de rede aos quais estão conectados e precisam
conectar através de um proxy, gráficos pode ser usado para especificar o endereço que o cliente
deve se conectar. O URI é formado da seguinte forma:

protocolo://hostname[:porta]/[?parâmetros]

onde protocolo é "spice" ou "vnc" e parâmetros é uma lista de protocolos
parâmetros específicos separados por '&'. Os parâmetros atualmente reconhecidos são "tlsPort"
e "tlsSubject". Por exemplo,

tempero://target.host.com:1234/?tlsPort=4567

Opcional endereço de escuta define o endereço de escuta desse hipervisor no destino
lado deve se vincular para a migração de entrada. Endereços IPv4 e IPv6 são aceitos
bem como nomes de host (a resolução é feita no destino). Alguns hipervisores não
oferece suporte a esse recurso e retornará um erro se esse parâmetro for usado.

migrar-setmaxdowntime domínio tempo de inatividade
Defina o tempo de inatividade máximo tolerável para um domínio que está sendo migrado em tempo real para outro
hospedeiro. o tempo de inatividade é o número de milissegundos que o convidado pode ficar no chão
fim da migração ao vivo.

migrar-compcache domínio [--Tamanho bytes]
Define e/ou obtém o tamanho do cache (em bytes) usado para compactar repetidamente
páginas de memória transferidas durante a migração ao vivo. Quando chamado sem tamanho, o comando
apenas imprime o tamanho atual do cache de compactação. Quando tamanho é especificado, o
o hipervisor é solicitado a alterar o cache de compactação para tamanho bytes e depois o atual
tamanho é impresso (o resultado pode diferir do tamanho solicitado devido ao arredondamento feito por
o hipervisor). O tamanho opção deve ser usada enquanto o domínio está sendo
migrados ao vivo como uma reação ao progresso da migração e ao aumento do número de compactações
falhas de cache obtidas de domjobinfo.

migração-setspeed domínio largura de banda
Defina a largura de banda máxima de migração (em MiB/s) para um domínio que está sendo migrado para
outro hospedeiro. largura de banda é interpretado como um valor longo e não assinado. Especificando um
valor negativo resulta em um valor essencialmente ilimitado sendo fornecido ao
hipervisor. O hipervisor pode escolher se deseja rejeitar o valor ou convertê-lo para o
valor máximo permitido.

migrar-getspeed domínio
Obtenha a largura de banda máxima de migração (em MiB/s) para um domínio.

numatune domínio [--modo modo] [--nodeset conjunto de nós] [[--config] [--viver] | [--atual]]
Defina ou obtenha os parâmetros numa de um domínio, correspondentes ao elemento de
domínio XML. Sem sinalizadores, as configurações atuais são exibidas.

modo pode ser `estrito', `intercalado' e `preferido' ou qualquer número válido do
virDomainNumatuneMemMode enum caso o daemon o suporte. Para um domínio em execução,
o modo não pode ser alterado e o conjunto de nós só pode ser alterado se o domínio for
começou com um modo `estrito'.

conjunto de nós é uma lista de nós numa usados ​​pelo host para executar o domínio. Sua sintaxe
é uma lista separada por vírgulas, com '-' para intervalos e '^' para excluir um nó.

If --viver for especificado, defina as informações do agendador de um convidado em execução. Se --config is
especificado, afetará a próxima inicialização de um convidado persistente. Se --atual é especificado,
afetar o estado atual do convidado.

reinicialização domínio [--modo LISTA DE MODOS]
Reinicialize um domínio. Isso age como se o domínio tivesse o reinicialização comando executado a partir do
console. O comando retorna assim que executa a ação de reinicialização, que pode
ser significativamente antes de o domínio realmente ser reinicializado.

O comportamento exato de um domínio quando ele é reinicializado é definido pelo na_reinicialização parâmetro em
a definição XML do domínio.

Por padrão, o hipervisor tentará escolher um método de desligamento adequado. Para especificar um
método alternativo, o --modo parâmetro pode especificar uma lista separada por vírgulas que
inclui "acpi", "agent", "initctl", "signal" e "paravirt". A ordem em que
os drivers tentarão que cada modo seja indefinido e não esteja relacionado à ordem especificada para
virsh. Para um controle rigoroso sobre os pedidos, use um único modo de cada vez e repita o
comando.

redefinir domínio
Redefina um domínio imediatamente sem qualquer desligamento de convidado. redefinir emula a redefinição de energia
botão em uma máquina, onde todo o hardware convidado vê a linha RST definida e reinicializa
estado interno.

Observação: A redefinição sem qualquer desligamento do sistema operacional convidado corre o risco de perda de dados.

restaurar arquivo de estado [--bypass-cache] [--xml lima] [{--correndo | --pausado}]
Restaura um domínio de um Virsh salvar arquivo de estado. Ver salvar para mais informações.

If --bypass-cache for especificado, a restauração evitará o cache do sistema de arquivos, embora
isso pode retardar a operação.

--xml lima geralmente é omitido, mas pode ser usado para fornecer um arquivo XML alternativo para
usar no convidado restaurado com alterações apenas nas partes específicas do host do
domínio XML. Por exemplo, pode ser usado para considerar diferenças de nomenclatura de arquivos em
armazenamento subjacente devido a instantâneos de disco tirados depois que o convidado foi salvo.

Normalmente, a restauração de uma imagem salva usará o estado gravado na imagem salva para
decidir entre correr ou pausar; passando ou o --correndo or --pausado bandeira vai
permite substituir em qual estado o domínio deve ser iniciado.

Observação: Para evitar corromper o conteúdo do sistema de arquivos dentro do domínio, você não deve reutilizar
o arquivo de estado salvo por um segundo restaurar a menos que você também tenha revertido todo o armazenamento
volumes de volta ao mesmo conteúdo de quando o arquivo de estado foi criado.

salvar domínio arquivo de estado [--bypass-cache] [--xml lima] [{--correndo | --pausado}] [--verbose]
Salva um domínio em execução (RAM, mas não o estado do disco) em um arquivo de estado para que possa ser
restaurado mais tarde. Uma vez salvo, o domínio não estará mais rodando no sistema, portanto
a memória alocada para o domínio estará livre para uso de outros domínios. Virsh
restaurar restaura deste arquivo de estado. Se --bypass-cache for especificado, o salvamento será
evite o cache do sistema de arquivos, embora isso possa retardar a operação.

O progresso pode ser monitorado usando domjobinfo comando virsh e cancelado com
domjobabort comando (enviado por outra instância virsh). Outra opção é enviar SIGINT
(geralmente com "Ctrl-C") para o processo virsh em execução salvar comando. --verbose monitores
o progresso do salvamento.

Isso é aproximadamente equivalente a hibernar em um computador em execução, com todos os
mesmas limitações. Conexões de rede abertas podem ser interrompidas na restauração, pois o TCP
os tempos limite podem ter expirado.

--xml lima geralmente é omitido, mas pode ser usado para fornecer um arquivo XML alternativo para
usar no convidado restaurado com alterações apenas nas partes específicas do host do
domínio XML. Por exemplo, pode ser usado para considerar diferenças de nomenclatura de arquivos que
estão planejados para serem feitos por meio de instantâneos de disco do armazenamento subjacente depois que o convidado for
salvo.

Normalmente, a restauração de uma imagem salva decidirá entre execução ou pausa com base no
indique o domínio em que o domínio estava quando o salvamento foi feito; passando ou o --correndo or
--pausado sinalizador permitirá substituir qual estado o restaurar Deveria usar.

Os arquivos de estado salvos no domínio assumem que as imagens de disco permanecerão inalteradas entre
ponto de criação e restauração. Para um ponto de restauração do sistema mais completo, onde o disco
estado é salvo junto com o estado da memória, consulte o instantâneo família de comandos.

salvar-imagem-definir lima xml [{--correndo | --pausado}]
Atualize o XML do domínio que será usado quando lima é mais tarde usado no restaurar
comando. o xml argumento deve ser um nome de arquivo contendo o XML alternativo, com
muda apenas nas partes específicas do host do XML do domínio. Por exemplo, pode ser
usado para explicar diferenças de nomenclatura de arquivos resultantes da criação de instantâneos de disco de
armazenamento subjacente depois que o convidado foi salvo.

A imagem salva registra se o domínio deve ser restaurado para um estado em execução ou pausado.
estado. Normalmente, este comando não altera o estado gravado; passando ou o
--correndo or --pausado sinalizador permitirá substituir qual estado o restaurar Deveria usar.

salvar-imagem-dumpxml lima [--Informação de segurança]
Extraia o XML do domínio que estava em vigor no momento do arquivo de estado salvo lima foi
criado com o salvar comando. Usando --Informação de segurança também incluirá segurança
informação sensível.

salvar-editar imagem lima [{--correndo | --pausado}]
Edite a configuração XML associada a um arquivo de estado salvo lima criado pelo salvar
comando.

A imagem salva registra se o domínio deve ser restaurado para um estado em execução ou pausado.
estado. Normalmente, este comando não altera o estado gravado; passando ou o
--correndo or --pausado sinalizador permitirá substituir qual estado o restaurar Deveria usar.

Isso é equivalente a:

virsh save-image-dumpxml arquivo de estado > arquivo de estado.xml
vi state-file.xml (ou faça alterações com seu outro editor de texto)
virsh salvar-imagem-define arquivo de estado arquivo-de-estado-xml

exceto que faz alguma verificação de erros.

O editor utilizado pode ser fornecido pelas variáveis ​​de ambiente $VISUAL ou $EDITOR, e
o padrão é "vi".

informações agendadas domínio [[--config] [--viver] | [--atual]] [[--definir] parâmetro = valor] ...
informações agendadas [--peso número] [--boné número] domínio
Permite mostrar (e definir) os parâmetros do agendador de domínio. Os parâmetros disponíveis
para cada hipervisor são:

LXC (agendador posix): cpu_shares, vcpu_period, vcpu_quota

QEMU/KVM (agendador posix): cpu_shares, vcpu_period, vcpu_quota, emulator_period,
emulador_quota

Xen (agendador de crédito): peso, limite

ESX (agendador de alocação): reserva, limite, compartilhamentos

If --viver for especificado, defina as informações do agendador de um convidado em execução. Se --config is
especificado, afetará a próxima inicialização de um convidado persistente. Se --atual é especificado,
afetar o estado atual do convidado.

Observação: O parâmetro cpu_shares tem um intervalo de valores válido de 0 a 262144; Valores negativos
são agrupados em positivo e valores maiores são limitados ao máximo. Portanto, -1
é um atalho útil para 262144. No kernel Linux, os valores 0 e 1 são
convertido automaticamente para um valor mínimo de 2.

Observação: Os parâmetros de peso e limite são definidos apenas para o agendador XEN_CREDIT e
agora são DESCONTINUADA.

Observação: Os parâmetros vcpu_period/emulator_period têm um intervalo de valores válido de
1000-1000000 ou 0, e os parâmetros vcpu_quota/emulator_quota têm um valor válido
intervalo de 1000-18446744073709551 ou menor que 0. O valor 0 para qualquer parâmetro é
o mesmo que não especificar esse parâmetro.

imagem de tela domínio [caminho do arquivo de imagem] [--tela ID da tela]
Faz uma captura de tela de um console de domínio atual e a armazena em um arquivo. Opcionalmente,
se o hipervisor suportar mais exibições para um domínio, ID da tela permite especificar quais
a tela será capturada. É o número sequencial da tela. Em caso de múltiplos
placas gráficas, os cabeçotes são enumerados antes dos dispositivos, por exemplo, tendo duas placas gráficas,
ambos com quatro cabeças, a tela ID 5 aborda a segunda cabeça no segundo cartão.

chave de envio domínio [--codeset conjunto de códigos] [--tempo de espera tempo de espera] Código chave...
Analise o Código chave sequência de pressionamentos de teclas para enviar para domínio. Cada Código chave pode qualquer um
ser um valor numérico ou um nome simbólico do conjunto de códigos correspondente. Se --tempo de espera
é fornecido, cada pressionamento de tecla será mantido por tantos milissegundos. O conjunto de códigos padrão
is linux, mas o uso do --codeset opção permite que outros conjuntos de códigos sejam escolhidos.

Se vários códigos de acesso forem especificados, todos eles serão enviados simultaneamente ao hóspede e
eles podem ser recebidos em ordem aleatória. Se você precisar de pressionamentos de teclas distintos, deverá usar
múltiplas invocações de chave de envio.

linux
Os valores numéricos são aqueles definidos pelo subsistema de evento de entrada genérico do Linux.
Os nomes simbólicos correspondem aos nomes de macro constantes de chave do Linux correspondentes.

xt Os valores numéricos são aqueles definidos pelo controlador de teclado XT original. Não
nomes simbólicos são fornecidos

atset1
Os valores numéricos são aqueles definidos pelo controlador de teclado AT, conjunto 1 (também conhecido como XT
conjunto compatível). Keycoes estendidos de atset1 podem diferir dos códigos-chave estendidos em
da xt conjunto de códigos. Nenhum nome simbólico é fornecido

atset2
Os valores numéricos são aqueles definidos pelo controlador de teclado AT, conjunto 2. Não
nomes simbólicos são fornecidos

atset3
Os valores numéricos são aqueles definidos pelo controlador de teclado AT, conjunto 3 (também conhecido como
conjunto compatível com PS/2). Nenhum nome simbólico é fornecido

os_x
Os valores numéricos são aqueles definidos pelo subsistema de entrada do teclado OS-X. O
nomes simbólicos correspondem aos nomes de macro constantes de chave OS-X correspondentes

xt_kbd
Os valores numéricos são aqueles definidos pelo dispositivo Linux KBD. Estas são uma variante
no conjunto de códigos XT original, mas muitas vezes com codificação diferente para extensão
códigos-chave. Nenhum nome simbólico é fornecido.

win32
Os valores numéricos são aqueles definidos pelo subsistema de entrada do teclado Win32. O
nomes simbólicos correspondem aos nomes de macro constantes de chave Win32 correspondentes

usb Os valores numéricos são aqueles definidos pela especificação USB HID para teclado
entrada. Nenhum nome simbólico é fornecido

rfb Os valores numéricos são aqueles definidos pela extensão RFB para envio de dados brutos
códigos-chave. Estes são uma variante do conjunto de códigos XT, mas os códigos de acesso estendidos têm o
bit baixo do segundo conjunto de bytes, em vez do bit alto do primeiro byte. Não
nomes simbólicos são fornecidos.

Exemplos
# envia três traços 'k', 'e', ​​'y', usando xt codeset. esses
# são todos pressionados simultaneamente e podem ser recebidos pelo convidado
# em ordem aleatória
virsh enviar chave dom --codeset xt 37 18 21

# envia um toque 'right-ctrl+C'
virsh enviar chave dom KEY_RIGHTCTRL KEY_C

#envia uma guia, segurada por 1 segundo
virsh enviar-chave --holdtime 1000 0xf

enviar sinal de processo id de domínio pid nome de assinatura
Envie um sinal nome de assinatura ao processo identificado por pid rodando no domínio virtual
id de domínio. O pid é um ID de processo no namespace de domínio virtual.

O nome de assinatura argumento pode ser um número constante de sinal inteiro ou um dos
nomes simbólicos:

"nop", "hup", "int", "quit", "ill",
"armadilha", "abrt", "ônibus", "fpe", "matar",
"usr1", "segv", "usr2", "pipe", "alrm",
"termo", "stkflt", "chld", "cont", "parar",
"tstp", "ttin", "ttou", "urg", "xcpu",
"xfsz", "vtalrm", "prof", "guincho", "poll",
"pwr", "sys", "rt0", "rt1", "rt2", "rt3",
"rt4", "rt5", "rt6", "rt7", "rt8", "rt9",
"rt10", "rt11", "rt12", "rt13", "rt14", "rt15",
"rt16", "rt17", "rt18", "rt19", "rt20", "rt21",
"rt22", "rt23", "rt24", "rt25", "rt26", "rt27",
"rt28", "rt29", "rt30", "rt31", "rt32"

O nome do símbolo pode opcionalmente ser prefixado com 'sig' ou 'sig_' e pode estar em
maiúsculas ou minúsculas.

Exemplos
virsh enviar-processo-sinal meuconvidado 1 15
virsh enviar-processo-sinal myguest 1 termo
virsh enviar-processo-sinal myguest 1 sigterm
virsh enviar-processo-sinal myguest 1 SIG_HUP

definir domínio tamanho [[--config] [--viver] | [--atual]]
Altere a alocação de memória para um domínio convidado. Se --viver é especificado, execute um
balão de memória de um convidado correndo. Se --config é especificado, afetará a próxima inicialização do
um convidado persistente. Se --atual é especificado, afeta o estado atual do convidado. Ambos
--viver e --config bandeiras podem ser dadas, mas --atual é exclusivo. Se nenhuma bandeira for
especificado, o comportamento é diferente dependendo do hipervisor.

tamanho é um número inteiro escalonado (veja NOTAS acima); o padrão é kibibytes (blocos de 1024
bytes), a menos que você forneça um sufixo (e o nome da opção mais antiga --quilobytes está disponível
como um sinônimo obsoleto). Libvirt arredonda para o kibibyte mais próximo. Alguns
hipervisores exigem uma granularidade maior que KiB, e solicitações que não são uniformes
múltiplo será arredondado para cima. Por exemplo, o vSphere/ESX arredonda o parâmetro para
mebibytes (1024 kibibytes).

Para o Xen, você só pode ajustar a memória de um domínio em execução se o domínio estiver
paravirtualizado ou executando o driver do balão fotovoltaico.

Para LXC, o valor que está sendo definido é o valor cgroups para limit_in_bytes ou o valor máximo
quantidade de memória do usuário (incluindo cache de arquivo). Ao visualizar a memória dentro do
recipiente, este é o / proc / meminfo Valor "MemTotal". Ao visualizar o valor do
anfitrião, use o Virsh memtune comando. Para visualizar a memória atual em uso e
o valor máximo permitido para definir a memória, use o Virsh dominfo comando.

definir senha do usuário domínio usuário senha [- criptografado]
Defina a senha para o usuário conta no domínio convidado.

If - criptografado for especificado, a senha será considerada já criptografada pelo
método exigido pelo sistema operacional convidado.

Para QEMU/KVM, isso requer que o agente convidado esteja configurado e em execução.

setmaxmem domínio tamanho [[--config] [--viver] | [--atual]]
Altere o limite máximo de alocação de memória para um domínio convidado. Se --viver is
especificado, afeta um convidado em execução. Se --config é especificado, afetará a próxima inicialização do
um convidado persistente. Se --atual é especificado, afeta o estado atual do convidado. Ambos
--viver e --config bandeiras podem ser dadas, mas --atual é exclusivo. Se nenhuma bandeira for
especificado, o comportamento é diferente dependendo do hipervisor.

Alguns hipervisores como QEMU/KVM não suportam alterações ao vivo (especialmente crescentes)
do limite máximo de memória. Mesmo alterações persistentes na configuração podem não ser
realizado com alguns hipervisores/configuração (por exemplo, em domínios habilitados para NUMA no QEMU).
Para alterações complexas de configuração, use o comando editar em vez de).

tamanho é um número inteiro escalonado (veja NOTAS acima); o padrão é kibibytes (blocos de 1024
bytes), a menos que você forneça um sufixo (e o nome da opção mais antiga --quilobytes está disponível
como um sinônimo obsoleto). Libvirt arredonda para o kibibyte mais próximo. Alguns
hipervisores exigem uma granularidade maior que KiB, e solicitações que não são uniformes
múltiplo será arredondado para cima. Por exemplo, o vSphere/ESX arredonda o parâmetro para
mebibytes (1024 kibibytes).

memtune domínio [--limite rígido tamanho] [--limite suave tamanho] [--swap-hard-limit tamanho]
[--min-garantia tamanho] [[--config] [--viver] | [--atual]]
Permite exibir ou definir os parâmetros de memória do domínio. Sem bandeiras, o atual
as configurações são exibidas; com uma bandeira, o limite apropriado é ajustado se suportado por
o hipervisor. Suporte LXC e QEMU/KVM --limite rígido, --limite suave e
--swap-hard-limit. --min-garantia é suportado apenas pelo hipervisor ESX. Cada um
esses limites são números inteiros escalonados (consulte NOTAS acima), com um padrão de kibibytes
(blocos de 1024 bytes) se nenhum sufixo estiver presente. Libvirt arredonda para o mais próximo
quibibyte. Alguns hipervisores exigem uma granularidade maior que o KiB e solicitam que
não são múltiplos pares serão arredondados. Por exemplo, o vSphere/ESX arredonda o
parâmetro até mebibytes (1024 kibibytes).

If --viver é especificado, afeta um convidado em execução. Se --config é especificado, afeta o
próxima inicialização de um convidado persistente. Se --atual é especificado, afeta o convidado atual
estado. Ambos --viver e --config bandeiras podem ser dadas, mas --atual é exclusivo. Se não
sinalizador é especificado, o comportamento é diferente dependendo do hipervisor.

Para QEMU/KVM, os parâmetros são aplicados ao processo QEMU como um todo. Assim, quando
contando-os, é necessário adicionar RAM de convidado, RAM de vídeo de convidado e um pouco de memória
sobrecarga do próprio QEMU. A última peça é difícil de determinar, então é preciso adivinhar e
experimentar.

Para LXC, o valor hard_limit exibido é a configuração de memória atual do XML ou
os resultados de um Virsh definir comando.

--limite rígido
A memória máxima que o convidado pode usar.

--limite suave
O limite de memória a ser imposto durante a contenção de memória.

--swap-hard-limit
A memória máxima mais troca que o convidado pode usar. Isso tem que ser mais do que difícil.
valor limite fornecido.

--min-garantia
A alocação mínima de memória garantida para o convidado.

Especificar -1 como valor para esses limites é interpretado como ilimitado.

blkiotune domínio [--peso peso] [--device-pesos pesos do dispositivo]
[--device-read-iops-sec dispositivo-leitura-iops-sec] [--device-write-iops-sec dispositivo-gravação-iops-
seca] [--device-read-bytes-sec dispositivo-leitura-bytes-s] [--device-write-bytes-sec dispositivo-
gravação-bytes-s] [[--config] [--viver] | [--atual]]
Exibir ou definir os parâmetros do blkio. Suporte QEMU/KVM --peso. --peso está dentro do alcance
[100, 1000]. Após o kernel 2.6.39, o valor pode estar no intervalo [10, 1000].

pesos do dispositivo é uma única string listando um ou mais pares dispositivo/peso, no
formato de /caminho/para/dispositivo,peso,/caminho/para/dispositivo,peso. Cada peso está na faixa
[100, 1000], [10, 1000] após o kernel 2.6.39 ou o valor 0 para remover esse dispositivo do
listagens por dispositivo. Somente os dispositivos listados na string são modificados; qualquer existente
os pesos por dispositivo para outros dispositivos permanecem inalterados.

dispositivo-leitura-iops-sec é uma única string listando um ou mais dispositivos/read_iops_sec
pares, no formato /caminho/para/dispositivo,read_iops_sec,/caminho/para/dispositivo,read_iops_sec.
Cada read_iops_sec é um número cujo tipo é unsigned int, valor 0 para remover isso
dispositivo da listagem por decisão. Somente os dispositivos listados na string são modificados;
qualquer read_iops_sec existente por dispositivo para outros dispositivos permanece inalterado.

dispositivo-gravação-iops-sec é uma única string listando um ou mais dispositivos/write_iops_sec
pares, no formato de
/caminho/para/dispositivo,write_iops_sec,/caminho/para/dispositivo,write_iops_sec. Cada write_iops_sec é
um número cujo tipo é unsigned int, valor 0 para remover esse dispositivo do per-decice
listagem. Somente os dispositivos listados na string são modificados; qualquer dispositivo existente por dispositivo
write_iops_sec para outros dispositivos permanecem inalterados.

dispositivo-leitura-bytes-s é uma única string listando um ou mais dispositivos/read_bytes_sec
pares, no formato de
/caminho/para/dispositivo,read_bytes_sec,/caminho/para/dispositivo,read_bytes_sec. Cada read_bytes_sec é
um número cujo tipo é unsigned long long, valor 0 para remover esse dispositivo do per-
lista de decisão. Somente os dispositivos listados na string são modificados; qualquer per-
dispositivo read_bytes_sec para outros dispositivos permanecem inalterados.

dispositivo-gravação-bytes-s é uma única string listando um ou mais dispositivos/write_bytes_sec
pares, no formato de
/caminho/para/dispositivo,write_bytes_sec,/caminho/para/dispositivo,write_bytes_sec. Cada write_bytes_sec
é um número cujo tipo é unsigned long long, valor 0 para remover esse dispositivo do per-
lista de decisão. Somente os dispositivos listados na string são modificados; qualquer per-
write_bytes_sec do dispositivo para outros dispositivos permanecem inalterados.

If --viver é especificado, afeta um convidado em execução. Se --config é especificado, afeta o
próxima inicialização de um convidado persistente. Se --atual é especificado, afeta o convidado atual
estado. Ambos --viver e --config bandeiras podem ser dadas, mas --atual é exclusivo. Se não
sinalizador é especificado, o comportamento é diferente dependendo do hipervisor.

setvcpus domínio contar [--máximo] [[--config] [--viver] | [--atual]] [--hóspede]
Altere o número de CPUs virtuais ativas em um domínio convidado. Por padrão, este comando
funciona em domínios convidados ativos. Para alterar as configurações de um domínio convidado inativo,
use o --config bandeira.

O contar O valor pode ser limitado pelo host, hipervisor ou por um limite proveniente do
descrição original do domínio convidado. Para o Xen, você só pode ajustar o virtual
CPUs de um domínio em execução se o domínio for paravirtualizado.

Se o --config sinalizador é especificado, a alteração é feita na configuração XML armazenada
para o domínio convidado e só entrará em vigor na próxima vez que o domínio convidado for iniciado.

If --viver for especificado, o domínio convidado deverá estar ativo e a alteração ocorrerá
imediatamente. Tanto o --config e --viver sinalizadores podem ser especificados juntos se
suportado pelo hipervisor. Se este comando for executado antes do convidado terminar
inicialização, o convidado pode não conseguir processar a alteração.

If --atual é especificado, afeta o estado atual do convidado.

Quando nenhuma bandeira for dada, o --viver flag é assumida e o domínio convidado deve ser
ativo. Nesta situação cabe ao hipervisor se o --config bandeira é
também assumido e, portanto, se a configuração XML é ajustada para tornar o
mudança persistente.

If --hóspede é especificado, então a contagem de cpus é modificada no convidado em vez de
o hipervisor. Este sinalizador pode ser usado apenas para domínios ativos e pode exigir agente convidado
a ser configurado no convidado.

O --máximo flag controla o número máximo de CPUs virtuais que podem ser hot-plugged
na próxima vez que o domínio for inicializado. Como tal, só deve ser utilizado com o --config
bandeira, e não com a --viver ou de --atual bandeira.

encerramento domínio [--modo LISTA DE MODOS]
Encerra normalmente um domínio. Isso se coordena com o sistema operacional de domínio para realizar
desligamento normal, então não há garantia de que terá sucesso e pode demorar um
duração variável de tempo dependendo de quais serviços devem ser encerrados no domínio.

O comportamento exato de um domínio quando ele é encerrado é definido pelo on_shutdown parâmetro
na definição XML do domínio.

If domínio for transitório, os metadados de quaisquer instantâneos serão perdidos assim que o convidado
para de ser executado, mas o conteúdo do snapshot ainda existe e um novo domínio com o mesmo
nome e UUID podem restaurar os metadados do instantâneo com criação de instantâneo.

Por padrão, o hipervisor tentará escolher um método de desligamento adequado. Para especificar um
método alternativo, o --modo parâmetro pode especificar uma lista separada por vírgulas que
inclui "acpi", "agent", "initctl", "signal" e "paravirt". A ordem em que
os drivers tentarão que cada modo seja indefinido e não esteja relacionado à ordem especificada para
virsh. Para um controle rigoroso sobre os pedidos, use um único modo de cada vez e repita o
comando.

começo nome de domínio ou uuid [--console] [--pausado] [--autodestruir] [--bypass-cache]
[--force-boot] [--pass-fds N,M,...]
Inicie um domínio inativo (previamente definido), seja do último gerenciado salvar Estado,
ou por meio de uma nova inicialização se nenhum estado de salvamento gerenciado estiver presente. O domínio será pausado se
da --pausado opção é usada e suportada pelo driver; caso contrário, ele estará em execução.
If --console for solicitado, anexe ao console após a criação. Se --autodestruir is
solicitado, o convidado será automaticamente destruído quando o virsh fechar seu
conexão com libvirt ou sai de outra forma. Se --bypass-cache é especificado, e
existir, a restauração evitará o cache do sistema de arquivos, embora isso
pode retardar a operação. Se --force-boot é especificado, então qualquer estado de salvamento gerenciado
é descartado e ocorre uma nova inicialização.

If --pass-fds é especificado, o argumento é uma lista separada por vírgula de arquivos abertos
descritores que devem ser repassados ​​ao hóspede. Os descritores de arquivo serão re-
numerado no convidado, começando em 3. Isso só é suportado com base em contêiner
virtualização.

suspender domínio
Suspender um domínio em execução. Ele é mantido na memória, mas não será mais agendado.

currículo domínio
Tira um domínio do estado suspenso. Isso permitirá que um usuário anteriormente suspenso
domínio agora seja elegível para agendamento pelo hipervisor subjacente.

dompmsuspender domínio alvo [--duração]
Suspender um domínio em execução em um desses estados (possível alvo valores):
mem equivalente ao estado S3 ACPI
equivalente em disco do estado S4 ACPI
RAM híbrida é salva no disco, mas não desligada

O --duração argumento especifica o número de segundos antes que o domínio seja ativado
depois de ter sido suspenso (ver também dompmwakeup). O padrão é 0 para suspensão ilimitada
tempo. (Este recurso não é atualmente suportado por nenhum driver de hipervisor e 0 deve ser
usado.).

Observe que este comando requer um agente convidado configurado e em execução no domínio
sistema operacional convidado.

Esteja ciente de que, pelo menos para o QEMU, o processo do domínio será encerrado quando o destino
disco é usado e um novo processo será iniciado quando a libvirt for solicitada a ativar o
domínio. Como resultado disso, qualquer alteração no tempo de execução, como hotplug do dispositivo ou memória
configurações, são perdidas, a menos que tais alterações sejam feitas com --config bandeira.

dompmwakeup domínio
Ative um domínio do estado pmsuspended (suspenso por dompmsuspend ou do estado
próprio convidado). Injeta uma ativação no convidado que está no estado pmsuspended, em vez
do que esperar que a duração solicitada anteriormente (se houver) decorra. Esta operação
não falha necessariamente se o domínio estiver em execução.

ttyconsole domínio
Gere o dispositivo usado para o console TTY do domínio. Se a informação não for
disponível, os processos fornecerão um código de saída 1.

indefinir domínio [--gerenciado-salvar] [--snapshots-metadados] [--nvram] [{--armazenar volumes |
--remove-todo-armazenamento [--delete-instantâneos]} --wipe-armazenamento]
Indefinir um domínio. Se o domínio estiver em execução, isso o converte em um domínio transitório,
sem pará-lo. Se o domínio estiver inativo, a configuração do domínio será removida.

O --gerenciado-salvar sinalizador garante que qualquer imagem salva gerenciada (veja o gerenciado salvar
comando) também é limpo. Sem o sinalizador, as tentativas de indefinir um domínio com um
a imagem salva gerenciada falhará.

O --snapshots-metadados sinalizador garante que quaisquer instantâneos (veja o lista de instantâneos
comando) também são limpos ao indefinir um domínio inativo. Sem a bandeira,
tentativas de indefinir um domínio inativo com metadados de snapshot falharão. Se o
domínio está ativo, esse sinalizador é ignorado.

O --nvram flag garante que nenhum arquivo nvram (/domain/os/nvram/) seja deixado para trás. Se o
domínio tiver um arquivo nvram e o sinalizador for omitido, a indefinição falhará.

O --armazenar flag recebe um parâmetro volumes, que é uma lista separada por vírgulas de
nomes de destino de volume ou caminhos de origem de volumes de armazenamento a serem removidos junto com o
domínio indefinido. Os volumes podem ser indefinidos e, portanto, removidos apenas em domínios inativos.
A exclusão do volume só é tentada depois que o domínio é indefinido; se não todos
os volumes solicitados podem ser excluídos, a mensagem de erro indica o que ainda resta
atrás. Se um caminho de volume não for encontrado na definição de domínio, ele será tratado como se o
o volume foi excluído com sucesso. Somente volumes gerenciados pela libvirt em pools de armazenamento podem
ser removido desta forma. (Ver lista domblk para obter uma lista de nomes de destino associados a um
domínio). Exemplo: --storage vda,/caminho/para/storage.img

O --remove-todo-armazenamento sinalizador especifica que todos os volumes de armazenamento do domínio
deve ser excluído.

O --delete-instantâneos sinalizador especifica que quaisquer instantâneos associados ao armazenamento
o volume também deve ser excluído. Requer o --remove-todo-armazenamento bandeira para ser
oferecido. Nem todos os drivers de armazenamento suportam esta opção, atualmente apenas o rbd.

A bandeira --wipe-armazenamento especifica que os volumes de armazenamento devem ser apagados antes
remoção.

NOTA: Para um domínio inativo, o nome de domínio ou UUID deve ser usado como domínio.

vcpucount domínio [{--máximo | --ativo} {--config | --viver | --atual}] [--hóspede]
Imprima informações sobre as contagens de CPU virtual do determinado domínio. Se não houver bandeiras
especificado, todas as contagens possíveis são listadas em uma tabela; caso contrário, a saída é limitada
apenas para o valor numérico solicitado. Por razões históricas, a tabela lista os
rótulo "atual" nas linhas que podem ser consultadas isoladamente por meio do --ativo bandeira,
em vez de se relacionar com o --atual bandeira.

--máximo solicita informações sobre o limite máximo de vcpus que um domínio pode adicionar via
setvcpus, enquanto --ativo mostra o uso atual; estas duas bandeiras não podem ser ambas
Especificadas. --config requer um domínio persistente e solicita informações sobre
na próxima vez que o domínio for inicializado, --viver requer um domínio em execução e listas
valores atuais, e --atual consultas de acordo com o estado atual do domínio
(correspondente a --viver se estiver correndo, ou --config se inativo); essas três bandeiras são
Mutualmente exclusivo.

If --hóspede é especificado, então a contagem de cpus é relatada da perspectiva de
O convidado. Este sinalizador pode ser usado apenas para domínios ativos e pode exigir que o agente convidado seja
configurado no convidado.

vcpuinfo domínio [--bonito]
Retorna informações básicas sobre as CPUs virtuais do domínio, como o número de vCPUs, o
tempo de execução, a afinidade com processadores físicos.

Com --bonito, as afinidades da CPU são mostradas como intervalos.

vcpupin domínio [vcpu] [cpulista] [[--viver] [--config] | [--atual]]
Consulte ou altere a fixação de VCPUs de domínio para hospedar CPUs físicas. Para fixar um único
vcpu, especificamos cpulista; caso contrário, você pode consultar um vcpu ou omitir vcpu listar tudo em
uma vez.

cpulista é uma lista de números físicos de CPU. Sua sintaxe é uma lista separada por vírgulas e um
marcação especial usando '-' e '^' (ex. '0-4', '0-3,^2') também pode ser permitida. O '-'
denota o intervalo e '^' denota exclusivo. Para fixar o vcpu para todos os físicos
cpus especifica 'r' como um cpulista. Se --viver é especificado, afeta um convidado em execução. Se
--config for especificado, afetará a próxima inicialização de um convidado persistente. Se --atual is
especificado, afeta o estado atual do convidado. Ambos --viver e --config bandeiras podem ser
dado se cpulista está presente, mas --atual é exclusivo. Se nenhum sinalizador for especificado,
o comportamento é diferente dependendo do hipervisor.

Observação: a expressão é avaliada sequencialmente, então "0-15,^8" é idêntico a
"9-14,0-7,15" mas não idêntico a "^8,0-15".

emuladorpin domínio [cpulista] [[--viver] [--config] | [--atual]]
Consulte ou altere a fixação dos threads do emulador do domínio para hospedar CPUs físicas.

See vcpupin for cpulista.

If --viver é especificado, afeta um convidado em execução. Se --config é especificado, afeta o
próxima inicialização de um convidado persistente. Se --atual é especificado, afeta o convidado atual
estado. Ambos --viver e --config bandeiras podem ser dadas se cpulista está presente, mas
--atual é exclusivo. Se nenhum sinalizador for especificado, o comportamento será diferente dependendo
hipervisor.

exibição vnc domínio
Envie o endereço IP e o número da porta para o display VNC. Se a informação não for
disponível, os processos fornecerão um código de saída 1.

DISPOSITIVO COMANDOS

Os comandos a seguir manipulam dispositivos associados a domínios. O domínio pode ser
especificado como um número inteiro curto, um nome ou um UUID completo. Para entender melhor os valores
permitidas como opções para o comando lendo a documentação em
<http://libvirt.org/formatdomain.html> no formato das seções do dispositivo para obter o
conjunto mais preciso de valores aceitos.

dispositivo de conexão domínio ARQUIVO [[[--viver] [--config] | [--atual]] | [--persistente]]
Anexe um dispositivo ao domínio usando uma definição de dispositivo em um arquivo XML usando um dispositivo
elemento de definição, como ou como o elemento de nível superior. Veja o
documentação emhttp://libvirt.org/formatdomain.html#elementsDevices> para saber mais
Formato XML libvirt para um dispositivo. Se --config é especificado, o comando altera o
configuração de domínio persistente com a anexação do dispositivo entrando em vigor na próxima vez
libvirt inicia o domínio. Para dispositivos de cdrom e disquete, este comando substitui apenas
a mídia dentro de um dispositivo existente; considere usar dispositivo de atualização para este uso. Para
dispositivos host de passagem, consulte também nodedev-detach, necessário se o dispositivo PCI não
use o modo gerenciado.

If --viver é especificado, afetará um domínio em execução. Se --config é especificado, afeta o
próxima inicialização de um domínio persistente. Se --atual é especificado, afeta a corrente
estado do domínio. Ambos --viver e --config bandeiras podem ser dadas, mas --atual is
exclusivo. Quando nenhum sinalizador é especificado, a API legada é usada cujo comportamento depende do
driver do hipervisor.

Para fins de compatibilidade, --persistente se comporta como --config para um domínio off-line,
e gosto --viver --config para um domínio em execução.

Observação: o uso de arquivos XML de definição parcial de dispositivo pode levar a resultados inesperados, pois
alguns campos podem ser gerados automaticamente e, portanto, corresponder a dispositivos diferentes dos esperados.

anexar disco domínio fonte alvo [[[--viver] [--config] | [--atual]] | [--persistente]]
[--targetbus ônibus] [--motorista motorista] [--subdriver subdriver] [--iothread iothread] [--cache
esconderijo] [--modelo tipo] [--modo modo] [--sourcetype tipo de fonte] [--serial serial] [--wwn wwn]
[--rawio] [--Morada endereço] [--multifuncional] [--print-xml]
Anexe um novo dispositivo de disco ao domínio. fonte é o caminho para os arquivos e dispositivos.
alvo controla o barramento ou dispositivo sob o qual o disco está exposto ao sistema operacional convidado. Isto
indica o nome "lógico" do dispositivo; o opcional barramento alvo atributo especifica o
tipo de dispositivo de disco a ser emulado; os valores possíveis são específicos do driver, com típico
valores sendo ide, scsi, virtio, Xen, usb, sata, ou sd, se omitido, o tipo de barramento é
inferido do estilo do nome do dispositivo (por exemplo, um dispositivo chamado 'sda' normalmente
ser exportado usando um barramento SCSI). motorista pode ser lima, torneira or phy para o hipervisor Xen
dependendo do tipo de acesso; ou qemu para o emulador QEMU. Mais detalhes para
o motorista pode ser passado usando subdriver. Para Xen subdriver pode ser aio, enquanto para QEMU
subdriver deve corresponder ao formato da origem do disco, como cru or qcow2.
O padrão do hipervisor será usado se subdriver não está especificado. No entanto, o padrão
pode não estar correto, esp. para QEMU, pois por razões de segurança ele está configurado para não
detectar formatos de disco. tipo pode indicar lun, cdrom or mole como alternativa ao
disco padrão, embora esse uso substitua apenas a mídia dentro do virtual existente
dispositivo de CD-ROM ou disquete; considere usar dispositivo de atualização para esse uso. modo pode
especifique os dois modos específicos somente leitura or compartilhável. tipo de fonte pode indicar o tipo
da fonte (bloco | arquivo) esconderijo pode ser "padrão", "nenhum", "writethrough",
"writeback", "directsync" ou "inseguro". iothread é o número dentro do intervalo de
domínio IOThreads ao qual este disco pode ser anexado (somente QEMU). serial é a série
do dispositivo de disco. wwn é o wwn do dispositivo de disco. cruio indica que o disco precisa de rawio
capacidade. endereço é o endereço do dispositivo de disco na forma de
pci:domain.bus.slot.function, scsi:controller.bus.unit, ide:controller.bus.unit ou
ccw:cssid.ssid.devno. Os dispositivos Virtio-ccw devem ter seu cssid definido como 0xfe.
multifunções indica que o endereço PCI especificado é um endereço de dispositivo PCI multifuncional.

If --print-xml é especificado, então o XML do disco que seria anexado é
impresso em vez disso.

If --viver é especificado, afetará um domínio em execução. Se --config é especificado, afeta o
próxima inicialização de um domínio persistente. Se --atual é especificado, afeta a corrente
estado do domínio. Ambos --viver e --config bandeiras podem ser dadas, mas --atual is
exclusivo. Quando nenhum sinalizador é especificado, a API legada é usada cujo comportamento depende do
driver do hipervisor.

Para fins de compatibilidade, --persistente se comporta como --config para um domínio off-line,
e gosto --viver --config para um domínio em execução. Da mesma maneira, --compartilhável é um apelido para
--modo compartilhável.

interface de anexação domínio tipo fonte [[[--viver] [--config] | [--atual]] | [--persistente]]
[--alvo alvo] [--Mac mac] [--roteiro escrita] [--modelo modelo] [--entrada
média, pico, explosão, piso] [--saída média, pico, explosão] [--gerenciou] [--print-xml]
Anexe uma nova interface de rede ao domínio.

tipo pode ser um dos:

rede para indicar conexão através de uma rede virtual libvirt,

ponte para indicar a conexão através de um dispositivo de ponte no host,

diretamente para indicar conexão diretamente a uma das interfaces de rede do host ou
pontes,

hostdev para indicar a conexão usando uma passagem do dispositivo PCI no host.

fonte indica a origem da conexão. A fonte depende do tipo de
Interface:

rede nome da rede virtual,

ponte o nome do dispositivo de ponte,

diretamente o nome da interface ou ponte do host,

hostdev o endereço PCI da interface do host formatado como
domínio: barramento: slot.function.

--alvo é usado para especificar o dispositivo tap/macvtap a ser usado para conectar o domínio ao
a fonte. Nomes que começam com 'vnet' são considerados gerados automaticamente e são
apagado/regenerado cada vez que a interface é conectada.

--Mac especifica o endereço MAC da interface de rede; se um endereço MAC não for
fornecido, um novo endereço será gerado automaticamente (e armazenado no arquivo persistente
configuração se "--config" for fornecido na linha de comando).

--roteiro é usado para especificar um caminho para um script personalizado a ser chamado durante a anexação ao
uma ponte - ela será chamada em vez do script padrão e não além dele.
Isso é válido apenas para interfaces de ponte tipo e apenas para domínios Xen.

--modelo especifica o modelo de dispositivo de rede a ser apresentado ao domínio.

--entrada e --saída controlar a largura de banda da interface. Pelo menos um de
da média, andar par deve ser especificado. Os outros dois pico e explosão são opcionais,
então "média, pico", "média,, explosão", "média,,,piso", "média" e ",,,piso" são
também legal. Valores para média, andar e pico são expressos em quilobytes por segundo,
enquanto explosão é expresso em kilobytes em uma única explosão em pico velocidade conforme descrito em
a documentação do Network XML emhttp://libvirt.org/formatnetwork.html#elementoQoS>.

--gerenciou é utilizável apenas para hostdev type e diz à libvirt que a interface deve
ser gerenciado, o que significa desanexado e reconectado de/para o host pela libvirt.

If --print-xml é especificado, então o XML da interface que seria anexada é
impresso em vez disso.

If --viver é especificado, afetará um domínio em execução. Se --config é especificado, afeta o
próxima inicialização de um domínio persistente. Se --atual é especificado, afeta a corrente
estado do domínio. Ambos --viver e --config bandeiras podem ser dadas, mas --atual is
exclusivo. Quando nenhum sinalizador é especificado, a API legada é usada cujo comportamento depende do
driver do hipervisor.

Para fins de compatibilidade, --persistente se comporta como --config para um domínio off-line,
e gosto --viver --config para um domínio em execução.

Observação: o valor de destino opcional é o nome de um dispositivo a ser criado como back-end
no nó. Se não for fornecido, um dispositivo chamado "vnetN" ou "vifN" será criado
automaticamente.

dispositivo de desconexão domínio ARQUIVO [[[--viver] [--config] | [--atual]] | [--persistente]]
Desconectar um dispositivo do domínio, usa o mesmo tipo de descrições XML do comando
dispositivo de conexão. Para dispositivos host de passagem, consulte também nodedev-reattach, necessário se o
o dispositivo não usa o modo gerenciado.

Observação: A descrição XML fornecida do dispositivo deve ser tão específica quanto seu
definição no domínio XML. O conjunto de atributos usados ​​para corresponder ao dispositivo é
interno aos drivers. Usando uma definição parcial ou tentando desanexar um dispositivo
que não está presente no XML do domínio, mas compartilha alguns atributos específicos com um
presente, pode levar a resultados inesperados.

If --viver é especificado, afetará um domínio em execução. Se --config é especificado, afeta o
próxima inicialização de um domínio persistente. Se --atual é especificado, afeta a corrente
estado do domínio. Ambos --viver e --config bandeiras podem ser dadas, mas --atual is
exclusivo. Quando nenhum sinalizador é especificado, a API legada é usada cujo comportamento depende do
driver do hipervisor.

Para fins de compatibilidade, --persistente se comporta como --config para um domínio off-line,
e gosto --viver --config para um domínio em execução.

Observe que versões mais antigas do virsh usavam --config como um apelido para --persistente.

desanexar disco domínio alvo [[[--viver] [--config] | [--atual]] | [--persistente]]
Desanexe um dispositivo de disco de um domínio. O alvo é o dispositivo visto do domínio.

If --viver é especificado, afetará um domínio em execução. Se --config é especificado, afeta o
próxima inicialização de um domínio persistente. Se --atual é especificado, afeta a corrente
estado do domínio. Ambos --viver e --config bandeiras podem ser dadas, mas --atual is
exclusivo. Quando nenhum sinalizador é especificado, a API legada é usada cujo comportamento depende do
driver do hipervisor.

Para fins de compatibilidade, --persistente se comporta como --config para um domínio off-line,
e gosto --viver --config para um domínio em execução.

Observe que versões mais antigas do virsh usavam --config como um apelido para --persistente.

interface de desanexação domínio tipo [--Mac mac] [[[--viver] [--config] | [--atual]] |
[--persistente]]
Desconecte uma interface de rede de um domínio. tipo pode ser rede para indicar um
dispositivo de rede física ou ponte para indicar uma ponte para um dispositivo. É recomendado
usar o mac opção para distinguir entre as interfaces se mais de uma estiver
presente no domínio.

If --viver é especificado, afetará um domínio em execução. Se --config é especificado, afeta o
próxima inicialização de um domínio persistente. Se --atual é especificado, afeta a corrente
estado do domínio. Ambos --viver e --config bandeiras podem ser dadas, mas --atual is
exclusivo. Quando nenhum sinalizador é especificado, a API legada é usada cujo comportamento depende do
driver do hipervisor.

Para fins de compatibilidade, --persistente se comporta como --config para um domínio off-line,
e gosto --viver --config para um domínio em execução.

Observe que versões mais antigas do virsh usavam --config como um apelido para --persistente.

dispositivo de atualização domínio lima [--força] [[[--viver] [--config] | [--atual]] | [--persistente]]
Atualizar as características de um dispositivo associado a domínio, com base no dispositivo
definição em um XML lima. O --força opção pode ser usada para forçar a atualização do dispositivo,
por exemplo, para ejetar um CD-ROM mesmo se ele estiver bloqueado/montado no domínio. Veja o
documentação emhttp://libvirt.org/formatdomain.html#elementsDevices> para saber mais
Formato XML libvirt para um dispositivo.

If --viver é especificado, afetará um domínio em execução. Se --config é especificado, afeta o
próxima inicialização de um domínio persistente. Se --atual é especificado, afeta a corrente
estado do domínio. Ambos --viver e --config bandeiras podem ser dadas, mas --atual is
exclusivo. Não especificar nenhum sinalizador é o mesmo que especificar --atual.

Para fins de compatibilidade, --persistente se comporta como --config para um domínio off-line,
e gosto --viver --config para um domínio em execução.

Observe que versões mais antigas do virsh usavam --config como um apelido para --persistente.

Observação: o uso de arquivos XML de definição parcial de dispositivo pode levar a resultados inesperados, pois
alguns campos podem ser gerados automaticamente e, portanto, corresponder a dispositivos diferentes dos esperados.

mudança de mídia domínio caminho [--ejetar] [--inserir] [--atualizar] [fonte] [--força] [[--viver]
[--config] | [--atual]] [--print-xml] [--bloquear]
Troque a mídia de CDROM ou unidade de disquete. caminho pode ser o caminho totalmente qualificado ou o
nome de destino exclusivo ( ) do dispositivo de disco. fonte especifica o caminho
da mídia a ser inserida ou atualizada. Bandeira --bloquear permite definir o tipo de apoio em
Nesse caso, um dispositivo de bloco é usado como mídia para o CD-ROM ou unidade de disquete em vez de um arquivo.

--ejetar indica que a mídia será ejetada. --inserir indica que a mídia será
inserido. fonte deve ser especificado. Se o dispositivo tiver fonte (por exemplo
arquivo='mídia'>) e fonte não é especificado, --atualizar é igual a --ejetar. Se o
dispositivo não tem fonte e fonte é especificado, --atualizar é igual a --inserir. Se o
dispositivo tem fonte, e fonte é especificado, --atualizar se comporta como uma combinação de
--ejetar e --inserir. Se nenhum de --ejetar, --inserir e --atualizar é especificado,
--atualizar é usado por padrão. o --força opção pode ser usada para forçar a mudança de mídia.
If --viver for especificado, altere a configuração ao vivo do convidado em execução. Se --config is
especificado, altera a configuração persistente, efeito observado na próxima inicialização. --atual
pode ser um ou ambos viver e configuração, depende da implementação do hipervisor.
Ambos --viver e --config bandeiras podem ser dadas, mas --atual é exclusivo. Se nenhuma bandeira for
especificado, o comportamento é diferente dependendo do hipervisor. Se --print-xml is
especificado, o XML que seria usado para alterar a mídia é impresso em vez de alterar
a mídia.

NODEDEV COMANDOS

Os comandos a seguir manipulam dispositivos host que devem ser transmitidos para
domínios convidados por meio de elementos de um domínio seção. Uma chave de dispositivo de nó
geralmente é especificado pelo nome do barramento seguido de seu endereço, usando sublinhados entre
todos os componentes, como pci_0000_00_02_1, usb_1_5_3 ou net_eth1_00_27_13_6a_fe_00. O
lista de nodedev fornece a lista completa de dispositivos host conhecidos pela libvirt, embora este
inclui dispositivos que não podem ser atribuídos a um convidado (por exemplo, tentativa de desconectar o
Dispositivo PCI que controla o controlador de disco rígido do host onde estão as imagens de disco do convidado
live pode fazer com que o sistema host trave ou reinicie).

Para obter mais informações sobre a definição de dispositivo de nó, consulte:http://libvirt.org/formatnode.html>.

Os dispositivos de passagem não podem ser usados ​​simultaneamente pelo host e seus domínios convidados, nem
por vários convidados ativos ao mesmo tempo. Se o a descrição de um dispositivo PCI inclui
o atributo gerenciado='sim', e o driver do hipervisor o suportar, então o dispositivo está em
modo gerenciado e as tentativas de usar esse dispositivo de passagem em um convidado ativo
comportar-se automaticamente como se nodedev-detach (início de convidado, hot-plug do dispositivo) e nodedev-
recolocar (parada de convidado, dispositivo hot-unplug) foram chamados nos pontos certos. Se um dispositivo PCI
não estiver marcado como gerenciado, ele deverá ser desconectado manualmente antes que os hóspedes possam usá-lo e
reconectado manualmente para ser retornado ao host. Além disso, se um dispositivo for desconectado manualmente,
então o host não recupera o controle do dispositivo sem uma reconexão correspondente, mesmo que
os convidados usam o dispositivo no modo gerenciado.

nodedev-criar ARQUIVO
Crie um dispositivo no nó host que possa então ser atribuído a máquinas virtuais.
Normalmente, a libvirt é capaz de determinar automaticamente quais nós de host estão disponíveis
para uso, mas isso permite o registro de hardware host que a libvirt não
detectar automaticamente. lima contém xml para um nível superior descrição de um
dispositivo de nó.

nodedev-destruir dispositivo
Destrua (pare) um dispositivo no host. dispositivo pode ser o nome do dispositivo ou o par wwn em
Formato "wwnn, wwpn" (atualmente funciona apenas para vHBA). Observe que isso faz com que a libvirt saia
gerenciar um dispositivo host e pode até tornar esse dispositivo inutilizável pelo resto do
host físico até uma reinicialização.

nodedev-detach nodeev [--motorista backend_driver]
Separar nodeev do anfitrião, para que possa ser usado com segurança pelos hóspedes via
atravessar. Isto é revertido com nodedev-reattach, e é feito automaticamente para
dispositivos gerenciados. Para fins de compatibilidade, este comando também pode ser escrito
nodedev-dettach.

Diferentes drivers de back-end esperam que o dispositivo esteja vinculado a diferentes dispositivos fictícios.
Por exemplo, o driver backend "kvm" do QEMU (o padrão) espera que o dispositivo seja vinculado
para pci-stub, mas seu driver de back-end "vfio" espera que o dispositivo esteja vinculado a vfio-pci.
O --motorista O parâmetro pode ser usado para especificar o driver de back-end desejado.

nodedev-dumpxml dispositivo
Despejar um Representação XML para um determinado dispositivo de nó, incluindo tais
informações como o nome do dispositivo, qual barramento possui o dispositivo, o fornecedor e o ID do produto,
e quaisquer recursos do dispositivo utilizáveis ​​pela libvirt (como se a redefinição do dispositivo é
suportado). dispositivo pode ser o nome do dispositivo ou o par wwn no formato "wwnn,wwpn" (somente
funciona para HBA).

lista de nodedev boné --árvore
Liste todos os dispositivos disponíveis no nó que são conhecidos pela libvirt. boné é usado
para filtrar a lista por tipos de capacidade, os tipos devem ser separados por vírgula, por exemplo
--cap pci,scsi, tipos de recursos válidos incluem 'system', 'pci', 'usb_device', 'usb',
'net', 'scsi_host', 'scsi_target', 'scsi', 'armazenamento', 'fc_host', 'vports',
'scsi_genérico'. Se --árvore é usado, a saída é formatada em uma árvore representando
pais de cada nó. boné e --árvore são mutuamente exclusivos.

nodedev-reattach nodeev
Declare que nodeev não está mais em uso por nenhum convidado e que o anfitrião pode retomar
uso normal do dispositivo. Isso é feito automaticamente para dispositivos PCI em modo gerenciado
e dispositivos USB, mas deve ser feito explicitamente para corresponder a qualquer nodedev-detach.

nodedev-reset nodeev
Acionar uma redefinição do dispositivo para nodeev, útil antes de transferir um dispositivo de nó entre
passagem do convidado ou do host. Libvirt frequentemente fará esta ação implicitamente quando
obrigatório, mas este comando permite uma redefinição explícita quando necessário.

VIRTUAL REDE COMANDOS

Os comandos a seguir manipulam redes. Libvirt tem a capacidade de definir virtual
redes que podem então ser usadas por domínios e vinculadas a dispositivos de rede reais. Para mais
informações detalhadas sobre esse recurso consulte a documentação em
<http://libvirt.org/formatnetwork.html> . Muitos dos comandos para redes virtuais são
semelhantes aos usados ​​para domínios, mas a forma de nomear uma rede virtual é por
seu nome ou UUID.

net-autostart rede [--desativar]
Configure uma rede virtual para ser iniciada automaticamente na inicialização. O --desativar opção
desativar a inicialização automática.

criar rede lima
Crie uma rede virtual transitória (temporária) a partir de um XML lima e instanciar
(iniciar) a rede. Veja a documentação emhttp://libvirt.org/formatnetwork.html>
para obter uma descrição do formato de rede XML usado pela libvirt.

definição de rede lima
Definir uma rede virtual persistente inativa ou modificar uma rede persistente existente
do XML lima.

destruição de rede rede
Destruir (parar) uma determinada rede virtual transitória ou persistente especificada pelo seu nome
ou UUID. Isso entra em vigor imediatamente.

net-dumpxml rede [--inativo]
Produza as informações da rede virtual como um dump XML para stdout. Se --inativo is
especificado, então as funções físicas não são expandidas em seus espaços virtuais associados.
funções.

edição líquida rede
Edite o arquivo de configuração XML para uma rede.

Isso é equivalente a:

virsh net-dumpxml --rede inativa > network.xml
vi network.xml (ou faça alterações com seu outro editor de texto)
virsh net-define network.xml

exceto que faz alguma verificação de erros.

O editor utilizado pode ser fornecido pelas variáveis ​​de ambiente $VISUAL ou $EDITOR, e
o padrão é "vi".

evento líquido {[rede] evento [--ciclo] [--tempo esgotado segundo] [--timestamp] --Lista}
Aguarde a ocorrência de uma classe de eventos de rede e imprima os detalhes apropriados dos eventos
à medida que acontecem. Os eventos podem opcionalmente ser filtrados por rede. Usando --Lista as
o único argumento fornecerá uma lista de possíveis evento valores conhecidos por este cliente,
embora a conexão possa não permitir o registro para todos esses eventos.

Por padrão, esse comando é único e retorna sucesso quando um evento ocorre; você
pode enviar SIGINT (geralmente via "Ctrl-C") para sair imediatamente. Se --tempo esgotado is
especificado, o comando desiste de esperar por eventos após segundo já decorreram. Com
--ciclo, o comando imprime todos os eventos até um tempo limite ou tecla de interrupção.

Quando --timestamp for usado, um carimbo de data e hora legível será impresso antes do evento.

informações da rede rede
Retorna informações básicas sobre o rede objeto.

lista de rede [--inativo | --tudo] {[--tabela] --nome | --uuid } [--persistente]
[<--transitório>] [--começo automático] [<--sem inicialização automática>]
Retorna a lista de redes ativas, se --tudo é especificado, isso também incluirá
redes definidas mas inativas, se --inativo é especificado apenas os inativos
ser listado. Você também pode filtrar as redes retornadas por --persistente listar
os persistentes, --transitório para listar os transitórios, --começo automático para listar o
aqueles com inicialização automática ativada e --no-autostart para listar aqueles com inicialização automática
Desativado.

If --nome é especificado, os nomes das redes são impressos em vez do formato de tabela
por linha. Se --uuid é especificado que os UUIDs da rede são impressos em vez de nomes. Bandeira
--tabela especifica que a saída formatada em tabela herdada deve ser usada. Isto é o
padrão. Todos estes são mutuamente exclusivos.

NOTA: Ao conversar com servidores mais antigos, este comando é forçado a usar uma série de API
chamadas com uma corrida inerente, onde um pool pode não estar listado ou pode aparecer mais
mais de uma vez se mudasse de estado entre as chamadas enquanto a lista estava sendo coletada. Mais recente
servidores não têm esse problema.

nome da rede rede-UUID
Converta um UUID de rede em nome de rede.

início líquido rede
Inicie uma rede inativa (previamente definida).

rede-indefinida rede
Indefina a configuração de uma rede persistente. Se a rede estiver ativa, faça-a
transitório.

net-uuid nome da rede
Converta um nome de rede em UUID de rede.

atualização líquida rede comando seção xml [--índice-pai índice] [[--viver] [--config]
[--atual]]
Atualize a seção fornecida de uma definição de rede existente, com as alterações
opcionalmente com efeito imediato, sem a necessidade de destruir e reiniciar o
rede.

comando é um de "adicionar primeiro", "adicionar último", "adicionar" (um sinônimo de adicionar último), "excluir",
ou "modificar".

seção é um de "ponte", "domínio", "ip", "ip-dhcp-host", "ip-dhcp-range",
"forward", "forward-interface", "forward-pf", "portgroup", "dns-host", "dns-txt" ou
"dns-srv", cada seção sendo nomeada por uma concatenação da hierarquia de elementos xml
levando à alteração do elemento. Por exemplo, "ip-dhcp-host" irá alterar um
elemento que está contido dentro de um elemento dentro de um elemento do
rede.

xml é o texto de um elemento xml completo do tipo que está sendo alterado (por exemplo
"
elemento xml completo. A desambiguação é feita olhando para o primeiro caractere do
texto fornecido - se o primeiro caractere for "<", é texto xml, se o primeiro caractere
não é "<", é o nome de um arquivo que contém o texto xml a ser utilizado.

O --índice-pai opção é usada para especificar qual dos vários elementos pai o
o elemento solicitado está em (baseado em 0). Por exemplo, um dhcp elemento pode estar em qualquer
um de vários elementos da rede; se um índice pai não for fornecido, o
"mais apropriado" elemento será selecionado (geralmente o único que já
tem um elemento), mas se --índice-pai é dado, aquela instância específica de
receberá a modificação.

If --viver é especificado, afetará uma rede em execução. Se --config é especificado, afeta
a próxima inicialização de uma rede persistente. Se --atual é especificado, afeta o
estado atual da rede. Ambos --viver e --config bandeiras podem ser dadas, mas --atual is
exclusivo. Não especificar nenhum sinalizador é o mesmo que especificar --atual.

arrendamentos net-dhcp rede [mac]
Obtenha uma lista de concessões de DHCP para todas as interfaces de rede conectadas ao determinado virtual
rede ou saída limitada apenas para uma interface se mac é especificado.

INTERFACE COMANDOS

Os comandos a seguir manipulam interfaces de host. Freqüentemente, essas interfaces de host podem então
ser usado por nome dentro do domínio elementos (como uma ponte criada pelo sistema
interface), mas não há exigência de que as interfaces de host estejam vinculadas a qualquer
XML de configuração de convidado.

Muitos dos comandos para interfaces de host são semelhantes aos usados ​​para domínios, e o
A maneira de nomear uma interface é pelo nome ou pelo endereço MAC. No entanto, usando um MAC
endereço para um ifface argumento só funciona quando esse endereço é único (se uma interface e
uma ponte compartilha o mesmo endereço MAC, o que geralmente é o caso, e então usar esse endereço MAC
resulta em um erro devido à ambiguidade, e você deve recorrer a um nome).

ponte iface interface ponte [--no-stp] [atraso] [--não iniciar]
Crie um dispositivo de ponte chamado pontee conecte o dispositivo de rede existente interface
para a nova ponte. O padrão da nova ponte é iniciar imediatamente, com STP habilitado
e um atraso de 0; essas configurações podem ser alteradas com --no-stp, --não iniciarE um
número inteiro de segundos para atraso. Todas as configurações de endereço IP de interface será
movido para o novo dispositivo de ponte.

Veja também iface-desponte para desfazer esta operação.

definir iface lima
Defina uma interface de host física persistente inativa ou modifique uma interface de host física persistente existente
um do XML lima.

iface-destruir interface
Destrua (pare) uma determinada interface de host, executando "if-down" para desativá-la.
interface do uso ativo. Isso entra em vigor imediatamente.

iface-dumpxml interface [--inativo]
Produza as informações da interface do host como um dump XML para stdout. Se --inativo is
especificado, então a saída reflete o estado persistente da interface que será
usado na próxima vez que for iniciado.

editar iface interface
Edite o arquivo de configuração XML para uma interface de host.

Isso é equivalente a:

virsh iface-dumpxml iface > iface.xml
vi iface.xml (ou faça alterações com seu outro editor de texto)
virsh iface-define iface.xml

exceto que faz alguma verificação de erros.

O editor utilizado pode ser fornecido pelas variáveis ​​de ambiente $VISUAL ou $EDITOR, e
o padrão é "vi".

lista iface [--inativo | --tudo]
Retorna a lista de interfaces de host ativas. Se --tudo é especificado isso também
incluem interfaces definidas, mas inativas. Se --inativo é especificado apenas o inativo
aqueles serão listados.

nome iface interface
Converta um MAC de interface de host em nome de interface, se o endereço MAC for único entre os
interfaces do host.

interface especifica o endereço MAC da interface.

iface-mac interface
Converta um nome de interface host em endereço MAC.

interface especifica o nome da interface.

iface-start interface
Inicie uma interface host (previamente definida), como executando "if-up".

iface-desponte ponte [--não iniciar]
Derrube um dispositivo de ponte chamado ponte, liberando sua interface subjacente de volta para
uso normal e mover toda a configuração de endereço IP do dispositivo bridge para o
dispositivo subjacente. A interface subjacente é reiniciada, a menos que --não iniciar is
presente; este sinalizador está presente para simetria, mas geralmente não é recomendado.

Veja também ponte iface para criar uma ponte.

iface-indefinir interface
Indefina a configuração de uma interface de host inativa.

iface-begin
Crie um instantâneo das configurações atuais da interface do host, que pode ser confirmado posteriormente
(iface-commit) ou restaurado (reversão iface). Se já existir um instantâneo, então este
O comando falhará até que o instantâneo anterior seja confirmado ou restaurado.
O comportamento indefinido ocorre se quaisquer alterações externas forem feitas nas interfaces do host fora
da API libvirt entre o início de um instantâneo e seu eventual commit ou
reversão.

iface-commit
Declare todas as alterações desde a última iface-begin como funcionando e exclua a reversão
apontar. Se nenhum snapshot da interface já tiver sido iniciado, então este comando irá
falhou.

reversão iface
Reverta todas as configurações da interface do host de volta ao estado registrado no último iface-begin.
Se nenhum snapshot da interface já tiver sido iniciado, esse comando falhará.
A reinicialização do host também serve como um ponto de reversão implícito.

ARMAZENAMENTO POOL COMANDOS

Os comandos a seguir manipulam conjuntos de armazenamento. Libvirt tem a capacidade de gerenciar
várias soluções de armazenamento, incluindo arquivos, partições brutas e formatos específicos de domínio,
usado para fornecer os volumes de armazenamento visíveis como dispositivos em máquinas virtuais. Para mais
informações detalhadas sobre esse recurso, consulte a documentação em
<http://libvirt.org/formatstorage.html> . Muitos dos comandos para pools são semelhantes a
aqueles usados ​​para domínios.

encontrar fontes de pool de armazenamento tipo [srcSpec]
Retorna XML descrevendo todas as possíveis fontes de pool de armazenamento disponíveis que poderiam ser usadas
para criar ou definir um pool de armazenamento de um determinado tipo. Se srcSpec é fornecido, é um
arquivo que contém XML para restringir ainda mais a consulta de pools.

Nem todos os pools de armazenamento suportam a descoberta dessa maneira. Além disso, para aqueles que fazem
suporte à descoberta, apenas elementos XML específicos são necessários para retornar valores válidos
dados, enquanto outros elementos e até mesmo atributos de alguns elementos são ignorados, uma vez que
não são necessários para localizar o pool com base nos critérios de pesquisa. As seguintes listas
o suportado tipo opções e os elementos XML mínimos esperados usados ​​para executar o
procurar.

Para um pool "netfs" ou "gluster", o XML mínimo esperado necessário é o
elemento com um atributo "nome" que descreve o endereço IP ou nome de host a ser usado para
encontre a piscina. O atributo "porta" será ignorado, assim como qualquer outro XML fornecido
elementos em srcSpec.

Para um pool "lógico", o conteúdo do srcSpec arquivo são ignorados, embora se
desde que o arquivo deva pelo menos existir.

Para um pool "iscsi", o XML esperado mínimo necessário é o elemento com um
Atributo "nome" que descreve o endereço IP ou nome do host a ser usado para encontrar o pool
(o endereço do servidor iSCSI). Opcionalmente, o atributo "porta" pode ser fornecido, embora
o padrão será 3260. Opcionalmente, um elemento XML com um "nome"
atributo pode ser fornecido para restringir ainda mais a pesquisa de alvo iSCSI a um determinado
iniciador para pools de armazenamento iSCSI multi-iqn.

encontrar-pool-de-armazenamento-fontes-como tipo [hospedeiro] [porta] [iniciador]
Em vez de fornecer srcSpec Arquivo XML para encontrar fontes de pool de armazenamento use este comando
opção para que o virsh gere o arquivo XML de consulta usando o opcional
argumentos. O comando retornará o mesmo XML de saída que encontrar fontes de pool de armazenamento.

Uso hospedeiro para descrever um host específico a ser usado para armazenamento em rede, como netfs,
brilho e iscsi tipo piscinas.

Uso porta para restringir ainda mais qual porta de rede utilizar para a conexão se
exigido pelo back-end de armazenamento específico, como iscsi.

Uso iniciador para restringir ainda mais o iscsi tipo agrupar pesquisas para um alvo específico
iniciadores.

pool-autostart pool-ou-uuid [--desativar]
Configurar se piscina deve iniciar automaticamente na inicialização.

construção de piscina pool-ou-uuid [- sobrescrever] [--não sobrescrever]
Construa um determinado pool.

Opções - sobrescrever e --não sobrescrever só pode ser usado para construção de piscina um sistema de arquivos ou
conjunto de discos. Para um conjunto de sistemas de arquivos, se nenhum deles for especificado, construção de piscina faz
o diretório. Se --não sobrescrever é especificado, ele testa para determinar se um sistema de arquivos
já existe no dispositivo de destino, retornando um erro, se existir, ou usando mkfs para
formate o dispositivo de destino, caso contrário. Se - sobrescrever é especificado, mkfs é sempre executado
e quaisquer dados existentes no dispositivo de destino serão substituídos incondicionalmente. Para um disco
pool, se nenhum deles for especificado ou --não sobrescrever é especificado, construção de piscina precisarão
use 'parted --print' para determinar se o disco já possui um rótulo antes
tentando criar um. Somente se um disco ainda não tiver um, um rótulo será
criado. Se - sobrescrever é especificado ou foi determinado que o disco não
já tiver um, 'parted mklabel' será usado para criar um rótulo do formato
especificado pelo tipo de formato de origem do pool ou "dos" se não for especificado para o pool.

criação de pool lima [--construir] [[- sobrescrever] | [--não sobrescrever]]
Crie e inicie um objeto pool a partir do XML lima.

[--construir] [[- sobrescrever] | [--não sobrescrever]] realizar um construção de piscina após a criação em
para eliminar a necessidade de um comando de acompanhamento para construir o pool. O - sobrescrever
e --não sobrescrever bandeiras seguem as mesmas regras que construção de piscina. Se apenas --construir is
fornecido, então construção de piscina é chamado sem sinalizadores.

pool-criar-como nome tipo [--print-xml] [--source-host hostname] [--caminho-fonte caminho]
[--source-dev caminho] [--nome-fonte nome] [--alvo caminho] [--formato-fonte formato]
[--auth-type tipo de autenticação --auth-nome de usuário nome de usuário --uso secreto uso] [[--nome do adaptador
nome] | [--adaptador-wwnn --adaptador-wwpn] [--adaptador-pai principal]] [--construir]
[[- sobrescrever] | [--não sobrescrever]]
Criar e iniciar um objeto pool nome dos parâmetros brutos. Se --print-xml is
especificado e imprima o XML do objeto pool sem criar o pool.
Caso contrário, o pool tem o especificado tipo. Ao usar pool-criar-como para uma piscina de
tipo "disco", as partições existentes encontradas no --source-dev caminho será usado para
preencher o pool de discos. Portanto, sugere-se a utilização pool-definir-como e piscina-
construir com o - sobrescrever para inicializar adequadamente o conjunto de discos.

[--source-host hostname] fornece o nome do host de origem para pools apoiados pelo armazenamento de
um servidor remoto (tipos de pool netfs, iscsi, rbd, Sheepdog, Gluster).

[--caminho-fonte caminho] fornece o caminho do diretório de origem para pools apoiados por
diretórios (tipo de pool dir).

[--source-dev caminho] fornece o caminho de origem para pools apoiados por dispositivos físicos
(tipos de pool fs, lógico, disco, iscsi, zfs).

[--nome-fonte nome] fornece o nome de origem para pools apoiados pelo armazenamento de um nome
elemento (tipos de pool lógico, rbd, Sheepdog, Gluster).

[--alvo caminho] é o caminho para o mapeamento do pool de armazenamento no arquivo host
sistema.

[--formato-fonte formato] fornece informações sobre o formato do pool (tipos de pool
fs, netfs, disco, lógico).

[--auth-type tipo de autenticação --auth-nome de usuário nome de usuário --uso secreto uso] fornece o
elementos necessários para gerar credenciais de autenticação para o pool de armazenamento. O
tipo de autenticação é um cara para iscsi tipo piscinas ou ceph para rbd tipo piscinas.

[--nome do adaptador nome] define o nome do adaptador scsi_hostN a ser usado para o scsi_host
conjunto de tipo de adaptador.

[--adaptador-wwnn --adaptador-wwpn [--adaptador-pai principal]] define wwnn e wwpn para
ser usado para o conjunto do tipo de adaptador fc_host. O pai opcionalmente fornece o nome de
o dispositivo do nó scsi_hostN a ser usado para o vHBA.

[--construir] [[- sobrescrever] | [--não sobrescrever]] realizar um construção de piscina após a criação em
para eliminar a necessidade de um comando de acompanhamento para construir o pool. O - sobrescrever
e --não sobrescrever bandeiras seguem as mesmas regras que construção de piscina. Se apenas --construir is
fornecido, então construção de piscina é chamado sem sinalizadores.

definição de pool lima
Defina um conjunto de armazenamento persistente inativo ou modifique um persistente existente em
o XML lima.

pool-definir-como nome tipo [--print-xml] [--source-host hostname] [--caminho-fonte caminho]
[--source-dev caminho] [--nome-fonte nome] [--alvo caminho] [--formato-fonte formato]
[--auth-type tipo de autenticação --auth-nome de usuário nome de usuário --uso secreto uso] [[--nome do adaptador
nome] | [--adaptador-wwnn --adaptador-wwpn] [--adaptador-pai principal]]
Crie, mas não inicie, um objeto de pool nome dos parâmetros brutos. Se --print-xml
é especificado e imprima o XML do objeto pool sem definir o pool.
Caso contrário, o pool tem o especificado tipo.

Use os mesmos argumentos que pool-criar-como, exceto para o --construir, - sobrescrever e
--não sobrescrever opções.

destruição de piscina pool-ou-uuid
Destruir (parar) um determinado piscina objeto. Libvirt não gerenciará mais o armazenamento
descrito pelo objeto pool, mas os dados brutos contidos no pool não são alterados,
e pode ser posteriormente recuperado com criação de pool.

exclusão de pool pool-ou-uuid
Destruir os recursos usados ​​por um determinado piscina objeto. Esta operação não é recuperável.
O piscina objeto ainda existirá após este comando, pronto para a criação de novos
volumes de armazenamento.

pool-dumpxml [--inativo] pool-ou-uuid
Retorna as informações XML sobre o piscina objeto. --inativo diz ao virsh para despejar
configuração do pool que será usada na próxima inicialização do pool, em oposição à
configuração atual do pool.

edição de pool pool-ou-uuid
Edite o arquivo de configuração XML para um conjunto de armazenamento.

Isso é equivalente a:

piscina virsh-dumpxml piscina > piscina.xml
vi pool.xml (ou faça alterações com seu outro editor de texto)
virsh pool-definir pool.xml

exceto que faz alguma verificação de erros.

O editor utilizado pode ser fornecido pelas variáveis ​​de ambiente $VISUAL ou $EDITOR, e
o padrão é "vi".

informações da piscina pool-ou-uuid
Retorna informações básicas sobre o piscina objeto.

lista de pool [--inativo] [--tudo] [--persistente] [--transitório] [--começo automático] [--no-autostart]
[[--detalhes] []
Listar objetos de pool conhecidos pela libvirt. Por padrão, apenas os pools ativos são listados;
--inativo lista apenas os pools inativos e --tudo lista todos os pools.

Além disso, existem vários conjuntos de sinalizadores de filtragem. --persistente é listar os
piscinas persistentes, --transitório é listar os pools transitórios. --começo automático lista os
piscinas de inicialização automática, --no-autostart lista os pools com inicialização automática desabilitada.

Você também pode listar pools com tipos especificados usando tipo, os tipos de pool devem
ser separados por vírgula, por ex. --type dir,disco. Os tipos de pool válidos incluem 'dir', 'fs',
'netfs', 'lógico', 'disco', 'iscsi', 'scsi', 'mpath', 'rbd', 'sheepdog' e 'gluster'.

O --detalhes opção instrui o virsh a exibir adicionalmente a persistência do pool e
informações relacionadas com a capacidade, quando disponíveis.

NOTA: Ao conversar com servidores mais antigos, este comando é forçado a usar uma série de API
chamadas com uma corrida inerente, onde um pool pode não estar listado ou pode aparecer mais
mais de uma vez se mudasse de estado entre as chamadas enquanto a lista estava sendo coletada. Mais recente
servidores não têm esse problema.

nome do pool uuid
converter o uuid para um nome de pool.

atualização de piscina pool-ou-uuid
Atualize a lista de volumes contidos em piscina.

início da piscina pool-ou-uuid [--construir] [[- sobrescrever] | [--não sobrescrever]]
Inicie o armazenamento piscina, que está definido anteriormente, mas inativo.

[--construir] [[- sobrescrever] | [--não sobrescrever]] realizar um construção de piscina antes de início da piscina
para garantir que o ambiente do pool esteja no estado esperado, em vez de precisar executar o
comando build antes da inicialização. O - sobrescrever e --não sobrescrever bandeiras seguem o
mesmas regras que construção de piscina. Se apenas --construir é fornecido, então construção de piscina é chamado com
sem bandeiras.

Observação: um pool de armazenamento que depende de recursos remotos, como um "iscsi" ou um (v)HBA
O pool "scsi" apoiado pode precisar ser atualizado várias vezes para ter todos os
volumes detectados (ver atualização de piscina). Isso ocorre porque os dispositivos de volume correspondentes
pode não estar presente no sistema de arquivos do host durante a inicialização inicial do pool ou o
tentativa de atualização atual. O número de novas tentativas de atualização depende da rede
conexão e o tempo que o host leva para exportar os dispositivos correspondentes.

piscina-indefinida pool-ou-uuid
Indefinir a configuração para um inativo piscina.

piscina-uuid piscina
Retorna o UUID do nomeado piscina.

VOLUME COMANDOS

vol-criar pool-ou-uuid ARQUIVO [--prealloc-metadados]
Crie um volume a partir de um XML. pool-ou-uuid é o nome ou UUID do armazenamento
pool para criar o volume. ARQUIVO é o XML com a definição do volume. Um
Uma maneira fácil de criar o XML é usar o vol-dumpxml comando para obter o
definição de um volume pré-existente. [--prealloc-metadados] pré-alocar metadados (para
imagens qcow2 que não suportam alocação completa). Esta opção cria uma imagem esparsa
arquivo com metadados, resultando em maior desempenho em comparação com imagens sem
pré-alocação e uso inicial de espaço em disco apenas um pouco maior.

Exemplo

virsh vol-dumpxml --pool storagepool1 appvolume1 > novovolume.xml
vi newvolume.xml (ou faça alterações com seu outro editor de texto)
virsh vol-criar pool de armazenamento diferente newvolume.xml

vol-criar-de pool-ou-uuid ARQUIVO [--inputpool pool-ou-uuid] vol-nome-ou-chave-ou-caminho
[--prealloc-metadados] [--reflink]
Crie um volume usando outro volume como entrada. pool-ou-uuid é o nome ou UUID de
o conjunto de armazenamento no qual criar o volume. ARQUIVO é o XML com o volume
definição. --inputpool pool-ou-uuid é o nome ou uuid do pool de armazenamento que
o volume de origem está dentro. vol-nome-ou-chave-ou-caminho é o nome ou chave ou caminho da fonte
volume. [--prealloc-metadados] pré-alocar metadados (para imagens qcow2 que não
apoiar a alocação total). Esta opção cria um arquivo de imagem esparso com metadados,
resultando em maior desempenho em comparação com imagens sem pré-alocação e apenas
uso inicial de espaço em disco um pouco maior. Quando --reflink é especificado, execute um COW
cópia leve, onde os blocos de dados são copiados apenas quando modificados. Se isso não for
possível, a cópia falha.

vol-criar-como pool-ou-uuid nome capacidade [--alocação tamanho] [--formato corda]
[--backing-vol vol-nome-ou-chave-ou-caminho] [--backing-vol-formato corda]
[--prealloc-metadados]
Crie um volume a partir de um conjunto de argumentos. pool-ou-uuid é o nome ou UUID do
pool de armazenamento para criar o volume. nome é o nome do novo volume. Para um disco
pool, isso deve corresponder ao nome da partição conforme determinado no dispositivo de origem do pool
caminho e a próxima partição disponível. Por exemplo, um caminho de dispositivo de origem de /dev/sdb
e não há partições no disco, então o nome deve ser sdb1 com o próximo nome
sendo sdb2 e assim por diante. capacidade é o tamanho do volume a ser criado, como uma escala
inteiro (veja NOTAS acima), padronizando bytes se não houver sufixo. --alocação
tamanho é o tamanho inicial a ser alocado no volume, também como um número inteiro escalonado
padrão para bytes. --formato corda é usado em pools de armazenamento baseados em arquivo para especificar
o formato de arquivo de volume a ser usado; cru, bochs, qcow, qcow2, vmdk, qed. Uso estendido para
conjuntos de armazenamento em disco para criar uma partição estendida (outros valores são válidos
verificado, mas não preservado quando o libvirtd é reiniciado ou o pool é atualizado).
--backing-vol vol-nome-ou-chave-ou-caminho é o volume de apoio de origem a ser usado se
tirar um instantâneo de um volume existente. --backing-vol-formato corda é o formato de
o volume de backup do instantâneo; bruto, bochs, qcow, qcow2, qed, vmdk, host_device. Esses
são, no entanto, destinados a pools de armazenamento baseados em arquivos. [--prealloc-metadados] pré-alocar
metadados (para imagens qcow2 que não suportam alocação completa). Esta opção cria um
arquivo de imagem esparso com metadados, resultando em maior desempenho em comparação com imagens
sem pré-alocação e com uso inicial de espaço em disco apenas um pouco maior.

vol-clone [--piscina pool-ou-uuid] vol-nome-ou-chave-ou-caminho nome [--prealloc-metadados]
[--reflink]
Clone um volume existente. Versão menos poderosa, mas mais fácil de digitar, do vol-criar-
da. --piscina pool-ou-uuid é o nome ou UUID do pool de armazenamento para criar o
volume em. vol-nome-ou-chave-ou-caminho é o nome, chave ou caminho do volume de origem.
nome é o nome do novo volume. [--prealloc-metadados] pré-alocar metadados (para
imagens qcow2 que não suportam alocação completa). Esta opção cria uma imagem esparsa
arquivo com metadados, resultando em maior desempenho em comparação com imagens sem
pré-alocação e uso inicial de espaço em disco apenas um pouco maior. Quando --reflink is
especificado, execute uma cópia leve COW, onde os blocos de dados são copiados somente quando
modificado. Se isso não for possível, a cópia falhará.

vol-excluir [--piscina pool-ou-uuid] vol-nome-ou-chave-ou-caminho [--delete-instantâneos]
Exclua um determinado volume. --piscina pool-ou-uuid é o nome ou UUID do pool de armazenamento
o volume está dentro. vol-nome-ou-chave-ou-caminho é o nome ou chave ou caminho do volume para
excluir.

O --delete-instantâneos sinalizador especifica que quaisquer instantâneos associados ao armazenamento
o volume também deve ser excluído. Nem todos os drivers de armazenamento suportam esta opção,
atualmente apenas rbd.

vol-upload [--piscina pool-ou-uuid] [--Deslocamento bytes] [--comprimento bytes] vol-nome-ou-chave-ou-caminho
arquivo local
Carregue o conteúdo de arquivo local para um volume de armazenamento. --piscina pool-ou-uuid é o
nome ou UUID do conjunto de armazenamento em que o volume está. vol-nome-ou-chave-ou-caminho é o
nome ou chave ou caminho do volume onde o arquivo será carregado. --Deslocamento é o
posição no volume de armazenamento na qual iniciar a gravação dos dados. O valor deve ser 0
ou maior. --comprimento é um limite superior da quantidade de dados a serem carregados. Um negativo
valor é interpretado como um valor longo e não assinado para incluir essencialmente tudo
do deslocamento até o final do volume. Ocorrerá um erro se o arquivo local is
maior que o comprimento especificado. Veja a descrição da libvirt
API virStorageVolUpload para obter detalhes sobre possíveis alterações no volume de destino e no pool
como resultado da atualização do pool quando o upload é tentado.

vol-download [--piscina pool-ou-uuid] [--Deslocamento bytes] [--comprimento bytes] vol-nome-ou-chave-ou-
caminho arquivo local
Baixe o conteúdo de um volume de armazenamento para arquivo local. --piscina pool-ou-uuid é o
nome ou UUID do conjunto de armazenamento em que o volume está. vol-nome-ou-chave-ou-caminho é o
nome ou chave ou caminho do volume para download. --Deslocamento é a posição no
volume de armazenamento no qual iniciar a leitura dos dados. O valor deve ser 0 ou maior.
--comprimento é um limite superior da quantidade de dados a serem baixados. Um valor negativo é
interpretado como um valor longo e não assinado para incluir essencialmente tudo, desde o
deslocado para o final do volume.

vol-wipe [--piscina pool-ou-uuid] [--algoritmo algoritmo] vol-nome-ou-chave-ou-caminho
Limpe um volume, certifique-se de que os dados anteriormente contidos no volume não estejam acessíveis para leituras futuras.
--piscina pool-ou-uuid é o nome ou UUID do conjunto de armazenamento no qual o volume está. Vol-
nome-ou-chave-ou-caminho é o nome, chave ou caminho do volume a ser apagado. É possível
para escolher diferentes algoritmos de limpeza em vez de reescrever o volume com zeros. Esse
pode ser feito via --algoritmo interruptor.

Suportado algoritmos
zero - 1 passagem em todos os zeros
nnsa - Carta de política NNSA de 4 passagens NAP-14.1-C (XVI-8) para
higienizando discos rígidos removíveis e não removíveis:
aleatório x2, 0x00, verifique.
dod - procedimento DoD 4-M seção 5220.22-8 de 306 passagens para
higienizante rígido removível e não removível
discos: aleatório, 0x00, 0xff, verifique.
bsi - método de 9 passagens recomendado pelo Centro Alemão de
Segurança em Tecnologias de Informação
(http://www.bsi.bund.de): 0xff, 0xfe, 0xfd, 0xfb,
0xf7, 0xef, 0xdf, 0xbf, 0x7f.
gutmann - A sequência canônica de 35 passagens descrita em
Artigo de Gutmann.
schneier - método de 7 passagens descrito por Bruce Schneier em
"Criptografia Aplicada" (1996): 0x00, 0xff,
aleatório x5.
pfitzner7 - Método de 7 passagens aleatórias de Roy Pfitzner: aleatório x7.
pfitzner33 - Método de 33 passagens aleatórias de Roy Pfitzner: aleatório x33.
aleatório - padrão de 1 passagem: aleatório.

Observação: A disponibilidade dos algoritmos pode ser limitada pela versão do "scrub"
binário instalado no host.

vol-dumpxml [--piscina pool-ou-uuid] vol-nome-ou-chave-ou-caminho
Produza as informações do volume como um dump XML para stdout. --piscina pool-ou-uuid é o
nome ou UUID do conjunto de armazenamento em que o volume está. vol-nome-ou-chave-ou-caminho É o nome
ou chave ou caminho do volume para gerar o XML.

vol-info [--piscina pool-ou-uuid] vol-nome-ou-chave-ou-caminho
Retorna informações básicas sobre o volume de armazenamento determinado. --piscina pool-ou-uuid é o
nome ou UUID do conjunto de armazenamento em que o volume está. vol-nome-ou-chave-ou-caminho É o nome
ou chave ou caminho do volume para o qual retornar informações.

lista vol [--piscina pool-ou-uuid] [--detalhes]
Retorne a lista de volumes no conjunto de armazenamento fornecido. --piscina pool-ou-uuid É o nome
ou UUID do pool de armazenamento. O --detalhes opção instrui virsh a adicionalmente
exibir informações relacionadas ao tipo de volume e capacidade, quando disponíveis.

piscina vol [--uuid] vol-key-ou-caminho
Retorne o nome do pool ou UUID de um determinado volume. Por padrão, o nome do pool é
devolvida. Se o --uuid for fornecida, o UUID do pool será retornado. vol-key-
ou-caminho é a chave ou o caminho do volume para o qual retornar as informações do pool.

vol-caminho [--piscina pool-ou-uuid] vol-nome-ou-chave
Retorne o caminho para um determinado volume. --piscina pool-ou-uuid é o nome ou UUID do
pool de armazenamento em que o volume está. vol-nome-ou-chave é o nome ou chave do volume a ser
retornar o caminho para.

vol-nome vol-key-ou-caminho
Retorne o nome de um determinado volume. vol-key-ou-caminho é a chave ou caminho do volume
para retornar o nome.

tecla vol [--piscina pool-ou-uuid] vol-nome-ou-caminho
Retorne a chave de volume para um determinado volume. --piscina pool-ou-uuid é o nome ou UUID de
o conjunto de armazenamento em que o volume está. vol-nome-ou-caminho é o nome ou caminho do volume
para retornar a tecla de volume.

vol-redimensionar [--piscina pool-ou-uuid] vol-nome-ou-caminho pool-ou-uuid capacidade [--distribuir]
[--delta] [--Psiquiatra]
Redimensione a capacidade do volume determinado, em bytes. --piscina pool-ou-uuid é o nome ou
UUID do conjunto de armazenamento em que o volume está. vol-nome-ou-chave-ou-caminho é o nome ou chave
ou caminho do volume a ser redimensionado. A nova capacidade poderá ser escassa, a menos que --distribuir
é especificado. Normalmente, capacidade é o novo tamanho, mas se --delta está presente, então
é adicionado ao tamanho existente. As tentativas de reduzir o volume falharão, a menos que
--Psiquiatra é presente; capacidade não pode ser negativo a menos que --Psiquiatra é fornecido, mas um
sinal negativo não é necessário. capacidade é um número inteiro escalonado (veja NOTAS acima), que
o padrão é bytes se não houver sufixo. Este comando só é seguro para armazenamento
volumes não utilizados por um convidado ativo; Veja também redimensionar bloco para redimensionamento ao vivo.

SECRET COMANDOS

Os comandos a seguir manipulam "segredos" (por exemplo, senhas, senhas e criptografia
chaves). Libvirt pode armazenar segredos independentemente do seu uso, e outros objetos (por exemplo,
volumes ou domínios) podem referir-se aos segredos para criptografia ou possivelmente outros usos.
Os segredos são identificados usando um UUID. Veja <http://libvirt.org/formatsecret.html> para
documentação do formato XML usado para representar propriedades de segredos.

definir segredo lima
Crie um segredo com as propriedades especificadas em lima, sem segredo associado
valor. Se lima não especifica um UUID, escolha um automaticamente. Se lima especifica
um UUID de um segredo existente, substitua suas propriedades pelas propriedades definidas em lima,
sem afetar o valor secreto.

dump-secretoxml segredo
Propriedades de saída de segredo (especificado por seu UUID) como um dump XML para stdout.

valor definido secreto segredo base64
Defina o valor associado a segredo (especificado por seu UUID) para o valor
Valor codificado em Base64 base64.

segredo-obter-valor segredo
Produza o valor associado a segredo (especificado por seu UUID) para stdout, codificado
usando Base64.

segredo-indefinido segredo
Excluir um segredo (especificado pelo seu UUID), incluindo o valor associado, se houver.

lista secreta [--efêmero] [--não-efêmero] [--privado] [--não-privado]
Retorna a lista de segredos. Você também pode filtrar os segredos retornados por
--efêmero para listar os efêmeros, --não-efêmero para listar os não efêmeros,
--privado para listar os privados, e --não-privado para listar os não privados.

INSTANTÂNEO COMANDOS

Os comandos a seguir manipulam instantâneos de domínio. Os instantâneos levam o disco, a memória e
estado do dispositivo de um domínio em um determinado momento e salvá-lo para uso futuro. Eles têm muitos
usa, desde salvar uma cópia "limpa" de uma imagem do sistema operacional até salvar o estado de um domínio antes de um
operação potencialmente destrutiva. Os instantâneos são identificados com um nome exclusivo. Ver
<http://libvirt.org/formatsnapshot.html> para documentação do formato XML usado para
representam propriedades de instantâneos.

criação de instantâneo domínio [arquivo xml] {[--redefinir [--atual]] | [--sem metadados] [--parar]
[--disk-somente] [--reuse-externo] [--quiescer] [--atômico] [--viver]}
Crie um instantâneo para o domínio domínio com as propriedades especificadas em arquivo xml.
Normalmente, as únicas propriedades configuráveis ​​para um instantâneo de domínio são e
Elementos , bem como se --disk-somente é dada; o resto do
os campos são ignorados e preenchidos automaticamente pela libvirt. Se arquivo xml é completamente
omitido, então libvirt escolherá um valor para todos os campos. O novo instantâneo será
tornar-se atual, conforme listado por instantâneo atual.

If --parar for especificado, o domínio será deixado em um estado inativo após o
instantâneo é criado.

If --disk-somente for especificado, o instantâneo incluirá apenas o estado do disco em vez do
ponto de verificação normal do sistema com estado vm. Os instantâneos de disco são mais rápidos que o sistema completo
pontos de verificação, mas a reversão para um instantâneo de disco pode exigir replays de fsck ou diário,
já que é como o estado do disco no momento em que o cabo de alimentação é puxado abruptamente;
e misturando --parar e --disk-somente perde todos os dados que não foram liberados para o disco no
tempo.

If --redefinir é especificado, então todos os elementos XML produzidos por snapshot-dumpxml e guarante que os mesmos estão
válido; isso pode ser usado para migrar a hierarquia de snapshots de uma máquina para outra, para
recriar hierarquia para o caso de um domínio transitório que desaparece e é posteriormente
recriado com o mesmo nome e UUID, ou para fazer pequenas alterações no instantâneo
metadados (como aspectos específicos do host do XML do domínio incorporado no instantâneo).
Quando este sinalizador é fornecido, o arquivo xml argumento é obrigatório e o domínio
o instantâneo atual não será alterado a menos que o --atual bandeira também é dada.

If --sem metadados for especificado, os dados do instantâneo serão criados, mas quaisquer metadados serão
descartado imediatamente (ou seja, libvirt não trata o instantâneo como atual e
não pode reverter para o instantâneo, a menos que --redefinir é mais tarde usado para ensinar libvirt sobre
os metadados novamente).

If --reuse-externo é especificado e o XML do instantâneo solicita um instantâneo externo
com um destino de um arquivo existente, então o destino deve existir e ser pré-
criado com formato e metadados corretos. O arquivo é então reutilizado; caso contrário, um
o snapshot é recusado para evitar a perda do conteúdo dos arquivos existentes.

If --quiescer for especificado, a libvirt tentará usar o agente convidado para congelar e descongelar
sistemas de arquivos montados do domínio. No entanto, se o domínio não tiver agente convidado, o snapshot
a criação falhará. Atualmente, isso exige --disk-somente para ser passado também.

If --atômico é especificado, libvirt garantirá que o instantâneo seja bem-sucedido ou
falha sem alterações; nem todos os hipervisores suportam isso. Se esta bandeira não for
especificado, então alguns hipervisores podem falhar após executar parcialmente a ação, e
dumpxml deve ser usado para ver se ocorreram alterações parciais.

If --viver é especificado, libvirt tira o instantâneo enquanto o convidado está em execução. Esse
aumenta o tamanho da imagem de memória do ponto de verificação externo. Isto é atualmente
suportado apenas para pontos de verificação externos.

A existência de metadados de instantâneo impedirá tentativas de indefinir um domínio persistente.
No entanto, para domínios transitórios, os metadados do instantâneo são perdidos silenciosamente quando o domínio
sai da execução (seja por comando como destruir ou por ação interna de convidados).

instantâneo-criar como domínio {[--print-xml] | [--sem metadados] [--parar] [--reuse-externo]}
[nome] [descrição] [--disk-somente [--quiescer]] [--atômico] [[--viver] [--memspec memspec]]
[--diskspec] especificação de disco] ...
Crie um instantâneo para o domínio domínio com o e fornecidos; se qualquer um
value for omitido, libvirt escolherá um valor. Se --print-xml é especificado, então XML
apropriado para criação de instantâneo é a saída, em vez de realmente criar um instantâneo.
Caso contrário, se --parar for especificado, o domínio será deixado em um estado inativo após
o instantâneo é criado e se --disk-somente for especificado, o instantâneo não será
inclua o estado da VM.

O --memspec opção pode ser usada para controlar se um ponto de verificação é interno ou
externo. O --memspec bandeira é obrigatória, seguida por um memspec do formulário
[arquivo=]nome[,instantâneo=tipo], onde o tipo pode ser não, interno, ou externo. Incluir
uma vírgula literal em arquivo=nome, escape com uma segunda vírgula. --memspec não pode ser usado
Juntamente com --disk-somente.

O --diskspec opção pode ser usada para controlar como --disk-somente e pontos de verificação externos
criar arquivos externos. Esta opção pode ocorrer diversas vezes, de acordo com o número
de elementos no xml do domínio. Cada está no formato
disco[,instantâneo=tipo][,driver=tipo][,arquivo=nome]. UMA especificação de disco deve ser fornecido para discos
apoiado por dispositivos de bloco, pois o libvirt não gera nomes de arquivos automaticamente para eles. Para
inclua uma vírgula literal em disco ou em arquivo=nome, escape com uma segunda vírgula. A
literal --diskspec deve preceder cada especificação de disco a menos que todos os três domínio, nome e
descrição também estão presentes. Por exemplo, um diskspec de
"vda,snapshot=external,file=/path/to,,new" resulta no seguinte XML:




If --reuse-externo é especificado e o domínio XML ou especificação de disco opção solicita um
instantâneo externo com o destino de um arquivo existente, o destino deverá
existir e ser pré-criado com formato e metadados corretos. O arquivo é então reutilizado;
caso contrário, um instantâneo será recusado para evitar a perda do conteúdo dos arquivos existentes.

If --quiescer for especificado, a libvirt tentará usar o agente convidado para congelar e descongelar
sistemas de arquivos montados do domínio. No entanto, se o domínio não tiver agente convidado, o snapshot
a criação falhará. Atualmente, isso exige --disk-somente para ser passado também.

If --sem metadados for especificado, os dados do instantâneo serão criados, mas quaisquer metadados serão
descartado imediatamente (ou seja, libvirt não trata o instantâneo como atual e
não pode reverter para o instantâneo, a menos que criação de instantâneo mais tarde é usado para ensinar libvirt
sobre os metadados novamente). Este sinalizador é incompatível com --print-xml.

If --atômico é especificado, libvirt garantirá que o instantâneo seja bem-sucedido ou
falha sem alterações; nem todos os hipervisores suportam isso. Se esta bandeira não for
especificado, então alguns hipervisores podem falhar após executar parcialmente a ação, e
dumpxml deve ser usado para ver se ocorreram alterações parciais.

If --viver é especificado, libvirt tira o instantâneo enquanto o convidado está em execução. Esse
aumenta o tamanho da imagem de memória do ponto de verificação externo. Isto é atualmente
suportado apenas para pontos de verificação externos.

instantâneo atual domínio {[--nome] | [--Informação de segurança] | [nome do instantâneo]}
Sem nome do instantâneo, isso gerará o XML do instantâneo para o domínio atual
instantâneo (se houver). Se --nome é especificado, apenas o nome do instantâneo atual em vez de
o xml completo. Caso contrário, usando --Informação de segurança também incluirá informações sensíveis à segurança
informações no XML.

Com nome do instantâneo, esta é uma solicitação para fazer com que o instantâneo nomeado existente se torne o
instantâneo atual, sem reverter o domínio.

edição de instantâneo domínio [nome do instantâneo] [--atual] {[--renomear] | [--clone]}
Edite o arquivo de configuração XML para nome do instantâneo de um domínio. Se ambos nome do instantâneo
e --atual são especificados, também força o instantâneo editado a se tornar o atual
instantâneo. Se nome do instantâneo é omitido, então --atual deve ser fornecido, para editar o
instantâneo atual.

Isso é equivalente a:

virsh snapshot-dumpxml nome dom > snapshot.xml
vi snapshot.xml (ou faça alterações com seu outro editor de texto)
virsh snapshot-create dom snapshot.xml --redefine [--current]

exceto que faz alguma verificação de erros.

O editor utilizado pode ser fornecido pelas variáveis ​​de ambiente $VISUAL ou $EDITOR, e
o padrão é "vi".

If --renomear for especificado, as edições poderão alterar o nome do instantâneo. Se --clone is
especificado, alterar o nome do instantâneo criará um clone do instantâneo
metadados. Se nenhum deles for especificado, as edições não deverão alterar o nome do instantâneo.
Observe que a alteração do nome de um snapshot deve ser feita com cuidado, pois o conteúdo de alguns
instantâneos, como instantâneos internos dentro de um único arquivo qcow2, são acessíveis apenas
do nome original.

informações do instantâneo domínio {instantâneo | --atual}
Produza informações básicas sobre um nomeado ou o instantâneo atual com
--atual.

lista de instantâneos domínio [--metadados] [--sem metadados] [{--pai | --raízes | [{--árvore |
--nome}]}] [{[--a partir de] instantâneo | --atual} [--descendentes]] [--folhas] [--sem folhas]
[--inativo] [--ativo] [--disk-somente] [--interno] [--externo]
Liste todos os instantâneos disponíveis para um determinado domínio, com o padrão de mostrar colunas
para o nome do instantâneo, hora de criação e estado do domínio.

If --pai é especificado, adicione uma coluna à tabela de saída fornecendo o nome do
pai de cada instantâneo. Se --raízes for especificado, a lista será filtrada apenas
instantâneos que não têm pais. Se --árvore é especificado, a saída estará em uma árvore
formato, listando apenas nomes de instantâneos. Estas três opções são mutuamente exclusivas. Se
--nome é especificado, apenas o nome do instantâneo é impresso. Esta opção é mutuamente
exclusivo com --árvore.

If --a partir de é fornecido, filtre a lista para instantâneos que são filhos do determinado
instantâneo; ou se --atual é fornecido, comece no instantâneo atual. Quando usado em
isolamento ou com --pai, a lista é limitada a filhos diretos, a menos que
--descendentes também está presente. Quando usado com --árvore, o uso de --descendentes is
implícita. Esta opção não é compatível com --raízes. Observe que o ponto de partida
--a partir de or --atual não está incluído na lista, a menos que o --árvore opção também é
presente.

If --folhas for especificado, a lista será filtrada apenas para instantâneos que não possuem
crianças. Da mesma forma, se --sem folhas for especificado, a lista será filtrada apenas
instantâneos com crianças. (Observe que omitir ambas as opções não faz filtragem, enquanto
fornecer ambas as opções produzirá a mesma lista ou ocorrerá um erro, dependendo de
se o servidor reconhece os sinalizadores). As opções de filtragem não são compatíveis com
--árvore.

If --metadados for especificado, a lista será filtrada apenas para instantâneos que envolvem
metadados da libvirt e, portanto, impediria indefinir de um domínio persistente ou será perdido
on destruir de um domínio transitório. Da mesma forma, se --sem metadados é especificado, a lista
será filtrado apenas para instantâneos que existem sem a necessidade de metadados libvirt.

If --inativo for especificado, a lista será filtrada para instantâneos que foram tirados
quando o domínio foi desligado. Se --ativo for especificado, a lista será filtrada para
instantâneos que foram tirados quando o domínio estava em execução e onde o instantâneo inclui
o estado da memória para reverter para esse estado de execução. Se --disk-somente é especificado, o
lista será filtrada para instantâneos que foram tirados quando o domínio estava em execução, mas
onde o instantâneo inclui apenas o estado do disco.

If --interno for especificado, a lista será filtrada para instantâneos que usam
armazenamento de imagens de disco existentes. Se --externo for especificado, a lista será
filtrado para instantâneos que usam arquivos externos para imagens de disco ou estado de memória.

snapshot-dumpxml domínio instantâneo [--Informação de segurança]
Produza o XML do instantâneo para o instantâneo do domínio chamado instantâneo. Usando
--Informação de segurança também incluirá informações confidenciais de segurança. Usar snapshot-
atual para acessar facilmente o XML do instantâneo atual.

instantâneo-pai domínio {instantâneo | --atual}
Produza o nome do instantâneo pai, se houver, para o determinado instantâneoou para o
instantâneo atual com --atual.

reversão de instantâneo domínio {instantâneo | --atual} [{--correndo | --pausado}] [--força]
Reverter o domínio fornecido para o instantâneo especificado por instantâneo, ou para o atual
instantâneo com --atual. Esteja ciente de que esta é uma ação destrutiva; quaisquer alterações em
o domínio desde a última captura instantânea será perdido. Observe também que o estado
do domínio após a conclusão da reversão do instantâneo será o estado do domínio no
hora em que o instantâneo original foi tirado.

Normalmente, reverter para um instantâneo deixa o domínio no estado em que estava no momento
o instantâneo foi criado, exceto que um instantâneo de disco sem estado de VM deixa o
domínio em estado inativo. Passando ou o --correndo or --pausado bandeira vai
realizar alterações de estado adicionais (como inicializar um domínio inativo ou pausar um
domínio em execução). Como os domínios transitórios não podem ficar inativos, é necessário usar
um desses sinalizadores ao reverter para um instantâneo de disco de um domínio transitório.

Existem dois casos em que a reversão de um snapshot envolve risco extra, o que requer a
uso de --força para prosseguir. Um é o caso de um snapshot que não possui domínio completo
informações para reverter a configuração (como instantâneos criados antes da libvirt
0.9.5); já que a libvirt não pode provar que a configuração atual corresponde ao que estava em
usar no momento do snapshot, fornecendo --força garante à libvirt que o instantâneo
é compatível com a configuração atual (e se não for, o domínio provavelmente será
não conseguir executar). O outro é o caso de reverter de um domínio em execução para um domínio ativo
indicar onde um novo hipervisor deve ser criado em vez de reutilizar o existente
hipervisor, porque implica desvantagens como quebrar qualquer VNC ou Spice existente
conexões; esta condição acontece com um instantâneo ativo que usa um comprovadamente
configuração incompatível, bem como com um instantâneo inativo que é combinado com
da --começar or --pausa bandeira.

exclusão de instantâneo domínio {instantâneo | --atual} [--metadados] [{--crianças |
--somente crianças}]
Exclua o instantâneo do domínio nomeado instantâneoou o instantâneo atual com
--atual. Se este instantâneo tiver instantâneos filhos, as alterações deste instantâneo serão
fundidos nos filhos. Se --crianças for passado, exclua este instantâneo e qualquer
filhos deste instantâneo. Se --somente crianças for passado, exclua todos os filhos de
este instantâneo, mas deixe-o intacto. Estas duas bandeiras são mutuamente
exclusivo.

If --metadados for especificado, exclua apenas os metadados do snapshot mantidos por
libvirt, deixando intacto o conteúdo do snapshot para acesso por ferramentas externas;
caso contrário, a exclusão de um instantâneo também removerá o conteúdo dos dados daquele momento.

NWFILTRO COMANDOS

Os comandos a seguir manipulam filtros de rede. Os filtros de rede permitem a filtragem do
tráfego de rede vindo e indo para máquinas virtuais. Tráfego de rede individual
filtros são escritos em XML e podem conter referências a outros filtros de rede, descreva
regras de filtragem de tráfego ou conter ambas. Os filtros de rede são referenciados por virtuais
máquinas a partir de sua descrição de interface. Um filtro de rede pode ser referenciado por
interfaces de múltiplas máquinas virtuais.

nwfilter-definir arquivo xml
Torne um novo filtro de rede conhecido pela libvirt. Se um filtro de rede com o mesmo nome
já existe, ele será substituído pelo novo XML. Qualquer máquina virtual em execução
referenciar este filtro de rede terá suas regras de tráfego de rede adaptadas. Se por
por qualquer motivo, as regras de filtragem de tráfego de rede não podem ser instanciadas por qualquer um dos
executando máquinas virtuais, o novo XML será rejeitado.

nwfilter-undefine nome do nwfilter
Exclua um filtro de rede. A exclusão falhará se alguma máquina virtual em execução for
atualmente usando este filtro de rede.

lista nwfilter
Liste todos os filtros de rede disponíveis.

nwfilter-dumpxml nome do nwfilter
Produza o XML do filtro de rede.

edição nwfilter nome do nwfilter
Edite o XML de um filtro de rede.

Isso é equivalente a:

virsh nwfilter-dumpxml meufiltro > meufilter.xml
vi myfilter.xml (ou faça alterações com seu outro editor de texto)
virsh nwfilter-define meufilter.xml

exceto que faz alguma verificação de erros. O novo filtro de rede pode ser rejeitado devido
pelo mesmo motivo mencionado em nwfilter-definir.

O editor utilizado pode ser fornecido pelas variáveis ​​de ambiente $VISUAL ou $EDITOR, e
o padrão é "vi".

ESPECÍFICO DO HIPERVISOR COMANDOS

NOTA: O uso dos seguintes comandos é discordaram desanimado. Eles podem fazer com que o libvirt
ficar confuso e fazer a coisa errada nas operações subsequentes. Depois de usar estes
comandos, por favor não relate problemas aos desenvolvedores da libvirt; os relatórios serão
ignorado. Se você achar que esses comandos são a única maneira de realizar algo, então
é melhor solicitar que o recurso seja adicionado como cidadão de primeira classe no regular
biblioteca libvirt.

qemu-anexar pid
Anexe um processo QEMU iniciado externamente ao driver libvirt QEMU. O QEMU
o processo deve ter sido criado com uma conexão de monitor usando o driver UNIX.
Idealmente, o processo também terá o argumento '-name' especificado.

$ qemu-kvm -cdrom ~/demo.iso \
-monitor unix:/tmp/demo,servidor,nowait \
-nome foo\
-uuid cece4f9f-dff0-575d-0e8e-01fe380f12ea &
$QEMUPID=$!
$ virsh qemu-attach $QEMUPID

Não se espera que todas as funções do libvirt funcionem de forma confiável após serem anexadas a um
processo QEMU lançado externamente. Pode haver problemas com a alteração da ABI convidada
migração e hotplug ou hotunplug do dispositivo podem não funcionar. O ambiente anexado
deve ser considerado principalmente somente leitura.

comando qemu-monitor domínio {[--hmp] | [--bonito]} comando...
Envie um comando de monitor arbitrário comando para domínio domínio através do monitor qemu.
Os resultados do comando serão impressos em stdout. Se --hmp é passado, o comando
é considerado um comando de monitor humano e a libvirt irá convertê-lo automaticamente
no QMP, se necessário. Nesse caso, o resultado também será convertido de volta do QMP. Se
--bonito for fornecido e o monitor usar QMP, a saída será bem impressa.
Se mais de um argumento for fornecido para comando, eles são concatenados com um espaço
antes de passar o comando único para o monitor.

comando do agente qemu domínio [--tempo esgotado segundo | --assíncrono | --bloquear] comando...
Envie um comando arbitrário de agente convidado comando para domínio domínio através do agente qemu.
--tempo esgotado, --assíncrono e --bloquear as opções são exclusivas. --tempo esgotado requer tempo limite
segundo segundo e deve ser positivo. Quando --aysnc é dado, o comando espera por
tempo limite, seja sucesso ou falha. E quando --bloquear é dado, o comando espera
para sempre com tempo limite de bloqueio.

evento qemu-monitor [domínio] [--evento nome do evento] [--ciclo] [--tempo esgotado segundo] [--bonito]
[--regex] [--nenhum caso] [--timestamp]
Aguarde a ocorrência de eventos arbitrários do monitor QEMU e imprima os detalhes dos eventos
à medida que acontecem. Os eventos podem opcionalmente ser filtrados por domínio or nome do evento. O
O comando QMP 'query-events' pode ser usado via comando qemu-monitor para saber quais eventos
são suportados. Se --regex é usado, nome do evento é uma expressão regular básica em vez disso
de uma string literal. Se --nenhum caso é usado, nome do evento corresponderá sem distinção entre maiúsculas e minúsculas.

Por padrão, esse comando é único e retorna sucesso quando um evento ocorre; você
pode enviar SIGINT (geralmente via "Ctrl-C") para sair imediatamente. Se --tempo esgotado is
especificado, o comando desiste de esperar por eventos após segundo já decorreram. Com
--ciclo, o comando imprime todos os eventos até um tempo limite ou tecla de interrupção. Se --bonito
for especificado, todos os detalhes do evento JSON serão impressos para melhor legibilidade.

Quando --timestamp for usado, um carimbo de data e hora legível será impresso antes do evento,
e as informações de tempo fornecidas pelo QEMU serão omitidas.

lxc-enter-namespace domínio -- /caminho/para/binário [arg1, [arg2, ...]]
Insira o namespace de domínio e execute o comando "/path/to/binary" passando o
argumentos solicitados. O caminho binário é relativo ao sistema de arquivos raiz do contêiner, não ao
sistema de arquivos raiz host. O binário herdará as variáveis ​​de ambiente/console
visível para virsh. Este comando só funciona quando conectado ao driver do hipervisor LXC.
Este comando será bem-sucedido somente se "/caminho/para/binário" tiver status de saída 0.

MEIO AMBIENTE

As seguintes variáveis ​​de ambiente podem ser definidas para alterar o comportamento de "virsh"

VIRSH_DEBUG=
Ative a depuração detalhada dos comandos virsh. Os níveis válidos são

· VIRSH_DEBUG=0

DEBUG - Mensagens em TODOS os níveis são registradas

· VIRSH_DEBUG=1

INFO - Registra mensagens nos níveis INFO, NOTICE, WARNING e ERROR

· VIRSH_DEBUG=2

AVISO - Registra mensagens nos níveis AVISO, AVISO e ERRO

· VIRSH_DEBUG=3

AVISO - Registra mensagens nos níveis AVISO e ERRO

· VIRSH_DEBUG=4

ERROR - As mensagens apenas no nível ERROR são registradas.

VIRSH_LOG_FILE="LOGFILE"
O arquivo para registrar mensagens de depuração virsh.

VIRSH_DEFAULT_CONNECT_URI
O hipervisor ao qual se conectar por padrão. Defina isso como um URI, no mesmo formato que
aceito pelo connect opção. Esta variável de ambiente está obsoleta em favor de
global LIBVIRT_DEFAULT_URI variável que serve ao mesmo propósito.

LIBVIRT_DEFAULT_URI
O hipervisor ao qual se conectar por padrão. Defina isso como um URI, no mesmo formato que
aceito pelo connect opção. Isso substitui o URI padrão definido em qualquer cliente
config e evita que a libvirt procure drivers.

VISUAL
O editor a ser usado pelo editar e opções relacionadas.

EDITOR
O editor a ser usado pelo editar e opções relacionadas, se "VISUAL" não estiver definido.

VIRSH_HISTSIZE
O número de comandos a serem lembrados no histórico de comandos. O valor padrão é 500.

LIBVIRT_DEBUG = LEVEL
Ative a depuração detalhada de todas as chamadas de API libvirt. Os níveis válidos são

· LIBVIRT_DEBUG = 1

Mensagens no nível DEBUG ou acima

· LIBVIRT_DEBUG = 2

Mensagens no nível INFO ou acima

· LIBVIRT_DEBUG = 3

Mensagens no nível WARNING ou acima

· LIBVIRT_DEBUG = 4

Mensagens no nível ERROR ou acima

Para obter mais informações sobre as opções de depuração, consulte
"http://libvirt.org/logging.html"

Use virsh online usando serviços onworks.net