virsh - Online en la nube

PROGRAMA:

NOMBRE

virsh - interfaz de usuario de gestión

SINOPSIS

Virsh [OPCIÓN] ... [COMMAND_STRING]

Virsh [OPCIÓN] ... COMANDO [ARG] ...

DESCRIPCIÓN

La sección Virsh El programa es la interfaz principal para administrar los dominios invitados de virsh. El programa puede
utilizarse para crear, pausar y cerrar dominios. También se puede utilizar para enumerar
dominios. Libvirt es un conjunto de herramientas de C para interactuar con las capacidades de virtualización de los últimos
versiones de Linux (y otros sistemas operativos). Es un software gratuito disponible bajo GNU Lesser
Licencia publica general. La virtualización del sistema operativo Linux significa la capacidad de
ejecutar varias instancias de sistemas operativos al mismo tiempo en un solo sistema de hardware donde
los recursos básicos están controlados por una instancia de Linux. La biblioteca tiene como objetivo proporcionar una larga
término API C estable. Actualmente es compatible con Xen, QEMU, KVM, LXC, OpenVZ, VirtualBox y
VMWare ESX.

La estructura básica de la mayoría de los usos virsh es:

virsh [OPCIÓN] ... [ARG] ...

¿Dónde? comando es uno de los comandos que se enumeran a continuación; dominio es el ID de dominio numérico, o el
nombre de dominio o UUID de dominio; y ARGS son opciones específicas del comando. Hay algunos
excepciones a esta regla en los casos en que el comando en cuestión actúe en todos los dominios,
toda la máquina, o directamente en el hipervisor xen. Esas excepciones quedarán claras para
cada uno de esos comandos. Nota: está permitido dar nombres numéricos a los dominios,
sin embargo, al hacerlo, se obtendrá un dominio que solo se puede identificar mediante el ID de dominio. En
En otras palabras, si se proporciona un valor numérico, se interpretará como una identificación de dominio, no como
un nombre.

La sección Virsh El programa se puede utilizar para ejecutar uno COMANDO dando la orden y su
argumentos en la línea de comandos del shell, o un COMMAND_STRING que es un argumento de shell único
que consta de múltiples COMANDO acciones y sus argumentos unidos con espacios en blanco, y
separados por punto y coma entre los comandos. Dentro de COMMAND_STRING, virsh entiende el
los mismos escapes simple, doble y de barra invertida que el shell, aunque debe agregar otro
capa de shell que se escapa al crear el argumento de shell único. Si no se da ninguna orden en
la línea de comando, Virsh luego iniciará un intérprete mínimo esperando sus comandos,
y renuncia El comando saldrá del programa.

La sección Virsh El programa comprende lo siguiente OPCIONES.

-c, --conectar URI
Conéctese al especificado URI, como por el se unen comando, en lugar del predeterminado
conexión.

-d, --depurar NIVEL
Habilitar mensajes de depuración en números enteros NIVEL y por encima. NIVEL puede variar de 0 a 4
(defecto). Ver la documentación de VIRSH_DEBUG variable de entorno a continuación para el
descripción de cada NIVEL.

-e, --escapar cadena
Establecer secuencia de escape alternativa para un mueble consola mando. Por defecto, telnet ^] se utiliza.
Los caracteres permitidos cuando se usa la notación de sombrero son: carácter alfabético, @, [,], \, ^,
_.

-h, --ayuda
Ignore todos los demás argumentos y compórtese como si el ayuda en su lugar se dieron órdenes.

-k, --keepalive-intervalo INTERVALO
Establecer un INTERVALO (en segundos) para enviar mensajes keepalive para comprobar si
la conexión con el servidor sigue viva. Establecer el intervalo en 0 inhabilita al cliente
mecanismo keepalive.

-K, --keepalive-cuenta COUNT
Establezca el número de veces que se puede enviar el mensaje keepalive sin obtener una respuesta del
servidor sin marcar la conexión muerta. Este ajuste no tiene ningún efecto en
caso el INTERVALO se establece en 0.

-l, --Iniciar sesión ARCHIVO
Detalles de registro de salida a ARCHIVO.

-q, --tranquilo
Evite los mensajes informativos adicionales.

-r, --solo lectura
Haga que la conexión inicial sea de solo lectura, como si --solo lectura opción del se unen
mando.

-t, --momento
Salida de información de tiempo transcurrido para cada comando.

-v, --versión [= corta]
Ignora todos los demás argumentos e imprime la versión de la biblioteca libvirt virsh es
procedente de

-V, --version = largo
Ignora todos los demás argumentos e imprime la versión de la biblioteca libvirt virsh es
procedente y en qué opciones y controlador se compilan.

NOTAS

La mayoría de las Virsh Las operaciones dependen de que la biblioteca libvirt pueda conectarse a un
ejecutando el servicio libvirtd. Esto generalmente se puede hacer usando el comando invocar-rc.d biblioteca
comienzo.

La mayoría de las Virsh Los comandos requieren privilegios de root para ejecutarse debido a los canales de comunicación utilizados.
para hablar con el hipervisor. Ejecutar como no root devolverá un error.

La mayoría de las Virsh Los comandos actúan sincrónicamente, excepto quizás shutdown, setvcpus y setmem. En
esos casos el hecho de que el Virsh programa devuelto, puede no significar que la acción está completa
y debes sondear periódicamente para detectar que el huésped completó la operación.

Virsh se esfuerza por lograr la compatibilidad con versiones anteriores. Aunque el ayuda comando solo enumera el
uso preferido de un comando, si una versión anterior de Virsh apoyó una ortografía alternativa
de un comando u opción (como - tunelizado en lugar de - tunelizado), luego scripts usando
esa ortografía más antigua seguirá funcionando.

Varias Virsh los comandos toman un entero opcionalmente escalado; si no se proporciona una escala, entonces
el valor predeterminado se enumera en el comando (por razones históricas, algunos comandos predeterminados
bytes, mientras que otros comandos están predeterminados en kibibytes). Lo siguiente no distingue entre mayúsculas y minúsculas
Los sufijos se pueden utilizar para seleccionar una escala específica:
b, byte byte 1
KB kilobyte 1,000
k, KiB kibibyte 1,024
MB megabyte 1,000,000
M, MiB mebibyte 1,048,576
GB gigabytes 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 petabytes 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

Los siguientes comandos son genéricos, es decir, no específicos de un dominio.

ayuda [comando-o-grupo]
Esto enumera cada uno de los comandos virsh. Cuando se usa sin opciones, todos los comandos son
enumerados, uno por línea, agrupados en categorías relacionadas, mostrando la palabra clave para cada
grupo.

Para mostrar solo comandos para un grupo específico, ingrese la palabra clave para ese grupo como un
opción. Por ejemplo:

virsh # ayuda al anfitrión

Host e hipervisor (palabra clave de ayuda 'host'):
capacidades capacidades
cpu-models muestran los modelos de CPU para una arquitectura
conectarse (re) conectarse al hipervisor
memoria libre NUMA freecell
nombre de host imprime el nombre de host del hipervisor
qemu-attach Adjuntar al proceso QEMU existente
qemu-monitor-command Comando de monitorización QEMU
qemu-agent-command Comando de agente invitado de QEMU
sysinfo imprime el hipervisor sysinfo
uri imprime el URI canónico del hipervisor

Para mostrar información detallada para un comando específico, dé su nombre como opción
en lugar de. Por ejemplo:

virsh # lista de ayuda
NOMBRE
lista - lista de dominios

SINOPSIS
lista [- inactivo] [--todos]

DESCRIPCIÓN
Devuelve la lista de dominios.

OPCIONES
- lista inactiva dominios inactivos
--todos los dominios inactivos y activos de la lista

renuncia, salida
salir de esta terminal interactiva

versión [--demonio]
Imprimirá la información de la versión principal sobre lo que se construyó. Si --demonio is
especificado, la versión del demonio libvirt se incluye en la salida.

Ejemplo

$ virsh versión
Compilado contra la biblioteca: libvirt 1.2.3
Usando la biblioteca: libvirt 1.2.3
Usando API: QEMU 1.2.3
Ejecución de hipervisor: QEMU 2.0.50

$ virsh versión --daemon
Compilado contra la biblioteca: libvirt 1.2.3
Usando la biblioteca: libvirt 1.2.3
Usando API: QEMU 1.2.3
Ejecución de hipervisor: QEMU 2.0.50
Ejecutando contra demonio: 1.2.6

cd [directorio]
Cambiará el directorio actual a directorio. El directorio predeterminado para el cd comando
es el directorio de inicio o, si no hay INICIO variable en el medio ambiente, la raíz
directorio.

Este comando solo está disponible en modo interactivo.

pwd Imprimirá el directorio actual.

se unen [URI] [--solo lectura]
(Re) -Conéctese al hipervisor. Cuando se inicia el shell por primera vez, esto se
corre con el URI parámetro solicitado por la opción "-c" en la línea de comando. los URI
El parámetro especifica cómo conectarse al hipervisor. La página de documentación en
<http://libvirt.org/uri.html> enumere los valores admitidos, pero los más comunes son:

xen: ///
esto se usa para conectarse al hipervisor Xen local

qemu: /// sistema
conectarse localmente como root al demonio que supervisa los dominios QEMU y KVM

qemu: /// sesión
conectarse localmente como un usuario normal a su propio conjunto de dominios QEMU y KVM

lxc: ///
conectarse a un contenedor linux local

Para encontrar el URI utilizado actualmente, marque el uri comando documentado a continuación.

Para acceso remoto, consulte la página de documentación enhttp://libvirt.org/uri.html> sobre como
para hacer URI. los --solo lectura La opción permite una conexión de solo lectura

uri Imprime el URI canónico del hipervisor, puede ser útil en modo shell.

hostname
Imprima el nombre de host del hipervisor.

Sysinfo
Imprima la representación XML del hipervisor sysinfo, si está disponible.

información de nodo
Devuelve información básica sobre el nodo, como el número y tipo de CPU y el tamaño del
memoria física. La salida corresponde a la estructura virNodeInfo. Específicamente, el
El campo "CPU socket (s)" significa el número de CPU sockets por celda NUMA. La información
Las pantallas de libvirt dependen de lo que pueda proporcionar cada arquitectura.

mapa de nodecpuma [--lindo]
Muestra el número total de CPU del nodo, el número de CPU en línea y la lista de
CPU en línea.

Con --lindo las CPU en línea se imprimen como un rango en lugar de una lista.

nodecpustats [cpu] [--por ciento]
Devuelve las estadísticas de la CPU del nodo. Si cpu se especifica, esto imprimirá la CPU especificada
solo estadísticas. Si --por ciento se especifica, esto imprimirá el porcentaje de cada tipo
de estadísticas de la CPU durante 1 segundo.

estadísticas de nodeme [(SCD por sus siglas en inglés),]
Devuelve las estadísticas de memoria del nodo. Si (SCD por sus siglas en inglés), se especifica, esto imprimirá especificado
solo estadísticas de celda.

nodos suspender [dirigidos] [duración]
Pone el nodo (máquina host) en un estado de suspensión de todo el sistema y programa la
Interrupción del reloj de tiempo real para reanudar el nodo después del tiempo especificado por
duración Está fuera. dirigidos especifica el estado al que se suspenderá el host,
puede ser "mem" (suspender a RAM), "disco" (suspender a disco) o "híbrido" (suspender a
tanto RAM como disco). duración especifica el tiempo de duración en segundos durante el cual el
El host debe suspenderse, debe durar al menos 60 segundos.

nodo-memoria-sintonizar [shm-páginas-para-escanear] [shm-sleep-milisecs] [shm-fusionar-entre-nodos]
Le permite mostrar o configurar los parámetros de la memoria del nodo. shm-páginas-para-escanear puede ser
se utiliza para establecer el número de páginas que se escanearán antes de que el servicio de memoria compartida
dormir shm-sleep-milisecs se puede utilizar para establecer el número de milisegundos que se comparten
el servicio de memoria debe dormir antes del siguiente escaneo; shm-fusionar-entre-nodos especifica si
se pueden fusionar páginas de diferentes nodos numa. Cuando se establece en 0, solo las páginas que
residir físicamente en el área de memoria del mismo nodo NUMA se puede fusionar. Cuando se establece en 1,
las páginas de todos los nodos se pueden fusionar. Predeterminado a 1.

Nota: : Actualmente, el "servicio de memoria compartida" solo significa KSM (Kernel Samepage Merging).

capacidades
Imprima un documento XML que describa las capacidades del hipervisor que estamos actualmente.
conectado a. Esto incluye una sección sobre las capacidades del host en términos de CPU y
características y un conjunto de descripciones para cada tipo de huésped que se puede virtualizar.
Para obtener una descripción más completa, consulte:
<http://libvirt.org/formatcaps.html> El XML también muestra la información de topología NUMA
si está disponible.

domcapacidades [tipo de virtud] [emulador] [arco] [máquina]
Imprima un documento XML que describa las capacidades de dominio para el hipervisor que somos
conectado al uso de información procedente de un dominio existente o extraída de
el Virsh capacidades producción. Esto puede ser útil si tiene la intención de crear un nuevo dominio.
y tienen curiosidad si, por ejemplo, podría hacer uso de VFIO creando un dominio para el
hipervisor con un emulador y una arquitectura específicos.

Cada hipervisor tendrá diferentes requisitos con respecto a qué opciones se requieren
y que son opcionales. Un hipervisor puede admitir el suministro de un valor predeterminado para cualquiera de
las opciones.

La sección tipo de virtud La opción especifica el tipo de virtualización utilizado. El valor a utilizar es
ya sea desde el atributo 'tipo' del elemento de nivel superior del dominio
XML o el atributo 'tipo' que se encuentra dentro de cada elemento del Virsh
capacidades producción. los emulador La opción especifica la ruta al emulador. los
El valor que se utilizará es el elemento en el dominio XML o el Virsh
capacidades producción. los arco La opción especifica la arquitectura que se utilizará para la
dominio. El valor que se utilizará es el atributo "arch" del XML del dominio.
elemento y subelemento o el atributo "nombre" de un elemento
desde la Virsh capacidades producción. los máquina especifica el tipo de máquina para el
emulador. El valor que se utilizará es el atributo "máquina" del XML del dominio.
elemento y subelemento o uno de una lista de máquinas del Virsh
capacidades salida para una arquitectura y un tipo de dominio específicos.

Para el hipervisor qemu, un tipo de virtud de 'qemu' o 'kvm' deben suministrarse junto
con el emulador or arco para generar salida para el valor predeterminado
máquina. Suministrar un máquina El valor generará una salida para la máquina específica.

inyectar-nmi dominio
Inyecte NMI al invitado.

lista [--inactivo | --todas] [--administrado-guardar] [--título] {[--mesa] | --nombre | --uuido }
[--persistente] [--transitorio] [--con guardado gestionado] [--sin-administrado-guardar] [--autoencendido]
[--sin inicio automático] [--con-instantánea] [--sin instantánea] [- estado de funcionamiento] [--estado-pausado]
[- cierre del estado] [--estado-otro]
Imprime información sobre dominios existentes. Si no se especifican opciones, se imprime
información sobre la ejecución de dominios.

Un formato de ejemplo para la lista es el siguiente:

Virsh lista
Id Nombre Estado
-------------------------------------------------- -
0 dominio-0 en ejecución
2 fedora en pausa

Nombre es el nombre del dominio. Identifique la identificación numérica del dominio. El estado es el estado de ejecución
(vea abajo).

ESTADOS

El campo Estado enumera 8 estados para un dominio y en cuáles se encuentra el dominio actual.

correr
El dominio se está ejecutando actualmente en una CPU

ocioso
El dominio está inactivo y no se está ejecutando ni se puede ejecutar. Esto puede deberse a que
El dominio está esperando IO (un estado de espera tradicional) o se ha dormido porque
no había nada más que hacer.

pausa
El dominio se ha detenido, por lo general, cuando el administrador ejecuta
Virsh suspender. Cuando esté en un estado de pausa, el dominio seguirá consumiendo asignado
recursos como la memoria, pero no podrán ser programados por el hipervisor.

cierre
El dominio está en proceso de cerrarse, es decir, el sistema operativo invitado ha
ha sido notificado y debería estar en proceso de detener sus operaciones correctamente.

shut off
El dominio no se está ejecutando. Por lo general, esto indica que el dominio se ha cerrado
por completo o no se ha iniciado.

estrellado
El dominio se ha bloqueado, lo que siempre es un final violento. Por lo general, este estado puede
solo ocurre si el dominio se ha configurado para que no se reinicie en caso de bloqueo.

moribundo
El dominio está en proceso de extinción, pero no se ha cerrado por completo ni se ha bloqueado.

pmsuspendido
El dominio ha sido suspendido por la administración de energía del invitado, por ejemplo, ingresado en s3
estado.

Normalmente, solo se enumeran los dominios activos. Para enumerar los dominios inactivos, especifique --inactivo
or --todas para enumerar los dominios activos e inactivos.

Para filtrar aún más la lista de dominios, puede especificar una o más banderas de filtrado
apoyada por la lista mando. Estas banderas están agrupadas por función. Especificando uno o
más banderas de un grupo habilita el grupo de filtro. Tenga en cuenta que algunas combinaciones de banderas
puede no producir ningún resultado. Banderas y grupos de filtrado admitidos:

Persistencia
Destacar --persistente se utiliza para incluir dominios persistentes en la lista devuelta. Para
incluir dominios transitorios especificar --transitorio.

vida of gestionado guarde imagen
Para enumerar los dominios que tienen una imagen guardada administrada, especifique la marca --con guardado gestionado. For
dominios que no tienen una imagen guardada administrada especificar --sin-administrado-guardar.

Dominio estado
Las siguientes banderas de filtro seleccionan un dominio por su estado: - estado de funcionamiento para
ejecutando dominios, --estado-pausado para dominios en pausa, - cierre del estado para girar
fuera de dominios y --estado-otro para todos los demás estados como alternativa.

Inicio automático dominios
Para enumerar los dominios de inicio automático, use la bandera --autoencendido. Para listar dominios con esto
función inhabilitada uso --sin inicio automático.

Instantánea existencia
Los dominios que tienen imágenes instantáneas se pueden enumerar usando una bandera --con-instantánea,
dominios sin una instantánea --sin instantánea.

Cuando se habla con servidores más antiguos, este comando se ve obligado a utilizar una serie de llamadas a la API
con una raza inherente, donde un dominio podría no aparecer en la lista o aparecer más de
una vez si cambiaba de estado entre llamadas mientras se recopilaba la lista. Más nuevo
los servidores no tienen este problema.

If --administrado-guardar se especifica, luego los dominios que han gestionado el estado de guardado (solo
posible si están en el shut off estado, por lo que debe especificar --inactivo or --todas
para enumerarlos) se mostrará en su lugar como salvado en el listado. Esta bandera es utilizable
solo con el predeterminado --mesa producción. Tenga en cuenta que esta bandera no filtra la lista de
dominios

If --nombre se especifica, los nombres de dominio se imprimen en lugar de la tabla formateada
por línea. Si --uuido Si se especifica, los UUID del dominio se imprimen en lugar de los nombres. Bandera
--mesa especifica que se debe utilizar la salida con formato de tabla heredada. Este es el
defecto. Todos estos son mutuamente excluyentes.

If --título se especifica, luego la descripción breve del dominio (título) se imprime en un
columna extra. Esta bandera solo se puede usar con el valor predeterminado --mesa salida.

Ejemplo:

Virsh lista - título
Id Nombre Estado Título
-------------------------------------------------- ------------------------
0 Dominio-0 ejecutando Mailserver 1
2 fedora en pausa

Freecell [{[--celda] celular | --todas }]
Imprime la cantidad de memoria disponible en la máquina o dentro de una celda NUMA. los
El comando de celda libre puede proporcionar una de las tres pantallas diferentes de memoria disponible en
la máquina en función de las opciones especificadas. Sin opciones, muestra el
memoria libre total en la máquina. Con la opción --todos, muestra la memoria libre
en cada celda y la memoria libre total en la máquina. Finalmente, con un numérico
argumento o con --cellno más un número de celda, mostrará la memoria libre para el
celda especificada solamente.

páginas libres [{[--celda] celular [--tamaño de página] tamaño de página | --todas }]
Imprime la cantidad disponible de páginas dentro de una celda NUMA. celular se refiere a la NUMA
celular que le interesa. tamaño de página es un entero escalado (ver NOTAS encima).
Alternativamente, si --todas se utiliza, información sobre cada combinación posible de celda NUMA y
se imprime el tamaño de la página.

alocpages [--tamaño de página] tamaño de página [--recuento de páginas] recuento de páginas [[--celda] celular] [--agregar]
[--todas]
Cambiar el tamaño del grupo de páginas de tamaño de página en el anfitrión. Si --agregar se especifica, entonces
recuento de páginas las páginas se agregan al grupo. Sin embargo, si --agregar no se especificó, entonces el
recuento de páginas se toma como el nuevo tamaño absoluto de la piscina (esto puede usarse para liberar algunos
páginas y reducir el tamaño de la piscina). los celular El modificador se puede utilizar para reducir el
modificación hasta una única celda NUMA de host. En el otro extremo del espectro se encuentra --todas
que ejecuta la modificación en todas las celdas NUMA.

línea de base de CPU ARCHIVO [--características] [--migrable]
Calcule la CPU de referencia que será compatible con todas las CPU de host que se indican en . los
La lista de CPU de host se crea extrayendo todos elementos de la . Por lo tanto, la
puede contener un conjunto de elementos separados por nuevas líneas o incluso un conjunto
de completo elementos impresos por capacidades mando. Si --características is
especificado, la descripción XML resultante incluirá explícitamente todas las características que
componen la CPU, sin esta opción, las características que son parte del modelo de CPU no
aparecer en la descripción XML. Si --migrable se especifica, características que bloquean
la migración no se incluirá en la CPU resultante.

comparar cpu ARCHIVO [--error]
Comparar la definición de CPU de XML con CPU de host. El XML puede contener
definición de CPU de host o invitado. La definición de la CPU del host es la elemento y
su contenido impreso por capacidades mando. La definición de CPU invitada es la
elemento y su contenido de la definición XML de dominio. Para obtener más información sobre la CPU invitada
definición ver:http://libvirt.org/formatdomain.html#elementsCPU>. Si --error is
especificado, el comando devolverá un error cuando la CPU dada sea incompatible con
CPU del host y se mostrará un mensaje con más detalles sobre la incompatibilidad.
impreso.

cpu-modelos arco
Imprima la lista de modelos de CPU conocidos para la arquitectura especificada.

echo [--cáscara] [--xml] [arg...]
Echo atrás cada uno arg, separados por espacio. Si --cáscara se especifica, entonces la salida
ser entre comillas simples cuando sea necesario, de modo que sea adecuado para su reutilización en un contexto de shell.
If --xml se especifica, la salida se escapará para su uso en XML.

DOMINIO COMANDOS

Los siguientes comandos manipulan dominios directamente, como se indicó anteriormente, la mayoría de los comandos
tome dominio como primer parámetro. los dominio se puede especificar como un número entero corto, un nombre
o un UUID completo.

inicio automático [--desactivar] dominio
Configure un dominio para que se inicie automáticamente en el arranque.

La opción --desactivar desactiva el inicio automático.

un mueble consola dominio [nombredev] [--a salvo] [--fuerza]
Conecte la consola serie virtual para el invitado. El opcional nombredev parámetro
se refiere al alias del dispositivo de una consola alternativa, dispositivo en serie o paralelo
configurado para el invitado. Si se omite, se abrirá la consola principal.

Si la bandera --a salvo se especifica, la conexión solo se intenta si el controlador
admite el manejo seguro de la consola. Esta bandera especifica que el servidor debe asegurarse
acceso exclusivo a dispositivos de consola. Opcionalmente el --fuerza se puede especificar la bandera,
solicitando desconectar cualquier sesión existente, como en el caso de una interrupción
conexión.

Para crear ARCHIVO [--consola] [- pausado] [--autodestruir] [--pass-fds NUEVO MÉJICO,...]
Crea un dominio a partir de un XML . Una forma sencilla de crear XML es usar el
volcarxml comando para obtener la definición de un huésped preexistente. El dominio será
pausado si el - pausado la opción es utilizada y respaldada por el controlador; de lo contrario lo hará
estar corriendo. Si --consola se solicita, adjuntar a la consola después de la creación. Si
--autodestruir se solicita, el huésped será automáticamente destruido cuando virsh
cierra su conexión con libvirt, o sale de otro modo.

If --pass-fds se especifica, el argumento es una lista separada por comas de archivos abiertos
descriptores que deben transmitirse al huésped. Los descriptores de archivo se volverán a
numerados en el invitado, a partir de 3. Esto solo es compatible con contenedores basados
virtualización.

