virsh - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

virsh - Management-Benutzeroberfläche

ZUSAMMENFASSUNG

virsch [zur Auswahl]... [COMMAND_STRING]

virsch [zur Auswahl] ... COMMAND [ARG] ...

BESCHREIBUNG

Der virsch Programm ist die Hauptschnittstelle für die Verwaltung von virsh-Gastdomänen. Das Programm kann
zum Erstellen, Anhalten und Herunterfahren von Domänen verwendet werden. Es kann auch verwendet werden, um aktuelle
Domänen. Libvirt ist ein C-Toolkit zur Interaktion mit den Virtualisierungsfunktionen neuerer
Versionen von Linux (und anderen Betriebssystemen). Es ist freie Software, die unter der GNU Lesser verfügbar ist
Allgemeine öffentliche Lizenz. Die Virtualisierung des Linux-Betriebssystems bedeutet die Fähigkeit,
mehrere Instanzen von Betriebssystemen gleichzeitig auf einem einzigen Hardwaresystem ausführen, wobei
die grundlegenden Ressourcen werden von einer Linux-Instanz gesteuert. Ziel der Bibliothek ist es, einen langen
Begriff stabile C-API. Es unterstützt derzeit Xen, QEMU, KVM, LXC, OpenVZ, VirtualBox und
VMware-ESX.

Die Grundstruktur der meisten Virsh-Nutzung ist:

virsh [OPTION]... [ARG]...

COHO Expo bei der Befehl ist einer der unten aufgeführten Befehle; Domain ist die numerische Domänen-ID oder die
Domänenname oder die Domänen-UUID; und ARGS sind befehlsspezifische Optionen. Es gibt ein paar
Ausnahmen von dieser Regel in den Fällen, in denen der betreffende Befehl auf alle Domänen wirkt,
der gesamten Maschine oder direkt auf dem Xen-Hypervisor. Diese Ausnahmen werden klar sein für
jeder dieser Befehle. Hinweis: Es ist zulässig, Domänen numerische Namen zu geben,
Dies führt jedoch zu einer Domäne, die nur durch die Domänen-ID identifiziert werden kann. In
mit anderen Worten, wenn ein numerischer Wert angegeben wird, wird er als Domänen-ID interpretiert, nicht als
ein Name.

Der virsch Programm kann entweder verwendet werden, um eines auszuführen COMMAND indem man den Befehl und seine
Argumente auf der Shell-Befehlszeile oder a COMMAND_STRING das ist ein einzelnes Shell-Argument
bestehend aus mehreren COMMAND Aktionen und ihre Argumente mit Leerzeichen verbunden, und
durch Semikolon getrennt zwischen den Befehlen. Innerhalb COMMAND_STRING, virsh versteht das
Dieselben einfachen, doppelten und umgekehrten Schrägstrich-Escapes wie die Shell, obwohl Sie eine weitere hinzufügen müssen
Shell-Schicht, die beim Erstellen des einzelnen Shell-Arguments entkommt. Wenn kein Befehl in . gegeben wird
die Befehlszeile, virsch startet dann einen minimalen Interpreter, der auf Ihre Befehle wartet,
und den verlassen Befehl beendet dann das Programm.

Der virsch Programm versteht folgendes OPTIONAL.

-c, --verbinden URI
Verbinden Sie sich mit dem angegebenen URI, wie von der connect Befehl, statt der Standardeinstellung
Verbindung.

-d, --debuggen LEVEL
Debug-Nachrichten bei Ganzzahl aktivieren LEVEL und darüber. LEVEL kann von 0 bis 4 reichen
(Ursprünglich). Siehe die Dokumentation von VIRSH_DEBUG Umgebungsvariable unten für die
Beschreibung von jedem LEVEL.

-e, --fliehen Schnur
Legen Sie eine alternative Escape-Sequenz für fest trösten Befehl. Standardmäßig sind Telnets ^] wird eingesetzt.
Zulässige Zeichen bei der Hutnotation sind: alphabetisches Zeichen, @, [, ], \, ^,
_.

-h, --help
Ignorieren Sie alle anderen Argumente und verhalten Sie sich so, als ob die Hilfe Befehl wurde stattdessen gegeben.

-k, --keepalive-intervall INTERVALL
Stellen Sie ein INTERVALL (in Sekunden) zum Senden von Keepalive-Nachrichten, um zu überprüfen, ob
Verbindung zum Server besteht noch. Das Einstellen des Intervalls auf 0 deaktiviert den Client
Keepalive-Mechanismus.

-K, --keepalive-count ANZAHL
Legen Sie fest, wie oft Keepalive-Nachrichten gesendet werden können, ohne dass eine Antwort vom
Server, ohne die Verbindung als tot zu markieren. Diese Einstellung hat keine Auswirkung in
Fall die INTERVALL ist auf 0 gesetzt.

-l, --Protokoll FILE
Protokollierungsdetails ausgeben an FILE.

-q, --ruhig
Vermeiden Sie zusätzliche Informationsnachrichten.

-r, --schreibgeschützt
Machen Sie die anfängliche Verbindung schreibgeschützt, als ob durch die --schreibgeschützt Option der connect
Befehl.

-t, --zeitliche Koordinierung
Informationen zur verstrichenen Zeit für jeden Befehl ausgeben.

-v, --version[=kurz]
Ignoriert alle anderen Argumente und gibt die Version der libvirt-Bibliothek virsh is . aus
kommen von

-V, --version=lang
Ignoriert alle anderen Argumente und gibt die Version der libvirt-Bibliothek virsh is . aus
stammen und welche Optionen und Treiber einkompiliert sind.

ANMERKUNG

Most virsch Operationen beruhen darauf, dass die libvirt-Bibliothek eine Verbindung zu einem bereits
Ausführen des libvirtd-Dienstes. Dies kann normalerweise mit dem Befehl invoke-rc.d libvirtd
Anfang.

Most virsch Befehle erfordern aufgrund der verwendeten Kommunikationskanäle Root-Rechte, um ausgeführt zu werden
mit dem Hypervisor zu sprechen. Die Ausführung als Nicht-Root gibt einen Fehler zurück.

Most virsch Befehle agieren synchron, außer vielleicht shutdown, setvcpus und setmem. In
diese Fälle die Tatsache, dass die virsch Programm zurückgegeben, bedeutet möglicherweise nicht, dass die Aktion abgeschlossen ist
und Sie müssen regelmäßig eine Abfrage durchführen, um zu erkennen, dass der Gast den Vorgang abgeschlossen hat.

virsch strebt nach Abwärtskompatibilität. Obwohl die Hilfe Befehl listet nur die
bevorzugte Verwendung eines Befehls, wenn eine ältere Version von virsch unterstützt eine alternative Schreibweise
eines Befehls oder einer Option (wie --getunnelt statt --getunnelt), dann Skripte mit
dass die ältere Schreibweise weiterhin funktioniert.

. virsch Befehle nehmen eine optional skalierte Ganzzahl an; wenn keine Skala vorhanden ist, dann
die Standardeinstellung ist im Befehl aufgeführt (aus historischen Gründen sind einige Befehle standardmäßig auf
Bytes, während andere Befehle standardmäßig Kibibytes verwenden). Folgende Groß-/Kleinschreibung muss beachtet werden:
Suffixe können verwendet werden, um eine bestimmte Skala auszuwählen:
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 Gigabyte 1,000,000,000
G, GiB Gibibyte 1,073,741,824
TB Terabyte 1,000,000,000,000
T, TiB Tebibyte 1,099,511,627,776
PB Petabyte 1,000,000,000,000,000
P, PiB Pebibyte 1,125,899,906,842,624
EB Exabyte 1,000,000,000,000,000,000
E, EiB Exbibyte 1,152,921,504,606,846,976

GENERISCH BEFEHLE

Die folgenden Befehle sind generisch, dh nicht domänenspezifisch.

Hilfe [Befehl-oder-Gruppe]
Dies listet jeden der virsh-Befehle auf. Bei Verwendung ohne Optionen sind alle Befehle
aufgelistet, eine pro Zeile, gruppiert in verwandte Kategorien, wobei das Schlüsselwort für jede angezeigt wird
Gruppe.

Um nur Befehle für eine bestimmte Gruppe anzuzeigen, geben Sie das Schlüsselwort für diese Gruppe als an
Möglichkeit. Zum Beispiel:

virsh # Hilfehost

Host und Hypervisor (Hilfe-Schlüsselwort 'host'):
Fähigkeiten Fähigkeiten
CPU-Modelle zeigen die CPU-Modelle für eine Architektur
verbinden (erneut) mit Hypervisor verbinden
freecell NUMA freier Speicher
hostname gibt den Hypervisor-Hostnamen aus
qemu-attach An bestehenden QEMU-Prozess anhängen
qemu-monitor-command QEMU Monitor-Befehl
qemu-agent-command QEMU-Gast-Agent-Befehl
sysinfo druckt die Hypervisor-Sysinfo
uri gibt den kanonischen URI des Hypervisors aus

Um detaillierte Informationen zu einem bestimmten Befehl anzuzeigen, geben Sie seinen Namen als Option ein
stattdessen. Beispielsweise:

virsh # Hilfeliste
NAME/FUNKTION
list - Domains auflisten

ZUSAMMENFASSUNG
Liste [--inaktiv] [--all]

BESCHREIBUNG
Gibt eine Liste der Domänen zurück.

OPTIONAL
--inactive listet inaktive Domänen auf
--alle inaktiven und aktiven Domänen auflisten

verlassen, wunsch
Beende dieses interaktive Terminal

Version [--dämon]
Druckt die Hauptversionsinformationen darüber aus, woraus dies erstellt wurde. Wenn --dämon is
angegeben, wird die Version des libvirt-Daemons in die Ausgabe aufgenommen.

Beispiel

$ Virsh-Version
Kompiliert gegen Bibliothek: libvirt 1.2.3
Bibliothek verwenden: libvirt 1.2.3
API verwenden: QEMU 1.2.3
Laufender Hypervisor: QEMU 2.0.50

$ virsh-Version --daemon
Kompiliert gegen Bibliothek: libvirt 1.2.3
Bibliothek verwenden: libvirt 1.2.3
API verwenden: QEMU 1.2.3
Laufender Hypervisor: QEMU 2.0.50
Gegen Daemon laufen: 1.2.6

cd [Verzeichnis]
Ändert das aktuelle Verzeichnis zu Verzeichnis. Das Standardverzeichnis für die cd Befehl
ist das Home-Verzeichnis oder, falls kein STARTSEITE variabel in der Umgebung, die Wurzel
Verzeichnis.

Dieser Befehl ist nur im interaktiven Modus verfügbar.

pwd Druckt das aktuelle Verzeichnis.

connect [URI] [--schreibgeschützt]
(Erneut) – Verbinden Sie sich mit dem Hypervisor. Wenn die Shell zum ersten Mal gestartet wird, ist dies automatisch
lauf mit dem URI Parameter, der von der Option "-c" in der Befehlszeile angefordert wird. Die URI
Parameter gibt an, wie eine Verbindung zum Hypervisor hergestellt wird. Die Dokumentationsseite unter
<http://libvirt.org/uri.html> Liste die unterstützten Werte auf, aber die gebräuchlichsten sind:

xen:///
Dies wird verwendet, um eine Verbindung zum lokalen Xen-Hypervisor herzustellen

qemu:///system
Verbinden Sie sich lokal als Root mit dem Daemon, der die QEMU- und KVM-Domänen überwacht

qemu:///session
als normaler Benutzer lokal mit seinem eigenen Satz von QEMU- und KVM-Domänen verbinden

lxc:///
eine Verbindung zu einem lokalen Linux-Container herstellen

Um die aktuell verwendete URI zu finden, überprüfen Sie die uri Befehl unten dokumentiert.

Informationen zum Fernzugriff finden Sie auf der Dokumentationsseite unterhttp://libvirt.org/uri.html> wie
URIs zu machen. Die --schreibgeschützt Option ermöglicht schreibgeschützte Verbindung

uri Gibt den kanonischen URI des Hypervisors aus, kann im Shell-Modus nützlich sein.

hostname
Geben Sie den Hostnamen des Hypervisors aus.

Sysinfo
Drucken Sie die XML-Darstellung der Hypervisor-Sysinfo, falls verfügbar.

Knoteninfo
Gibt grundlegende Informationen über den Knoten zurück, wie Anzahl und Typ der CPU und Größe der
physikalischer Speicher. Die Ausgabe entspricht der virNodeInfo-Struktur. Insbesondere die
Das Feld "CPU-Socket(s)" bedeutet die Anzahl der CPU-Sockets pro NUMA-Zelle. Die Information
libvirt display hängt davon ab, was jede Architektur bieten kann.

Nodecpumap [--ziemlich]
Zeigt die Gesamtanzahl der CPUs des Knotens, die Anzahl der Online-CPUs und die Liste der
Online-CPUs.

Bei --ziemlich die Online-CPUs werden als Bereich statt als Liste gedruckt.

Knotencpustats [CPU] [--Prozent]
Gibt CPU-Statistiken des Knotens zurück. Wenn CPU angegeben ist, druckt dies die angegebene CPU
nur Statistik. Wenn --Prozent angegeben ist, wird der Prozentsatz jeder Art gedruckt
der CPU-Statistik während 1 Sekunde.

nodememstats [Zelle]
Gibt Speicherstatistiken des Knotens zurück. Wenn Zelle angegeben ist, wird dies angegeben gedruckt
nur Zellenstatistik.

Knotensuspend [Ziel] [Dauer]
Versetzt den Knoten (Host-Rechner) in einen systemweiten Ruhezustand und plant die Knoten
Real-Time-Clock-Interrupt, um den Knoten nach der durch angegebenen Zeitdauer wieder aufzunehmen
Dauer ist raus. Ziel gibt den Status an, in dem der Host ausgesetzt wird,
es kann "mem" (auf RAM aussetzen), "disk" (auf Festplatte aussetzen) oder "hybrid" (aussetzen auf
sowohl RAM als auch Festplatte). Dauer gibt die Zeitdauer in Sekunden an, für die die
host muss angehalten werden, es sollte mindestens 60 Sekunden dauern.

Node-Memory-Tune [shm-seiten-zu-scannen] [shm-Schlaf-Millisekunden] [shm-merge-across-nodes]
Ermöglicht Ihnen die Anzeige oder Einstellung der Knotenspeicherparameter. shm-seiten-zu-scannen kann sein
Wird verwendet, um die Anzahl der zu scannenden Seiten festzulegen, bevor der Shared-Memory-Dienst zum geht
schlafen shm-Schlaf-Millisekunden kann verwendet werden, um die Anzahl der Millisekunden einzustellen, die geteilt wird
Speicherdienst sollte vor dem nächsten Scan schlafen; shm-merge-across-nodes gibt an, ob
Seiten von verschiedenen Numa-Knoten können zusammengeführt werden. Bei Einstellung auf 0 werden nur Seiten angezeigt, die
sich physisch im Speicherbereich desselben NUMA-Knotens befinden, können zusammengeführt werden. Bei Einstellung auf 1
Seiten von allen Knoten können zusammengeführt werden. Standard auf 1.

Hinweis: Derzeit bedeutet "Shared Memory Service" nur KSM (Kernel Samepage Merging).

Ressourcen
Drucken Sie ein XML-Dokument aus, das die Fähigkeiten des Hypervisors beschreibt, der wir derzeit sind
verbunden. Dies beinhaltet einen Abschnitt über die Host-Fähigkeiten in Bezug auf CPU und
Funktionen und eine Reihe von Beschreibungen für jede Art von Gästen, die virtualisiert werden können.
Eine ausführlichere Beschreibung finden Sie unter:
<http://libvirt.org/formatcaps.html> Die XML zeigt auch die NUMA-Topologieinformationen an
wenn verfügbar.

Domfähigkeiten [Virttyp] [Emulatorbin] [Bogen] [Maschine]
Drucken Sie ein XML-Dokument, das die Domänenfunktionen für den Hypervisor beschreibt, der wir sind
verbunden mit der Verwendung von Informationen, die entweder aus einer bestehenden Domäne stammen oder von . stammen
virsch Ressourcen Ausgang. Dies kann nützlich sein, wenn Sie beabsichtigen, eine neue Domain zu erstellen
und sind neugierig, ob es zum Beispiel VFIO nutzen könnte, indem es eine Domäne für die
Hypervisor mit einem bestimmten Emulator und einer bestimmten Architektur.

Jeder Hypervisor hat unterschiedliche Anforderungen bezüglich der erforderlichen Optionen
und die optional sind. Ein Hypervisor kann die Bereitstellung eines Standardwerts für jeden von
die Optionen.

Der Virttyp Option gibt den verwendeten Virtualisierungstyp an. Der zu verwendende Wert ist
entweder aus dem 'type'-Attribut des Top-Level-Element aus der Domain
XML oder das 'Typ'-Attribut, das in jedem gefunden wird Element aus dem virsch
Ressourcen Ausgang. Die Emulatorbin Option gibt den Pfad zum Emulator an. Die
zu verwendender Wert ist entweder der -Element in der Domänen-XML oder der virsch
Ressourcen Ausgang. Die Bogen Option gibt die Architektur an, die für die
Domain. Der zu verwendende Wert ist entweder das "arch"-Attribut aus dem XML der Domain
Element und Unterelement oder das Attribut "name" von an Element
von dem virsch Fähigkeiten Ausgang. Die Maschine gibt den Maschinentyp für die
Emulator. Der zu verwendende Wert ist entweder das "machine"-Attribut aus dem XML der Domain
Element und Unterelement oder eines aus einer Liste von Maschinen aus dem virsch
Ressourcen Ausgabe für eine bestimmte Architektur und einen bestimmten Domänentyp.

Für den qemu-Hypervisor gilt a Virttyp von entweder 'qemu' oder 'kvm' muss mitgeliefert werden
entweder mit den Emulatorbin or Bogen um eine Ausgabe für die Vorgabe zu generieren
Maschine. Lieferung von a Maschine Wert erzeugt eine Ausgabe für die spezifische Maschine.

injizieren-nmi Domain
Injizieren Sie dem Gast NMI.

Liste [--inaktiv | --alle] [--managed-save] [--Titel] { [--Tisch] | --Name | --uuid }
[--hartnäckig] [- vorübergehend] [--mit-managed-save] [--ohne-verwaltet-speichern] [--Auto-Start]
[--kein-autostart] [--mit-Schnappschuss] [--ohne-Schnappschuss] [--state-running] [--state-pausiert]
[--state-shutoff] [--state-other]
Druckt Informationen zu vorhandenen Domänen. Wenn keine Optionen angegeben sind, wird es ausgedruckt
Informationen zum Ausführen von Domänen.

Ein Beispielformat für die Liste sieht wie folgt aus:

virsch Liste
ID-Namensstatus
-------------------------------------------------- -
0 Domain-0 läuft
2 Fedora pausiert

Name ist der Name der Domäne. ID der numerischen Domänen-ID. State ist der Run-Zustand
(siehe unten).

STAATEN

Das Feld State listet 8 Zustände für eine Domäne auf, und in welchen sich die aktuelle Domäne befindet.

Laufen
Die Domain läuft derzeit auf einer CPU

Leerlauf
Die Domäne ist im Leerlauf und wird nicht ausgeführt oder kann nicht ausgeführt werden. Dies kann verursacht werden, weil die
Domain wartet auf IO (ein traditioneller Wartezustand) oder ist in den Ruhezustand gegangen, weil
es blieb ihm nichts anderes übrig.

pausiert
Die Domäne wurde angehalten, was normalerweise durch die Ausführung des Administrators geschieht
virsch aussetzen. Im pausierten Zustand verbraucht die Domain weiterhin zugewiesene
Ressourcen wie Arbeitsspeicher, kommen jedoch nicht für die Planung durch den Hypervisor in Frage.

Schließung
Die Domäne wird gerade heruntergefahren, dh das Gastbetriebssystem hat
wurde benachrichtigt und sollte dabei sein, seinen Betrieb ordnungsgemäß zu beenden.

geschlossen WOW!
Die Domäne wird nicht ausgeführt. Normalerweise zeigt dies an, dass die Domäne geschlossen wurde
vollständig oder wurde nicht gestartet.

abgestürzt
Die Domain ist abgestürzt, was immer ein heftiges Ende ist. Normalerweise kann dieser Zustand
treten nur auf, wenn die Domäne so konfiguriert wurde, dass sie bei einem Absturz nicht neu gestartet wird.

sterbend
Die Domain ist im Sterben, wurde aber noch nicht vollständig heruntergefahren oder ist abgestürzt.

pmsuspendiert
Die Domäne wurde durch die Gaststromverwaltung gesperrt, zB in s3 eingetragen
Zustand.

Normalerweise werden nur aktive Domänen aufgelistet. Um inaktive Domänen aufzulisten, geben Sie an --inaktiv
or --alle um sowohl aktive als auch inaktive Domänen aufzulisten.

Um die Liste der Domänen weiter zu filtern, können Sie eines oder mehrere Filterflags angeben
unterstützt von der Liste Befehl. Diese Flags sind nach Funktion gruppiert. Angabe eines oder
mehr Flags aus einer Gruppe aktiviert die Filtergruppe. Beachten Sie, dass einige Kombinationen von Flags
kann keine Ergebnisse liefern. Unterstützte Filterflags und -gruppen:

Beharrlichkeit
Flagge --hartnäckig wird verwendet, um persistente Domänen in die zurückgegebene Liste aufzunehmen. Zu
Transiente Domänen einschließen - vorübergehend.

Existenz of verwaltet Speichern Image
Um Domänen mit einem verwalteten Speicherabbild aufzulisten, geben Sie das Flag an --mit-managed-save. For
Domänen, die kein verwaltetes Speicherabbild haben, angeben --ohne-verwaltet-speichern.

Domain Zustand
Die folgenden Filterflags wählen eine Domäne nach ihrem Status aus: --state-running für
laufende Domänen, --state-pausiert für pausierte Domains, --state-shutoff für gedreht
aus Domänen und --state-other für alle anderen Staaten als Fallback.

Autostart Domains
Um automatisch startende Domains aufzulisten, verwenden Sie das Flag --Auto-Start. Um Domains damit aufzulisten
Funktion deaktivierte Verwendung --kein-autostart.

Schnappschuss Existenz
Domains mit Snapshot-Images können mit Flag . aufgelistet werden --mit-Schnappschuss,
Domains ohne Snapshot --ohne-Schnappschuss.

Bei der Kommunikation mit älteren Servern ist dieser Befehl gezwungen, eine Reihe von API-Aufrufen zu verwenden
mit einer inhärenten Rasse, bei der eine Domain möglicherweise nicht aufgeführt ist oder mehr als
einmal, wenn der Status zwischen Anrufen geändert wurde, während die Liste gesammelt wurde. Neuere
Server haben dieses Problem nicht.

If --managed-save angegeben ist, dann Domänen mit verwaltetem Speicherstatus (nur
möglich, wenn sie in der geschlossen WOW! Zustand, also müssen Sie angeben --inaktiv or --alle
um sie tatsächlich aufzulisten) wird stattdessen angezeigt als Gerettet in der Auflistung. Diese Flagge ist verwendbar
nur mit der Vorgabe --Tisch Ausgang. Beachten Sie, dass dieses Flag die Liste der nicht filtert
Domains.

If --Name angegeben ist, werden Domainnamen anstelle des tabellenformatierten ausgegeben
pro Zeile. Wenn --uuid wird die UUID der angegebenen Domäne anstelle von Namen ausgegeben. Flagge
--Tisch gibt an, dass die alte tabellenformatierte Ausgabe verwendet werden soll. Dies ist das
Ursprünglich. All dies schließt sich gegenseitig aus.

If --Titel angegeben ist, dann wird die kurze Domainbeschreibung (Titel) in einem
zusätzliche Spalte. Dieses Flag kann nur mit der Standardeinstellung verwendet werden --Tisch Ausgabe.

Ejemplo:

virsch Liste --titel
ID-Name Statustitel
-------------------------------------------------- ------------------------
0 Domain-0 mit Mailserver 1
2 Fedora pausiert

Freecell [{ [--mobilnr] Zellennr | --alle }]
Druckt den verfügbaren Speicherplatz auf dem Gerät oder innerhalb einer NUMA-Zelle. Die
Der Befehl freecell kann eine von drei verschiedenen Anzeigen des verfügbaren Speichers anzeigen
die Maschine je nach den angegebenen Optionen. Ohne Optionen zeigt es die
insgesamt freier Arbeitsspeicher auf dem Gerät. Mit der Option --all wird der freie Speicher angezeigt
in jeder Zelle und den gesamten freien Speicherplatz auf dem Gerät. Schließlich mit einem numerischen
Argument oder mit --cellno plus einer Zellennummer wird der freie Speicher für die
nur angegebene Zelle.

kostenlose Seiten [{ [--mobilnr] Zellennr [--Seitengröße] Seitengröße | --alle }]
Druckt die verfügbare Seitenanzahl innerhalb einer NUMA-Zelle. Zellennr bezieht sich auf die NUMA
Zelle, die Sie interessiert. Seitengröße ist eine skalierte ganze Zahl (siehe ANMERKUNG über).
Alternativ, wenn --alle verwendet wird, Infos zu jeder möglichen Kombination von NUMA-Zelle und
Seitengröße wird ausgedruckt.

Zuweisungen [--Seitengröße] Seitengröße [--Seitenzahl] Seitenzahl [[--mobilnr] Zellennr] [--hinzufügen]
[--alle]
Ändern Sie die Größe des Seitenpools von Seitengröße auf dem Wirt. Wenn --hinzufügen angegeben ist, dann
Seitenzahl Seiten werden dem Pool hinzugefügt. Wie auch immer, wenn --hinzufügen wurde nicht angegeben, dann die
Seitenzahl wird als neue absolute Größe des Pools angenommen (dies kann verwendet werden, um einige
Seiten und verkleinern Sie den Pool). Die Zellennr Modifikator kann verwendet werden, um die
Modifikation auf eine einzelne Host-NUMA-Zelle. Am anderen Ende des Spektrums liegt --alle
die die Modifikation auf allen NUMA-Zellen ausführt.

CPU-Basislinie FILE [--Merkmale] [--migrationsfähig]
Berechnen Sie die Baseline-CPU, die von allen in angegebenen Host-CPUs unterstützt wird . Die
Liste der Host-CPUs wird erstellt, indem alle extrahiert werden Elemente aus dem . Und so kam es dass der
kann entweder eine Menge von enthalten Elemente getrennt durch neue Zeilen oder sogar eine Menge
von vollständig Elemente gedruckt von Ressourcen Befehl. Wenn --Merkmale is
angegeben, enthält die resultierende XML-Beschreibung explizit alle Funktionen, die
bilden die CPU, ohne diese Option werden Funktionen, die Teil des CPU-Modells sind, nicht
in der XML-Beschreibung aufgeführt werden. Wenn --migrationsfähig angegeben ist, Funktionen, die blockieren
Migration wird nicht in die resultierende CPU aufgenommen.

CPU-Vergleich FILE [--Error]
Vergleichen Sie die CPU-Definition von XML mit Host-CPU. Die XML-Datei kann enthalten
entweder Host- oder Gast-CPU-Definition. Die Host-CPU-Definition ist die Element und
sein Inhalt wie gedruckt von Ressourcen Befehl. Die Gast-CPU-Definition ist die
-Element und dessen Inhalt aus der Domänen-XML-Definition. Weitere Informationen zur Gast-CPU
Definition siehe:http://libvirt.org/formatdomain.html#elementsCPU>. Wenn --Error is
angegeben, gibt der Befehl einen Fehler zurück, wenn die angegebene CPU nicht kompatibel ist mit
Host-CPU und eine Nachricht mit weiteren Details zur Inkompatibilität wird angezeigt
ausgedruckt.

CPU-Modelle Bogen
Drucken Sie die Liste der CPU-Modelle, die für die angegebene Architektur bekannt sind.

Echo [--Schale] [--xml] [arg...]
Echo zurück jedes arg, durch Leerzeichen getrennt. Wenn --Schale angegeben ist, wird die Ausgabe
bei Bedarf in einfache Anführungszeichen gesetzt werden, damit es für die Wiederverwendung in einem Shell-Kontext geeignet ist.
If --xml angegeben ist, wird die Ausgabe für die Verwendung in XML mit Escapezeichen versehen.

DOMAIN BEFEHLE

Die folgenden Befehle manipulieren Domänen direkt, wie zuvor die meisten Befehle beschrieben
Nehmen Sie domain als ersten Parameter. Die Domain kann als kurzer Integer oder Name angegeben werden
oder eine vollständige UUID.

Auto-Start [--deaktivieren] Domain
Konfigurieren Sie eine Domäne, die beim Booten automatisch gestartet wird.

Die Option --deaktivieren deaktiviert den Autostart.

trösten Domain [Entwicklername] [--sicher] [--Macht]
Verbinden Sie die virtuelle serielle Konsole für den Gast. Die Wahl Entwicklername Parameter
bezieht sich auf den Gerätealias einer alternativen Konsole, eines seriellen oder parallelen Geräts
für den Gast konfiguriert. Wenn es weggelassen wird, wird die primäre Konsole geöffnet.

Wenn die Flagge --sicher angegeben ist, wird die Verbindung nur versucht, wenn der Treiber
unterstützt den sicheren Umgang mit der Konsole. Dieses Flag gibt an, dass der Server sicherstellen muss
exklusiver Zugriff auf Konsolengeräte. Optional die --Macht Flag kann angegeben werden,
Aufforderung zum Trennen bestehender Sitzungen, z. B. im Falle einer Unterbrechung
Verbindung.

erstellen FILE [--Konsole] [--pausiert] [--autodestroy] [--pass-fds N, M,...]
Erstellen Sie eine Domäne aus einer XML . Eine einfache Möglichkeit, das XML zu erstellen ist die zu benutzen
dumpxml Befehl, um die Definition eines bereits vorhandenen Gasts abzurufen. Die Domain wird
pausiert, wenn die --pausiert Option wird vom Treiber verwendet und unterstützt; sonst wird es
in Betrieb sein. Wenn --Konsole angefordert wird, nach der Erstellung an die Konsole anhängen. Wenn
--autodestroy angefordert wird, wird der Gast automatisch vernichtet, wenn virsh
schließt seine Verbindung zu libvirt oder beendet sich anderweitig.