Ejemplo

virsh dumpxml > dominio.xml
vi domain.xml (o realice cambios con su otro editor de texto)
virsh crea dominio.xml

definir ARCHIVO
Definir un dominio a partir de un XML . La definición de dominio está registrada pero no
empezado. Si el dominio ya se está ejecutando, los cambios entrarán en vigencia en el próximo arranque.

desc dominio [[--En Vivo] [--config] | [--Actual]] [--título] [--editar] [--nuevo-desc New
descripción o mensaje de título]
Muestra o modifica la descripción y el título de un dominio. Estos valores son campos de usuario que
permiten almacenar datos textuales arbitrarios para permitir una fácil identificación de dominios. Título
debe ser breve, aunque no se aplica. (Ver también metadatos que funciona con XML
metadatos de dominio basados.)

Banderas --En Vivo or --config seleccione si este comando funciona en vivo o persistente
definiciones del dominio. Si ambos --En Vivo y --config se especifican, el --config
La opción tiene prioridad sobre la obtención de la descripción actual y la configuración en vivo.
y config se actualizan al configurar la descripción. --Actual es exclusivo y
implícito si no se especifica ninguno de estos.

Destacar --editar especifica que un editor con el contenido de la descripción o título actual
debe abrirse y el contenido se debe guardar posteriormente.

Destacar --título selecciona la operación en el campo del título en lugar de la descripción.

Si ninguno de --editar y --nuevo-desc se especifican se muestra la nota o descripción
en lugar de ser modificado.

destruir dominio [--agraciado]
Terminar inmediatamente el dominio dominio. Esto no le da al SO del dominio ninguna posibilidad
reaccionar, y es el equivalente a arrancar el cable de alimentación de una máquina física.
En la mayoría de los casos, querrá utilizar el cierre comando en su lugar. Sin embargo, esto
no elimine ningún volumen de almacenamiento utilizado por el invitado, y si el dominio es persistente,
se puede reiniciar más tarde.

If dominio es transitorio, los metadatos de las instantáneas se perderán una vez que el invitado
deja de ejecutarse, pero el contenido de la instantánea aún existe y un nuevo dominio con el mismo
nombre y UUID pueden restaurar los metadatos de la instantánea con creación de instantánea.

If --agraciado se especifica, no recurra a medidas extremas (por ejemplo, SIGKILL) cuando el
el invitado no se detiene después de un tiempo de espera razonable; devuelve un error en su lugar.

domblkstat dominio [dispositivo de bloque] [--humano]
Obtén estadísticas de bloqueo de dispositivos para un dominio en ejecución. A dispositivo de bloque corresponde a un único
nombre de destino ) o archivo fuente ( ) para uno de
los dispositivos de disco conectados a dominio (Véase también lista de domblk para enumerar estos nombres). Sobre
un dominio lxc o qemu, omitiendo el dispositivo de bloque produce estadísticas de bloqueo del dispositivo de forma resumida
para todo el dominio.

Utilice --humano para una salida más legible por humanos.

La disponibilidad de estos campos depende del hipervisor. Faltan campos no admitidos
de la salida. Pueden aparecer otros campos si se comunica con una versión más reciente de
libvirtd.

Explicación of campos (los campos aparecen en el siguiente orden):
rd_req - recuento de operaciones de lectura
rd_bytes - recuento de bytes leídos
wr_req - recuento de operaciones de escritura
wr_bytes - recuento de bytes escritos
errs - recuento de errores
flush_operations - recuento de operaciones de flush
rd_total_times - tiempo total que tardaron las operaciones de lectura (ns)
wr_total_times: tiempo total que tardaron las operaciones de escritura (ns)
flush_total_times - tiempo total que tomaron las operaciones de descarga (ns)
<- otros campos proporcionados por el hipervisor ->

domifaddr dominio [interfaz.] [--lleno] [--fuente arrendamiento | agente]
Obtener una lista de interfaces de un dominio en ejecución junto con sus direcciones IP y MAC, o
salida limitada solo para una interfaz si interfaz. está especificado. Tenga en cuenta que interfaz.
puede depender del controlador, puede ser el nombre dentro del sistema operativo invitado o el nombre que vería
en el dominio XML. Además, todo el comando puede requerir la configuración de un agente invitado.
para el dominio consultado bajo algunos controladores, en particular qemu. Si --lleno se especifica, el
El nombre de la interfaz siempre se muestra cuando la interfaz tiene varias direcciones o alias,
de lo contrario, solo muestra el nombre de la interfaz para la primera dirección y "-" para la
otros. los --fuente El argumento especifica qué fuente de datos usar para las direcciones,
actualmente uno de 'arrendamiento' para leer arrendamientos DHCP, o 'agente' para consultar el sistema operativo invitado a través de un
agente. Si no se especifica, "arrendamiento" es el valor predeterminado.

domistat dominio dispositivo de interfaz
Obtenga estadísticas de interfaz de red para un dominio en ejecución.

enlace-domif dominio dispositivo de interfaz estado [--config]
Modifique el estado del enlace de la interfaz virtual del dominio. Los valores posibles para el estado son
"arriba y abajo". Si --config se especifica, solo la configuración persistente del
se modifica el dominio, por motivos de compatibilidad, --persistente es alias de --config.
dispositivo de interfaz puede ser el nombre de destino de la interfaz o la dirección MAC.

enlace-domif dominio dispositivo de interfaz [--config]
Consulta el estado del enlace de la interfaz virtual del dominio. Si --config se especifica, consulta
la configuración persistente, por motivos de compatibilidad, --persistente es alias de
--config.

dispositivo de interfaz puede ser el nombre de destino de la interfaz o la dirección MAC.

dominar dominio dispositivo de interfaz [[--config] [--En Vivo] | [--Actual]] [--entrante
promedio, pico, explosión, piso] [--saliente promedio, pico, ráfaga]
Configure o consulte los parámetros de ancho de banda de la interfaz de red del dominio. dispositivo de interfaz
puede ser el nombre de destino de la interfaz ( ) o la dirección MAC.

Si no es correcto --entrante or --saliente se especifica, este comando consultará y mostrará el
configuración de ancho de banda. De lo contrario, establecerá el ancho de banda entrante o saliente.
promedio, pico, explosión, piso es lo mismo que al mando adjuntar interfaz. Valores para
promedio, pico y piso se expresan en kilobytes por segundo, mientras que explosión is
expresado en kilobytes en una sola ráfaga a pico velocidad como se describe en el XML de red
documentación enhttp://libvirt.org/formatnetwork.html#elementQoS>.

Para borrar la configuración entrante o saliente, use --entrante or --saliente respetuosamente con
valor medio de cero.

If --En Vivo se especifica, afecta a un invitado en ejecución. Si --config se especifica, afectan al
siguiente arranque de un invitado persistente. Si --Actual se especifica, afecta al invitado actual
estado. Ambos --En Vivo y --config se pueden dar banderas, pero --Actual es exclusivo. Si no
se especifica la bandera, el comportamiento es diferente según el hipervisor.

dommemstat dominio [--período segundos] [[--config] [--En Vivo] | [--Actual]]
Obtenga estadísticas de memoria para un dominio en ejecución.

Dependiendo del hipervisor, se pueden devolver diversas estadísticas.

Para QEMU / KVM con un globo de memoria, configurar el opcional --período a un valor mayor
que 0 en segundos permitirá que el controlador del globo devuelva estadísticas adicionales que
será mostrado por subsecuente dommemstat comandos. Establecer el --período a 0 voluntad
detiene la recopilación de controladores de globo, pero no borra las estadísticas en el globo
conductor. Requiere al menos QEMU / KVM 1.5 para ejecutarse en el host.

La sección --En Vivo, --config y --Actual Las banderas solo son válidas cuando se usa el --período
opción para establecer el período de recopilación del controlador de globo. Si --En Vivo is
especificado, solo se ve afectado el período de recopilación de invitados en ejecución. Si --config is
especificado, afectará al próximo arranque de un invitado persistente. Si --Actual está especificado,
afectar el estado actual del huésped.

Ambos --En Vivo y --config se pueden dar banderas, pero --Actual es exclusivo. Si no hay bandera
especificado, el comportamiento es diferente según el estado del huésped.

error dominio
Mostrar errores en dispositivos de bloque. Este comando suele ser útil cuando dominar comando
dice que un dominio se pausó debido a un error de E / S. los error el comando enumera todo
bloquear dispositivos en estado de error y el error visto en cada uno de ellos.

domblkinfo dominio dispositivo de bloque
Obtén información sobre el tamaño del dispositivo de bloque para un dominio. A dispositivo de bloque corresponde a un único
nombre de destino ) o archivo fuente ( ) para uno de
los dispositivos de disco conectados a dominio (Véase también lista de domblk para enumerar estos nombres).

lista de domblk dominio [--inactivo] [--detalles]
Imprima una tabla que muestre la breve información de todos los dispositivos de bloque asociados con
dominio. Si --inactivo se especifica, consulte los dispositivos de bloque que se utilizarán en el
siguiente arranque, en lugar de los que utiliza actualmente un dominio en ejecución. Si --detalles is
especificado, también se imprimirán el tipo de disco y el valor del dispositivo. Otros contextos que
requieren un nombre de dispositivo de bloque (como domblkinfo or creación de instantánea para instantáneas de disco)
aceptará nombres de origen únicos o de destino impresos por este comando.

estadísticas domésticas [--crudo] [--hacer cumplir] [--apoyo] [--estado] [--cpu-total] [--globo] [--vcpu]
[--interfaz] [--cuadra] [[--lista-activa] [--lista-inactiva] [--lista-persistente]
[--lista-transitoria] [- lista en ejecución] [--lista-en pausa] [--list-cierre] [--listar-otros]] |
[dominio ...]
Obtenga estadísticas para varios o todos los dominios. Sin ningún argumento, este comando se imprime
todas las estadísticas disponibles para todos los dominios.

La lista de dominios para recopilar estadísticas puede limitarse enumerando los dominios
como una lista separada por espacios, o especificando una de las banderas de filtrado --lista-*. (Los
los enfoques no se pueden combinar.)

De forma predeterminada, algunos de los campos devueltos se pueden convertir a valores más amigables para los humanos
por un conjunto de bonitas impresoras. Para suprimir este comportamiento, utilice el --crudo bandera.

Los grupos de estadísticas individuales se pueden seleccionar mediante indicadores específicos. Por defecto todos
Se devuelven los grupos de estadísticas admitidos. Los indicadores de grupos de estadísticas admitidos son:
--estado, --cpu-total, --globo, --vcpu, --interfaz, --cuadra.

Al seleccionar el --estado group, se devuelven los siguientes campos: "state.state" -
estado de la máquina virtual, devuelto como un número de virDomainState enum, "state.reason" - motivo
para entrar en un estado dado, devuelto como int de virDomain * Enum de motivo correspondiente a
estado dado.

--cpu-total devuelve: "cpu.time": tiempo total de CPU dedicado a este dominio en nanosegundos,
"cpu.user": tiempo de CPU de usuario invertido en nanosegundos, "cpu.system": tiempo de CPU del sistema invertido
en nanosegundos

--globo devuelve: "balloon.current" - la memoria en kiB utilizada actualmente,
"balloon.maximum": la memoria máxima permitida en kiB

--vcpu devuelve: "vcpu.current": número actual de CPU virtuales en línea, "vcpu.maximum"
- número máximo de CPU virtuales en línea, "vcpu. .state "- estado de la CPU virtual
, como número de virVcpuState enum, "vcpu. .time ": tiempo de CPU virtual empleado por
CPU virtual

--interfaz devuelve: "net.count" - número de interfaces de red en este dominio,
"neto. .name "- nombre de la interfaz , "neto. .rx.bytes "- número de bytes
recibido, "neto. .rx.pkts "- número de paquetes recibidos", net. .rx.errs "-
número de errores de recepción, "neto. .rx.drop ": número de paquetes de recepción descartados,
"neto. .tx.bytes "- número de bytes transmitidos," net. .tx.pkts "- número de
paquetes transmitidos, "net. .tx.errs ": número de errores de transmisión,
"neto. .tx.drop ": número de paquetes de transmisión descartados

--cuadra devuelve información sobre los discos asociados con cada dominio. Utilizando el
--apoyo flag extiende esta información para cubrir todos los recursos en la cadena de respaldo,
en lugar del valor predeterminado de limitar la información a la capa activa para cada invitado
disco. La información enumerada incluye: "block.count": número de dispositivos de bloque que se están
listado, "bloque. .name "- nombre del destino del dispositivo de bloque (lo mismo
nombre para múltiples entradas si --apoyo está presente), "bloque. .backingIndex "- cuando
--apoyo está presente, coincide con el índice listado en el dominio XML
para respaldar archivos, "block. .path "- fuente de archivo del dispositivo de bloque , si es un
archivo local o dispositivo de bloque, "block. .rd.reqs ": número de solicitudes de lectura,
"cuadra. .rd.bytes "- número de bytes leídos," bloque. .rd.times "- tiempo total
(ns) gastados en lecturas, "bloque. .wr.reqs ": número de solicitudes de escritura,
"cuadra. .wr.bytes "- número de bytes escritos," bloque. .wr.times "- tiempo total
(ns) gastados en escrituras, "bloque. .fl.reqs ": solicitudes de descarga totales,
"cuadra. .fl.times "- tiempo total (ns) dedicado al vaciado de la caché", bloque. .errors "
- Solo Xen: el valor 'oo_req', bloque ". .allocation ": desplazamiento del valor más alto escrito
sector en bytes, "bloque. .capacity ": tamaño lógico del archivo de origen en bytes,
"cuadra. .physical ": tamaño físico del archivo de origen en bytes

Seleccionar un grupo de estadísticas específico no garantiza que el demonio admita el
grupo seleccionado de estadísticas. Bandera --hacer cumplir obliga al comando a fallar si el demonio
no es compatible con el grupo seleccionado.

domiflista dominio [--inactivo]
Imprima una tabla que muestre la breve información de todas las interfaces virtuales asociadas con
dominio. Si --inactivo se especifica, consulte las interfaces virtuales que se utilizarán en
el próximo arranque, en lugar de los que utiliza actualmente un dominio en ejecución. Otros contextos
que requieren una dirección MAC de interfaz virtual (como desconectar-interfaz or domi-
establecer enlace) aceptará la dirección MAC impresa por este comando.

compromiso de bloque dominio camino [ancho de banda] [bases] [--poco profundo] [parte superior] [--Eliminar] [--keep-relativo]
[--Espere [--asíncrono] [--verboso]] [--se acabó el tiempo segundos] [--activo] [{--pivote | --mantener superposición}]
Reduzca la longitud de una cadena de imagen de respaldo, realizando cambios en la parte superior de la
encadenar (archivos de instantánea o delta) en imágenes de respaldo. Por defecto, este comando
intenta aplanar toda la cadena. Si bases y/o parte superior se especifican como archivos
dentro de la cadena de respaldo, entonces la operación se limita a comprometer solo eso
porción de la cadena; --poco profundo se puede usar en lugar de bases para especificar el inmediato
archivo de respaldo de la imagen superior resultante que se comprometerá. Los archivos que se están comprometiendo
se invalidan, posiblemente tan pronto como comience la operación; utilizando el --Eliminar
flag intentará eliminar estos archivos invalidados cuando se complete con éxito el
la operación de confirmación. Cuando el --keep-relativo se utiliza la bandera, las rutas del archivo de respaldo
se mantendrá relativo.

¿Cuándo? parte superior se omite o se especifica como la imagen activa, también es posible especificar
--activo para activar un compromiso activo de dos fases. En la primera fase, parte superior se copia en
bases y el trabajo solo se puede cancelar, y la parte superior aún contiene datos que aún no están en la base.
En la segunda fase, parte superior y bases permanecen idénticos hasta que una llamada a trabajo en bloque con el
--abortar bandera (manteniendo la parte superior como la imagen activa que rastrea los cambios desde ese punto en
tiempo) o el --pivote bandera (haciendo base la nueva imagen activa e invalidando la parte superior).

De forma predeterminada, este comando regresa tan pronto como sea posible, y los datos de todo el disco son
cometido en segundo plano; el progreso de la operación se puede comprobar con
trabajo en bloque. Sin embargo, si --Espere se especifica, este comando se bloqueará hasta que
la operación se completa (o para --activo, entra en la segunda fase), o hasta que la operación
se cancela porque el opcional tiempo de espera en segundos transcurre o se envía SIGINT (generalmente
con "Ctrl-C"). Utilizando --verboso para cada año fiscal junto con la --Espere producirá un estado periódico
actualizaciones. Si se activa la cancelación del trabajo, --asíncrono devolverá el control al usuario como
lo más rápido posible, de lo contrario, el comando puede continuar bloqueándose un poco más
hasta que termine el trabajo de limpieza. Utilizando --pivote es la abreviatura de combinar --activo
--Espere con un automatico trabajo en bloque --pivote; y usando --mantener superposición es taquigrafía para
combinar --activo --Espere con un automatico trabajo en bloque --abortar.

camino especifica la ruta completa del disco; corresponde a un objetivo único
nombre ( ) o archivo fuente ( ) para uno de los discos
dispositivos conectados a dominio (Véase también lista de domblk para enumerar estos nombres). ancho de banda
especifica el límite de ancho de banda de copia en MiB / s, aunque para qemu, puede ser solo distinto de cero
para un dominio en línea. La especificación de un valor negativo se interpreta como un largo sin signo.
valor largo o esencialmente ilimitado. El hipervisor puede elegir si rechaza el
valor o conviértalo al valor máximo permitido.

copia en bloque dominio camino { dest [formato] [--blockdev] | --xml presentar } [--poco profundo]
[--reutilizar-externo] [ancho de banda] [--Espere [--asíncrono] [--verboso]] [{--pivote | --terminar}]
[--se acabó el tiempo segundos] [granularidad] [tamaño buf]
Copie una cadena de imágenes de respaldo de disco en un destino. Cualquiera dest como archivo de destino
nombre, o --xml con el nombre de un archivo XML que contiene un nivel superior elemento
describiendo el destino, debe estar presente. Además, si dest es dado, formato
debe especificarse para declarar el formato del destino (si formato se omite,
luego libvirt reutilizará el formato de la fuente, o con --reutilizar-externo se mantendrá
forzado a sondear el formato de destino, que podría ser un potencial agujero de seguridad).
El comando admite --crudo como sinónimo de bandera booleana para --format = raw. Cuando usas
dest, el destino se trata como un archivo normal a menos que --blockdev se usa para señalar
que es un dispositivo de bloque. De forma predeterminada, este comando aplana toda la cadena; pero si
--poco profundo se especifica, la copia comparte la cadena de respaldo.

If --reutilizar-externo se especifica, entonces el destino debe existir y tener suficiente
espacio para guardar la copia. Si --poco profundo se usa junto con --reutilizar-externo y luego
la imagen creada previamente debe tener contenidos visibles para los invitados idénticos a los de los invitados visibles
contenido del archivo de respaldo de la imagen original. Esto se puede utilizar para modificar el
copia de seguridad de los nombres de archivo en el destino.

De forma predeterminada, el trabajo de copia se ejecuta en segundo plano y consta de dos fases.
Inicialmente, el trabajo debe copiar todos los datos del origen y, durante esta fase, el trabajo
solo se puede cancelar para volver al disco de origen, sin garantías sobre el
destino. Una vez completada esta fase, tanto el origen como el destino permanecen
reflejado hasta que una llamada a trabajo en bloque con el --abortar y --pivote banderas gira sobre
la copia, o una llamada sin --pivote deja el destino como una copia fiel de ese
punto en el tiempo. Sin embargo, si --Espere se especifica, este comando se bloqueará hasta que
comienza la fase de duplicación, o cancele la operación si el opcional tiempo de espera en segundos
transcurre o se envía SIGINT (normalmente con "Ctrl-C"). Utilizando --verboso para cada año fiscal junto con la --Espere
producirá actualizaciones de estado periódicas. Utilizando --pivote (Similar a trabajo en bloque --pivote) o
--terminar (Similar a trabajo en bloque --abortar) implica --Esperey, además, finalizará el
trabaje limpiamente en lugar de dejar las cosas en la fase de reflejo. Si la cancelación del trabajo es
desencadenado por el tiempo de espera o por --terminar, --asíncrono devolverá el control al usuario lo más rápido
como sea posible, de lo contrario, el comando puede continuar bloqueándose un poco más hasta que
el trabajo realmente se ha cancelado.

camino especifica la ruta completa del disco. ancho de banda especifica copiar
límite de ancho de banda en MiB / s. La especificación de un valor negativo se interpreta como sin firmar.
valor largo a largo que podría ser esencialmente ilimitado, pero que probablemente se desbordaría;
es más seguro usar 0 para ese propósito. Especificando granularidad permite el ajuste fino de
la granularidad que se copiará cuando se detecte una región sucia; valores mayores
desencadenar menos sobrecarga de E / S pero puede terminar copiando más datos en general (el valor predeterminado
suele ser correcto); Los hipervisores pueden restringir esto para que sea un poder de dos o caer dentro de
un cierto rango. Especificando tamaño buf controlará cuántos datos pueden ser simultáneamente
en vuelo durante la copia; los valores más grandes usan más memoria, pero pueden permitir más
finalización (el valor predeterminado suele ser correcto).

tirar del bloque dominio camino [ancho de banda] [bases] [--Espere [--verboso] [--se acabó el tiempo segundos]
[--asíncrono]] [--keep-relativo]
Rellene un disco a partir de su cadena de imágenes de respaldo. De forma predeterminada, este comando aplana el
cadena entera; pero si bases se especifica, que contiene el nombre de uno de los respaldos
archivos en la cadena, entonces ese archivo se convierte en el nuevo archivo de respaldo y solo el
se tira de la parte intermedia de la cadena. Una vez que todos los datos solicitados del respaldo
se ha tirado de la cadena de imagen, el disco ya no depende de esa parte del respaldo
cadena.

De forma predeterminada, este comando regresa tan pronto como sea posible, y los datos de todo el disco son
tirado en el fondo; el progreso de la operación se puede comprobar con trabajo en bloque.
Sin embargo, si --Espere se especifica, entonces este comando se bloqueará hasta que la operación
completa, o cancela la operación si el opcional tiempo de espera en segundos transcurre o
Se envía SIGINT (normalmente con "Ctrl-C"). Utilizando --verboso para cada año fiscal junto con la --Espere will
producir actualizaciones de estado periódicas. Si se activa la cancelación del trabajo, --asíncrono will
devolver el control al usuario lo más rápido posible; de ​​lo contrario, el comando puede continuar
bloquee un poco más hasta que termine de limpiar el trabajo.

Usando el --keep-relativo flag mantendrá los nombres de la cadena de respaldo relativos.

camino especifica la ruta completa del disco; corresponde a un objetivo único
nombre ( ) o archivo fuente ( ) para uno de los discos
dispositivos conectados a dominio (Véase también lista de domblk para enumerar estos nombres). ancho de banda
especifica el límite de ancho de banda de copia en MiB / s. La especificación de un valor negativo se interpreta
como un valor largo largo sin firmar o esencialmente ilimitado. El hipervisor puede elegir
si rechazar el valor o convertirlo al valor máximo permitido.

blkdeviotune dominio de dispositivos [[--config] [--En Vivo] | [--Actual]] [[total-bytes-seg] | [leer-
bytes-seg] [escritura-bytes-seg]] [[total-iops-seg] | [leer-iops-seg] [escritura-iops-seg]]
[[total-bytes-seg-max] | [leer-bytes-sec-max] [escritura-bytes-sec-max]] [[total-iops-seg-max]
| [leer-iops-sec-max] [escribir-iops-sec-max]] [tamaño-iops-sec]
Establecer o consultar los parámetros de io del disco de bloque para un dispositivo de bloque de dominio. de dispositivos
especifica un nombre de destino único ( ) o archivo fuente (
file = 'name' />) para uno de los dispositivos de disco conectados a dominio (Véase también lista de domblk para
enumerando estos nombres).

Si no se especifica ningún límite, consultará la configuración actual de los límites de E / S. De lo contrario, modifique
los límites con estas banderas: --total-bytes-seg especifica el límite de rendimiento total en
bytes por segundo. --leer-bytes-seg especifica el límite de rendimiento de lectura en bytes por
segundo. --escribir-bytes-seg especifica el límite de rendimiento de escritura en bytes por segundo.
--total-iops-seg especifica el límite total de operaciones de E / S por segundo. --read-iops-sec
especifica el límite de operaciones de E / S de lectura por segundo. --escribir-iops-sec especifica escribir E / S
límite de operaciones por segundo. --total-bytes-seg-max especifica el rendimiento total máximo
límite en bytes por segundo. --leer-bytes-sec-max especifica el rendimiento máximo de lectura
límite en bytes por segundo. --escribir-bytes-sec-max especifica el rendimiento máximo de escritura
límite en bytes por segundo. --total-iops-sec-max especifica el máximo total de E / S
límite de operaciones por segundo. --read-iops-sec-max especifica la E / S de lectura máxima
límite de operaciones por segundo. --escribir-iops-sec-max especifica el máximo de E / S de escritura
límite de operaciones por segundo. - tamaño-iops-sec especifica el tamaño del límite de operaciones de E / S por
segundo.

Las versiones anteriores de virsh solo aceptaban estas opciones con un guión bajo en lugar de un guión,
como en --total_bytes_seg.

Los valores de bytes y iops son independientes, pero establecen un solo valor (como
--read-bytes-sec) restablece los otros dos en esa categoría a ilimitados. Un 0 explícito
también borra cualquier límite. Un valor distinto de cero para un total dado no se puede mezclar con un valor distinto de cero.
valores cero para lectura o escritura.

If --En Vivo se especifica, afecta a un invitado en ejecución. Si --config se especifica, afectan al
siguiente arranque de un invitado persistente. Si --Actual se especifica, afecta al invitado actual
estado. Al configurar los parámetros del disco io tanto --En Vivo y --config banderas pueden ser
dado, pero --Actual es exclusivo. Para consultar solo uno de --En Vivo, --config or
--Actual se puede especificar. Si no se especifica ninguna bandera, el comportamiento es diferente según
en hipervisor.

trabajo en bloque dominio camino {[--abortar] [--asíncrono] [--pivote] | [--información] [--crudo] [--bytes] |
[ancho de banda]}
Gestionar operaciones de bloques activos. Hay tres modos mutuamente excluyentes: --información,
ancho de banda y --abortar. --asíncrono y --pivote implica el modo de aborto; --crudo implica información
modo; y si no se dio ningún modo, --información se asume el modo.

camino especifica la ruta completa del disco; corresponde a un objetivo único
nombre ( ) o archivo fuente ( ) para uno de los discos
dispositivos conectados a dominio (Véase también lista de domblk para enumerar estos nombres).

In --abortar modo, se cancelará el trabajo activo en el disco especificado. Si --asíncrono is
También especificado, este comando volverá inmediatamente, en lugar de esperar a que
cancelación para completar. Si --pivote se especifica, esto solicita que una copia activa
o el trabajo de confirmación activo se pivote sobre la nueva imagen.

In --información modo, se imprimirá la información del trabajo activo en el disco especificado. Por
por defecto, la salida es una única línea de resumen legible por humanos; este formato puede cambiar en
versiones futuras. Añadiendo --crudo enumera cada campo de la estructura, en un formato estable. Si
el --bytes se establece la bandera, entonces el comando falla si el servidor no puede suministrar
resolución de bytes / s; al omitir la bandera, la salida sin procesar se enumera en MiB / sy
La salida legible selecciona automáticamente la mejor resolución admitida por el servidor.

ancho de banda se puede utilizar para establecer el límite de ancho de banda para el trabajo activo. Especificando un
El valor negativo se interpreta como un valor largo largo sin firmar o esencialmente ilimitado.
El hipervisor puede elegir si rechazar el valor o convertirlo al máximo
valor permitido.

tamaño de bloque dominio camino tamaño
Cambiar el tamaño de un dispositivo de bloque de dominio mientras el dominio se está ejecutando, camino especifica el
ruta absoluta del dispositivo de bloque; corresponde a un nombre de destino único (
dev = 'nombre' />) o archivo fuente ( ) para uno de los dispositivos de disco
adjunto a dominio (Véase también lista de domblk para enumerar estos nombres).

tamaño es un entero escalado (ver NOTAS arriba) que por defecto es KiB (bloques de 1024
bytes) si no hay sufijo. Debe utilizar un sufijo "B" para obtener bytes (tenga en cuenta que
por razones históricas, esto difiere de vol-cambiar tamaño que por defecto es bytes sin un
sufijo).

pantalladom dominio [--incluir-contraseña] [[--escribe] tipo]
Genere un URI que se puede utilizar para conectarse a la pantalla gráfica del dominio a través de
VNC, SPICE o RDP. El tipo de pantalla gráfica particular se puede seleccionar usando el
tipo parámetro (por ejemplo, "vnc", "especia", "rdp"). Si --incluir-contraseña se especifica, el
La contraseña del canal SPICE se incluirá en el URI.

informacióndomfsinfo dominio
Muestra una lista de sistemas de archivos montados dentro del dominio en ejecución. La lista contiene
puntos de montaje, nombres de un dispositivo montado en el invitado, tipos de sistemas de archivos y
nombres de destino utilizados en el dominio XML ( ).

Tenga en cuenta que este comando requiere un agente invitado configurado y ejecutándose en el dominio
SO invitado.

domfsfreeze dominio [[--punto de montaje] punto de montaje...]
Congele los sistemas de archivos montados dentro de un dominio en ejecución para prepararlos para
instantáneas.

La sección --punto de montaje la opción toma un parámetro punto de montaje, que es una ruta de punto de montaje de
el sistema de archivos que se congelará. Esta opción puede ocurrir varias veces. Si esto no es
especificado, cada sistema de archivos montado se congela.

Nota: creación de instantánea el comando tiene un --quiescencia opción de congelar y descongelar el
sistemas de archivos automáticamente para mantener la coherencia de las instantáneas. domfsfreeze el comando es solo
necesario cuando un usuario desea utilizar las funciones de instantáneas nativas de los dispositivos de almacenamiento
no es compatible con libvirt.

descongelar dominio [[--punto de montaje] punto de montaje...]
Descongele sistemas de archivos montados dentro de un dominio en ejecución, que han sido congelados por
comando domfsfreeze.

La sección --punto de montaje la opción toma un parámetro punto de montaje, que es una ruta de punto de montaje de
el sistema de archivos que se va a descongelar. Esta opción puede ocurrir varias veces. Si esto no es
especificado, cada sistema de archivos montado se descongela.

domfstrim dominio [--mínimo bytes] [--punto de montaje punto de montaje]
Emita un comando fstrim en todos los sistemas de archivos montados dentro de un dominio en ejecución. Descarta
bloques que no están en uso por el sistema de archivos. Si --mínimo bytes se especifica, es
indica la longitud del kernel invitado del rango libre contiguo. Más pequeño que esto puede ignorarse
(esto es una indirecta y es posible que el huésped no la respete). Al aumentar este valor, el
La operación fstrim se completará más rápidamente para sistemas de archivos con archivos libres muy fragmentados.
espacio, aunque no se descartarán todos los bloques. El valor predeterminado es cero, lo que significa
"descartar todos los bloques libres". Además, si el usuario desea recortar solo un punto de montaje,
se puede especificar a través de opcional --punto de montaje parámetro.

nombre de hostdom dominio
Devuelve el nombre de host de un dominio, si el hipervisor lo hace disponible.

información dominante dominio
Devuelve información básica sobre el dominio.

domuid nombre-de-dominio-o-id
Convierta un nombre de dominio o ID en UUID de dominio

domid nombre-de-dominio-o-uuid
Convierta un nombre de dominio (o UUID) en una identificación de dominio

domjobabort dominio
Abortar el trabajo de dominio que se está ejecutando actualmente.

domjobinfo dominio [--terminado]
Devuelve información sobre trabajos que se ejecutan en un dominio. --terminado le dice a virsh que regrese
información sobre un trabajo terminado recientemente. Las estadísticas de un trabajo completado son
se destruye automáticamente una vez leído o cuando se reinicia libvirtd. Tenga en cuenta que el tiempo
La información devuelta para las migraciones completadas puede ser completamente irrelevante a menos que ambos
Los hosts de origen y destino tienen hora sincronizada (es decir, el demonio NTP se está ejecutando en
ambos).

nombre de dominio id-dominio-o-uuid
Convierta una identificación de dominio (o UUID) en un nombre de dominio

domrename dominio nuevo nombre
Cambiar el nombre de un dominio. Este comando cambia el nombre de dominio actual al nuevo nombre especificado en
el segundo argumento.

Nota: : El dominio debe estar inactivo y sin instantáneas.

dominar dominio [--razón]
Devuelve el estado de un dominio. --razón le dice a virsh que también imprima el motivo de la
estado.

control de dominio dominio
Devuelve el estado de una interfaz a VMM que se utiliza para controlar un dominio. Para estados que no sean
"ok" o "error" el comando también imprime el número de segundos transcurridos desde el control
interfaz entró en su estado actual.

tiempo de dominación dominio {[--ahora] [--lindo] [--sincronizar] [--tiempo time]}
Obtiene o establece la hora del sistema del dominio. Cuando se ejecuta sin argumentos (pero dominio),
Se imprime la hora del sistema del dominio actual. los --lindo El modificador se puede utilizar para
imprima la hora en una forma más legible para los humanos.

¿Cuándo? --tiempo time se especifica, la hora del dominio no se obtiene sino que se establece en su lugar. los
--ahora El modificador actúa como si fuera un alias para --tiempo $ ahora, lo que significa que establece el
tiempo que está actualmente en el host en el que se está ejecutando virsh. En ambos casos (entorno y
obteniendo), el tiempo está en segundos en relación con la Época de 1970-01-01 en UTC. los --sincronizar
modifica un poco el comportamiento del set: el tiempo transcurrido se ignora, pero el tiempo para configurar es
leer desde el RTC del dominio en su lugar. Tenga en cuenta que algunos hipervisores pueden requerir un invitado
agente que se configurará para obtener o establecer la hora del invitado.

domxml-de-nativo formato config
Convierte el archivo config en el formato de configuración de invitado nativo nombrado por formato a una
formato XML de dominio. Para el hipervisor QEMU / KVM, el formato el argumento debe ser qemu-argv. For
Hipervisor Xen, el formato el argumento puede ser xen-xm, xen-xl o xen-sxpr. Para LXC
hipervisor, el formato el argumento debe ser herramientas lxc.

domxml a nativo formato xml
Convierte el archivo xml en formato XML de dominio al formato de configuración de invitado nativo
nombrado por formato. Para el hipervisor QEMU / KVM, el formato el argumento debe ser qemu-argv. For
Hipervisor Xen, el formato el argumento puede ser xen-xm, xen-xl o xen-sxpr. Para LXC
hipervisor, el formato el argumento debe ser herramientas lxc.

arrojar dominio ruta del archivo principal [--bypass-caché] {[--En Vivo] | [--choque] | [--Reiniciar]} [--verboso]
[- solo de memoria] [--formato cadena]
Vuelca el núcleo de un dominio en un archivo para su análisis. Si --En Vivo se especifica, el dominio
continúa ejecutándose hasta que se completa el volcado del núcleo, en lugar de hacer una pausa al principio. Si
--choque se especifica, el dominio se detiene con un estado bloqueado, en lugar de simplemente
dejado en un estado de pausa. Si --Reiniciar se especifica, el dominio se restablece después de
vertedero. Tenga en cuenta que estos tres conmutadores son mutuamente excluyentes. Si --bypass-caché is
especificado, el guardado evitará el caché del sistema de archivos, aunque esto puede ralentizar el
operación. Si - solo de memoria se especifica, el archivo es elf y solo incluirá
la memoria del dominio y el valor del registro común de la CPU. Es muy útil si el dominio usa
dispositivos host directamente. --formato cadena se utiliza para especificar el formato de 'solo memoria'
volcado, y cadena puede ser uno de ellos: elf, kdump-zlib (formato comprimido kdump con
zlib-compressed), kdump-lzo (formato kdump comprimido con lzo comprimido),
kdump-snappy (formato comprimido kdump con snappy-compressed).

El progreso se puede monitorear usando domjobinfo comando virsh y cancelado con
domjobabort comando (enviado por otra instancia de virsh). Otra opción es enviar SIGINT
(generalmente con "Ctrl-C") al proceso virsh en ejecución arrojar mando. --verboso
el progreso del volcado.

NOTA: Algunos hipervisores pueden requerir que el usuario asegure manualmente los permisos adecuados en
archivo y ruta especificados por argumento ruta del archivo principal.

volcarxml dominio [--inactivo] [--información de seguridad] [--actualizar-cpu] [--migrable]
Envíe la información del dominio como un volcado XML a stdout, este formato puede ser utilizado por el
Para crear mando. Se pueden utilizar opciones adicionales que afecten al volcado XML. --inactivo
le dice a virsh que descargue la configuración del dominio que se utilizará en el próximo inicio del dominio
a diferencia de la configuración de dominio actual. Utilizando --información de seguridad También se
incluir información confidencial de seguridad en el volcado XML. --actualizar-cpu actualiza el dominio
Requisitos de CPU de acuerdo con la CPU del host. Con --migrable se puede solicitar un XML que
es adecuado para migraciones, es decir, compatible con versiones anteriores de libvirt y posiblemente
modificado con opciones internas de tiempo de ejecución. Esta opción puede habilitar automáticamente otros
opciones (--actualizar-cpu, --información de seguridad, ...) según sea necesario.

editar dominio
Edite el archivo de configuración XML para un dominio, que afectará el próximo arranque del
invitado.

Esto es equivalente a:

virsh dumpxml --inactive --security-info dominio> dominio.xml
vi domain.xml (o realice cambios con su otro editor de texto)
virsh define dominio.xml

excepto que realiza una comprobación de errores.

El editor utilizado puede ser proporcionado por las variables de entorno $ VISUAL o $ EDITOR, y
por defecto es "vi".

evento {[dominio] { evento | --todas } [--círculo] [--se acabó el tiempo segundos] [- marca de tiempo] | --lista}
Espere a que ocurra una clase de eventos de dominio e imprima los detalles apropiados de los eventos como
Ellos pasan. Los eventos se pueden filtrar opcionalmente por dominio. Utilizando --lista como el
El único argumento proporcionará una lista de posibles evento valores conocidos por este cliente,
aunque es posible que la conexión no permita registrarse para todos estos eventos. Tambien es
posible de usar --todas en lugar de evento para registrarse para todos los tipos de eventos posibles en
una vez.

De forma predeterminada, este comando es de una sola vez y devuelve el éxito una vez que ocurre un evento; usted
puede enviar SIGINT (normalmente a través de "Ctrl-C") para salir inmediatamente. Si --se acabó el tiempo is
especificado, el comando deja de esperar eventos después segundos han transcurrido. Con
--círculo, el comando imprime todos los eventos hasta un tiempo de espera o una tecla de interrupción.

¿Cuándo? - marca de tiempo se utiliza, se imprimirá una marca de tiempo legible por humanos antes del evento.

iothreadinfo dominio [[--En Vivo] [--config] | [--Actual]]
Muestra información básica de IOThreads de dominio, incluido el ID de IOThread y la CPU
Afinidad para cada IOThread.

If --En Vivo se especifica, obtenga los datos de IOThreads del invitado en ejecución. Si el invitado es
no se está ejecutando, se devuelve un error. Si --config se especifica, obtenga los datos de IOThreads
desde el siguiente arranque de un invitado persistente. Si --Actual se especifica o --En Vivo y
--config no están especificados, luego obtenga los datos de IOThread basados ​​en el invitado actual
estado.

iothreadpin dominio hilo pulista [[--En Vivo] [--config] | [--Actual]]
Cambie la fijación de un IOThread de dominio para alojar CPU físicas. Para recuperar un
lista de todos los IOThreads, utilice iothreadinfo. Para anclar un hilo especifica el pulista
deseado para el ID de IOThread como se indica en el iothreadinfo salida.

pulista es una lista de números de CPU físicos. Su sintaxis es una lista separada por comas y una
También se puede permitir el marcado especial con '-' y '^' (por ejemplo, '0-4', '0-3, ^ 2'). Los '-'
denota el rango y el '^' denota exclusivo. Si desea restablecer iothreadpin
ajuste, es decir, fijar un hilo a todos los cpus físicos, simplemente especifique 'r' como un
pulista.

If --En Vivo se especifica, afecta a un invitado en ejecución. Si el invitado no se está ejecutando, aparece un error.
es regresado. Si --config se especifica, afectará al próximo arranque de un invitado persistente.
If --Actual se especifica o --En Vivo y --config no se especifican, afectan la corriente
estado invitado. Ambos --En Vivo y --config se pueden dar banderas si pulista está presente, pero
--Actual es exclusivo. Si no se especifica ninguna bandera, el comportamiento es diferente dependiendo de
hipervisor.

Nota: : La expresión se evalúa secuencialmente, por lo que "0-15, ^ 8" es idéntico a
"9-14,0-7,15" pero no idéntico a "^ 8,0-15".

iothreadadd dominio iothread_id [[--config] [--En Vivo] | [--Actual]]
Agregue un nuevo IOThread al dominio usando el especificado iothread_id. Si el iothread_id
ya existe, el comando fallará. los iothread_id Debe ser mayor que cero.

If --En Vivo se especifica, afecta a un invitado en ejecución. Si el invitado no está ejecutando un error
es regresado. Si --config se especifica, afectará al próximo arranque de un invitado persistente.
If --Actual se especifica o --En Vivo y --config no se especifican, afectan la corriente
estado invitado.

iothreaddel dominio iothread_id [[--config] [--En Vivo] | [--Actual]]
Elimina un IOThread del dominio usando el especificado iothread_id. Si un IOThread es
asignado actualmente a un recurso de disco, como a través del adjuntar-disco comando, entonces el
el intento de eliminar el IOThread fallará. Si el iothread_id no existe un error
se producirá.

If --En Vivo se especifica, afecta a un invitado en ejecución. Si el invitado no está ejecutando un error
es regresado. Si --config se especifica, afectará al próximo arranque de un invitado persistente.
If --Actual se especifica o --En Vivo y --config no se especifican, afectan la corriente
estado invitado.

gestionado guardar dominio [--bypass-caché] [{--corriendo | - pausado}] [--verboso]
Guarde y destruya (detenga) un dominio en ejecución, para que pueda reiniciarse desde el mismo estado
en otro momento. Cuando el virsh comienzo siguiente comando se ejecuta para el dominio,
se iniciará automáticamente desde este estado guardado. Si --bypass-caché se especifica, el
save evitará la caché del sistema de archivos, aunque esto puede ralentizar la operación.

El progreso se puede monitorear usando domjobinfo comando virsh y cancelado con
domjobabort comando (enviado por otra instancia de virsh). Otra opción es enviar SIGINT
(generalmente con "Ctrl-C") al proceso virsh en ejecución gestionado guardar mando. --verboso
muestra el progreso de guardar.

Normalmente, al iniciar un guardado administrado se decidirá entre ejecutar o pausar según la
indicar en el que se encontraba el dominio cuando se realizó el guardado; pasando ya sea el --corriendo or
- pausado La bandera permitirá anular qué estado el comienzo debería usar.

La sección información dominante El comando se puede utilizar para consultar si un dominio tiene actualmente algún
guardar imagen.

gestionado guardar-eliminar dominio
Eliminar el gestionado guardar archivo de estado para un dominio, si existe. Esto asegura el dominio
hará un arranque completo la próxima vez que se inicie.

maxvcpus [tipo]
Proporcione la cantidad máxima de CPU virtuales admitidas para una máquina virtual invitada en este
conexión. Si se proporciona, el tipo El parámetro debe ser un atributo de tipo válido para el
elemento de XML.

cpu-estadísticas dominio [--total] [comienzo] [contar]
Proporciona información de estadísticas de la CPU de un dominio. El dominio debería estar funcionando. Defecto
muestra estadísticas para todas las CPU y un total. Usar --total solo para las estadísticas totales, comienzo
solo para las estadísticas por CPU de las CPU de comienzo, contar por solo contar Estadísticas de CPU.

metadatos dominio [[--En Vivo] [--config] | [--Actual]] [--editar] [uri] [clave] [.] [--retirar]
Muestre o modifique metadatos XML personalizados de un dominio. Los metadatos son un XML definido por el usuario.
que permite almacenar datos XML arbitrarios en la definición del dominio. Múltiples separados
Las piezas de metadatos personalizados se pueden almacenar en el dominio XML. Las piezas están identificadas por
un espacio de nombres XML privado proporcionado a través del uri argumento. (Ver también desc que trabaja con
metadatos textuales de un dominio.)

Banderas --En Vivo or --config seleccione si este comando funciona en vivo o persistente
definiciones del dominio. Si ambos --En Vivo y --config se especifican, el --config
La opción tiene prioridad sobre la obtención de la descripción actual y la configuración en vivo.
y config se actualizan al configurar la descripción. --Actual es exclusivo y
implícito si no se especifica ninguno de estos.

Destacar --retirar especifica que el elemento de metadatos especificado por el uri el argumento debe
eliminarse en lugar de actualizarse.

Destacar --editar especifica que un editor con los metadatos identificados por el uri argumento
debe abrirse y el contenido se debe guardar posteriormente. De lo contrario, los nuevos contenidos
se puede proporcionar a través del . argumento.

Al configurar metadatos a través de --editar or . el clave el argumento debe especificarse y se utiliza
para prefijar los elementos personalizados para vincularlos al espacio de nombres privado.

Si ninguno de --editar y . se especifican los metadatos XML correspondientes a la uri
el espacio de nombres se muestra en lugar de modificarse.

migrado [--En Vivo] [--desconectado] [--directo] [--p2p [- tunelizado]] [--persistente]
[--fuente indefinida] [--suspender] [--copia-almacenamiento-todo] [--copia-almacenamiento-inc]
[- protección contra cambios] [--inseguro] [--verboso] [--comprimido] [--aborto por error]
[--autoconvergencia] dominio desturi [migrauri] [Graphicsuri] [escuchar-direccion] [nombre]
[--se acabó el tiempo segundos] [--xml presentar] [--migrar-discos lista de discos]
Migre el dominio a otro host. Agregar --En Vivo para la migración en vivo; <--p2p> para
migración entre pares; --directo para la migración directa; o - tunelizado para tunelizado
migración. --desconectado migra la definición de dominio sin iniciar el dominio en
destino y sin detenerlo en el host de origen. Se puede utilizar la migración sin conexión
con dominios inactivos y debe usarse con --persistente . --persistente
deja el dominio persistente en el host de destino, --fuente indefinida indefine el
dominio en el host de origen, y --suspender deja el dominio en pausa en el destino
anfitrión. --copia-almacenamiento-todo indica migración con almacenamiento no compartido con disco completo
dupdo, --copia-almacenamiento-inc indica migración con almacenamiento no compartido con incremental
copia (la misma imagen base compartida entre el origen y el destino). En ambos casos el disco
las imágenes tienen que existir en el host de destino, el --almacenamiento de copias -... las opciones solo dicen
libvirt para transferir datos de las imágenes en el host de origen a las imágenes que se encuentran en el
mismo lugar en el host de destino. De forma predeterminada, solo se muestran las imágenes no compartidas que no son de solo lectura.
transferido. Usar --migrar-discos para especificar explícitamente una lista de destinos de disco para
transferencia a través de comas separadas lista de discos argumento. - protección contra cambios hace cumplir eso
No se realizarán cambios de configuración incompatibles en el dominio mientras se realiza la migración.
está en marcha; esta bandera está habilitada implícitamente cuando es compatible con el hipervisor, pero puede
ser utilizado explícitamente para rechazar la migración si el hipervisor carece de protección contra cambios
apoyo. --verboso muestra el progreso de la migración. --comprimido activa
Compresión de páginas de memoria que deben transferirse repetidamente durante la transmisión en vivo.
migración. --aborto por error cancela la migración si se produce un error leve (por ejemplo, E / S
error) ocurre durante la migración. --autoconvergencia fuerzas de convergencia durante la vida
migración.

Nota: : Los hipervisores individuales no suelen admitir todos los tipos posibles de migración.
Por ejemplo, QEMU no admite la migración directa.

En algunos casos, libvirt puede negarse a migrar el dominio porque hacerlo puede llevar a
problemas potenciales como la corrupción de datos y, por lo tanto, la migración se considera
inseguro. Para el dominio QEMU, esto puede suceder si el dominio usa discos sin explícitamente
configurando el modo de caché en "ninguno". La migración de dichos dominios no es segura a menos que las imágenes de disco
se almacenan en un sistema de archivos en clúster coherente, como GFS2 o GPFS. Si está seguro de que
la migración es segura o simplemente no te importa, usa --inseguro para forzar la migración.

nombre se utiliza para cambiar el nombre del dominio a un nuevo nombre durante la migración, que también suele
puede ser omitido. Igualmente, --xml presentar generalmente se omite, pero se puede utilizar para proporcionar un
archivo XML alternativo para usar en el destino para proporcionar un conjunto mayor de cambios a
cualquier parte específica del host del XML de dominio, como la contabilidad para la denominación
diferencias entre origen y destino en el acceso al almacenamiento subyacente.