If --pass-fds angegeben ist, ist das Argument eine durch Kommas getrennte Liste der geöffneten Datei
Deskriptoren, die an den Gast weitergegeben werden sollen. Die Dateideskriptoren werden neu
im Gast nummeriert, beginnend mit 3. Dies wird nur bei Container-basiert unterstützt
Virtualisierung.

Beispiel

virsh dumpxml > domain.xml
vi domain.xml (oder nehmen Sie Änderungen mit Ihrem anderen Texteditor vor)
virsh erstellen domain.xml

definieren FILE
Definieren Sie eine Domäne aus einer XML . Die Domänendefinition ist registriert, aber nicht
gestartet. Wenn die Domäne bereits ausgeführt wird, werden die Änderungen beim nächsten Start wirksam.

desc Domain [[--Live] [--config] | [--aktuell]] [--Titel] [--bearbeiten] [--new-desc NEU
Beschreibung oder Titelnachricht]
Beschreibung und Titel einer Domain anzeigen oder ändern. Diese Werte sind Benutzerfelder, die
erlauben, beliebige Textdaten zu speichern, um eine einfache Identifizierung von Domänen zu ermöglichen. Titel
sollte kurz sein, obwohl es nicht erzwungen wird. (Siehe auch Metadaten das funktioniert mit XML
basierende Domain-Metadaten.)

Flags --Live or --config Wählen Sie aus, ob dieser Befehl live oder dauerhaft funktioniert
Definitionen der Domäne. Wenn beides --Live und --config angegeben sind, die --config
Option hat Vorrang beim Abrufen der aktuellen Beschreibung und der Live-Konfiguration
und config werden beim Festlegen der Beschreibung aktualisiert. --aktuell ist exklusiv und
impliziert, wenn nichts davon angegeben wurde.

Flagge --bearbeiten gibt an, dass ein Editor mit dem Inhalt der aktuellen Beschreibung oder des Titels
geöffnet und der Inhalt anschließend wieder gespeichert werden soll.

Flagge --Titel wählt die Operation im Titelfeld anstelle der Beschreibung aus.

Wenn keiner von --bearbeiten und --new-desc angegeben sind, wird der Hinweis oder die Beschreibung angezeigt
anstatt modifiziert zu werden.

zerstören Domain [--anmutig]
Domain sofort kündigen Domain. Das gibt dem Domain-Betriebssystem keine Chance
zu reagieren, und es ist gleichbedeutend mit dem Abreißen des Netzkabels an einer physischen Maschine.
In den meisten Fällen möchten Sie die Schließung Befehl statt. Das geht jedoch
Löschen Sie keine vom Gast verwendeten Speichervolumes, und wenn die Domäne persistent ist,
kann später neu gestartet werden.

If Domain vorübergehend ist, gehen die Metadaten aller Snapshots verloren, sobald der Gast
wird nicht mehr ausgeführt, aber die Snapshot-Inhalte sind noch vorhanden und eine neue Domäne mit derselben
Name und UUID können die Snapshot-Metadaten mit wiederherstellen Schnappschuss-Erstellen.

If --anmutig angegeben ist, greifen Sie nicht zu extremen Maßnahmen (zB SIGKILL), wenn die
Gast hört nicht nach einer angemessenen Zeit auf; stattdessen einen Fehler zurückgeben.

domblkstat Domain [Block-Gerät] [--Mensch]
Rufen Sie Geräteblockstatistiken für eine laufende Domain ab. EIN Block-Gerät entspricht einem Unikat
Zielname ( ) oder Quelldatei ( ) für einen von
die angeschlossenen Plattengeräte Domain (Siehe auch Domblkliste um diese Namen aufzulisten). Auf
eine lxc- oder qemu-Domain, ohne die Block-Gerät liefert zusammenfassend Geräteblock-Statistiken
für die gesamte Domäne.

Wasser --Mensch für eine besser lesbare Ausgabe.

Die Verfügbarkeit dieser Felder hängt vom Hypervisor ab. Nicht unterstützte Felder fehlen
aus der Ausgabe. Andere Felder können erscheinen, wenn Sie mit einer neueren Version von . kommunizieren
libvirtd.

Erläuterung of Felder (Felder erscheinen in der folgenden Reihenfolge):
rd_req - Anzahl der Lesevorgänge
rd_bytes - Anzahl der gelesenen Bytes
wr_req - Anzahl der Schreibvorgänge
wr_bytes - Anzahl der geschriebenen Bytes
Fehler - Fehleranzahl
flush_operations - Anzahl der Spülvorgänge
rd_total_times - Gesamtzeit für Lesevorgänge (ns)
wr_total_times - Gesamtzeit für Schreibvorgänge (ns)
flush_total_times - Gesamtzeit für die Spülvorgänge (ns)
<-- andere vom Hypervisor bereitgestellte Felder -->

Domifaddr Domain [Schnittstelle] [--voll] [--Quelle Miete|Vermittler]
Rufen Sie eine Liste der Schnittstellen einer laufenden Domäne zusammen mit ihren IP- und MAC-Adressen ab, oder
begrenzte Ausgabe nur für eine Schnittstelle, wenn Schnittstelle angegeben. Beachten Sie, dass Schnittstelle
kann treiberabhängig sein, es kann der Name innerhalb des Gastbetriebssystems sein oder der Name, den Sie sehen würden
in Domänen-XML. Darüber hinaus erfordert der gesamte Befehl möglicherweise die Konfiguration eines Gast-Agenten
für die abgefragte Domain unter einigen Treibern, insbesondere qemu. Wenn --voll angegeben ist, die
Schnittstellenname wird immer angezeigt, wenn die Schnittstelle mehrere Adressen oder Alias ​​hat,
andernfalls zeigt es nur den Schnittstellennamen für die erste Adresse und "-" für die
Andere. Die --Quelle Argument gibt an, welche Datenquelle für die Adressen verwendet werden soll,
derzeit einer von 'lease' um DHCP-Leases zu lesen oder 'agent' um das Gastbetriebssystem über ein abzufragen
Agent. Wenn nicht angegeben, ist 'Lease' die Standardeinstellung.

domifstat Domain Schnittstellengerät
Rufen Sie Netzwerkschnittstellenstatistiken für eine ausgeführte Domäne ab.

domif-setlink Domain Schnittstellengerät Zustand [--config]
Ändern Sie den Verbindungsstatus der virtuellen Schnittstelle der Domäne. Mögliche Werte für den Zustand sind
"auf und ab". Wenn --config angegeben ist, wird nur die persistente Konfiguration der
Domain wird aus Kompatibilitätsgründen geändert, --hartnäckig ist ein Pseudonym von --config.
Schnittstellengerät kann der Zielname der Schnittstelle oder die MAC-Adresse sein.

domif-getlink Domain Schnittstellengerät [--config]
Linkstatus der virtuellen Schnittstelle der Domäne abfragen. Wenn --config angegeben ist, Abfrage
die persistente Konfiguration aus Kompatibilitätsgründen, --hartnäckig ist ein Pseudonym von
--config.

Schnittstellengerät kann der Zielname der Schnittstelle oder die MAC-Adresse sein.

Domiftun Domain Schnittstellengerät [[--config] [--Live] | [--aktuell]] [--eingehende
Durchschnitt, Spitze, Platzen, Boden] [--ausgehend Durchschnitt, Spitze, Burst]
Legen Sie die Bandbreitenparameter der Netzwerkschnittstelle der Domäne fest oder fragen Sie sie ab. Schnittstellengerät
kann der Zielname der Schnittstelle sein ( ) oder die MAC-Adresse.

Wenn nein --eingehende or --ausgehend angegeben ist, fragt dieser Befehl die ab und zeigt sie an
Bandbreiteneinstellungen. Andernfalls wird die eingehende oder ausgehende Bandbreite festgelegt.
Durchschnitt, Spitze, Platzen, Boden ist das gleiche wie im Befehl Attach-Schnittstelle. Werte für
durchschnittlich, Haupt und Boden werden in Kilobyte pro Sekunde ausgedrückt, während Burst is
ausgedrückt in Kilobyte in einem einzelnen Burst bei Haupt Geschwindigkeit wie in der Netzwerk-XML beschrieben
Dokumentation beihttp://libvirt.org/formatnetwork.html#elementQoS>.

Um die eingehenden oder ausgehenden Einstellungen zu löschen, verwenden Sie --eingehende or --ausgehend respektvoll mit
Durchschnittswert Null.

If --Live angegeben ist, betrifft einen laufenden Gast. Wenn --config angegeben ist, beeinflussen die
nächsten Booten eines persistenten Gasts. Wenn --aktuell angegeben ist, betrifft den aktuellen Gast
Zustand. Beide --Live und --config Flags können angegeben werden, aber --aktuell ist exklusiv. Wenn nein
Flag angegeben ist, ist das Verhalten je nach Hypervisor unterschiedlich.

Domemstat Domain [--Zeitraum Sekunden] [[--config] [--Live] | [--aktuell]]
Abrufen von Speicherstatistiken für eine laufende Domäne.

Je nach Hypervisor können verschiedene Statistiken zurückgegeben werden

Für QEMU/KVM mit einem Speicherballon, Einstellen des optionalen --Zeitraum auf einen Wert größer
als 0 in Sekunden ermöglicht es dem Ballonfahrer, zusätzliche Statistiken zurückzugeben, die
wird nachfolgend angezeigt Domemstat Befehle. Einstellen der --Zeitraum zu 0 wird
Stoppt die Ballonfahrersammlung, löscht aber nicht die Statistiken im Ballon
Treiber. Erfordert mindestens QEMU/KVM 1.5, um auf dem Host ausgeführt zu werden.

Der --Live, --configsowie --aktuell Flags sind nur gültig, wenn die --Zeitraum
Option, um den Abholzeitraum für den Ballonfahrer einzustellen. Wenn --Live is
angegeben, ist nur der laufende Gastsammelzeitraum betroffen. Wenn --config is
angegeben, wirken sich auf den nächsten Start eines persistenten Gasts aus. Wenn --aktuell angegeben,
wirken sich auf den aktuellen Gaststatus aus.

Beide --Live und --config Flags können angegeben werden, aber --aktuell ist exklusiv. Wenn keine Flagge ist
angegeben, ist das Verhalten je nach Gaststatus unterschiedlich.

domblkerror Domain
Fehler auf Blockgeräten anzeigen. Dieser Befehl ist normalerweise praktisch, wenn Domstaat Befehl
sagt, dass eine Domäne aufgrund eines E/A-Fehlers angehalten wurde. Die domblkerror Befehl listet alle auf
Blockgeräte im Fehlerzustand und den auf jedem von ihnen festgestellten Fehler.

Hausinfo Domain Block-Gerät
Informationen zur Blockgerätegröße für eine Domain abrufen. EIN Block-Gerät entspricht einem Unikat
Zielname ( ) oder Quelldatei ( ) für einen von
die angeschlossenen Plattengeräte Domain (Siehe auch Domblkliste um diese Namen aufzulisten).

Domblkliste Domain [--inaktiv] [--Einzelheiten]
Drucken Sie eine Tabelle mit den Kurzinformationen aller Blockgeräte, die mit verbunden sind
Domain. Wenn --inaktiv angegeben ist, fragen Sie die Blockgeräte ab, die auf dem
beim nächsten Booten statt derjenigen, die derzeit von einer laufenden Domäne verwendet werden. Wenn --Einzelheiten is
angegeben, werden auch der Festplattentyp und der Gerätewert gedruckt. Andere Kontexte, die
erfordern einen Blockgerätenamen (wie z Hausinfo or Schnappschuss-Erstellen für Festplatten-Snapshots)
akzeptiert entweder Ziel- oder eindeutige Quellennamen, die von diesem Befehl ausgegeben werden.

Domstatistiken [--roh] [--erzwingen] [--unterstützen] [--Zustand] [--cpu-gesamt] [--Ballon] [--vcpu]
[--Schnittstelle] [--Block] [[--list-aktiv] [--list-inaktiv] [--list-persistent]
[--list-transient] [--list-running] [--list-pausiert] [--list-shutoff] [--list-other]] |
[Domain ...]
Rufen Sie Statistiken für mehrere oder alle Domänen ab. Ohne Argument druckt dieser Befehl
alle verfügbaren Statistiken für alle Domänen.

Die Liste der Domains, für die Statistiken gesammelt werden sollen, kann entweder durch die Auflistung der Domains eingeschränkt werden
als durch Leerzeichen getrennte Liste oder durch Angabe eines der Filterflags --aufführen-*. (Das
Ansätze können nicht kombiniert werden.)

Standardmäßig können einige der zurückgegebenen Felder in benutzerfreundlichere Werte umgewandelt werden
von einer Reihe von hübschen Druckern. Um dieses Verhalten zu unterdrücken, verwenden Sie die --roh Flagge.

Die einzelnen Statistikgruppen sind über spezielle Flags auswählbar. Standardmäßig alle
unterstützte Statistikgruppen werden zurückgegeben. Unterstützte Statistikgruppen-Flags sind:
--Zustand, --cpu-gesamt, --Ballon, --vcpu, --Schnittstelle, --Block.

Bei der Auswahl der --Zustand Gruppe werden folgende Felder zurückgegeben: "state.state" -
Zustand der VM, zurückgegeben als Zahl von virDomainState enum, "state.reason" - Grund
zum Eingeben des gegebenen Zustands, zurückgegeben als int von virDomain*Reason Enum entsprechend
gegebenen Zustand.

--cpu-gesamt gibt zurück: "cpu.time" - Gesamte CPU-Zeit, die für diese Domäne in Nanosekunden aufgewendet wurde,
"cpu.user" - verbrauchte CPU-Zeit des Benutzers in Nanosekunden, "cpu.system" - verbrauchte CPU-Zeit des Systems
in Nanosekunden

--Ballon gibt zurück: "balloon.current" - der aktuell verwendete Speicher in kiB,
"balloon.maximum" - der maximal erlaubte Speicher in kiB

--vcpu gibt zurück: "vcpu.current" - aktuelle Anzahl virtueller Online-CPUs, "vcpu.maximum"
- maximale Anzahl virtueller Online-CPUs, "vcpu. .state" - Zustand der virtuellen CPU
, als Zahl aus virVcpuState enum, "vcpu. .time" - virtuelle CPU-Zeit, die von . ausgegeben wird
virtuelle CPU

--Schnittstelle gibt zurück: "net.count" - Anzahl der Netzwerkschnittstellen auf dieser Domain,
"Netz. .name" - Name der Schnittstelle , "Netz. .rx.bytes" - Anzahl der Bytes
erhalten, "netto. .rx.pkts" - Anzahl der empfangenen Pakete, "net. .rx.errs" -
Anzahl der Empfangsfehler, "net. .rx.drop" - Anzahl der verworfenen Empfangspakete,
"Netz. .tx.bytes" - Anzahl der übertragenen Bytes, "net. .tx.pkts" - Anzahl von
übertragene Pakete, "net. .tx.errs" - Anzahl der Übertragungsfehler,
"Netz. .tx.drop" - Anzahl der verworfenen Sendepakete

--Block gibt Informationen zu Datenträgern zurück, die jeder Domäne zugeordnet sind. Verwendung der
--unterstützen Flag erweitert diese Informationen, um alle Ressourcen in der unterstützenden Kette abzudecken,
anstatt die standardmäßige Beschränkung der Informationen auf die aktive Ebene für jeden Gast
Scheibe. Die aufgeführten Informationen umfassen: "block.count" - Anzahl der Blockgeräte, die
aufgelistet, "blockieren. .name" - Name des Ziels des Blockgeräts (das gleiche
Name für Mehrfacheinträge wenn --unterstützen vorhanden ist), "block. .backingIndex" - wann
--unterstützen ist vorhanden, stimmt mit dem überein Index in Domänen-XML aufgeführt
zum Sichern von Dateien "block. .path" - Dateiquelle des Blockgeräts , wenn es ein
lokale Datei oder Blockgerät, "block. .rd.reqs" - Anzahl der Leseanfragen,
"Block. .rd.bytes" - Anzahl der gelesenen Bytes, "block. .rd.times" - Gesamtzeit
(ns) für Lesevorgänge ausgegeben, "block. .wr.reqs" - Anzahl der Schreibanfragen,
"Block. .wr.bytes" - Anzahl der geschriebenen Bytes, "block. .wr.times" - Gesamtzeit
(ns) für Schreibvorgänge ausgegeben, "block. .fl.reqs" - Gesamte Flush-Anforderungen,
"Block. .fl.times" - Gesamtzeit (ns), die für das Leeren des Caches aufgewendet wurde, "block. .Fehler"
- Nur Xen: der 'oo_req'-Wert, "block. .allocation" - Offset des höchsten geschriebenen
Sektor in Bytes, "block. .capacity" - logische Größe der Quelldatei in Bytes,
"Block. .physical" - physikalische Größe der Quelldatei in Bytes

Die Auswahl einer bestimmten Statistikgruppe garantiert nicht, dass der Daemon die
ausgewählte Gruppe von Statistiken. Flagge --erzwingen zwingt den Befehl zum Scheitern, wenn der Daemon
unterstützt die ausgewählte Gruppe nicht.

Domifliste Domain [--inaktiv]
Drucken Sie eine Tabelle mit den Kurzinformationen aller virtuellen Schnittstellen, die mit verbunden sind
Domain. Wenn --inaktiv angegeben ist, fragen Sie die virtuellen Schnittstellen ab, die auf verwendet werden
beim nächsten Start, und nicht die, die derzeit von einer laufenden Domäne verwendet werden. Andere Kontexte
die eine MAC-Adresse der virtuellen Schnittstelle erfordern (wie z Trennschnittstelle or Domif-
Setlink) akzeptiert die von diesem Befehl ausgegebene MAC-Adresse.

Blockcommit Domain Weg [Bandbreite] [Base] [--seicht] [Top] [--löschen] [--relativ bleiben]
[--Warten [--async] [- ausführlich]] [--Auszeit Sekunden] [--aktiv] [{- Drehpunkt | --Keep-Overlay}]
Reduzieren Sie die Länge einer Backing-Image-Kette, indem Sie Änderungen am Anfang der
Kette (Schnappschuss- oder Delta-Dateien) in Backing-Images. Standardmäßig ist dieser Befehl
versucht, die gesamte Kette zu glätten. Wenn Base und / oder Top werden als Dateien angegeben
innerhalb der Backing Chain, dann ist die Operation darauf beschränkt, genau das zu begehen
Teil der Kette; --seicht kann anstelle von verwendet werden Base um die unmittelbare zu spezifizieren
Backing-Datei des resultierenden Top-Images, das festgeschrieben werden soll. Die Dateien, die übertragen werden
werden ungültig, möglicherweise sobald die Operation beginnt; Verwendung der --löschen
Flag versucht, diese ungültigen Dateien nach erfolgreichem Abschluss von . zu entfernen
die Commit-Operation. Wenn das --relativ bleiben Flag verwendet wird, die Pfade der Backing-Datei
wird relativ gehalten.

Wann Top weggelassen oder als aktives Bild angegeben wird, kann auch angegeben werden
--aktiv um einen zweiphasigen aktiven Commit auszulösen. In der ersten Phase, Top wird kopiert in
Base und der Job kann nur abgebrochen werden, wobei top noch Daten enthält, die noch nicht in base vorhanden sind.
In der zweiten Phase, Top und Base bleiben identisch bis ein Aufruf an Blockjob an. Nach der Installation können Sie HEIC-Dateien mit der
--abbrechen Flag (oben bleiben als aktives Bild, das Änderungen von diesem Punkt an verfolgt)
Zeit) oder die - Drehpunkt Flag (wodurch base zum neuen aktiven Image wird und top ungültig gemacht wird).

Standardmäßig kehrt dieser Befehl so schnell wie möglich zurück, und die Daten für die gesamte Festplatte sind
im Hintergrund begangen; der Fortschritt der Operation kann mit überprüft werden
Blockjob. jedoch, wenn --Warten angegeben ist, wird dieser Befehl blockiert, bis der
Vorgang abgeschlossen (oder für --aktiv, tritt in die zweite Phase ein) oder bis die Operation
wird storniert, weil das optionale Timeout in Sekunden vergeht oder SIGINT gesendet wird (normalerweise
mit "Strg-C"). Verwenden von - ausführlich zusammen mit --Warten erzeugt periodischen Status
Aktualisierung. Wenn eine Jobabsage ausgelöst wird, --async gibt die Kontrolle an den Benutzer zurück als
so schnell wie möglich, sonst kann der Befehl noch etwas länger blockieren
bis die Arbeit mit dem Aufräumen erledigt ist. Verwenden von - Drehpunkt ist die Abkürzung für das Kombinieren --aktiv
--Warten mit einer automatischen Blockjob - Drehpunkt; und verwenden --Keep-Overlay ist eine Abkürzung für
Vereinigung --aktiv --Warten mit einer automatischen Blockjob --abbrechen.

Weg gibt den vollqualifizierten Pfad des Datenträgers an; es entspricht einem einzigartigen Ziel
Name ( ) oder Quelldatei ( ) für einen der Datenträger
angeschlossene Geräte Domain (Siehe auch Domblkliste um diese Namen aufzulisten). Bandbreite
gibt das Kopierbandbreitenlimit in MiB/s an, obwohl es für qemu nur ungleich Null sein kann
für eine Online-Domain. Die Angabe eines negativen Werts wird als Long ohne Vorzeichen interpretiert
Long-Wert oder im Wesentlichen unbegrenzt. Der Hypervisor kann wählen, ob er den
Wert oder wandeln Sie ihn in den maximal zulässigen Wert um.

Blockkopie Domain Weg { dest [Format] [--blockdev] | --xml Datei } [--seicht]
[--wiederverwenden-extern] [Bandbreite] [--Warten [--async] [- ausführlich]] [{- Drehpunkt | --beenden}]
[--Auszeit Sekunden] [Die Granularität] [buf-größe]
Kopieren Sie eine Laufwerks-Backing-Image-Kette an ein Ziel. Entweder dest als Zieldatei
Name, oder --xml mit dem Namen einer XML-Datei mit einem Top-Level Element
Beschreibung des Ziels, muss vorhanden sein. Außerdem, wenn dest gegeben ist, Format
sollte angegeben werden, um das Format des Ziels zu deklarieren (wenn Format wurde weggelassen,
dann wird libvirt das Format der Quelle wiederverwenden, oder mit --wiederverwenden-extern wird sein
gezwungen, das Zielformat zu prüfen, was eine potenzielle Sicherheitslücke darstellen könnte).
Der Befehl unterstützt --roh als boolesches Flaggensynonym für --format=roh. Beim Benutzen
dest, wird das Ziel wie eine normale Datei behandelt, es sei denn --blockdev wird verwendet, um zu signalisieren
dass es sich um ein Blockgerät handelt. Standardmäßig glättet dieser Befehl die gesamte Kette; doch wenn
--seicht angegeben ist, teilt sich die Kopie die Sicherungskette.

If --wiederverwenden-extern angegeben ist, muss das Ziel existieren und genügend
Platz für die Kopie. Wenn --seicht wird in Verbindung mit verwendet --wiederverwenden-extern dann
Das vorab erstellte Bild muss für den Gast sichtbare Inhalte haben, die mit dem für den Gast sichtbaren Inhalt identisch sind
Inhalt der Backing-Datei des Originalbildes. Dies kann verwendet werden, um die
Backup-Dateinamen auf dem Ziel.

Der Kopierauftrag wird standardmäßig im Hintergrund ausgeführt und besteht aus zwei Phasen.
Zunächst muss der Job alle Daten aus der Quelle kopieren, und während dieser Phase muss der Job
kann nur abgebrochen werden, um zur Quellfestplatte zurückzukehren, ohne Garantien bezüglich der
Ziel. Nach Abschluss dieser Phase bleiben sowohl die Quelle als auch das Ziel erhalten
gespiegelt, bis ein Anruf an Blockjob an. Nach der Installation können Sie HEIC-Dateien mit der --abbrechen und - Drehpunkt Fahnen schwenken um zu
die Kopie, oder ein Anruf ohne - Drehpunkt verlässt das Ziel als getreue Kopie davon
Zeitpunkt. Wie auch immer, wenn --Warten angegeben ist, wird dieser Befehl blockiert, bis
die Spiegelungsphase beginnt, oder brechen Sie den Vorgang ab, wenn die optionale Timeout in Sekunden
abläuft oder SIGINT gesendet wird (normalerweise mit "Strg-C"). Verwenden von - ausführlich zusammen mit --Warten
erzeugt regelmäßige Statusaktualisierungen. Verwenden von - Drehpunkt (ähnlich zu Blockjob - Drehpunktoder
--beenden (ähnlich zu Blockjob --abbrechen) impliziert --Warten, und beendet zusätzlich die
sauber arbeiten, anstatt Dinge in der Spiegelungsphase zu belassen. Wenn die Stellenstreichung ist
ausgelöst durch Timeout oder durch --beenden, --async gibt dem Benutzer die Kontrolle so schnell zurück
wie möglich, sonst kann es sein, dass der Befehl noch etwas länger blockiert, bis
der Job wurde tatsächlich abgebrochen.

Weg gibt den vollqualifizierten Pfad des Datenträgers an. Bandbreite spezifiziert das Kopieren
Bandbreitenlimit in MiB/s. Die Angabe eines negativen Werts wird als vorzeichenlos interpretiert
long Long-Wert, der im Wesentlichen unbegrenzt sein könnte, aber wahrscheinlicher überlaufen würde;
es ist sicherer, 0 für diesen Zweck zu verwenden. Angabe Die Granularität ermöglicht die Feinabstimmung von
die Granularität, die kopiert wird, wenn ein schmutziger Bereich erkannt wird; größere Werte
weniger I/O-Overhead auslösen, aber möglicherweise insgesamt mehr Daten kopieren (der Standardwert
ist normalerweise richtig); Hypervisoren können dies auf eine Zweierpotenz beschränken oder innerhalb eines Bereichs liegen
eine gewisse Reichweite. Angabe buf-größe wird steuern, wie viele Daten gleichzeitig sein können
während des Kopierens im Flug; größere Werte verbrauchen mehr Speicher, ermöglichen aber möglicherweise schnellere
Vervollständigung (der Standardwert ist normalerweise richtig).

Blockzug Domain Weg [Bandbreite] [Base] [--Warten [- ausführlich] [--Auszeit Sekunden]
[--async]] [--relativ bleiben]
Füllen Sie eine Festplatte aus ihrer Backing-Image-Kette. Standardmäßig reduziert dieser Befehl die
gesamte Kette; doch wenn Base angegeben ist und den Namen eines der Backings enthält
Dateien in der Kette, dann wird diese Datei die neue Sicherungsdatei und nur die
Zwischenabschnitt der Kette wird gezogen. Sobald alle angeforderten Daten vom Backing
Image-Kette wurde gezogen, die Disk hängt nicht mehr von diesem Teil des Backings
Kette.

Standardmäßig kehrt dieser Befehl so schnell wie möglich zurück, und die Daten für die gesamte Festplatte sind
in den Hintergrund gezogen; der Fortschritt der Operation kann mit überprüft werden Blockjob.
Wie auch immer, wenn --Warten angegeben ist, wird dieser Befehl blockiert, bis die Operation
abschließt, oder brechen Sie den Vorgang ab, wenn das optionale Timeout in Sekunden vergeht oder
SIGINT wird gesendet (normalerweise mit "Strg-C"). Verwenden von - ausführlich zusammen mit --Warten werden wir
regelmäßige Statusaktualisierungen erstellen. Wenn eine Jobabsage ausgelöst wird, --async werden wir
Geben Sie die Kontrolle so schnell wie möglich an den Benutzer zurück, andernfalls kann der Befehl fortgesetzt werden
etwas länger blockieren, bis die Arbeit mit dem Aufräumen erledigt ist.

Verwendung der --relativ bleiben Flag hält die Namen der Backing Chain relativ.

Weg gibt den vollqualifizierten Pfad des Datenträgers an; es entspricht einem einzigartigen Ziel
Name ( ) oder Quelldatei ( ) für einen der Datenträger
angeschlossene Geräte Domain (Siehe auch Domblkliste um diese Namen aufzulisten). Bandbreite
gibt das Kopierbandbreitenlimit in MiB/s an. Die Angabe eines negativen Wertes wird interpretiert
als Long-Long-Wert ohne Vorzeichen oder im Wesentlichen unbegrenzt. Der Hypervisor kann wählen
ob der Wert abgelehnt oder in den maximal zulässigen Wert konvertiert werden soll.

schwarzdeviotune Domain Gerät [[--config] [--Live] | [--aktuell]] [[Gesamt-Byte-Sek.] | [lesen-
Byte-Sek] [schreiben-bytes-sec]] [[total-iops-sek] | [Read-iops-sec] [schreiben-iops-sek]]
[[gesamt-bytes-sek-max] | [lesen-bytes-sec-max] [schreiben-bytes-sec-max]] [[gesamt-iops-s-max]
| [Read-iops-sec-max] [schreiben-iops-sec-max]] [Größe-iops-sec]
Festlegen oder Abfragen der Blockdisk-IO-Parameter für ein Blockgerät von Domain. Gerät
gibt einen eindeutigen Zielnamen an ( ) oder Quelldatei (
file='name'/>) für eines der angeschlossenen Laufwerke Domain (Siehe auch Domblkliste für
Auflistung dieser Namen).

Wenn kein Grenzwert angegeben ist, wird die aktuelle E/A-Grenzwerteinstellung abgefragt. Ansonsten ändern
die Grenzen mit diesen Flags: --total-bytes-sec gibt die Gesamtdurchsatzgrenze in . an
Byte pro Sekunde. --read-bytes-sek gibt das Lesedurchsatzlimit in Bytes pro an
zweite. --write-bytes-sek gibt die Schreibdurchsatzgrenze in Bytes pro Sekunde an.
--total-iops-sec gibt das Gesamtlimit der E/A-Operationen pro Sekunde an. --read-iops-sek
gibt das Limit für Lese-E/A-Operationen pro Sekunde an. --write-iops-sek spezifiziert Schreib-I/O
Betriebslimit pro Sekunde. --total-bytes-sec-max gibt den maximalen Gesamtdurchsatz an
Begrenzung in Bytes pro Sekunde. --read-bytes-sec-max gibt den maximalen Lesedurchsatz an
Begrenzung in Bytes pro Sekunde. --write-bytes-sec-max gibt den maximalen Schreibdurchsatz an
Begrenzung in Bytes pro Sekunde. --total-iops-sec-max spezifiziert maximale Gesamt-I/O
Betriebslimit pro Sekunde. --read-iops-sec-max spezifiziert maximale Lese-E/A
Betriebslimit pro Sekunde. --write-iops-sec-max spezifiziert maximale Schreib-I/O
Betriebslimit pro Sekunde. --size-iops-sek spezifiziert die Größe der E/A-Operationen pro
zweite.

Ältere Versionen von virsh akzeptierten diese Optionen nur mit Unterstrich statt Bindestrich.
wie in --total_bytes_sec.

Bytes- und Iops-Werte sind unabhängig, aber es wird nur ein Wert eingestellt (z. B.
--read-bytes-sec) setzt die anderen beiden in dieser Kategorie auf unbegrenzt zurück. Eine explizite 0
löscht auch jede Grenze. Ein Wert ungleich Null für eine gegebene Summe kann nicht mit Nicht-Null-Werten gemischt werden.
Nullwerte für Lesen oder Schreiben.

If --Live angegeben ist, betrifft einen laufenden Gast. Wenn --config angegeben ist, beeinflussen die
nächsten Booten eines persistenten Gasts. Wenn --aktuell angegeben ist, betrifft den aktuellen Gast
Zustand. Beim Einstellen der Disk io-Parameter beide --Live und --config Flaggen können sein
gegeben, aber --aktuell ist exklusiv. Zum Abfragen nur eines von --Live, --config or
--aktuell angegeben werden kann. Wenn kein Flag angegeben ist, unterscheidet sich das Verhalten je nach
auf Hypervisor.

Blockjob Domain Weg { [--abbrechen] [--async] [- Drehpunkt] | [--die Info] [--roh] [- Bytes] |
[Bandbreite]}
Aktive Blockoperationen verwalten. Es gibt drei sich gegenseitig ausschließende Modi: --die Info,
Bandbreitesowie --abbrechen. --async und - Drehpunkt implizieren Abbruchmodus; --roh impliziert Info
Modus; und wenn kein Modus angegeben wurde, --die Info Modus vorausgesetzt.

Weg gibt den vollqualifizierten Pfad des Datenträgers an; es entspricht einem einzigartigen Ziel
Name ( ) oder Quelldatei ( ) für einen der Datenträger
angeschlossene Geräte Domain (Siehe auch Domblkliste um diese Namen aufzulisten).

In --abbrechen Modus wird der aktive Job auf der angegebenen Platte abgebrochen. Wenn --async is
ebenfalls angegeben, wird dieser Befehl sofort zurückkehren, anstatt auf die zu warten
Stornierung abzuschließen. Wenn - Drehpunkt angegeben ist, fordert dies eine aktive Kopie an
oder aktiver Commit-Job auf das neue Image geschwenkt werden.

In --die Info Modus werden die aktiven Jobinformationen auf dem angegebenen Datenträger gedruckt. Von
Standardmäßig ist die Ausgabe eine einzelne von Menschen lesbare Zusammenfassungszeile; Dieses Format kann sich ändern in
zukünftige Versionen. Hinzufügen --roh listet jedes Feld der Struktur in einem stabilen Format auf. Wenn
- Bytes Flag gesetzt ist, dann wird der Befehl fehlgeschlagen, wenn der Server nicht liefern konnte
Byte/s Auflösung; Wenn das Flag weggelassen wird, wird die Rohausgabe in MiB/s und in Human-
Die lesbare Ausgabe wählt automatisch die beste vom Server unterstützte Auflösung.

Bandbreite kann verwendet werden, um das Bandbreitenlimit für den aktiven Job festzulegen. Angabe von a
negativer Wert wird als Long-Wert ohne Vorzeichen oder im Wesentlichen unbegrenzt interpretiert.
Der Hypervisor kann wählen, ob er den Wert ablehnt oder in das Maximum umwandelt
Wert erlaubt.

Blockgröße Domain Weg Größe
Ändern Sie die Größe eines Blockgeräts der Domäne, während die Domäne ausgeführt wird. Weg spezifiziert das
absoluter Pfad des Blockgeräts; es entspricht einem eindeutigen Zielnamen (
dev='name'/>) oder Quelldatei ( ) für eines der Plattengeräte
angehängt an Domain (Siehe auch Domblkliste um diese Namen aufzulisten).

Größe ist eine skalierte ganze Zahl (siehe ANMERKUNG oben), die standardmäßig auf KiB (Blöcke von 1024 .)
Bytes), wenn kein Suffix vorhanden ist. Sie müssen ein Suffix von "B" verwenden, um Bytes zu erhalten (beachten Sie, dass
aus historischen Gründen unterscheidet sich dies von Vol-Größe ändern was standardmäßig Bytes ohne a . ist
Suffix).