--se acabó el tiempo segundos obliga al huésped a suspender cuando la migración en vivo excede esa cantidad
segundos, y luego la migración se completará sin conexión. Solo se puede usar con
--En Vivo.

La migración en ejecución se puede cancelar interrumpiendo virsh (generalmente usando "Ctrl-C") o
domjobabort comando enviado desde otra instancia de virsh.

La sección desturi y migrauri Los parámetros se pueden utilizar para controlar qué destino
usos de la migración. desturi es importante para la migración gestionada, pero no se utiliza para
migración; migrauri es necesario para la migración directa, pero normalmente se puede
determinado automáticamente para la migración gestionada.

Nota: : Los desturi El parámetro para la migración normal y la migración peer2peer tiene diferentes
semántica:

· Migración normal: la desturi es una dirección del host de destino como se ve desde el
máquina cliente.

· Migración peer2peer: la desturi es una dirección del host de destino como se ve desde el
máquina fuente.

¿Cuándo? migrauri no se especifica, libvirt determinará automáticamente el hipervisor
URI específico. Algunos hipervisores, incluido QEMU, tienen un "host_migracion" opcional
parámetro de configuración (útil cuando el host tiene múltiples interfaces de red). Si
esto no está especificado, libvirt determina un nombre buscando el host de destino
nombre de host configurado.

Hay algunos escenarios en los que especificar migrauri puede ayudar:

· El nombre de host configurado es incorrecto o el DNS está roto. Si un anfitrión tiene un nombre de anfitrión
que no se resolverá para coincidir con una de sus direcciones IP públicas, entonces libvirt
generar un URI incorrecto. En este caso migrauri debe ser explícitamente
especificado, utilizando una dirección IP o un nombre de host correcto.

· El anfitrión tiene múltiples interfaces de red. Si un host tiene varias redes
interfaces, puede ser deseable que el flujo de datos de migración se envíe a través de un
interfaz específica por motivos de seguridad o de rendimiento. En este caso
migrauri debe especificarse explícitamente, utilizando una dirección IP asociada con el
red que se utilizará.

· El cortafuegos restringe los puertos disponibles. Cuando libvirt genera un
URI de migración, elegirá un número de puerto utilizando reglas específicas del hipervisor. Algunos
Los hipervisores solo requieren un puerto abierto en los firewalls, mientras que otros
requieren una amplia gama de números de puerto. En este último caso migrauri puede ser
especificado para elegir un número de puerto específico fuera del rango predeterminado con el fin de
Cumpla con las políticas de firewall locales.

Verhttp://libvirt.org/migration.html#uris> para obtener más detalles sobre los URI de migración.

Opcional Graphicsuri anula los parámetros de conexión utilizados para automáticamente
volver a conectar un cliente gráfico al final de la migración. Si se omite, libvirt
Calcule los parámetros en función de la dirección IP del host de destino. En caso de que el cliente no
tener acceso directo a la red a la que los hosts de virtualización están conectados y necesitan
conectarse a través de un proxy, Graphicsuri se puede utilizar para especificar la dirección del cliente
debe conectarse a. El URI se forma de la siguiente manera:

protocolo: // nombre de host [: puerto] / [? parámetros]

donde el protocolo es "spice" o "vnc" y los parámetros son una lista de protocolos
parámetros específicos separados por '&'. Los parámetros reconocidos actualmente son "tlsPort"
y "tlsSubject". Por ejemplo,

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

Opcional escuchar-direccion establece la dirección de escucha que el hipervisor en el destino
side debe enlazar para la migración entrante. Se aceptan direcciones IPv4 e IPv6
así como los nombres de host (la resolución se realiza en el destino). Algunos hipervisores no
admite esta función y devolverá un error si se utiliza este parámetro.

migrar-setmaxdowntime dominio el tiempo de inactividad
Establecer el tiempo de inactividad máximo tolerable para un dominio que se está migrando en vivo a otro
anfitrión. los el tiempo de inactividad es una cantidad de milisegundos que el huésped puede estar en el
fin de la migración en vivo.

migrar-compcache dominio [--Talla bytes]
Establece y / o obtiene el tamaño de la caché (en bytes) que se usa para comprimir repetidamente
páginas de memoria transferidas durante la migración en vivo. Cuando se llama sin tamaño, El comando
simplemente imprime el tamaño actual de la caché de compresión. Cuando tamaño se especifica, el
se le pide al hipervisor que cambie la caché de compresión a tamaño bytes y luego el actual
se imprime el tamaño (el resultado puede diferir del tamaño solicitado debido al redondeo realizado por
el hipervisor). los tamaño Se supone que la opción debe usarse mientras el dominio está siendo
live-migrated como reacción al progreso de la migración y al aumento del número de compresiones
fallos de caché obtenidos de domjobinfo.

migrate-setpeed dominio ancho de banda
Establezca el ancho de banda máximo de migración (en MiB / s) para un dominio al que se está migrando
otro anfitrión. ancho de banda se interpreta como un valor largo largo sin firmar. Especificando un
El valor negativo da como resultado un valor esencialmente ilimitado que se proporciona al
hipervisor. El hipervisor puede elegir si rechazar el valor o convertirlo al valor
valor máximo permitido.

migrar-getspeed dominio
Obtenga el máximo ancho de banda de migración (en MiB / s) para un dominio.

numatune dominio [--modo modo] [--conjunto de nodos conjunto de nodos] [[--config] [--En Vivo] | [--Actual]]
Establecer u obtener los parámetros numa de un dominio, correspondientes al elemento de
XML de dominio. Sin banderas, se muestran los ajustes actuales.

modo puede ser uno de "estricto", "intercalar" y "preferido" o cualquier número válido de la
virDomainNumatuneMemMode enumeración en caso de que el demonio lo admita. Para un dominio en ejecución,
el modo no se puede cambiar, y el conjunto de nodos se puede cambiar solo si el dominio fue
comenzó con un modo de "estricto".

conjunto de nodos es una lista de nodos numa utilizados por el host para ejecutar el dominio. Su sintaxis
es una lista separada por comas, con '-' para rangos y '^' para excluir un nodo.

If --En Vivo se especifica, establece la información del programador de un invitado en ejecución. Si --config is
especificado, afectará al próximo arranque de un invitado persistente. Si --Actual está especificado,
afectar el estado actual del huésped.

reiniciar dominio [--modo LISTA DE MODOS]
Reinicia un dominio. Esto actúa como si el dominio tuviera la reiniciar comando ejecutar desde el
consola. El comando regresa tan pronto como ha ejecutado la acción de reinicio, que puede
ser significativamente antes de que el dominio se reinicie.

El comportamiento exacto de un dominio cuando se reinicia lo establece el al_reiniciar parámetro en
la definición XML del dominio.

De forma predeterminada, el hipervisor intentará elegir un método de apagado adecuado. Para especificar un
método alternativo, el --modo El parámetro puede especificar una lista separada por comas que
incluye "acpi", "agente", "initctl", "señal" y "paravirt". El orden en que
Los conductores intentarán que cada modo no esté definido y no esté relacionado con el orden especificado para
virsh. Para un control estricto sobre los pedidos, use un solo modo a la vez y repita el
mando.

reajustar dominio
Restablezca un dominio de inmediato sin que ningún invitado se apague. reajustar emula el reinicio de energía
en una máquina, donde todo el hardware invitado ve la línea RST configurada y se reinicia
estado interno

Nota: : Restablecer sin ningún apagado del sistema operativo invitado corre el riesgo de pérdida de datos.

restaurar estado-archivo [--bypass-caché] [--xml presentar] [{--corriendo | - pausado}]
Restaura un dominio de un Virsh guarde archivo de estado. Ver guarde para más información.

If --bypass-caché se especifica, la restauración evitará la caché del sistema de archivos, aunque
esto puede ralentizar la operación.

--xml presentar generalmente se omite, pero se puede utilizar para proporcionar un archivo XML alternativo para
usar en el huésped restaurado con cambios solo en las partes específicas del host del
XML de dominio. Por ejemplo, se puede utilizar para tener en cuenta las diferencias de nombres de archivos en
almacenamiento subyacente debido a instantáneas de disco tomadas después de que se guardó el invitado.

Normalmente, la restauración de una imagen guardada utilizará el estado grabado en la imagen guardada para
decidir entre correr o pausar; pasando ya sea el --corriendo or - pausado bandera será
Permitir anular el estado en el que se debe iniciar el dominio.

Nota: : Para evitar dañar el contenido del sistema de archivos dentro del dominio, no debe reutilizar
el archivo de estado guardado por un segundo restaurar a menos que también hayas revertido todo el almacenamiento
volúmenes de nuevo al mismo contenido que cuando se creó el archivo de estado.

guarde dominio estado-archivo [--bypass-caché] [--xml presentar] [{--corriendo | - pausado}] [--verboso]
Guarda un dominio en ejecución (RAM, pero no el estado del disco) en un archivo de estado para que pueda ser
restaurado más tarde. Una vez guardado, el dominio ya no se ejecutará en el sistema, por lo que
la memoria asignada para el dominio estará libre para que la utilicen otros dominios. Virsh
restaurar restaura desde este archivo de estado. Si --bypass-caché se especifica, el guardado
evite la caché del sistema de archivos, aunque esto puede ralentizar la operación.

El progreso se puede monitorear usando domjobinfo comando virsh y cancelado con
domjobabort comando (enviado por otra instancia de virsh). Otra opción es enviar SIGINT
(generalmente con "Ctrl-C") al proceso virsh en ejecución guarde mando. --verboso
el progreso de guardar.

Esto es aproximadamente equivalente a hacer una hibernación en una computadora en ejecución, con todas las
mismas limitaciones. Las conexiones de red abiertas pueden romperse tras la restauración, ya que TCP
los tiempos de espera pueden haber expirado.

--xml presentar generalmente se omite, pero se puede utilizar para proporcionar un archivo XML alternativo para
usar en el huésped restaurado con cambios solo en las partes específicas del host del
XML de dominio. Por ejemplo, se puede utilizar para tener en cuenta las diferencias de nombres de archivos que
están planificados para realizarse a través de instantáneas de disco del almacenamiento subyacente después de que el invitado
salvado.

Normalmente, la restauración de una imagen guardada decidirá entre ejecutar o pausar según la
indicar en el que se encontraba el dominio cuando se realizó el guardado; pasando ya sea el --corriendo or
- pausado La bandera permitirá anular qué estado el restaurar debería usar.

Los archivos de estado guardados en el dominio asumen que las imágenes de disco no cambiarán entre
punto de creación y restauración. Para un punto de restauración del sistema más completo, donde el disco
El estado se guarda junto con el estado de la memoria, consulte el instantánea familia de comandos.

guardar-imagen-definir presentar xml [{--corriendo | - pausado}]
Actualice el XML de dominio que se utilizará cuando presentar se utiliza más tarde en el restaurar
mando. los xml El argumento debe ser un nombre de archivo que contenga el XML alternativo, con
cambia solo en las partes específicas del host del XML de dominio. Por ejemplo, puede ser
utilizado para tener en cuenta las diferencias de nombres de archivos resultantes de la creación de instantáneas de disco de
almacenamiento subyacente después de que se guardó el invitado.

La imagen guardada registra si el dominio debe restaurarse a un estado en ejecución o en pausa.
estado. Normalmente, este comando no altera el estado registrado; pasando ya sea el
--corriendo or - pausado La bandera permitirá anular qué estado el restaurar debería usar.

guardar-imagen-dumpxml presentar [--información de seguridad]
Extraiga el XML de dominio que estaba en vigor en el momento en que se guardó el archivo de estado. presentar iba
creado con el guarde mando. Utilizando --información de seguridad también incluirá seguridad
información sensible.

guardar-imagen-editar presentar [{--corriendo | - pausado}]
Edite la configuración XML asociada con un archivo de estado guardado presentar creado por la guarde
mando.

La imagen guardada registra si el dominio debe restaurarse a un estado en ejecución o en pausa.
estado. Normalmente, este comando no altera el estado registrado; pasando ya sea el
--corriendo or - pausado La bandera permitirá anular qué estado el restaurar debería usar.

Esto es equivalente a:

virsh save-image-dumpxml archivo-estado> archivo-estado.xml
vi state-file.xml (o realice cambios con su otro editor de texto)
virsh guardar-imagen-definir estado-archivo estado-archivo-xml

excepto que realiza una comprobación de errores.

El editor utilizado puede ser proporcionado por las variables de entorno $ VISUAL o $ EDITOR, y
por defecto es "vi".

informaciónprogramada dominio [[--config] [--En Vivo] | [--Actual]] [[--colocar] parámetro = valor] ...
informaciónprogramada [--peso número] [--gorra número] dominio
Le permite mostrar (y configurar) los parámetros del programador de dominio. Los parámetros disponibles
para cada hipervisor son:

LXC (programador posix): cpu_shares, vcpu_period, vcpu_quota

QEMU / KVM (planificador posix): cpu_shares, vcpu_period, vcpu_quota, emulator_period,
emulator_quota

Xen (programador de crédito): peso, límite

ESX (programador de asignación): reserva, límite, recursos compartidos

If --En Vivo se especifica, establece la información del programador de un invitado en ejecución. Si --config is
especificado, afectará al próximo arranque de un invitado persistente. Si --Actual está especificado,
afectar el estado actual del huésped.

Nota: : El parámetro cpu_shares tiene un rango de valor válido de 0-262144; Valores negativos
se ajustan a positivo y los valores más grandes tienen un límite máximo. Por lo tanto, -1
es una abreviatura útil para 262144. En el kernel de Linux, los valores 0 y 1 son
convertido automáticamente a un valor mínimo de 2.

Nota: : Los parámetros de peso y límite se definen solo para el programador XEN_CREDIT y
son ahora OBSOLETO.

Nota: : Los parámetros vcpu_period / emulator_period tienen un rango de valor válido de
1000-1000000 o 0, y los parámetros vcpu_quota / emulator_quota tienen un valor válido
rango de 1000-18446744073709551 o menor que 0. El valor 0 para cualquiera de los parámetros es
lo mismo que no especificar ese parámetro.

captura de pantalla dominio [ruta del archivo de imagen] [--pantalla ID de pantalla]
Toma una captura de pantalla de una consola de dominio actual y la almacena en un archivo. Opcionalmente
si el hipervisor admite más pantallas para un dominio, ID de pantalla permite especificar cual
se capturará la pantalla. Es el número secuencial de pantalla. En caso de múltiples
tarjetas gráficas, las cabezas se enumeran antes que los dispositivos, por ejemplo, que tienen dos tarjetas gráficas,
ambos con cuatro cabezas, la ID de pantalla 5 se dirige a la segunda cabeza en la segunda tarjeta.

tecla Enviar dominio [--conjunto de códigos conjunto de códigos] [--hora de espera hora de espera] clave...
Analizar el clave secuencia como pulsaciones de teclas para enviar a dominio. Cada clave puede cualquiera
ser un valor numérico o un nombre simbólico del conjunto de códigos correspondiente. Si --hora de espera
se da, cada pulsación de tecla se mantendrá durante esa cantidad de milisegundos. El conjunto de códigos predeterminado
is Linux, pero el uso del --conjunto de códigos La opción permite elegir otros conjuntos de códigos.

Si se especifican varios códigos clave, todos se envían simultáneamente al invitado y
pueden recibirse en orden aleatorio. Si necesita distintas pulsaciones de teclas, debe utilizar
múltiples invocaciones de clave de envío.

Linux
Los valores numéricos son los definidos por el subsistema de eventos de entrada genérico de Linux.
Los nombres simbólicos coinciden con los nombres de macro de constantes de clave de Linux correspondientes.

xt Los valores numéricos son los definidos por el controlador de teclado XT original. No
se proporcionan nombres simbólicos

atset1
Los valores numéricos son los definidos por el controlador de teclado AT, conjunto 1 (también conocido como XT
conjunto compatible). Keycoes extendidos de atset1 puede diferir de los códigos de teclado extendidos en
el xt conjunto de códigos. No se proporcionan nombres simbólicos

atset2
Los valores numéricos son los definidos por el controlador de teclado AT, ajuste 2. No
se proporcionan nombres simbólicos

atset3
Los valores numéricos son los definidos por el controlador de teclado AT, conjunto 3 (también conocido como
Equipo compatible con PS / 2). No se proporcionan nombres simbólicos

os_x
Los valores numéricos son los definidos por el subsistema de entrada del teclado OS-X. los
Los nombres simbólicos coinciden con los nombres de macro de constantes de teclas correspondientes de OS-X

xt_kbd
Los valores numéricos son los definidos por el dispositivo KBD de Linux. Estas son una variante
en el conjunto de códigos XT original, pero a menudo con una codificación diferente para
códigos clave. No se proporcionan nombres simbólicos.

win32
Los valores numéricos son los definidos por el subsistema de entrada del teclado Win32. los
Los nombres simbólicos coinciden con los nombres de macro de constantes de teclas correspondientes de Win32

usb Los valores numéricos son los definidos por la especificación USB HID para teclado.
aporte. No se proporcionan nombres simbólicos

rfb Los valores numéricos son los definidos por la extensión RFB para enviar raw
códigos clave. Se trata de una variante del conjunto de códigos XT, pero los códigos de teclas extendidos tienen la
bit bajo del segundo conjunto de bytes, en lugar del bit alto del primer byte. No
Se proporcionan nombres simbólicos.

Ejemplos
# envíe tres trazos 'k', 'e', ​​'y', usando el conjunto de códigos xt. estas
# se presionan todos simultáneamente y pueden ser recibidos por el huésped
# En orden aleatorio
virsh clave de envío dom --codeset xt 37 18 21

# enviar un trazo 'right-ctrl + C'
virsh enviar-clave dom KEY_RIGHTCTRL KEY_C

# enviar una pestaña, retenida durante 1 segundo
virsh enviar-clave --holdtime 1000 0xf

enviar-señal-proceso ID de dominio pid signname
Enviar una señal signname al proceso identificado por pid corriendo en el dominio virtual
ID de dominio. pid es un ID de proceso en el espacio de nombres de dominio virtual.

La sección signname El argumento puede ser un número constante de señal entera, o uno de los
nombres simbólicos:

"nop", "hup", "int", "quit", "enfermo",
"trap", "abrt", "bus", "fpe", "kill",
"usr1", "segv", "usr2", "pipe", "alrm",
"término", "stkflt", "chld", "cont", "detener",
"tstp", "ttin", "ttou", "urg", "xcpu",
"xfsz", "vtalrm", "prof", "winch", "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"

El nombre del símbolo puede opcionalmente tener el prefijo 'sig' o 'sig_' y puede estar en
mayúsculas o minúsculas.

Ejemplos
virsh enviar-proceso-señal myguest 1 15
virsh enviar-proceso-señal myguest 1 término
virsh enviar-proceso-señal myguest 1 sigterm
virsh enviar-proceso-señal myguest 1 SIG_HUP

establecermem dominio tamaño [[--config] [--En Vivo] | [--Actual]]
Cambie la asignación de memoria para un dominio invitado. Si --En Vivo está especificado, realice una
globo de memoria de un invitado corriendo. Si --config está especificado, afectará al próximo arranque de
un invitado persistente. Si --Actual se especifica, afecta al estado actual del invitado. Ambos
--En Vivo y --config se pueden dar banderas, pero --Actual es exclusivo. Si no hay bandera
especificado, el comportamiento es diferente según el hipervisor.

tamaño es un entero escalado (ver NOTAS encima); por defecto es kibibytes (bloques de 1024
bytes) a menos que proporcione un sufijo (y el nombre de la opción anterior - kilobytes está disponible
como sinónimo obsoleto). Libvirt redondea al kibibyte más cercano. Algunos
Los hipervisores requieren una granularidad mayor que KiB, y las solicitudes que no son uniformes
se redondeará el múltiplo. Por ejemplo, vSphere / ESX redondea el parámetro hasta
mebibytes (1024 kibibytes).

Para Xen, solo puede ajustar la memoria de un dominio en ejecución si el dominio es
paravirtualizado o ejecutando el controlador de globo PV.

Para LXC, el valor que se establece es el valor de cgroups para limit_in_bytes o el valor máximo
cantidad de memoria de usuario (incluida la caché de archivos). Al ver la memoria dentro del
contenedor, este es el / proc / meminfo Valor "MemTotal". Al ver el valor de la
anfitrión, use el Virsh sintonía mando. Para ver la memoria actual en uso y
el valor máximo permitido para configurar la memoria, utilice el Virsh información dominante mando.

establecer contraseña de usuario dominio usuario la contraseña [--encriptado]
Establezca la contraseña para usuario cuenta en el dominio invitado.

If --encriptado se especifica, se supone que la contraseña ya está encriptada por el
método requerido por el sistema operativo invitado.

Para QEMU / KVM, esto requiere que el agente invitado esté configurado y en ejecución.

setmaxmem dominio tamaño [[--config] [--En Vivo] | [--Actual]]
Cambie el límite máximo de asignación de memoria para un dominio invitado. Si --En Vivo is
especificado, afecta a un invitado en ejecución. Si --config está especificado, afectará al próximo arranque de
un invitado persistente. Si --Actual se especifica, afecta al estado actual del invitado. Ambos
--En Vivo y --config se pueden dar banderas, pero --Actual es exclusivo. Si no hay bandera
especificado, el comportamiento es diferente según el hipervisor.

Algunos hipervisores como QEMU / KVM no admiten cambios en vivo (especialmente el aumento)
del límite máximo de memoria. Incluso los cambios de configuración persistentes pueden no ser
realizado con algunos hipervisores / configuración (por ejemplo, en dominios habilitados para NUMA en QEMU).
Para cambios de configuración complejos, use el comando editar en lugar).

tamaño es un entero escalado (ver NOTAS encima); por defecto es kibibytes (bloques de 1024
bytes) a menos que proporcione un sufijo (y el nombre de la opción anterior - kilobytes está disponible
como sinónimo obsoleto). Libvirt redondea al kibibyte más cercano. Algunos
Los hipervisores requieren una granularidad mayor que KiB, y las solicitudes que no son uniformes
se redondeará el múltiplo. Por ejemplo, vSphere / ESX redondea el parámetro hasta
mebibytes (1024 kibibytes).

sintonía dominio [- límite duro tamaño] [- límite suave tamaño] [--swap-hard-límite tamaño]
[- garantía mínima tamaño] [[--config] [--En Vivo] | [--Actual]]
Le permite mostrar o configurar los parámetros de la memoria del dominio. Sin banderas, la corriente
se muestran los ajustes; con una bandera, el límite apropiado se ajusta si es compatible con
el hipervisor. Soporte LXC y QEMU / KVM - límite duro, - límite suave y
--swap-hard-límite. - garantía mínima solo es compatible con el hipervisor ESX. Cada uno de
estos límites son números enteros escalados (ver NOTAS arriba), con un valor predeterminado de kibibytes
(bloques de 1024 bytes) si no hay sufijo presente. Libvirt redondea al más cercano
kibibyte. Algunos hipervisores requieren una granularidad mayor que KiB y solicitan que
no son un múltiplo par se redondearán. Por ejemplo, vSphere / ESX redondea el
parámetro hasta mebibytes (1024 kibibytes).

If --En Vivo se especifica, afecta a un invitado en ejecución. Si --config se especifica, afectan al
siguiente arranque de un invitado persistente. Si --Actual se especifica, afecta al invitado actual
estado. Ambos --En Vivo y --config se pueden dar banderas, pero --Actual es exclusivo. Si no
se especifica la bandera, el comportamiento es diferente según el hipervisor.

Para QEMU / KVM, los parámetros se aplican al proceso QEMU en su conjunto. Por tanto, cuando
contándolos, es necesario agregar RAM de invitado, RAM de video de invitado y algo de memoria
gastos generales de QEMU en sí. La última pieza es difícil de determinar, por lo que es necesario adivinar y
tratar.

Para LXC, el valor hard_limit mostrado es la configuración de memoria actual del XML o
los resultados de un Virsh establecermem mando.

- límite duro
La memoria máxima que puede usar el huésped.

- límite suave
El límite de memoria que se debe aplicar durante la contención de la memoria.

--swap-hard-límite
La memoria máxima más el intercambio que puede usar el huésped. Esto tiene que ser más que difícil.
valor límite proporcionado.

- garantía mínima
La asignación de memoria mínima garantizada para el invitado.

Especificar -1 como valor para estos límites se interpreta como ilimitado.

blkiotune dominio [--peso peso] [--dispositivo-pesos pesos del dispositivo]
[--dispositivo-lectura-iops-sec dispositivo-lectura-iops-sec] [--dispositivo-escritura-iops-sec dispositivo-escritura-iops-
AMF] [--dispositivo-lectura-bytes-seg dispositivo-lectura-bytes-seg] [--dispositivo-escritura-bytes-seg dispositivo-
escritura-bytes-seg] [[--config] [--En Vivo] | [--Actual]]
Muestra o establece los parámetros de blkio. Soportes QEMU / KVM --peso. --peso está en el rango
[100, 1000]. Después del kernel 2.6.39, el valor podría estar en el rango [10, 1000].