Domanzeige Domain [--include-Passwort] [[--Typ] tippe]
Geben Sie eine URI aus, über die eine Verbindung zur grafischen Darstellung der Domäne hergestellt werden kann über
VNC, SPICE oder RDP. Die jeweilige grafische Darstellungsart kann über die
tippe Parameter (zB "vnc", "spice", "rdp"). Wenn --include-Passwort angegeben ist, die
Das SPICE-Kanalpasswort wird in die URI aufgenommen.

domfsinfo Domain
Zeigt eine Liste der gemounteten Dateisysteme innerhalb der laufenden Domäne an. Die Liste enthält
Einhängepunkte, Namen eines gemounteten Geräts im Gast, Dateisystemtypen und eindeutige
Zielnamen, die in der Domänen-XML verwendet werden ( ).

Beachten Sie, dass für diesen Befehl ein Gast-Agent erforderlich ist, der im der Domäne konfiguriert und ausgeführt wird
Gastbetriebssystem.

domfsfreeze Domain [[--Einhängepunkt] Einhängepunkt...]
Frieren Sie eingehängte Dateisysteme innerhalb einer laufenden Domäne ein, um sich auf konsistente . vorzubereiten
Schnappschüsse.

Der --Einhängepunkt Option nimmt einen Parameter an Einhängepunkt, das ist ein Einhängepunktpfad von
das Dateisystem eingefroren werden soll. Diese Option kann mehrmals vorkommen. Wenn dies nicht der Fall ist
angegeben, wird jedes gemountete Dateisystem eingefroren.

Hinweis: Schnappschuss-Erstellen Befehl hat a - Ruhe Möglichkeit zum Einfrieren und Auftauen
Dateisysteme automatisch, um Snapshots konsistent zu halten. domfsfreeze Befehl ist nur
erforderlich, wenn ein Benutzer die nativen Snapshot-Funktionen von Speichergeräten nutzen möchte
nicht von libvirt unterstützt.

domfstau Domain [[--Einhängepunkt] Einhängepunkt...]
Tauen Sie gemountete Dateisysteme innerhalb einer laufenden Domain auf, die eingefroren wurden durch
domfsfreeze-Befehl.

Der --Einhängepunkt Option nimmt einen Parameter an Einhängepunkt, das ist ein Einhängepunktpfad von
das Dateisystem aufgetaut werden. Diese Option kann mehrmals vorkommen. Wenn dies nicht der Fall ist
angegeben, wird jedes gemountete Dateisystem aufgetaut.

Domfstrim Domain [--Minimum Bytes] [--Einhängepunkt Einhängepunkt]
Geben Sie einen fstrim-Befehl auf allen gemounteten Dateisystemen innerhalb einer laufenden Domäne aus. Es verwirft
Blöcke, die vom Dateisystem nicht verwendet werden. Wenn --Minimum Bytes angegeben ist, es
teilt dem Gast-Kernel die Länge des zusammenhängenden freien Bereichs mit. Kleiner als dies kann ignoriert werden
(Dies ist ein Hinweis und der Gast kann ihn nicht respektieren). Durch Erhöhen dieses Wertes wird der
Der fstrim-Vorgang wird für Dateisysteme mit stark fragmentierten freien schneller abgeschlossen
Platz, obwohl nicht alle Blöcke verworfen werden. Der Standardwert ist null, d. h.
"jeden freien Block verwerfen". Wenn der Benutzer außerdem nur einen Einhängepunkt trimmen möchte, ist es
kann über optional angegeben werden --Einhängepunkt Parameters.

Domhostname Domain
Gibt den Hostnamen einer Domäne zurück, wenn der Hypervisor diesen zur Verfügung stellt.

Dominfo Domain
Gibt grundlegende Informationen über die Domäne zurück.

Domuuid Domänenname-oder-ID
Konvertieren Sie einen Domänennamen oder eine ID in eine Domänen-UUID

dominant Domänenname-oder-uuid
Konvertieren Sie einen Domainnamen (oder UUID) in eine Domain-ID

Domjobabbruch Domain
Brechen Sie den aktuell laufenden Domänenjob ab.

Domjobinfo Domain [--vollendet]
Gibt Informationen zu Jobs zurück, die in einer Domäne ausgeführt werden. --vollendet sagt Virsh, dass er zurückkehren soll
Informationen zu einem kürzlich abgeschlossenen Job. Statistiken eines abgeschlossenen Jobs sind
wird automatisch zerstört, sobald libvirtd gelesen oder neu gestartet wird. Merken Sie sich diese Zeit
Informationen, die für abgeschlossene Migrationen zurückgegeben werden, können völlig irrelevant sein, es sei denn, beide
Quell- und Zielhosts haben eine synchronisierte Zeit (dh der NTP-Daemon läuft auf
beide).

Domname Domain-ID-oder-UUID
Konvertieren Sie eine Domain-ID (oder UUID) in einen Domainnamen

Domrename Domain neuer Name
Benennen Sie eine Domäne um. Dieser Befehl ändert den aktuellen Domänennamen in den neuen Namen, der in angegeben ist
das zweite Argument.

Hinweis: Die Domäne muss inaktiv und ohne Snapshots sein.

Domstaat Domain [--Grund]
Gibt den Status einer Domäne zurück. --Grund weist virsh an, auch den Grund für die zu drucken
Zustand.

Domkontrolle Domain
Gibt den Status einer Schnittstelle an VMM zurück, die zum Steuern einer Domäne verwendet wird. Für andere Staaten als
"ok" oder "error" der Befehl gibt auch die Anzahl der Sekunden aus, die seit der Kontrolle verstrichen sind
Schnittstelle in den aktuellen Zustand übergegangen.

Domtime Domain { [--jetzt] [--ziemlich] [--sync] [--Zeit Zeit]}
Ruft die Systemzeit der Domäne ab oder legt diese fest. Bei Ausführung ohne Argumente (aber Domain),
die Systemzeit der aktuellen Domäne wird ausgedruckt. Die --ziemlich Modifikator kann verwendet werden, um
Drucken Sie die Zeit in besser lesbarer Form aus.

Wann --Zeit Zeit angegeben ist, wird die Zeit der Domain nicht geholt, sondern gesetzt. Die
--jetzt Modifikator verhält sich, als wäre es ein Alias ​​für --Zeit $jetzt, was bedeutet, dass es die
Zeit, die derzeit auf dem Host virsh läuft. In beiden Fällen (Einstellung und
immer), ist die Zeit in Sekunden relativ zur Epoche vom 1970 in UTC. Die --sync
ändert das eingestellte Verhalten etwas: Die verstrichene Zeit wird ignoriert, aber die Zeit zum Einstellen ist
Lesen Sie stattdessen von der RTC der Domäne. Bitte beachten Sie, dass einige Hypervisor möglicherweise einen Gast benötigen
Agent konfiguriert werden, um die Gastzeit abzurufen oder einzustellen.

domxml-von-nativ Format Config
Konvertieren Sie die Datei Config im nativen Gastkonfigurationsformat namens Format zum
Domänen-XML-Format. Für QEMU/KVM-Hypervisor ist der Format Argument muss sein qemu-argv. For
Xen-Hypervisor, der Format Argument kann sein xen-xm, xen-xloder xen-sxpr. Für LXC
Hypervisor, der Format Argument muss sein lxc-tools.

domxml-zu-nativ Format xml
Konvertieren Sie die Datei xml im Domänen-XML-Format in das native Gastkonfigurationsformat
benannt von Format. Für QEMU/KVM-Hypervisor ist der Format Argument muss sein qemu-argv. For
Xen-Hypervisor, der Format Argument kann sein xen-xm, xen-xloder xen-sxpr. Für LXC
Hypervisor, der Format Argument muss sein lxc-tools.

abladen Domain Kerndateipfad [--bypass-cache] { [--Live] | [--Absturz] | [--zurücksetzen] } [- ausführlich]
[--nur Speicher] [--Format Schnur]
Speichert den Kern einer Domäne zur Analyse in einer Datei. Wenn --Live angegeben ist, die Domain
läuft weiter, bis der Core-Dump abgeschlossen ist, anstatt zu pausieren. Wenn
--Absturz angegeben ist, wird die Domain mit einem abgestürzten Status angehalten und nicht nur
in einem angehaltenen Zustand belassen. Wenn --zurücksetzen angegeben ist, wird die Domain nach erfolgreicher Ausführung zurückgesetzt
entsorgen. Beachten Sie, dass sich diese drei Schalter gegenseitig ausschließen. Wenn --bypass-cache is
angegeben, vermeidet das Speichern den Dateisystem-Cache, obwohl dies die Datei verlangsamen kann
Betrieb. Wenn --nur Speicher angegeben ist, ist die Datei elf Datei und enthält nur
Speicher- und CPU-Common-Registerwert der Domäne. Es ist sehr nützlich, wenn die Domain verwendet
Host-Geräte direkt. --Format Schnur wird verwendet, um das Format von 'nur Speicher' anzugeben
entsorgen, und Schnur kann einer von ihnen sein: elf, kdump-zlib(kdump-komprimiertes Format mit
zlib-komprimiert), kdump-lzo (kdump-komprimiertes Format mit lzo-komprimiert),
kdump-snappy(kdump-komprimiertes Format mit snappy-compressed).

Der Fortschritt kann überwacht werden mit Domjobinfo virsh-Befehl und abgebrochen mit
Domjobabbruch Befehl (von einer anderen virsh-Instanz gesendet). Eine andere Möglichkeit ist das Senden von SIGINT
(normalerweise mit "Strg-C") zum laufenden virsh-Prozess abladen Befehl. - ausführlich Displays
der Fortschritt der Deponierung.

HINWEIS: Bei einigen Hypervisoren muss der Benutzer möglicherweise manuell die richtigen Berechtigungen für
Datei und Pfad angegeben durch Argument Kerndateipfad.

dumpxml Domain [--inaktiv] [--Sicherheitsinformationen] [--update-cpu] [--migrationsfähig]
Geben Sie die Domäneninformationen als XML-Dump auf stdout aus, dieses Format kann von den
erstellen Befehl. Zusätzliche Optionen, die den XML-Dump betreffen, können verwendet werden. --inaktiv
weist virsh an, die Domänenkonfiguration zu speichern, die beim nächsten Start der Domäne verwendet wird
im Gegensatz zur aktuellen Domänenkonfiguration. Verwenden von --Sicherheitsinformationen wird auch
sicherheitsrelevante Informationen in den XML-Dump einschließen. --update-cpu aktualisiert Domäne
CPU-Anforderungen gemäß Host-CPU. Mit --migrationsfähig man kann eine XML anfordern, die
ist für Migrationen geeignet, dh kompatibel mit älteren libvirt-Releases und möglicherweise
mit internen Laufzeitoptionen ergänzt. Diese Option aktiviert möglicherweise automatisch andere
Optionen (--update-cpu, --Sicherheitsinformationen, ...) wie nötig.

bearbeiten Domain
Bearbeiten Sie die XML-Konfigurationsdatei für eine Domäne, die sich auf den nächsten Start des
Gast.

Dies ist äquivalent zu:

virsh dumpxml --inactive --security-info domain > domain.xml
vi domain.xml (oder nehmen Sie Änderungen mit Ihrem anderen Texteditor vor)
virsh definieren domain.xml

außer dass es einige Fehlerüberprüfungen durchführt.

Der verwendete Editor kann durch die Umgebungsvariablen $VISUAL oder $EDITOR bereitgestellt werden, und
standardmäßig auf "vi".

Event {[Domain] { Event | --alle } [--Schleife] [--Auszeit Sekunden] [--Zeitstempel] | --aufführen}
Warten Sie, bis eine Klasse von Domänenereignissen auftritt, und drucken Sie die entsprechenden Details der Ereignisse als
sie passieren. Die Ereignisse können optional gefiltert werden nach Domain. Mit --aufführen wie die
nur Argument liefert eine Liste möglicher Event diesem Kunden bekannte Werte,
obwohl die Verbindung möglicherweise nicht die Registrierung für alle diese Ereignisse zulässt. Es ist auch
möglich zu verwenden --alle statt Event um sich für alle möglichen Veranstaltungsarten anzumelden unter
Einmal.

Standardmäßig ist dieser Befehl einmalig und gibt Erfolg zurück, sobald ein Ereignis eintritt; Sie
kann SIGINT (normalerweise über "Strg-C") senden, um sofort zu beenden. Wenn --Auszeit is
angegeben, gibt der Befehl das Warten auf Ereignisse nach . auf Sekunden verstrichen sind. Mit
--Schleife, druckt der Befehl alle Ereignisse bis zu einem Timeout oder einer Unterbrechungstaste.

Wann --Zeitstempel verwendet wird, wird vor der Veranstaltung ein lesbarer Zeitstempel gedruckt.

iothreadinfo Domain [[--Live] [--config] | [--aktuell]]
Zeigt grundlegende Domänen-IOThreads-Informationen an, einschließlich der IOThread-ID und der CPU
Affinität für jeden IOThread.

If --Live angegeben ist, rufen Sie die IOThreads-Daten vom laufenden Gast ab. Wenn der Gast ist
nicht ausgeführt wird, wird ein Fehler zurückgegeben. Wenn --config angegeben ist, holen Sie sich die IOThreads-Daten
vom nächsten Booten eines persistenten Gasts. Wenn --aktuell angegeben ist oder --Live und
--config nicht angegeben sind, erhalten Sie die IOThread-Daten basierend auf dem aktuellen Gast
Zustand.

jothreadpin Domain jothread Kpulist [[--Live] [--config] | [--aktuell]]
Ändern Sie das Anheften eines Domänen-IOThreads, um physische CPUs zu hosten. Um a . abzurufen
Liste aller IOThreads, verwenden iothreadinfo. Anpinnen jothread Präzisiere das Kpulist
erwünscht für die IOThread ID wie in der Liste aufgeführt iothreadinfo Ausgabe.

Kpulist ist eine Liste mit physischen CPU-Nummern. Seine Syntax ist eine durch Kommas getrennte Liste und a
spezielles Markup mit '-' und '^' (zB '0-4', '0-3,^2') kann ebenfalls zugelassen werden. Die '-'
bezeichnet den Bereich und das '^' bezeichnet exklusiv. Wenn Sie iothreadpin zurücksetzen möchten
Einstellung, d. h. zum Anheften an jothread für alle physischen CPUs geben Sie einfach 'r' als a . an
Kpulist.

If --Live angegeben ist, betrifft einen laufenden Gast. Wenn der Gast nicht ausgeführt wird, ein Fehler
ist zurück gekommen. Wenn --config angegeben ist, wirken sich auf den nächsten Start eines persistenten Gasts aus.
If --aktuell angegeben ist oder --Live und --config nicht angegeben sind, wirken sich auf den Strom aus
Gastzustand. Beide --Live und --config Flaggen dürfen gegeben werden, wenn Kpulist ist vorhanden, aber
--aktuell ist exklusiv. Wenn kein Flag angegeben ist, unterscheidet sich das Verhalten je nach
Hypervisor.

Hinweis: Der Ausdruck wird sequentiell ausgewertet, also ist "0-15,^8" identisch mit
"9-14,0-7,15", aber nicht identisch mit "^8,0-15".

iothreadadd Domain iothread_id [[--config] [--Live] | [--aktuell]]
Fügen Sie der Domäne einen neuen IOThread mit dem angegebenen . hinzu iothread_id. Wenn der iothread_id
bereits existiert, schlägt der Befehl fehl. Die iothread_id muss größer als null sein.

If --Live angegeben ist, betrifft einen laufenden Gast. Wenn der Gast keinen Fehler ausführt
ist zurück gekommen. Wenn --config angegeben ist, wirken sich auf den nächsten Start eines persistenten Gasts aus.
If --aktuell angegeben ist oder --Live und --config nicht angegeben sind, wirken sich auf den Strom aus
Gastzustand.

jothreaddel Domain iothread_id [[--config] [--Live] | [--aktuell]]
Löschen Sie einen IOThread aus der Domäne mit dem angegebenen iothread_id. Wenn ein IOThread ist
derzeit einer Datenträgerressource zugewiesen, z. B. über die Attach-Disk Befehl, dann die
Der Versuch, den IOThread zu entfernen, schlägt fehl. Wenn die iothread_id existiert kein Fehler
wird passieren.

If --Live angegeben ist, betrifft einen laufenden Gast. Wenn der Gast keinen Fehler ausführt
ist zurück gekommen. Wenn --config angegeben ist, wirken sich auf den nächsten Start eines persistenten Gasts aus.
If --aktuell angegeben ist oder --Live und --config nicht angegeben sind, wirken sich auf den Strom aus
Gastzustand.

verwaltetsave Domain [--bypass-cache] [{--Laufen | --pausiert}] [- ausführlich]
Speichern und zerstören (stoppen) Sie eine laufende Domäne, damit sie im gleichen Zustand neu gestartet werden kann
zu einem späteren Zeitpunkt. Wenn die virsh Anfang Befehl wird als nächstes für die Domäne ausgeführt, er wird
automatisch aus diesem gespeicherten Zustand gestartet werden. Wenn --bypass-cache angegeben ist, die
save wird den Dateisystemcache vermeiden, obwohl dies den Vorgang verlangsamen kann.

Der Fortschritt kann überwacht werden mit Domjobinfo virsh-Befehl und abgebrochen mit
Domjobabbruch Befehl (von einer anderen virsh-Instanz gesendet). Eine andere Möglichkeit ist das Senden von SIGINT
(normalerweise mit "Strg-C") zum laufenden virsh-Prozess verwaltetsave Befehl. - ausführlich
zeigt den Fortschritt des Speicherns an.

Normalerweise entscheidet das Starten eines verwalteten Speichers, ob er ausgeführt oder pausiert wird
angeben, in dem sich die Domäne befand, als die Speicherung durchgeführt wurde; vorbei entweder die --Laufen or
--pausiert Flag ermöglicht das Überschreiben, welcher Zustand der Anfang sollte nutzen.

Der Dominfo Mit dem Befehl kann abgefragt werden, ob eine Domain derzeit über verwaltete
Bild speichern.

verwaltetsave-remove Domain
Entferne das verwaltetsave state-Datei für eine Domäne, falls vorhanden. Dies stellt sicher, dass die Domäne
führt beim nächsten Start einen vollständigen Bootvorgang durch.

maxvcpus [tippe]
Geben Sie die maximale Anzahl virtueller CPUs an, die für eine Gast-VM auf diesem unterstützt werden
Verbindung. Falls vorhanden, tippe Parameter muss ein gültiges Typattribut für die
XML-Element.

CPU-Statistiken Domain [--gesamt] [Anfang] [zählen]
Stellen Sie CPU-Statistikinformationen einer Domäne bereit. Die Domäne sollte ausgeführt werden. Standard
es zeigt Statistiken für alle CPUs und eine Gesamtsumme. Benutzen --gesamt nur für die Gesamtstatistik, Anfang
nur für die Pro-CPU-Statistiken der CPUs von Anfang, zählen für nur zählen CPU-Statistiken.

Metadaten Domain [[--Live] [--config] | [--aktuell]] [--bearbeiten] [uri] [Haupt] [kompensieren] [--Löschen]
Benutzerdefinierte XML-Metadaten einer Domäne anzeigen oder ändern. Die Metadaten sind ein benutzerdefiniertes XML
das erlaubt, beliebige XML-Daten in der Domänendefinition zu speichern. Mehrere getrennt
benutzerdefinierte Metadatenteile können in der Domänen-XML gespeichert werden. Die Stücke sind gekennzeichnet durch
ein privater XML-Namensraum, der über das . bereitgestellt wird uri Streit. (Siehe auch desc das funktioniert mit
textuelle Metadaten einer Domain.)

Flags --Live or --config Wählen Sie aus, ob dieser Befehl live oder dauerhaft funktioniert
Definitionen der Domäne. Wenn beides --Live und --config angegeben sind, die --config
Option hat Vorrang beim Abrufen der aktuellen Beschreibung und der Live-Konfiguration
und config werden beim Festlegen der Beschreibung aktualisiert. --aktuell ist exklusiv und
impliziert, wenn nichts davon angegeben wurde.

Flagge --Löschen gibt an, dass das von der uri Argument sollte
eher entfernt als aktualisiert werden.

Flagge --bearbeiten gibt an, dass ein Editor mit den Metadaten, die durch den uri Argument
geöffnet und der Inhalt anschließend wieder gespeichert werden soll. Ansonsten die neuen Inhalte
kann über die bereitgestellt werden kompensieren Argument.

Beim Festlegen von Metadaten über --bearbeiten or kompensieren Haupt Argument muss angegeben werden und wird verwendet
um die benutzerdefinierten Elemente voranzustellen, um sie an den privaten Namespace zu binden.

Wenn keiner von --bearbeiten und kompensieren angegeben werden die XML-Metadaten entsprechend den uri
Namespace wird angezeigt, anstatt geändert zu werden.

migriert [--Live] [--offline] [--Direkte] [--p2p [--getunnelt]] [--hartnäckig]
[--undefinesource] [--aussetzen] [--copy-storage-all] [--copy-storage-inc]
[--change-protection] [--unsicher] [- ausführlich] [--komprimiert] [--abort-on-error]
[--auto-konvergieren] Domain desturi [migrieren] [Grafikuri] [Hör-Adresse] [Name]
[--Auszeit Sekunden] [--xml Datei] [--migrate-disks Diskettenliste]
Migrieren Sie die Domäne auf einen anderen Host. Hinzufügen --Live für Live-Migration; <--p2p> für
Peer-2-Peer-Migration; --Direkte für direkte Migration; oder --getunnelt für getunnelt
Migration. --offline migriert die Domänendefinition, ohne die Domäne zu starten
Ziel und ohne es auf dem Quellhost zu stoppen. Offline-Migration kann verwendet werden
mit inaktiven Domänen und muss verwendet werden mit --hartnäckig . --hartnäckig
lässt die Domain auf dem Zielhost persistent, --undefinesource und definiert die
Domain auf dem Quellhost und --aussetzen lässt die Domain auf dem Ziel pausieren
Gastgeber. --copy-storage-all zeigt die Migration mit nicht gemeinsam genutztem Speicher mit voller Festplatte an
Kopieren, --copy-storage-inc zeigt die Migration mit nicht gemeinsam genutztem Speicher mit inkrementellem an
kopieren (dasselbe Basis-Image wird zwischen Quelle und Ziel geteilt). In beiden Fällen ist die Scheibe
Bilder müssen auf dem Zielhost vorhanden sein, die --Kopie-Speicher-... Optionen nur sagen
libvirt, um Daten von den Bildern auf dem Quellhost zu den Bildern zu übertragen, die auf dem gefunden werden
gleiche Stelle auf dem Zielhost. Standardmäßig sind nur nicht freigegebene, nicht schreibgeschützte Bilder
übertragen. Benutzen --migrate-disks um explizit eine Liste von Festplattenzielen zu spezifizieren
Übergabe durch Komma getrennt Diskettenliste Argument. --change-protection erzwingt das
Während der Migration werden keine inkompatiblen Konfigurationsänderungen an der Domäne vorgenommen
ist unterwegs; Dieses Flag ist implizit aktiviert, wenn es vom Hypervisor unterstützt wird, kann aber
explizit verwendet werden, um die Migration abzulehnen, wenn der Hypervisor keinen Änderungsschutz besitzt
unterstützen. - ausführlich zeigt den Fortschritt der Migration an. --komprimiert aktiviert
Komprimierung von Speicherseiten, die während des Live-Betriebs wiederholt übertragen werden müssen
Migration. --abort-on-error bricht die Migration ab, wenn ein Soft Error (zum Beispiel I/O
error) tritt während der Migration auf. --auto-konvergieren erzwingt Konvergenz während des Lebens
Migration.

Hinweis: Einzelne Hypervisor unterstützen normalerweise nicht alle möglichen Migrationsarten.
QEMU unterstützt beispielsweise keine direkte Migration.

In einigen Fällen kann libvirt die Migration der Domäne verweigern, da dies zu
potenzielle Probleme wie Datenkorruption, und daher wird die Migration in Betracht gezogen
unsicher. Bei einer QEMU-Domäne kann dies passieren, wenn die Domäne Festplatten ohne explizit verwendet
Cache-Modus auf "none" setzen. Die Migration solcher Domänen ist unsicher, es sei denn, die Disk-Images
werden auf einem kohärenten geclusterten Dateisystem wie GFS2 oder GPFS gespeichert. Wenn Sie sicher sind, dass
Migration ist sicher oder es ist Ihnen einfach egal, verwenden Sie --unsicher die Migration zu erzwingen.

Name wird verwendet, um die Domain während der Migration in einen neuen Namen umzubenennen, was normalerweise auch
kann ausgelassen werden. Ebenfalls, --xml Datei wird normalerweise weggelassen, kann aber verwendet werden, um eine
alternative XML-Datei zur Verwendung am Ziel, um einen größeren Satz von Änderungen an bereitzustellen
alle hostspezifischen Teile der Domänen-XML, wie z. B. die Namensnennung
Unterschiede zwischen Quelle und Ziel beim Zugriff auf den zugrunde liegenden Speicher.

--Auszeit Sekunden zwingt den Gast zum Aussetzen, wenn die Live-Migration so viele überschreitet
Sekunden, und dann wird die Migration offline abgeschlossen. Es kann nur verwendet werden mit
--Live.

Die laufende Migration kann abgebrochen werden, indem man virsh unterbricht (normalerweise mit "Strg-C") oder durch
Domjobabbruch Befehl, der von einer anderen virsh-Instanz gesendet wurde.

Der desturi und migrieren Parameter können verwendet werden, um zu steuern, welches Ziel
Migration verwendet. desturi ist wichtig für verwaltete Migration, aber ungenutzt für direkte
Migration; migrieren ist für die direkte Migration erforderlich, kann aber in der Regel sein
automatisch für die verwaltete Migration bestimmt.

Hinweis: Der desturi Parameter für normale Migration und Peer2Peer-Migration hat unterschiedliche
Semantik:

· normale Migration: die desturi ist eine Adresse des Zielhosts aus Sicht des
Client-Maschine.

· Peer2Peer-Migration: die desturi ist eine Adresse des Zielhosts aus Sicht des
Quellmaschine.

Wann migrieren nicht angegeben ist, ermittelt libvirt automatisch den Hypervisor
spezifische URI. Einige Hypervisoren, einschließlich QEMU, haben einen optionalen "migration_host"
Konfigurationsparameter (nützlich, wenn der Host über mehrere Netzwerkschnittstellen verfügt). Wenn
dies ist nicht spezifiziert, libvirt ermittelt einen Namen, indem sie die . des Zielhosts nachschlägt
konfigurierter Hostname.

Es gibt einige Szenarien, in denen die Angabe migrieren kann helfen:

· Der konfigurierte Hostname ist falsch oder das DNS ist defekt. Wenn ein Host einen Hostnamen hat
die sich nicht auflöst, um einer seiner öffentlichen IP-Adressen zu entsprechen, dann wird libvirt
einen falschen URI generieren. In diesem Fall migrieren sollte explizit sein
unter Verwendung einer IP-Adresse oder eines korrekten Hostnamens angegeben.

· Der Host hat mehrere Netzwerkschnittstellen. Wenn ein Host über mehrere Netzwerke verfügt
Schnittstellen kann es wünschenswert sein, dass der Migrationsdatenstrom über eine
bestimmte Schnittstelle entweder aus Sicherheits- oder Leistungsgründen. In diesem Fall
migrieren sollte explizit angegeben werden, indem eine IP-Adresse verwendet wird, die mit dem
Netzwerk verwendet werden.

· Die Firewall beschränkt die verfügbaren Ports. Wenn libvirt a . generiert
Migrations-URI wird eine Portnummer mit hypervisorspezifischen Regeln ausgewählt. Manche
Hypervisor benötigen nur einen einzigen Port, um in den Firewalls geöffnet zu sein, während andere
eine ganze Reihe von Portnummern erfordern. Im letzteren Fall migrieren könnte sein,
angegeben, um eine bestimmte Portnummer außerhalb des Standardbereichs zu wählen, um
lokale Firewall-Richtlinien einhalten.

Sehenhttp://libvirt.org/migration.html#uris> für weitere Informationen zu Migrations-URIs.

Optional Grafikuri überschreibt die für automatisch verwendeten Verbindungsparameter
erneutes Verbinden eines grafischen Clients am Ende der Migration. Wenn es weggelassen wird, wird libvirt
Berechnen Sie die Parameter basierend auf der IP-Adresse des Zielhosts. Falls der Kunde dies nicht tut
einen direkten Zugriff auf das Netzwerk haben, mit dem die Virtualisierungshosts verbunden sind und müssen
über einen Proxy verbinden, Grafikuri kann verwendet werden, um die Adresse des Kunden anzugeben
verbinden soll. Der URI wird wie folgt gebildet:

Protokoll://Hostname[:Port]/[?Parameter]

wobei Protokoll entweder "spice" oder "vnc" ist und Parameter eine Liste von Protokollen ist
bestimmte Parameter durch '&' getrennt. Derzeit erkannte Parameter sind "tlsPort"
und "tlsSubject". Beispielsweise,

Gewürz://target.host.com:1234/?tlsPort=4567

Optional Hör-Adresse setzt die Abhöradresse des Hypervisors auf das Ziel
Seite sollte für eingehende Migration binden. Sowohl IPv4- als auch IPv6-Adressen werden akzeptiert
sowie Hostnamen (die Auflösung erfolgt am Ziel). Einige Hypervisoren nicht
unterstützen diese Funktion und geben einen Fehler zurück, wenn dieser Parameter verwendet wird.

migrieren-setmaxdowntime Domain Ausfallzeit
Legen Sie die maximal tolerierbare Ausfallzeit für eine Domain fest, die live zu einer anderen migriert wird
Gastgeber. Die Ausfallzeit ist die Anzahl von Millisekunden, die der Gast am Ende sein darf
Ende der Live-Migration.

migrieren-compcache Domain [--Größe Bytes]
Setzt und/oder erhält die Größe des Caches (in Bytes), der für die wiederholte Komprimierung verwendet wird
übertragenen Speicherseiten während der Live-Migration. Bei Anruf ohne Größe, der Befehl
gibt nur die aktuelle Größe des Komprimierungscaches aus. Wann Größe angegeben ist, die
Hypervisor wird aufgefordert, den Komprimierungs-Cache auf zu ändern Größe Bytes und dann der Strom
Größe wird gedruckt (das Ergebnis kann aufgrund von Rundungen von der gewünschten Größe abweichen
der Hypervisor). Der Größe Option soll verwendet werden, während die Domain erstellt wird
lebend migriert als Reaktion auf Migrationsfortschritt und zunehmende Komprimierung
Cache-Fehler von domjobinfo erhalten.

migrieren-setspeed Domain Bandbreite
Legen Sie die maximale Migrationsbandbreite (in MiB/s) für eine Domain fest, auf die migriert wird
ein anderer Gastgeber. Bandbreite wird als Long-Long-Wert ohne Vorzeichen interpretiert. Angabe von a
negativer Wert führt dazu, dass dem . ein im Wesentlichen unbegrenzter Wert zur Verfügung gestellt wird
Hypervisor. Der Hypervisor kann wählen, ob er den Wert ablehnt oder in den . umwandelt
maximal zulässiger Wert.

migrieren-getspeed Domain
Rufen Sie die maximale Migrationsbandbreite (in MiB/s) für eine Domäne ab.

Numatun Domain [--Modus Modus] [--nodeset Knotenmenge] [[--config] [--Live] | [--aktuell]]
Legen Sie die numa-Parameter einer Domäne fest oder rufen Sie sie ab, die den Element von
Domänen-XML. Ohne Flags werden die aktuellen Einstellungen angezeigt.

Modus kann entweder `strict', `interleave' und `bevorzugt' sein oder eine beliebige gültige Zahl aus dem
virDomainNumatuneMemMode-Enumeration, falls der Daemon dies unterstützt. Für eine laufende Domain,
Der Modus kann nicht geändert werden und das Nodeset kann nur geändert werden, wenn die Domäne
begann mit einem Modus von "streng".

Knotenmenge ist eine Liste von Numa-Knoten, die vom Host zum Ausführen der Domäne verwendet werden. Seine Syntax
ist eine durch Kommas getrennte Liste mit '-' für Bereiche und '^' zum Ausschließen eines Knotens.

If --Live angegeben ist, legen Sie die Scheduler-Informationen eines laufenden Gasts fest. Wenn --config is
angegeben, wirken sich auf den nächsten Start eines persistenten Gasts aus. Wenn --aktuell angegeben,
wirken sich auf den aktuellen Gaststatus aus.

rebooten Domain [--Modus MODUS-LISTE]
Starten Sie eine Domäne neu. Dies verhält sich so, als ob die Domain die rebooten Befehlslauf von der
Konsole. Der Befehl kehrt zurück, sobald er die Neustartaktion ausgeführt hat, die möglicherweise
erheblich sein, bevor die Domäne tatsächlich neu gestartet wird.

Das genaue Verhalten einer Domäne beim Neustart wird durch die on_reboot Parameter in
die XML-Definition der Domäne.

Standardmäßig versucht der Hypervisor, eine geeignete Methode zum Herunterfahren auszuwählen. Um ein zu spezifizieren
alternative Methode, die --Modus Parameter kann eine durch Kommas getrennte Liste angeben, die
enthält "acpi", "agent", "initctl", "signal" und "paravirt". Die Reihenfolge, in der
Die Fahrer werden versuchen, dass jeder Modus nicht definiert ist und sich nicht auf die angegebene Reihenfolge bezieht
virsch. Um eine strenge Kontrolle über die Bestellung zu erhalten, verwenden Sie jeweils einen einzelnen Modus und wiederholen Sie die
Befehl.

zurückstellen Domain
Setzen Sie eine Domain sofort zurück, ohne dass ein Gast heruntergefahren wird. zurückstellen emuliert den Power-Reset
auf einem Computer, auf dem die gesamte Gasthardware die eingestellte RST-Leitung sieht und neu initialisiert
internen Zustand.

Hinweis: Zurücksetzen ohne Herunterfahren des Gastbetriebssystems riskiert Datenverlust.

wiederherstellen Zustandsdatei [--bypass-cache] [--xml Datei] [{--Laufen | --pausiert}]
Stellt eine Domain von a . wieder her virsch Speichern Zustandsdatei. Sehen Speichern mehr info

If --bypass-cache angegeben ist, vermeidet die Wiederherstellung den Dateisystem-Cache, obwohl
dies kann den Betrieb verlangsamen.

--xml Datei wird normalerweise weggelassen, kann aber verwendet werden, um eine alternative XML-Datei für
Verwendung auf dem wiederhergestellten Gast mit Änderungen nur in den hostspezifischen Teilen der
Domänen-XML. Es kann beispielsweise verwendet werden, um Unterschiede bei der Dateibenennung in
zugrunde liegenden Speicher aufgrund von Festplatten-Snapshots, die nach dem Speichern des Gasts erstellt wurden.

Normalerweise wird beim Wiederherstellen eines gespeicherten Bildes der im gespeicherten Bild aufgezeichnete Zustand verwendet, um
zwischen Laufen oder Pause entscheiden; vorbei entweder die --Laufen or --pausiert Flagge wird
Überschreiben, in welchem ​​Zustand die Domäne gestartet werden soll.

Hinweis: Um eine Beschädigung von Dateisysteminhalten innerhalb der Domäne zu vermeiden, sollten Sie sie nicht wiederverwenden
die gespeicherte Zustandsdatei für eine Sekunde wiederherstellen es sei denn, Sie haben auch den gesamten Speicher zurückgesetzt
Volumes wieder auf den gleichen Inhalt wie bei der Erstellung der Statusdatei zurück.

Speichern Domain Zustandsdatei [--bypass-cache] [--xml Datei] [{--Laufen | --pausiert}] [- ausführlich]
Speichert eine laufende Domäne (RAM, aber nicht den Festplattenstatus) in einer Statusdatei, damit sie
später wiederhergestellt. Nach dem Speichern läuft die Domain nicht mehr auf dem System, daher
der für die Domäne zugewiesene Speicher steht anderen Domänen zur Verfügung. virsch
wiederherstellen Wiederherstellungen aus dieser Zustandsdatei. Wenn --bypass-cache angegeben ist, wird das Speichern
Vermeiden Sie den Dateisystem-Cache, obwohl dies den Vorgang verlangsamen kann.

Der Fortschritt kann überwacht werden mit Domjobinfo virsh-Befehl und abgebrochen mit
Domjobabbruch Befehl (von einer anderen virsh-Instanz gesendet). Eine andere Möglichkeit ist das Senden von SIGINT
(normalerweise mit "Strg-C") zum laufenden virsh-Prozess Speichern Befehl. - ausführlich Displays
der Fortschritt des Speicherns.

Dies entspricht in etwa einem Ruhezustand auf einem laufenden Computer mit all den
gleichen Einschränkungen. Offene Netzwerkverbindungen können bei der Wiederherstellung unterbrochen werden, da TCP
Timeouts können abgelaufen sein.

--xml Datei wird normalerweise weggelassen, kann aber verwendet werden, um eine alternative XML-Datei für
Verwendung auf dem wiederhergestellten Gast mit Änderungen nur in den hostspezifischen Teilen der
Domänen-XML. Es kann beispielsweise verwendet werden, um Unterschiede bei der Dateibenennung zu berücksichtigen, die
sollen über Festplatten-Snapshots des zugrunde liegenden Speichers erstellt werden, nachdem der Gast
Gerettet.

Normalerweise entscheidet die Wiederherstellung eines gespeicherten Bildes zwischen der Ausführung oder Pause basierend auf dem
angeben, in dem sich die Domäne befand, als die Speicherung durchgeführt wurde; vorbei entweder die --Laufen or
--pausiert Flag ermöglicht das Überschreiben, welcher Zustand der wiederherstellen sollte nutzen.

Gespeicherte Zustandsdateien der Domäne gehen davon aus, dass die Datenträgerabbilder zwischen den
Erstellungs- und Wiederherstellungspunkt. Für einen vollständigeren Systemwiederherstellungspunkt, an dem die Festplatte
Zustand wird zusammen mit dem Speicherzustand gespeichert, siehe Schnappschuss Familie von Befehlen.

Speichern-Bild-Definieren Datei xml [{--Laufen | --pausiert}]
Aktualisieren Sie die Domänen-XML, die verwendet wird, wenn Datei wird später in der verwendet wiederherstellen
Befehl. Das xml Argument muss ein Dateiname sein, der das alternative XML enthält, mit
Änderungen nur in den hostspezifischen Teilen der Domänen-XML. Es kann zum Beispiel sein
Wird verwendet, um Dateinamensunterschiede zu berücksichtigen, die sich aus der Erstellung von Festplatten-Snapshots von
zugrunde liegende Speicherung, nachdem der Gast gespeichert wurde.

Das Speicherbild zeichnet auf, ob die Domäne in einen laufenden oder pausierten Zustand wiederhergestellt werden soll
Zustand. Normalerweise ändert dieser Befehl den aufgezeichneten Zustand nicht; vorbei entweder die
--Laufen or --pausiert Flag ermöglicht das Überschreiben, welcher Zustand der wiederherstellen sollte nutzen.

save-image-dumpxml Datei [--Sicherheitsinformationen]
Extrahieren Sie die Domänen-XML, die zum Zeitpunkt der gespeicherten Statusdatei gültig war Datei wurde
erstellt mit dem Speichern Befehl. Verwenden von --Sicherheitsinformationen wird auch Sicherheit beinhalten
heikle Informationen.

Speichern-Bild-Bearbeiten Datei [{--Laufen | --pausiert}]
Bearbeiten Sie die XML-Konfiguration, die einer gespeicherten Statusdatei zugeordnet ist Datei durch die erstellt Speichern
Befehl.

Das Speicherbild zeichnet auf, ob die Domäne in einen laufenden oder pausierten Zustand wiederhergestellt werden soll
Zustand. Normalerweise ändert dieser Befehl den aufgezeichneten Zustand nicht; vorbei entweder die
--Laufen or --pausiert Flag ermöglicht das Überschreiben, welcher Zustand der wiederherstellen sollte nutzen.

Dies ist äquivalent zu:

virsh save-image-dumpxml state-file > state-file.xml
vi state-file.xml (oder nehmen Sie Änderungen mit Ihrem anderen Texteditor vor)
virsh save-image-define Zustandsdatei Zustandsdatei-xml

außer dass es einige Fehlerüberprüfungen durchführt.

Der verwendete Editor kann durch die Umgebungsvariablen $VISUAL oder $EDITOR bereitgestellt werden, und
standardmäßig auf "vi".

Schedinfo Domain [[--config] [--Live] | [--aktuell]] [[--einstellen] Parameter=Wert] ...
Schedinfo [--Last Anzahl] [--Deckel Anzahl] Domain
Ermöglicht Ihnen das Anzeigen (und Festlegen) der Domänen-Scheduler-Parameter. Die verfügbaren Parameter
für jeden Hypervisor sind:

LXC (Posix-Scheduler): cpu_shares, vcpu_period, vcpu_quota

QEMU/KVM (Posix-Scheduler): cpu_shares, vcpu_period, vcpu_quota, emulator_period,
emulator_quote

Xen (Credit Scheduler): Gewicht, Obergrenze

ESX (Allokationsplaner): Reservierung, Limit, Aktien

If --Live angegeben ist, legen Sie die Scheduler-Informationen eines laufenden Gasts fest. Wenn --config is
angegeben, wirken sich auf den nächsten Start eines persistenten Gasts aus. Wenn --aktuell angegeben,
wirken sich auf den aktuellen Gaststatus aus.

Hinweis: Der Parameter cpu_shares hat einen gültigen Wertebereich von 0-262144; Negative Werte
werden ins Positive umgebrochen, und größere Werte werden auf das Maximum begrenzt. Daher -1
ist eine nützliche Abkürzung für 262144. Auf dem Linux-Kernel sind die Werte 0 und 1
automatisch auf einen Minimalwert von 2 umgerechnet.

Hinweis: Die Parameter Weight und Cap sind nur für den XEN_CREDIT-Scheduler definiert und
sind jetzt DEPARCATED.

Hinweis: Die Parameter vcpu_period/emulator_period haben einen gültigen Wertebereich von
1000-1000000 oder 0, und die Parameter vcpu_quota/emulator_quota haben einen gültigen Wert
Bereich von 1000-18446744073709551 oder weniger als 0. Der Wert 0 für jeden Parameter ist
dasselbe, als würde man diesen Parameter nicht angeben.

Screenshot Domain [Bilddateipfad] [--Bildschirm Bildschirm-ID]
Erstellt einen Screenshot einer aktuellen Domänenkonsole und speichert ihn in einer Datei. Optional,
Wenn der Hypervisor mehr Anzeigen für eine Domäne unterstützt, Bildschirm-ID erlaubt anzugeben, welche
Bildschirm aufgenommen wird. Es ist die fortlaufende Nummer des Bildschirms. Bei mehreren
Grafikkarten, Köpfe werden vor Geräten aufgezählt, z. B. mit zwei Grafikkarten,
beide mit vier Köpfen, Bildschirm-ID 5 adressiert den zweiten Kopf auf der zweiten Karte.

Sendetaste Domain [- Codesatz Codesatz] [--Haltezeit Haltezeit] Schlüsselcode...
Analysieren Sie die Schlüsselcode Sequenz als Tastenanschläge zum Senden an Domain. Jeder Schlüsselcode kann entweder
ein numerischer Wert oder ein symbolischer Name aus dem entsprechenden Codeset sein. Wenn --Haltezeit
gegeben ist, wird jeder Tastendruck für so viele Millisekunden gehalten. Der Standardcodesatz
is linux, aber die Verwendung der - Codesatz Option ermöglicht die Auswahl anderer Codesätze.

Wenn mehrere Tastencodes angegeben werden, werden sie alle gleichzeitig an den Gast gesendet, und
sie können in zufälliger Reihenfolge empfangen werden. Wenn Sie unterschiedliche Tastendrücke benötigen, müssen Sie
mehrere Sendeschlüsselaufrufe.

linux
Die numerischen Werte sind diejenigen, die vom generischen Eingabeereignis-Subsystem von Linux definiert werden.
Die symbolischen Namen stimmen mit den entsprechenden Makronamen der Linux-Schlüsselkonstanten überein.

xt Die numerischen Werte sind diejenigen, die vom ursprünglichen XT-Keyboard-Controller definiert wurden. Nein
symbolische Namen werden bereitgestellt

atset1
Die numerischen Werte sind diejenigen, die vom AT-Tastatur-Controller, Satz 1 (auch bekannt als XT
kompatibles Set). Erweiterte Keycoes von atset1 kann von erweiterten Tastencodes abweichen in
xt Codesatz. Es werden keine symbolischen Namen bereitgestellt

atset2
Die numerischen Werte sind diejenigen, die vom AT-Tastaturcontroller, Satz 2, definiert wurden. Nein
symbolische Namen werden bereitgestellt

atset3
Die numerischen Werte sind diejenigen, die vom AT-Tastatur-Controller, Set 3 (auch bekannt als
PS/2-kompatibles Set). Es werden keine symbolischen Namen bereitgestellt

os_x
Die numerischen Werte sind diejenigen, die vom OS-X-Tastatureingabe-Subsystem definiert werden. Der
symbolische Namen stimmen mit den entsprechenden Makronamen der OS-X-Schlüsselkonstanten überein

xt_kbd
Die numerischen Werte sind die vom Linux KBD-Gerät definierten. Das sind eine Variante
auf dem ursprünglichen XT-Codeset, aber oft mit anderer Codierung für erweitertes
Schlüsselcodes. Es werden keine symbolischen Namen bereitgestellt.

win32
Die numerischen Werte sind diejenigen, die vom Win32-Tastatureingabesubsystem definiert werden. Der
symbolische Namen stimmen mit den entsprechenden Makronamen der Win32-Schlüsselkonstanten überein

USB Die numerischen Werte sind diejenigen, die durch die USB-HID-Spezifikation für Tastaturen definiert sind
Eingang. Es werden keine symbolischen Namen bereitgestellt

rfb Die numerischen Werte sind diejenigen, die von der RFB-Erweiterung für das Senden von Rohdaten definiert wurden
Schlüsselcodes. Dies ist eine Variante des XT-Codesets, aber erweiterte Tastencodes haben die
Low-Bit des zweiten Bytes gesetzt, anstelle des High-Bits des ersten Bytes. Nein
symbolische Namen werden bereitgestellt.

Beispiele
# sende drei Striche 'k', 'e', ​​'y' mit dem xt-Codeset. diese
# werden alle gleichzeitig gedrückt und können vom Gast empfangen werden
# in zufälliger Reihenfolge
virsh send-key dom --codeset xt 37 18 21

# einen Strich 'rechts-Strg+C' senden
virsh send-key dom KEY_RIGHTCTRL KEY_C

# Tab senden, 1 Sekunde lang gehalten
virsh send-key --holdtime 1000 0xf

Prozess-Signal senden Domain-ID pid Zeichenname
Sende ein Signal Zeichenname zu dem durch . identifizierten Prozess pid läuft in der virtuellen Domäne
Domain-IDdem „Vermischten Geschmack“. Seine pid ist eine Prozess-ID im virtuellen Domänennamensraum.

Der Zeichenname Argument kann entweder eine ganzzahlige Signalkonstante oder eines der
symbolische Namen:

"nop", "hup", "int", "quit", "krank",
"trap", "abrt", "bus", "fpe", "kill",
"usr1", "segv", "usr2", "pipe", "alrm",
"term", "stkflt", "chld", "cont", "stop",
"tstp", "ttin", "ttou", "urg", "xcpu",
"xfsz", "vtalrm", "prof", "winde", "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"

Der Symbolname kann optional mit 'sig' oder 'sig_' vorangestellt werden und kann in
Groß- oder Kleinschreibung.

Beispiele
virsh send-process-signal myguest 1 15
virsh send-process-signal myguest 1 Begriff
virsh send-process-signal myguest 1 sigterm
virsh send-process-signal myguest 1 SIG_HUP

Setmem Domain Größe [[--config] [--Live] | [--aktuell]]
Ändern Sie die Speicherzuweisung für eine Gastdomäne. Wenn --Live angegeben ist, führen Sie a . aus
Erinnerungsballon eines laufenden Gastes. Wenn --config angegeben ist, wirkt sich auf den nächsten Start von . aus
ein hartnäckiger Gast. Wenn --aktuell angegeben ist, wirken sich auf den aktuellen Gaststatus aus. Beide
--Live und --config Flags können angegeben werden, aber --aktuell ist exklusiv. Wenn keine Flagge ist
angegeben, ist das Verhalten je nach Hypervisor unterschiedlich.

Größe ist eine skalierte ganze Zahl (siehe ANMERKUNG Oben); Standardmäßig sind Kibibytes (Blöcke von 1024 .)
Bytes), es sei denn, Sie geben ein Suffix (und den älteren Optionsnamen) an --Kilobyte verfügbar
als veraltetes Synonym) . Libvirt rundet auf das nächste Kibibyte auf. Manche
Hypervisoren erfordern eine größere Granularität als KiB und Anfragen, die nicht gerade sind
Vielfaches wird aufgerundet. Beispielsweise rundet vSphere/ESX den Parameter auf
Mebibyte (1024 Kibibyte).

Für Xen können Sie den Speicher einer laufenden Domäne nur anpassen, wenn die Domäne
paravirtualisiert oder den PV-Ballontreiber ausführen.

Für LXC ist der eingestellte Wert der cgroups-Wert für limit_in_bytes oder das Maximum
Größe des Benutzerspeichers (einschließlich Dateicache). Beim Anzeigen des Speichers im
Behälter, das ist der / proc / meminfo "MemTotal"-Wert. Beim Anzeigen des Wertes aus dem
Host, verwenden Sie die virsch Memtune Befehl. Um den aktuell verwendeten Speicher anzuzeigen und
den maximal zulässigen Wert zum Einstellen des Speichers, verwenden Sie die virsch Dominfo Befehl.

Benutzer Passwort festlegen Domain Benutzer Passwort [--verschlüsselt]
Legen Sie das Passwort für die . fest Benutzer Konto in der Gastdomäne.

If --verschlüsselt angegeben wird, wird davon ausgegangen, dass das Passwort bereits verschlüsselt ist
vom Gastbetriebssystem benötigte Methode.

Für QEMU/KVM erfordert dies, dass der Gast-Agent konfiguriert ist und ausgeführt wird.

setmaxmem Domain Größe [[--config] [--Live] | [--aktuell]]
Ändern Sie die maximale Speicherzuweisungsgrenze für eine Gastdomäne. Wenn --Live is
angegeben, wirken sich auf einen laufenden Gast aus. Wenn --config angegeben ist, wirkt sich auf den nächsten Start von . aus
ein hartnäckiger Gast. Wenn --aktuell angegeben ist, wirken sich auf den aktuellen Gaststatus aus. Beide
--Live und --config Flags können angegeben werden, aber --aktuell ist exklusiv. Wenn keine Flagge ist
angegeben, ist das Verhalten je nach Hypervisor unterschiedlich.

Einige Hypervisoren wie QEMU/KVM unterstützen keine Live-Änderungen (insbesondere zunehmend)
der maximalen Speichergrenze. Selbst dauerhafte Konfigurationsänderungen sind möglicherweise nicht
mit einigen Hypervisoren/Konfigurationen durchgeführt (zB auf NUMA-fähigen Domänen auf QEMU).
Für komplexe Konfigurationsänderungen verwenden Sie den Befehl bearbeiten stattdessen).

Größe ist eine skalierte ganze Zahl (siehe ANMERKUNG Oben); Standardmäßig sind Kibibytes (Blöcke von 1024 .)
Bytes), es sei denn, Sie geben ein Suffix (und den älteren Optionsnamen) an --Kilobyte verfügbar
als veraltetes Synonym) . Libvirt rundet auf das nächste Kibibyte auf. Manche
Hypervisoren erfordern eine größere Granularität als KiB und Anfragen, die nicht gerade sind
Vielfaches wird aufgerundet. Beispielsweise rundet vSphere/ESX den Parameter auf
Mebibyte (1024 Kibibyte).

Memtune Domain [--hard-limit Größe] [--soft-limit Größe] [--swap-hard-limit Größe]
[--min-garantie Größe] [[--config] [--Live] | [--aktuell]]
Ermöglicht Ihnen, die Domänenspeicherparameter anzuzeigen oder einzustellen. Ohne Flaggen, der Strom
Einstellungen werden angezeigt; mit einem Flag wird das entsprechende Limit angepasst, wenn es unterstützt wird von
der Hypervisor. LXC- und QEMU/KVM-Unterstützung --hard-limit, --soft-limitsowie
--swap-hard-limit. --min-garantie wird nur vom ESX-Hypervisor unterstützt. Jeder von
diese Grenzen sind skalierte ganze Zahlen (siehe ANMERKUNG oben), mit einem Standardwert von Kibibytes
(Blöcke von 1024 Byte), wenn kein Suffix vorhanden ist. Libvirt rundet auf
kibibyte. Einige Hypervisor erfordern eine größere Granularität als KiB und verlangen dies
kein gerades Vielfaches sind, wird aufgerundet. vSphere/ESX rundet beispielsweise die
Parameter bis zu Mebibyte (1024 Kibibyte).

If --Live angegeben ist, betrifft einen laufenden Gast. Wenn --config angegeben ist, beeinflussen die
nächsten Booten eines persistenten Gasts. Wenn --aktuell angegeben ist, betrifft den aktuellen Gast
Zustand. Beide --Live und --config Flags können angegeben werden, aber --aktuell ist exklusiv. Wenn nein
Flag angegeben ist, ist das Verhalten je nach Hypervisor unterschiedlich.

Bei QEMU/KVM werden die Parameter auf den QEMU-Prozess als Ganzes angewendet. Also, wenn
Wenn man sie zählt, muss man Gast-RAM, Gast-Video-RAM und etwas Speicher addieren
Overhead der QEMU selbst. Das letzte Stück ist schwer zu bestimmen, also muss man raten und
Versuchen.

Für LXC ist der angezeigte Wert hard_limit die aktuelle Speichereinstellung aus dem XML oder
die Ergebnisse von a virsch Setmem Befehl.

--hard-limit
Der maximale Speicher, den der Gast verwenden kann.

--soft-limit
Das Speicherlimit, das während eines Speicherkonflikts erzwungen werden soll.

--swap-hard-limit
Der maximale Arbeitsspeicher plus Swap, den der Gast verwenden kann. Das muss mehr als schwer sein-
Grenzwert angegeben.

--min-garantie
Die garantierte Mindestspeicherzuweisung für den Gast.

Die Angabe von -1 als Wert für diese Grenzen wird als unbegrenzt interpretiert.