pesos del dispositivo es una sola cadena que enumera uno o más pares de dispositivo / peso, en el
formato de / ruta / a / dispositivo, peso, / ruta / a / dispositivo, peso. Cada peso está en el rango
[100, 1000], [10, 1000] después del kernel 2.6.39, o el valor 0 para eliminar ese dispositivo de
listados por dispositivo. Solo se modifican los dispositivos enumerados en la cadena; cualquier existente
los pesos por dispositivo para otros dispositivos permanecen sin cambios.

dispositivo-lectura-iops-sec es una sola cadena que enumera uno o más dispositivos / read_iops_sec
pares, int el formato de / ruta / a / dispositivo, read_iops_sec, / ruta / a / dispositivo, read_iops_sec.
Cada read_iops_sec es un número cuyo tipo es unsigned int, valor 0 para eliminar eso
dispositivo de la lista por decice. Solo se modifican los dispositivos enumerados en la cadena;
cualquier read_iops_sec existente por dispositivo para otros dispositivos permanece sin cambios.

dispositivo-escritura-iops-sec es una sola cadena que enumera uno o más dispositivos / write_iops_sec
pares, en el formato de
/ ruta / a / dispositivo, write_iops_sec, / ruta / a / dispositivo, write_iops_sec. Cada write_iops_sec es
un número cuyo tipo es unsigned int, valor 0 para eliminar ese dispositivo de por decice
listado. Solo se modifican los dispositivos enumerados en la cadena; cualquier por dispositivo existente
write_iops_sec para otros dispositivos permanece sin cambios.

dispositivo-lectura-bytes-seg es una sola cadena que enumera uno o más dispositivos / read_bytes_sec
pares, en el formato de
/ ruta / a / dispositivo, read_bytes_sec, / ruta / a / dispositivo, read_bytes_sec. Cada read_bytes_sec es
un número cuyo tipo es unsigned long long, valor 0 para eliminar ese dispositivo de
listado de decice. Solo se modifican los dispositivos enumerados en la cadena; cualquier per-
device read_bytes_sec para otros dispositivos permanece sin cambios.

dispositivo-escritura-bytes-seg es una sola cadena que enumera uno o más device / write_bytes_sec
pares, en el formato de
/ ruta / a / dispositivo, write_bytes_sec, / ruta / a / dispositivo, write_bytes_sec. Cada write_bytes_sec
es un número cuyo tipo es unsigned long long, valor 0 para eliminar ese dispositivo de
listado de decice. Solo se modifican los dispositivos enumerados en la cadena; cualquier per-
device write_bytes_sec para otros dispositivos permanecen sin cambios.

If --En Vivo se especifica, afecta a un invitado en ejecución. Si --config se especifica, afectan al
siguiente arranque de un invitado persistente. Si --Actual se especifica, afecta al invitado actual
estado. Ambos --En Vivo y --config se pueden dar banderas, pero --Actual es exclusivo. Si no
se especifica la bandera, el comportamiento es diferente según el hipervisor.

setvcpus dominio contar [--máximo] [[--config] [--En Vivo] | [--Actual]] [--huésped]
Cambie la cantidad de CPU virtuales activas en un dominio invitado. Por defecto, este comando
funciona en dominios invitados activos. Para cambiar la configuración de un dominio invitado inactivo,
utilice el --config bandera.

La sección contar El valor puede estar limitado por el host, el hipervisor o un límite proveniente del
descripción original del dominio invitado. Para Xen, solo puede ajustar el virtual
CPU de un dominio en ejecución si el dominio está paravirtualizado.

Si --config se especifica la bandera, el cambio se realiza en la configuración XML almacenada
para el dominio invitado, y solo entrará en vigencia la próxima vez que se inicie el dominio invitado.

If --En Vivo se especifica, el dominio invitado debe estar activo y el cambio se lleva a cabo
inmediatamente. Ambos --config y --En Vivo Las banderas pueden especificarse juntas si
soportado por el hipervisor. Si este comando se ejecuta antes de que el invitado haya terminado
al arrancar, es posible que el invitado no pueda procesar el cambio.

If --Actual se especifica, afecta al estado actual del invitado.

Cuando no se dan banderas, el --En Vivo se asume la bandera y el dominio invitado debe ser
activo. En esta situación, depende del hipervisor si el --config bandera es
También se asume, y por lo tanto, si la configuración XML se ajusta para hacer que el
cambio persistente.

If --huésped se especifica, entonces el recuento de cpus se modifica en el invitado en lugar de
el hipervisor. Esta bandera solo se puede usar para dominios activos y puede requerir un agente invitado
a configurar en el invitado.

La sección --máximo La bandera controla el número máximo de CPU virtuales que se pueden conectar en caliente.
la próxima vez que se inicie el dominio. Como tal, solo debe usarse con el --config
bandera, y no con la --En Vivo o en el --Actual bandera.

cierre dominio [--modo LISTA DE MODOS]
Cierra con gracia un dominio. Esto se coordina con el sistema operativo del dominio para realizar
cierre ordenado, por lo que no hay garantía de que tenga éxito, y puede tomar un
período de tiempo variable según los servicios que se deben cerrar en el dominio.

El comportamiento exacto de un dominio cuando se apaga lo establece el en_apagado parámetro
en la definición XML del dominio.

If dominio es transitorio, los metadatos de las instantáneas se perderán una vez que el invitado
deja de ejecutarse, pero el contenido de la instantánea aún existe y un nuevo dominio con el mismo
nombre y UUID pueden restaurar los metadatos de la instantánea con creación de instantánea.

De forma predeterminada, el hipervisor intentará elegir un método de apagado adecuado. Para especificar un
método alternativo, el --modo El parámetro puede especificar una lista separada por comas que
incluye "acpi", "agente", "initctl", "señal" y "paravirt". El orden en que
Los conductores intentarán que cada modo no esté definido y no esté relacionado con el orden especificado para
virsh. Para un control estricto sobre los pedidos, use un solo modo a la vez y repita el
mando.

comienzo nombre-de-dominio-o-uuid [--consola] [- pausado] [--autodestruir] [--bypass-caché]
[--force-arranque] [--pass-fds NUEVO MÉJICO,...]
Inicie un dominio inactivo (definido previamente), ya sea desde el último gestionado guardar estado,
o mediante un arranque nuevo si no hay un estado Managedsave presente. El dominio se pausará si
el - pausado la opción es utilizada y respaldada por el controlador; de lo contrario, estará funcionando.
If --consola se solicita, adjuntar a la consola después de la creación. Si --autodestruir is
solicitado, el huésped será automáticamente destruido cuando virsh cierre su
conexión a libvirt, o salidas de otro modo. Si --bypass-caché se especifica, y
estado administradosave existe, la restauración evitará la caché del sistema de archivos, aunque esto
puede ralentizar la operación. Si --force-arranque se especifica, luego cualquier estado de Managedsave
se descarta y se produce una nueva bota.

If --pass-fds se especifica, el argumento es una lista separada por comas de archivos abiertos
descriptores que deben transmitirse al huésped. Los descriptores de archivo se volverán a
numerado en el invitado, a partir de 3. Esto solo es compatible con contenedores basados
virtualización.

suspender dominio
Suspender un dominio en ejecución. Se guarda en la memoria pero ya no se programará.

currículum dominio
Saca un dominio del estado suspendido. Esto permitirá una suspensión previamente
dominio para que ahora sea elegible para la programación por el hipervisor subyacente.

dompmsuspender dominio dirigidos [--duración]
Suspender un dominio en ejecución en uno de estos estados (posible dirigidos valores):
mem equivalente del estado S3 ACPI
disco equivalente al estado S4 ACPI
La RAM híbrida se guarda en el disco pero no se apaga

La sección --duración El argumento especifica el número de segundos antes de que se despierte el dominio.
después de que fue suspendido (ver también despertar). El valor predeterminado es 0 para suspensión ilimitada
tiempo. (Esta función no es compatible actualmente con ningún controlador de hipervisor y 0 debería ser
usó.).

Tenga en cuenta que este comando requiere un agente invitado configurado y ejecutándose en el dominio
SO invitado.

Tenga en cuenta que al menos para QEMU, el proceso del dominio finalizará cuando el objetivo
se utiliza el disco y se iniciará un nuevo proceso cuando se le solicite a libvirt que active el
dominio. Como resultado de esto, cualquier cambio en el tiempo de ejecución, como la conexión en caliente del dispositivo o la memoria
configuraciones, se pierden a menos que dichos cambios se hayan realizado con --config bandera.

despertar dominio
Despertar un dominio del estado pmsuspended (ya sea suspendido por dompmsuspend o desde el
propio huésped). Inyecta un despertador en el huésped que está en estado suspendido, en lugar de
que esperar a que transcurra la duración solicitada anteriormente (si corresponde). Esta operacion
no necesariamente falla si el dominio se está ejecutando.

ttyconsola dominio
Salida del dispositivo utilizado para la consola TTY del dominio. Si la información no es
disponible, los procesos proporcionarán un código de salida de 1.

indefinir dominio [--administrado-guardar] [--snapshots-metadatos] [--nvram] [{--almacenamiento volúmenes |
- eliminar-todo-almacenamiento [- eliminar-instantáneas]} - almacenamiento de toallitas]
Anula la definición de un dominio. Si el dominio se está ejecutando, esto lo convierte en un dominio transitorio,
sin detenerlo. Si el dominio está inactivo, se elimina la configuración del dominio.

La sección --administrado-guardar bandera garantiza que cualquier imagen guardada gestionada (consulte la gestionado guardar
comando) también se limpia. Sin la bandera, intenta anular la definición de un dominio con un
la imagen guardada administrada fallará.

La sección --snapshots-metadatos bandera garantiza que cualquier instantánea (ver la lista de instantáneas
comando) también se limpian al eliminar la definición de un dominio inactivo. Sin la bandera
los intentos de anular la definición de un dominio inactivo con metadatos de instantáneas fallarán. Si el
El dominio está activo, esta bandera se ignora.

La sección --nvram flag asegura que ningún archivo nvram (/ domain / os / nvram /) se quede atrás. Si el
dominio tiene un archivo nvram y la bandera se omite, la indefinición fallará.

La sección --almacenamiento bandera toma un parámetro volúmenes, que es una lista separada por comas de
nombres de destino de volumen o rutas de origen de los volúmenes de almacenamiento que se eliminarán junto con el
dominio indefinido. Los volúmenes pueden no estar definidos y, por lo tanto, eliminarse solo en dominios inactivos.
La eliminación del volumen solo se intenta después de que el dominio no está definido; si no todos los
los volúmenes solicitados podrían eliminarse, el mensaje de error indica lo que aún queda
detrás. Si no se encuentra una ruta de volumen en la definición de dominio, se trata como si el
el volumen se eliminó correctamente. Solo los volúmenes administrados por libvirt en grupos de almacenamiento pueden
ser eliminado de esta manera. (Ver lista de domblk para obtener una lista de los nombres de destino asociados a un
dominio). Ejemplo: --storage vda, / ruta / a / storage.img

La sección - eliminar-todo-almacenamiento bandera especifica que todos los volúmenes de almacenamiento del dominio
debe ser eliminado.

La sección - eliminar-instantáneas bandera especifica que cualquier instantánea asociada con el almacenamiento
el volumen también debe eliminarse. Requiere el - eliminar-todo-almacenamiento bandera para ser
previsto. No todos los controladores de almacenamiento admiten esta opción, actualmente solo rbd.

La bandera - almacenamiento de toallitas especifica que los volúmenes de almacenamiento deben limpiarse antes
eliminación.

NOTA: Para un dominio inactivo, el nombre de dominio o UUID debe usarse como el dominio.

cuenta vcpu dominio [{--máximo | --activo} {--config | --En Vivo | --Actual}] [--huésped]
Imprime información sobre los recuentos de cpu virtuales de los dominio. Si no hay banderas
especificado, todos los recuentos posibles se enumeran en una tabla; de lo contrario, la salida es limitada
a solo el valor numérico solicitado. Por razones históricas, la tabla enumera los
etiqueta "actual" en las filas que se pueden consultar de forma aislada a través de la --activo bandera,
en lugar de relacionarse con el --Actual bandera.

--máximo solicita información sobre el límite máximo de vcpus que un dominio puede agregar a través de
setvcpus, mientras --activo muestra el uso actual; estas dos banderas no pueden ser ambas
especificado. --config requiere un dominio persistente y solicita información sobre
la próxima vez que se inicie el dominio, --En Vivo requiere un dominio y listas en ejecución
valores actuales, y --Actual consultas según el estado actual del dominio
(correspondiente a --En Vivo si está corriendo, o --config si está inactivo); estas tres banderas son
mutuamente excluyentes.

If --huésped se especifica, entonces el recuento de cpus se informa desde la perspectiva de
el invitado. Esta bandera solo se puede usar para dominios activos y puede requerir que el agente invitado sea
configurado en el invitado.

vcpuinfo dominio [--lindo]
Devuelve información básica sobre las CPU virtuales del dominio, como la cantidad de CPU virtuales, la
tiempo de ejecución, la afinidad con los procesadores físicos.

Con --lindo, las afinidades de la cpu se muestran como rangos.

vcpupin dominio [CPU] [pulista] [[--En Vivo] [--config] | [--Actual]]
Consulte o cambie la fijación de las VCPU de dominio para alojar CPU físicas. Para anclar un solo
CPU, especificar pulista; de lo contrario, puede consultar uno CPU u omitir CPU para listar todo en
una vez.

pulista es una lista de números de CPU físicos. Su sintaxis es una lista separada por comas y una
También se puede permitir el marcado especial con '-' y '^' (por ejemplo, '0-4', '0-3, ^ 2'). Los '-'
denota el rango y el '^' denota exclusivo. Para fijar el CPU a todo fisico
cpus especifique 'r' como pulista. Si --En Vivo se especifica, afecta a un invitado en ejecución. Si
--config se especifica, afectará al próximo arranque de un invitado persistente. Si --Actual is
especificado, afecta al estado actual del huésped. Ambos --En Vivo y --config banderas pueden ser
dado si pulista está presente, pero --Actual es exclusivo. Si no se especifica ninguna bandera,
el comportamiento es diferente según el hipervisor.

Nota: : La expresión se evalúa secuencialmente, por lo que "0-15, ^ 8" es idéntico a
"9-14,0-7,15" pero no idéntico a "^ 8,0-15".

emulador dominio [pulista] [[--En Vivo] [--config] | [--Actual]]
Consulte o cambie la fijación de los subprocesos del emulador del dominio para alojar CPU físicas.

See vcpupin para pulista.

If --En Vivo se especifica, afecta a un invitado en ejecución. Si --config se especifica, afectan al
siguiente arranque de un invitado persistente. Si --Actual se especifica, afecta al invitado actual
estado. Ambos --En Vivo y --config se pueden dar banderas si pulista está presente, pero
--Actual es exclusivo. Si no se especifica ninguna bandera, el comportamiento es diferente dependiendo de
hipervisor.

vncdisplay dominio
Muestra la dirección IP y el número de puerto para la pantalla VNC. Si la información no es
disponible, los procesos proporcionarán un código de salida de 1.

DISPOSITIVO COMANDOS

Los siguientes comandos manipulan dispositivos asociados a dominios. los dominio puede ser
especificado como un entero corto, un nombre o un UUID completo. Para comprender mejor los valores
permitido como opciones para el comando leyendo la documentación en
<http://libvirt.org/formatdomain.html> en el formato de las secciones del dispositivo para obtener la
conjunto más preciso de valores aceptados.

adjuntar-dispositivo dominio ARCHIVO [[[--En Vivo] [--config] | [--Actual]] | [--persistente]]
Adjunte un dispositivo al dominio, usando una definición de dispositivo en un archivo XML usando un dispositivo
elemento de definición como o como elemento de nivel superior. Ver el
documentación enhttp://libvirt.org/formatdomain.html#elementsDevices> para obtener más información
Formato XML libvirt para un dispositivo. Si --config se especifica el comando altera el
configuración de dominio persistente con el dispositivo adjunto que entrará en vigor la próxima vez
libvirt inicia el dominio. Para dispositivos cdrom y disquete, este comando solo reemplaza
los medios dentro de un dispositivo existente; Considere usar dispositivo de actualización para este uso. Para
dispositivos host de paso, consulte también nodedev-separar, necesario si el dispositivo PCI no
utilizar el modo gestionado.

If --En Vivo se especifica, afecta a un dominio en ejecución. Si --config se especifica, afectan al
siguiente inicio de un dominio persistente. Si --Actual se especifica, afecta la corriente
estado del dominio. Ambos --En Vivo y --config se pueden dar banderas, pero --Actual is
exclusivo. Cuando no se especifica ninguna marca, se utiliza una API heredada cuyo comportamiento depende de la
controlador de hipervisor.

Por motivos de compatibilidad, --persistente se comporta como --config para un dominio sin conexión,
y, como --En Vivo --config para un dominio en ejecución.

Nota: : el uso de archivos XML de definición de dispositivo parcial puede dar lugar a resultados inesperados como
algunos campos pueden generarse automáticamente y, por lo tanto, coincidir con dispositivos distintos de los esperados.

adjuntar-disco dominio fuente dirigidos [[[--En Vivo] [--config] | [--Actual]] | [--persistente]]
[--bus objetivo horarios] [--conductor conductor] [--subcontrolador subcontrolador] [--iothread hilo] [--cache
cache] [--escribe tipo] [--modo modo] [--tipo de fuente tipo de fuente] [--de serie de serie] [--wwn wwn]
[--rawio] [--Dirección de facturación] [--multifunción] [--imprimir-xml]
Adjunte un nuevo dispositivo de disco al dominio. fuente es la ruta para los archivos y dispositivos.
dirigidos controla el bus o dispositivo bajo el cual el disco está expuesto al sistema operativo invitado. Eso
indica el nombre del dispositivo "lógico"; el opcional bus de destino atributo especifica el
tipo de dispositivo de disco para emular; Los valores posibles son específicos del controlador, con valores típicos
valores siendo ide, scsi, virtuoso, xen, usb, sata o sd, si se omite, el tipo de bus es
inferido del estilo del nombre del dispositivo (por ejemplo, un dispositivo llamado 'sda' normalmente
exportarse mediante un bus SCSI). conductor puede ser presentar, Central profunda or físico para el hipervisor Xen
dependiendo del tipo de acceso; o qemu para el emulador QEMU. Más detalles a
el controlador se puede pasar usando subcontrolador. Para Xen subcontrolador puede ser AIO, mientras que para QEMU
El subcontrolador debe coincidir con el formato de la fuente del disco, como crudo or qvaca2.
El hipervisor predeterminado se utilizará si subcontrolador no se especifica. Sin embargo, el valor predeterminado
puede no ser correcto, esp. para QEMU ya que por razones de seguridad está configurado para no
detectar formatos de disco. tipo puede indicar lun, cdrom or flexible como alternativa a la
disco predeterminado, aunque este uso solo reemplaza el medio dentro del virtual existente
cdrom o dispositivo de disquete; Considere usar dispositivo de actualización para este uso en su lugar. modo can
especificar los dos modos específicos solo lectura or compartible. tipo de fuente puede indicar el tipo
de fuente (bloque | archivo) cache puede ser uno de los siguientes: "predeterminado", "ninguno", "escritura directa",
"writeback", "directsync" o "inseguro". hilo es el número dentro del rango de
IOThreads de dominio a los que se puede adjuntar este disco (solo QEMU). de serie es la serie
del dispositivo de disco. wwn es el wwn del dispositivo de disco. rawio indica que el disco necesita rawio
capacidad. de facturación es la dirección del dispositivo de disco en forma de
pci: domain.bus.slot.function, scsi: controller.bus.unit, ide: controller.bus.unit o
ccw: cssid.ssid.devno. Los dispositivos Virtio-ccw deben tener su cssid configurado en 0xfe.
multifunción indica que la dirección pci especificada es una dirección de dispositivo pci multifunción.

If --imprimir-xml se especifica, entonces el XML del disco que se adjuntará es
impreso en su lugar.

If --En Vivo se especifica, afecta a un dominio en ejecución. Si --config se especifica, afectan al
siguiente inicio de un dominio persistente. Si --Actual se especifica, afecta la corriente
estado del dominio. Ambos --En Vivo y --config se pueden dar banderas, pero --Actual is
exclusivo. Cuando no se especifica ninguna marca, se utiliza una API heredada cuyo comportamiento depende de la
controlador de hipervisor.

Por motivos de compatibilidad, --persistente se comporta como --config para un dominio sin conexión,
y, como --En Vivo --config para un dominio en ejecución. Igualmente, --compartible es un alias para
--modo compartible.

adjuntar interfaz dominio tipo fuente [[[--En Vivo] [--config] | [--Actual]] | [--persistente]]
[--objetivo dirigidos] [--Mac Mac] [--guión guión] [--modelo modelo] [--entrante
promedio, pico, explosión, piso] [--saliente promedio, pico, ráfaga] [--administrado] [--imprimir-xml]
Adjunte una nueva interfaz de red al dominio.

tipo puede ser uno de los:

del sistema, para indicar la conexión a través de una red virtual libvirt,

puente para indicar la conexión a través de un dispositivo puente en el host,

de reservas para indicar la conexión directamente a una de las interfaces de red del host o
puentes

desarrollador de host para indicar la conexión mediante un paso a través de un dispositivo PCI en el host.

fuente indica el origen de la conexión. La fuente depende del tipo de
interfaz:

del sistema, nombre de la red virtual,

puente el nombre del dispositivo puente,

de reservas el nombre de la interfaz o puente del host,

desarrollador de host la dirección PCI de la interfaz del host formateada como
dominio: bus: ranura.función.

--objetivo se utiliza para especificar el dispositivo tap / macvtap que se utilizará para conectar el dominio a
la fuente. Los nombres que comienzan con 'vnet' se consideran generados automáticamente y se
se borra / se regenera cada vez que se conecta la interfaz.

--Mac especifica la dirección MAC de la interfaz de red; si una dirección MAC no es
dado, se generará automáticamente una nueva dirección (y se almacenará en el
configuración si se proporciona "--config" en la línea de comando).

--guión se utiliza para especificar una ruta a un script personalizado que se llamará mientras se adjunta a
un puente: se llamará en lugar del script predeterminado, no además de él.
Esto es válido solo para interfaces de puente type y solo para dominios Xen.

--modelo especifica el modelo de dispositivo de red que se presentará al dominio.

--entrante y --saliente controlar el ancho de banda de la interfaz. Al menos uno de
el promedio, piso debe especificarse el par. Los otros dos pico y explosión son opcionales,
así que "promedio, pico", "promedio ,, ráfaga", "promedio ,,, piso", "promedio" y ",,, piso" son
también legal. Valores para promedio, piso y pico se expresan en kilobytes por segundo,
mientras explosión se expresa en kilobytes en una sola ráfaga a pico velocidad como se describe en
la documentación XML de red enhttp://libvirt.org/formatnetwork.html#elementQoS>.

--administrado es utilizable solo para desarrollador de host escribe y le dice a libvirt que la interfaz debe
ser administrado, lo que significa que libvirt lo separa y lo vuelve a conectar desde / al host.

If --imprimir-xml se especifica, entonces el XML de la interfaz que se adjuntará es
impreso en su lugar.

If --En Vivo se especifica, afecta a un dominio en ejecución. Si --config se especifica, afectan al
siguiente inicio de un dominio persistente. Si --Actual se especifica, afecta la corriente
estado del dominio. Ambos --En Vivo y --config se pueden dar banderas, pero --Actual is
exclusivo. Cuando no se especifica ninguna marca, se utiliza una API heredada cuyo comportamiento depende de la
controlador de hipervisor.

Por motivos de compatibilidad, --persistente se comporta como --config para un dominio sin conexión,
y, como --En Vivo --config para un dominio en ejecución.

Nota: : el valor objetivo opcional es el nombre de un dispositivo que se creará como back-end
en el nodo. Si no se proporciona, se creará un dispositivo llamado "vnetN" o "vifN"
automáticamente.

desconectar-dispositivo dominio ARCHIVO [[[--En Vivo] [--config] | [--Actual]] | [--persistente]]
Desconecta un dispositivo del dominio, toma el mismo tipo de descripciones XML que el comando
adjuntar-dispositivo. Para dispositivos host de acceso directo, consulte también nodedev-reconectar, necesario si el
el dispositivo no usa el modo administrado.

Nota: : La descripción XML proporcionada del dispositivo debe ser tan específica como su
definición en el dominio XML. El conjunto de atributos que se utilizan para hacer coincidir el dispositivo son
interno a los controladores. Usar una definición parcial o intentar desconectar un dispositivo
que no está presente en el dominio XML, pero comparte algunos atributos específicos con uno
presente, puede dar lugar a resultados inesperados.

If --En Vivo se especifica, afecta a un dominio en ejecución. Si --config se especifica, afectan al
siguiente inicio de un dominio persistente. Si --Actual se especifica, afecta la corriente
estado del dominio. Ambos --En Vivo y --config se pueden dar banderas, pero --Actual is
exclusivo. Cuando no se especifica ninguna marca, se utiliza una API heredada cuyo comportamiento depende de la
controlador de hipervisor.

Por motivos de compatibilidad, --persistente se comporta como --config para un dominio sin conexión,
y, como --En Vivo --config para un dominio en ejecución.

Tenga en cuenta que las versiones anteriores de virsh usaban --config como un alias para --persistente.

separar-disco dominio dirigidos [[[--En Vivo] [--config] | [--Actual]] | [--persistente]]
Desconecte un dispositivo de disco de un dominio. los dirigidos es el dispositivo visto desde el dominio.

If --En Vivo se especifica, afecta a un dominio en ejecución. Si --config se especifica, afectan al
siguiente inicio de un dominio persistente. Si --Actual se especifica, afecta la corriente
estado del dominio. Ambos --En Vivo y --config se pueden dar banderas, pero --Actual is
exclusivo. Cuando no se especifica ninguna marca, se utiliza una API heredada cuyo comportamiento depende de la
controlador de hipervisor.

Por motivos de compatibilidad, --persistente se comporta como --config para un dominio sin conexión,
y, como --En Vivo --config para un dominio en ejecución.

Tenga en cuenta que las versiones anteriores de virsh usaban --config como un alias para --persistente.

desconectar-interfaz dominio tipo [--Mac Mac] [[[--En Vivo] [--config] | [--Actual]] |
[--persistente]]
Desconecte una interfaz de red de un dominio. tipo pueden ser cualquiera de los dos del sistema, para indicar un
dispositivo de red físico o puente para indicar un puente a un dispositivo. Es recomendado
utilizar el Mac opción para distinguir entre las interfaces si hay más de una
presente en el dominio.

If --En Vivo se especifica, afecta a un dominio en ejecución. Si --config se especifica, afectan al
siguiente inicio de un dominio persistente. Si --Actual se especifica, afecta la corriente
estado del dominio. Ambos --En Vivo y --config se pueden dar banderas, pero --Actual is
exclusivo. Cuando no se especifica ninguna marca, se utiliza una API heredada cuyo comportamiento depende de la
controlador de hipervisor.

Por motivos de compatibilidad, --persistente se comporta como --config para un dominio sin conexión,
y, como --En Vivo --config para un dominio en ejecución.

Tenga en cuenta que las versiones anteriores de virsh usaban --config como un alias para --persistente.

dispositivo de actualización dominio presentar [--fuerza] [[[--En Vivo] [--config] | [--Actual]] | [--persistente]]
Actualizar las características de un dispositivo asociado a dominio, basado en el dispositivo
definición en un XML presentar. --fuerza La opción se puede usar para forzar la actualización del dispositivo,
por ejemplo, para expulsar un CD-ROM incluso si está bloqueado / montado en el dominio. Ver el
documentación enhttp://libvirt.org/formatdomain.html#elementsDevices> para obtener más información
Formato XML libvirt para un dispositivo.

If --En Vivo se especifica, afecta a un dominio en ejecución. Si --config se especifica, afectan al
siguiente inicio de un dominio persistente. Si --Actual se especifica, afecta la corriente
estado del dominio. Ambos --En Vivo y --config se pueden dar banderas, pero --Actual is
exclusivo. No especificar ninguna bandera es lo mismo que especificar --Actual.

Por motivos de compatibilidad, --persistente se comporta como --config para un dominio sin conexión,
y, como --En Vivo --config para un dominio en ejecución.

Tenga en cuenta que las versiones anteriores de virsh usaban --config como un alias para --persistente.

Nota: : el uso de archivos XML de definición de dispositivo parcial puede dar lugar a resultados inesperados como
algunos campos pueden generarse automáticamente y, por lo tanto, coincidir con dispositivos distintos de los esperados.

medios de cambio dominio camino [--expulsar] [--insertar] [--actualizar] [fuente] [--fuerza] [[--En Vivo]
[--config] | [--Actual]] [--imprimir-xml] [--cuadra]
Cambie el medio de CDROM o disquetera. camino puede ser la ruta totalmente calificada o la
nombre de destino único ( ) del dispositivo de disco. fuente especifica la ruta
de los medios a insertar o actualizar. Bandera --cuadra permite configurar el tipo de respaldo en
caso de que se utilice un dispositivo de bloque como medio para el CDROM o la unidad de disquete en lugar de un archivo.

--expulsar indica que el medio será expulsado. --insertar indica que los medios serán
insertado. fuente debe especificarse. Si el dispositivo tiene fuente (p. Ej.
file = 'media'>), y fuente no está especificado, --actualizar es igual a --expulsar. Si el
dispositivo no tiene fuente, y fuente está especificado, --actualizar es igual a --insertar. Si el
dispositivo tiene fuente, y fuente está especificado, --actualizar se comporta como una combinación de
--expulsar y --insertar. Si ninguno de --expulsar, --insertar y --actualizar está especificado,
--actualizar se utiliza de forma predeterminada. los --fuerza La opción se puede utilizar para forzar el cambio de papel.
If --En Vivo se especifica, altere la configuración en vivo del invitado en ejecución. Si --config is
especificado, alterar la configuración persistente, efecto observado en el próximo arranque. --Actual
puede ser uno o ambos de vivir y config, depende de la implementación del hipervisor.
Ambos --En Vivo y --config se pueden dar banderas, pero --Actual es exclusivo. Si no hay bandera
especificado, el comportamiento es diferente según el hipervisor. Si --imprimir-xml is
especificado, el XML que se utilizaría para cambiar el medio se imprime en lugar de cambiar
los medios de comunicación.

NODEDEV COMANDOS

Los siguientes comandos manipulan los dispositivos host que están destinados a pasar a
dominios invitados a través de elementos en un dominio sección. Una clave de dispositivo de nodo
generalmente se especifica por el nombre del bus seguido de su dirección, utilizando guiones bajos entre
todos los componentes, como pci_0000_00_02_1, usb_1_5_3 o net_eth1_00_27_13_6a_fe_00. los
lista de desarrollo de nodos da la lista completa de dispositivos host que son conocidos por libvirt, aunque esto
incluye dispositivos que no se pueden asignar a un invitado (por ejemplo, intentar desconectar el
Dispositivo PCI que controla el controlador del disco duro del host donde las imágenes del disco del invitado
live podría hacer que el sistema host se bloquee o se reinicie).

Para obtener más información sobre la definición de dispositivo de nodo, consulte:http://libvirt.org/formatnode.html>.

Los dispositivos de paso a través no pueden ser utilizados simultáneamente por el host y sus dominios invitados, ni
por varios invitados activos a la vez. Si el La descripción de un dispositivo PCI incluye
el atributo administrado = 'sí'y el controlador del hipervisor lo admite, entonces el dispositivo está en
modo administrado, y los intentos de usar ese dispositivo de paso en un invitado activo
comportarse automáticamente como si nodedev-separar (inicio de invitado, dispositivo de conexión en caliente) y nodev-
volver a colocar (parada de invitado, desconexión en caliente del dispositivo) en los puntos correctos. Si un dispositivo PCI
no está marcado como administrado, entonces debe desconectarse manualmente antes de que los invitados puedan usarlo, y
volver a adjuntar manualmente para ser devuelto al host. Además, si un dispositivo se desconecta manualmente,
entonces el host no recupera el control del dispositivo sin una reconexión correspondiente, incluso si
los invitados usan el dispositivo en modo administrado.

nodedev-crear ARCHIVO
Cree un dispositivo en el nodo host que luego pueda asignarse a máquinas virtuales.
Normalmente, libvirt puede determinar automáticamente qué nodos de host están disponibles
para su uso, pero esto permite el registro de hardware de host que libvirt no
detectar automáticamente. presentar contiene xml para un nivel superior descripción de un
dispositivo de nodo.

nododev-destruir de dispositivos
Destruye (detén) un dispositivo en el host. de dispositivos puede ser el nombre del dispositivo o el par wwn en
Formato "wwnn, wwpn" (solo funciona para vHBA actualmente). Tenga en cuenta que esto hace que libvirt se cierre
administrar un dispositivo host, e incluso puede hacer que ese dispositivo sea inutilizable por el resto de los
host físico hasta un reinicio.

nodedev-separar nodev [--conductor controlador_backend]
Despegar nodev del anfitrión, para que los huéspedes puedan utilizarlo de forma segura a través de
pasar por. Esto se invierte con nodedev-reconectar, y se hace automáticamente para
dispositivos gestionados. Por motivos de compatibilidad, este comando también se puede escribir
nodedev-separar.

Los diferentes controladores de backend esperan que el dispositivo esté vinculado a diferentes dispositivos ficticios.
Por ejemplo, el controlador de backend "kvm" de QEMU (el predeterminado) espera que el dispositivo esté vinculado
a pci-stub, pero su controlador de backend "vfio" espera que el dispositivo esté vinculado a vfio-pci.
La sección --conductor El parámetro se puede utilizar para especificar el controlador de backend deseado.

nodedev-dumpxml de dispositivos
Volcar un Representación XML para el dispositivo de nodo dado, incluidos los
información como el nombre del dispositivo, qué bus es propietario del dispositivo, el proveedor y la identificación del producto,
y cualquier capacidad del dispositivo utilizable por libvirt (como si el reinicio del dispositivo es
soportado). de dispositivos puede ser un nombre de dispositivo o un par wwn en formato "wwnn, wwpn" (solo
funciona para HBA).

lista de desarrollo de nodos tapa --árbol
Enumere todos los dispositivos disponibles en el nodo que libvirt conoce. tapa se utiliza
para filtrar la lista por tipos de capacidad, los tipos deben estar separados por comas, p. ej.
--cap pci, scsi, los tipos de capacidad válidos incluyen 'system', 'pci', 'usb_device', 'usb',
'net', 'scsi_host', 'scsi_target', 'scsi', 'almacenamiento', 'fc_host', 'vports',
'scsi_generic'. Si --árbol se utiliza, la salida se formatea en un árbol que representa
padres de cada nodo. tapa y --árbol son mutuamente excluyentes.

nodedev-reconectar nodev
Declarar que nodev ya no está en uso por ningún invitado, y que el anfitrión puede reanudar
uso normal del dispositivo. Esto se hace automáticamente para dispositivos PCI en modo administrado
y dispositivos USB, pero debe hacerse explícitamente para que coincida con cualquier nodedev-separar.

reinicio de nodedev nodev
Activar un reinicio del dispositivo para nodev, útil antes de transferir un dispositivo de nodo entre
paso de invitado o el anfitrión. Libvirt a menudo hará esta acción implícitamente cuando
requerido, pero este comando permite un reinicio explícito cuando sea necesario.

VIRTUAL RED COMANDOS

Los siguientes comandos manipulan redes. Libvirt tiene la capacidad de definir virtual
redes que luego pueden ser utilizadas por dominios y vinculadas a dispositivos de red reales. Para más
información detallada sobre esta función, consulte la documentación en
<http://libvirt.org/formatnetwork.html>. Muchos de los comandos para redes virtuales son
similares a los que se usan para los dominios, pero la forma de nombrar una red virtual es por
su nombre o UUID.

inicio automático de red del sistema, [--desactivar]
Configure una red virtual para que se inicie automáticamente en el arranque. los --desactivar opción
deshabilitar el inicio automático.

creación de red presentar
Cree una red virtual transitoria (temporal) a partir de un XML presentar y instanciar
(iniciar) la red. Ver la documentación enhttp://libvirt.org/formatnetwork.html>
para obtener una descripción del formato de red XML utilizado por libvirt.

definición de red presentar
Definir una red virtual persistente inactiva o modificar una persistente existente
desde el XML presentar.

destruir la red del sistema,
Destruir (detener) una red virtual transitoria o persistente determinada especificada por su nombre
o UUID. Esto entra en vigor de inmediato.

net-dumpxml del sistema, [--inactivo]
Envíe la información de la red virtual como un volcado XML a stdout. Si --inactivo is
especificado, entonces las funciones fsicas no se expanden en sus asociados virtuales
funciones.

edición en red del sistema,
Edite el archivo de configuración XML para una red.

Esto es equivalente a:

virsh net-dumpxml: red inactiva> network.xml
vi network.xml (o realice cambios con su otro editor de texto)
virsh net-define red.xml

excepto que realiza una comprobación de errores.

El editor utilizado puede ser proporcionado por las variables de entorno $ VISUAL o $ EDITOR, y
por defecto es "vi".

evento neto {[del sistema,] evento [--círculo] [--se acabó el tiempo segundos] [- marca de tiempo] | --lista}
Espere a que ocurra una clase de eventos de red e imprima los detalles apropiados de los eventos.
a medida que suceden. Los eventos se pueden filtrar opcionalmente por del sistema,. Utilizando --lista as
el único argumento proporcionará una lista de posibles evento valores conocidos por este cliente,
aunque es posible que la conexión no permita registrarse para todos estos eventos.

De forma predeterminada, este comando es de una sola vez y devuelve el éxito una vez que ocurre un evento; usted
puede enviar SIGINT (normalmente a través de "Ctrl-C") para salir inmediatamente. Si --se acabó el tiempo is
especificado, el comando deja de esperar eventos después segundos han transcurrido. Con
--círculo, el comando imprime todos los eventos hasta un tiempo de espera o una tecla de interrupción.

¿Cuándo? - marca de tiempo se utiliza, se imprimirá una marca de tiempo legible por humanos antes del evento.

información de red del sistema,
Devuelve información básica sobre el del sistema, objeto.

lista de red [--inactivo | --todas] {[--mesa] | --nombre | --uuido } [--persistente]
[<--transitorio>] [--autoencendido] [<--no-inicio automático>]
Devuelve la lista de redes activas, si --todas se especifica esto también incluirá
redes definidas pero inactivas, si --inactivo se especifica solo los inactivos
estar en la lista. Es posible que también desee filtrar las redes devueltas por --persistente Listar
los persistentes, --transitorio para enumerar los transitorios, --autoencendido para enumerar el
los que tienen el inicio automático habilitado, y --sin inicio automático para enumerar los que tienen inicio automático
discapacitado.

If --nombre se especifica, los nombres de red se imprimen en lugar de la tabla formateada
por línea. Si --uuido Se especifica que los UUID de la red se imprimen en lugar de los nombres. Bandera
--mesa especifica que se debe utilizar la salida con formato de tabla heredada. Este es el
defecto. Todos estos son mutuamente excluyentes.

NOTA: Cuando se habla con servidores más antiguos, este comando se ve obligado a utilizar una serie de API
llamadas con una carrera inherente, donde un grupo puede no estar en la lista o puede aparecer más
de una vez si cambió de estado entre llamadas mientras se recopilaba la lista. Más nuevo
los servidores no tienen este problema.

nombre de red UUID de red
Convierta un UUID de red en un nombre de red.

inicio neto del sistema,
Inicie una red inactiva (definida previamente).

neta indefinida del sistema,
Anule la definición de la configuración para una red persistente. Si la red está activa, conviértala
transitorio.

uuid neto nombre de red
Convierta un nombre de red en UUID de red.

actualización de red del sistema, comando . xml [- índice de padres índice] [[--En Vivo] [--config] |
[--Actual]]
Actualice la sección dada de una definición de red existente, con los cambios
opcionalmente con efecto inmediato, sin necesidad de destruir y reiniciar el
red.

comando es uno de los siguientes: "agregar primero", "agregar último", "agregar" (un sinónimo de agregar último), "eliminar",
o "modificar".

. es uno de "puente", "dominio", "ip", "ip-dhcp-host", "ip-dhcp-range",
"forward", "forward-interface", "forward-pf", "portgroup", "dns-host", "dns-txt", o
"dns-srv", cada sección se nombra mediante una concatenación de la jerarquía de elementos xml
lo que lleva al elemento que se cambia. Por ejemplo, "ip-dhcp-host" cambiará un
elemento que está contenido dentro de un elemento dentro de un elemento de la
red.