blkiotune Domain [--Last Gewicht] [--Gerätegewichte Gerätegewichte]
[--device-read-iops-sek geräte-lese-iops-sek] [--device-write-iops-sek gerät-schreibe-iops-
Sek.] [--device-read-bytes-sec Gerät-lesen-Bytes-Sek.] [--device-write-bytes-sec Gerät-
schreiben-bytes-sec] [[--config] [--Live] | [--aktuell]]
Zeigen Sie die blkio-Parameter an oder stellen Sie sie ein. QEMU/KVM-Unterstützung --Last. --Last ist in Reichweite
[100, 1000]. Nach Kernel 2.6.39 könnte der Wert im Bereich [10, 1000] liegen.

Gerätegewichte ist eine einzelne Zeichenfolge, die ein oder mehrere Geräte-/Gewichtspaare im
Format von /Pfad/zum/Gerät,Gewicht,/Pfad/zum/Gerät,Gewicht. Jedes Gewicht liegt im Bereich
[100, 1000], [10, 1000] nach Kernel 2.6.39, oder der Wert 0, um dieses Gerät aus zu entfernen
Auflistungen pro Gerät. Es werden nur die im String aufgeführten Geräte geändert; alle vorhandenen
Gewichte pro Gerät für andere Geräte bleiben unverändert.

geräte-lese-iops-sek ist eine einzelne Zeichenfolge, die ein oder mehrere Geräte/read_iops_sec aufführt
Paare, int das Format /path/to/device,read_iops_sec,/path/to/device,read_iops_sec.
Jeder read_iops_sec ist eine Zahl vom Typ unsigned int, Wert 0, um das zu entfernen
Gerät aus der Liste pro Decice. Es werden nur die im String aufgeführten Geräte geändert;
alle vorhandenen gerätebezogenen read_iops_sec für andere Geräte bleiben unverändert.

Gerät-schreiben-iops-sek ist eine einzelne Zeichenfolge, die ein oder mehrere device/write_iops_sec aufführt
Paare, im Format von
/path/to/device,write_iops_sec,/path/to/device,write_iops_sec. Jeder write_iops_sec ist
eine Zahl, deren Typ unsigned int ist, Wert 0, um dieses Gerät aus dem Pro-Dezice zu entfernen
Auflistung. Es werden nur die im String aufgeführten Geräte geändert; jedes vorhandene pro Gerät
write_iops_sec für andere Geräte bleiben unverändert.

Gerät-lesen-Bytes-Sek. ist eine einzelne Zeichenfolge, die ein oder mehrere device/read_bytes_sec aufführt
Paare, im Format von
/path/to/device,read_bytes_sec,/path/to/device,read_bytes_sec. Jeder read_bytes_sec ist
eine Zahl vom Typ unsigned long long, Wert 0, um dieses Gerät aus dem Per-
Entscheidungsliste. Es werden nur die im String aufgeführten Geräte geändert; alle vorhandenen per-
device read_bytes_sec für andere Geräte bleiben unverändert.

Gerät-schreiben-Bytes-Sek. ist eine einzelne Zeichenfolge, die ein oder mehrere device/write_bytes_sec auflistet
Paare, im Format von
/path/to/device,write_bytes_sec,/path/to/device,write_bytes_sec. Jeder write_bytes_sec
ist eine Zahl vom Typ unsigned long long, Wert 0, um dieses Gerät aus dem Per-
Entscheidungsliste. Es werden nur die im String aufgeführten Geräte geändert; alle vorhandenen per-
device write_bytes_sec für andere Geräte bleiben unverändert.

If --Live angegeben ist, betrifft einen laufenden Gast. Wenn --config angegeben ist, beeinflussen die
nächsten Booten eines persistenten Gasts. Wenn --aktuell angegeben ist, betrifft den aktuellen Gast
Zustand. Beide --Live und --config Flags können angegeben werden, aber --aktuell ist exklusiv. Wenn nein
Flag angegeben ist, ist das Verhalten je nach Hypervisor unterschiedlich.

setvcpus Domain zählen [--maximal] [[--config] [--Live] | [--aktuell]] [--Gast]
Ändern Sie die Anzahl der in einer Gastdomäne aktiven virtuellen CPUs. Standardmäßig ist dieser Befehl
funktioniert auf aktiven Gastdomänen. Um die Einstellungen für eine inaktive Gastdomäne zu ändern,
verwenden Sie die --config Flagge.

Der zählen Wert kann durch Host, Hypervisor oder ein Limit von
Originalbeschreibung der Gastdomäne. Für Xen können Sie nur das virtuelle anpassen
CPUs einer laufenden Domäne, wenn die Domäne paravirtualisiert ist.

Besitzt das --config Flag angegeben ist, wird die Änderung an der gespeicherten XML-Konfiguration vorgenommen
für die Gastdomäne und wird erst beim nächsten Start der Gastdomäne wirksam.

If --Live angegeben ist, muss die Gastdomäne aktiv sein und die Änderung findet statt
sofort. Beide --config und --Live Flags können zusammen angegeben werden, wenn
vom Hypervisor unterstützt. Wenn dieser Befehl ausgeführt wird, bevor der Gast fertig ist
bootet, kann der Gast die Änderung möglicherweise nicht verarbeiten.

If --aktuell angegeben ist, wirken sich auf den aktuellen Gaststatus aus.

Wenn keine Flags angegeben sind, wird die --Live Flag wird vorausgesetzt und die Gastdomäne muss sein
aktiv. In dieser Situation liegt es am Hypervisor, ob die --config Flagge ist
ebenfalls vorausgesetzt, und ob daher die XML-Konfiguration so angepasst ist, dass die
dauerhaft ändern.

If --Gast angegeben ist, wird die Anzahl der CPUs im Gast geändert, anstatt
der Hypervisor. Dieses Flag kann nur für Live-Domains verwendet werden und erfordert möglicherweise einen Gast-Agenten
im Gast konfiguriert werden.

Der --maximal Flag steuert die maximale Anzahl virtueller CPUs, die hot-plugged werden können
beim nächsten Booten der Domäne. Daher darf es nur mit dem --config
Flagge, und nicht mit der --Live oder unter der --aktuell Flagge.

Schließung Domain [--Modus MODUS-LISTE]
Schließt eine Domäne ordnungsgemäß ab. Dies koordiniert mit dem Domänenbetriebssystem, das ausgeführt werden soll
ordnungsgemäßes Herunterfahren, daher gibt es keine Garantie für den Erfolg und kann einige Zeit in Anspruch nehmen
variable Zeitdauer, abhängig davon, welche Dienste in der Domäne heruntergefahren werden müssen.

Das genaue Verhalten einer Domain beim Herunterfahren wird durch die on_shutdown Parameter
in der XML-Definition der Domäne.

If Domain vorübergehend ist, gehen die Metadaten aller Snapshots verloren, sobald der Gast
wird nicht mehr ausgeführt, aber die Snapshot-Inhalte sind noch vorhanden und eine neue Domäne mit derselben
Name und UUID können die Snapshot-Metadaten mit wiederherstellen Schnappschuss-Erstellen.

Standardmäßig versucht der Hypervisor, eine geeignete Methode zum Herunterfahren auszuwählen. Um ein zu spezifizieren
alternative Methode, die --Modus Parameter kann eine durch Kommas getrennte Liste angeben, die
enthält "acpi", "agent", "initctl", "signal" und "paravirt". Die Reihenfolge, in der
Die Fahrer werden versuchen, dass jeder Modus nicht definiert ist und sich nicht auf die angegebene Reihenfolge bezieht
virsch. Um eine strenge Kontrolle über die Bestellung zu erhalten, verwenden Sie jeweils einen einzelnen Modus und wiederholen Sie die
Befehl.

Anfang Domänenname-oder-uuid [--Konsole] [--pausiert] [--autodestroy] [--bypass-cache]
[--force-boot] [--pass-fds N, M,...]
Starten Sie eine (zuvor definierte) inaktive Domäne, entweder von der letzten verwaltetsave Staat,
oder über einen Neustart, wenn kein Managedsave-Zustand vorhanden ist. Die Domain wird pausiert, wenn
--pausiert Option wird vom Treiber verwendet und unterstützt; sonst läuft es.
If --Konsole angefordert wird, nach der Erstellung an die Konsole anhängen. Wenn --autodestroy is
angefordert, dann wird der Gast automatisch zerstört, wenn virsh seine schließt
Verbindung zu libvirt oder auf andere Weise beendet. Wenn --bypass-cache angegeben ist, und
Managedsave-Status vorhanden ist, vermeidet die Wiederherstellung den Dateisystem-Cache, obwohl dies
kann den Betrieb verlangsamen. Wenn --force-boot angegeben ist, dann jeder Managedsave-Status
wird verworfen und es erfolgt ein Neustart.

If --pass-fds angegeben ist, ist das Argument eine durch Kommas getrennte Liste der geöffneten Datei
Deskriptoren, die an den Gast weitergegeben werden sollen. Die Dateideskriptoren werden neu
im Gast nummeriert, beginnend mit 3. Dies wird nur bei Container-basiert unterstützt
Virtualisierung.

aussetzen Domain
Eine laufende Domäne anhalten. Es wird im Speicher gehalten, aber nicht mehr geplant.

fortsetzen Domain
Verschiebt eine Domäne aus dem gesperrten Zustand. Dadurch wird ein zuvor gesperrter
Domäne jetzt für die Planung durch den zugrunde liegenden Hypervisor berechtigt.

dommsuspendieren Domain Ziel [--Dauer]
Eine laufende Domäne in einem dieser Zustände aussetzen (möglich Ziel Werte):
mem-Äquivalent des S3-ACPI-Zustands
Festplattenäquivalent des S4 ACPI-Zustands
Hybrid-RAM wird auf der Festplatte gespeichert, aber nicht ausgeschaltet

Der --Dauer Argument gibt die Anzahl der Sekunden an, bevor die Domäne aufgeweckt wird
nachdem es ausgesetzt wurde (siehe auch dompmaufwachen). Der Standardwert ist 0 für unbegrenztes Suspendieren
Zeit. (Diese Funktion wird derzeit von keinem Hypervisor-Treiber unterstützt und 0 sollte sein
Gebraucht.).

Beachten Sie, dass für diesen Befehl ein Gast-Agent erforderlich ist, der im der Domäne konfiguriert und ausgeführt wird
Gastbetriebssystem.

Beachten Sie, dass zumindest für QEMU der Prozess der Domäne beendet wird, wenn Ziel
Festplatte verwendet und ein neuer Prozess wird gestartet, wenn libvirt aufgefordert wird, die
Domain. Dadurch werden Laufzeitänderungen wie Geräte-Hotplug oder Speicher
Einstellungen, gehen verloren, es sei denn, solche Änderungen wurden mit vorgenommen --config Flagge.

dompmaufwachen Domain
Wecken Sie eine Domain aus dem pmsuspended-Zustand auf (entweder suspendiert durch dompmsuspend oder aus dem
Gast selbst). Fügt dem Gast, der sich im pmsuspended-Zustand befindet, ein Wakeup ein, eher
als auf den Ablauf der zuvor angeforderten Dauer (falls vorhanden) zu warten. Diese Operation
schlägt nicht unbedingt fehl, wenn die Domäne ausgeführt wird.

ttyconsole Domain
Geben Sie das Gerät aus, das für die TTY-Konsole der Domäne verwendet wird. Wenn die Informationen nicht
verfügbar sind, liefern die Prozesse einen Exit-Code von 1.

undefinieren Domain [--managed-save] [--snapshots-metadata] [--nvram] [ {--Lagerung Volumen |
--remove-all-storage [--Schnappschüsse löschen]} --wipe-storage]
Definieren Sie eine Domäne. Wenn die Domäne ausgeführt wird, wird sie dadurch in eine vorübergehende Domäne umgewandelt.
ohne es zu stoppen. Wenn die Domäne inaktiv ist, wird die Domänenkonfiguration entfernt.

Der --managed-save Flag garantiert, dass jedes verwaltete Speicherbild (siehe die verwaltetsave
Befehl) wird ebenfalls bereinigt. Versucht ohne das Flag, eine Domäne mit a . aufzuheben
Das verwaltete Speicherabbild schlägt fehl.

Der --snapshots-metadata Flag garantiert, dass alle Snapshots (siehe die Schnappschuss-Liste
Befehl) werden auch beim Aufheben der Definition einer inaktiven Domäne bereinigt. Ohne die Flagge,
Versuche, die Definition einer inaktiven Domäne mit Snapshot-Metadaten aufzuheben, schlagen fehl. Wenn die
Domäne aktiv ist, wird dieses Flag ignoriert.

Der --nvram Flag stellt sicher, dass keine nvram-Datei (/domain/os/nvram/) zurückgelassen wird. Wenn die
domain eine nvram-Datei hat und das Flag weggelassen wird, schlägt das Undefinieren fehl.

Der --Lagerung Flag nimmt einen Parameter an Volumen, eine durch Kommas getrennte Liste von
Datenträgerzielnamen oder Quellpfade von Speicherdatenträgern, die zusammen mit den zu entfernenden
undefinierte Domäne. Volumes können undefiniert und daher nur auf inaktiven Domänen entfernt werden.
Das Löschen des Volumes wird nur versucht, nachdem die Domäne nicht definiert wurde. wenn nicht alle
angeforderte Volumes konnten gelöscht werden, die Fehlermeldung zeigt an, was noch übrig ist
hinter. Wenn in der Domänendefinition kein Datenträgerpfad gefunden wird, wird er so behandelt, als ob der
Volume wurde erfolgreich gelöscht. Nur Volumes, die von libvirt in Speicherpools verwaltet werden, können
auf diese Weise entfernt werden. (Sehen Domblkliste für Liste der Zielnamen, die a . zugeordnet sind
Domain). Beispiel: --storage vda,/path/to/storage.img

Der --remove-all-storage Flag gibt an, dass alle Speichervolumes der Domäne
sollte gelöscht werden.

Der --Schnappschüsse löschen Flag gibt an, dass alle Snapshots, die mit dem Speicher verknüpft sind
Volume sollte ebenfalls gelöscht werden. Benötigt die --remove-all-storage Flagge zu sein
bereitgestellt. Nicht alle Speichertreiber unterstützen diese Option, derzeit nur rbd.

Die Flagge --wipe-storage gibt an, dass die Speichervolumes vorher gelöscht werden sollen
Entfernung.

HINWEIS: Bei einer inaktiven Domäne muss der Domänenname oder die UUID als Domain.

vcpucount Domain [{--maximal | --aktiv} {--config | --Live | --aktuell}] [--Gast]
Drucken Sie Informationen über die virtuellen CPU-Zahlen der angegebenen Domain. Wenn keine Flaggen sind
angegeben, werden alle möglichen Zählungen in einer Tabelle aufgelistet; andernfalls ist die Leistung begrenzt
nur auf den angeforderten numerischen Wert. Aus historischen Gründen listet die Tabelle die
Label "aktuell" auf den Zeilen, die isoliert über den . abgefragt werden können --aktiv Flagge,
anstatt sich auf die --aktuell Flagge.

--maximal fordert Informationen zur maximalen vcpus-Obergrenze an, die eine Domain über hinzufügen kann
setvcpus, während --aktiv zeigt die aktuelle Nutzung an; diese beiden Flaggen können nicht beide sein
spezifiziert. --config erfordert eine persistente Domäne und fordert Informationen zu
wenn die Domäne das nächste Mal gebootet wird, --Live erfordert eine laufende Domain und Listen
aktuelle Werte und --aktuell Abfragen nach dem aktuellen Stand der Domain
(korrespondierend zu --Live wenn es läuft, oder --config wenn inaktiv); diese drei Flaggen sind
sich gegenseitig ausschließen.

If --Gast angegeben ist, wird die Anzahl der CPUs aus der Sicht von . gemeldet
der Gast. Dieses Flag kann nur für Live-Domains verwendet werden und erfordert möglicherweise, dass ein Gast-Agent
im Gast konfiguriert.

vcpuinfo Domain [--ziemlich]
Gibt grundlegende Informationen über die virtuellen CPUs der Domäne zurück, wie die Anzahl der vCPUs, die
Laufzeit, die Affinität zu physikalischen Prozessoren.

Bei --ziemlich, CPU-Affinitäten werden als Bereiche angezeigt.

vcpupin Domain [VCPU] [Kpulist] [[--Live] [--config] | [--aktuell]]
Fragen Sie das Anheften von Domänen-VCPUs an das Hosten physischer CPUs ab oder ändern Sie sie. Um eine Single zu pinnen
VCPU, spezifizieren Kpulist; andernfalls können Sie einen abfragen VCPU oder weglassen VCPU um alles aufzulisten bei
Einmal.

Kpulist ist eine Liste mit physischen CPU-Nummern. Seine Syntax ist eine durch Kommas getrennte Liste und a
spezielles Markup mit '-' und '^' (zB '0-4', '0-3,^2') kann ebenfalls zugelassen werden. Die '-'
bezeichnet den Bereich und das '^' bezeichnet exklusiv. Zum Anheften der VCPU zu allen körperlichen
CPU spezifizieren 'r' als a Kpulist. Wenn --Live angegeben ist, betrifft einen laufenden Gast. Wenn
--config angegeben ist, wirken sich auf den nächsten Start eines persistenten Gasts aus. Wenn --aktuell is
angegeben, wirken sich auf den aktuellen Gaststatus aus. Beide --Live und --config Flaggen können sein
gegeben, wenn Kpulist ist vorhanden, aber --aktuell ist exklusiv. Wenn kein Flag angegeben ist,
Das Verhalten ist je nach Hypervisor unterschiedlich.

Hinweis: Der Ausdruck wird sequentiell ausgewertet, also ist "0-15,^8" identisch mit
"9-14,0-7,15", aber nicht identisch mit "^8,0-15".

Emulatorpin Domain [Kpulist] [[--Live] [--config] | [--aktuell]]
Fragen Sie das Anheften der Emulatorthreads der Domäne an physische Host-CPUs ab oder ändern Sie sie.

Weitere Informationen finden Sie auch in den vcpupin für Kpulist.

If --Live angegeben ist, betrifft einen laufenden Gast. Wenn --config angegeben ist, beeinflussen die
nächsten Booten eines persistenten Gasts. Wenn --aktuell angegeben ist, betrifft den aktuellen Gast
Zustand. Beide --Live und --config Flaggen dürfen gegeben werden, wenn Kpulist ist vorhanden, aber
--aktuell ist exklusiv. Wenn kein Flag angegeben ist, unterscheidet sich das Verhalten je nach
Hypervisor.

vncdisplay Domain
Geben Sie die IP-Adresse und Portnummer für das VNC-Display aus. Wenn die Informationen nicht
verfügbar sind, liefern die Prozesse einen Exit-Code von 1.

DEVICE BEFEHLE

Die folgenden Befehle manipulieren Geräte, die Domänen zugeordnet sind. Der Domain kann sein
angegeben als eine kurze Ganzzahl, ein Name oder eine vollständige UUID. Um die Werte besser zu verstehen
erlaubt als Optionen für den Befehl Lesen der Dokumentation at
<http://libvirt.org/formatdomain.html> zum Format der Geräteabschnitte, um die
genauesten Satz akzeptierter Werte.