xml es el texto de un elemento xml completo del tipo que se está cambiando (p. ej.
"
elemento xml completo. La desambiguación se realiza mirando el primer carácter del
texto proporcionado: si el primer carácter es "<", es texto xml, si el primer carácter
no es "<", es el nombre de un archivo que contiene el texto xml que se utilizará.

La sección - índice de padres La opción se utiliza para especificar cuál de varios elementos principales
el elemento solicitado está en (basado en 0). Por ejemplo, un dhcp El elemento podría estar en cualquier
uno de múltiples elementos en la red; si no se proporciona un índice principal, el
"más apropiado" se seleccionará el elemento (normalmente el único que ya
tiene un elemento), pero si - índice de padres se da, ese caso particular de
obtendrá la modificación.

If --En Vivo se especifica, afecta a una red en funcionamiento. Si --config se especifica, afecta
el próximo inicio de una red persistente. Si --Actual se especifica, afectan al
estado actual de la red. Ambos --En Vivo y --config se pueden dar banderas, pero --Actual is
exclusivo. No especificar ninguna bandera es lo mismo que especificar --Actual.

arrendamientos-netos-dhcp del sistema, [Mac]
Obtenga una lista de arrendamientos de dhcp para todas las interfaces de red conectadas a la virtual
del sistema, o salida limitada solo para una interfaz si Mac está especificado.

INTERFAZ COMANDOS

Los siguientes comandos manipulan las interfaces del host. A menudo, estas interfaces de host pueden
ser utilizado por nombre dentro del dominio elementos (como un puente creado por el sistema
interfaz), pero no hay ningún requisito de que las interfaces de host estén vinculadas a ninguna
XML de configuración de invitado en absoluto.

Muchos de los comandos para las interfaces de host son similares a los que se utilizan para los dominios, y
La forma de nombrar una interfaz es por su nombre o su dirección MAC. Sin embargo, usar un MAC
dirección para un Yo afronto El argumento solo funciona cuando esa dirección es única (si una interfaz y
un puente comparte la misma dirección MAC, que suele ser el caso, y luego usa esa dirección MAC
da como resultado un error debido a la ambigüedad, y debe recurrir a un nombre en su lugar).

iface-puente interfaz. puente [--no-stp] [retrasar] [--sin inicio]
Cree un dispositivo puente llamado puentey conecte el dispositivo de red existente interfaz.
al nuevo puente. El nuevo puente comienza de manera predeterminada para comenzar de inmediato, con STP habilitado
y un retraso de 0; estos ajustes se pueden modificar con --no-stp, --sin inicio, y una
número entero de segundos para retrasar. Toda la configuración de la dirección IP de interfaz. se mantendrá
movido al nuevo dispositivo puente.

Vea también iface-unbridge para deshacer esta operación.

definición de iface presentar
Defina una interfaz de host física persistente inactiva o modifique una interfaz persistente existente.
uno del XML presentar.

iface-destrozar interfaz.
Destruir (detener) una interfaz de host determinada, por ejemplo, ejecutando "if-down" para deshabilitar esa
interfaz de uso activo. Esto entra en vigor de inmediato.

iface-dumpxml interfaz. [--inactivo]
Envíe la información de la interfaz del host como un volcado XML a stdout. Si --inactivo is
especificado, la salida refleja el estado persistente de la interfaz que se
se utilizará la próxima vez que se inicie.

iface-editar interfaz.
Edite el archivo de configuración XML para una interfaz de host.

Esto es equivalente a:

virsh iface-dumpxml iface> iface.xml
vi iface.xml (o realice cambios con su otro editor de texto)
virsh iface-definir iface.xml

excepto que realiza una comprobación de errores.

El editor utilizado puede ser proporcionado por las variables de entorno $ VISUAL o $ EDITOR, y
por defecto es "vi".

lista iface [--inactivo | --todas]
Devuelve la lista de interfaces de host activas. Si --todas se especifica esto también
incluyen interfaces definidas pero inactivas. Si --inactivo se especifica solo el inactivo
se enumerarán unos.

nombre-iface interfaz.
Convierta una MAC de interfaz de host en un nombre de interfaz, si la dirección MAC es única entre las
interfaces del host.

interfaz. especifica la dirección MAC de la interfaz.

iface-mac interfaz.
Convierta un nombre de interfaz de host en una dirección MAC.

interfaz. especifica el nombre de la interfaz.

iface-inicio interfaz.
Inicie una interfaz de host (definida previamente), por ejemplo, ejecutando "if-up".

iface-unbridge puente [--sin inicio]
Derriba un dispositivo puente llamado puente, liberando su interfaz subyacente de nuevo a
uso normal, y mover toda la configuración de la dirección IP del dispositivo puente al
dispositivo subyacente. La interfaz subyacente se reinicia a menos que --sin inicio is
regalo; esta bandera está presente para la simetría, pero generalmente no se recomienda.

Vea también iface-puente para crear un puente.

iface-indefinido interfaz.
Anule la definición de la configuración para una interfaz de host inactiva.

iface-comienza
Cree una instantánea de la configuración actual de la interfaz del host, que luego se puede confirmar
(iface-compromiso) o restaurado (iface-reversión). Si ya existe una instantánea, entonces este
El comando fallará hasta que la instantánea anterior se haya confirmado o restaurado.
Se produce un comportamiento indefinido si se realizan cambios externos en las interfaces de host externas.
de la API libvirt entre el comienzo de una instantánea y su eventual confirmación o
Retroceder.

iface-compromiso
Declare todos los cambios desde el último iface-comienza como en funcionamiento, y elimine la reversión
punto. Si aún no se ha iniciado ninguna instantánea de la interfaz, este comando
fallar.

iface-reversión
Revertir todas las configuraciones de la interfaz del host al estado registrado en la última iface-comienza.
Si aún no se ha iniciado ninguna instantánea de la interfaz, este comando fallará.
Reiniciar el host también sirve como un punto de reversión implícito.

ALMACENAMIENTO POOL COMANDOS

Los siguientes comandos manipulan las agrupaciones de almacenamiento. Libvirt tiene la capacidad de gestionar
Varias soluciones de almacenamiento, incluidos archivos, particiones sin formato y formatos específicos de dominio,
se utiliza para proporcionar los volúmenes de almacenamiento visibles como dispositivos dentro de las máquinas virtuales. Para más
información detallada sobre esta función, consulte la documentación en
<http://libvirt.org/formatstorage.html>. Muchos de los comandos para grupos son similares a
los que se utilizan para los dominios.

buscar-fuentes-agrupaciones-de-almacenamiento tipo [especificaciónsrc]
Devuelve XML que describe todas las posibles fuentes de agrupaciones de almacenamiento disponibles que podrían utilizarse
para crear o definir un grupo de almacenamiento de un determinado tipo. Si especificaciónsrc se proporciona, es un
archivo que contiene XML para restringir aún más la consulta de grupos.

No todos los grupos de almacenamiento admiten el descubrimiento de esta manera. Además, para aquellos que lo hacen
admite el descubrimiento, solo se requieren elementos XML específicos para devolver datos válidos
datos, mientras que otros elementos e incluso atributos de algunos elementos se ignoran ya que
no son necesarios para encontrar el grupo según los criterios de búsqueda. Las siguientes listas
el apoyado tipo opciones y los elementos XML mínimos esperados utilizados para realizar la
buscar.

Para un grupo "netfs" o "gluster", el XML mínimo esperado es el
elemento con un atributo "nombre" que describe la dirección IP o el nombre de host que se utilizará para
encuentra la piscina. El atributo "puerto" se ignorará al igual que cualquier otro XML proporcionado.
elementos en especificaciónsrc.

Para un grupo "lógico", el contenido del especificaciónsrc archivo se ignoran, aunque si
siempre que el archivo deba existir al menos.

Para un grupo "iscsi", el XML esperado mínimo requerido es el elemento con un
Atributo "nombre" que describe la dirección IP o el nombre de host que se utilizará para encontrar el grupo.
(la dirección del servidor iSCSI). Opcionalmente, se puede proporcionar el atributo "puerto", aunque
se establecerá de forma predeterminada en 3260. Opcionalmente, Elemento XML con un "nombre"
Se puede proporcionar un atributo para restringir aún más la búsqueda de destino iSCSI a un
iniciador para grupos de almacenamiento iSCSI multi-iqn.

buscar-fuentes-agrupaciones-de-almacenamiento-como tipo [host] [Puerto] [iniciador]
En lugar de proporcionar especificaciónsrc Archivo XML para buscar-fuentes-agrupaciones-de-almacenamiento usa este comando
opción para que virsh genere el archivo XML de consulta usando el opcional
argumentos. El comando devolverá el mismo XML de salida que buscar-fuentes-agrupaciones-de-almacenamiento.

Utilice host para describir un host específico que se utilizará para el almacenamiento en red, como netfs,
gluster y iscsi tipo quinielas.

Utilice Puerto para restringir aún más qué puerto de red utilizar para la conexión si
requerido por el backend de almacenamiento específico, como iscsi.

Utilice iniciador para restringir aún más el iscsi tipo agrupar búsquedas para un objetivo específico
iniciadores.

inicio automático de la piscina piscina-o-uuid [--desactivar]
Configurar si alberca debería comenzar automáticamente en el arranque.

construir piscina piscina-o-uuid [--Sobrescribir] [--no-sobrescribir]
Construye una piscina determinada.

--Sobrescribir y --no-sobrescribir solo se puede usar para construir piscina un sistema de archivos o
grupo de discos. Para un grupo de sistemas de archivos, si no se especifica ninguno de ellos, construir piscina petroquímica
El directorio. Si --no-sobrescribir se especifica, sondea para determinar si un sistema de archivos
ya existe en el dispositivo de destino, devolviendo un error si existe, o usando mkfs para
formatee el dispositivo de destino si no es así. Si --Sobrescribir se especifica, mkfs siempre se ejecuta
y cualquier dato existente en el dispositivo de destino se sobrescribe incondicionalmente. Por un disco
pool, si no se especifica ninguno de ellos o --no-sobrescribir está especificado, construir piscina will
use 'parted --print' para determinar si el disco ya tiene una etiqueta antes
intentando crear uno. Solo si un disco aún no tiene uno, se incluirá una etiqueta.
creado. Si --Sobrescribir está especificado o se ha determinado que el disco no
ya tiene uno, se utilizará 'parted mklabel' para crear una etiqueta del formato
especificado por el tipo de formato de origen del grupo o "dos" si no se especifica para el grupo.

crear piscina presentar [--construir] [[--Sobrescribir] | [--no-sobrescribir]]
Crear e iniciar un objeto de grupo desde XML presentar.

[--construir] [[--Sobrescribir] | [--no-sobrescribir]] realizar una construir piscina después de la creación en
para eliminar la necesidad de un comando de seguimiento para construir la piscina. El --Sobrescribir
y --no-sobrescribir banderas siguen las mismas reglas que construir piscina. Si solo --construir is
siempre que construir piscina se llama sin banderas.

piscina-crear-como nombre tipo [--imprimir-xml] [--fuente-host hostname] [- ruta de origen camino]
[--fuente-dev camino] [--nombre de la fuente nombre ] [--objetivo camino] [--formato de fuente formato]
[--Tipo de autenticación Tipo de autenticación --auth-nombre de usuario nombre de usuario - uso secreto personal] [[--nombre-adaptador
nombre ] | [--adaptador-wwnn --adaptador-wwpn] [- padre-adaptador con el futuro bebé]] [--construir]
[[--Sobrescribir] | [--no-sobrescribir]]
Crear e iniciar un objeto de piscina nombre de los parámetros sin procesar. Si --imprimir-xml is
especificado, luego imprima el XML del objeto de grupo sin crear el grupo.
De lo contrario, el grupo tiene el especificado tipo. Cuando usas piscina-crear-como para una piscina de
tipo "disco", las particiones existentes que se encuentran en el --fuente-dev camino será utilizado para
poblar la agrupación de discos. Por lo tanto, se sugiere utilizar piscina-definir-como y piscina-
construimos con el --Sobrescribir para inicializar correctamente la agrupación de discos.

[--fuente-host hostname] proporciona el nombre de host de origen para los grupos respaldados por el almacenamiento de
un servidor remoto (tipos de pool netfs, iscsi, rbd, sheepdog, gluster).

[- ruta de origen camino] proporciona la ruta del directorio de origen para los grupos respaldados por
directorios (tipo de grupo dir).

[--fuente-dev camino] proporciona la ruta de origen para los grupos respaldados por dispositivos físicos.
(tipos de grupo fs, lógico, disco, iscsi, zfs).

[--nombre de la fuente nombre ] proporciona el nombre de origen para los grupos respaldados por el almacenamiento de un nombre
elemento (tipos de grupo lógicos, rbd, perro pastor, gluster).

[--objetivo camino] es la ruta para el mapeo de la agrupación de almacenamiento en el archivo de host
.

[--formato de fuente formato] proporciona información sobre el formato del grupo (tipos de grupo
fs, netfs, disco, lógico).

[--Tipo de autenticación Tipo de autenticación --auth-nombre de usuario nombre de usuario - uso secreto personal] proporciona el
elementos necesarios para generar credenciales de autenticación para el grupo de almacenamiento. El
Tipo de autenticación es chap para iscsi tipo piscinas o ceph para rbd tipo quinielas.

[--nombre-adaptador nombre ] define el nombre del adaptador scsi_hostN que se utilizará para scsi_host
grupo de tipo adaptador.

[--adaptador-wwnn --adaptador-wwpn [- padre-adaptador con el futuro bebé]] define wwnn y wwpn para
se utilizará para el grupo de tipos de adaptadores fc_host. El padre opcionalmente proporciona el nombre de
el dispositivo de nodo scsi_hostN que se utilizará para el vHBA.

[--construir] [[--Sobrescribir] | [--no-sobrescribir]] realizar una construir piscina después de la creación en
para eliminar la necesidad de un comando de seguimiento para construir la piscina. El --Sobrescribir
y --no-sobrescribir banderas siguen las mismas reglas que construir piscina. Si solo --construir is
siempre que construir piscina se llama sin banderas.

definir piscina presentar
Defina un grupo de almacenamiento persistente inactivo o modifique uno persistente existente de
el XML presentar.

piscina-definir-como nombre tipo [--imprimir-xml] [--fuente-host hostname] [- ruta de origen camino]
[--fuente-dev camino] [--nombre de la fuente nombre ] [--objetivo camino] [--formato de fuente formato]
[--Tipo de autenticación Tipo de autenticación --auth-nombre de usuario nombre de usuario - uso secreto personal] [[--nombre-adaptador
nombre ] | [--adaptador-wwnn --adaptador-wwpn] [- padre-adaptador con el futuro bebé]]
Cree, pero no inicie, un objeto de grupo nombre de los parámetros sin procesar. Si --imprimir-xml
se especifica, luego imprima el XML del objeto de grupo sin definir el grupo.
De lo contrario, el grupo tiene el especificado tipo.

Usa los mismos argumentos que piscina-crear-como, excepto por el --construir, --Sobrescribir y
--no-sobrescribir .

piscina-destruir piscina-o-uuid
Destruye (detén) un dado alberca objeto. Libvirt ya no administrará el almacenamiento
descrito por el objeto del grupo, pero los datos brutos contenidos en el grupo no se modifican,
y se puede recuperar posteriormente con crear piscina.

eliminar grupo piscina-o-uuid
Destruye los recursos utilizados por un determinado alberca objeto. Esta operación no es recuperable.
La sección alberca El objeto seguirá existiendo después de este comando, listo para la creación de nuevos
volúmenes de almacenamiento.

volcado de piscinapxml [--inactivo] piscina-o-uuid
Devuelve la información XML sobre el alberca objeto. --inactivo le dice a virsh que se deshaga
configuración de la piscina que se utilizará en el próximo inicio de la piscina en lugar de la
configuración actual de la piscina.

piscina-editar piscina-o-uuid
Edite el archivo de configuración XML para una agrupación de almacenamiento.

Esto es equivalente a:

virsh pool-dumpxml pool> pool.xml
vi pool.xml (o realice cambios con su otro editor de texto)
virsh pool-definir pool.xml

excepto que realiza una comprobación de errores.

El editor utilizado puede ser proporcionado por las variables de entorno $ VISUAL o $ EDITOR, y
por defecto es "vi".

información de la piscina piscina-o-uuid
Devuelve información básica sobre el alberca objeto.

lista de grupos [--inactivo] [--todas] [--persistente] [--transitorio] [--autoencendido] [--sin inicio automático]
[[--detalles] [ ]
Lista de objetos de grupo conocidos por libvirt. De forma predeterminada, solo se enumeran los grupos activos;
--inactivo enumera solo los grupos inactivos, y --todas enumera todos los grupos.

Además, hay varios conjuntos de indicadores de filtrado. --persistente es enumerar el
piscinas persistentes, --transitorio es enumerar los grupos transitorios. --autoencendido enumera el
grupos de inicio automático, --sin inicio automático enumera los grupos con inicio automático deshabilitado.

Es posible que también desee enumerar los grupos con tipos específicos utilizando tipo, los tipos de piscina deben
estar separados por comas, por ejemplo, --type dir, disk. Los tipos de grupo válidos incluyen 'dir', 'fs',
'netfs', 'lógico', 'disco', 'iscsi', 'scsi', 'mpath', 'rbd', 'perro pastor' y 'gluster'.

La sección --detalles La opción indica a virsh que muestre adicionalmente la persistencia del grupo y
información relacionada con la capacidad cuando esté disponible.

NOTA: Cuando se habla con servidores más antiguos, este comando se ve obligado a utilizar una serie de API
llamadas con una carrera inherente, donde un grupo puede no estar en la lista o puede aparecer más
de una vez si cambió de estado entre llamadas mientras se recopilaba la lista. Más nuevo
los servidores no tienen este problema.

nombre-piscina uuid
Convertir el uuid a un nombre de grupo.

refrescar la piscina piscina-o-uuid
Actualizar la lista de volúmenes contenidos en alberca.

inicio de piscina piscina-o-uuid [--construir] [[--Sobrescribir] | [--no-sobrescribir]]
Iniciar el almacenamiento alberca, que está previamente definido pero inactivo.

[--construir] [[--Sobrescribir] | [--no-sobrescribir]] realizar una construir piscina antes de inicio de piscina
para garantizar que el entorno de la piscina esté en un estado esperado en lugar de tener que ejecutar el
construir comando antes del inicio. El --Sobrescribir y --no-sobrescribir banderas siguen el
mismas reglas que construir piscina. Si solo --construir se proporciona, entonces construir piscina se llama con
sin banderas.

Nota: : Un grupo de almacenamiento que depende de recursos remotos, como un "iscsi" o un (v) HBA
Es posible que sea necesario actualizar el grupo "scsi" respaldado varias veces para tener todos los
volúmenes detectados (ver refrescar la piscina). Esto se debe a que los dispositivos de volumen correspondientes
puede no estar presente en el sistema de archivos del host durante el inicio del grupo inicial o el
intento de actualización actual. El número de reintentos de actualización depende de la red
conexión y el tiempo que tarda el host en exportar los dispositivos correspondientes.

piscina-indefinida piscina-o-uuid
Anule la definición de la configuración para un inactivo alberca.

piscina-uuid alberca
Devuelve el UUID del nombre alberca.

VOLUMEN COMANDOS

vol-crear piscina-o-uuid ARCHIVO [--prealloc-metadatos]
Crea un volumen a partir de un XML . piscina-o-uuid es el nombre o UUID del almacenamiento
pool para crear el volumen en. ARCHIVO es el XML con la definición de volumen. Un
forma fácil de crear el XML es usar el Vol-dumppxml comando para obtener el
definición de un volumen preexistente. [--prealloc-metadatos] preasignar metadatos (para
qcow2 imágenes que no admiten la asignación completa). Esta opción crea una imagen dispersa
archivo con metadatos, lo que resulta en un mayor rendimiento en comparación con las imágenes sin
preasignación y uso de espacio en disco inicial solo ligeramente superior.

Ejemplo

virsh vol-dumpxml --pool storagepool1 appvolume1> newvolume.xml
vi newvolume.xml (o realice cambios con su otro editor de texto)
virsh vol-create differenttoragepool newvolume.xml

vol-crear-desde piscina-o-uuid ARCHIVO [--grupo de entrada piscina-o-uuid] vol-nombre-o-clave-o-ruta
[--prealloc-metadatos] [--reflink]
Crea un volumen, usando otro volumen como entrada. piscina-o-uuid es el nombre o UUID de
el grupo de almacenamiento para crear el volumen en. ARCHIVO es el XML con el volumen
definición. --grupo de entrada piscina-o-uuid es el nombre o uuid del grupo de almacenamiento
el volumen de la fuente está en. vol-nombre-o-clave-o-ruta es el nombre o clave o ruta de la fuente
volumen. [--prealloc-metadatos] preasignar metadatos (para imágenes qcow2 que no
apoyar la asignación completa). Esta opción crea un archivo de imagen disperso con metadatos,
resultando en un mayor rendimiento en comparación con las imágenes sin preasignación y solo
uso de espacio en disco inicial ligeramente mayor. Cuándo --reflink se especifica, realice una VACA
copia ligera, donde los bloques de datos se copian solo cuando se modifican. Si esto no es
posible, la copia falla.

vol-crear-como piscina-o-uuid nombre para actuar [--asignación tamaño] [--formato cadena]
[--back-vol vol-nombre-o-clave-o-ruta] [--back-vol-formato cadena]
[--prealloc-metadatos]
Crea un volumen a partir de un conjunto de argumentos. piscina-o-uuid es el nombre o UUID del
grupo de almacenamiento para crear el volumen en. nombre es el nombre del nuevo volumen. Por un disco
pool, debe coincidir con el nombre de la partición según lo determinado por el dispositivo de origen del pool
ruta y la siguiente partición disponible. Por ejemplo, una ruta de dispositivo de origen de / dev / sdb
y no hay particiones en el disco, entonces el nombre debe ser sdb1 con el siguiente nombre
siendo sdb2 y así sucesivamente. para actuar es el tamaño del volumen que se creará, como una escala
entero (ver NOTAS arriba), por defecto a bytes si no hay sufijo. --asignación
tamaño es el tamaño inicial que se asignará en el volumen, también como un entero escalado
por defecto a bytes. --formato cadena se utiliza en grupos de almacenamiento basados ​​en archivos para especificar
el formato de archivo de volumen a utilizar; crudo, bochs, qcow, qcow2, vmdk, qed. Uso extendido para
grupos de almacenamiento en disco para crear una partición extendida (otros valores son la validez
se comprueba pero no se conserva cuando se reinicia libvirtd o se actualiza el grupo).
--back-vol vol-nombre-o-clave-o-ruta es el volumen de respaldo de la fuente que se utilizará si
tomar una instantánea de un volumen existente. --back-vol-formato cadena es el formato de
el volumen de respaldo de la instantánea; raw, bochs, qcow, qcow2, qed, vmdk, host_device. Estos
Sin embargo, están pensados ​​para grupos de almacenamiento basados ​​en archivos. [--prealloc-metadatos] preasignar
metadatos (para imágenes qcow2 que no admiten la asignación completa). Esta opción crea un
archivo de imagen escaso con metadatos, lo que resulta en un mayor rendimiento en comparación con las imágenes
sin preasignación y con un uso de espacio en disco inicial ligeramente superior.

vol-clon [--piscina piscina-o-uuid] vol-nombre-o-clave-o-ruta nombre [--prealloc-metadatos]
[--reflink]
Clona un volumen existente. Versión de menos potente, pero más fácil de escribir vol-crear-
Desde. --piscina piscina-o-uuid es el nombre o UUID del grupo de almacenamiento para crear el
volumen en. vol-nombre-o-clave-o-ruta es el nombre, la clave o la ruta del volumen de origen.
nombre es el nombre del nuevo volumen. [--prealloc-metadatos] preasignar metadatos (para
qcow2 imágenes que no admiten la asignación completa). Esta opción crea una imagen dispersa
archivo con metadatos, lo que resulta en un mayor rendimiento en comparación con las imágenes sin
preasignación y uso de espacio en disco inicial solo ligeramente superior. Cuándo --reflink is
especificado, realice una copia ligera COW, donde los bloques de datos se copian solo cuando
modificado. Si esto no es posible, la copia falla.

vol-eliminar [--piscina piscina-o-uuid] vol-nombre-o-clave-o-ruta [- eliminar-instantáneas]
Eliminar un volumen determinado. --piscina piscina-o-uuid es el nombre o UUID del grupo de almacenamiento
el volumen está en. vol-nombre-o-clave-o-ruta es el nombre o clave o ruta del volumen a
Eliminar.

La sección - eliminar-instantáneas bandera especifica que cualquier instantánea asociada con el almacenamiento
el volumen también debe eliminarse. No todos los controladores de almacenamiento admiten esta opción,
actualmente solo rbd.

subir volumen [--piscina piscina-o-uuid] [--compensar bytes] [--largo bytes] vol-nombre-o-clave-o-ruta
archivo local
Sube el contenido de archivo local a un volumen de almacenamiento. --piscina piscina-o-uuid son los
nombre o UUID del grupo de almacenamiento en el que se encuentra el volumen. vol-nombre-o-clave-o-ruta son los
nombre o clave o ruta del volumen donde se cargará el archivo. --compensar son los
posición en el volumen de almacenamiento en el que comenzar a escribir los datos. El valor debe ser 0
o mayor. --largo es un límite superior de la cantidad de datos que se cargarán. Un negativo
el valor se interpreta como un valor largo largo sin firmar para incluir esencialmente todo
desde el desplazamiento hasta el final del volumen. Ocurrirá un error si el archivo local is
mayor que la longitud especificada. Ver la descripción de libvirt
API virStorageVolUpload para obtener detalles sobre posibles cambios de grupo y volumen de destino
como resultado de la actualización del grupo cuando se intenta la carga.

vol-descargar [--piscina piscina-o-uuid] [--compensar bytes] [--largo bytes] vol-nombre-o-clave-o-
camino archivo local
Descargue el contenido de un volumen de almacenamiento para archivo local. --piscina piscina-o-uuid son los
nombre o UUID del grupo de almacenamiento en el que se encuentra el volumen. vol-nombre-o-clave-o-ruta son los
nombre o clave o ruta del volumen a descargar. --compensar es la posición en el
volumen de almacenamiento en el que comenzar a leer los datos. El valor debe ser 0 o mayor.
--largo es un límite superior de la cantidad de datos que se descargarán. Un valor negativo es
interpretado como un valor largo largo sin firmar para incluir esencialmente todo, desde el
compensar hasta el final del volumen.

Vol-limpiar [--piscina piscina-o-uuid] [--algoritmo algoritmo] vol-nombre-o-clave-o-ruta
Limpie un volumen, asegúrese de que los datos previamente en el volumen no sean accesibles para lecturas futuras.
--piscina piscina-o-uuid es el nombre o UUID del grupo de almacenamiento en el que se encuentra el volumen. vol-
nombre-o-clave-o-ruta es el nombre, la clave o la ruta del volumen que se va a limpiar. Es posible
para elegir diferentes algoritmos de limpieza en lugar de reescribir el volumen con ceros. Esta
se puede hacer a través de --algoritmo switch.

Soportado algoritmos
cero - 1 paso todos los ceros
nnsa - Carta de política de la NNSA de 4 pasadas NAP-14.1-C (XVI-8) para
desinfectar discos duros extraíbles y no extraíbles:
aleatorio x2, 0x00, verificar.
dod - procedimiento de 4 pasadas DoD 5220.22-M sección 8-306 para
higienizante rígido removible y no removible
discos: aleatorio, 0x00, 0xff, verificar.
bsi - método de 9 pasadas recomendado por el Centro Alemán de
Seguridad en Tecnologías de la Información
(http://www.bsi.bund.de): 0xff, 0xfe, 0xfd, 0xfb,
0xf7, 0xef, 0xdf, 0xbf, 0x7f.
Gutmann - La secuencia canónica de 35 pasadas descrita en
El artículo de Gutmann.
schneier - método de 7 pasos descrito por Bruce Schneier en
"Criptografía aplicada" (1996): 0x00, 0xff,
aleatorio x5.
pfitzner7 - Método de 7 pases aleatorios de Roy Pfitzner: aleatorio x7.
pfitzner33 - Método de 33 pases aleatorios de Roy Pfitzner: aleatorio x33.
aleatorio - patrón de 1 pasada: aleatorio.

Nota: : La disponibilidad de algoritmos puede estar limitada por la versión del "scrub"
binario instalado en el host.

Vol-dumppxml [--piscina piscina-o-uuid] vol-nombre-o-clave-o-ruta
Envíe la información del volumen como un volcado XML a stdout. --piscina piscina-o-uuid son los
nombre o UUID del grupo de almacenamiento en el que se encuentra el volumen. vol-nombre-o-clave-o-ruta es el nombre
o clave o ruta del volumen para generar el XML.

vol-info [--piscina piscina-o-uuid] vol-nombre-o-clave-o-ruta
Devuelve información básica sobre el volumen de almacenamiento dado. --piscina piscina-o-uuid son los
nombre o UUID del grupo de almacenamiento en el que se encuentra el volumen. vol-nombre-o-clave-o-ruta es el nombre
o clave o ruta del volumen para el que se devolverá la información.

lista de vol [--piscina piscina-o-uuid] [--detalles]
Devuelve la lista de volúmenes en la agrupación de almacenamiento dada. --piscina piscina-o-uuid es el nombre
o UUID del grupo de almacenamiento. El --detalles opción instruye a virsh a adicionalmente
mostrar información relacionada con el tipo de volumen y la capacidad cuando esté disponible.

vol-piscina [--uuido] vol-clave-o-ruta
Devuelve el nombre del grupo o UUID para un volumen determinado. De forma predeterminada, el nombre de la piscina es
regresó. Si el --uuido se da la opción, en su lugar se devuelve el UUID del grupo. vol-tecla-
o-camino es la clave o ruta del volumen para el que se devolverá la información del grupo.

vol-camino [--piscina piscina-o-uuid] vol-nombre-o-clave
Devuelve la ruta de un volumen determinado. --piscina piscina-o-uuid es el nombre o UUID del
grupo de almacenamiento en el que se encuentra el volumen. vol-nombre-o-clave es el nombre o clave del volumen a
devolver el camino para.

vol-nombre vol-clave-o-ruta
Devuelve el nombre de un volumen determinado. vol-clave-o-ruta es la clave o ruta del volumen
para devolver el nombre.

vol-tecla [--piscina piscina-o-uuid] vol-nombre-o-ruta
Devuelve la tecla de volumen para un volumen determinado. --piscina piscina-o-uuid es el nombre o UUID de
el grupo de almacenamiento en el que se encuentra el volumen. vol-nombre-o-ruta es el nombre o la ruta del volumen
para devolver la tecla de volumen.

vol-cambiar tamaño [--piscina piscina-o-uuid] vol-nombre-o-ruta piscina-o-uuid para actuar [--asignar]
[--delta] [--encogerse]
Cambie el tamaño de la capacidad del volumen dado, en bytes. --piscina piscina-o-uuid es el nombre o
UUID del grupo de almacenamiento en el que se encuentra el volumen. vol-nombre-o-clave-o-ruta es el nombre o la clave
o ruta del volumen a redimensionar. La nueva capacidad puede ser escasa a menos que --asignar
está especificado. Normalmente, para actuar es el nuevo tamaño, pero si --delta está presente, entonces
se agrega al tamaño existente. Los intentos de reducir el volumen fallarán a menos que
--encogerse está presente; para actuar no puede ser negativo a menos que --encogerse se proporciona, pero un
el signo negativo no es necesario. para actuar es un entero escalado (ver NOTAS arriba), que
toma el valor predeterminado de bytes si no hay sufijo. Este comando solo es seguro para el almacenamiento
volúmenes no utilizados por un huésped activo; ver también tamaño de bloque para cambiar el tamaño en vivo.

SECRETO COMANDOS

Los siguientes comandos manipulan "secretos" (por ejemplo, contraseñas, frases de contraseña y cifrado
teclas). Libvirt puede almacenar secretos independientemente de su uso y otros objetos (p. Ej.
volúmenes o dominios) pueden hacer referencia a los secretos para el cifrado o posiblemente para otros usos.
Los secretos se identifican mediante un UUID. Verhttp://libvirt.org/formatsecret.html> para
documentación del formato XML utilizado para representar las propiedades de los secretos.

secreto-definir presentar
Crea un secreto con las propiedades especificadas en presentar, sin secreto asociado
valor. Si presentar no especifica un UUID, elija uno automáticamente. Si presentar especifica
un UUID de un secreto existente, reemplace sus propiedades por propiedades definidas en presentar,
sin afectar el valor secreto.

volcado secretopxml secreto
Propiedades de salida de secreto (especificado por su UUID) como un volcado XML a stdout.

valor-conjunto-secreto secreto base64
Establecer el valor asociado con secreto (especificado por su UUID) al valor
Valor codificado en Base64 base64.

secreto-obtener-valor secreto
Salida del valor asociado con secreto (especificado por su UUID) a stdout, codificado
usando Base64.

secreto indefinido secreto
Eliminar un secreto (especificado por su UUID), incluido el valor asociado, si lo hubiera.

lista-secreta [--efímero] [--no-efímero] [--privado] [--no-privado]
Devuelve la lista de secretos. Es posible que también desee filtrar los secretos devueltos por
--efímero enumerar los efímeros, --no-efímero para enumerar los no efímeros,
--privado para enumerar los privados, y --no-privado para enumerar los no privados.

INSTANTÁNEA COMANDOS

Los siguientes comandos manipulan instantáneas de dominio. Las instantáneas toman el disco, la memoria y
estado del dispositivo de un dominio en un momento determinado y guárdelo para usarlo en el futuro. Tienen muchos
utiliza, desde guardar una copia "limpia" de una imagen del sistema operativo hasta guardar el estado de un dominio antes de
operación potencialmente destructiva. Las instantáneas se identifican con un nombre único. Ver
<http://libvirt.org/formatsnapshot.html> para la documentación del formato XML utilizado para
representan las propiedades de las instantáneas.

creación de instantánea dominio [archivo xml] {[--redefinir [--Actual]] | [--no-metadatos] [--detener]
[--solo disco] [--reutilizar-externo] [--quiescencia] [--atómico] [--En Vivo]}
Crea una instantánea para el dominio dominio con las propiedades especificadas en archivo xml.
Normalmente, las únicas propiedades configurables para una instantánea de dominio son las y
elementos, así como Si --solo disco es dado; el resto de
Los campos se ignoran y libvirt los completa automáticamente. Si archivo xml es completamente
omitido, libvirt elegirá un valor para todos los campos. La nueva instantánea
ponerse al día, según lo enumerado por instantánea-actual.

If --detener se especifica, el dominio se dejará en un estado inactivo después de la
Se crea la instantánea.

If --solo disco se especifica, la instantánea solo incluirá el estado del disco en lugar de la
punto de control habitual del sistema con estado vm. Las instantáneas de disco son más rápidas que el sistema completo
puntos de control, pero volver a una instantánea de disco puede requerir repeticiones de fsck o journal,
ya que es como el estado del disco en el momento en que se tira bruscamente del cable de alimentación;
y mezclando --detener y --solo disco pierde todos los datos que no se volcaron al disco en el
en las transacciones.

If --redefinir se especifica, entonces todos los elementos XML producidos por instantánea-dumppxml están
válido; esto se puede utilizar para migrar la jerarquía de instantáneas de una máquina a otra, para
recrear la jerarquía para el caso de un dominio transitorio que desaparece y es más tarde
recreado con el mismo nombre y UUID, o para realizar ligeras alteraciones en la instantánea
metadatos (como aspectos específicos del host del dominio XML incrustado en la instantánea).
Cuando se suministra esta bandera, el archivo xml argumento es obligatorio, y el dominio
La instantánea actual no se modificará a menos que --Actual también se da la bandera.

If --no-metadatos se especifica, luego se crean los datos de la instantánea, pero los metadatos se
descartado inmediatamente (es decir, libvirt no trata la instantánea como actual, y
no puede volver a la instantánea a menos que --redefinir se utiliza más tarde para enseñar a libvirt sobre
los metadatos de nuevo).

If --reutilizar-externo se especifica, y el XML de instantánea solicita una instantánea externa
con un destino de un archivo existente, entonces el destino debe existir y estar pre
creado con el formato y los metadatos correctos. Luego, el archivo se reutiliza; de lo contrario, un
Se rechaza la instantánea para evitar perder el contenido de los archivos existentes.

If --quiescencia está especificado, libvirt intentará usar el agente invitado para congelar y descongelar
sistemas de archivos montados del dominio. Sin embargo, si el dominio no tiene un agente invitado, la instantánea
la creación fallará. Actualmente, esto requiere --solo disco para ser pasado también.

If --atómico se especifica, libvirt garantizará que la instantánea se realice correctamente o
falla sin cambios; no todos los hipervisores admiten esto. Si esta bandera no es
especificado, algunos hipervisores pueden fallar después de realizar parcialmente la acción, y
volcarxml debe usarse para ver si se produjeron cambios parciales.

If --En Vivo se especifica, libvirt toma la instantánea mientras el invitado se está ejecutando. Esta
aumenta el tamaño de la imagen de la memoria del punto de control externo. Esto es actualmente
admitido solo para puntos de control externos.

La existencia de metadatos de instantáneas evitará los intentos de indefinir un dominio persistente.
Sin embargo, para los dominios transitorios, los metadatos de instantáneas se pierden silenciosamente cuando el dominio
deja de funcionar (ya sea por un comando como destruir o por la acción de un huésped interno).

instantánea-crear-como dominio {[--imprimir-xml] | [--no-metadatos] [--detener] [--reutilizar-externo]}
[nombre ] [description] [--solo disco [--quiescencia]] [--atómico] [[--En Vivo] [--memspec especificación mem]]
[--diskspec] especificación de disco] ...
Crea una instantánea para el dominio dominio con lo dado y ; si alguno
se omite el valor, libvirt elegirá un valor. Si --imprimir-xml se especifica, luego XML
apropiado para creación de instantánea es la salida, en lugar de crear una instantánea.
De lo contrario, si --detener se especifica, el dominio se dejará en un estado inactivo después de
se crea la instantánea, y si --solo disco se especifica, la instantánea no
incluir el estado de VM.

La sección --memspec La opción se puede utilizar para controlar si un punto de control es interno o
externo. El --memspec la bandera es obligatoria, seguida de una especificación mem de la forma
[archivo =] nombre [, instantánea = tipo], donde el tipo puede ser no, interno o externo. Para incluir
una coma literal en file = nombre, escúrralo con una segunda coma. --memspec No puede ser usado
Junto con --solo disco.

La sección --diskspec La opción se puede utilizar para controlar cómo --solo disco y puntos de control externos
crear archivos externos. Esta opción puede ocurrir varias veces, según el número
de elementos en el dominio xml. Cada está en la forma
disco [, instantánea = tipo] [, controlador = tipo] [, archivo = nombre]. La especificación de disco debe proporcionarse para discos
respaldado por dispositivos de bloque, ya que libvirt no genera automáticamente nombres de archivo para esos. A
incluir una coma literal en disco ó en file = nombre, escúrralo con una segunda coma. A
literal --diskspec debe preceder a cada especificación de disco a menos que los tres dominio, nombre y
description también están presentes. Por ejemplo, una especificación de disco de
"vda, snapshot = external, file = / path / to ,, new" da como resultado el siguiente XML:




If --reutilizar-externo se especifica, y el dominio XML o especificación de disco la opción solicita un
instantánea externa con un destino de un archivo existente, entonces el destino debe
existen y se han creado previamente con el formato y los metadatos correctos. Luego, el archivo se reutiliza;
de lo contrario, se rechaza una instantánea para evitar perder el contenido de los archivos existentes.

If --quiescencia está especificado, libvirt intentará usar el agente invitado para congelar y descongelar
sistemas de archivos montados del dominio. Sin embargo, si el dominio no tiene un agente invitado, la instantánea
la creación fallará. Actualmente, esto requiere --solo disco para ser pasado también.

If --no-metadatos se especifica, luego se crean los datos de la instantánea, pero los metadatos se
descartado inmediatamente (es decir, libvirt no trata la instantánea como actual, y
no puede volver a la instantánea a menos que creación de instantánea se usa más tarde para enseñar libvirt
sobre los metadatos nuevamente). Esta bandera es incompatible con --imprimir-xml.

If --atómico se especifica, libvirt garantizará que la instantánea se realice correctamente o
falla sin cambios; no todos los hipervisores admiten esto. Si esta bandera no es
especificado, algunos hipervisores pueden fallar después de realizar parcialmente la acción, y
volcarxml debe usarse para ver si se produjeron cambios parciales.

If --En Vivo se especifica, libvirt toma la instantánea mientras el invitado se está ejecutando. Esta
aumenta el tamaño de la imagen de la memoria del punto de control externo. Esto es actualmente
admitido solo para puntos de control externos.

instantánea-actual dominio {[--nombre] | [--información de seguridad] | [nombre de instantánea]}
Sin nombre de instantánea, esto generará la instantánea XML para el dominio actual
instantánea (si corresponde). Si --nombre se especifica, solo el nombre de la instantánea actual en lugar de
el xml completo. De lo contrario, usando --información de seguridad también incluirá información sensible a la seguridad
información en el XML.

Con nombre de instantánea, esta es una solicitud para hacer que la instantánea con nombre existente se convierta en la
instantánea actual, sin revertir el dominio.

instantánea-editar dominio [nombre de instantánea] [--Actual] {[--rebautizar] | [--clon]}
Edite el archivo de configuración XML para nombre de instantánea de un dominio. Si ambos nombre de instantánea
y --Actual se especifican, también fuerzan la instantánea editada a convertirse en la actual
instantánea. Si nombre de instantánea se omite, entonces --Actual debe ser suministrado, para editar el
instantánea actual.

Esto es equivalente a:

virsh snapshot-dumpxml nombre de dom> snapshot.xml
vi snapshot.xml (o realice cambios con su otro editor de texto)
virsh snapshot-create dom snapshot.xml --redefine [--actual]

excepto que realiza una comprobación de errores.

El editor utilizado puede ser proporcionado por las variables de entorno $ VISUAL o $ EDITOR, y
por defecto es "vi".

If --rebautizar se especifica, las ediciones pueden cambiar el nombre de la instantánea. Si --clon is
especificado, luego cambiar el nombre de la instantánea creará un clon de la instantánea
metadatos. Si no se especifica ninguno, las ediciones no deben cambiar el nombre de la instantánea.
Tenga en cuenta que el cambio de nombre de una instantánea debe realizarse con cuidado, ya que el contenido de algunas
Las instantáneas, como las instantáneas internas dentro de un solo archivo qcow2, solo son accesibles
del nombre original.

información-instantánea dominio {instantánea | --Actual}
Salida de información básica sobre un nombre , o la instantánea actual con
--Actual.

lista de instantáneas dominio [--metadatos] [--no-metadatos] [{--padre | --raíces | [{--árbol |
--nombre}]}] [{[--desde] instantánea | --Actual} [--descendientes]] [--hojas] [--no-hojas]
[--inactivo] [--activo] [--solo disco] [--interno] [--externo]
Enumere todas las instantáneas disponibles para el dominio dado, de manera predeterminada para mostrar columnas
para el nombre de la instantánea, la hora de creación y el estado del dominio.

If --padre se especifica, agregue una columna a la tabla de salida dando el nombre de la
padre de cada instantánea. Si --raíces se especifica, la lista se filtrará a solo
instantáneas que no tienen padres. Si --árbol se especifica, la salida estará en un árbol
formato, enumerando solo los nombres de las instantáneas. Estas tres opciones son mutuamente excluyentes. Si
--nombre se especifica solo se imprime el nombre de la instantánea. Esta opción es mutuamente
exclusivo con --árbol.

If --desde se proporciona, filtre la lista a instantáneas que son secundarias del
instantánea; o si --Actual se proporciona, comience en la instantánea actual. Cuando se usa en
aislamiento o con --padre, la lista se limita a los niños directos a menos que
--descendientes también está presente. Cuando se usa con --árbol, El uso de --descendientes is
implícito. Esta opción no es compatible con --raíces. Tenga en cuenta que el punto de partida de
--desde or --Actual no está incluido en la lista a menos que el --árbol la opción también es
presente.

If --hojas se especifica, la lista se filtrará solo a las instantáneas que no tienen
niños. Asimismo, si --no-hojas se especifica, la lista se filtrará a solo
instantáneas con niños. (Tenga en cuenta que omitir ambas opciones no filtra, mientras que
Proporcionar ambas opciones producirá la misma lista o se producirá un error dependiendo de
si el servidor reconoce las banderas). Las opciones de filtrado no son compatibles con
--árbol.

If --metadatos se especifica, la lista se filtrará solo a instantáneas que involucren
libvirt metadatos, y por lo tanto evitaría indefinir de un dominio persistente, o perderse
on destruir de un dominio transitorio. Asimismo, si --no-metadatos se especifica, la lista
se filtrará a solo instantáneas que existan sin la necesidad de metadatos libvirt.

If --inactivo se especifica, la lista se filtrará a las instantáneas que se tomaron
cuando se cerró el dominio. Si --activo se especifica, la lista se filtrará a
instantáneas que se tomaron cuando el dominio se estaba ejecutando y donde la instantánea incluye
el estado de la memoria para volver a ese estado de ejecución. Si --solo disco se especifica, el
La lista se filtrará a las instantáneas que se tomaron cuando el dominio se estaba ejecutando, pero
donde la instantánea incluye solo el estado del disco.

If --interno se especifica, la lista se filtrará a las instantáneas que utilizan internos
almacenamiento de imágenes de disco existentes. Si --externo se especifica, la lista será
filtrado a instantáneas que utilizan archivos externos para imágenes de disco o estado de la memoria.

instantánea-dumppxml dominio instantánea [--información de seguridad]
Genere el XML de instantánea para la instantánea del dominio denominada instantánea. Utilizando
--información de seguridad también incluirá información confidencial de seguridad. Usar instantánea, que
corriente para acceder fácilmente al XML de la instantánea actual.

padre-instantánea dominio {instantánea | --Actual}
Muestra el nombre de la instantánea principal, si la hubiera, para el instantánea, o para el
instantánea actual con --Actual.

instantánea-revertir dominio {instantánea | --Actual} [{--corriendo | - pausado}] [--fuerza]
Revertir el dominio dado a la instantánea especificada por instantánea, o al actual
instantánea con --Actual. Tenga en cuenta que esta es una acción destructiva; cualquier cambio en
se perderá el dominio desde que se tomó la última instantánea. También tenga en cuenta que el estado
del dominio después de que se complete la reversión de instantáneas será el estado del dominio en el
hora en que se tomó la instantánea original.

Normalmente, volver a una instantánea deja el dominio en el estado en el que estaba en ese momento
se creó la instantánea, excepto que una instantánea de disco sin estado de vm deja el
dominio en un estado inactivo. Pasando el --corriendo or - pausado bandera será
realizar cambios de estado adicionales (como iniciar un dominio inactivo o pausar un
dominio en ejecución). Dado que los dominios transitorios no pueden estar inactivos, es necesario utilizar
uno de estos indicadores al revertir a una instantánea de disco de un dominio transitorio.

Hay dos casos en los que la reversión de una instantánea implica un riesgo adicional, que requiere la
uso de --fuerza para proceder. Uno es el caso de una instantánea que carece de dominio completo
información para revertir la configuración (como instantáneas creadas antes de libvirt
0.9.5); ya que libvirt no puede probar que la configuración actual coincide con la que estaba en
utilizar en el momento de la instantánea, proporcionando --fuerza le asegura a libvirt que la instantánea
es compatible con la configuración actual (y si no lo es, es probable que el dominio
no se ejecuta). El otro es el caso de revertir de un dominio en ejecución a un activo
indicar dónde se debe crear un nuevo hipervisor en lugar de reutilizar el existente
hipervisor, porque implica inconvenientes como romper cualquier VNC o Spice existente
conexiones; esta condición ocurre con una instantánea activa que usa un comprobante
configuración incompatible, así como con una instantánea inactiva que se combina con
el --comienzo or --pausa bandera.

instantánea-borrar dominio {instantánea | --Actual} [--metadatos] [{--niños |
- solo para niños}]
Eliminar la instantánea del dominio denominado instantánea, o la instantánea actual con
--Actual. Si esta instantánea tiene instantáneas secundarias, los cambios de esta instantánea serán
se fusionó con los niños. Si --niños se pasa, luego borre esta instantánea y cualquier
hijos de esta instantánea. Si - solo para niños se pasa, luego borre cualquier hijo de
esta instantánea, pero déjela intacta. Estas dos banderas son mutuamente
exclusiva.

If --metadatos se especifica, luego solo elimine los metadatos de la instantánea mantenidos por
libvirt, dejando intacto el contenido de la instantánea para el acceso de herramientas externas;
de lo contrario, la eliminación de una instantánea también elimina el contenido de los datos de ese momento.

FILTRO NW COMANDOS

Los siguientes comandos manipulan filtros de red. Los filtros de red permiten filtrar
tráfico de red procedente y dirigido a máquinas virtuales. Tráfico de red individual
Los filtros están escritos en XML y pueden contener referencias a otros filtros de red, describa
reglas de filtrado de tráfico, o contener ambas. Los filtros de red son referenciados por virtual
máquinas desde la descripción de su interfaz. Un filtro de red puede ser referenciado por
interfaces de múltiples máquinas virtuales.

nwfilter-definir archivo xml
Dar a conocer un nuevo filtro de red para libvirt. Si un filtro de red con el mismo nombre
ya existe, será reemplazado por el nuevo XML. Cualquier máquina virtual en ejecución
Al hacer referencia a este filtro de red, se adaptarán sus reglas de tráfico de red. Si por
por cualquier motivo, las reglas de filtrado de tráfico de red no pueden ser instanciadas por ninguno de los
ejecutando máquinas virtuales, el nuevo XML será rechazado.

nwfilter-undefinir nwfilter-nombre
Eliminar un filtro de red. La eliminación fallará si alguna máquina virtual en ejecución es
actualmente usando este filtro de red.

lista de filtros nw
Enumere todos los filtros de red disponibles.

nwfilter-dumpxml nwfilter-nombre
Genere el XML del filtro de red.

nwfilter-editar nwfilter-nombre
Edite el XML de un filtro de red.

Esto es equivalente a:

virsh nwfilter-dumpxml myfilter> myfilter.xml
vi myfilter.xml (o realice cambios con su otro editor de texto)
virsh nwfilter-definir myfilter.xml

excepto que realiza alguna comprobación de errores. El nuevo filtro de red puede rechazarse debido
por la misma razón que se menciona en nwfilter-definir.

El editor utilizado puede ser proporcionado por las variables de entorno $ VISUAL o $ EDITOR, y
por defecto es "vi".

HIPERVISOR ESPECÍFICO COMANDOS

NOTA: El uso de los siguientes comandos es se mostró plenamente desanimado. Pueden hacer que libvirt
confundirse y hacer lo incorrecto en operaciones posteriores. Una vez que haya usado estos
comandos, no informe problemas a los desarrolladores de libvirt; los informes serán
ignorado. Si encuentra que estos comandos son la única forma de lograr algo, entonces
Es mejor solicitar que se agregue la característica como ciudadano de primera clase en el
biblioteca libvirt.

qemu-adjuntar pid
Adjunte un proceso QEMU lanzado externamente al controlador libvirt QEMU. El QEMU
El proceso debe haber sido creado con una conexión de monitor usando el controlador UNIX.
Idealmente, el proceso también habrá tenido el argumento '-name' especificado.

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

No se espera que todas las funciones de libvirt funcionen de manera confiable después de adjuntarlas a un
proceso QEMU lanzado externamente. Puede haber problemas con el cambio de ABI del invitado
Es posible que la migración y la conexión en caliente o desconexión en caliente del dispositivo no funcionen. El entorno adjunto
debe considerarse principalmente de solo lectura.

comando-monitor-qemu dominio {[--hmp] | [--lindo]} comando...
Envíe un comando de monitor arbitrario comando al dominio dominio a través del monitor qemu.
Los resultados del comando se imprimirán en stdout. Si --hmp se pasa, el comando
se considera un comando de monitor humano y libvirt lo convertirá automáticamente
en QMP si es necesario. En ese caso, el resultado también se volverá a convertir de QMP. Si
--lindo se proporciona, y el monitor usa QMP, entonces la salida se imprimirá bastante.
Si se proporciona más de un argumento para comando, están concatenados con un espacio
en el medio antes de pasar el comando único al monitor.

comando-agente-qemu dominio [--se acabó el tiempo segundos | --asíncrono | --cuadra] comando...
Enviar un comando de agente invitado arbitrario comando al dominio dominio a través del agente qemu.
--se acabó el tiempo, --asíncrono y --cuadra las opciones son exclusivas. --se acabó el tiempo requiere tiempo de espera
segundos segundos y debe ser positivo. Cuándo --aysnc se da, el comando espera
tiempo de espera ya sea exitoso o fallido. Y cuando --cuadra se da, el comando espera
para siempre con el bloqueo del tiempo de espera.

qemu-monitor-evento [dominio] [--evento nombre del evento] [--círculo] [--se acabó el tiempo segundos] [--lindo]
[--expresión regular] [--no hay caso] [- marca de tiempo]
Espere a que ocurran eventos arbitrarios del monitor QEMU e imprima los detalles de los eventos
a medida que suceden. Los eventos se pueden filtrar opcionalmente por dominio or nombre del evento.
El comando QMP 'query-events' se puede utilizar a través de comando-monitor-qemu para saber que eventos
son compatibles. Si --expresión regular es usado nombre del evento es una expresión regular básica en su lugar
de una cadena literal. Si --no hay caso es usado nombre del evento coincidirá sin distinción entre mayúsculas y minúsculas.

De forma predeterminada, este comando es de una sola vez y devuelve el éxito una vez que ocurre un evento; usted
puede enviar SIGINT (normalmente a través de "Ctrl-C") para salir inmediatamente. Si --se acabó el tiempo is
especificado, el comando deja de esperar eventos después segundos han transcurrido. Con
--círculo, el comando imprime todos los eventos hasta un tiempo de espera o una tecla de interrupción. Si --lindo
se especifica, los detalles de cualquier evento JSON están impresos para una mejor legibilidad.

¿Cuándo? - marca de tiempo se utiliza, se imprimirá una marca de tiempo legible por humanos antes del evento,
y se omitirá la información de tiempo proporcionada por QEMU.

lxc-ingresar-espacio de nombres dominio - / ruta / a / binario [arg1, [arg2, ...]]
Ingrese el espacio de nombres de dominio y ejecute el comando "/ ruta / a / binario" pasando el
argumentos solicitados. La ruta binaria es relativa al sistema de archivos raíz del contenedor, no al
host del sistema de archivos raíz. El binario heredará las variables de entorno/consola
visible para virsh. Este comando solo funciona cuando está conectado al controlador del hipervisor LXC.
Este comando tiene éxito solo si "/ruta/hacia/binario" tiene el estado de salida 0.

MEDIO AMBIENTE

Las siguientes variables de entorno se pueden configurar para alterar el comportamiento de "virsh"

VIRSH_DEBUG=<0 a 4>
Active la depuración detallada de los comandos virsh. Los niveles válidos son

· VIRSH_DEBUG=0

DEPURACIÓN: los mensajes de TODOS los niveles se registran

· VIRSH_DEBUG=1

INFO: registra mensajes en los niveles INFO, AVISO, ADVERTENCIA y ERROR

· VIRSH_DEBUG=2

AVISO: registra mensajes en los niveles AVISO, ADVERTENCIA y ERROR

· VIRSH_DEBUG=3

ADVERTENCIA: registra mensajes en los niveles ADVERTENCIA y ERROR

· VIRSH_DEBUG=4

ERROR: se registran los mensajes que solo se encuentran en el nivel de ERROR.

VIRSH_LOG_FILE="ARCHIVO DE REGISTRO"
El archivo para registrar los mensajes de depuración de virsh.

VIRSH_DEFAULT_CONNECT_URI
El hipervisor al que conectarse de forma predeterminada. Establézcalo en un URI, en el mismo formato que
aceptado por el se unen opción. Esta variable de entorno está en desuso en favor de
el mundial LIBVIRT_DEFAULT_URI variable que sirve para el mismo propósito.

LIBVIRT_DEFAULT_URI
El hipervisor al que conectarse de forma predeterminada. Establézcalo en un URI, en el mismo formato que
aceptado por el se unen opción. Esto anula el URI predeterminado establecido en cualquier cliente
config y evita que libvirt busque controladores.

VISUAL
El editor a utilizar por el editar y opciones relacionadas.

EDITOR
El editor a utilizar por el editar y opciones relacionadas, si "VISUAL" no está configurado.

VIRSH_HISTSIZE
El número de comandos para recordar en el historial de comandos. El valor predeterminado es 500.

LIBVIRT_DEBUG = NIVEL
Active la depuración detallada de todas las llamadas a la API de libvirt. Los niveles válidos son

· LIBVIRT_DEBUG = 1

Mensajes a nivel DEBUG o superior

· LIBVIRT_DEBUG = 2

Mensajes de nivel INFO o superior

· LIBVIRT_DEBUG = 3

Mensajes de nivel ADVERTENCIA o superior

· LIBVIRT_DEBUG = 4

Mensajes de nivel ERROR o superior

Para obtener más información sobre las opciones de depuración, consulte
"http://libvirt.org/logging.html"

Use virsh en línea usando los servicios de onworks.net