Attach-Gerät Domain FILE [[[[--Live] [--config] | [--aktuell]] | [--hartnäckig]]
Anhängen eines Geräts an die Domäne mithilfe einer Gerätedefinition in einer XML-Datei mithilfe eines Geräts
Definitionselement wie oder als oberstes Element. Siehe die
Dokumentation beihttp://libvirt.org/formatdomain.html#elementsDevices> um mehr darüber zu erfahren
libvirt XML-Format für ein Gerät. Wenn --config angegeben ist, ändert der Befehl die
persistente Domänenkonfiguration, bei der das Anhängen des Geräts beim nächsten Mal wirksam wird
libvirt startet die Domäne. Bei CD-ROM- und Diskettengeräten ersetzt dieser Befehl nur
die Medien in einem bestehenden Gerät; erwägen zu verwenden Update-Gerät für diese Verwendung. Für
Passthrough-Hostgeräte, siehe auch nodedev-detach, benötigt, wenn das PCI-Gerät dies nicht tut
den verwalteten Modus verwenden.

If --Live angegeben ist, wirken sich auf eine laufende Domäne aus. Wenn --config angegeben ist, beeinflussen die
nächsten Start einer persistenten Domäne. Wenn --aktuell angegeben ist, wirkt sich auf den Strom aus
Domänenstatus. Beide --Live und --config Flags können angegeben werden, aber --aktuell is
exklusiv. Wenn kein Flag angegeben ist, wird eine Legacy-API verwendet, deren Verhalten von der
Hypervisor-Treiber.

Aus Kompatibilitätsgründen, --hartnäckig benimmt sich wie --config für eine Offline-Domain,
und wie --Live --config für eine laufende Domäne.

Hinweis: Die Verwendung von XML-Dateien mit teilweiser Gerätedefinition kann zu unerwarteten Ergebnissen führen, da
Einige Felder werden möglicherweise automatisch generiert und entsprechen daher anderen Geräten als erwartet.

Attach-Disk Domain Quelle Ziel [[[[--Live] [--config] | [--aktuell]] | [--hartnäckig]]
[--zielbus Bus] [--Treiber Fahrer] [--subdriver Untertreiber] [--iothread jothread] [--Zwischenspeicher
Cache-Speicher] [--Typ tippe] [--Modus Modus] [--Quelle Typ Quelle Typ] [--seriell seriell] [--wwn wwn]
[--rawio] [--die Anschrift Adresse] [--Multifunktion] [--print-xml]
Hängen Sie ein neues Plattengerät an die Domäne an. Quelle ist der Pfad für die Dateien und Geräte.
Ziel steuert den Bus oder das Gerät, unter dem die Festplatte dem Gastbetriebssystem ausgesetzt ist. Es
zeigt den "logischen" Gerätenamen an; die Wahl Zielbus Attribut spezifiziert die
Typ des zu emulierenden Plattengeräts; mögliche Werte sind treiberspezifisch, mit typischen
Werte sein ide, scsi, Virtio, Xen, USB, SATAoder sd, wenn weggelassen, ist der Bustyp
aus dem Stil des Gerätenamens abgeleitet (z. B. wird ein Gerät mit dem Namen 'sda' typischerweise
über einen SCSI-Bus exportiert werden). Fahrer kann sein Datei, tippen or phy für den Xen-Hypervisor
je nach Zugangsart; oder qemu für den QEMU-Emulator. Weitere Details zu
der Fahrer kann überholt werden mit Untertreiber. Für Xen Untertreiber kann sein aio, während für QEMU
Subdriver sollte dem Format der Datenträgerquelle entsprechen, wie z roh or qcow2.
Der Hypervisor-Standard wird verwendet, wenn Untertreiber ist nicht angegeben. Die Standardeinstellung ist jedoch
möglicherweise nicht korrekt, insb. für QEMU, da es aus Sicherheitsgründen so konfiguriert ist, dass es nicht
Festplattenformate erkennen. tippe kann anzeigen Mo., cdrom or floppy als Alternative zum
Festplattenstandard, obwohl diese Verwendung nur die Medien innerhalb der vorhandenen virtuellen ersetzt
CD-ROM oder Diskette; erwägen zu verwenden Update-Gerät stattdessen für diese Verwendung. Modus können.
spezifizieren Sie die beiden spezifischen Modi schreibgeschützt or teilbar. Quelle Typ kann den Typ angeben
der Quelle (Block|Datei) Cache-Speicher kann einer von "Standard", "Keine", "Durchschreiben",
"writeback", "directsync" oder "unsafe". jothread ist die Zahl im Bereich von
Domänen-IOThreads, an die dieser Datenträger angeschlossen werden kann (nur QEMU). seriell ist die serie
des Plattengeräts. wwn ist das wwn des Plattengeräts. Rawio zeigt an, dass die Festplatte rawio . benötigt
Fähigkeit. Adresse ist die Adresse des Plattengeräts in der Form
pci:domain.bus.slot.function, scsi:controller.bus.unit, ide:controller.bus.unit oder
ccw:cssid.ssid.devno. Bei Virtio-ccw-Geräten muss die CSS-ID auf 0xfe gesetzt sein.
Multifunktions- zeigt an, dass die angegebene PCI-Adresse eine Multifunktions-PCI-Geräteadresse ist.

If --print-xml angegeben ist, lautet die XML-Datei der anzuhängenden Festplatte
stattdessen gedruckt.

If --Live angegeben ist, wirken sich auf eine laufende Domäne aus. Wenn --config angegeben ist, beeinflussen die
nächsten Start einer persistenten Domäne. Wenn --aktuell angegeben ist, wirkt sich auf den Strom aus
Domänenstatus. Beide --Live und --config Flags können angegeben werden, aber --aktuell is
exklusiv. Wenn kein Flag angegeben ist, wird eine Legacy-API verwendet, deren Verhalten von der
Hypervisor-Treiber.

Aus Kompatibilitätsgründen, --hartnäckig benimmt sich wie --config für eine Offline-Domain,
und wie --Live --config für eine laufende Domäne. Ebenfalls, --teilbar ist ein Alias ​​für
--Modus teilbar.

Attach-Schnittstelle Domain tippe Quelle [[[[--Live] [--config] | [--aktuell]] | [--hartnäckig]]
[--Ziel Ziel] [--Mac mac] [--Skript Skript] [--Modell Modell] [--eingehende
Durchschnitt, Spitze, Platzen, Boden] [--ausgehend Durchschnitt, Spitze, Burst] [--gelang es] [--print-xml]
Hängen Sie eine neue Netzwerkschnittstelle an die Domäne an.

tippe kann einer der folgenden sein:

Netzwerk um eine Verbindung über ein virtuelles libvirt-Netzwerk anzuzeigen,

Brücke Verbindung über ein Bridge-Gerät auf dem Host anzeigen,

direkt um eine direkte Verbindung zu einer der Netzwerkschnittstellen des Hosts anzuzeigen oder
Brücken,

hostdev um die Verbindung mit einem Passthrough des PCI-Geräts auf dem Host anzuzeigen.

Quelle gibt die Quelle der Verbindung an. Die Quelle hängt von der Art der
Schnittstelle:

Netzwerk Name des virtuellen Netzwerks,

Brücke der Name des Brückengeräts,

direkt der Name der Schnittstelle oder Bridge des Hosts,

hostdev die PCI-Adresse der Schnittstelle des Hosts formatiert als
domain:bus:slot.funktion.

--Ziel wird verwendet, um das tap/macvtap-Gerät anzugeben, mit dem die Domäne verbunden werden soll
die Quelle. Namen, die mit 'vnet' beginnen, gelten als automatisch generiert und sind
wird jedes Mal ausgeblendet/neu generiert, wenn die Schnittstelle angeschlossen wird.

--Mac spezifiziert die MAC-Adresse der Netzwerkschnittstelle; wenn keine MAC-Adresse
gegeben, wird automatisch eine neue Adresse generiert (und im persistenten
Konfiguration, wenn "--config" in der Befehlszeile angegeben wird).

--Skript wird verwendet, um einen Pfad zu einem benutzerdefinierten Skript anzugeben, das beim Anhängen an aufgerufen werden soll
eine Brücke - diese wird anstelle des Standardskripts nicht zusätzlich aufgerufen.
Dies gilt nur für Schnittstellen von Brücke Typ und nur für Xen-Domains.

--Modell gibt das Netzwerkgerätemodell an, das der Domäne präsentiert werden soll.

--eingehende und --ausgehend die Bandbreite der Schnittstelle steuern. Mindestens einer von
durchschnittlich, Boden Paar muss angegeben werden. Die anderen zwei Haupt und Burst sind optional,
also "average,peak", "average,,burst", "average,,,floor", "average" und ",,,floor" sind
auch legal. Werte für durchschnittlich, Boden und Haupt werden in Kilobyte pro Sekunde ausgedrückt,
während Burst wird in Kilobyte in einem einzelnen Burst bei ausgedrückt Haupt Geschwindigkeit wie beschrieben in
die Network XML-Dokumentation unterhttp://libvirt.org/formatnetwork.html#elementQoS>.

--gelang es ist nur verwendbar für hostdev type und teilt libvirt mit, dass die Schnittstelle
verwaltet werden, was bedeutet, dass die libvirt vom/zum Host getrennt und wieder an diesen angehängt wird.

If --print-xml angegeben ist, dann lautet das XML der Schnittstelle, die angehängt werden würde
stattdessen gedruckt.

If --Live angegeben ist, wirken sich auf eine laufende Domäne aus. Wenn --config angegeben ist, beeinflussen die
nächsten Start einer persistenten Domäne. Wenn --aktuell angegeben ist, wirkt sich auf den Strom aus
Domänenstatus. Beide --Live und --config Flags können angegeben werden, aber --aktuell is
exklusiv. Wenn kein Flag angegeben ist, wird eine Legacy-API verwendet, deren Verhalten von der
Hypervisor-Treiber.

Aus Kompatibilitätsgründen, --hartnäckig benimmt sich wie --config für eine Offline-Domain,
und wie --Live --config für eine laufende Domäne.

Hinweis: Der optionale Zielwert ist der Name eines Geräts, das als Back-End erstellt werden soll
auf dem Knoten. Wenn nicht angegeben, wird ein Gerät namens "vnetN" oder "vifN" erstellt
automatisch.

Gerät abtrennen Domain FILE [[[[--Live] [--config] | [--aktuell]] | [--hartnäckig]]
Trennen eines Geräts von der Domäne, verwendet die gleiche Art von XML-Beschreibungen wie der Befehl
Attach-Gerät. Für Passthrough-Hostgeräte siehe auch nodedev-reattach, benötigt, wenn die
Gerät verwendet den verwalteten Modus nicht.

Hinweis: Die mitgelieferte XML-Beschreibung des Geräts sollte so spezifisch sein wie seine
Definition in der Domänen-XML. Die zum Abgleich mit dem Gerät verwendeten Attribute sind
intern zu den Treibern. Verwenden einer teilweisen Definition oder Versuch, ein Gerät zu trennen
das in der Domänen-XML nicht vorhanden ist, aber einige spezifische Attribute mit einem teilt
vorhanden ist, kann zu unerwarteten Ergebnissen führen.

If --Live angegeben ist, wirken sich auf eine laufende Domäne aus. Wenn --config angegeben ist, beeinflussen die
nächsten Start einer persistenten Domäne. Wenn --aktuell angegeben ist, wirkt sich auf den Strom aus
Domänenstatus. Beide --Live und --config Flags können angegeben werden, aber --aktuell is
exklusiv. Wenn kein Flag angegeben ist, wird eine Legacy-API verwendet, deren Verhalten von der
Hypervisor-Treiber.

Aus Kompatibilitätsgründen, --hartnäckig benimmt sich wie --config für eine Offline-Domain,
und wie --Live --config für eine laufende Domäne.

Beachten Sie, dass ältere Versionen von virsh verwendet wurden --config als Alias ​​für --hartnäckig.

Trennscheibe Domain Ziel [[[[--Live] [--config] | [--aktuell]] | [--hartnäckig]]
Trennen Sie ein Plattengerät von einer Domäne. Der Ziel ist das Gerät aus Sicht der Domäne.

If --Live angegeben ist, wirken sich auf eine laufende Domäne aus. Wenn --config angegeben ist, beeinflussen die
nächsten Start einer persistenten Domäne. Wenn --aktuell angegeben ist, wirkt sich auf den Strom aus
Domänenstatus. Beide --Live und --config Flags können angegeben werden, aber --aktuell is
exklusiv. Wenn kein Flag angegeben ist, wird eine Legacy-API verwendet, deren Verhalten von der
Hypervisor-Treiber.

Aus Kompatibilitätsgründen, --hartnäckig benimmt sich wie --config für eine Offline-Domain,
und wie --Live --config für eine laufende Domäne.

Beachten Sie, dass ältere Versionen von virsh verwendet wurden --config als Alias ​​für --hartnäckig.

Trennschnittstelle Domain tippe [--Mac mac] [[[--Live] [--config] | [--aktuell]] |
[--hartnäckig]]
Trennen Sie eine Netzwerkschnittstelle von einer Domäne. tippe Kann beides sein Netzwerk a . angeben
physisches Netzwerkgerät oder Brücke um eine Brücke zu einem Gerät anzuzeigen. Es wird empfohlen
zu verwenden, die mac Möglichkeit, zwischen den Schnittstellen zu unterscheiden, wenn mehr als eine vorhanden sind
auf der Domäne vorhanden.

If --Live angegeben ist, wirken sich auf eine laufende Domäne aus. Wenn --config angegeben ist, beeinflussen die
nächsten Start einer persistenten Domäne. Wenn --aktuell angegeben ist, wirkt sich auf den Strom aus
Domänenstatus. Beide --Live und --config Flags können angegeben werden, aber --aktuell is
exklusiv. Wenn kein Flag angegeben ist, wird eine Legacy-API verwendet, deren Verhalten von der
Hypervisor-Treiber.

Aus Kompatibilitätsgründen, --hartnäckig benimmt sich wie --config für eine Offline-Domain,
und wie --Live --config für eine laufende Domäne.

Beachten Sie, dass ältere Versionen von virsh verwendet wurden --config als Alias ​​für --hartnäckig.

Update-Gerät Domain Datei [--Macht] [[[--Live] [--config] | [--aktuell]] | [--hartnäckig]]
Aktualisieren Sie die Eigenschaften eines Geräts, das mit . verknüpft ist Domain, je nach Gerät
Definition in einer XML Dateidem „Vermischten Geschmack“. Seine --Macht Option kann verwendet werden, um eine Geräteaktualisierung zu erzwingen,
zB um eine CD-ROM auszuwerfen, auch wenn sie in der Domäne gesperrt/eingehängt ist. Siehe die
Dokumentation beihttp://libvirt.org/formatdomain.html#elementsDevices> um mehr darüber zu erfahren
libvirt XML-Format für ein Gerät.

If --Live angegeben ist, wirken sich auf eine laufende Domäne aus. Wenn --config angegeben ist, beeinflussen die
nächsten Start einer persistenten Domäne. Wenn --aktuell angegeben ist, wirkt sich auf den Strom aus
Domänenstatus. Beide --Live und --config Flags können angegeben werden, aber --aktuell is
exklusiv. Das Nichtangeben eines Flags ist dasselbe wie das Angeben --aktuell.

Aus Kompatibilitätsgründen, --hartnäckig benimmt sich wie --config für eine Offline-Domain,
und wie --Live --config für eine laufende Domäne.

Beachten Sie, dass ältere Versionen von virsh verwendet wurden --config als Alias ​​für --hartnäckig.

Hinweis: Die Verwendung von XML-Dateien mit teilweiser Gerätedefinition kann zu unerwarteten Ergebnissen führen, da
Einige Felder werden möglicherweise automatisch generiert und entsprechen daher anderen Geräten als erwartet.

Medien ändern Domain Weg [--auswerfen] [--Einfügung] [--aktualisieren] [Quelle] [--Macht] [[--Live]
[--config] | [--aktuell]] [--print-xml] [--Block]
Wechseln Sie das Medium der CD-ROM oder des Diskettenlaufwerks. Weg kann der vollqualifizierte Weg sein oder der
eindeutiger Zielname ( ) des Plattengeräts. Quelle gibt den Pfad an
der einzufügenden oder zu aktualisierenden Medien. Flagge --Block ermöglicht die Einstellung des Trägertyps in
Fall statt einer Datei ein Blockgerät als Medium für das CD-ROM- oder Diskettenlaufwerk verwendet wird.

--auswerfen zeigt an, dass das Medium ausgeworfen wird. --Einfügung zeigt an, dass die Medien sein werden
eingefügt. Quelle muss angegeben werden. Wenn das Gerät eine Quelle hat (zB
file='media'>), und Quelle ist nicht angegeben, --aktualisieren entspricht --auswerfen. Wenn der
Gerät hat keine Quelle und Quelle angegeben, --aktualisieren entspricht --Einfügung. Wenn der
Gerät hat Quelle und Quelle angegeben, --aktualisieren verhält sich wie eine Kombination aus
--auswerfen und --Einfügung. Wenn keiner von --auswerfen, --Einfügungsowie --aktualisieren angegeben,
--aktualisieren wird standardmäßig verwendet. Die --Macht Option kann verwendet werden, um einen Medienwechsel zu erzwingen.
If --Live angegeben ist, ändern Sie die Live-Konfiguration des laufenden Gasts. Wenn --config is
angegeben, persistente Konfiguration ändern, Effekt beim nächsten Booten beobachtet. --aktuell
kann eines oder beides sein leben und Config, hängt von der Implementierung des Hypervisors ab.
Beide --Live und --config Flags können angegeben werden, aber --aktuell ist exklusiv. Wenn keine Flagge ist
angegeben, ist das Verhalten je nach Hypervisor unterschiedlich. Wenn --print-xml is
angegeben, wird die XML, die zum Wechseln der Medien verwendet würde, gedruckt, anstatt sie zu ändern
die Medien.

NODEDEV BEFEHLE

Die folgenden Befehle manipulieren Host-Geräte, die durchgereicht werden sollen an
Gastdomains über Elemente in der einer Domain Sektion. Ein Knotengeräteschlüssel
wird im Allgemeinen durch den Busnamen gefolgt von seiner Adresse angegeben, wobei Unterstriche zwischen verwendet werden
alle Komponenten wie pci_0000_00_02_1, usb_1_5_3 oder net_eth1_00_27_13_6a_fe_00. Der
Knotendev-Liste gibt die vollständige Liste der Host-Geräte an, die libvirt bekannt sind, obwohl dies
umfasst Geräte, die keinem Gast zugewiesen werden können (z. B. der Versuch, das Gerät zu trennen)
PCI-Gerät, das den Festplatten-Controller des Hosts steuert, auf dem die Festplatten-Images des Gasts
live könnte dazu führen, dass das Host-System abstürzt oder neu startet).

Weitere Informationen zur Knotengerätedefinition finden Sie unter:http://libvirt.org/formatnode.html>.

Passthrough-Geräte können nicht gleichzeitig vom Host und seinen Gastdomänen verwendet werden
von mehreren aktiven Gästen gleichzeitig. Wenn die Beschreibung eines PCI-Geräts beinhaltet
das Attribut verwaltet='ja', und der Hypervisor-Treiber unterstützt dies, dann ist das Gerät in
verwalteten Modus und versucht, dieses Passthrough-Gerät in einem aktiven Gast zu verwenden
automatisch so verhalten, als ob nodedev-detach (Gaststart, Gerät Hot-Plug) und Knotendev-
wieder anbringen (Gaststätte, Gerät Hot-Unplug) wurden an den richtigen Stellen aufgerufen. Wenn ein PCI-Gerät
nicht als verwaltet gekennzeichnet ist, muss es manuell getrennt werden, bevor Gäste es verwenden können, und
manuell wieder angehängt, um an den Host zurückgegeben zu werden. Auch wenn ein Gerät manuell getrennt wird,
dann erlangt der Host die Kontrolle über das Gerät nicht ohne eine entsprechende erneute Verbindung zurück, selbst wenn
die Gäste verwenden das Gerät im verwalteten Modus.

nodedev-create FILE
Erstellen Sie auf dem Hostknoten ein Gerät, das dann virtuellen Maschinen zugewiesen werden kann.
Normalerweise kann libvirt automatisch feststellen, welche Hostknoten verfügbar sind
zur Verwendung, aber dies ermöglicht die Registrierung von Host-Hardware, die libvirt nicht verwendet hat
automatisch erkennen. Datei enthält XML für ein Top-Level Beschreibung von a
Knotengerät.

nodedev-destroy Gerät
Zerstören (stoppen) Sie ein Gerät auf dem Host. Gerät kann entweder ein Gerätename oder ein wwn Pair in sein
"wwnn,wwpn"-Format (funktioniert derzeit nur für vHBA). Beachten Sie, dass dies dazu führt, dass libvirt beendet wird
Verwaltung eines Host-Geräts und kann dieses Gerät sogar für den Rest der
physischen Host bis zu einem Neustart.

nodedev-detach Knotendev [--Treiber backend_driver]
Trennen Knotendev vom Gastgeber, damit es von den Gästen über gefahrlos genutzt werden kann
Durchgang. Dies ist umgekehrt mit nodedev-reattach, und erfolgt automatisch für
verwaltete Geräte. Aus Kompatibilitätsgründen kann dieser Befehl auch buchstabiert werden
nodedev-detach.

Verschiedene Backend-Treiber erwarten, dass das Gerät an verschiedene Dummy-Geräte gebunden ist.
Beispielsweise erwartet der Backend-Treiber "kvm" von QEMU (Standardeinstellung), dass das Gerät gebunden ist
zu pci-stub, aber sein "vfio"-Backend-Treiber erwartet, dass das Gerät an vfio-pci gebunden ist.
Der --Treiber Parameter kann verwendet werden, um den gewünschten Backend-Treiber anzugeben.

nodedev-dumpxml Gerät
Dump a XML-Darstellung für das angegebene Knotengerät, einschließlich solcher
Informationen wie der Gerätename, welcher Bus das Gerät besitzt, die Hersteller- und Produkt-ID,
und alle Fähigkeiten des Geräts, die von libvirt verwendet werden können (z. B. ob das Zurücksetzen des Geräts
unterstützt). Gerät kann entweder ein Gerätename oder ein wwn-Paar im "wwnn,wwpn"-Format sein (nur
funktioniert für HBA).

Knotendev-Liste Kappe --Baum
Listen Sie alle auf dem Knoten verfügbaren Geräte auf, die libvirt bekannt sind. Kappe verwendet wird
um die Liste nach Fähigkeitstypen zu filtern, müssen die Typen durch Kommas getrennt werden, zB
--cap pci,scsi, gültige Fähigkeitstypen umfassen 'system', 'pci', 'usb_device', 'usb',
'net', 'scsi_host', 'scsi_target', 'scsi', 'storage', 'fc_host', 'vports',
'scsi_generic'. Wenn --Baum verwendet wird, wird die Ausgabe in einem Baum formatiert, der
Eltern jedes Knotens. Kappe und --Baum sind sich gegenseitig aus.

nodedev-reattach Knotendev
Erkläre das Knotendev nicht mehr von Gästen genutzt wird und der Gastgeber wieder aufnehmen kann
normaler Gebrauch des Gerätes. Dies erfolgt automatisch für PCI-Geräte im verwalteten Modus
und USB-Geräten, muss aber explizit erfolgen, um expliziten nodedev-detach.

nodedev-reset Knotendev
Einen Geräte-Reset auslösen für Knotendev, nützlich vor der Übertragung eines Knotengeräts zwischen
Gast-Passthrough oder der Host. Libvirt führt diese Aktion oft implizit aus, wenn
erforderlich, aber dieser Befehl ermöglicht bei Bedarf ein explizites Zurücksetzen.

VIRTUELLER KONFIGURATOR NETZWERK BEFEHLE

Die folgenden Befehle manipulieren Netzwerke. Libvirt hat die Fähigkeit, virtuelle
Netzwerke, die dann von Domänen verwendet und mit tatsächlichen Netzwerkgeräten verbunden werden können. Für mehr
Detaillierte Informationen zu dieser Funktion finden Sie in der Dokumentation unter
<http://libvirt.org/formatnetwork.html> . Viele der Befehle für virtuelle Netzwerke sind
ähnlich den für Domänen verwendeten, aber die Möglichkeit, ein virtuelles Netzwerk zu benennen, ist entweder durch
seinen Namen oder UUID.

Netz-Autostart Netzwerk [--deaktivieren]
Konfigurieren Sie ein virtuelles Netzwerk, das beim Booten automatisch gestartet wird. Der --deaktivieren ganz ohne irgendetwas tun oder drücken zu müssen.
Autostart deaktivieren.

net-erstellen Datei
Erstellen Sie ein transientes (temporäres) virtuelles Netzwerk aus einer XML Datei und instanziieren
(starten) Sie das Netzwerk. Siehe die Dokumentation unterhttp://libvirt.org/formatnetwork.html>
um eine Beschreibung des XML-Netzwerkformats zu erhalten, das von libvirt verwendet wird.

Netzdefinition Datei
Definieren Sie ein inaktives persistentes virtuelles Netzwerk oder ändern Sie ein vorhandenes persistentes Netzwerk
aus der XML Datei.

Netz-Zerstörung Netzwerk
Zerstören (stoppen) Sie ein bestimmtes vorübergehendes oder dauerhaftes virtuelles Netzwerk, das durch seinen Namen angegeben ist
oder UUID. Dies tritt sofort in Kraft.

net-dumpxml Netzwerk [--inaktiv]
Geben Sie die Informationen zum virtuellen Netzwerk als XML-Dump auf stdout aus. Wenn --inaktiv is
spezifiziert, dann werden physikalische Funktionen nicht in ihre zugehörigen virtuellen erweitert
Funktionen.

net-edit Netzwerk
Bearbeiten Sie die XML-Konfigurationsdatei für ein Netzwerk.

Dies ist äquivalent zu:

virsh net-dumpxml --inactive network > network.xml
vi network.xml (oder nehmen Sie Änderungen mit Ihrem anderen Texteditor vor)
virsh net-define network.xml

außer dass es einige Fehlerüberprüfungen durchführt.

Der verwendete Editor kann durch die Umgebungsvariablen $VISUAL oder $EDITOR bereitgestellt werden, und
standardmäßig auf "vi".

Netzereignis {[Netzwerk] Event [--Schleife] [--Auszeit Sekunden] [--Zeitstempel] | --aufführen}
Warten Sie, bis eine Klasse von Netzwerkereignissen eintritt, und drucken Sie die entsprechenden Ereignisdetails
wie sie passieren. Die Ereignisse können optional gefiltert werden nach Netzwerk. Mit --aufführen as
das einzige Argument liefert eine Liste möglicher Event diesem Kunden bekannte Werte,
obwohl die Verbindung möglicherweise nicht die Registrierung für alle diese Ereignisse zulässt.

Standardmäßig ist dieser Befehl einmalig und gibt Erfolg zurück, sobald ein Ereignis eintritt; Sie
kann SIGINT (normalerweise über "Strg-C") senden, um sofort zu beenden. Wenn --Auszeit is
angegeben, gibt der Befehl das Warten auf Ereignisse nach . auf Sekunden verstrichen sind. Mit
--Schleife, druckt der Befehl alle Ereignisse bis zu einem Timeout oder einer Unterbrechungstaste.

Wann --Zeitstempel verwendet wird, wird vor der Veranstaltung ein lesbarer Zeitstempel gedruckt.

Netz-Info Netzwerk
Liefert grundlegende Informationen über die Netzwerk Objekt.

Netzliste [--inaktiv | --alle] { [--Tisch] | --Name | --uuid } [--hartnäckig]
[<--transient>] [--Auto-Start] [<--no-autostart>]
Gibt die Liste der aktiven Netzwerke zurück, wenn --alle ist angegeben, dass dies auch einschließt
definierte, aber inaktive Netzwerke, wenn --inaktiv wird nur die inaktiven angegeben
aufgeführt werden. Sie können die zurückgegebenen Netzwerke auch filtern nach --hartnäckig auflisten
die hartnäckigen, - vorübergehend um die vergänglichen aufzulisten, --Auto-Start um die aufzulisten
solche mit aktiviertem Autostart, und --kein-autostart um die mit Autostart aufzulisten
behindert.

If --Name angegeben ist, werden Netzwerknamen anstelle des tabellenformatierten ausgegeben
pro Zeile. Wenn --uuid wird angegeben, dass die UUIDs des Netzwerks anstelle von Namen gedruckt werden. Flagge
--Tisch gibt an, dass die alte tabellenformatierte Ausgabe verwendet werden soll. Dies ist das
Ursprünglich. All dies schließt sich gegenseitig aus.

HINWEIS: Wenn Sie mit älteren Servern kommunizieren, muss dieser Befehl eine Reihe von APIs verwenden
Anrufe mit einem inhärenten Rennen, bei dem ein Pool möglicherweise nicht aufgeführt ist oder mehr angezeigt wird
als einmal, wenn der Status zwischen Anrufen geändert wurde, während die Liste gesammelt wurde. Neuere
Server haben dieses Problem nicht.

Netzname Netzwerk-UUID
Wandeln Sie eine Netzwerk-UUID in einen Netzwerknamen um.

Nettostart Netzwerk
Starten Sie ein (zuvor definiertes) inaktives Netzwerk.

netto-undefinieren Netzwerk
Definieren Sie die Konfiguration für ein persistentes Netzwerk. Wenn das Netzwerk aktiv ist, machen Sie es
vergänglich.

net-uuid Netzwerkname
Konvertieren Sie einen Netzwerknamen in eine Netzwerk-UUID.

Netz-Update Netzwerk Befehl Abschnitt xml [--parent-index Index] [[--Live] [--config] |
[--aktuell]]
Aktualisieren Sie den angegebenen Abschnitt einer vorhandenen Netzwerkdefinition mit den Änderungen
wahlweise mit sofortiger Wirkung, ohne Zerstörung und Neustart der
Netzwerk.

Befehl ist eine von "add-first", "add-last", "add" (ein Synonym für add-last), "delete",
oder "ändern".

Abschnitt ist einer von "bridge", "domain", "ip", "ip-dhcp-host", "ip-dhcp-range",
"forward", "forward-interface", "forward-pf", "portgroup", "dns-host", "dns-txt" oder
„dns-srv“, wobei jeder Abschnitt durch eine Verkettung der XML-Elementhierarchie benannt wird
was dazu führt, dass das Element geändert wird. Zum Beispiel ändert „ip-dhcp-host“ a
Element, das in a enthalten ist Element innerhalb eines Element der
Netzwerk.

xml ist entweder der Text eines vollständigen XML-Elements des geänderten Typs (z
"
vollständiges XML-Element. Die Begriffsklärung erfolgt durch Betrachten des ersten Zeichens der
bereitgestellter Text - wenn das erste Zeichen "<" ist, ist es XML-Text, wenn das erste Zeichen
nicht "<" ist, sondern der Name einer Datei, die den zu verwendenden XML-Text enthält.

Der --parent-index Option wird verwendet, um anzugeben, welches von mehreren übergeordneten Elementen die
angefordertes Element ist in (0-basiert). Zum Beispiel ein DHCP Element könnte in jedem sein
einer von mehreren Elemente im Netzwerk; Wenn kein übergeordneter Index bereitgestellt wird, wird die
"am besten geeignet" Element ausgewählt wird (normalerweise das einzige, das bereits
hat ein Element), aber wenn --parent-index gegeben ist, dass bestimmte Instanz von
bekommt die Modifikation.

If --Live angegeben ist, wirken sich auf ein laufendes Netzwerk aus. Wenn --config angegeben ist, beeinflussen
der nächste Start eines persistenten Netzwerks. Wenn --aktuell angegeben ist, beeinflussen die
aktueller Netzwerkzustand. Beide --Live und --config Flags können angegeben werden, aber --aktuell is
exklusiv. Das Nichtangeben eines Flags ist dasselbe wie das Angeben --aktuell.

net-dhcp-leasing Netzwerk [mac]
Rufen Sie eine Liste der DHCP-Leases für alle Netzwerkschnittstellen ab, die mit dem angegebenen virtuellen verbunden sind
Netzwerk oder begrenzte Ausgabe nur für eine Schnittstelle, wenn mac angegeben.

INTERFACE BEFEHLE

Die folgenden Befehle bearbeiten Hostschnittstellen. Oft können diese Host-Schnittstellen dann
namentlich innerhalb der Domain verwendet werden Elemente (z. B. eine vom System erstellte Bridge
Schnittstelle), aber es ist nicht erforderlich, dass Hostschnittstellen an eine bestimmte gebunden sind
Gastkonfigurations-XML überhaupt.

Viele der Befehle für Hostschnittstellen ähneln denen, die für Domänen verwendet werden, und die
Eine Schnittstelle kann entweder nach ihrem Namen oder nach ihrer MAC-Adresse benannt werden. Allerdings mit einem MAC
Adresse für ein iface Argument funktioniert nur, wenn diese Adresse eindeutig ist (wenn eine Schnittstelle und
eine Bridge teilt die gleiche MAC-Adresse, was oft der Fall ist, und verwendet dann diese MAC-Adresse
führt zu einem Fehler aufgrund von Mehrdeutigkeit, und Sie müssen stattdessen auf einen Namen zurückgreifen).

iface-Brücke Schnittstelle Brücke [--no-stp] [verzögern] [--kein Start]
Erstellen Sie ein Bridge-Gerät mit dem Namen Brücke, und schließen Sie das vorhandene Netzwerkgerät an Schnittstelle
zur neuen Brücke. Die neue Bridge startet standardmäßig sofort mit aktiviertem STP
und eine Verzögerung von 0; Diese Einstellungen können mit geändert werden --no-stp, --kein StartUnd ein
ganze Zahl von Sekunden für verzögern. Alle IP-Adresskonfiguration von Schnittstelle wird sein
auf das neue Bridge-Gerät verschoben.

[VORLÄUFIGE VOLLAUTOMATISCHE TEXTÜBERSETZUNG - muss noch überarbeitet werden. Wir bitten um Ihr Verständnis.] iface-unbridge um diesen Vorgang rückgängig zu machen.

iface-definieren Datei
Definieren Sie eine inaktive persistente physische Hostschnittstelle oder ändern Sie eine vorhandene persistente
eine aus dem XML Datei.

ifface-zerstören Schnittstelle
Zerstören (stoppen) Sie eine bestimmte Host-Schnittstelle, indem Sie beispielsweise "if-down" ausführen, um diese zu deaktivieren
Schnittstelle aus aktiver Nutzung. Diese tritt sofort in Kraft.

iface-dumpxml Schnittstelle [--inaktiv]
Geben Sie die Hostschnittstelleninformationen als XML-Dump an stdout aus. Wenn --inaktiv is
angegeben, dann spiegelt die Ausgabe den dauerhaften Zustand der Schnittstelle wider, die sein wird
beim nächsten Start verwendet.

iface-bearbeiten Schnittstelle
Bearbeiten Sie die XML-Konfigurationsdatei für eine Hostschnittstelle.

Dies ist äquivalent zu:

virsh iface-dumpxml iface > iface.xml
vi iface.xml (oder nehmen Sie Änderungen mit Ihrem anderen Texteditor vor)
virsh iface-define iface.xml

außer dass es einige Fehlerüberprüfungen durchführt.

Der verwendete Editor kann durch die Umgebungsvariablen $VISUAL oder $EDITOR bereitgestellt werden, und
standardmäßig auf "vi".

iface-Liste [--inaktiv | --alle]
Gibt die Liste der aktiven Hostschnittstellen zurück. Wenn --alle angegeben wird dies auch
enthalten definierte, aber inaktive Schnittstellen. Wenn --inaktiv angegeben ist nur das inaktive
diejenigen werden aufgelistet.

iface-name Schnittstelle
Konvertieren Sie den MAC einer Hostschnittstelle in einen Schnittstellennamen, wenn die MAC-Adresse unter den eindeutig ist
Host-Schnittstellen.

Schnittstelle gibt die MAC-Adresse der Schnittstelle an.

iface-mac Schnittstelle
Konvertieren Sie einen Hostschnittstellennamen in eine MAC-Adresse.

Schnittstelle gibt den Schnittstellennamen an.

ifface-Start Schnittstelle
Starten Sie eine (zuvor definierte) Host-Schnittstelle, z. B. durch Ausführen von "if-up".

iface-unbridge Brücke [--kein Start]
Reißen Sie ein Bridge-Gerät mit dem Namen ab Brücke, wodurch die zugrunde liegende Schnittstelle wieder freigegeben wird
normale Nutzung und Verschieben der gesamten IP-Adresskonfiguration vom Bridge-Gerät zum
darunterliegendes Gerät. Die zugrunde liegende Schnittstelle wird neu gestartet, es sei denn --kein Start is
Geschenk; Dieses Flag ist aus Symmetriegründen vorhanden, wird aber im Allgemeinen nicht empfohlen.

[VORLÄUFIGE VOLLAUTOMATISCHE TEXTÜBERSETZUNG - muss noch überarbeitet werden. Wir bitten um Ihr Verständnis.] iface-Brücke um eine Brücke zu bauen.

iface-undefiniert Schnittstelle
Definieren Sie die Konfiguration für eine inaktive Hostschnittstelle.

ifface-beginnen
Erstellen Sie einen Snapshot der aktuellen Hostschnittstelleneinstellungen, der später festgeschrieben werden kann
(iface-commit) oder restauriert (iface-rollback). Wenn bereits ein Snapshot vorhanden ist, dann dieser
Der Befehl schlägt fehl, bis der vorherige Snapshot festgeschrieben oder wiederhergestellt wurde.
Undefiniertes Verhalten ergibt sich, wenn externe Änderungen an Hostschnittstellen außerhalb vorgenommen werden
der libvirt-API zwischen dem Beginn eines Snapshots und seinem eventuellen Commit oder
zurückrollen.

iface-commit
Deklarieren Sie alle Änderungen seit dem letzten ifface-beginnen als funktionierend, und löschen Sie das Rollback
Punkt. Wenn noch kein Schnittstellen-Snapshot gestartet wurde, wird dieser Befehl dies tun
Scheitern.

iface-rollback
Setzen Sie alle Host-Schnittstelleneinstellungen auf den zuletzt aufgezeichneten Zustand zurück ifface-beginnen.
Wenn noch kein Schnittstellen-Snapshot gestartet wurde, schlägt dieser Befehl fehl.
Der Neustart des Hosts dient auch als impliziter Rollback-Punkt.

Lagerung POOL BEFEHLE

Die folgenden Befehle bearbeiten Speicherpools. Libvirt hat die Fähigkeit zu verwalten
verschiedene Speicherlösungen, darunter Dateien, Raw-Partitionen und domänenspezifische Formate,
Wird verwendet, um die Speichervolumes bereitzustellen, die als Geräte in virtuellen Maschinen sichtbar sind. Für mehr
Detaillierte Informationen zu dieser Funktion finden Sie in der Dokumentation unter
<http://libvirt.org/formatstorage.html> . Viele der Befehle für Pools ähneln denen
diejenigen, die für Domänen verwendet werden.

Speicherpoolquellen finden tippe [Quellenspez]
Gibt XML zurück, das alle möglichen verfügbaren Speicherpoolquellen beschreibt, die verwendet werden könnten
um einen Speicherpool eines gegebenen zu erstellen oder zu definieren tippe. Wenn Quellenspez vorgesehen ist, ist es a
Datei, die XML enthält, um die Abfrage für Pools weiter einzuschränken.

Nicht alle Speicherpools unterstützen die Erkennung auf diese Weise. Außerdem für diejenigen, die es tun
Erkennung unterstützen, sind nur bestimmte XML-Elemente erforderlich, um gültig zurückzugeben
Daten, während andere Elemente und sogar Attribute einiger Elemente ignoriert werden, da sie
sind nicht erforderlich, um den Pool anhand der Suchkriterien zu finden. Die folgenden Listen
die unterstützt tippe Optionen und die erwarteten minimalen XML-Elemente, die verwendet werden, um die auszuführen
Suche.

Für einen „netfs“- oder „gluster“-Pool ist das erwartete Mindest-XML erforderlich
-Element mit einem "Name"-Attribut, das die zu verwendende IP-Adresse oder den Hostnamen beschreibt
finde das Becken. Das Attribut „port“ wird ignoriert, ebenso wie jedes andere bereitgestellte XML
Elemente in Quellenspez.

Für einen "logischen" Pool ist der Inhalt der Quellenspez Datei werden ignoriert, obwohl if
sofern die Datei zumindest vorhanden sein muss.

Für einen „iscsi“-Pool ist das mindestens erforderliche XML-Expect der Element mit a
"name"-Attribut, das die IP-Adresse oder den Hostnamen beschreibt, der zum Suchen des Pools verwendet werden soll
(die iSCSI-Serveradresse). Optional kann jedoch das Attribut "port" bereitgestellt werden
standardmäßig wird 3260 verwendet. Optional kann an XML-Element mit einem "Namen"
-Attribut kann bereitgestellt werden, um die iSCSI-Zielsuche weiter auf ein bestimmtes einzuschränken
Initiator für Multi-IQN-iSCSI-Speicherpools.

find-storage-pool-sources-as tippe [Gastgeber] [port ] [Initiator]
Anstatt bereitzustellen Quellenspez XML-Datei für Speicherpoolquellen finden benutze diesen Befehl
Option, damit virsh die Abfrage-XML-Datei mit der optionalen generiert
Argumente. Der Befehl gibt dieselbe Ausgabe-XML zurück wie Speicherpoolquellen finden.

Wasser Gastgeber um einen bestimmten Host zu beschreiben, der für Netzwerkspeicher verwendet werden soll, z. B. netfs,
gluster und iscsi tippe Pools.

Wasser port um weiter einzuschränken, welcher Netzwerkport für die Verbindung verwendet werden soll, wenn
erforderlich durch das spezifische Speicher-Backend, wie z. B. iscsi.

Wasser Initiator iscsi weiter einzuschränken tippe Sammeln Sie Suchen zu einem bestimmten Ziel
Initiatoren.

Pool-Autostart pool-oder-uuid [--deaktivieren]
Konfigurieren Sie ob Pool sollte automatisch beim Booten starten.

Poolbau pool-oder-uuid [--überschreiben] [--no-overwrite]
Baue einen bestimmten Pool.

Optionen --überschreiben und --no-overwrite kann nur für verwendet werden Poolbau ein Dateisystem bzw
Plattenpool. Für einen Dateisystempool, wenn keiner von beiden angegeben ist, Poolbau macht
das Verzeichnis. Wenn --no-overwrite angegeben ist, prüft es, ob ein Dateisystem
existiert bereits auf dem Zielgerät, gibt einen Fehler zurück, falls vorhanden, oder verwendet mkfs to
formatieren Sie das Zielgerät, wenn nicht. Wenn --überschreiben angegeben ist, wird mkfs immer ausgeführt
und alle vorhandenen Daten auf dem Zielgerät werden bedingungslos überschrieben. Für eine Festplatte
pool, wenn keiner von beiden angegeben ist oder --no-overwrite angegeben, Poolbau werden wir
Verwenden Sie 'parted --print', um festzustellen, ob die Festplatte bereits zuvor ein Label hatte
versucht, einen zu erstellen. Nur wenn eine Festplatte noch keine hat, wird ein Label angezeigt
erstellt. Wenn --überschreiben angegeben ist oder festgestellt wurde, dass die Festplatte dies nicht tut
bereits eines haben, wird 'parted mklabel' verwendet, um ein Etikett des Formats zu erstellen
angegeben durch den Pool-Quellformattyp oder "dos", wenn nicht für den Pool angegeben.

Pool erstellen Datei [--bauen] [[--überschreiben] | [--no-overwrite]]
Erstellen und starten Sie ein Pool-Objekt aus dem XML Datei.

[--bauen] [[--überschreiben] | [--no-overwrite]] führe a aus Poolbau nach Erstellung in
um die Notwendigkeit eines Folgebefehls zum Erstellen des Pools zu beseitigen. Der --überschreiben
und --no-overwrite Flaggen folgen den gleichen Regeln wie Poolbau. Wenn nur --bauen is
dann vorausgesetzt Poolbau wird ohne Flags aufgerufen.

pool-erstellen-als Name tippe [--print-xml] [--source-host hostname] [--source-path Weg]
[--source-dev Weg] [--Quellenname Name] [--Ziel Weg] [--source-format Format]
[--Authentifizierungstyp Authentifizierungstyp --auth-Benutzername Benutzername --secret-usage Verwendung] [[--adapter-name
Name] | [--adapter-wwnn --adapter-wwpn] [--adapter-parent Elternteil]] [--bauen]
[[--überschreiben] | [--no-overwrite]]
Erstellen und starten Sie ein Pool-Objekt Name aus den Rohparametern. Wenn --print-xml is
angegeben, dann drucken Sie das XML des Pool-Objekts, ohne den Pool zu erstellen.
Ansonsten hat der Pool die angegebenen tippe. Beim Benutzen pool-erstellen-als für einen Pool von
tippe "Festplatte", die vorhandenen Partitionen, die auf der gefunden werden --source-dev Weg wird daran gewöhnt sein
Befüllen Sie den Plattenpool. Daher wird die Verwendung empfohlen pool-definieren-als und Schwimmbad-
bauen an. Nach der Installation können Sie HEIC-Dateien mit der --überschreiben um den Plattenpool richtig zu initialisieren.

[--source-host hostname] stellt den Quellhostnamen für Pools bereit, die durch Speicher von unterstützt werden
ein entfernter Server (Pool-Typen netfs, iscsi, rbd, sheepdog, gluster).

[--source-path Weg] stellt den Quellverzeichnispfad für Pools bereit, die von unterstützt werden
Verzeichnisse (Pooltyp dir).

[--source-dev Weg] stellt den Quellpfad für Pools bereit, die von physischen Geräten unterstützt werden
(Pooltypen fs, logisch, Festplatte, iscsi, zfs).

[--Quellenname Name] stellt den Quellnamen für Pools bereit, die von einem benannten Speicher unterstützt werden
Element (Pool-Typen logisch, rbd, Schäferhund, Gluster).

[--Ziel Weg] ist der Pfad für die Zuordnung des Speicherpools zur Hostdatei
System.

[--source-format Format] gibt Auskunft über das Format des Pools (Pool-Typen
fs, netfs, Festplatte, logisch).

[--Authentifizierungstyp Authentifizierungstyp --auth-Benutzername Benutzername --secret-usage Verwendung] bietet die
Elemente, die zum Generieren von Authentifizierungsdaten für den Speicherpool erforderlich sind. Der
Authentifizierungstyp ist entweder chap für iscsi tippe pools oder ceph für rbd tippe Pools.

[--adapter-name Name] definiert den scsi_hostN-Adapternamen, der für scsi_host verwendet werden soll
Adaptertyp-Pool.

[--adapter-wwnn --adapter-wwpn [--adapter-parent Elternteil]] definiert wwnn und wwpn to
für den Adaptertyppool fc_host verwendet werden. Der Elternteil gibt optional den Namen von an
das scsi_hostN-Knotengerät, das für den vHBA verwendet werden soll.

[--bauen] [[--überschreiben] | [--no-overwrite]] führe a aus Poolbau nach Erstellung in
um die Notwendigkeit eines Folgebefehls zum Erstellen des Pools zu beseitigen. Der --überschreiben
und --no-overwrite Flaggen folgen den gleichen Regeln wie Poolbau. Wenn nur --bauen is
dann vorausgesetzt Poolbau wird ohne Flags aufgerufen.

Pool-definieren Datei
Definieren Sie einen inaktiven persistenten Speicherpool oder ändern Sie einen vorhandenen persistenten Speicherpool
die XML-Datei Datei.

pool-definieren-als Name tippe [--print-xml] [--source-host hostname] [--source-path Weg]
[--source-dev Weg] [--Quellenname Name] [--Ziel Weg] [--source-format Format]
[--Authentifizierungstyp Authentifizierungstyp --auth-Benutzername Benutzername --secret-usage Verwendung] [[--adapter-name
Name] | [--adapter-wwnn --adapter-wwpn] [--adapter-parent Elternteil]]
Erstellen Sie ein Poolobjekt, aber starten Sie es nicht Name aus den Rohparametern. Wenn --print-xml
angegeben ist, drucken Sie dann das XML des Pool-Objekts, ohne den Pool zu definieren.
Ansonsten hat der Pool die angegebenen tippe.

Verwenden Sie die gleichen Argumente wie pool-erstellen-als, mit Ausnahme der --bauen, --überschreibensowie
--no-overwrite nach.

Pool-zerstören pool-oder-uuid
Zerstöre (stoppe) ein gegebenes Pool Objekt. Libvirt verwaltet den Speicher nicht mehr
durch das Pool-Objekt beschrieben, die im Pool enthaltenen Rohdaten werden jedoch nicht verändert,
und kann später mit wiederhergestellt werden Pool erstellen.

Pool löschen pool-oder-uuid
Zerstöre die Ressourcen, die von einem bestimmten verwendet werden Pool Objekt. Dieser Vorgang ist nicht wiederherstellbar.
Der Pool Objekt wird nach diesem Befehl noch existieren, bereit für die Erstellung eines neuen
Speichervolumen.

pool-dumpxml [--inaktiv] pool-oder-uuid
Gibt die XML-Informationen über die zurück Pool Objekt. --inaktiv weist virsh an, zu dumpen
Poolkonfiguration, die beim nächsten Start des Pools verwendet wird, im Gegensatz zu der
aktuelle Poolkonfiguration.

Pool-Bearbeitung pool-oder-uuid
Bearbeiten Sie die XML-Konfigurationsdatei für einen Speicherpool.

Dies ist äquivalent zu:

virsh pool-dumpxml pool > pool.xml
vi pool.xml (oder nehmen Sie Änderungen mit Ihrem anderen Texteditor vor)
virsh pool-define pool.xml

außer dass es einige Fehlerüberprüfungen durchführt.

Der verwendete Editor kann durch die Umgebungsvariablen $VISUAL oder $EDITOR bereitgestellt werden, und
standardmäßig auf "vi".

Pool-Info pool-oder-uuid
Liefert grundlegende Informationen über die Pool Objekt.

Pool-Liste [--inaktiv] [--alle] [--hartnäckig] [- vorübergehend] [--Auto-Start] [--kein-autostart]
[[--Einzelheiten] [ ]
Listet Pool-Objekte auf, die libvirt bekannt sind. Standardmäßig werden nur aktive Pools aufgelistet;
--inaktiv listet nur die inaktiven Pools auf, und --alle listet alle Pools auf.

Darüber hinaus gibt es mehrere Sätze von Filter-Flags. --hartnäckig ist die aufzulisten
anhaltende Pools, - vorübergehend besteht darin, die transienten Pools aufzulisten. --Auto-Start listet die
automatisch startende Pools, --kein-autostart listet die Pools mit deaktiviertem Autostart auf.

Sie können auch Pools mit bestimmten Typen mit auflisten tippe, die Pooltypen müssen
durch Komma getrennt werden, zB --type dir,disk. Zu den gültigen Pooltypen gehören „dir“, „fs“,
„netfs“, „logical“, „disk“, „iscsi“, „scsi“, „mpath“, „rbd“, „sheepdog“ und „gluster“.

Der --Einzelheiten Option weist virsh an, zusätzlich die Pool-Persistenz anzuzeigen und
kapazitätsbezogene Informationen, sofern verfügbar.

HINWEIS: Wenn Sie mit älteren Servern kommunizieren, muss dieser Befehl eine Reihe von APIs verwenden
Anrufe mit einem inhärenten Rennen, bei dem ein Pool möglicherweise nicht aufgeführt ist oder mehr angezeigt wird
als einmal, wenn der Status zwischen Anrufen geändert wurde, während die Liste gesammelt wurde. Neuere
Server haben dieses Problem nicht.

Poolname uuid
Konvertieren Sie die uuid zu einem Poolnamen.

Pool-Erfrischung pool-oder-uuid
Aktualisieren Sie die Liste der enthaltenen Volumes in Pool.

Pool-Start pool-oder-uuid [--bauen] [[--überschreiben] | [--no-overwrite]]
Starten Sie die Speicherung Pool, die zuvor definiert, aber inaktiv ist.

[--bauen] [[--überschreiben] | [--no-overwrite]] führe a aus Poolbau vor Pool-Start
um sicherzustellen, dass sich die Poolumgebung in einem erwarteten Zustand befindet, anstatt die ausführen zu müssen
build-Befehl vor dem Start. Der --überschreiben und --no-overwrite Flaggen folgen dem
gleichen Regeln wie Poolbau. Wenn nur --bauen ist dann vorgesehen Poolbau heißt mit
keine Fahnen.

Hinweis: Ein Speicherpool, der auf Remote-Ressourcen wie „iscsi“ oder (v)HBA angewiesen ist
Der gesicherte "SCSI"-Pool muss möglicherweise mehrmals aktualisiert werden, um alle zu haben
Volumen erkannt (vgl Pool-Erfrischung). Das liegt an den entsprechenden Lautstärkegeräten
möglicherweise nicht im Dateisystem des Hosts während des anfänglichen Starts des Pools oder der
aktueller Aktualisierungsversuch. Die Anzahl der Aktualisierungsversuche hängt vom Netzwerk ab
Verbindung und die Zeit, die der Host benötigt, um die entsprechenden Geräte zu exportieren.

Pool-undefine pool-oder-uuid
Definieren Sie die Konfiguration für eine inaktive Pool.

pool-uuid Pool
Gibt die UUID des benannten zurück Pool.

VOLUME BEFEHLE

vol-erstellen pool-oder-uuid FILE [--prealloc-metadata]
Erstellen Sie ein Volume aus einem XML . pool-oder-uuid ist der Name oder die UUID des Speichers
Pool zum Erstellen des Volumes. FILE ist das XML mit der Volumendefinition. Ein
einfache Möglichkeit, das XML zu erstellen ist die zu verwenden vol-dumpxml Befehl zum Abrufen der
Definition eines bereits bestehenden Volumes. [--prealloc-metadata] Metadaten vorbelegen (z
qcow2-Images, die keine vollständige Zuordnung unterstützen). Diese Option erstellt ein Sparse-Image
Datei mit Metadaten, was zu einer höheren Leistung im Vergleich zu Bildern ohne führt
Vorabzuweisung und nur geringfügig höhere anfängliche Speicherplatznutzung.

Beispiel

virsh vol-dumpxml --pool storagepool1 appvolume1 > newvolume.xml
vi newvolume.xml (oder nehmen Sie Änderungen mit Ihrem anderen Texteditor vor)
virsh vol-create differentstoragepool newvolume.xml

vol-erstellen-von pool-oder-uuid FILE [--Eingabepool pool-oder-uuid] Vol-Name-oder-Schlüssel-oder-Pfad
[--prealloc-metadata] [--reflink]
Erstellen Sie ein Volume, indem Sie ein anderes Volume als Eingabe verwenden. pool-oder-uuid ist der Name oder die UUID von
den Speicherpool, in dem das Volume erstellt werden soll. FILE ist das XML mit der Lautstärke
Definition. --Eingabepool pool-oder-uuid ist der Name oder die UUID des Speicherpools
Quell-Volume ist drin. Vol-Name-oder-Schlüssel-oder-Pfad ist der Name oder Schlüssel oder Pfad der Quelle
Volumen. [--prealloc-metadata] Metadaten vorbelegen (für qcow2-Images, die dies nicht tun
volle Zuweisung unterstützen). Diese Option erstellt eine Sparse-Bilddatei mit Metadaten,
Dies führt zu einer höheren Leistung im Vergleich zu Bildern ohne Vorabzuweisung und nur
etwas höhere anfängliche Speicherplatznutzung. Wann --reflink angegeben ist, führe einen COW durch
leichte Kopie, bei der die Datenblöcke nur kopiert werden, wenn sie geändert werden. Wenn dies nicht der Fall ist
möglich, schlägt die Kopie fehl.

vol-erstellen-als pool-oder-uuid Name Kapazität [--Zuweisung Größe] [--Format Schnur]
[--backing-vol Vol-Name-oder-Schlüssel-oder-Pfad] [--backing-vol-format Schnur]
[--prealloc-metadata]
Erstellen Sie ein Volume aus einer Reihe von Argumenten. pool-oder-uuid ist der Name oder die UUID der
Speicherpool zum Erstellen des Volumes. Name ist der Name des neuen Volumes. Für eine Festplatte
pool, muss dies mit dem Partitionsnamen übereinstimmen, der vom Quellgerät des Pools bestimmt wird
Pfad und die nächste verfügbare Partition. Beispielsweise ein Quellgerätepfad von /dev/sdb
und es gibt keine Partitionen auf der Festplatte, dann muss der Name sdb1 mit dem nächsten Namen sein
sdb2 sein und so weiter. Kapazität ist die skalierte Größe des zu erstellenden Volumes
Ganzzahl (vgl ANMERKUNG oben), standardmäßig Bytes, wenn kein Suffix vorhanden ist. --Zuweisung
Größe ist die Anfangsgröße, die dem Volume zugewiesen werden soll, ebenfalls als skalierte Ganzzahl
standardmäßig Bytes. --Format Schnur wird in dateibasierten Speicherpools verwendet, um sie anzugeben
das zu verwendende Volumendateiformat; roh, bochs, qcow, qcow2, vmdk, qed. Verwenden Sie erweitert für
Plattenspeicherpools, um eine erweiterte Partition zu erstellen (andere Werte sind gültig
aktiviert, aber nicht beibehalten, wenn libvirtd neu gestartet oder der Pool aktualisiert wird).
--backing-vol Vol-Name-oder-Schlüssel-oder-Pfad ist das zu verwendende Quell-Backing-Volume, wenn
Erstellen eines Snapshots eines vorhandenen Volumes. --backing-vol-format Schnur ist das Format von
das Snapshot-Backing-Volume; raw, bochs, qcow, qcow2, qed, vmdk, host_device. Diese
sind jedoch für dateibasierte Speicherpools gedacht. [--prealloc-metadata] vorbelegen
Metadaten (für qcow2-Images, die keine vollständige Zuordnung unterstützen). Diese Option erstellt eine
Sparse-Bilddatei mit Metadaten, was zu einer höheren Leistung im Vergleich zu Bildern führt
ohne Vorabzuweisung und nur geringfügig höherer anfänglicher Speicherplatznutzung.

Vol-Klon [--Schwimmbad pool-oder-uuid] Vol-Name-oder-Schlüssel-oder-Pfad Name [--prealloc-metadata]
[--reflink]
Klonen Sie ein vorhandenes Volume. Weniger leistungsstarke, aber einfacher zu tippende Version von vol-erstellen-
von. --Schwimmbad pool-oder-uuid ist der Name oder die UUID des Speicherpools, der erstellt werden soll
Lautstärke ein. Vol-Name-oder-Schlüssel-oder-Pfad ist der Name oder Schlüssel oder Pfad des Quellvolumes.
Name ist der Name des neuen Volumes. [--prealloc-metadata] Metadaten vorbelegen (z
qcow2-Images, die keine vollständige Zuordnung unterstützen). Diese Option erstellt ein Sparse-Image
Datei mit Metadaten, was zu einer höheren Leistung im Vergleich zu Bildern ohne führt
Vorabzuweisung und nur geringfügig höhere anfängliche Speicherplatznutzung. Wann --reflink is
angegeben, führen Sie eine COW Lightweight-Kopie durch, bei der die Datenblöcke nur dann kopiert werden, wenn
geändert. Ist dies nicht möglich, schlägt die Kopie fehl.

vol-löschen [--Schwimmbad pool-oder-uuid] Vol-Name-oder-Schlüssel-oder-Pfad [--Schnappschüsse löschen]
Löschen Sie ein bestimmtes Volume. --Schwimmbad pool-oder-uuid ist der Name oder die UUID des Speicherpools
das Volumen ist drin. Vol-Name-oder-Schlüssel-oder-Pfad ist der Name oder Schlüssel oder Pfad des Volumes zu
löschen.

Der --Schnappschüsse löschen Flag gibt an, dass alle Snapshots, die mit dem Speicher verknüpft sind
Volume sollte ebenfalls gelöscht werden. Nicht alle Speichertreiber unterstützen diese Option,
derzeit nur rbd.

Vol-Upload [--Schwimmbad pool-oder-uuid] [- Offset Bytes] [--Länge Bytes] Vol-Name-oder-Schlüssel-oder-Pfad
lokale-Datei
Laden Sie den Inhalt von hoch lokale-Datei zu einem Speichervolumen. --Schwimmbad pool-oder-uuid ist das
Name oder UUID des Speicherpools, in dem sich das Volume befindet. Vol-Name-oder-Schlüssel-oder-Pfad ist das
Name oder Schlüssel oder Pfad des Volumes, auf das die Datei hochgeladen wird. - Offset ist das
Position im Speicherdatenträger, an der mit dem Schreiben der Daten begonnen werden soll. Der Wert muss 0 sein
oder größer. --Länge ist eine Obergrenze der hochzuladenden Datenmenge. Ein Negativ
value wird als vorzeichenloser Long-Long-Wert interpretiert, um im Wesentlichen alles einzuschließen
vom Offset bis zum Ende des Bandes. Ein Fehler tritt auf, wenn die lokale-Datei is
größer als die angegebene Länge. Siehe die Beschreibung für die libvirt
virStorageVolUpload-API für Details zu möglichen Ziel-Volume- und Pool-Änderungen
als Ergebnis der Poolaktualisierung, wenn der Upload versucht wird.

Vol-Download [--Schwimmbad pool-oder-uuid] [- Offset Bytes] [--Länge Bytes] Vol-Name-oder-Schlüssel-oder-
Weg lokale-Datei
Laden Sie den Inhalt eines Speichervolumens auf herunter lokale-Datei. --Schwimmbad pool-oder-uuid ist das
Name oder UUID des Speicherpools, in dem sich das Volume befindet. Vol-Name-oder-Schlüssel-oder-Pfad ist das
Name oder Schlüssel oder Pfad des herunterzuladenden Volumes. - Offset ist die Position in der
Speichervolumen, ab dem mit dem Lesen der Daten begonnen werden soll. Der Wert muss 0 oder größer sein.
--Länge ist eine Obergrenze der herunterzuladenden Datenmenge. Ein negativer Wert ist
als vorzeichenloser long long-Wert interpretiert, um im Wesentlichen alles von einzuschließen
an das Ende des Bandes versetzt.

vol-wischen [--Schwimmbad pool-oder-uuid] [--Algorithmus Algorithmus] Vol-Name-oder-Schlüssel-oder-Pfad
Löschen Sie ein Volume, stellen Sie sicher, dass Daten, die sich zuvor auf dem Volume befanden, für zukünftige Lesevorgänge nicht zugänglich sind.
--Schwimmbad pool-oder-uuid ist der Name oder die UUID des Speicherpools, in dem sich das Volume befindet. vol-
Name-oder-Schlüssel-oder-Pfad ist der Name oder Schlüssel oder Pfad des zu löschenden Volumes. Es ist möglich
verschiedene Löschalgorithmen zu wählen, anstatt die Lautstärke mit Nullen neu zu schreiben. Dies
kann über erfolgen --Algorithmus Schalter.

Unterstützte Algorithmen
zero - 1-passiere alle Nullen
nnsa – 4-Pass NNSA Policy Letter NAP-14.1-C (XVI-8) für
Bereinigung von Wechsel- und Festplatten:
zufällig x2, 0x00, überprüfen.
dod - 4-Pass DoD 5220.22-M Abschnitt 8-306 Verfahren für
desinfizierende entfernbare und nicht entfernbare starre
Festplatten: zufällig, 0x00, 0xff, überprüfen.
bsi - 9-Pass-Methode empfohlen vom Deutschen Zentrum für
Sicherheit in Informationstechnologien
(http://www.bsi.bund.de): 0xff, 0xfe, 0xfd, 0xfb,
0xf7, 0xef, 0xdf, 0xbf, 0x7f.
gutmann - Die kanonische 35-Pass-Sequenz beschrieben in
Gutmanns Papier.
schneier - 7-Pass-Methode, beschrieben von Bruce Schneier in
"Angewandte Kryptographie" (1996): 0x00, 0xff,
zufällig x5.
pfitzner7 - Roy Pfitzners 7-Random-Pass-Methode: random x7.
pfitzner33 - Roy Pfitzners 33-Random-Pass-Methode: random x33.
zufällig - 1-Durchlauf-Muster: zufällig.

Hinweis: Die Verfügbarkeit von Algorithmen kann durch die Version des "Scrub" eingeschränkt sein
binär auf dem Host installiert.

vol-dumpxml [--Schwimmbad pool-oder-uuid] Vol-Name-oder-Schlüssel-oder-Pfad
Geben Sie die Volume-Informationen als XML-Dump auf stdout aus. --Schwimmbad pool-oder-uuid ist das
Name oder UUID des Speicherpools, in dem sich das Volume befindet. Vol-Name-oder-Schlüssel-oder-Pfad ist der Name
oder Schlüssel oder Pfad des Volumes, dessen XML ausgegeben werden soll.

Band-Info [--Schwimmbad pool-oder-uuid] Vol-Name-oder-Schlüssel-oder-Pfad
Gibt grundlegende Informationen über das angegebene Speichervolumen zurück. --Schwimmbad pool-oder-uuid ist das
Name oder UUID des Speicherpools, in dem sich das Volume befindet. Vol-Name-oder-Schlüssel-oder-Pfad ist der Name
oder Schlüssel oder Pfad des Volumes, für das Informationen zurückgegeben werden sollen.

vol-Liste [--Schwimmbad pool-oder-uuid] [--Einzelheiten]
Gibt die Liste der Datenträger im angegebenen Speicherpool zurück. --Schwimmbad pool-oder-uuid ist der Name
oder UUID des Speicherpools. Der --Einzelheiten Option weist virsh zusätzlich an
Anzeigen von Volumentyp und kapazitätsbezogenen Informationen, sofern verfügbar.

Vol-Pool [--uuid] vol-key-or-path
Gibt den Poolnamen oder die UUID für ein bestimmtes Volume zurück. Standardmäßig lautet der Poolname
ist zurückgekommen. Wenn die --uuid Option angegeben ist, wird stattdessen die Pool-UUID zurückgegeben. Vol-Taste-
oder-Weg ist der Schlüssel oder Pfad des Volumes, für das die Poolinformationen zurückgegeben werden sollen.

vol-Pfad [--Schwimmbad pool-oder-uuid] Vol-Name-oder-Schlüssel
Gibt den Pfad für ein bestimmtes Volume zurück. --Schwimmbad pool-oder-uuid ist der Name oder die UUID der
Speicherpool, in dem sich das Volume befindet. Vol-Name-oder-Schlüssel ist der Name oder Schlüssel des Volumes
gib den Pfad für zurück.

Vol-Name vol-key-or-path
Gibt den Namen für ein bestimmtes Volume zurück. vol-key-or-path ist der Schlüssel oder Pfad des Volumes
um den Namen zurückzugeben.

vol-Taste [--Schwimmbad pool-oder-uuid] Vol-Name-oder-Pfad
Gibt die Lautstärketaste für eine bestimmte Lautstärke zurück. --Schwimmbad pool-oder-uuid ist der Name oder die UUID von
der Speicherpool, in dem sich das Volume befindet. Vol-Name-oder-Pfad ist der Name oder Pfad des Volumes
um die Lautstärketaste zurückzugeben.

Vol-Größe ändern [--Schwimmbad pool-oder-uuid] Vol-Name-oder-Pfad pool-oder-uuid Kapazität [--zuordnen]
[--Delta] [--schrumpfen]
Ändert die Kapazität des angegebenen Volumes in Bytes. --Schwimmbad pool-oder-uuid ist der Name bzw
UUID des Speicherpools, in dem sich das Volume befindet. Vol-Name-oder-Schlüssel-oder-Pfad ist der Name oder Schlüssel
oder Pfad des Volumes, dessen Größe geändert werden soll. Die neue Kapazität könnte spärlich sein, es sei denn --zuordnen
angegeben. Normalerweise, Kapazität ist die neue Größe, aber wenn --Delta vorhanden ist, dann ist es
wird zur bestehenden Größe hinzugefügt. Versuche, das Volume zu verkleinern, schlagen fehl, es sei denn
--schrumpfen ist anwesend; Kapazität kann nicht negativ sein, es sei denn --schrumpfen vorgesehen ist, aber a
negatives Vorzeichen ist nicht erforderlich. Kapazität ist eine skalierte ganze Zahl (siehe ANMERKUNG oben), die
standardmäßig Bytes, wenn kein Suffix vorhanden ist. Dieser Befehl ist nur für die Speicherung sicher
Volumes, die von einem aktiven Gast nicht verwendet werden; siehe auch Blockgröße für die Live-Größenänderung.

SECRET BEFEHLE

Die folgenden Befehle manipulieren "Geheimnisse" (z. B. Passwörter, Passphrasen und Verschlüsselung
Schlüssel). Libvirt kann Geheimnisse unabhängig von ihrer Verwendung speichern und andere Objekte (z
Volumes oder Domains) können sich auf die Geheimnisse für die Verschlüsselung oder möglicherweise andere Verwendungen beziehen.
Secrets werden anhand einer UUID identifiziert. Sehenhttp://libvirt.org/formatsecret.html> für
Dokumentation des XML-Formats, das zur Darstellung von Eigenschaften von Geheimnissen verwendet wird.

geheim-definieren Datei
Erstellen Sie ein Geheimnis mit den in angegebenen Eigenschaften Datei, ohne zugeordnetes Geheimnis
Wert. Wenn Datei keine UUID angibt, wählen Sie automatisch eine aus. Wenn Datei spezifiziert
B. eine UUID eines vorhandenen Geheimnisses, ersetzen Sie dessen Eigenschaften durch Eigenschaften, die in definiert sind Datei,
ohne den geheimen Wert zu beeinträchtigen.

geheim-dumpxml secret
Ausgangseigenschaften von secret (angegeben durch seine UUID) als XML-Dump auf stdout.

geheimer Wert secret base64
Stellen Sie den zugehörigen Wert ein secret (angegeben durch seine UUID) auf den Wert
Base64-codierter Wert base64.

geheimer Wert secret
Den zugeordneten Wert ausgeben secret (angegeben durch seine UUID) an stdout, verschlüsselt
mit Base64.

Geheimnis-undefiniert secret
Löschen Sie a secret (angegeben durch seine UUID), einschließlich des zugehörigen Werts, falls vorhanden.

geheime Liste [--flüchtig] [--no-ephemer] [--Privatgelände] [--kein-privat]
Gibt die Liste der Geheimnisse zurück. Möglicherweise möchten Sie die zurückgegebenen Geheimnisse auch filtern nach
--flüchtig um die Vergänglichen aufzuzählen, --no-ephemer um die nicht-ephemeren aufzulisten,
--Privatgelände um die privaten aufzulisten, und --kein-privat um die nicht privaten aufzulisten.

SCHNAPPSCHUSS BEFEHLE

Die folgenden Befehle manipulieren Domain-Snapshots. Snapshots nehmen die Festplatte, den Speicher und
Gerätestatus einer Domain zu einem bestimmten Zeitpunkt und speichern Sie ihn für die zukünftige Verwendung. Sie haben viele
verwendet, vom Speichern einer "sauberen" Kopie eines Betriebssystemabbilds bis zum Speichern des Zustands einer Domäne vor a
potenziell destruktiver Betrieb. Snapshots werden mit einem eindeutigen Namen identifiziert. Sehen
<http://libvirt.org/formatsnapshot.html> zur Dokumentation des verwendeten XML-Formats
stellen Eigenschaften von Schnappschüssen dar.

Schnappschuss-Erstellen Domain [xml-Datei] {[--redefinieren [--aktuell]] | [--keine-Metadaten] [--Halt]
[--disk-only] [--wiederverwenden-extern] [- Ruhe] [--atomar] [--Live]}
Erstellen Sie einen Snapshot für die Domäne Domain mit den in angegebenen Eigenschaften xml-Datei.
Normalerweise sind die einzigen Eigenschaften, die für einen Domänen-Snapshot eingestellt werden können, die und
Elemente sowie wenn --disk-only gegeben ist; der Rest des
Felder werden ignoriert und automatisch von libvirt ausgefüllt. Wenn xml-Datei ist komplett
weggelassen, dann wählt libvirt einen Wert für alle Felder. Der neue Snapshot wird
aktuell werden, wie aufgeführt von Schnappschuss-aktuell.

If --Halt angegeben ist, bleibt die Domain nach dem inaktiv
Schnappschuss wird erstellt.

If --disk-only angegeben ist, enthält der Snapshot nur den Festplattenstatus und nicht den
üblicher Systemprüfpunkt mit VM-Status. Festplatten-Snapshots sind schneller als das gesamte System
Checkpoints, aber das Zurücksetzen auf einen Festplatten-Snapshot kann fsck- oder Journal-Wiederholungen erfordern,
da es wie der Plattenzustand an dem Punkt ist, an dem das Netzkabel abrupt gezogen wird;
und mischen --Halt und --disk-only verliert alle Daten, die nicht auf die Festplatte geleert wurden
Zeit.

If --redefinieren angegeben ist, dann werden alle XML-Elemente von erzeugt Snapshot-Dumpxml sind
gültig; Dies kann verwendet werden, um die Snapshot-Hierarchie von einer Maschine auf eine andere zu migrieren
Hierarchie neu erstellen für den Fall einer vorübergehenden Domäne, die weggeht und später ist
mit demselben Namen und derselben UUID neu erstellt oder geringfügige Änderungen am Snapshot vorgenommen werden
Metadaten (z. B. hostspezifische Aspekte des in den Snapshot eingebetteten Domänen-XML).
Wenn dieses Flag bereitgestellt wird, wird die xml-Datei Argument ist obligatorisch, und die Domäne
aktuelle Schnappschuss wird nicht geändert, es sei denn, die --aktuell Flagge ist auch gegeben.

If --keine-Metadaten angegeben ist, werden die Snapshot-Daten erstellt, alle Metadaten jedoch
sofort verworfen (das heißt, libvirt behandelt den Snapshot nicht als aktuell, und
kann nicht zum Snapshot zurückkehren, es sei denn --redefinieren wird später verwendet, um libvirt etwas beizubringen
die Metadaten erneut).

If --wiederverwenden-extern angegeben ist und das Snapshot-XML einen externen Snapshot anfordert
mit einem Ziel einer vorhandenen Datei, dann muss das Ziel existieren und vor-
mit korrektem Format und Metadaten erstellt. Die Datei wird dann wiederverwendet; ansonsten a
Snapshot wird abgelehnt, um den Inhalt der vorhandenen Dateien nicht zu verlieren.

If - Ruhe angegeben ist, wird libvirt versuchen, den Gastagenten zum Einfrieren und Auftauen zu verwenden
gemounteten Dateisysteme der Domäne. Wenn die Domäne jedoch keinen Gastagenten hat, Snapshot
Schöpfung wird scheitern. Derzeit erfordert dies --disk-only auch zu überstehen.

If --atomar angegeben ist, garantiert libvirt, dass der Schnappschuss entweder erfolgreich ist, oder
schlägt ohne Änderungen fehl; nicht alle Hypervisoren unterstützen dies. Wenn dieses Flag nicht ist
angegeben, dann können einige Hypervisoren fehlschlagen, nachdem sie die Aktion teilweise ausgeführt haben, und
dumpxml verwendet werden, um festzustellen, ob partielle Änderungen aufgetreten sind.

If --Live angegeben ist, erstellt libvirt den Snapshot, während der Gast läuft. Dies
erhöht die Größe des Speicherabbilds des externen Prüfpunkts. Dies ist derzeit
wird nur für externe Checkpoints unterstützt.

Das Vorhandensein von Snapshot-Metadaten verhindert Versuche, dies zu tun undefinieren eine persistente Domäne.
Bei vorübergehenden Domänen gehen Snapshot-Metadaten jedoch unbemerkt verloren, wenn die Domäne
beendet die Ausführung (ob per Befehl wie z zerstören oder durch interne Gastaktion).

Snapshot-erstellen-als Domain {[--print-xml] | [--keine-Metadaten] [--Halt] [--wiederverwenden-extern]}
[Name] [Beschreibung] [--disk-only [- Ruhe]] [--atomar] [[--Live] [--speicherspez memspez]]
[--diskspec] Festplattenspez] ...
Erstellen Sie einen Snapshot für die Domäne Domain mit dem gegebenen und ; wenn entweder
value weggelassen wird, wählt libvirt einen Wert. Wenn --print-xml angegeben ist, dann XML
passend für Schnappschuss-Erstellen ausgegeben wird, anstatt tatsächlich einen Snapshot zu erstellen.
Ansonsten wenn --Halt angegeben ist, bleibt die Domain danach in einem inaktiven Zustand
der Schnappschuss wird erstellt, und wenn --disk-only angegeben ist, wird der Schnappschuss nicht
VM-Zustand einschließen.

Der --speicherspez Option kann verwendet werden, um zu steuern, ob ein Prüfpunkt intern ist oder
extern. Der --speicherspez flag ist obligatorisch, gefolgt von a memspez der Form
[Datei=]Name[,Schnappschuss=Typ], wobei Typ sein kann nicht, internoder extern. Einschließen
ein wörtliches Komma Datei=Name, maskieren Sie es mit einem zweiten Komma. --speicherspez kann nicht benutzt werden
Zusammen mit --disk-only.

Der --diskspec Option kann verwendet werden, um zu steuern, wie --disk-only und externe Checkpoints
externe Dateien erstellen. Diese Option kann je nach Anzahl mehrfach vorkommen
von Elemente in der Domäne xml. Jeder ist im Formular
disk[,snapshot=typ][,driver=typ][,datei=name]herunterzuladen. Ein Festplattenspez müssen für Datenträger bereitgestellt werden
unterstützt durch Blockgeräte, da libvirt keine Dateinamen für diese automatisch generiert. Zu
Fügen Sie ein wörtliches Komma ein Scheibe oder Datei=Name, maskieren Sie es mit einem zweiten Komma. EIN
wörtlich --diskspec müssen jeweils vorangestellt werden Festplattenspez es sei denn alle drei Domain, Namesowie
Beschreibung sind ebenfalls vorhanden. Zum Beispiel eine Festplattenspezifikation von
"vda,snapshot=external,file=/path/to,,new" ergibt folgendes XML:




If --wiederverwenden-extern angegeben ist, und die Domäne XML oder Festplattenspez Option verlangt ein
externer Snapshot mit einem Ziel einer vorhandenen Datei, dann muss das Ziel
vorhanden und mit korrektem Format und Metadaten vorab erstellt sein. Die Datei wird dann wiederverwendet;
andernfalls wird ein Schnappschuss verweigert, um den Inhalt der vorhandenen Dateien nicht zu verlieren.

If - Ruhe angegeben ist, wird libvirt versuchen, den Gastagenten zum Einfrieren und Auftauen zu verwenden
gemounteten Dateisysteme der Domäne. Wenn die Domäne jedoch keinen Gastagenten hat, Snapshot
Schöpfung wird scheitern. Derzeit erfordert dies --disk-only auch zu überstehen.

If --keine-Metadaten angegeben ist, werden die Snapshot-Daten erstellt, alle Metadaten jedoch
sofort verworfen (das heißt, libvirt behandelt den Snapshot nicht als aktuell, und
kann nicht zum Snapshot zurückkehren, es sei denn Schnappschuss-Erstellen wird später verwendet, um libvirt zu lehren
nochmal zu den Metadaten). Dieses Flag ist nicht kompatibel mit --print-xml.

If --atomar angegeben ist, garantiert libvirt, dass der Schnappschuss entweder erfolgreich ist, oder
schlägt ohne Änderungen fehl; nicht alle Hypervisoren unterstützen dies. Wenn dieses Flag nicht ist
angegeben, dann können einige Hypervisoren fehlschlagen, nachdem sie die Aktion teilweise ausgeführt haben, und
dumpxml verwendet werden, um festzustellen, ob partielle Änderungen aufgetreten sind.

If --Live angegeben ist, erstellt libvirt den Snapshot, während der Gast läuft. Dies
erhöht die Größe des Speicherabbilds des externen Prüfpunkts. Dies ist derzeit
wird nur für externe Checkpoints unterstützt.

Schnappschuss-aktuell Domain {[--Name] | [--Sicherheitsinformationen] | [Snapshotname]}
Ohne Snapshotname, wird dies den Snapshot-XML für die aktuelle Domäne ausgeben
Schnappschuss (falls vorhanden). Wenn --Name angegeben ist, nur der aktuelle Snapshot-Name statt
die vollständige xml. Ansonsten verwenden --Sicherheitsinformationen wird auch sicherheitssensibel sein
Informationen im XML.

Bei Snapshotname, ist dies eine Anfrage, um den vorhandenen benannten Snapshot zum zu machen
aktuellen Snapshot, ohne die Domäne zurückzusetzen.

Schnappschuss-Bearbeitung Domain [Snapshotname] [--aktuell] {[--umbenennen] | [--Klon]}
Bearbeiten Sie die XML-Konfigurationsdatei für Snapshotname einer Domäne. Wenn beides Snapshotname
und --aktuell angegeben sind, erzwingen Sie auch, dass der bearbeitete Snapshot zum aktuellen wird
Schnappschuss. Wenn Snapshotname entfällt, dann --aktuell geliefert werden muss, um die zu bearbeiten
aktuelle Momentaufnahme.

Dies ist äquivalent zu:

virsh snapshot-dumpxml Dom-Name > snapshot.xml
vi snapshot.xml (oder nehmen Sie Änderungen mit Ihrem anderen Texteditor vor)
virsh snapshot-create dom snapshot.xml --redefine [--current]

außer dass es einige Fehlerüberprüfungen durchführt.

Der verwendete Editor kann durch die Umgebungsvariablen $VISUAL oder $EDITOR bereitgestellt werden, und
standardmäßig auf "vi".

If --umbenennen angegeben ist, können die Bearbeitungen den Snapshot-Namen ändern. Wenn --Klon is
angegeben, dann wird durch Ändern des Snapshot-Namens ein Klon des Snapshots erstellt
Metadaten. Wenn nichts angegeben ist, dürfen die Bearbeitungen den Snapshot-Namen nicht ändern.
Beachten Sie, dass das Ändern eines Snapshot-Namens mit Vorsicht erfolgen muss, da der Inhalt einiger
Snapshots, wie z. B. interne Snapshots innerhalb einer einzelnen qcow2-Datei, sind nur zugänglich
vom ursprünglichen Namen.

Schnappschuss-Info Domain {Schnappschuss | --aktuell}
Grundlegende Informationen über einen benannten ausgeben , oder den aktuellen Snapshot mit
--aktuell.

Schnappschuss-Liste Domain [--metadaten] [--keine-Metadaten] [{--Elternteil | --Wurzeln | [{--Baum |
--Name}]}] [{[--aus] Schnappschuss | --aktuell} [--Nachkommenschaft]] [--Blätter] [- keine Blätter]
[--inaktiv] [--aktiv] [--disk-only] [--intern] [--extern]
Listet alle verfügbaren Snapshots für die angegebene Domain auf und zeigt standardmäßig Spalten an
für den Snapshot-Namen, die Erstellungszeit und den Domänenstatus.

If --Elternteil angegeben ist, fügen Sie der Ausgabetabelle eine Spalte mit dem Namen der hinzu
übergeordnetes Element jedes Snapshots. Wenn --Wurzeln angegeben ist, wird die Liste nur gefiltert
Schnappschüsse, die keine Eltern haben. Wenn --Baum angegeben ist, erfolgt die Ausgabe in einer Baumstruktur
Format, das nur Snapshot-Namen auflistet. Diese drei Optionen schließen sich gegenseitig aus. Wenn
--Name angegeben ist, wird nur der Snapshot-Name gedruckt. Diese Option ist gegenseitig
exklusiv mit --Baum.

If --aus bereitgestellt wird, filtern Sie die Liste nach Schnappschüssen, die untergeordnete Elemente der angegebenen sind
Schnappschuss; oder wenn --aktuell bereitgestellt wird, beginnen Sie mit dem aktuellen Snapshot. Bei Verwendung in
Isolierung oder mit --Elternteil, ist die Liste auf direkte Kinder beschränkt, es sei denn
--Nachkommenschaft ist auch dabei. Bei Verwendung mit --Baum, die Verwendung von --Nachkommenschaft is
impliziert. Diese Option ist nicht kompatibel mit --Wurzeln. Beachten Sie, dass der Ausgangspunkt von
--aus or --aktuell ist nicht in der Liste enthalten, es sei denn, die --Baum Option ist auch
Geschenk.

If --Blätter angegeben ist, wird die Liste nur nach Snapshots gefiltert, die keine haben
Kinder. Ebenso wenn - keine Blätter angegeben ist, wird die Liste nur gefiltert
Schnappschüsse mit Kindern. (Beachten Sie, dass das Auslassen beider Optionen keine Filterung bewirkt, während
Wenn Sie beide Optionen angeben, wird entweder dieselbe Liste oder ein Fehler ausgegeben, je nachdem
ob der Server die Flags erkennt). Filteroptionen sind nicht kompatibel mit
--Baum.

If --metadaten angegeben ist, wird die Liste nur nach Snapshots gefiltert, die enthalten
libvirt-Metadaten und würde somit verhindern undefinieren einer persistenten Domäne oder verloren gehen
on zerstören einer transienten Domäne. Ebenso wenn --keine-Metadaten angegeben ist, die Liste
werden nur nach Snapshots gefiltert, die ohne die Notwendigkeit von libvirt-Metadaten existieren.

If --inaktiv angegeben ist, wird die Liste nach aufgenommenen Schnappschüssen gefiltert
wenn die Domäne abgeschaltet wurde. Wenn --aktiv angegeben ist, wird nach der Liste gefiltert
Snapshots, die aufgenommen wurden, als die Domäne ausgeführt wurde, und wo der Snapshot enthalten ist
den Speicherzustand, um in diesen Laufzustand zurückzukehren. Wenn --disk-only angegeben ist, die
Liste wird nach Schnappschüssen gefiltert, die aufgenommen wurden, als die Domäne ausgeführt wurde, aber
wobei der Snapshot nur den Festplattenstatus enthält.

If --intern angegeben ist, wird die Liste nach Snapshots gefiltert, die internal verwenden
Speicherung vorhandener Disk-Images. Wenn --extern angegeben ist, wird die Liste sein
in Snapshots gefiltert, die externe Dateien für Disk-Images oder Speicherstatus verwenden.

Snapshot-Dumpxml Domain Schnappschuss [--Sicherheitsinformationen]
Geben Sie die Snapshot-XML für den benannten Snapshot der Domäne aus Schnappschuss. Mit
--Sicherheitsinformationen enthält auch sicherheitsrelevante Informationen. Benutzen Snapshot-
Strom um einfach auf das XML des aktuellen Snapshots zuzugreifen.

Snapshot-Elternteil Domain {Schnappschuss | --aktuell}
Geben Sie den Namen des übergeordneten Snapshots, falls vorhanden, für die angegebene aus Schnappschuss, oder für die
aktuelle Momentaufnahme mit --aktuell.

Snapshot-zurücksetzen Domain {Schnappschuss | --aktuell} [{--Laufen | --pausiert}] [--Macht]
Setzen Sie die angegebene Domäne auf den durch angegebenen Snapshot zurück Schnappschuss, oder zum Strom
Schnappschuss mit --aktuell. Seien Sie sich bewusst, dass dies eine destruktive Aktion ist; irgendwelche Änderungen in
die Domäne seit dem letzten Schnappschuss geht verloren. Beachten Sie auch, dass der Staat
der Domäne nach Abschluss der Snapshot-Wiederherstellung ist der Status der Domäne am
Zeitpunkt, zu dem der ursprüngliche Schnappschuss aufgenommen wurde.

Normalerweise belässt die Wiederherstellung eines Snapshots die Domäne in dem Zustand, in dem sie sich zu diesem Zeitpunkt befand
der Snapshot wurde erstellt, außer dass ein Festplatten-Snapshot ohne VM-Status das verlässt
Domäne in einem inaktiven Zustand. Vorbei an entweder der --Laufen or --pausiert Flagge wird
Führen Sie zusätzliche Statusänderungen durch (z. B. das Booten einer inaktiven Domäne oder das Anhalten einer
laufende Domäne). Da transiente Domänen nicht inaktiv sein können, muss sie verwendet werden
eines dieser Flags beim Zurücksetzen auf einen Festplatten-Snapshot einer vorübergehenden Domäne.

Es gibt zwei Fälle, in denen eine Snapshot-Wiederherstellung ein zusätzliches Risiko birgt, was Folgendes erfordert
Verwendung von --Macht fortfahren. Einer ist der Fall eines Snapshots, dem die vollständige Domäne fehlt
Informationen zum Zurücksetzen der Konfiguration (z. B. Snapshots, die vor libvirt
0.9.5); da libvirt nicht beweisen kann, dass die aktuelle Konfiguration mit der darin enthaltenen übereinstimmt
Verwendung zum Zeitpunkt des Schnappschusses, Bereitstellung --Macht versichert libvirt, dass der Snapshot
mit der aktuellen Konfiguration kompatibel ist (und wenn dies nicht der Fall ist, wird die Domäne wahrscheinlich
nicht laufen). Der andere ist der Fall des Zurücksetzens von einer laufenden Domäne auf eine aktive
angeben, wo ein neuer Hypervisor erstellt werden muss, anstatt den vorhandenen wiederzuverwenden
Hypervisor, da dies Nachteile mit sich bringt, wie z. B. das Brechen vorhandener VNC oder Spice
Verbindungen; diese Bedingung tritt bei einem aktiven Snapshot auf, der nachweisbar verwendet
inkompatible Konfiguration sowie mit einem inaktiven Snapshot, der mit kombiniert wird
--Anfang or --Pause Flagge.

Schnappschuss löschen Domain {Schnappschuss | --aktuell} [--metadaten] [{--Kinder |
--nur für Kinder}]
Löschen Sie den Snapshot für die genannte Domäne Schnappschuss, oder den aktuellen Snapshot mit
--aktuell. Wenn dieser Snapshot untergeordnete Snapshots hat, werden Änderungen aus diesem Snapshot angezeigt
mit den Kindern verschmolzen. Wenn --Kinder bestanden ist, dann löschen Sie diesen Snapshot und alle anderen
Kinder dieser Momentaufnahme. Wenn --nur für Kinder übergeben wird, dann löschen Sie alle untergeordneten Elemente von
diesen Snapshot, aber lassen Sie diesen Snapshot intakt. Diese beiden Flags sind gegenseitig
exklusiv.

If --metadaten angegeben ist, dann löschen Sie nur die von verwalteten Snapshot-Metadaten
libvirt, während der Snapshot-Inhalt für den Zugriff durch externe Tools intakt bleibt;
Andernfalls werden durch das Löschen eines Snapshots auch die Dateninhalte von diesem Zeitpunkt entfernt.

NWFILTER BEFEHLE

Die folgenden Befehle manipulieren Netzwerkfilter. Netzwerkfilter ermöglichen das Filtern der
Netzwerkdatenverkehr von und zu virtuellen Maschinen. Individueller Netzwerkverkehr
Filter sind in XML geschrieben und können Verweise auf andere Netzwerkfilter enthalten, beschreiben
Verkehrsfilterregeln oder beide enthalten. Netzwerkfilter werden von virtual referenziert
Maschinen innerhalb ihrer Schnittstellenbeschreibung. Auf einen Netzwerkfilter kann verwiesen werden durch
Schnittstellen mehrerer virtueller Maschinen.

nwfilter-define xml-Datei
Machen Sie libvirt einen neuen Netzwerkfilter bekannt. Wenn ein Netzwerkfilter mit dem gleichen Namen
bereits vorhanden ist, wird es durch das neue XML ersetzt. Jede laufende virtuelle Maschine
Wenn Sie auf diesen Netzwerkfilter verweisen, werden die Netzwerkverkehrsregeln angepasst. Wenn wegen
Aus irgendeinem Grund können die Filterregeln für den Netzwerkdatenverkehr nicht von einem der instanziiert werden
virtuelle Maschinen ausgeführt werden, wird das neue XML abgelehnt.

nwfilter-undefiniert nwfilter-name
Löschen Sie einen Netzwerkfilter. Das Löschen schlägt fehl, wenn eine virtuelle Maschine ausgeführt wird
verwendet derzeit diesen Netzwerkfilter.

nwfilter-list
Listet alle verfügbaren Netzwerkfilter auf.

nwfilter-dumpxml nwfilter-name
Geben Sie die Netzwerkfilter-XML aus.

nwfilter-edit nwfilter-name
Bearbeiten Sie das XML eines Netzwerkfilters.

Dies ist äquivalent zu:

virsh nwfilter-dumpxml myfilter > myfilter.xml
vi myfilter.xml (oder nehmen Sie Änderungen mit Ihrem anderen Texteditor vor)
virsh nwfilter-define myfilter.xml

außer dass es einige Fehlerprüfungen durchführt. Der neue Netzwerkfilter kann fällig abgelehnt werden
aus demselben Grund wie in erwähnt nwfilter-define.

Der verwendete Editor kann durch die Umgebungsvariablen $VISUAL oder $EDITOR bereitgestellt werden, und
standardmäßig auf "vi".

HYPERVISOR-SPEZIFISCH BEFEHLE

HINWEIS: Die Verwendung der folgenden Befehle ist starker entmutigt. Sie können dazu führen, dass libvirt
verwirrt werden und bei nachfolgenden Operationen das Falsche tun. Sobald Sie diese verwendet haben
Befehlen, bitte melden Sie keine Probleme den libvirt-Entwicklern; die Berichte werden
ignoriert. Wenn Sie feststellen, dass diese Befehle die einzige Möglichkeit sind, etwas zu erreichen, dann
Es ist besser zu beantragen, dass das Feature als erstklassiger Bürger in den regulären aufgenommen wird
libvirt-Bibliothek.

qemu-anhängen pid
Hängen Sie einen extern gestarteten QEMU-Prozess an den libvirt-QEMU-Treiber an. Die QEMU
Prozess muss mit einer Monitorverbindung unter Verwendung des UNIX-Treibers erstellt worden sein.
Idealerweise wird für den Prozess auch das Argument „-name“ angegeben.

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

Es wird erwartet, dass nicht alle Funktionen von libvirt nach dem Anhängen an eine zuverlässig funktionieren
extern gestarteter QEMU-Prozess. Es kann Probleme mit der Gast-ABI-Änderung geben
Migration und Geräte-Hotplug oder Hotunplug funktionieren möglicherweise nicht. Die angehängte Umgebung
sollte in erster Linie als schreibgeschützt betrachtet werden.

qemu-monitor-Befehl Domain { [- hmp] | [--ziemlich]} Befehl...
Senden Sie einen beliebigen Monitorbefehl Befehl zur Domäne Domain über den qemu-Monitor.
Die Ergebnisse des Befehls werden auf stdout ausgegeben. Wenn - hmp übergeben wird, der Befehl
wird als ein menschlicher Monitorbefehl betrachtet und libvirt wird ihn automatisch konvertieren
in QMP, falls erforderlich. In diesem Fall wird das Ergebnis auch von QMP zurückkonvertiert. Wenn
--ziemlich angegeben ist und der Monitor QMP verwendet, wird die Ausgabe hübsch gedruckt.
Wenn mehr als ein Argument vorgesehen ist Befehl, werden sie mit einem Leerzeichen verkettet
dazwischen, bevor der einzelne Befehl an den Monitor weitergegeben wird.

qemu-agent-command Domain [--Auszeit Sekunden | --async | --Block] Befehl...
Senden Sie einen beliebigen Gast-Agent-Befehl Befehl zur Domäne Domain über den qemu-Agenten.
--Auszeit, --async und --Block Optionen sind exklusiv. --Auszeit erfordert Zeitüberschreitung
Sekunden Sekunden und es muss positiv sein. Wann --aysnc gegeben ist, wartet der Befehl
Timeout ob Erfolg oder Fehlschlag. Und wann --Block gegeben wird, wartet der Befehl
für immer mit Sperrzeitüberschreitung.

qemu-monitor-event [Domain] [--Veranstaltung Veranstaltungsname] [--Schleife] [--Auszeit Sekunden] [--ziemlich]
[--regex] [--kein Fall] [--Zeitstempel]
Warten Sie, bis beliebige QEMU-Monitorereignisse auftreten, und drucken Sie die Details der Ereignisse aus
wie sie passieren. Die Ereignisse können optional gefiltert werden nach Domain or Veranstaltungsnamedem „Vermischten Geschmack“. Seine
Der QMP-Befehl „query-events“ kann über verwendet werden qemu-monitor-Befehl zu erfahren, welche Ereignisse
sind unterstützt. Wenn --regex wird genutzt, Veranstaltungsname ist stattdessen ein einfacher regulärer Ausdruck
einer Literalzeichenfolge. Wenn --kein Fall wird genutzt, Veranstaltungsname passt ohne Berücksichtigung der Groß-/Kleinschreibung.

Standardmäßig ist dieser Befehl einmalig und gibt Erfolg zurück, sobald ein Ereignis eintritt; Sie
kann SIGINT (normalerweise über "Strg-C") senden, um sofort zu beenden. Wenn --Auszeit is
angegeben, gibt der Befehl das Warten auf Ereignisse nach . auf Sekunden verstrichen sind. Mit
--Schleife, druckt der Befehl alle Ereignisse bis zu einem Timeout oder einer Unterbrechungstaste. Wenn --ziemlich
angegeben ist, werden alle JSON-Ereignisdetails zur besseren Lesbarkeit hübsch gedruckt.

Wann --Zeitstempel verwendet wird, wird vor dem Ereignis ein menschenlesbarer Zeitstempel gedruckt,
und die von QEMU bereitgestellten Zeitinformationen werden weggelassen.

lxc-enter-namespace Domain -- /path/to/binary [arg1, [arg2, ...]]
Geben Sie den Namensraum von ein Domain und führen Sie den Befehl "/path/to/binary" aus, indem Sie die
angeforderte Argumente. Der Binärpfad ist relativ zum Container-Root-Dateisystem, nicht zum
Host-Root-Dateisystem. Die Binärdatei erbt die Umgebungsvariablen / Konsole
sichtbar für virsh. Dieser Befehl funktioniert nur, wenn eine Verbindung zum LXC-Hypervisor-Treiber besteht.
Dieser Befehl ist nur erfolgreich, wenn "/path/to/binary" den Exit-Status 0 hat.

Die folgenden Umgebungsvariablen können gesetzt werden, um das Verhalten von „virsh“ zu ändern

VIRSH_DEBUG=<0 bis 4>
Aktivieren Sie das ausführliche Debuggen von virsh-Befehlen. Gültige Ebenen sind

· VIRSH_DEBUG=0

DEBUG - Nachrichten auf ALLEN Ebenen werden protokolliert

· VIRSH_DEBUG=1

INFO - Protokolliert Meldungen auf den Ebenen INFO, NOTICE, WARNING und ERROR

· VIRSH_DEBUG=2

HINWEIS - Protokolliert Meldungen auf den Ebenen NOTICE, WARNING und ERROR

· VIRSH_DEBUG=3

WARNUNG - Protokolliert Meldungen auf den Ebenen WARNUNG und FEHLER

· VIRSH_DEBUG=4

FEHLER - Nachrichten nur auf FEHLER-Ebene werden protokolliert.

VIRSH_LOG_FILE="LOGDATEI"
Die Datei zum Protokollieren von virsh-Debug-Meldungen.

VIRSH_DEFAULT_CONNECT_URI
Der Hypervisor, zu dem standardmäßig eine Verbindung hergestellt werden soll. Setzen Sie dies auf einen URI im gleichen Format wie
von der akzeptiert connect Möglichkeit. Diese Umgebungsvariable wird zugunsten von verworfen
die globale LIBVIRT_DEFAULT_URI Variable, die dem gleichen Zweck dient.

LIBVIRT_DEFAULT_URI
Der Hypervisor, zu dem standardmäßig eine Verbindung hergestellt werden soll. Setzen Sie dies auf einen URI im gleichen Format wie
von der akzeptiert connect Möglichkeit. Dies überschreibt den in jedem Client festgelegten Standard-URI
config-Datei und verhindert, dass libvirt nach Treibern sucht.

VISUAL
Der von der zu verwendende Editor bearbeiten und zugehörige Optionen.

EDITOR
Der von der zu verwendende Editor bearbeiten und zugehörige Optionen, wenn "VISUAL" nicht eingestellt ist.

VIRSH_HISTSIZE
Die Anzahl der Befehle, die im Befehlsverlauf gespeichert werden sollen. Der Standardwert ist 500.

LIBVIRT_DEBUG=EBENE
Aktivieren Sie das ausführliche Debugging aller libvirt-API-Aufrufe. Gültige Level sind

· LIBVIRT_DEBUG=1

Nachrichten auf Level DEBUG oder höher

· LIBVIRT_DEBUG=2

Nachrichten auf der Ebene INFO oder höher

· LIBVIRT_DEBUG=3

Meldungen der Stufe WARNUNG oder höher

· LIBVIRT_DEBUG=4

Meldungen auf Stufe ERROR oder höher

Weitere Informationen zu Debugging-Optionen finden Sie unter
"http://libvirt.org/logging.html"

Verwenden Sie virsh online mit den Diensten von onworks.net