virsh - Online w chmurze

PROGRAM:

IMIĘ

virsh - interfejs użytkownika do zarządzania

STRESZCZENIE

Virsh [OPCJA]... [KOMENDA_STRING]

Virsh [OPCJA] ... COMMAND [ARG] ...

OPIS

Virsh program jest głównym interfejsem do zarządzania domenami gościnnymi virsh. Program może
służyć do tworzenia, wstrzymywania i zamykania domen. Można go również używać do wyświetlania bieżących
domeny. Libvirt to zestaw narzędzi C umożliwiający interakcję z najnowszymi możliwościami wirtualizacji
wersje Linuksa (i innych systemów operacyjnych). Jest to wolne oprogramowanie dostępne na licencji GNU Lesser
Powszechna licencja publiczna. Wirtualizacja systemu operacyjnego Linux oznacza możliwość
uruchamiać jednocześnie wiele wystąpień systemów operacyjnych na jednym systemie sprzętowym, gdzie
podstawowe zasoby są obsługiwane przez instancję Linuksa. Biblioteka ma na celu udostępnianie długich
terminowo stabilne API C. Obecnie obsługuje Xen, QEMU, KVM, LXC, OpenVZ, VirtualBox i
VMware ESX.

Podstawowa struktura większości zastosowań virsh to:

virsh [OPCJA]... [ARG]...

Gdzie komenda jest jednym z poleceń wymienionych poniżej; domena jest numerycznym identyfikatorem domeny lub
nazwa domeny lub identyfikator UUID domeny; I ARGI są opcjami specyficznymi dla poleceń. Jest kilka
wyjątki od tej reguły w przypadkach, gdy dane polecenie działa na wszystkich domenach,
całą maszynę lub bezpośrednio na hypervisorze Xen. Te wyjątki będą jasne
każde z tych poleceń. Uwaga: dopuszczalne jest nadawanie domenom nazw numerycznych,
jednakże spowoduje to utworzenie domeny, którą można zidentyfikować jedynie na podstawie identyfikatora domeny. W
innymi słowy, jeśli podana zostanie wartość liczbowa, zostanie ona zinterpretowana jako identyfikator domeny, a nie jako
imię.

Virsh program może być użyty do jego uruchomienia COMMAND wydając polecenie i jego
argumenty w wierszu poleceń powłoki lub a KOMENDA_STRING który jest pojedynczym argumentem powłoki
składający się z wielu COMMAND akcje i ich argumenty połączone spacjami oraz
oddzielone średnikami pomiędzy poleceniami. W KOMENDA_STRING, virsh rozumie
te same ucieczki pojedyncze, podwójne i ukośniki odwrotne, co w powłoce, chociaż musisz dodać kolejny
warstwa powłoki uciekająca podczas tworzenia pojedynczego argumentu powłoki. Jeśli nie zostanie wydane żadne polecenie
linia poleceń, Virsh następnie uruchomi minimalny interpreter czekający na Twoje polecenia,
i porzucić polecenie spowoduje zamknięcie programu.

Virsh program rozumie, co następuje OPCJE.

-c, --łączyć URI
Połącz się z określonym URI, jakby przy connect polecenie zamiast domyślnego
połączenia.

-d, --odpluskwić POZIOM
Włącz komunikaty debugowania w liczbie całkowitej POZIOM i powyżej. POZIOM może wynosić od 0 do 4
(domyślny). Zapoznaj się z dokumentacją VIRSH_DEBUG zmienna środowiskowa poniżej dla
opis każdego POZIOM.

-e, --ucieczka ciąg
Ustaw alternatywną sekwencję ucieczki dla konsola Komenda. Domyślnie telnet ^] Jest używane.
Dozwolone znaki w notacji kapeluszowej to: znak alfabetu, @, [, ], \, ^,
_.

-h, --help
Zignoruj ​​wszystkie inne argumenty i zachowuj się tak, jakby pomoc zamiast tego wydano polecenie.

-k, --keepalive-interwał INTERWAŁ
Ustaw INTERWAŁ (w sekundach) za wysyłanie wiadomości podtrzymujących w celu sprawdzenia, czy
połączenie z serwerem jest nadal aktywne. Ustawienie interwału na 0 wyłącza klienta
mechanizm utrzymywania aktywności.

-K, --keepalive-count COUNT
Ustaw, ile razy wiadomość podtrzymująca może zostać wysłana bez otrzymania odpowiedzi od
serwer bez zaznaczania martwego połączenia. To ustawienie nie ma żadnego wpływu
sprawa INTERWAŁ jest ustawiony na 0.

-l, --Dziennik FILE
Wyprowadź szczegóły rejestrowania do FILE.

-q, --cichy
Unikaj dodatkowych wiadomości informacyjnych.

-r, --tylko czytać
Ustaw początkowe połączenie jako tylko do odczytu, tak jakby było to możliwe --tylko czytać opcja connect
dowództwo.

-t, --wyczucie czasu
Wyprowadź informacje o czasie, który upłynął dla każdego polecenia.

-v, --wersja[=krótka]
Zignoruj ​​wszystkie inne argumenty i wypisz wersję biblioteki libvirt virsh
pochodzące z

-V, --wersja=długa
Zignoruj ​​wszystkie inne argumenty i wypisz wersję biblioteki libvirt virsh
skąd pochodzi i jakie opcje i sterowniki są wkompilowane.

UWAGI

Większość Virsh operacje polegają na tym, że biblioteka libvirt może połączyć się z już
uruchomienie usługi libvirtd. Zwykle można to zrobić za pomocą polecenia wywołaj-rc.d libvirtd
początek.

Większość Virsh wykonywanie poleceń wymaga uprawnień roota ze względu na używane kanały komunikacji
porozmawiać z hypervisorem. Uruchomienie jako użytkownik inny niż root spowoduje zwrócenie błędu.

Większość Virsh polecenia działają synchronicznie, z wyjątkiem może zamknięcia, setvcpus i setmem. W
w tych przypadkach fakt, że Virsh zwrócony program, nie może oznaczać, że akcja została zakończona
i należy okresowo odpytywać, aby wykryć, że gość zakończył operację.

Virsh dąży do wstecznej kompatybilności. Chociaż pomoc polecenie wyświetla tylko listę
preferowane użycie polecenia, jeśli starsza wersja Virsh obsługiwał alternatywną pisownię
polecenia lub opcji (np --tunelowany zamiast --tunelowany), a następnie skrypty używające
że starsza pisownia będzie nadal działać.

Kilka Virsh polecenia przyjmują opcjonalnie skalowaną liczbę całkowitą; jeśli nie jest podana skala, to tak
wartość domyślna jest wymieniona w poleceniu (ze względów historycznych niektóre polecenia mają domyślną wartość
bajtów, podczas gdy inne polecenia domyślnie używają kibibajtów). Poniższe nie uwzględnia wielkości liter
przyrostki mogą być użyte do wybrania konkretnej skali:
b, bajt bajt 1
KB kilobajt 1,000
k, KiB kibibajt 1,024
MB megabajt 1,000,000 XNUMX XNUMX
M, MiB mebibajt 1,048,576 XNUMX XNUMX
GB gigabajt 1,000,000,000 XNUMX XNUMX XNUMX
G, gibibajt GiB 1,073,741,824 XNUMX XNUMX XNUMX
Terabajt TB 1,000,000,000,000 XNUMX XNUMX XNUMX XNUMX
T, TiB tebibajt 1,099,511,627,776 XNUMX XNUMX XNUMX XNUMX
Petabajt PB 1,000,000,000,000,000 XNUMX XNUMX XNUMX XNUMX XNUMX
P, PiB pebibajt 1,125,899,906,842,624 XNUMX XNUMX XNUMX XNUMX XNUMX
EB eksabajt 1,000,000,000,000,000,000 XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX
E, EiB eksbibajt 1,152,921,504,606,846,976 XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX

RODZAJOWY POLECENIA

Poniższe polecenia mają charakter ogólny, tj. nie są specyficzne dla domeny.

pomoc [polecenie-lub-grupa]
Zawiera listę wszystkich poleceń virsh. W przypadku użycia bez opcji wszystkie polecenia są takie
wymienione, po jednym w wierszu, pogrupowane w powiązane kategorie i wyświetlające słowo kluczowe dla każdej z nich
grupa.

Aby wyświetlić tylko polecenia dla określonej grupy, podaj słowo kluczowe dla tej grupy jako an
opcja. Na przykład:

virsh # pomoc hosta

Host i Hypervisor (słowo kluczowe pomocy „host”):
możliwości możliwości
cpu-models pokazują modele procesorów dla danej architektury
połącz (ponownie) połącz się z hypervisorem
wolna pamięć freecell NUMA
nazwa hosta wypisz nazwę hosta hypervisora
qemu-attach Dołącz do istniejącego procesu QEMU
qemu-monitor-command Polecenie monitorowania QEMU
qemu-agent-command Polecenie agenta gościa QEMU
sysinfo wypisuje sysinfo hypervisora
uri wypisuje kanoniczny identyfikator URI hypervisora

Aby wyświetlić szczegółowe informacje o konkretnym poleceniu, jako opcję podaj jego nazwę
zamiast. Na przykład:

virsh # lista pomocy
IMIĘ
lista - lista domen

STRESZCZENIE
lista [--nieaktywna] [--all]

OPIS
Zwraca listę domen.

OPCJE
--inactive wyświetla listę nieaktywnych domen
--all wyświetla listę nieaktywnych i aktywnych domen

porzucić, wyjście
opuść ten interaktywny terminal

wersja [--demon]
Wydrukuje informacje o wersji głównej dotyczące tego, z czego została zbudowana. Jeśli --demon is
określony, wówczas wersja demona libvirt zostanie uwzględniona w wynikach.

Przykład

Wersja $virsh
Skompilowano z biblioteką: libvirt 1.2.3
Korzystanie z biblioteki: libvirt 1.2.3
Korzystanie z API: QEMU 1.2.3
Uruchomiony hypervisor: QEMU 2.0.50

Wersja $ virsh --daemon
Skompilowano z biblioteką: libvirt 1.2.3
Korzystanie z biblioteki: libvirt 1.2.3
Korzystanie z API: QEMU 1.2.3
Uruchomiony hypervisor: QEMU 2.0.50
Uruchamianie przeciwko demonowi: 1.2.6

cd [katalog]
Zmieni bieżący katalog na katalog. Domyślny katalog dla cd komenda
jest katalogiem domowym lub, jeśli go nie ma GŁÓWNA zmienna w środowisku, korzeń
katalogiem.

To polecenie jest dostępne tylko w trybie interaktywnym.

Pwd Wydrukuje bieżący katalog.

connect [URI] [--tylko czytać]
(Ponownie) - Połącz się z hypervisorem. Kiedy powłoka jest uruchamiana po raz pierwszy, dzieje się to automatycznie
biegnij z URI parametr żądany przez opcję „-c” w wierszu poleceń. The URI
Parametr określa sposób połączenia z hypervisorem. Strona z dokumentacją pod adresem
<http://libvirt.org/uri.html> wypisz obsługiwane wartości, ale najczęstsze to:

xen:///
służy do łączenia się z lokalnym hiperwizorem Xen

qemu:///system
połącz się lokalnie jako root z demonem nadzorującym domeny QEMU i KVM

qemu:///sesja
połącz się lokalnie jako zwykły użytkownik z własnym zestawem domen QEMU i KVM

lxc:///
połącz się z lokalnym kontenerem systemu Linux

Aby znaleźć aktualnie używany URI, sprawdź Linki polecenie udokumentowane poniżej.

Aby uzyskać dostęp zdalny, zobacz stronę dokumentacji pod adresemhttp://libvirt.org/uri.html> o tym, jak
do tworzenia identyfikatorów URI. The --tylko czytać opcja pozwala na połączenie tylko do odczytu

Linki Drukuje kanoniczny URI hypervisora, może być przydatny w trybie powłoki.

hosta
Wydrukuj nazwę hosta hypervisora.

sysinfo
Wydrukuj reprezentację XML sysinfo hypervisora, jeśli jest dostępna.

Informacje o węźle
Zwraca podstawowe informacje o węźle, takie jak liczba i typ procesora oraz rozmiar pliku
Pamięć fizyczna. Dane wyjściowe odpowiadają strukturze virNodeInfo. Konkretnie,
Pole „Gniazda procesora” oznacza liczbę gniazd procesora na komórkę NUMA. Informacja
Wyświetlanie libvirt zależy od tego, co może zapewnić dana architektura.

mapa węzłów [--piękny]
Wyświetla całkowitą liczbę procesorów węzła, liczbę procesorów online i listę
procesory internetowe.

Wraz z --piękny procesory online są drukowane jako zakres, a nie lista.

nodecpustaty [cpu] [--procent]
Zwraca statystyki procesora węzła. Jeśli cpu zostanie określony, wydrukuje określony procesor
tylko statystyki. Jeśli --procent zostanie określony, spowoduje to wydrukowanie procentu każdego rodzaju
statystyk procesora w ciągu 1 sekundy.

statystyki węzłów [komórka]
Zwraca statystyki pamięci węzła. Jeśli komórka zostanie określony, spowoduje to wydrukowanie określonego
tylko statystyki komórek.

węzełzawieszenie [cel] [czas trwania]
Przełącza węzeł (komputer hosta) w ogólnosystemowy stan uśpienia i planuje działanie węzła
Przerwanie zegara czasu rzeczywistego, aby wznowić węzeł po upływie czasu określonego przez
czas trwania jest na zewnątrz. cel określa stan w jakim host zostanie zawieszony,
może to być „mem” (zawieszenie w pamięci RAM), „dysk” (zawieszenie na dysku) lub „hybrydowy” (zawieszenie w
zarówno RAM, jak i dysk). czas trwania określa czas w sekundach, przez który
host musi zostać zawieszony, powinno to trwać co najmniej 60 sekund.

dostrojenie pamięci węzła [shm-strony-do-skanowania] [shm-sleep-miliseks] [shm-łączenie-pomiędzy węzłami]
Umożliwia wyświetlenie lub ustawienie parametrów pamięci węzła. shm-strony-do-skanowania może być
służy do ustawiania liczby stron do zeskanowania przed przejściem do usługi pamięci współdzielonej
spać shm-sleep-miliseks można użyć do ustawienia liczby milisekund współdzielenia
usługa pamięci powinna spać przed następnym skanowaniem; shm-łączenie-pomiędzy węzłami określa, czy
strony z różnych węzłów numa można łączyć. Po ustawieniu na 0, tylko strony, które
fizycznie znajdują się w obszarze pamięci tego samego węzła NUMA, można je połączyć. Po ustawieniu na 1,
strony ze wszystkich węzłów można łączyć. Domyślnie 1.

Note: Obecnie „usługa pamięci współdzielonej” oznacza tylko KSM (łączenie jądra Samepage).

możliwości
Wydrukuj dokument XML opisujący możliwości hypervisora, na którym aktualnie się znajdujemy
połączony z. Obejmuje to sekcję dotyczącą możliwości hosta pod względem procesora i
funkcje oraz zestaw opisów dla każdego rodzaju gościa, który można zwirtualizować.
Pełniejszy opis można znaleźć w artykule:
<http://libvirt.org/formatcaps.html> Plik XML pokazuje także informacje o topologii NUMA
Jeśli możliwe.

możliwości domu [typ wirtualny] [emulator bin] [łuk] [maszyna]
Wydrukuj dokument XML opisujący możliwości domeny dla hypervisora, którym jesteśmy
związane z wykorzystaniem informacji pochodzących z istniejącej domeny lub z niej zaczerpniętych
dotychczasowy Virsh możliwości wyjście. Może to być przydatne, jeśli zamierzasz utworzyć nową domenę
i są ciekawi, czy mógłby na przykład skorzystać z VFIO, tworząc domenę dla
hypervisor z określonym emulatorem i architekturą.

Każdy hiperwizor będzie miał inne wymagania dotyczące wymaganych opcji
i które są opcjonalne. Hiperwizor może obsługiwać dostarczanie wartości domyślnej dla dowolnego z nich
opcje.

typ wirtualny opcja określa używany typ wirtualizacji. Wartość, której należy użyć, to
albo z atrybutu „type” elementu najwyższego poziomu z domeny
XML lub atrybut „type” znajdujący się w każdym elemencie z pliku Virsh
możliwości wyjście. ten emulator bin opcja określa ścieżkę do emulatora. The
wartością, która ma zostać użyta, jest element w domenie XML lub Virsh
możliwości wyjście. ten łuk Opcja określa architekturę, która ma być używana dla
domena. Wartością, którą należy zastosować, jest atrybut „arch” z kodu XML domeny
Element i element podrzędny lub atrybut „name” elementu
z Virsh możliwości wyjście. ten maszyna określa typ maszyny dla
emulator. Wartością, którą należy zastosować, jest atrybut „machine” z pliku XML domeny
Element i podelement lub jeden z listy maszyn z pliku Virsh
możliwości dane wyjściowe dla określonej architektury i typu domeny.

W przypadku hiperwizora qemu: a typ wirtualny Należy podać „qemu” lub „kvm”.
z emulator bin or łuk w celu wygenerowania danych wyjściowych dla wartości domyślnych
maszyna. Dostarczanie A maszyna wartość wygeneruje dane wyjściowe dla konkretnej maszyny.

wstrzyknij-nmi domena
Wstrzyknij NMI gościowi.

podstęp [--nieaktywny | --wszystko] [--zarządzane-zapisywanie] [--tytuł] { [--Tabela] | --Nazwa | --uid }
[--uporczywy] [--przejściowy] [--z-zarządzanym-zapisywaniem] [--bez zarządzanego-zapisu] [--automatyczny start]
[--brak autostartu] [--z-migawką] [--bez-migawki] [--działanie państwowe] [--stan-wstrzymany]
[--wyłączenie stanu] [--stan-inny]
Drukuje informacje o istniejących domenach. Jeśli nie określono żadnych opcji, zostanie wydrukowana
informacje o prowadzeniu domen.

Przykładowy format listy jest następujący:

Virsh podstęp
Identyfikator Nazwa Stan
-------------------------------------------------- -
0 Domena-0 działa
2 Fedora wstrzymana

Nazwa to nazwa domeny. ID numeryczny identyfikator domeny. Stan to stan uruchomienia
(Patrz niżej).

PAŃSTWA

Pole Stan zawiera listę 8 stanów domeny oraz informacje, w których znajduje się bieżąca domena.

bieganie
Domena aktualnie działa na procesorze

bezczynny
Domena jest bezczynna i nie działa lub nie można jej uruchomić. Może to być spowodowane tym, że
domena czeka na IO (tradycyjny stan oczekiwania) lub poszła spać, ponieważ
nie było nic innego do roboty.

Wstrzymany
Domena została wstrzymana, zwykle przez uruchomionego administratora
Virsh zawieszać. W stanie wstrzymania domena nadal będzie zużywać przydzielone zasoby
zasoby, takie jak pamięć, ale nie będą kwalifikować się do planowania przez hiperwizora.

zamknięcie
Domena jest w trakcie zamykania, tzn. system operacyjny gościa tak
został powiadomiony i powinien być w trakcie płynnego wstrzymywania swojej działalności.

zamknąć poza
Domena nie działa. Zwykle oznacza to, że domena została zamknięta
całkowicie lub nie został rozpoczęty.

rozbił się
Domena uległa awarii, co zawsze oznacza brutalne zakończenie. Zwykle ten stan może:
występują tylko wtedy, gdy domena została skonfigurowana tak, aby nie uruchamiała się ponownie po awarii.

umierający
Domena jest w trakcie umierania, ale nie została całkowicie zamknięta ani nie uległa awarii.

zawieszone
Domena została zawieszona przez zarządzanie energią gości, np. wszedł do s3
stan.

Zwykle na liście wyświetlane są tylko aktywne domeny. Aby wyświetlić listę nieaktywnych domen, określ --nieaktywny
or --wszystko aby wyświetlić listę domen aktywnych i nieaktywnych.

Aby dodatkowo filtrować listę domen, możesz określić jedną lub więcej flag filtrujących
popierany przez podstęp Komenda. Flagi te są pogrupowane według funkcji. Określenie jednego lub
więcej flag z grupy włącza grupę filtrów. Należy pamiętać, że niektóre kombinacje flag
może nie dać żadnych rezultatów. Obsługiwane flagi i grupy filtrowania:

Uporczywość
Flaga --uporczywy służy do uwzględniania trwałych domen na zwracanej liście. Do
uwzględnij domeny przejściowe określ --przejściowy.

Istnienie of zarządzane zapisać obraz
Aby wyświetlić listę domen posiadających zarządzany obraz zapisu, określ flagę --z-zarządzanym-zapisywaniem. Forum
domeny, które nie mają określonego zarządzanego obrazu zapisu --bez zarządzanego-zapisu.

Domena były
Następujące flagi filtrujące wybierają domenę według jej stanu: --działanie państwowe dla
prowadzenie domen, --stan-wstrzymany dla wstrzymanych domen, --wyłączenie stanu dla obróconych
poza domenami i --stan-inny dla wszystkich pozostałych stanów jako rozwiązanie awaryjne.

Autostart domeny
Aby wyświetlić listę domen uruchamiających się automatycznie, użyj flagi --automatyczny start. Aby wyświetlić listę domen z tym
funkcja niedostępna --brak autostartu.

Migawka istnienie
Domeny zawierające obrazy migawkowe można wyświetlać za pomocą flagi --z-migawką,
domeny bez migawki --bez-migawki.

Podczas rozmowy ze starszymi serwerami polecenie to jest zmuszone do użycia serii wywołań API
z wrodzoną rasą, gdzie domena może nie być wymieniona lub może pojawić się w większej liczbie
raz, jeśli zmienił stan pomiędzy wywołaniami podczas zbierania listy. Nowsza
serwery nie mają tego problemu.

If --zarządzane-zapisywanie zostanie określony, wówczas domeny, które zarządzały stanem zapisu (tylko
możliwe, jeśli są w zamknąć poza stan, więc musisz to określić --nieaktywny or --wszystko
aby je wyświetlić) zamiast tego będą wyświetlane jako zapisywane w zestawieniu. Ta flaga jest użyteczna
tylko z domyślnym --Tabela wyjście. Należy pamiętać, że ta flaga nie filtruje listy
domeny.

If --Nazwa zostanie określony, nazwy domen zostaną wydrukowane zamiast nazw w formacie tabeli
Za linię. Jeśli --uid jest określone, zamiast nazw drukowane są identyfikatory UUID domeny. Flaga
--Tabela określa, że ​​należy użyć starszego wyniku w formacie tabeli. To jest
domyślny. Wszystko to wzajemnie się wyklucza.

If --tytuł zostanie określony, wówczas krótki opis domeny (tytuł) zostanie wydrukowany w pliku
dodatkowa kolumna. Tej flagi można używać tylko z flagą domyślną --Tabela wyjście.

Przykład:

Virsh lista --tytuł
Identyfikator Stan Tytuł
-------------------------------------------------- ------------------------
0 Domena-0 z uruchomionym serwerem pocztowym 1
2 Fedora wstrzymana

Freecell [{ [--nr komórki] nr komórki | --wszystko }]
Drukuje dostępną ilość pamięci na komputerze lub w komórce NUMA. The
Polecenie freecell może zapewnić jeden z trzech różnych sposobów wyświetlania dostępnej pamięci
maszynę w zależności od określonych opcji. Bez opcji wyświetla
całkowita wolna pamięć na komputerze. Opcja --all wyświetla wolną pamięć
w każdej komórce i całkowitą wolną pamięć na komputerze. Na koniec numer
argumentem lub --cellno plus numer komórki wyświetli wolną pamięć dla
tylko określona komórka.

darmowe strony [{ [--nr komórki] nr komórki [--rozmiar strony] rozmiar strony | --wszystko }]
Drukuje dostępną liczbę stron w komórce NUMA. nr komórki odnosi się do NUMA
komórka, która Cię interesuje. rozmiar strony jest skalowaną liczbą całkowitą (patrz UWAGI powyżej).
Alternatywnie, jeśli --wszystko jest używany, informacje o każdej możliwej kombinacji komórki NUMA i
zostanie wydrukowany rozmiar strony.

przydziały [--rozmiar strony] rozmiar strony [--Liczba stron] Liczba stron [[--nr komórki] nr komórki] [--Dodaj]
[--wszystko]
Zmień rozmiar puli stron rozmiar strony na gospodarzu. Jeśli --Dodaj jest określony, to
Liczba stron strony są dodawane do puli. Jeśli jednak --Dodaj nie zostało określone, wówczas
Liczba stron jest przyjmowany jako nowy bezwzględny rozmiar puli (można go wykorzystać do uwolnienia części
stron i zmniejsz rozmiar puli). The nr komórki modyfikatora można użyć do zawężenia
modyfikacja do pojedynczej komórki hosta NUMA. Na drugim końcu spektrum leży --wszystko
który wykonuje modyfikację na wszystkich komórkach NUMA.

poziom bazowy procesora FILE [--cechy] [--migrowalne]
Oblicz bazowy procesor, który będzie obsługiwany przez wszystkie procesory hosta podane w . The
lista procesorów hosta jest tworzona poprzez wyodrębnienie wszystkich elementów z . Więc
może zawierać albo zestaw elementów oddzielonych nowymi liniami, albo nawet zestaw
kompletnych elementów wydrukowanych przez możliwości Komenda. Gdyby --cechy is
określony, wynikowy opis XML będzie wyraźnie zawierał wszystkie funkcje, które
składają się na procesor, bez tej opcji funkcje będące częścią modelu procesora nie będą dostępne
być wymienione w opisie XML. Jeśli --migrowalne jest określony, funkcje, które blokują
migracja nie zostanie uwzględniona w wynikowym procesorze.

porównanie procesora FILE [--błąd]
Porównaj definicję procesora z pliku XML z procesorem hosta. może zawierać
albo definicja procesora hosta, albo gościa. Definicja procesora hosta to element i
jego zawartość wydrukowana przez możliwości Komenda. Definicja procesora gościa to
element i jego zawartość z definicji domeny XML. Aby uzyskać więcej informacji na temat procesora gościa
definicja patrz: <http://libvirt.org/formatdomain.html#elementyCPU>. Jeśli --błąd is
określony, polecenie zwróci błąd, jeśli dany procesor jest niekompatybilny z
CPU hosta i pojawi się komunikat zawierający więcej szczegółów na temat niezgodności
wydrukowane.

modele procesorów łuk
Wydrukuj listę modeli procesorów znanych dla określonej architektury.

przegapić [--powłoka] [--xml] [arg...]
Powtórz każde z nich arg, oddzielone spacją. Jeśli --powłoka zostanie określony, wówczas wynik będzie
tam, gdzie to konieczne, należy umieścić go w pojedynczym cudzysłowie, aby nadawał się do ponownego użycia w kontekście powłoki.
If --xml zostanie określony, wówczas dane wyjściowe zostaną wykorzystane w formacie XML.

DOMAIN POLECENIA

Poniższe polecenia bezpośrednio manipulują domenami, jak wspomniano wcześniej w przypadku większości poleceń
weź domenę jako pierwszy parametr. The domena można określić jako krótką liczbę całkowitą, nazwę
lub pełny identyfikator UUID.

autostart [--wyłączyć] domena
Skonfiguruj domenę tak, aby była automatycznie uruchamiana podczas rozruchu.

Opcja --wyłączyć wyłącza autostart.

konsola domena [nazwa dewelopera] [--bezpieczna] [--siła]
Podłącz wirtualną konsolę szeregową dla gościa. Opcjonalne nazwa dewelopera parametr
odnosi się do aliasu urządzenia alternatywnej konsoli, urządzenia szeregowego lub równoległego
skonfigurowany dla gościa. Jeśli zostanie pominięty, konsola podstawowa zostanie otwarta.

Jeśli flaga --bezpieczna zostanie określony, próba połączenia będzie podejmowana tylko w przypadku sterownika
wspiera bezpieczną obsługę konsoli. Ta flaga określa, że ​​serwer musi to zapewnić
wyłączny dostęp do urządzeń konsolowych. Opcjonalnie --siła można określić flagę,
żądanie rozłączenia wszelkich istniejących sesji, np. w przypadku zerwania
połączenia.

Stwórz FILE [--konsola] [--pauza] [--samozniszczenie] [--pass-fds N, M,...]
Utwórz domenę z XML. Łatwym sposobem na utworzenie XML jest użycie
zrzutxml polecenie uzyskania definicji istniejącego gościa. Domena będzie
wstrzymane, jeśli --pauza opcja jest używana i obsługiwana przez sterownik; inaczej tak się stanie
biegać. Jeśli --konsola zostanie wyświetlony monit, dołącz do konsoli po utworzeniu. Jeśli
--samozniszczenie zostanie o to poproszony, gość zostanie automatycznie zniszczony, gdy zostanie virsh
zamyka połączenie z libvirt lub w inny sposób kończy działanie.

If --pass-fds jest określony, argumentem jest lista otwartych plików rozdzielonych przecinkami
deskryptory, które należy przekazać gościowi. Deskryptory plików zostaną ponownie
numerowane w gościu, zaczynając od 3. Jest to obsługiwane tylko w przypadku kontenerów
wirtualizacja.

Przykład

virsh dumpxml > domena.xml
vi domain.xml (lub dokonaj zmian w innym edytorze tekstu)
virsh utwórz domenę.xml

określić FILE
Zdefiniuj domenę na podstawie XML. Definicja domeny jest zarejestrowana, ale nie
Rozpoczęty. Jeśli domena jest już uruchomiona, zmiany zaczną obowiązywać przy następnym uruchomieniu.

desc domena [[--na żywo] [--konfig] | [--obecny]] [--tytuł] [--edytować] [--nowy-opis Nowości
opis lub wiadomość tytułowa]
Pokaż lub zmodyfikuj opis i tytuł domeny. Te wartości to pola użytkownika, które
pozwalają na przechowywanie dowolnych danych tekstowych w celu umożliwienia łatwej identyfikacji domen. Tytuł
powinien być krótki, chociaż nie jest to egzekwowane. (Zobacz też metadanych który działa z XML
oparte na metadanych domeny.)

Flagi --na żywo or --konfig wybierz, czy to polecenie działa na żywo, czy na stałe
definicje domeny. Jeśli oba --na żywo oraz --konfig są określone, --konfig
opcja ma pierwszeństwo przed uzyskaniem bieżącego opisu i obu konfiguracji na żywo
i config są aktualizowane podczas ustawiania opisu. --obecny jest ekskluzywny i
dorozumiane, jeśli żaden z nich nie został określony.

Flaga --edytować określa, że ​​edytor z zawartością bieżącego opisu lub tytułu
należy otworzyć, a następnie zapisać zawartość.

Flaga --tytuł wybiera operację na polu tytułu zamiast opisu.

Jeśli żadne z --edytować oraz --nowy-opis są określone, wyświetlana jest uwaga lub opis
zamiast być modyfikowany.

zniszczyć domena [--wdzięczny]
Natychmiast zakończ domenę domena. Nie daje to żadnej szansy systemowi operacyjnemu domeny
zareagować i jest to równoznaczne z wyrwaniem przewodu zasilającego na fizycznej maszynie.
W większości przypadków będziesz chciał użyć zamknięcie zamiast tego polecenie. Jednak tak się dzieje
nie usuwaj żadnych woluminów pamięci używanych przez gościa, a jeśli domena jest trwała, to
można uruchomić ponownie później.

If domena jest przejściowy, wówczas metadane wszelkich migawek zostaną utracone po wejściu gościa
przestaje działać, ale zawartość migawki nadal istnieje i nowa domena z nią
name i UUID mogą przywrócić metadane migawki tworzenie migawki.

If --wdzięczny jest określony, nie uciekaj się do ekstremalnych środków (np. SIGKILL), gdy
gość nie zatrzymuje się po rozsądnym czasie; zamiast tego zwróć błąd.

domblstat domena [urządzenie blokowe] [--człowiek]
Uzyskaj statystyki bloków urządzeń dla działającej domeny. A urządzenie blokowe odpowiada unikatowi
nazwa docelowa () lub plik źródłowy () dla jednego z
podłączone urządzenia dyskowe domena (Zobacz też lista domblk za wypisanie tych nazwisk). NA
domenę lxc lub qemu, pomijając urządzenie blokowe wyświetla podsumowanie statystyk bloków urządzeń
dla całej domeny.

Zastosowanie --człowiek aby uzyskać bardziej czytelny dla człowieka wynik.

Dostępność tych pól zależy od hypervisora. Brakuje nieobsługiwanych pól
z wyjścia. W przypadku komunikacji z nowszą wersją programu mogą pojawić się inne pola
libvirtd.

Wyjaśnienie of Pola (pola pojawiają się w następującej kolejności):
rd_req - liczba operacji odczytu
rd_bytes - liczba przeczytanych bajtów
wr_req - liczba operacji zapisu
wr_bytes - liczba zapisanych bajtów
errs – liczba błędów
Flush_ Operations - liczba operacji opróżniania
rd_total_times — całkowity czas operacji odczytu (ns)
wr_total_times — całkowity czas trwania operacji zapisu (ns)
Flush_total_times — całkowity czas trwania operacji spłukiwania (ns)


domifaddr domena [Interfejs] [--pełny] [--źródło agent|dzierżawy]
Uzyskaj listę interfejsów działającej domeny wraz z ich adresami IP i MAC, lub
ograniczone wyjście tylko dla jednego interfejsu if Interfejs jest specyficzne. Zauważ to Interfejs
może zależeć od sterownika, może to być nazwa w systemie-gościu lub nazwa, którą zobaczysz
w domenie XML. Co więcej, całe polecenie może wymagać skonfigurowania agenta-gościa
dla badanej domeny w niektórych sterownikach, zwłaszcza qemu. Jeśli --pełny jest określony,
nazwa interfejsu jest zawsze wyświetlana, gdy interfejs ma wiele adresów lub aliasów,
w przeciwnym razie wyświetla tylko nazwę interfejsu dla pierwszego adresu i „-” dla
inni. ten --źródło argument określa jakiego źródła danych użyć dla adresów,
obecnie jedna z opcji „dzierżawa” do odczytywania dzierżaw DHCP lub „agent” do wysyłania zapytań do systemu gościa za pośrednictwem pliku
agent. Jeśli nie określono, ustawieniem domyślnym jest „dzierżawa”.

domofstat domena urządzenie-interfejs
Uzyskaj statystyki interfejsu sieciowego dla działającej domeny.

domif-setlink domena urządzenie-interfejs były [--konfig]
Zmodyfikuj stan łącza wirtualnego interfejsu domeny. Możliwe wartości stanu to
"w górę i w dół". Jeśli --konfig jest określona, ​​tylko trwała konfiguracja pliku
domena została zmodyfikowana ze względu na kompatybilność, --uporczywy jest pseudonimem --konfig.
urządzenie-interfejs może być docelową nazwą interfejsu lub adresem MAC.

domif-getlink domena urządzenie-interfejs [--konfig]
Zapytanie o stan łącza wirtualnego interfejsu domeny. Jeśli --konfig jest określone, zapytanie
konfiguracja trwała, ze względu na kompatybilność, --uporczywy jest pseudonimem
--konfig.

urządzenie-interfejs może być docelową nazwą interfejsu lub adresem MAC.

domiftune domena urządzenie-interfejs [[--konfig] [--na żywo] | [--obecny]] [--przychodzące
średnia, szczyt, impuls, dolny poziom] [--wychodzące średnia, szczyt, wybuch]
Ustaw lub zapytaj o parametry przepustowości interfejsu sieciowego domeny. urządzenie-interfejs
może być docelową nazwą interfejsu () lub adresem MAC.

Jeśli nie --przychodzące or --wychodzące zostanie określony, to polecenie wykona zapytanie i wyświetli plik
ustawienia przepustowości. W przeciwnym razie ustawi przepustowość przychodzącą lub wychodzącą.
średnia, szczyt, impuls, dolny poziom jest taki sam jak w poleceniu interfejs dołączania. Wartości dla
średni, szczyt oraz piętro wyrażane są w kilobajtach na sekundę, natomiast wybuch is
wyrażone w kilobajtach w pojedynczej serii o godz szczyt prędkość zgodnie z opisem w pliku XML sieci
dokumentacja pod adresem <http://libvirt.org/formatnetwork.html#elementQoS>.

Aby wyczyścić ustawienia połączeń przychodzących lub wychodzących, użyj --przychodzące or --wychodzące z szacunkiem
średnia wartość zerowa.

If --na żywo jest określony, wpływają na działającego gościa. Jeśli --konfig jest określony, wpływa na
następny rozruch stałego gościa. Jeśli --obecny jest określony, wpływają na bieżącego gościa
państwo. Obydwa --na żywo oraz --konfig można rozdawać flagi, ale --obecny jest ekskluzywny. Jeśli nie
flaga jest określona, ​​zachowanie jest różne w zależności od hypervisora.

Dommemstat domena [--Kropka sekund] [[--konfig] [--na żywo] | [--obecny]]
Uzyskaj statystyki pamięci dla działającej domeny.

W zależności od hypervisora ​​można zwrócić różne statystyki

W przypadku QEMU/KVM z balonem pamięci ustawienie opcjonalne --Kropka do wartości większej
niż 0 w sekundach pozwoli kierowcy balonu zwrócić dodatkowe statystyki, które
będą wyświetlane przez kolejne Dommemstat polecenia. Ustawianie --Kropka do 0 woli
zatrzymuje zbieranie sterowników dymków, ale nie czyści statystyk w dymku
kierowca. Wymaga uruchomienia na hoście co najmniej QEMU/KVM 1.5.

--na żywo, --konfig, --obecny flagi są ważne tylko przy użyciu --Kropka
opcję w celu ustalenia okresu odbioru dla kierowcy balonu. Jeśli --na żywo is
określony, ma to wpływ tylko na bieżący okres zbierania gości. Jeśli --konfig is
określone, wpływają na następne uruchomienie stałego gościa. Jeśli --obecny jest specyficzne,
wpływać na bieżący stan gościa.

Obie --na żywo oraz --konfig można rozdawać flagi, ale --obecny jest ekskluzywny. Jeśli nie ma flagi
określony, zachowanie różni się w zależności od stanu gościa.

błąd domblkowy domena
Pokaż błędy na urządzeniach blokowych. To polecenie zwykle przydaje się, gdy stan domowy komenda
mówi, że domena została wstrzymana z powodu błędu we/wy. The błąd domblkowy polecenie wyświetla wszystkie
blokuj urządzenia w stanie błędu i błąd widoczny na każdym z nich.

Informacje o domu domena urządzenie blokowe
Uzyskaj informacje o rozmiarze urządzenia blokowego dla domeny. A urządzenie blokowe odpowiada unikatowi
nazwa docelowa () lub plik źródłowy () dla jednego z
podłączone urządzenia dyskowe domena (Zobacz też lista domblk za wypisanie tych nazwisk).

lista domblk domena [--nieaktywny] [--Detale]
Wydrukuj tabelę zawierającą krótkie informacje o wszystkich powiązanych urządzeniach blokowych
domena. Jeśli --nieaktywny jest określony, zapytaj o urządzenia blokowe, które będą używane w
następnym uruchomieniu, a nie te aktualnie używane przez działającą domenę. Jeśli --Detale is
określony, typ dysku i wartość urządzenia również zostaną wydrukowane. Inne konteksty
wymagają nazwy urządzenia blokowego (np Informacje o domu or tworzenie migawki dla migawek dysków)
zaakceptuje docelowe lub unikalne nazwy źródłowe wydrukowane przez to polecenie.

domstats [--surowe] [--egzekwować] [--poparcie] [--stan] [--Cpu-całkowita] [--balon] [--vprocesor]
[--berło] [--blok] [[--lista-aktywna] [--lista-nieaktywna] [--lista-trwała]
[--lista-przejściowa] [--uruchamianie listy] [--lista-wstrzymana] [--lista-wyłączenie] [--lista-inne]] |
[domena ...]
Uzyskaj statystyki dla wielu lub wszystkich domen. Bez żadnego argumentu to polecenie wypisuje
wszystkie dostępne statystyki dla wszystkich domen.

Listę domen, dla których zbierane są statystyki, można ograniczyć, umieszczając listę domen
jako listę oddzieloną spacjami lub poprzez określenie jednej z flag filtrujących --lista-*. (The
podejść nie można łączyć.)

Domyślnie niektóre zwrócone pola mogą zostać przekonwertowane na wartości bardziej przyjazne dla człowieka
przez zestaw ładnych drukarek. Aby stłumić to zachowanie, użyj opcji --surowe flag.

Poszczególne grupy statystyk można wybierać za pomocą określonych flag. Domyślnie wszystkie
zwracane są obsługiwane grupy statystyk. Obsługiwane flagi grup statystyk to:
--stan, --Cpu-całkowita, --balon, --vprocesor, --berło, --blok.

Podczas wyboru odpowiedniego serwisu --stan group zwracane są następujące pola: "state.state" -
stan maszyny wirtualnej, zwrócony jako liczba z wyliczenia virDomainState, „state.reason” – przyczyna
dla wejścia w dany stan, zwracany jako int z wyliczenia virDomain*Reason odpowiadającego
dany stan.

--Cpu-całkowita zwraca: "cpu.time" - całkowity czas procesora spędzony dla tej domeny w nanosekundach,
„cpu.user” – czas spędzony procesora użytkownika w nanosekundach, „cpu.system” – czas spędzony procesora systemowego
w nanosekundach

--balon zwraca: "balloon.current" - aktualnie używana pamięć w kiB,
"balloon.maximum" - maksymalna dozwolona pamięć w kiB

--vprocesor zwraca: „vcpu.current” - bieżąca liczba wirtualnych procesorów online, „vcpu.maximum”
- maksymalna liczba wirtualnych procesorów online, "vcpu..state" - stan wirtualnego procesora
, jako liczba z wyliczenia virVcpuState, "vcpu..time" - czas spędzony przez wirtualny procesor
wirtualny procesor

--berło zwraca: "net.count" - liczba interfejsów sieciowych w tej domenie,
"net..name" - nazwa interfejsu , "net..rx.bytes" - liczba bajtów
otrzymane, "net..rx.pkts" - liczba odebranych pakietów, "net..rx.errs" -
liczba błędów odbioru, "net..rx.drop" - liczba odrzuconych pakietów odebranych,
"net..tx.bytes" - liczba przesłanych bajtów, "net..tx.pkts" - liczba przesłanych bajtów
przesłanych pakietów, "net..tx.errs" - liczba błędów transmisji,
"net..tx.drop" - liczba odrzuconych pakietów transmisyjnych

--blok zwraca informacje o dyskach powiązanych z każdą domeną. Używając
--poparcie flag rozszerza tę informację na wszystkie zasoby w łańcuchu zapasowym,
zamiast domyślnego ograniczania informacji do aktywnej warstwy dla każdego gościa
dysk. Wyświetlane informacje obejmują: „block.count” – liczba znajdujących się urządzeń blokowych
na liście, "block..name" - nazwa celu urządzenia blokowego (to samo
nazwa dla wielu wpisów, jeśli --poparcie jest obecny), „block..backingIndex” – kiedy
--poparcie jest obecny, pasuje do indeksu wymienionego w pliku XML domeny
dla plików kopii zapasowych "block..path" - źródło pliku urządzenia blokowego , jeśli jest to
plik lokalny lub urządzenie blokowe, "block..rd.reqs" - liczba żądań odczytu,
"block..rd.bytes" - liczba odczytanych bajtów, "block..rd.times" - czas całkowity
(ns) wydane na odczyty, "block..wr.reqs" - liczba żądań zapisu,
"block..wr.bytes" - liczba zapisanych bajtów, "block..wr.times" - czas całkowity
(ns) wydane na zapisy, "block..fl.reqs" - suma żądań opróżnienia,
"block..fl.times" - całkowity czas (ns) spędzony na opróżnianiu pamięci podręcznej, "block..errors"
- Tylko Xen: wartość 'oo_req', "block..allocation" - przesunięcie najwyższego zapisanego
sektor w bajtach, "block..capacity" - rozmiar logiczny pliku źródłowego w bajtach,
"block..physical" - fizyczny rozmiar pliku źródłowego w bajtach

Wybranie konkretnej grupy statystyk nie gwarantuje, że demon będzie obsługiwał
wybrana grupa statystyk. Flaga --egzekwować wymusza niepowodzenie polecenia, jeśli demon
nie obsługuje wybranej grupy.

domiflista domena [--nieaktywny]
Wydrukuj tabelę zawierającą krótkie informacje o wszystkich powiązanych interfejsach wirtualnych
domena. Jeśli --nieaktywny jest określony, wykonaj zapytanie do interfejsów wirtualnych, które będą używane
następnym uruchomieniu, a nie te aktualnie używane przez działającą domenę. Inne konteksty
które wymagają adresu MAC interfejsu wirtualnego (np odłącz interfejs or domif-
ustaw łącze) zaakceptuje adres MAC wydrukowany przez to polecenie.

zatwierdzenie blokowe domena ścieżka [przepustowość] [baza] [--Płycizna] [Top] [--kasować] [--utrzymuj krewny]
[--czekać [--sync] [--gadatliwy]] [--koniec czasu sekund] [--aktywny] [{--sworzeń | --zachowaj nakładkę}]
Zmniejsz długość łańcucha obrazów podkładowych, zatwierdzając zmiany na górze
łańcuch (pliki migawkowe lub delta) w obrazy podkładowe. Domyślnie to polecenie
próbuje spłaszczyć cały łańcuch. Jeśli baza i / lub Top są określone jako pliki
w łańcuchu zapasowym, wówczas operacja jest ograniczona do zatwierdzenia właśnie tego
część łańcucha; --Płycizna można użyć zamiast baza aby określić natychmiast
plik zapasowy wynikowego górnego obrazu, który ma zostać zatwierdzony. Pliki są zatwierdzane
stają się nieważne, ewentualnie zaraz po rozpoczęciu operacji; używając --kasować
flag podejmie próbę usunięcia tych unieważnionych plików po pomyślnym zakończeniu
operację zatwierdzenia. Kiedy --utrzymuj krewny używana jest flaga, ścieżki plików zapasowych
zostaną zachowane względne.

Kiedy Top jest pominięty lub określony jako obraz aktywny, można to również określić
--aktywny aby wyzwolić dwufazowe aktywne zatwierdzenie. W pierwszej fazie Top jest kopiowany do
baza a zadanie można anulować tylko wtedy, gdy góra nadal zawiera dane, które nie znajdują się jeszcze w bazie.
W drugiej fazie Top oraz baza pozostają takie same, aż do wywołania blokada z
--anulować flaga (utrzymując górę jako aktywny obraz, który śledzi zmiany od tego momentu
czas) lub --sworzeń flaga (utworzenie podstawy nowego aktywnego obrazu i unieważnienie góry).

Domyślnie to polecenie powraca tak szybko, jak to możliwe, a dane dla całego dysku są
popełnione w tle; można sprawdzić postęp operacji
blokada. Jeśli jednak --czekać zostanie określony, wówczas to polecenie będzie blokować do momentu
operacja została zakończona (lub dla --aktywny, wchodzi w drugą fazę) lub do czasu operacji
zostaje anulowane, ponieważ jest opcjonalne Timeout w sekundach lub zostaje wysłany SIGINT (zwykle
z „Ctrl-C”). Za pomocą --gadatliwy oraz --czekać spowoduje stan okresowy
aktualizacje. Jeśli zostanie wywołane anulowanie zadania, --sync zwróci kontrolę użytkownikowi jako
tak szybko, jak to możliwe, w przeciwnym razie polecenie może blokować się trochę dłużej
dopóki nie zakończy się sprzątanie. Za pomocą --sworzeń jest skrótem od łączenia --aktywny
--czekać z automatycznym blokada --sworzeń; i używanie --zachowaj nakładkę jest skrótem od
łączenie --aktywny --czekać z automatycznym blokada --anulować.

ścieżka określa w pełni kwalifikowaną ścieżkę dysku; odpowiada unikalnemu celowi
nazwa () lub plik źródłowy () dla jednego z dysków
podłączone urządzenia domena (Zobacz też lista domblk za wypisanie tych nazwisk). przepustowość
określa limit przepustowości kopiowania w MiB/s, chociaż dla qemu może on być niezerowy
dla domeny internetowej. Określenie wartości ujemnej jest interpretowane jako wartość długa bez znaku
długa wartość lub zasadniczo nieograniczona. Hiperwizor może zdecydować, czy odrzucić plik
wartość lub przekonwertuj ją na maksymalną dozwoloną wartość.

kopia blokowa domena ścieżka { przeznaczenie [format] [--blockdev] | --xml filet } [--Płycizna]
[--reuse-external] [przepustowość] [--czekać [--sync] [--gadatliwy]] [{--sworzeń | --koniec}]
[--koniec czasu sekund] [ziarnistość] [rozmiar buf]
Skopiuj łańcuch obrazu kopii zapasowej dysku do miejsca docelowego. Albo przeznaczenie jako plik docelowy
imię, lub --xml z nazwą pliku XML zawierającego element najwyższego poziomu
opisujący cel podróży, musi być obecny. Dodatkowo jeśli przeznaczenie jest podawany, format
należy określić, aby zadeklarować format miejsca docelowego (jeśli format jest pominięty,
wtedy libvirt ponownie użyje formatu źródła lub with --reuse-external będzie
zmuszony do sprawdzenia formatu docelowego, co może stanowić potencjalną lukę w zabezpieczeniach).
Polecenie obsługuje --surowe jako synonim flagi logicznej --format=surowy. Podczas używania
przeznaczenie, miejsce docelowe jest traktowane jak zwykły plik, chyba że --blockdev służy do sygnalizacji
że jest to urządzenie blokowe. Domyślnie to polecenie spłaszcza cały łańcuch; ale jeśli
--Płycizna jest określony, kopia dzieli łańcuch zapasowy.

If --reuse-external zostanie określony, wówczas miejsce docelowe musi istnieć i mieć wystarczającą liczbę
miejsce na kopię. Jeśli --Płycizna jest używany w połączeniu z --reuse-external następnie
wstępnie utworzony obraz musi mieć zawartość widoczną dla gości, identyczną z widoczną dla gości
zawartość pliku kopii zapasowej oryginalnego obrazu. Można to wykorzystać do modyfikacji pliku
tworzenie kopii zapasowych nazw plików w miejscu docelowym.

Domyślnie zadanie kopiowania działa w tle i składa się z dwóch faz.
Początkowo zadanie musi skopiować wszystkie dane ze źródła, a w tej fazie zadanie
można anulować jedynie w celu przywrócenia dysku źródłowego, bez żadnych gwarancji
miejsce docelowe. Po zakończeniu tej fazy pozostaje zarówno źródło, jak i miejsce docelowe
dublowane do momentu wywołania blokada z --anulować oraz --sworzeń flagi obracają się do
kopię lub połączenie bez --sworzeń pozostawia miejsce docelowe jako jego wierną kopię
punkt w czasie. Jeśli jednak --czekać zostanie określony, to polecenie będzie blokować do
rozpoczyna się faza tworzenia kopii lustrzanej lub anuluj operację, jeśli jest to opcjonalne Timeout w sekundy
upłynie lub zostanie wysłany SIGINT (zwykle z „Ctrl-C”). Za pomocą --gadatliwy oraz --czekać
będzie generować okresowe aktualizacje statusu. Za pomocą --sworzeń (podobny do blokada --sworzeń) lub
--koniec (podobny do blokada --anulować) implikuje --czekać, i dodatkowo zakończy
należy wykonywać swoją pracę czysto, zamiast pozostawiać sprawy w fazie odzwierciedlania. Jeśli anulowanie pracy jest
wyzwalane przez przekroczenie limitu czasu lub przez --koniec, --sync równie szybko zwróci kontrolę użytkownikowi
jak to możliwe, w przeciwnym razie polecenie może blokować jeszcze przez chwilę, aż do
praca została faktycznie anulowana.

ścieżka określa w pełni kwalifikowaną ścieżkę dysku. przepustowość określa kopiowanie
limit przepustowości w MiB/s. Określenie wartości ujemnej jest interpretowane jako znak bez znaku
long long wartość, która może być zasadniczo nieograniczona, ale bardziej prawdopodobne jest jej przepełnienie;
bezpieczniej jest użyć w tym celu wartości 0. Określanie ziarnistość pozwala na precyzyjne dostrojenie
szczegółowość, która zostanie skopiowana po wykryciu brudnego obszaru; większe wartości
wyzwala mniej narzutów we/wy, ale może zakończyć się kopiowaniem większej ilości danych (wartość domyślna
jest zazwyczaj poprawny); hiperwizorzy mogą ograniczyć to do potęgi dwójki lub mieścić się w tym zakresie
pewien zakres. Określanie rozmiar buf będzie kontrolować, ile danych może być jednocześnie
w locie podczas kopiowania; większe wartości wymagają więcej pamięci, ale mogą pozwolić na szybsze
zakończenie (wartość domyślna jest zwykle poprawna).

blokowanie domena ścieżka [przepustowość] [baza] [--czekać [--gadatliwy] [--koniec czasu sekund]
[--sync]] [--utrzymuj krewny]
Zapełnij dysk z łańcucha obrazów podkładowych. Domyślnie to polecenie spłaszcza plik
cały łańcuch; ale jeśli baza jest określony i zawiera nazwę jednego z podkładów
plików w łańcuchu, wówczas plik ten stanie się nowym plikiem zapasowym i tylko plikiem
zostanie pociągnięta środkowa część łańcucha. Gdy wszyscy zażądali danych z kopii zapasowej
łańcuch obrazów został rozciągnięty, dysk nie jest już zależny od tej części podkładu
łańcuch.

Domyślnie to polecenie powraca tak szybko, jak to możliwe, a dane dla całego dysku są
wciągnięty w tło; można sprawdzić postęp operacji blokada.
Jeśli jednak --czekać zostanie określony, to polecenie zostanie zablokowane do czasu wykonania operacji
zakończy się lub anuluje operację, jeśli jest to opcjonalne Timeout w sekundach lub
Wysyłany jest SIGINT (zwykle z „Ctrl-C”). Za pomocą --gadatliwy oraz --czekać będzie
tworzyć okresowe aktualizacje statusu. Jeśli zostanie wywołane anulowanie zadania, --sync będzie
przywróć kontrolę użytkownikowi tak szybko, jak to możliwe, w przeciwnym razie polecenie może być kontynuowane
zablokuj jeszcze chwilę, aż sprzątanie zostanie zakończone.

Korzystanie z --utrzymuj krewny flaga sprawi, że nazwy łańcuchów zapasowych będą względne.

ścieżka określa w pełni kwalifikowaną ścieżkę dysku; odpowiada unikalnemu celowi
nazwa () lub plik źródłowy () dla jednego z dysków
podłączone urządzenia domena (Zobacz też lista domblk za wypisanie tych nazwisk). przepustowość
określa limit przepustowości kopiowania w MiB/s. Podanie wartości ujemnej jest interpretowane
jako wartość unsigned long long lub zasadniczo nieograniczona. Hiperwizor może wybrać
czy odrzucić wartość, czy przekonwertować ją na maksymalną dozwoloną wartość.

blkdeviotune domena urządzenie [[--konfig] [--na żywo] | [--obecny]] [[całkowita liczba bajtów-sek] | [czytać-
bajty-sek] [zapisu-bajtów-sek]] [[całkowita liczba iops-sek] | [odczyt-iops-sek] [zapis-iops-sek]]
[[całkowita liczba bajtów-s-maks] | [odczyt-bajtów-s-max] [zapis-bajtów-sek-max]] [[całkowita liczba iops-s-maks]
| [odczyt-iops-sec-max] [zapis-iops-sec-max]] [rozmiar-iops-sek]
Ustaw lub zapytaj parametry io dysku blokowego dla urządzenia blokowego domena. urządzenie
określa unikalną nazwę docelową () lub plik źródłowy (<source
file='name'/>) dla jednego z podłączonych urządzeń dyskowych domena (Zobacz też lista domblk dla
wymieniając te nazwiska).

Jeśli nie określono żadnego limitu, zostanie sprawdzone ustawienie bieżących limitów we/wy. W przeciwnym razie zmień
limity z tymi flagami: --total-bytes-sek określa całkowity limit przepustowości w
bajtów na sekundę. --czytaj-bajty-sek określa limit przepustowości odczytu w bajtach na
druga. --zapis-bajtów-sek określa limit przepustowości zapisu w bajtach na sekundę.
--całkowita liczba iops-sek określa całkowity limit operacji we/wy na sekundę. --czytaj-iops-sek
określa limit operacji we/wy odczytu na sekundę. --write-ioops-sec określa zapis we/wy
limit operacji na sekundę. --total-bytes-sec-max określa maksymalną całkowitą przepustowość
limit w bajtach na sekundę. --odczyt bajtów-sekund-maks określa maksymalną przepustowość odczytu
limit w bajtach na sekundę. --zapisz-bajty-sek-max określa maksymalną przepustowość zapisu
limit w bajtach na sekundę. --total-iops-s-max określa maksymalną całkowitą liczbę wejść/wyjść
limit operacji na sekundę. --read-iops-sec-max określa maksymalną liczbę we/wy odczytu
limit operacji na sekundę. --write-ioops-sec-max określa maksymalną liczbę operacji we/wy zapisu
limit operacji na sekundę. --rozmiar-iops-sek określa rozmiar Limit operacji we/wy na
druga.

Starsze wersje virsha akceptowały te opcje tylko z podkreśleniem zamiast myślnika,
jak w --total_bytes_sec.

Wartości bajtów i operacji iops są niezależne, ale ustawienie tylko jednej wartości (np
--read-bytes-sec) resetuje pozostałe dwa w tej kategorii do wartości nieograniczonej. Wyraźne 0
usuwa również wszelkie ograniczenia. Niezerowej wartości danej sumy nie można mieszać z wartością niezerową
wartości zerowe do odczytu lub zapisu.

If --na żywo jest określony, wpływają na działającego gościa. Jeśli --konfig jest określony, wpływa na
następny rozruch stałego gościa. Jeśli --obecny jest określony, wpływają na bieżącego gościa
państwo. Podczas ustawiania parametrów dysku io oba --na żywo oraz --konfig flagi mogą być
dane, ale --obecny jest ekskluzywny. Aby zapytać tylko o jeden z --na żywo, --konfig or
--obecny można określić. Jeśli nie określono żadnej flagi, zachowanie jest różne w zależności od
na hypervisorze.

blokada domena ścieżka { [--anulować] [--sync] [--sworzeń] | [--informacje] [--surowe] [--bajty] |
[przepustowość] }
Zarządzaj aktywnymi operacjami blokowymi. Istnieją trzy wzajemnie wykluczające się tryby: --informacje,
przepustowość, --anulować. --sync oraz --sworzeń sugerować tryb przerwania; --surowe oznacza informację
tryb; a jeśli nie podano żadnego trybu, --informacje zakłada się tryb.

ścieżka określa w pełni kwalifikowaną ścieżkę dysku; odpowiada unikalnemu celowi
nazwa () lub plik źródłowy () dla jednego z dysków
podłączone urządzenia domena (Zobacz też lista domblk za wypisanie tych nazwisk).

In --anulować trybie, aktywne zadanie na określonym dysku zostanie przerwane. Jeśli --sync is
również określone, to polecenie zwróci natychmiast, zamiast czekać na
anulowanie, aby zakończyć. Jeśli --sworzeń jest określony, powoduje to żądanie aktywnej kopii
lub aktywne zadanie zatwierdzenia zostanie przesunięte na nowy obraz.

In --informacje trybie wydrukowane zostaną informacje o aktywnym zadaniu na określonym dysku. Przez
domyślnie wyjściem jest pojedyncza linia podsumowania czytelna dla człowieka; ten format może się zmienić
przyszłe wersje. Dodawanie --surowe wyświetla listę każdego pola struktury w stabilnym formacie. Jeśli
dotychczasowy --bajty flaga jest ustawiona, polecenie powoduje błąd, jeśli serwer nie może dostarczyć
rozdzielczość bajtów/s; w przypadku pominięcia flagi surowe dane wyjściowe są podawane w MiB/s, a ludzkie
czytelny wynik automatycznie wybiera najlepszą rozdzielczość obsługiwaną przez serwer.

przepustowość można użyć do ustawienia limitu przepustowości dla aktywnego zadania. Określanie
wartość ujemna jest interpretowana jako długa i długa wartość bez znaku lub zasadniczo nieograniczona.
Hiperwizor może wybrać, czy odrzucić wartość, czy przekonwertować ją na maksimum
wartość dozwolona.

zmiana rozmiaru bloku domena ścieżka rozmiar
Zmień rozmiar urządzenia blokowego domeny, gdy domena jest uruchomiona, ścieżka określa
ścieżka bezwzględna urządzenia blokowego; odpowiada unikalnej nazwie celu (<target
dev='name'/>) lub plik źródłowy () dla jednego z urządzeń dyskowych
załączonym do domena (Zobacz też lista domblk za wypisanie tych nazwisk).

rozmiar jest skalowaną liczbą całkowitą (patrz UWAGI powyżej), która domyślnie wynosi KiB (bloki 1024
bajtów), jeśli nie ma przyrostka. Aby uzyskać bajty, musisz użyć przyrostka „B” (zwróć uwagę, że
ze względów historycznych różni się to od zmiana rozmiaru która domyślnie jest bajtami bez a
przyrostek).

domwyświetlacz domena [--include-hasło] [[--rodzaj] rodzaj]
Wyprowadź identyfikator URI, którego można użyć do połączenia z graficznym wyświetlaniem domeny za pośrednictwem
VNC, SPICE lub RDP. Konkretny typ wyświetlania graficznego można wybrać za pomocą
rodzaj parametr (np. „vnc”, „spice”, „rdp”). Jeśli --include-hasło jest określony,
Hasło kanału SPICE zostanie zawarte w identyfikatorze URI.

informacje o domfsinfo domena
Pokaż listę zamontowanych systemów plików w działającej domenie. Lista zawiera
punkty montowania, nazwy zamontowanego urządzenia w gościu, typy systemów plików i unikatowość
nazwy docelowe używane w domenie XML ().

Pamiętaj, że to polecenie wymaga skonfigurowania i uruchomienia agenta gościa w domenie
system operacyjny gościa.

domfsfreeze domena [[--punkt montowania] punkt montowania...]
Zamroź zamontowane systemy plików w działającej domenie, aby przygotować się na spójność
migawki.

--punkt montowania opcja przyjmuje parametr punkt montowania, która jest ścieżką punktu podłączenia
system plików, który ma zostać zamrożony. Opcja ta może wystąpić wielokrotnie. Jeśli tak nie jest
określony, każdy zamontowany system plików zostanie zablokowany.

Uwaga: tworzenie migawki komenda ma --cisza możliwość zamrażania i rozmrażania
systemów plików automatycznie, aby zachować spójność migawek. domfsfreeze polecenie jest tylko
potrzebne, gdy użytkownik chce korzystać z natywnych funkcji migawek urządzeń pamięci masowej
nie jest obsługiwany przez libvirt.

domfstaw domena [[--punkt montowania] punkt montowania...]
Odblokuj zamontowane systemy plików w działającej domenie, które zostały zamrożone przez
polecenie domfsfreeze.

--punkt montowania opcja przyjmuje parametr punkt montowania, która jest ścieżką punktu podłączenia
system plików, który ma zostać rozmrożony. Opcja ta może wystąpić wielokrotnie. Jeśli tak nie jest
określony, każdy zamontowany system plików zostanie odmrożony.

domfstrim domena [--minimum bajtów] [--punkt montowania punkt montowania]
Wydaj komendę fstrim na wszystkich zamontowanych systemach plików w działającej domenie. Odrzuca
bloki, które nie są używane przez system plików. Jeśli --minimum bajtów jest określony, to
informuje o długości jądra gościa ciągłego wolnego wybiegu. Mniejszy niż ten może zostać zignorowany
(jest to podpowiedź i gość może jej nie przestrzegać). Zwiększając tę ​​wartość, np
Operacja fstrim zakończy się szybciej w przypadku systemów plików z dużą fragmentacją
miejsce, chociaż nie wszystkie bloki zostaną odrzucone. Wartość domyślna to zero, co oznacza
„odrzuć każdy wolny blok”. Co więcej, jeśli użytkownik chce przyciąć tylko jeden punkt montowania, to
można określić opcjonalnie --punkt montowania parametr.

nazwahostadom domena
Zwraca nazwę hosta domeny, jeśli hypervisor ją udostępnia.

Informacje o domowniku domena
Zwraca podstawowe informacje o domenie.

domuid nazwa-domeny-lub-id
Konwertuj nazwę domeny lub identyfikator na UUID domeny

Domid nazwa-domeny-lub-uuid
Konwertuj nazwę domeny (lub UUID) na identyfikator domeny

przerwać pracę domową domena
Przerwij aktualnie uruchomione zadanie domeny.

informacje o pracy domowej domena [--zakończony]
Zwraca informacje o zadaniach uruchomionych w domenie. --zakończony każe virshowi wrócić
informacja o niedawno zakończonej pracy. Statystyki wykonanej pracy są
automatycznie niszczone po przeczytaniu lub ponownym uruchomieniu libvirtd. Zwróć uwagę na ten czas
informacje zwrócone w przypadku zakończonych migracji mogą być całkowicie nieistotne, chyba że oba
hosty źródłowy i docelowy mają zsynchronizowany czas (tj. demon NTP jest uruchomiony
obydwoje).

nazwadomu identyfikator-domeny lub-uuid
Konwertuj identyfikator domeny (lub UUID) na nazwę domeny

nazwadomrena domena nowe imie
Zmień nazwę domeny. To polecenie zmienia bieżącą nazwę domeny na nową nazwę określoną w
drugi argument.

Note: Domena musi być nieaktywna i bez migawek.

stan domowy domena [--powód]
Zwraca stan dotyczący domeny. --powód mówi virshowi, aby wydrukował także przyczynę
stan.

kontrola domu domena
Zwraca stan interfejsu do VMM używanego do kontrolowania domeny. Dla stanów innych niż
„ok” lub „błąd” polecenie wypisuje także liczbę sekund, które upłynęły od wykonania kontroli
interfejs osiągnął swój obecny stan.

czas domowy domena { [--Teraz] [--piękny] [--synchronizacja] [--czas czas] }
Pobiera lub ustawia czas systemowy domeny. Po uruchomieniu bez żadnych argumentów (ale domena),
drukowany jest czas systemowy bieżącej domeny. The --piękny można zastosować modyfikator
wydrukuj godzinę w formie bardziej czytelnej dla człowieka.

Kiedy --czas czas jest określony, czas domeny nie jest pobierany, ale zamiast tego ustawiany. The
--Teraz modyfikator działa tak, jakby był aliasem dla --czas $teraz, co oznacza, że ​​ustawia
czas, który aktualnie znajduje się na hoście virsh. W obu przypadkach (ustawienie i
uzyskiwanie), czas jest podany w sekundach w stosunku do epoki 1970-01-01 w UTC. The --synchronizacja
modyfikuje nieco ustawione zachowanie: Upływający czas jest ignorowany, ale czas do ustawienia już tak
zamiast tego odczytaj z RTC domeny. Należy pamiętać, że niektóre hypervisory mogą wymagać obecności gościa
agenta, który należy skonfigurować w celu uzyskania lub ustawienia czasu gościa.

domxml-z-natywnego format config
Konwertuj plik config w natywnym formacie konfiguracji gościa o nazwie by format do
domenowy format XML. W przypadku hiperwizora QEMU/KVM plik format argument musi być qemu-argv. Forum
Hiperwizor Xen, tzw format argumentem może być xen-xm, xen-xllub xen-sxpr. Dla LXC
hiperwizor, format argument musi być Narzędzia lxc.

domxml na natywny format xml
Konwertuj plik xml w formacie XML domeny do natywnego formatu konfiguracji gościa
nazwany przez format. W przypadku hiperwizora QEMU/KVM plik format argument musi być qemu-argv. Forum
Hiperwizor Xen, tzw format argumentem może być xen-xm, xen-xllub xen-sxpr. Dla LXC
hiperwizor, format argument musi być Narzędzia lxc.

zrzucać domena ścieżka pliku rdzenia [--bypass-cache] { [--na żywo] | [--rozbić się] | [--Resetowanie] } [--gadatliwy]
[--tylko pamięć] [--format ciąg]
Zrzuca rdzeń domeny do pliku w celu analizy. Jeśli --na żywo jest określona, ​​domena
kontynuuje działanie, aż do zakończenia zrzutu rdzenia, zamiast wstrzymywać się od początku. Jeśli
--rozbić się zostanie określony, domena zostanie zatrzymana ze statusem awarii, a nie tylko
pozostawiony w stanie pauzy. Jeśli --Resetowanie zostanie określony, domena zostanie zresetowana po pomyślnym zakończeniu
wysypisko. Należy pamiętać, że te trzy przełączniki wzajemnie się wykluczają. Jeśli --bypass-cache is
określony, zapisywanie będzie omijać pamięć podręczną systemu plików, chociaż może to spowolnić
operacja. Jeśli --tylko pamięć zostanie określony, plik będzie plikiem elf i będzie zawierał tylko
pamięć domeny i wartość wspólnego rejestru procesora. Jest to bardzo przydatne, jeśli domena korzysta
bezpośrednio do urządzeń hosta. --format ciąg służy do określenia formatu „tylko pamięć”
zrzut i ciąg może być jednym z nich: elf, kdump-zlib (skompresowany format kdump z
skompresowany zlib), kdump-lzo (format skompresowany kdump ze skompresowanym lzo),
kdump-snappy (format skompresowany przez kdump z kompresją snappy).

Postęp można monitorować za pomocą informacje o pracy domowej polecenie virsh i anulowane za pomocą
przerwać pracę domową polecenie (wysłane przez inną instancję virsh). Inną opcją jest wysłanie SIGINT
(zwykle z „Ctrl-C”), aby uruchomić proces virsh zrzucać dowództwo. --gadatliwy wyświetlacze
postęp zrzutu.

UWAGA: Niektóre hypervisory mogą wymagać od użytkownika ręcznego zapewnienia odpowiednich uprawnień
plik i ścieżka określona przez argument ścieżka pliku rdzenia.

zrzutxml domena [--nieaktywny] [--informacje Ochrony] [--update-cpu] [--migrowalne]
Wyprowadź informacje o domenie jako zrzut XML na standardowe wyjście. Ten format może być używany przez
Stwórz Komenda. Można zastosować dodatkowe opcje wpływające na zrzut XML. --nieaktywny
mówi virshowi, aby zrzucił konfigurację domeny, która będzie używana przy następnym uruchomieniu domeny
w przeciwieństwie do bieżącej konfiguracji domeny. Za pomocą --informacje Ochrony będzie również
dołącz poufne informacje dotyczące bezpieczeństwa do zrzutu XML. --update-cpu aktualizuje domenę
Wymagania procesora zgodnie z procesorem hosta. Z --migrowalne można poprosić o plik XML
jest odpowiedni do migracji, tj. jest kompatybilny ze starszymi wydaniami libvirt i ewentualnie
uzupełnione wewnętrznymi opcjami wykonawczymi. Ta opcja może automatycznie włączyć inne
opcje (--update-cpu, --informacje Ochrony, ...) jako niezbędne.

edit domena
Edytuj plik konfiguracyjny XML dla domeny, co będzie miało wpływ na następne uruchomienie
Gość.

Odpowiada to:

virsh dumpxml --inactive --security-info domena > domena.xml
vi domain.xml (lub dokonaj zmian w innym edytorze tekstu)
virsh zdefiniuj domenę.xml

z tą różnicą, że sprawdza pewne błędy.

Używany edytor może być dostarczony przez zmienne środowiskowe $VISUAL lub $EDITOR, oraz
domyślnie „vi”.

wydarzenie {[domena] { wydarzenie | --wszystko } [--pętla] [--koniec czasu sekund] [--znak czasu] | --lista}
Poczekaj na wystąpienie klasy zdarzeń domeny i wydrukuj odpowiednie szczegóły zdarzeń jako
się zdarzają. Zdarzenia można opcjonalnie filtrować według domena, Za pomocą --lista jak
jedyny argument wyświetli listę możliwych wydarzenie wartości znane temu klientowi,
chociaż połączenie może nie umożliwiać rejestracji na wszystkie te wydarzenia. To jest również
możliwe w użyciu --wszystko zamiast wydarzenie zarejestrować się na wszystkie możliwe typy wydarzeń pod adresem
pewnego razu.

Domyślnie to polecenie jest jednorazowe i zwraca sukces po wystąpieniu zdarzenia; Ty
może wysłać SIGINT (zwykle przez „Ctrl-C”), aby natychmiast zakończyć. Jeśli --koniec czasu is
określony, polecenie rezygnuje z oczekiwania na zdarzenia po sekund upłynęły. Z
--pętla, polecenie wypisuje wszystkie zdarzenia aż do przekroczenia limitu czasu lub klawisza przerwania.

Kiedy --znak czasu zostanie użyty, przed zdarzeniem zostanie wydrukowany czytelny dla człowieka znacznik czasu.

iothreadinfo domena [[--na żywo] [--konfig] | [--obecny]]
Wyświetl podstawowe informacje o domenie IOThreads, w tym identyfikator IOThread i procesor
Powinowactwo dla każdego IOThread.

If --na żywo jest określony, pobierz dane IOThreads od działającego gościa. Jeśli gość jest
nie działa, zwracany jest błąd. Jeśli --konfig jest określony, pobierz dane IOThreads
od następnego rozruchu stałego gościa. Jeśli --obecny jest określony lub --na żywo oraz
--konfig nie są określone, pobierz dane IOThread na podstawie bieżącego gościa
stan.

ithreadpin domena i wątek cpulista [[--na żywo] [--konfig] | [--obecny]]
Zmień przypinanie domeny IOThread, aby hostować fizyczne procesory. Aby odzyskać a
lista wszystkich IOThreads, użyj iothreadinfo. Aby przypiąć i wątek określić cpulista
wymagane dla identyfikatora IOThread wymienionego w iothreadinfo wyjście.

cpulista to lista numerów fizycznych procesorów. Jego składnia to lista oddzielona przecinkami i a
dozwolone są również specjalne znaczniki z użyciem „-” i „^” (np. „0-4”, „0-3,^2”). „-”
oznacza zakres, a „^” oznacza wyłączność. Jeśli chcesz zresetować iothreadpin
ustawienie, czyli przypięcie i wątek do wszystkich fizycznych procesorów, po prostu określ „r” jako a
cpulista.

If --na żywo jest określony, wpływają na działającego gościa. Jeśli gość nie jest uruchomiony, pojawia się błąd
jest zwracany. Gdyby --konfig jest określony, wpływają na następne uruchomienie stałego gościa.
If --obecny jest określony lub --na żywo oraz --konfig nie są określone, wpływają na prąd
stan gościnny. Obydwa --na żywo oraz --konfig flagi mogą zostać przyznane, jeśli cpulista jest obecny, ale
--obecny jest ekskluzywny. Jeśli nie określono żadnej flagi, zachowanie jest różne w zależności od
hiperwizor.

Note: Wyrażenie jest oceniane sekwencyjnie, więc „0-15,^8” jest identyczne
„9-14,0-7,15”, ale nie identyczne z „^8,0-15”.

iotreadadd domena iothread_id [[--konfig] [--na żywo] | [--obecny]]
Dodaj nowy IOThread do domeny, używając określonego iothread_id, Jeśli iothread_id
już istnieje, polecenie zakończy się niepowodzeniem. The iothread_id musi być większa od zera.

If --na żywo jest określony, wpływają na działającego gościa. Jeśli u gościa nie występuje błąd
jest zwracany. Gdyby --konfig jest określony, wpływają na następne uruchomienie stałego gościa.
If --obecny jest określony lub --na żywo oraz --konfig nie są określone, wpływają na prąd
stan gościnny.

iothreaddel domena iothread_id [[--konfig] [--na żywo] | [--obecny]]
Usuń IOThread z domeny, używając określonego iothread_id. Jeśli IOThread jest
aktualnie przypisany do zasobu dyskowego, np. poprzez dołącz dysk polecenie, a następnie
próba usunięcia IOThread zakończy się niepowodzeniem. Jeśli iothread_id nie istnieje błąd
wystąpi.

If --na żywo jest określony, wpływają na działającego gościa. Jeśli u gościa nie występuje błąd
jest zwracany. Gdyby --konfig jest określony, wpływają na następne uruchomienie stałego gościa.
If --obecny jest określony lub --na żywo oraz --konfig nie są określone, wpływają na prąd
stan gościnny.

udało się zapisać domena [--bypass-cache] [{--działanie | --pauza}] [--gadatliwy]
Zapisz i zniszcz (zatrzymaj) działającą domenę, aby można było ją ponownie uruchomić w tym samym stanie
w późniejszym terminie. Kiedy virsh początek polecenie zostanie następnie uruchomione dla domeny, tak się stanie
zostanie automatycznie uruchomiony od zapisanego stanu. Jeśli --bypass-cache jest określony,
save pozwoli uniknąć pamięci podręcznej systemu plików, chociaż może to spowolnić operację.

Postęp można monitorować za pomocą informacje o pracy domowej polecenie virsh i anulowane za pomocą
przerwać pracę domową polecenie (wysłane przez inną instancję virsh). Inną opcją jest wysłanie SIGINT
(zwykle z „Ctrl-C”), aby uruchomić proces virsh udało się zapisać dowództwo. --gadatliwy
wyświetla postęp zapisu.

Zwykle rozpoczęcie zarządzanego zapisywania decyduje o tym, czy będzie ono uruchamiane, czy wstrzymane, w zależności od
podaj, w której domenie znajdowała się w momencie zapisywania; mijając albo --działanie or
--pauza flaga pozwoli na nadpisanie stanu początek powinien użyć.

Informacje o domowniku polecenia można użyć do sprawdzenia, czy domena aktualnie zarządza jakimikolwiek domenami
zapisać obraz.

udało się zapisać-usunąć domena
Usunąć udało się zapisać plik stanu dla domeny, jeśli istnieje. Zapewnia to domenę
przy następnym uruchomieniu wykona pełny rozruch.

maxvcpus [rodzaj]
Podaj w tym przypadku maksymalną liczbę procesorów wirtualnych obsługiwanych przez maszynę wirtualną gościa
połączenie. Jeśli podano, rodzaj Parametr musi być prawidłowym atrybutem typu dla
element XML.

statystyki procesora domena [--całkowity] [początek] [liczyć]
Podaj informacje statystyczne dotyczące procesora dla domeny. Domena powinna działać. Domyślny
pokazuje statystyki dla wszystkich procesorów i sumę. Używać --całkowity tylko dla statystyk całkowitych, początek
tylko dla statystyk procesorów na procesor z początek, liczyć za jedyne liczyć Statystyki procesorów.

metadanych domena [[--na żywo] [--konfig] | [--obecny]] [--edytować] [Linki] [klucz] [zestaw] [--usunąć]
Pokaż lub zmodyfikuj niestandardowe metadane XML domeny. Metadane to plik XML zdefiniowany przez użytkownika
co pozwala na przechowywanie dowolnych danych XML w definicji domeny. Wiele oddzielnych
niestandardowe fragmenty metadanych można przechowywać w formacie XML domeny. Kawałki są identyfikowane przez
prywatna przestrzeń nazw XML udostępniana za pośrednictwem Linki argument. (Zobacz też desc to działa z
metadane tekstowe domeny.)

Flagi --na żywo or --konfig wybierz, czy to polecenie działa na żywo, czy na stałe
definicje domeny. Jeśli oba --na żywo oraz --konfig są określone, --konfig
opcja ma pierwszeństwo przed uzyskaniem bieżącego opisu i obu konfiguracji na żywo
i config są aktualizowane podczas ustawiania opisu. --obecny jest ekskluzywny i
dorozumiane, jeśli żaden z nich nie został określony.

Flaga --usunąć określa, że ​​element metadanych określony przez Linki argument powinien
zostać usunięte, a nie zaktualizowane.

Flaga --edytować określa, że ​​edytor z metadanymi identyfikowanymi przez Linki argument
należy otworzyć, a następnie zapisać zawartość. W przeciwnym razie nowa zawartość
można świadczyć za pośrednictwem zestaw argumenty.

Podczas ustawiania metadanych poprzez --edytować or zestaw dotychczasowy klucz argument musi być określony i jest używany
aby poprzedzić elementy niestandardowe i powiązać je z prywatną przestrzenią nazw.

Jeśli żadne z --edytować oraz zestaw są określone metadane XML odpowiadające Linki
przestrzeń nazw jest wyświetlana zamiast modyfikowana.

migrować [--na żywo] [--w trybie offline] [--bezpośredni] [--p2p [--tunelowany]] [--uporczywy]
[--nieokreślone źródło] [--zawieszać] [--kopiuj-przechowywanie-wszystko] [--copy-storage-inc]
[--ochrona przed zmianami] [--niebezpieczny] [--gadatliwy] [--sprężony] [- przerwanie w przypadku błędu]
[--automatyczna konwergencja] domena destrukcja [migrować] [grafika] [adres słuchania] [nazwa]
[--koniec czasu sekund] [--xml filet] [--migracja dysków lista dysków]
Przenieś domenę na inny host. Dodać --na żywo dla migracji na żywo; <--p2p> dla
migracja peer-2-peer; --bezpośredni dla migracji bezpośredniej; Lub --tunelowany dla tunelowanych
migracja. --w trybie offline migruje definicję domeny bez uruchamiania domeny
docelowego i bez zatrzymywania go na hoście źródłowym. Można zastosować migrację offline
z nieaktywnymi domenami i należy go używać z --uporczywy opcja. --uporczywy
pozostawia domenę stałą na hoście docelowym, --nieokreślone źródło nie definiuje
domena na hoście źródłowym oraz --zawieszać pozostawia domenę wstrzymaną w miejscu docelowym
gospodarz. --kopiuj-przechowywanie-wszystko wskazuje migrację z niewspółdzielonym magazynem z pełnym dyskiem
Kopiuj, --copy-storage-inc wskazuje migrację z niewspółdzieloną pamięcią masową z przyrostem
kopia (ten sam obraz podstawowy współdzielony między źródłem i miejscem docelowym). W obu przypadkach dysk
obrazy muszą istnieć na hoście docelowym, --kopia-przechowywanie-... opcje tylko mówią
libvirt do przesyłania danych z obrazów na hoście źródłowym do obrazów znalezionych w
tym samym miejscu na hoście docelowym. Domyślnie dostępne są tylko obrazy nieudostępnione, które nie są przeznaczone tylko do odczytu
przeniesiony. Używać --migracja dysków aby jawnie określić listę docelowych dysków
przenieść oddzielając je przecinkiem lista dysków argumenty. --ochrona przed zmianami wymusza to
podczas migracji nie zostaną wprowadzone żadne niezgodne zmiany w konfiguracji domeny
jest w toku; ta flaga jest domyślnie włączona, jeśli jest obsługiwana przez hiperwizor, ale może
być wyraźnie użyte do odrzucenia migracji, jeśli hiperwizor nie ma ochrony przed zmianami
Wsparcie. --gadatliwy wyświetla postęp migracji. --sprężony aktywuje
kompresja stron pamięci, które muszą być wielokrotnie przesyłane podczas transmisji na żywo
migracja. - przerwanie w przypadku błędu anuluje migrację, jeśli wystąpi błąd programowy (na przykład I/O
błąd) ma miejsce podczas migracji. --automatyczna konwergencja zbieżność sił podczas transmisji na żywo
migracja.

Note: Poszczególne hiperwizory zwykle nie obsługują wszystkich możliwych typów migracji.
Na przykład QEMU nie obsługuje migracji bezpośredniej.

W niektórych przypadkach libvirt może odmówić migracji domeny, ponieważ może to spowodować
potencjalne problemy, takie jak uszkodzenie danych, dlatego rozważa się migrację
niebezpieczny. W przypadku domeny QEMU może się to zdarzyć, jeśli domena używa dysków bez jawnie
ustawienie trybu pamięci podręcznej na „brak”. Migracja takich domen jest niebezpieczna, chyba że obrazy dysków
są przechowywane w spójnym klastrowym systemie plików, takim jak GFS2 lub GPFS. Jeśli jesteś pewien
migracja jest bezpieczna lub po prostu cię to nie obchodzi, użyj --niebezpieczny wymusić migrację.

nazwa służy do zmiany nazwy domeny na nową podczas migracji, co zwykle również
można pominąć. Podobnie, --xml filet jest zwykle pomijany, ale można go użyć do dostarczenia
alternatywny plik XML do użycia w miejscu docelowym w celu dostarczenia większego zestawu zmian
wszelkie specyficzne dla hosta części XML domeny, takie jak rozliczanie nazewnictwa
różnice między źródłem a miejscem docelowym w dostępie do podstawowej pamięci masowej.

--koniec czasu sekund zmusza gościa do zawieszenia, gdy migracja na żywo przekracza tę liczbę
sekund, a następnie migracja zakończy się w trybie offline. Można go używać tylko z
--na żywo.

Uruchomioną migrację można anulować, przerywając virsh (zwykle używając „Ctrl-C”) lub przez
przerwać pracę domową polecenie wysłane z innej instancji virsh.

destrukcja oraz migrować Parametry mogą służyć do kontrolowania miejsca docelowego
zastosowania migracji. destrukcja jest ważny w przypadku migracji zarządzanej, ale nie jest używany w przypadku migracji bezpośredniej
migracja; migrować jest wymagany w przypadku migracji bezpośredniej, ale zwykle może być
automatycznie określane dla migracji zarządzanej.

Note: the destrukcja parametr dla normalnej migracji i migracji peer2peer jest inny
semantyka:

· normalna migracja: destrukcja jest adresem hosta docelowego widzianym z
maszyna klienta.

· Migracja peer2peer: the destrukcja jest adresem hosta docelowego widzianym z
maszyna źródłowa.

Kiedy migrować nie jest określony, libvirt automatycznie określi hiperwizor
określonego identyfikatora URI. Niektóre hypervisory, w tym QEMU, mają opcjonalny „host_migracji”
parametr konfiguracyjny (przydatny, gdy host ma wiele interfejsów sieciowych). Jeśli
nie jest to określone, libvirt określa nazwę, sprawdzając nazwę hosta docelowego
skonfigurowana nazwa hosta.

Istnieje kilka scenariuszy, w których należy określić migrować może pomóc:

· Skonfigurowana nazwa hosta jest nieprawidłowa lub DNS jest uszkodzony. Jeśli host ma nazwę hosta
który nie będzie pasować do jednego z jego publicznych adresów IP, wówczas zrobi to libvirt
wygenerować nieprawidłowy identyfikator URI. W tym przypadku migrować powinno być wyraźnie
określony, używając adresu IP lub prawidłowej nazwy hosta.

· Host ma wiele interfejsów sieciowych. Jeśli host ma wiele sieci
interfejsów, może być pożądane, aby strumień danych migracji był przesyłany za pośrednictwem łącza A
określonego interfejsu ze względów bezpieczeństwa lub wydajności. W tym przypadku
migrować należy wyraźnie określić, używając adresu IP powiązanego z
sieć, z której chcesz korzystać.

· Zapora ogranicza dostępne porty. Kiedy libvirt generuje plik
URI migracji, wybierze numer portu przy użyciu reguł specyficznych dla hypervisora. Niektóre
hypervisory wymagają otwarcia tylko jednego portu w zaporach ogniowych, podczas gdy inne
wymagają całego zakresu numerów portów. W tym drugim przypadku migrować może być
określono, aby wybrać konkretny numer portu spoza domyślnego zakresu, aby to zrobić
przestrzegać lokalnych zasad zapory sieciowej.

Widziećhttp://libvirt.org/migration.html#uris>, aby uzyskać więcej informacji na temat identyfikatorów URI migracji.

Opcjonalnie grafika zastępuje parametry połączenia używane w trybie automatycznym
ponowne podłączenie klientów graficznych po zakończeniu migracji. Jeśli zostanie pominięty, zrobi to libvirt
obliczyć parametry w oparciu o adres IP hosta docelowego. W przypadku, gdy klient tego nie robi
mają bezpośredni dostęp do hostów wirtualizacji sieci, do których są podłączeni i muszą
połączyć się przez proxy, grafika może służyć do określenia adresu klienta
powinien się połączyć. URI tworzy się w następujący sposób:

protokół://nazwa hosta[:port]/[?parametry]

gdzie protokół to „spice” lub „vnc”, a parametry to lista protokołów
określone parametry oddzielone znakiem „&”. Obecnie rozpoznawane parametry to „tlsPort”
i „tlsSubject”. Na przykład,

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

Opcjonalnie adres słuchania ustawia adres nasłuchiwania hiperwizora w miejscu docelowym
strona powinna powiązać się z przychodzącą migracją. Akceptowane są zarówno adresy IPv4, jak i IPv6
jak również nazwy hostów (rozwiązywanie odbywa się w miejscu docelowym). Niektóre hypervisory tego nie robią
obsługuje tę funkcję i zwróci błąd, jeśli ten parametr zostanie użyty.

migracja-setmaxdowntime domena przestojów
Ustaw maksymalny tolerowany czas przestoju dla domeny, która jest migrowana na żywo do innej
gospodarz. ten przestojów to liczba milisekund, przez jaką gość może przebywać na dole
koniec migracji na żywo.

migracja-compcache domena [--rozmiar bajtów]
Ustawia i/lub pobiera rozmiar pamięci podręcznej (w bajtach) używanej do wielokrotnego kompresowania
przesłane strony pamięci podczas migracji na żywo. Gdy zadzwonisz bez rozmiar, Komenda
po prostu drukuje bieżący rozmiar pamięci podręcznej kompresji. Gdy rozmiar jest określony,
hypervisor jest proszony o zmianę pamięci podręcznej kompresji na rozmiar bajty, a następnie prąd
zostanie wydrukowany rozmiar (wynik może różnić się od żądanego rozmiaru ze względu na zaokrąglenia wykonane przez
hiperwizora). The rozmiar Opcja ta ma być używana w czasie, gdy domena jest przechowywana
live-migred jako reakcja na postęp migracji i rosnącą liczbę kompresji
braki pamięci podręcznej uzyskane z domjobinfo.

migracja-setspeed domena przepustowość
Ustaw maksymalną przepustowość migracji (w MiB/s) dla domeny, do której przeprowadzana jest migracja
inny gospodarz. przepustowość jest interpretowany jako wartość typu unsigned long long. Określanie
Wartość ujemna skutkuje zasadniczo nieograniczoną wartością dostarczaną do
hiperwizor. Hiperwizor może wybrać, czy odrzucić wartość, czy przekonwertować ją na
maksymalna dozwolona wartość.

migruj-getspeed domena
Uzyskaj maksymalną przepustowość migracji (w MiB/s) dla domeny.

numeracja domena [--tryb tryb] [--zestaw węzłów zestaw węzłów] [[--konfig] [--na żywo] | [--obecny]]
Ustaw lub pobierz parametry numa domeny odpowiadające element
domeny XML. Bez flag wyświetlane są aktualne ustawienia.

tryb może być jedną z opcji „ścisłych”, „przeplatanych” i „preferowanych” lub dowolną prawidłową liczbą z
virDomainNumatuneMemMode enum w przypadku, gdy demon to obsługuje. W przypadku działającej domeny
trybu nie można zmienić, a zestaw węzłów można zmienić tylko wtedy, gdy domena została zmieniona
rozpoczęło się od trybu „ścisłego”.

zestaw węzłów to lista węzłów num używanych przez hosta do uruchamiania domeny. Jego składnia
to lista oddzielona przecinkami, z „-” dla zakresów i „^” dla wykluczenia węzła.

If --na żywo jest określony, ustaw informacje o programie planującym działającego gościa. Jeśli --konfig is
określone, wpływają na następne uruchomienie stałego gościa. Jeśli --obecny jest specyficzne,
wpływać na bieżący stan gościa.

restart domena [--tryb LISTA TRYBÓW]
Uruchom ponownie domenę. Działa to tak, jakby domena miała restart polecenie uruchom z
konsola. Polecenie powraca, gdy tylko wykona akcję restartu, co może:
być znacznie przed ponownym uruchomieniem domeny.

Dokładne zachowanie domeny po ponownym uruchomieniu jest ustawiane przez przy ponownym uruchomieniu parametr w
definicja XML domeny.

Domyślnie hypervisor spróbuje wybrać odpowiednią metodę zamknięcia. Aby określić
metoda alternatywna, tj --tryb Parametr może określić listę oddzieloną przecinkami, która
obejmuje „acpi”, „agent”, „initctl”, „sygnał” i „parawirt”. Kolejność, w jakiej
sterowniki będą próbowały, każdy tryb jest niezdefiniowany i nie jest powiązany z określoną kolejnością
virsz. Aby uzyskać ścisłą kontrolę nad kolejnością, używaj pojedynczego trybu na raz i powtarzaj
dowództwo.

zresetuj domena
Natychmiast zresetuj domenę, bez wyłączania gościa. zresetuj emuluje reset zasilania
na komputerze, na którym cały sprzęt gościnny widzi zestaw linii RST i ponownie inicjuje
stan wewnętrzny.

Note: Zresetowanie bez zamykania systemu gościa grozi utratą danych.

przywracać plik-stanowy [--bypass-cache] [--xml filet] [{--działanie | --pauza}]
Przywraca domenę z a Virsh zapisać plik stanu. Widzieć zapisać więcej informacji.

If --bypass-cache zostanie określony, przywrócenie spowoduje jednak uniknięcie pamięci podręcznej systemu plików
może to spowolnić operację.

--xml filet jest zwykle pomijany, ale można go użyć do dostarczenia alternatywnego pliku XML
użyj na przywróconym gościu ze zmianami tylko w częściach pliku specyficznych dla hosta
domeny XML. Można go na przykład wykorzystać do uwzględnienia różnic w nazewnictwie plików w
bazowa pamięć masowa ze względu na migawki dysków wykonane po zapisaniu gościa.

Zwykle przy przywracaniu zapisanego obrazu używany będzie stan zapisany w zapisanym obrazie
zdecyduj, czy chcesz działać, czy wstrzymać; mijając albo --działanie or --pauza flaga będzie
zezwól na zastąpienie stanu, w którym domena powinna zostać uruchomiona.

Note: Aby uniknąć uszkodzenia zawartości systemu plików w domenie, nie należy używać go ponownie
zapisany plik stanu na sekundę przywracać chyba że przywróciłeś także całą pamięć
woluminach z powrotem do tej samej zawartości, jaka była podczas tworzenia pliku stanu.

zapisać domena plik-stanowy [--bypass-cache] [--xml filet] [{--działanie | --pauza}] [--gadatliwy]
Zapisuje działającą domenę (RAM, ale nie stan dysku) w pliku stanu, aby tak było
przywrócone później. Po zapisaniu domena nie będzie już działać w systemie
pamięć przydzielona dla domeny będzie wolna dla innych domen. Virsh
przywracać przywraca z tego pliku stanu. Jeśli --bypass-cache zostanie określony, zapis zostanie wykonany
unikaj pamięci podręcznej systemu plików, chociaż może to spowolnić operację.

Postęp można monitorować za pomocą informacje o pracy domowej polecenie virsh i anulowane za pomocą
przerwać pracę domową polecenie (wysłane przez inną instancję virsh). Inną opcją jest wysłanie SIGINT
(zwykle z „Ctrl-C”), aby uruchomić proces virsh zapisać dowództwo. --gadatliwy wyświetlacze
postęp zapisywania.

Jest to mniej więcej równoznaczne z hibernacją na uruchomionym komputerze, przy wszystkich
same ograniczenia. Otwarte połączenia sieciowe mogą zostać zerwane po przywróceniu, tak jak TCP
limity czasu mogły upłynąć.

--xml filet jest zwykle pomijany, ale można go użyć do dostarczenia alternatywnego pliku XML
użyj na przywróconym gościu ze zmianami tylko w częściach pliku specyficznych dla hosta
domeny XML. Można go na przykład wykorzystać do uwzględnienia różnic w nazewnictwie plików
planuje się, że będą one tworzone za pomocą migawek dysków bazowej pamięci po gościu
zapisane.

Zwykle przy przywracaniu zapisanego obrazu następuje decyzja o uruchomieniu lub wstrzymaniu w zależności od
podaj, w której domenie znajdowała się w momencie zapisywania; mijając albo --działanie or
--pauza flaga pozwoli na nadpisanie stanu przywracać powinien użyć.

W plikach stanu zapisanych w domenie zakłada się, że obrazy dysków pozostaną niezmienione pomiędzy
punkt tworzenia i przywracania. Aby uzyskać pełniejszy punkt przywracania systemu, w którym znajduje się dysk
stan jest zapisywany wraz ze stanem pamięci, patrz migawka rodzina poleceń.

zapisz-zdefiniuj obraz filet xml [{--działanie | --pauza}]
Zaktualizuj XML domeny, który będzie używany, gdy filet jest później używany w przywracać
Komenda. Plik xml argumentem musi być nazwa pliku zawierająca alternatywny kod XML, z
zmiany tylko w częściach XML domeny specyficznych dla hosta. Na przykład może tak być
służy do uwzględnienia różnic w nazewnictwie plików wynikających z tworzenia migawek dysków
podstawowa pamięć masowa po zapisaniu gościa.

Zapisany obraz rejestruje, czy domena powinna zostać przywrócona do działania, czy wstrzymana
państwo. Zwykle to polecenie nie zmienia zapisanego stanu; mijając albo
--działanie or --pauza flaga pozwoli na nadpisanie stanu przywracać powinien użyć.

zapisz-obraz-dumpxml filet [--informacje Ochrony]
Wyodrębnij kod XML domeny obowiązujący w momencie zapisywania pliku stanu filet była
utworzony przy pomocy zapisać Komenda. Za pomocą --informacje Ochrony będzie obejmować także bezpieczeństwo
Wrażliwa informacja.

zapisz-edytuj-obraz filet [{--działanie | --pauza}]
Edytuj konfigurację XML powiązaną z zapisanym plikiem stanu filet Stworzony przez zapisać
dowództwo.

Zapisany obraz rejestruje, czy domena powinna zostać przywrócona do działania, czy wstrzymana
państwo. Zwykle to polecenie nie zmienia zapisanego stanu; mijając albo
--działanie or --pauza flaga pozwoli na nadpisanie stanu przywracać powinien użyć.

Odpowiada to:

virsh save-image-dumpxml plik-stanu > plik-stanu.xml
vi state-file.xml (lub wprowadź zmiany w innym edytorze tekstu)
virsh save-image-define-state-file state-file-xml

z tą różnicą, że sprawdza pewne błędy.

Używany edytor może być dostarczony przez zmienne środowiskowe $VISUAL lub $EDITOR, oraz
domyślnie „vi”.

informacje o harmonogramie domena [[--konfig] [--na żywo] | [--obecny]] [[--ustawić] parametr=wartość] ...
informacje o harmonogramie [--waga numer] [--czapka numer] domena
Umożliwia pokazanie (i ustawienie) parametrów harmonogramu domeny. Dostępne parametry
dla każdego hypervisora ​​są:

LXC (harmonogram Posix): cpu_shares, vcpu_period, vcpu_quota

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

Xen (harmonogram kredytu): waga, limit

ESX (harmonogram alokacji): rezerwacja, limit, udziały

If --na żywo jest określony, ustaw informacje o programie planującym działającego gościa. Jeśli --konfig is
określone, wpływają na następne uruchomienie stałego gościa. Jeśli --obecny jest specyficzne,
wpływać na bieżący stan gościa.

Note: Parametr cpu_shares ma prawidłowy zakres wartości 0-262144; Wartości ujemne
są zawijane do wartości dodatnich, a większe wartości są ograniczane do maksimum. Dlatego -1
to przydatny skrót dla 262144. W jądrze Linuksa wartościami są 0 i 1
automatycznie konwertowane na minimalną wartość 2.

Note: Parametry wagi i limitu są zdefiniowane tylko dla harmonogramu XEN_CREDIT i
są teraz ODRADZANA.

Note: Parametry vcpu_period/emulator_period mają prawidłowy zakres wartości
1000-1000000 lub 0, a parametry vcpu_quota/emulator_quota mają prawidłową wartość
zakres 1000-18446744073709551 lub mniejszy niż 0. Wartość 0 dla każdego parametru to
to samo, co brak określenia tego parametru.

zrzut ekranu domena [ścieżka do pliku obrazu] [--ekran identyfikator ekranu]
Wykonuje zrzut ekranu bieżącej konsoli domeny i zapisuje go w pliku. Opcjonalnie,
jeśli hypervisor obsługuje więcej wyświetlaczy dla domeny, identyfikator ekranu pozwala określić które
ekran zostanie przechwycony. Jest to kolejny numer ekranu. W przypadku wielokrotności
karty graficzne, głowice są wyliczane przed urządzeniami, np. posiadającymi dwie karty graficzne,
obaj z czterema głowami, identyfikator ekranu 5 odnosi się do drugiej głowy na drugiej karcie.

klawisz wysyłania domena [--zestaw kodów zestaw kodów] [--wstrzymaj się wstrzymaj się] Kod Klucza...
Przeanalizuj Kod Klucza sekwencję naciśnięć klawiszy, do których chcesz wysłać domena, Każdy Kod Klucza może albo
być wartością numeryczną lub nazwą symboliczną z odpowiedniego zestawu kodów. Jeśli --wstrzymaj się
zostanie podana, każde naciśnięcie klawisza zostanie przytrzymane przez tyle milisekund. Domyślny zestaw kodów
is linux, ale użycie --zestaw kodów Opcja umożliwia wybór innych zestawów kodów.

Jeśli określono wiele kodów klawiszy, wszystkie są wysyłane jednocześnie do gościa i
mogą być odbierane w losowej kolejności. Jeśli potrzebujesz różnych naciśnięć klawiszy, musisz użyć
wielokrotne wywołania klawisza wysyłania.

linux
Wartości liczbowe są zdefiniowane przez podsystem ogólnych zdarzeń wejściowych systemu Linux.
Nazwy symboliczne odpowiadają odpowiednim nazwom makr stałych klucza systemu Linux.

xt Wartości numeryczne są zdefiniowane przez oryginalny kontroler klawiatury XT. NIE
podano nazwy symboliczne

zestaw1
Wartości numeryczne są zdefiniowane przez kontroler klawiatury AT, zestaw 1 (inaczej XT
kompatybilny zestaw). Rozszerzone klucze z zestaw1 mogą różnić się od rozszerzonych kodów klawiszy
dotychczasowy xt zestaw kodów. Nie podano żadnych nazw symbolicznych

zestaw2
Wartości numeryczne są zdefiniowane przez kontroler klawiatury AT, zestaw 2. Nie
podano nazwy symboliczne

zestaw3
Wartości numeryczne są zdefiniowane przez kontroler klawiatury AT, zestaw 3 (tzw
Zestaw zgodny z PS/2). Nie podano żadnych nazw symbolicznych

os_x
Wartości numeryczne są zdefiniowane przez podsystem wprowadzania danych z klawiatury OS-X. The
nazwy symboliczne odpowiadają odpowiednim nazwom makr stałych klucza OS-X

xt_kbd
Wartości numeryczne są zdefiniowane przez urządzenie Linux KBD. To są warianty
na oryginalnym zestawie kodów XT, ale często z innym kodowaniem w przypadku rozszerzeń
kody klawiszowe. Nie podano żadnych nazw symbolicznych.

win32
Wartości numeryczne są zdefiniowane przez podsystem wprowadzania klawiatury Win32. The
nazwy symboliczne odpowiadają odpowiednim nazwom makr stałych klucza Win32

usb Wartości numeryczne są zdefiniowane w specyfikacji USB HID dla klawiatury
wejście. Nie podano żadnych nazw symbolicznych

RFB Wartości numeryczne są zdefiniowane przez rozszerzenie RFB do wysyłania surowców
kody klawiszowe. Są to warianty zestawu kodów XT, ale rozszerzone kody klawiszy mają
dolny bit drugiego zestawu bajtów zamiast starszego bitu pierwszego bajtu. NIE
podano nazwy symboliczne.

Przykłady
# wyślij trzy kreski „k”, „e”, „y”, używając zestawu kodów xt. te
# są wciśnięte jednocześnie i mogą zostać odebrane przez gościa
# w kolejności losowej
virsh send-key dom --codeset xt 37 18 21

# wyślij jedno uderzenie „prawy-ctrl+C”
virsh wyślij klucz do domu KEY_RIGHTCTRL KEY_C

# wyślij kartę, przytrzymaną przez 1 sekundę
virsh send-key --holdtime 1000 0xf

wyślij sygnał-procesu identyfikator-domeny Pid znak
Wyślij sygnał znak do procesu identyfikowanego przez Pid działające w domenie wirtualnej
identyfikator-domeny, Pid to identyfikator procesu w przestrzeni nazw domeny wirtualnej.

znak argumentem może być stała liczba całkowita sygnału lub jedna z wartości
nazwy symboliczne:

„nie”, „hup”, „int”, „wyjdź”, „chory”,
„pułapka”, „abrt”, „autobus”, „fpe”, „zabij”,
„usr1”, „segv”, „usr2”, „potok”, „alrm”,
„termin”, „stkflt”, „chld”, „cont”, „stop”,
„tstp”, „ttin”, „ttou”, „urg”, „xcpu”,
"xfsz", "vtalrm", "prof", "wyciągarka", "ankieta",
„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”

Nazwa symbolu może być opcjonalnie poprzedzona przedrostkiem „sig” lub „sig_” i może występować w
wielką lub małą literą.

Przykłady
virsh send-process-signal myguest 1 15
virsh send-process-signal myguest 1 termin
virsh send-process-signal myguest 1 sigterm
virsh send-process-signal myguest 1 SIG_HUP

ustaw pam domena rozmiar [[--konfig] [--na żywo] | [--obecny]]
Zmień przydział pamięci dla domeny gościa. Jeśli --na żywo jest określone, wykonaj a
balon pamięci biegnącego gościa. Jeśli --konfig jest określony, wpływa na następne uruchomienie
stały gość. Jeśli --obecny jest określony, wpływają na bieżący stan gościa. Obydwa
--na żywo oraz --konfig można rozdawać flagi, ale --obecny jest ekskluzywny. Jeśli nie ma flagi
określone, zachowanie jest różne w zależności od hypervisora.

rozmiar jest skalowaną liczbą całkowitą (patrz UWAGI powyżej); domyślnie jest to kibibajty (bloki po 1024
bajtów), chyba że podasz sufiks (i starszą nazwę opcji -- kilobajtów jest dostępne
jako przestarzały synonim). Libvirt zaokrągla w górę do najbliższego kibibajta. Niektóre
hypervisory wymagają większej szczegółowości niż KiB i żądań, które nie są parzyste
wielokrotność zostanie zaokrąglona w górę. Na przykład vSphere/ESX zaokrągla parametr w górę do
mebibajty (1024 kibibajty).

W przypadku Xen możesz dostosować pamięć działającej domeny tylko wtedy, gdy domena jest
parawirtualizowany lub uruchamiający sterownik balonu fotowoltaicznego.

W przypadku LXC ustawiana wartość to wartość cgroups dla limit_in_bytes lub maksimum
ilość pamięci użytkownika (w tym pamięć podręczna plików). Przeglądając pamięć wewnątrz pliku
pojemnik, to jest / proc / meminfo Wartość „MemTotal”. Podczas przeglądania wartości z pliku
gospodarzu, użyj Virsh memtuna Komenda. Aby wyświetlić aktualnie używaną pamięć i
maksymalną wartość dozwoloną do ustawienia pamięci, użyj opcji Virsh Informacje o domowniku dowództwo.

Ustaw hasło użytkownika domena użytkownik password [--zaszyfrowane]
Ustaw hasło dla użytkownik konto w domenie gościnnej.

If --zaszyfrowane zostanie określony, zakłada się, że hasło zostało już zaszyfrowane przez
metoda wymagana przez system operacyjny-gościa.

W przypadku QEMU/KVM wymaga to skonfigurowania i uruchomienia agenta gościa.

ustaw maks. pam domena rozmiar [[--konfig] [--na żywo] | [--obecny]]
Zmień maksymalny limit alokacji pamięci dla domeny gościa. Jeśli --na żywo is
określone, wpływają na działającego gościa. Jeśli --konfig jest określony, wpływa na następne uruchomienie
stały gość. Jeśli --obecny jest określony, wpływają na bieżący stan gościa. Obydwa
--na żywo oraz --konfig można rozdawać flagi, ale --obecny jest ekskluzywny. Jeśli nie ma flagi
określone, zachowanie jest różne w zależności od hypervisora.

Niektóre hypervisory, takie jak QEMU/KVM, nie obsługują zmian na żywo (szczególnie rosnących)
maksymalnego limitu pamięci. Nawet trwałe zmiany konfiguracji mogą nie być
wykonywane z niektórymi hypervisorami/konfiguracją (np. w domenach obsługujących NUMA w QEMU).
W przypadku skomplikowanych zmian konfiguracyjnych użyj polecenia edit zamiast).

rozmiar jest skalowaną liczbą całkowitą (patrz UWAGI powyżej); domyślnie jest to kibibajty (bloki po 1024
bajtów), chyba że podasz sufiks (i starszą nazwę opcji -- kilobajtów jest dostępne
jako przestarzały synonim). Libvirt zaokrągla w górę do najbliższego kibibajta. Niektóre
hypervisory wymagają większej szczegółowości niż KiB i żądań, które nie są parzyste
wielokrotność zostanie zaokrąglona w górę. Na przykład vSphere/ESX zaokrągla parametr w górę do
mebibajty (1024 kibibajty).

memtuna domena [--ograniczenie twarde rozmiar] [--limit miękki rozmiar] [--swap-twardy-limit rozmiar]
[--min-gwarancja rozmiar] [[--konfig] [--na żywo] | [--obecny]]
Umożliwia wyświetlenie lub ustawienie parametrów pamięci domeny. Bez flag, prąd
wyświetlane są ustawienia; z flagą, odpowiedni limit jest dostosowywany, jeśli jest obsługiwany przez
hiperwizor. Obsługa LXC i QEMU/KVM --ograniczenie twarde, --limit miękki,
--swap-twardy-limit. --min-gwarancja jest obsługiwany tylko przez hypervisor ESX. Każdy z
limity te są skalowanymi liczbami całkowitymi (patrz UWAGI powyżej), z wartością domyślną kibibajtów
(bloki po 1024 bajtów), jeśli nie występuje żaden przyrostek. Libvirt zaokrągla w górę do najbliższej wartości
kibibajt. Niektóre hypervisory wymagają większej szczegółowości niż KiB i o to proszą
nie są parzystą wielokrotnością, zostaną zaokrąglone w górę. Na przykład vSphere/ESX zaokrągla
parametr do mebibajtów (1024 kibibajtów).

If --na żywo jest określony, wpływają na działającego gościa. Jeśli --konfig jest określony, wpływa na
następny rozruch stałego gościa. Jeśli --obecny jest określony, wpływają na bieżącego gościa
państwo. Obydwa --na żywo oraz --konfig można rozdawać flagi, ale --obecny jest ekskluzywny. Jeśli nie
flaga jest określona, ​​zachowanie jest różne w zależności od hypervisora.

W przypadku QEMU/KVM parametry są stosowane do całego procesu QEMU. Zatem kiedy
licząc je, należy dodać pamięć RAM gościa, pamięć RAM wideo gościa i trochę pamięci
obciążenie samego QEMU. Ostatni element jest trudny do określenia, więc trzeba zgadywać i
próbować.

W przypadku LXC wyświetlana wartość hard_limit to bieżące ustawienie pamięci z pliku XML lub
wyniki z A Virsh ustaw pam dowództwo.

--ograniczenie twarde
Maksymalna pamięć, z której może skorzystać gość.

--limit miękki
Limit pamięci wymuszany podczas rywalizacji o pamięć.

--swap-twardy-limit
Maksymalna pamięć plus wymiana, z której może skorzystać gość. To musi być więcej niż trudne
podana wartość graniczna.

--min-gwarancja
Gwarantowany minimalny przydział pamięci dla gościa.

Podanie -1 jako wartości tych limitów jest interpretowane jako nieograniczone.

blkiotune domena [--waga waga] [--wagi urządzeń wagi urządzeń]
[--device-read-iops-sec urządzenie-odczyt-iops-sec] [--device-write-iops-sec urządzenie-zapis-iops-
s] [--urządzenie-odczyt-bajtów-sek urządzenie-odczyt-bajtów-sek] [--urządzenie-zapis-bajtów-sek urządzenie-
zapisu-bajtów-sek] [[--konfig] [--na żywo] | [--obecny]]
Wyświetl lub ustaw parametry blkio. Obsługuje QEMU/KVM --waga. --waga jest w zasięgu
[100, 1000]. Po jądrze 2.6.39 wartość może mieścić się w zakresie [10, 1000].

wagi urządzeń to pojedynczy ciąg znaków zawierający jedną lub więcej par urządzenie/waga w pliku
format /ścieżka/do/urządzenia,waga,/ścieżka/do/urządzenia,waga. Każda waga mieści się w zakresie
[100, 1000], [10, 1000] po jądrze 2.6.39 lub wartość 0, aby usunąć to urządzenie z
listy według urządzenia. Modyfikowane są tylko urządzenia wymienione w ciągu; jakiekolwiek istniejące
wagi poszczególnych urządzeń w przypadku innych urządzeń pozostają niezmienione.

urządzenie-odczyt-iops-sec to pojedynczy ciąg znaków zawierający jedno lub więcej urządzeń/odczyt_iops_sek
pary, int w formacie /path/to/device,read_iops_sec,/path/to/device,read_iops_sec.
Każdy read_iops_sec to liczba typu unsigned int, wartość 0, aby ją usunąć
urządzenie z listy według poszczególnych urządzeń. Modyfikowane są tylko urządzenia wymienione w ciągu;
wszelkie istniejące read_iops_sec dla poszczególnych urządzeń dla innych urządzeń pozostają niezmienione.

urządzenie-zapis-iops-sec to pojedynczy ciąg znaków zawierający jedno lub więcej urządzeń/write_iops_sec
pary, w formacie
/ścieżka/do/urządzenia,zapis_iops_sek.,/ścieżka/do/urządzenia,zapis_iops_sek. Każdy write_iops_sec to
liczba typu unsigned int, wartość 0, aby usunąć to urządzenie z każdego urządzenia
wymienianie kolejno. Modyfikowane są tylko urządzenia wymienione w ciągu; dowolne istniejące urządzenie
write_iops_sec dla pozostałych urządzeń pozostają niezmienione.

urządzenie-odczyt-bajtów-sek to pojedynczy ciąg znaków zawierający jedno lub więcej urządzeń/odczyt_bajtów_s
pary, w formacie
/ścieżka/do/urządzenia,odczyt_bajtów,/ścieżka/do/urządzenia,odczyt_bajtów_sek. Każdy read_bytes_sec to
liczba typu unsigned long long, wartość 0, aby usunąć to urządzenie z per-
lista decyzji. Modyfikowane są tylko urządzenia wymienione w ciągu; wszelkie istniejące
urządzenie read_bytes_sec dla pozostałych urządzeń pozostaje niezmienione.

urządzenie-zapis bajtów-sek to pojedynczy ciąg znaków zawierający jedno lub więcej urządzeń/zapis_bajtów_sek
pary, w formacie
/ścieżka/do/urządzenia,zapis_bajtów_sek.,/ścieżka/do/urządzenia,zapis_bajtów_sek. Każdy zapis_bajtów_sek
to liczba typu unsigned long long, wartość 0 oznacza usunięcie tego urządzenia z per-
lista decyzji. Modyfikowane są tylko urządzenia wymienione w ciągu; wszelkie istniejące
urządzenie write_bytes_sec dla innych urządzeń pozostaje niezmienione.

If --na żywo jest określony, wpływają na działającego gościa. Jeśli --konfig jest określony, wpływa na
następny rozruch stałego gościa. Jeśli --obecny jest określony, wpływają na bieżącego gościa
państwo. Obydwa --na żywo oraz --konfig można rozdawać flagi, ale --obecny jest ekskluzywny. Jeśli nie
flaga jest określona, ​​zachowanie jest różne w zależności od hypervisora.

setvcpus domena liczyć [--maksymalny] [[--konfig] [--na żywo] | [--obecny]] [--Gość]
Zmień liczbę procesorów wirtualnych aktywnych w domenie gościa. Domyślnie to polecenie
działa na aktywnych domenach gościnnych. Aby zmienić ustawienia dla nieaktywnej domeny gościa,
użyć --konfig flag.

liczyć wartość może być ograniczona przez hosta, hypervisora ​​lub limit pochodzący z
oryginalny opis domeny gościa. W przypadku Xen można dostosować tylko tryb wirtualny
Procesory działającej domeny, jeśli domena jest parawirtualna.

Jeśli --konfig flaga, zmiana zostanie dokonana w zapisanej konfiguracji XML
dla domeny gościa i zacznie obowiązywać dopiero po ponownym uruchomieniu domeny gościa.

If --na żywo zostanie określony, domena gościa musi być aktywna i nastąpi zmiana
natychmiast. Oboje --konfig oraz --na żywo flagi mogą być określone razem if
wspierany przez hypervisora. Jeśli to polecenie zostanie uruchomione przed zakończeniem działania gościa
rozruchu, gość może nie przetworzyć zmiany.

If --obecny jest określony, wpływają na bieżący stan gościa.

Jeśli nie podano żadnych flag, --na żywo zakładana jest flaga i domena gościa musi być
aktywny. W tej sytuacji od hiperwizora zależy, czy plik --konfig flaga to
również założono, a zatem czy konfiguracja XML jest dostosowana do
zmiana trwała.

If --Gość zostanie określony, wówczas liczba procesorów zostanie zmodyfikowana w gościu zamiast
hiperwizor. Tej flagi można używać tylko w przypadku aktywnych domen i może wymagać agenta-gościa
do skonfigurowania w gościu.

--maksymalny flaga kontroluje maksymalną liczbę wirtualnych procesorów, które można podłączyć podczas pracy
przy następnym uruchomieniu domeny. W związku z tym należy go używać wyłącznie z --konfig
flagę, a nie z --na żywo albo --obecny flag.

zamknięcie domena [--tryb LISTA TRYBÓW]
Łagodnie zamyka domenę. To koordynuje się z systemem operacyjnym domeny do wykonania
łagodne zamknięcie, więc nie ma gwarancji, że się powiedzie i może zająć trochę czasu
zmienny czas w zależności od tego, jakie usługi muszą zostać zamknięte w domenie.

Dokładne zachowanie domeny po jej zamknięciu jest ustalane przez on_wyłączenie parametr
w definicji XML domeny.

If domena jest przejściowy, wówczas metadane wszelkich migawek zostaną utracone po wejściu gościa
przestaje działać, ale zawartość migawki nadal istnieje i nowa domena z nią
name i UUID mogą przywrócić metadane migawki tworzenie migawki.

Domyślnie hypervisor spróbuje wybrać odpowiednią metodę zamknięcia. Aby określić
metoda alternatywna, tj --tryb Parametr może określić listę oddzieloną przecinkami, która
obejmuje „acpi”, „agent”, „initctl”, „sygnał” i „parawirt”. Kolejność, w jakiej
sterowniki będą próbowały, każdy tryb jest niezdefiniowany i nie jest powiązany z określoną kolejnością
virsz. Aby uzyskać ścisłą kontrolę nad kolejnością, używaj pojedynczego trybu na raz i powtarzaj
dowództwo.

początek nazwa-domeny-lub-uuid [--konsola] [--pauza] [--samozniszczenie] [--bypass-cache]
[--force-boot] [--pass-fds N, M,...]
Uruchom (wcześniej zdefiniowaną) nieaktywną domenę, albo od ostatniej udało się zapisać stan,
lub poprzez nowy rozruch, jeśli nie ma stanu zarządzanego zapisu. Domena zostanie wstrzymana, jeśli
dotychczasowy --pauza opcja jest używana i obsługiwana przez sterownik; w przeciwnym razie będzie działać.
If --konsola zostanie wyświetlony monit, dołącz do konsoli po utworzeniu. Jeśli --samozniszczenie is
zażądano, wówczas gość zostanie automatycznie zniszczony, gdy virsh zamknie swoje
połączenie z libvirt lub w inny sposób kończy działanie. Jeśli --bypass-cache jest określony, oraz
ManagedSave istnieje, przywrócenie pozwoli uniknąć pamięci podręcznej systemu plików, chociaż jest to możliwe
może spowolnić operację. Jeśli --force-boot zostanie określony, a następnie dowolny stan zarządzanego zapisu
zostaje odrzucony i następuje nowy rozruch.

If --pass-fds jest określony, argumentem jest lista otwartych plików rozdzielonych przecinkami
deskryptory, które należy przekazać gościowi. Deskryptory plików zostaną ponownie
numerowane w gościu, zaczynając od 3. Jest to obsługiwane tylko w przypadku kontenerów
wirtualizacja.

zawieszać domena
Zawieś działającą domenę. Jest przechowywany w pamięci, ale nie będzie już planowany.

CV domena
Przenosi domenę ze stanu zawieszenia. Umożliwi to wcześniej zawieszone
domena, aby teraz kwalifikowała się do planowania przez bazowy hypervisor.

dommmsuspend domena cel [--Trwanie]
Zawieś działającą domenę w jednym z tych stanów (możliwe cel wartości):
mem odpowiednik stanu S3 ACPI
dyskowy odpowiednik stanu S4 ACPI
hybrydowa pamięć RAM jest zapisywana na dysku, ale nie jest wyłączana

--Trwanie argument określa liczbę sekund zanim domena zostanie wybudzona
po jego zawieszeniu (zob przebudzenie). Wartość domyślna to 0 dla nieograniczonego zawieszenia
czas. (Ta funkcja nie jest obecnie obsługiwana przez żaden sterownik hypervisora ​​i powinna być ustawiona na 0
używany.).

Pamiętaj, że to polecenie wymaga skonfigurowania i uruchomienia agenta gościa w domenie
system operacyjny gościa.

Uważaj, że przynajmniej w przypadku QEMU proces domeny zostanie zakończony, gdy będzie docelowy
dysk jest używany i nowy proces zostanie uruchomiony, gdy libvirt zostanie poproszony o wybudzenie
domena. W wyniku tego wszelkie zmiany w czasie wykonywania, takie jak hotplug urządzenia lub pamięć
ustawienia zostaną utracone, chyba że dokonano takich zmian za pomocą programu --konfig flag.

przebudzenie domena
Obudź domenę ze stanu pmsuspended (zawieszona przez dommsuspend lub ze stanu
sam gość). Raczej pobudza gościa, który jest w stanie zawieszonym
niż oczekiwanie na upłynięcie wcześniej żądanego czasu trwania (jeśli taki istnieje). Ta operacja
niekoniecznie kończy się niepowodzeniem, jeśli domena działa.

ttykonsola domena
Wyprowadź urządzenie używane dla konsoli TTY domeny. Jeśli nie ma informacji
dostępne, procesy zapewnią kod zakończenia równy 1.

niezdefiniowany domena [--zarządzane-zapisywanie] [--migawki-metadane] [--nwram] [ {--składowanie kłęby |
--usuń całą pamięć [--usuń-migawki]} --wyczyść-przechowywanie]
Usuń definicję domeny. Jeśli domena jest uruchomiona, powoduje to jej przekształcenie w domenę przejściową,
bez zatrzymywania tego. Jeśli domena jest nieaktywna, konfiguracja domeny zostanie usunięta.

--zarządzane-zapisywanie flag gwarantuje, że każdy zarządzany obraz zapisu (zobacz plik udało się zapisać
polecenie) jest również czyszczone. Bez flagi następuje próba ponownego zdefiniowania domeny za pomocą a
zarządzane zapisanie obrazu zakończy się niepowodzeniem.

--migawki-metadane flag gwarantuje, że wszelkie migawki (patrz plik lista migawek
polecenie) są również czyszczone w przypadku anulowania definicji nieaktywnej domeny. Bez flagi,
próby cofnięcia definicji nieaktywnej domeny za pomocą metadanych migawki nie powiodą się. Jeśli
domena jest aktywna, ta flaga jest ignorowana.

--nwram flaga gwarantuje, że żaden plik nvram (/domain/os/nvram/) nie zostanie pozostawiony. Jeśli
domena ma plik nvram i flaga zostanie pominięta, opcja undefine zakończy się niepowodzeniem.

--składowanie flaga przyjmuje parametr kłęby, która jest listą rozdzieloną przecinkami
nazwy docelowe woluminów lub ścieżki źródłowe woluminów pamięci, które mają zostać usunięte wraz z
niezdefiniowana domena. Woluminy mogą być niezdefiniowane i tym samym usuwane tylko w nieaktywnych domenach.
Próba usunięcia woluminu jest podejmowana dopiero wtedy, gdy domena jest niezdefiniowana; jeśli nie wszystkie
żądane woluminy można usunąć, komunikat o błędzie wskazuje, co jeszcze pozostało
za. Jeśli w definicji domeny nie zostanie znaleziona ścieżka woluminu, jest ona traktowana tak, jakby
wolumen został pomyślnie usunięty. Tylko woluminy zarządzane przez libvirt w pulach pamięci mogą to zrobić
zostać usunięty w ten sposób. (Widzieć lista domblk aby wyświetlić listę nazw docelowych powiązanych z a
domena). Przykład: --storage vda,/path/to/storage.img

--usuń całą pamięć flaga określa, że ​​wszystkie woluminy pamięci domeny
należy usunąć.

--usuń-migawki flaga określa, że ​​wszystkie migawki powiązane z magazynem
należy również usunąć wolumin. Wymaga --usuń całą pamięć flaga być
pod warunkiem, że. Nie wszystkie sterowniki pamięci masowej obsługują tę opcję, obecnie tylko rbd.

Flaga --wyczyść-przechowywanie określa, że ​​woluminy pamięci powinny zostać wcześniej wyczyszczone
usuwanie.

UWAGA: W przypadku nieaktywnej domeny należy użyć nazwy domeny lub UUID domena.

vcpucount domena [{--maksymalny | --aktywny} {--konfig | --na żywo | --obecny}] [--Gość]
Wydrukuj informację o liczbie procesorów wirtualnych podanego domena. Jeśli nie ma flag
określony, wszystkie możliwe liczby są wymienione w tabeli; w przeciwnym razie wydajność jest ograniczona
tylko do żądanej wartości liczbowej. Ze względów historycznych w tabeli wymieniono
etykietę „bieżący” w wierszach, które można odpytywać oddzielnie za pomocą metody --aktywny flaga,
a nie odnosić się do --obecny flag.

--maksymalny żąda informacji na temat maksymalnego limitu vcpus, który domena może dodać za pośrednictwem
setvcpus, podczas --aktywny pokazuje aktualne wykorzystanie; te dwie flagi nie mogą być obie
określony. --konfig wymaga stałej domeny i żąda informacji dot
przy następnym uruchomieniu domeny, --na żywo wymaga działającej domeny i list
aktualne wartości i --obecny zapytań zgodnie z aktualnym stanem domeny
(odpowiadającej --na żywo jeśli biegasz, lub --konfig jeśli nieaktywne); te trzy flagi są
wzajemnie się wykluczające.

If --Gość jest określony, wówczas liczba procesorów jest raportowana z perspektywy
gość. Tej flagi można używać tylko w przypadku aktywnych domen i może wymagać obecności agenta-gościa
skonfigurowane w gościu.

vcpuinformacje domena [--piękny]
Zwraca podstawowe informacje o wirtualnych procesorach domeny, takie jak liczba procesorów wirtualnych,
czas działania, powinowactwo do procesorów fizycznych.

Wraz z --piękny, powinowactwa procesora są pokazane jako zakresy.

vcpupin domena [procesor] [cpulista] [[--na żywo] [--konfig] | [--obecny]]
Zapytaj lub zmień przypinanie jednostek VCPU domeny do fizycznych procesorów hosta. Aby przypiąć singiel
procesor, podaj cpulista; w przeciwnym razie możesz wysłać zapytanie procesor lub pominąć procesor aby wyświetlić listę wszystkich
pewnego razu.

cpulista to lista numerów fizycznych procesorów. Jego składnia to lista oddzielona przecinkami i a
dozwolone są również specjalne znaczniki z użyciem „-” i „^” (np. „0-4”, „0-3,^2”). „-”
oznacza zakres, a „^” oznacza wyłączność. Do przypinania procesor wszystkim fizycznym
cpus określ „r” jako a cpulista. Jeśli --na żywo jest określony, wpływają na działającego gościa. Jeśli
--konfig jest określony, wpływają na następne uruchomienie stałego gościa. Jeśli --obecny is
określone, wpływają na bieżący stan gościa. Obydwa --na żywo oraz --konfig flagi mogą być
podane jeśli cpulista jest obecny, ale --obecny jest ekskluzywny. Jeśli nie określono żadnej flagi,
zachowanie jest różne w zależności od hypervisora.

Note: Wyrażenie jest oceniane sekwencyjnie, więc „0-15,^8” jest identyczne
„9-14,0-7,15”, ale nie identyczne z „^8,0-15”.

pin emulatora domena [cpulista] [[--na żywo] [--konfig] | [--obecny]]
Zapytaj lub zmień przypinanie wątków emulatora domeny do fizycznych procesorów hosta.

See vcpupin dla cpulista.

If --na żywo jest określony, wpływają na działającego gościa. Jeśli --konfig jest określony, wpływa na
następny rozruch stałego gościa. Jeśli --obecny jest określony, wpływają na bieżącego gościa
państwo. Obydwa --na żywo oraz --konfig flagi mogą zostać przyznane, jeśli cpulista jest obecny, ale
--obecny jest ekskluzywny. Jeśli nie określono żadnej flagi, zachowanie jest różne w zależności od
hiperwizor.

vncwyświetlacz domena
Wyprowadź adres IP i numer portu dla wyświetlacza VNC. Jeśli nie ma informacji
dostępne, procesy zapewnią kod zakończenia równy 1.

DEVICE POLECENIA

Poniższe polecenia manipulują urządzeniami powiązanymi z domenami. The domena może być
określony jako krótka liczba całkowita, nazwa lub pełny identyfikator UUID. Aby lepiej zrozumieć wartości
dozwolone jako opcje polecenia czytającego dokumentację pod adresem
<http://libvirt.org/formatdomain.html> na temat formatu sekcji urządzenia, aby uzyskać
najdokładniejszy zbiór akceptowanych wartości.

urządzenie dołączające domena FILE [[[--na żywo] [--konfig] | [--obecny]] | [--uporczywy]]
Dołącz urządzenie do domeny, korzystając z definicji urządzenia w pliku XML za pomocą urządzenia
element definicji, np Lub jako element najwyższego poziomu. Zobacz
dokumentacja pod adresem <http://libvirt.org/formatdomain.html#elementsDevices>, o których możesz się dowiedzieć
libvirt format XML dla urządzenia. Jeśli --konfig jest określone, polecenie zmienia
trwała konfiguracja domeny z podłączeniem urządzenia, która zacznie obowiązywać następnym razem
libvirt uruchamia domenę. W przypadku urządzeń CD-ROM i dyskietek to polecenie zastępuje tylko
media w istniejącym urządzeniu; rozważ użycie urządzenie-aktualizacyjne dla tego użycia. Dla
urządzenia hosta przejściowego, zobacz także nodedev-odłącz, potrzebne, jeśli urządzenie PCI tego nie robi
użyj trybu zarządzanego.

If --na żywo jest określony, wpływają na działającą domenę. Jeśli --konfig jest określony, wpływa na
kolejne uruchomienie domeny stałej. Jeśli --obecny jest określony, wpływają na prąd
stan domeny. Obydwa --na żywo oraz --konfig można rozdawać flagi, ale --obecny is
Ekskluzywny. Jeśli nie określono żadnej flagi, używany jest starszy interfejs API, którego zachowanie zależy od
sterownik hypervisora.

Dla celów kompatybilności, --uporczywy zachowuje się jak --konfig dla domeny offline,
i lubię --na żywo --konfig dla działającej domeny.

Note: użycie plików XML z częściową definicją urządzenia może prowadzić do nieoczekiwanych rezultatów, jak np
niektóre pola mogą zostać wygenerowane automatycznie i dlatego pasują do urządzeń innych niż oczekiwano.

dołącz dysk domena źródło cel [[[--na żywo] [--konfig] | [--obecny]] | [--uporczywy]]
[--docelowy autobus autobus] [--kierowca kierowca] [--podsterownik podsterownik] [--iwątek i wątek] [--Pamięć podręczna
Pamięć podręczna] [--rodzaj rodzaj] [--tryb tryb] [--rodzaj źródła rodzaj źródła] [--seryjny seryjny] [--wwn ww]
[--rawio] [--adres adres] [--wielofunkcyjny] [--print-xml]
Dołącz nowe urządzenie dyskowe do domeny. źródło to ścieżka do plików i urządzeń.
cel kontroluje magistralę lub urządzenie, pod którym dysk jest udostępniany systemowi gościa. To
wskazuje „logiczną” nazwę urządzenia; opcjonalne autobus docelowy atrybut określa
typ urządzenia dyskowego do emulacji; możliwe wartości są specyficzne dla sterownika i typowe
ceni bycie ide, SCSI, wirtuoz, Xen, usb, satalub sd, jeśli pominięto, typem magistrali jest
wywnioskować ze stylu nazwy urządzenia (np. urządzenie o nazwie „sda” będzie zazwyczaj
eksportować za pomocą magistrali SCSI). kierowca może być filet, dotknij or phy dla hiperwizora Xen
w zależności od rodzaju dostępu; Lub qemu dla emulatora QEMU. Dalsze szczegóły do
sterownik można przekazać za pomocą podsterownik. Dla Xena podsterownik może być aio, natomiast dla QEMU
podsterownik powinien odpowiadać formatowi źródła dysku, np surowy or qkrowa2.
Jeśli zostanie użyta wartość domyślna hypervisora podsterownik nie jest określone. Jednak domyślnie
może nie być poprawne, np. dla QEMU, ponieważ ze względów bezpieczeństwa nie jest to skonfigurowane
wykryć formaty dysków. rodzaj może wskazywać Pon, cdrom or miękki jako alternatywa dla
dysk domyślny, chociaż to użycie zastępuje tylko nośnik w istniejącym dysku wirtualnym
CD-ROM lub stacja dyskietek; rozważ użycie urządzenie-aktualizacyjne zamiast tego do tego zastosowania. tryb mogą
określ dwa konkretne tryby tylko czytać or udostępniane. rodzaj źródła może wskazać typ
źródła (blok|plik) Pamięć podręczna może mieć jedną z opcji: „domyślny”, „brak”, „zapis”,
„zapis zwrotny”, „directsync” lub „niebezpieczny”. i wątek to liczba mieszcząca się w zakresie
domena IOThreads, do których można podłączyć ten dysk (tylko QEMU). seryjny jest serial?
urządzenia dyskowego. ww to nazwa urządzenia dyskowego. surowiec wskazuje, że dysk potrzebuje rawio
zdolność. adres jest adresem urządzenia dyskowego w postaci
pci:domain.bus.slot.function, scsi:controller.bus.unit, ide:controller.bus.unit lub
ccw:cssid.ssid.devno. Urządzenia Virtio-ccw muszą mieć ustawiony identyfikator cssid na 0xfe.
Wielofunkcyjne wskazuje, że określony adres PCI jest adresem wielofunkcyjnego urządzenia PCI.

If --print-xml zostanie określony, wówczas będzie to kod XML dysku, który zostanie podłączony
zamiast tego drukowane.

If --na żywo jest określony, wpływają na działającą domenę. Jeśli --konfig jest określony, wpływa na
kolejne uruchomienie domeny stałej. Jeśli --obecny jest określony, wpływają na prąd
stan domeny. Obydwa --na żywo oraz --konfig można rozdawać flagi, ale --obecny is
Ekskluzywny. Jeśli nie określono żadnej flagi, używany jest starszy interfejs API, którego zachowanie zależy od
sterownik hypervisora.

Dla celów kompatybilności, --uporczywy zachowuje się jak --konfig dla domeny offline,
i lubię --na żywo --konfig dla działającej domeny. Podobnie, --współdzielone jest aliasem dla
--tryb udostępniane.

interfejs dołączania domena rodzaj źródło [[[--na żywo] [--konfig] | [--obecny]] | [--uporczywy]]
[--cel cel] [--prochowiec mac] [--scenariusz scenariusz] [--Model model] [--przychodzące
średnia, szczyt, impuls, dolny poziom] [--wychodzące średnia, szczyt, wybuch] [--zarządzany] [--print-xml]
Dołącz nowy interfejs sieciowy do domeny.

rodzaj może być jednym z:

sieć aby wskazać połączenie poprzez wirtualną sieć libvirt,

most aby wskazać połączenie poprzez urządzenie mostkowe na hoście,

kierować aby wskazać połączenie bezpośrednio z jednym z interfejsów sieciowych hosta lub
mosty,

deweloperzy hostów aby wskazać połączenie przy użyciu przejścia urządzenia PCI na hoście.

źródło wskazuje źródło połączenia. Źródło zależy od typu pliku
berło:

sieć nazwa sieci wirtualnej,

most nazwa urządzenia mostkowego,

kierować nazwa interfejsu lub mostu hosta,

deweloperzy hostów adres PCI interfejsu hosta w formacie
domena:szyna:gniazdo.funkcja.

--cel służy do określenia urządzenia tap/macvtap, z którym będzie łączona domena
źródło. Nazwy zaczynające się od „vnet” są uważane za wygenerowane automatycznie i takie są
wygaszane/regenerowane przy każdym podłączeniu interfejsu.

--prochowiec określa adres MAC interfejsu sieciowego; jeśli adres MAC nie jest
podany, nowy adres zostanie automatycznie wygenerowany (i zapisany w pliku permanent
konfiguracja, jeśli w wierszu poleceń podano „--config”).

--scenariusz służy do określenia ścieżki do niestandardowego skryptu, który ma zostać wywołany podczas dołączania
most - zostanie wywołany zamiast domyślnego skryptu, a nie jako dodatek do niego.
Dotyczy to tylko interfejsów most typ i tylko dla domen Xen.

--Model określa model urządzenia sieciowego, który ma być prezentowany domenie.

--przychodzące oraz --wychodzące kontrolować przepustowość interfejsu. Przynajmniej jeden z
dotychczasowy średni, piętro należy określić parę. Pozostałe dwa szczyt oraz wybuch są opcjonalne,
więc „średnia, szczytowa”, „średnia, impulsowa”, „średnia,,,dolna”, „średnia” i „,,,dolna” to
również legalne. Wartości dla średni, piętro oraz szczyt wyrażane są w kilobajtach na sekundę,
jednocześnie wybuch wyraża się w kilobajtach w pojedynczej serii o godz szczyt prędkość zgodnie z opisem w
dokumentacja sieci XML pod adresemhttp://libvirt.org/formatnetwork.html#elementQoS>.

--zarządzany nadaje się tylko do deweloperzy hostów type i informuje libvirt, że interfejs powinien
być zarządzane, co oznacza odłączanie i ponowne podłączanie od/do hosta przez libvirt.

If --print-xml zostanie określony, wówczas będzie to kod XML interfejsu, który zostanie dołączony
zamiast tego drukowane.

If --na żywo jest określony, wpływają na działającą domenę. Jeśli --konfig jest określony, wpływa na
kolejne uruchomienie domeny stałej. Jeśli --obecny jest określony, wpływają na prąd
stan domeny. Obydwa --na żywo oraz --konfig można rozdawać flagi, ale --obecny is
Ekskluzywny. Jeśli nie określono żadnej flagi, używany jest starszy interfejs API, którego zachowanie zależy od
sterownik hypervisora.

Dla celów kompatybilności, --uporczywy zachowuje się jak --konfig dla domeny offline,
i lubię --na żywo --konfig dla działającej domeny.

Note: opcjonalna wartość docelowa to nazwa urządzenia, które ma zostać utworzone jako back-end
na węźle. Jeśli nie zostanie podany, zostanie utworzone urządzenie o nazwie „vnetN” lub „vifN”.
automatycznie.

odłącz urządzenie domena FILE [[[--na żywo] [--konfig] | [--obecny]] | [--uporczywy]]
Odłączenie urządzenia od domeny wymaga tego samego rodzaju opisów XML co polecenie
urządzenie dołączające. Informacje na temat urządzeń hosta typu passthrough można znaleźć także w artykule ponowne podłączenie węzła, potrzebne, jeśli
urządzenie nie korzysta z trybu zarządzanego.

Note: Dostarczony opis XML urządzenia powinien być tak szczegółowy, jak jego
definicja w domenie XML. Zestaw atrybutów używanych do dopasowania urządzenia to
wewnętrzne dla sterowników. Korzystanie z częściowej definicji lub próba odłączenia urządzenia
który nie jest obecny w domenie XML, ale ma z nią pewne specyficzne atrybuty
który jest obecny, może prowadzić do nieoczekiwanych rezultatów.

If --na żywo jest określony, wpływają na działającą domenę. Jeśli --konfig jest określony, wpływa na
kolejne uruchomienie domeny stałej. Jeśli --obecny jest określony, wpływają na prąd
stan domeny. Obydwa --na żywo oraz --konfig można rozdawać flagi, ale --obecny is
Ekskluzywny. Jeśli nie określono żadnej flagi, używany jest starszy interfejs API, którego zachowanie zależy od
sterownik hypervisora.

Dla celów kompatybilności, --uporczywy zachowuje się jak --konfig dla domeny offline,
i lubię --na żywo --konfig dla działającej domeny.

Zauważ, że używane były starsze wersje virsh --konfig jako alias dla --uporczywy.

odłącz dysk domena cel [[[--na żywo] [--konfig] | [--obecny]] | [--uporczywy]]
Odłącz urządzenie dyskowe od domeny. The cel to urządzenie widziane z domeny.

If --na żywo jest określony, wpływają na działającą domenę. Jeśli --konfig jest określony, wpływa na
kolejne uruchomienie domeny stałej. Jeśli --obecny jest określony, wpływają na prąd
stan domeny. Obydwa --na żywo oraz --konfig można rozdawać flagi, ale --obecny is
Ekskluzywny. Jeśli nie określono żadnej flagi, używany jest starszy interfejs API, którego zachowanie zależy od
sterownik hypervisora.

Dla celów kompatybilności, --uporczywy zachowuje się jak --konfig dla domeny offline,
i lubię --na żywo --konfig dla działającej domeny.

Zauważ, że używane były starsze wersje virsh --konfig jako alias dla --uporczywy.

odłącz interfejs domena rodzaj [--prochowiec mac] [[[--na żywo] [--konfig] | [--obecny]] |
[--uporczywy]]
Odłącz interfejs sieciowy od domeny. rodzaj może być sieć wskazać
fizyczne urządzenie sieciowe lub most aby wskazać most do urządzenia. To jest zalecane
używać mac opcja rozróżnienia interfejsów, jeśli jest ich więcej niż jeden
obecny w domenie.

If --na żywo jest określony, wpływają na działającą domenę. Jeśli --konfig jest określony, wpływa na
kolejne uruchomienie domeny stałej. Jeśli --obecny jest określony, wpływają na prąd
stan domeny. Obydwa --na żywo oraz --konfig można rozdawać flagi, ale --obecny is
Ekskluzywny. Jeśli nie określono żadnej flagi, używany jest starszy interfejs API, którego zachowanie zależy od
sterownik hypervisora.

Dla celów kompatybilności, --uporczywy zachowuje się jak --konfig dla domeny offline,
i lubię --na żywo --konfig dla działającej domeny.

Zauważ, że używane były starsze wersje virsh --konfig jako alias dla --uporczywy.

urządzenie-aktualizacyjne domena filet [--siła] [[[--na żywo] [--konfig] | [--obecny]] | [--uporczywy]]
Zaktualizuj charakterystykę urządzenia powiązanego z domena, w zależności od urządzenia
definicja w formacie XML filet, --siła opcję można wykorzystać do wymuszenia aktualizacji urządzenia,
np. aby wysunąć CD-ROM, nawet jeśli jest on zablokowany/zamontowany w domenie. Zobacz
dokumentacja pod adresem <http://libvirt.org/formatdomain.html#elementsDevices>, o których możesz się dowiedzieć
libvirt format XML dla urządzenia.

If --na żywo jest określony, wpływają na działającą domenę. Jeśli --konfig jest określony, wpływa na
kolejne uruchomienie domeny stałej. Jeśli --obecny jest określony, wpływają na prąd
stan domeny. Obydwa --na żywo oraz --konfig można rozdawać flagi, ale --obecny is
Ekskluzywny. Nieokreślenie żadnej flagi jest równoznaczne z określeniem --obecny.

Dla celów kompatybilności, --uporczywy zachowuje się jak --konfig dla domeny offline,
i lubię --na żywo --konfig dla działającej domeny.

Zauważ, że używane były starsze wersje virsh --konfig jako alias dla --uporczywy.

Note: użycie plików XML z częściową definicją urządzenia może prowadzić do nieoczekiwanych rezultatów, jak np
niektóre pola mogą zostać wygenerowane automatycznie i dlatego pasują do urządzeń innych niż oczekiwano.

zmień media domena ścieżka [--wyrzucać] [--wstawić] [--aktualizacja] [źródło] [--siła] [[--na żywo]
[--konfig] | [--obecny]] [--print-xml] [--blok]
Zmień nośnik CDROM lub stację dyskietek. ścieżka może być w pełni kwalifikowaną ścieżką lub
unikalna nazwa celu ( ) urządzenia dyskowego. źródło określa ścieżkę
nośnika, który ma zostać wstawiony lub zaktualizowany. Flaga --blok pozwala ustawić typ podkładu
w przypadku, gdy urządzenie blokowe jest używane jako nośnik CDROM lub stacji dyskietek zamiast pliku.

--wyrzucać wskazuje, że nośnik zostanie wysunięty. --wstawić wskazuje, że media będą
włożony źródło należy określić. Jeśli urządzenie ma źródło (np
plik='media'>) i źródło nie jest określony, --aktualizacja jest równe --wyrzucać, Jeśli
urządzenie nie ma źródła i źródło jest specyficzne, --aktualizacja jest równe --wstawić, Jeśli
urządzenie ma źródło i źródło jest specyficzne, --aktualizacja zachowuje się jak kombinacja
--wyrzucać oraz --wstawić. Jeśli żaden z --wyrzucać, --wstawić, --aktualizacja jest specyficzne,
--aktualizacja jest używany domyślnie. The --siła tej opcji można użyć do wymuszenia zmiany nośnika.
If --na żywo jest określony, zmień bieżącą konfigurację działającego gościa. Jeśli --konfig is
określony, zmień trwałą konfigurację, efekt zaobserwowano przy następnym uruchomieniu. --obecny
może być jedno lub oba relacja na żywo oraz config, zależy od implementacji hypervisora.
Obie --na żywo oraz --konfig można rozdawać flagi, ale --obecny jest ekskluzywny. Jeśli nie ma flagi
określone, zachowanie jest różne w zależności od hypervisora. Jeśli --print-xml is
określony, zamiast zmieniać, drukowany jest kod XML, który byłby używany do zmiany nośnika
media.

WĘZEŁODCH POLECENIA

Poniższe polecenia manipulują urządzeniami hosta, do których mają być przekazywane
domeny gościnne za pośrednictwem elementy w domenie Sekcja. Klucz urządzenia węzła
jest zwykle określany przez nazwę magistrali, po której następuje jej adres, z użyciem podkreśleń pomiędzy nimi
wszystkie komponenty, takie jak pci_0000_00_02_1, usb_1_5_3 lub net_eth1_00_27_13_6a_fe_00. The
lista węzłów podaje pełną listę urządzeń hostów znanych libvirt, chociaż to
obejmuje urządzenia, których nie można przypisać do gościa (na przykład próba odłączenia
Urządzenie PCI sterujące kontrolerem dysku twardego hosta, na którym gromadzone są obrazy dysków gościa
live może spowodować zablokowanie lub ponowne uruchomienie systemu hosta).

Aby uzyskać więcej informacji na temat definicji urządzenia węzła, zobacz:http://libvirt.org/formatnode.html>.

Urządzenia przejściowe nie mogą być jednocześnie używane przez hosta i jego domeny gościnne, ani też
przez wielu aktywnych gości jednocześnie. Jeśli zawiera opis urządzenia PCI
atrybut udało się='tak', a sterownik hypervisora ​​go obsługuje, oznacza to, że urządzenie jest włączone
trybie zarządzanym i próby użycia tego urządzenia przejściowego w aktywnym gościu zostaną wykonane
automatycznie zachowuje się tak, jakby nodedev-odłącz (uruchomienie gościa, możliwość podłączenia urządzenia podczas pracy) i nodedev-
ponownie załączyć (przystanek dla gości, odłączenie urządzenia podczas pracy) zostały wywołane we właściwych punktach. Jeśli urządzenie PCI
nie jest oznaczony jako zarządzany, należy go ręcznie odłączyć, zanim goście będą mogli z niego korzystać, oraz
ręcznie ponownie podłączony w celu zwrócenia go hostowi. Ponadto, jeśli urządzenie zostanie odłączone ręcznie,
wtedy host nie odzyska kontroli nad urządzeniem bez ponownego podłączenia, nawet jeśli
goście korzystają z urządzenia w trybie zarządzanym.

nodedev — utwórz FILE
Utwórz urządzenie w węźle hosta, które można następnie przypisać do maszyn wirtualnych.
Zwykle libvirt jest w stanie automatycznie określić, które węzły hosta są dostępne
do użytku, ale pozwala to na rejestrację sprzętu hosta, czego nie zrobiła libvirt
automatycznie wykryć. filet zawiera XML dla najwyższego poziomu opis A
urządzenie węzłowe.

nodedev-zniszcz urządzenie
Zniszcz (zatrzymaj) urządzenie na hoście. urządzenie może być nazwą urządzenia lub parą wwn
format „wwnn,wwpn” (obecnie działa tylko dla vHBA). Zauważ, że powoduje to zamknięcie libvirt
zarządzanie urządzeniem głównym, a nawet może sprawić, że urządzenie to stanie się bezużyteczne dla reszty
host fizyczny do czasu ponownego uruchomienia.

nodedev-odłącz węzełdev [--kierowca sterownik_zaplecza]
Odłączyć węzełdev od gospodarza, aby goście mogli bezpiecznie z niego korzystać za pośrednictwem
Przejść przez. Jest to odwrócone za pomocą ponowne podłączenie węzłai jest wykonywane automatycznie dla
zarządzane urządzenia. Ze względu na kompatybilność polecenie to można również zapisać
nodedev-odłącz.

Różne sterowniki zaplecza oczekują, że urządzenie będzie powiązane z różnymi urządzeniami fikcyjnymi.
Na przykład sterownik zaplecza „kvm” QEMU (domyślny) oczekuje, że urządzenie zostanie powiązane
do pci-stub, ale jego sterownik zaplecza „vfio” oczekuje, że urządzenie będzie powiązane z vfio-pci.
--kierowca parametru można użyć do określenia żądanego sterownika zaplecza.

nodedev-dumppxml urządzenie
Zrzucić A Reprezentacja XML dla danego urządzenia węzłowego, w tym m.in
informacje takie jak nazwa urządzenia, która magistrala jest właścicielem urządzenia, sprzedawca i identyfikator produktu,
oraz wszelkie możliwości urządzenia, z których może korzystać libvirt (takie jak możliwość resetowania urządzenia
utrzymany). urządzenie może być nazwą urządzenia lub parą wwn w formacie „wwnn,wwpn” (tylko
pracuje dla HBA).

lista węzłów czapka z daszkiem --drzewo
Lista wszystkich urządzeń dostępnych w węźle, które są znane libvirt. czapka z daszkiem służy
aby przefiltrować listę według typów możliwości, typy należy oddzielić przecinkiem, np
--cap pci,scsi, prawidłowe typy możliwości obejmują „system”, „pci”, „urządzenie_usb”, „usb”,
„net”, „scsi_host”, „scsi_target”, „scsi”, „storage”, „fc_host”, „vports”,
„scsi_ogólny”. Jeśli --drzewo jest używany, dane wyjściowe są formatowane w postaci drzewa reprezentującego
rodzice każdego węzła. czapka z daszkiem oraz --drzewo wzajemnie się wykluczają.

ponowne podłączenie węzła węzełdev
Oświadczam, że węzełdev nie jest już używany przez żadnego gościa i gospodarz może go wznowić
normalnego użytkowania urządzenia. Odbywa się to automatycznie w przypadku urządzeń PCI w trybie zarządzanym
i urządzenia USB, ale należy to zrobić jawnie, aby dopasować dowolne jawne nodedev-odłącz.

resetowanie węzła węzełdev
Uruchom reset urządzenia dla węzełdev, przydatne przed przeniesieniem urządzenia węzłowego pomiędzy
przejście gościa lub hosta. Libvirt często wykonuje tę akcję w sposób dorozumiany, gdy
wymagane, ale to polecenie umożliwia jawne resetowanie w razie potrzeby.

VIRTUAL SIEĆ POLECENIA

Poniższe polecenia manipulują sieciami. Libvirt ma możliwość zdefiniowania wirtualnego
sieci, które mogą być następnie wykorzystywane przez domeny i łączone z rzeczywistymi urządzeniami sieciowymi. Aby uzyskać więcej
szczegółowe informacje na temat tej funkcji można znaleźć w dokumentacji pod adresem
<http://libvirt.org/formatnetwork.html> . Wiele poleceń dla sieci wirtualnych to
podobne do tych używanych w domenach, ale sieć wirtualną można nazwać albo przez
jego nazwa lub UUID.

autostart sieci sieć [--wyłączyć]
Skonfiguruj sieć wirtualną tak, aby była automatycznie uruchamiana podczas rozruchu. The --wyłączyć opcja
wyłącz autostart.

tworzenie sieci filet
Utwórz przejściową (tymczasową) sieć wirtualną na podstawie pliku XML filet i utworzyć instancję
(uruchom) sieć. Zobacz dokumentację pod adresemhttp://libvirt.org/formatnetwork.html>
aby uzyskać opis formatu sieciowego XML używanego przez libvirt.

definicja sieci filet
Zdefiniuj nieaktywną trwałą sieć wirtualną lub zmodyfikuj istniejącą trwałą
z XML-a filet.

zniszczyć sieć sieć
Zniszcz (zatrzymaj) daną przejściową lub trwałą sieć wirtualną określoną jej nazwą
lub UUID. To wchodzi w życie natychmiast.

net-dumppxml sieć [--nieaktywny]
Wyprowadź informacje o sieci wirtualnej jako zrzut XML na standardowe wyjście. Jeśli --nieaktywny is
określone, wówczas funkcje fizyczne nie są rozszerzane na powiązane z nimi funkcje wirtualne
funkcje.

edycja sieciowa sieć
Edytuj plik konfiguracyjny XML dla sieci.

Odpowiada to:

virsh net-dumpxml --nieaktywna sieć > sieć.xml
vi network.xml (lub wprowadź zmiany w innym edytorze tekstu)
virsh net-define network.xml

z tą różnicą, że sprawdza pewne błędy.

Używany edytor może być dostarczony przez zmienne środowiskowe $VISUAL lub $EDITOR, oraz
domyślnie „vi”.

wydarzenie sieciowe {[sieć] wydarzenie [--pętla] [--koniec czasu sekund] [--znak czasu] | --lista}
Poczekaj na wystąpienie klasy zdarzeń sieciowych i wydrukuj odpowiednie szczegóły zdarzeń
jak to się dzieje. Zdarzenia można opcjonalnie filtrować według sieć, Za pomocą --lista as
jedyny argument wyświetli listę możliwych wydarzenie wartości znane temu klientowi,
chociaż połączenie może nie umożliwiać rejestracji na wszystkie te wydarzenia.

Domyślnie to polecenie jest jednorazowe i zwraca sukces po wystąpieniu zdarzenia; Ty
może wysłać SIGINT (zwykle przez „Ctrl-C”), aby natychmiast zakończyć. Jeśli --koniec czasu is
określony, polecenie rezygnuje z oczekiwania na zdarzenia po sekund upłynęły. Z
--pętla, polecenie wypisuje wszystkie zdarzenia aż do przekroczenia limitu czasu lub klawisza przerwania.

Kiedy --znak czasu zostanie użyty, przed zdarzeniem zostanie wydrukowany czytelny dla człowieka znacznik czasu.

informacje o sieci sieć
Zwraca podstawowe informacje o sieć obiekt.

lista-sieci [--nieaktywny | --wszystko] { [--Tabela] | --Nazwa | --uid } [--uporczywy]
[<--przejściowe>] [--automatyczny start] [<--brak autostartu>]
Zwraca listę aktywnych sieci, jeśli --wszystko jest określone, będzie to również obejmować
zdefiniowane, ale nieaktywne sieci, if --nieaktywny jest określony, tylko te nieaktywne będą
być wymieniony. Możesz także przefiltrować zwrócone sieci według --uporczywy notować
te trwałe, --przejściowy aby wymienić te przejściowe, --automatyczny start aby wymienić
te z włączoną funkcją autostartu i --brak autostartu aby wyświetlić listę tych z funkcją autostartu
niepełnosprawny.

If --Nazwa zostanie określony, nazwy sieci zostaną wydrukowane zamiast nazw w formacie tabeli
Za linię. Jeśli --uid jest określone, zamiast nazw drukowane są identyfikatory UUID sieci. Flaga
--Tabela określa, że ​​należy użyć starszego wyniku w formacie tabeli. To jest
domyślny. Wszystko to wzajemnie się wyklucza.

UWAGA: Podczas rozmowy ze starszymi serwerami polecenie to wymusza użycie szeregu interfejsów API
wezwania z nieodłączną rasą, w przypadku których pula może nie być wymieniona lub może pojawić się w większej liczbie
niż raz, jeśli zmieniał stan pomiędzy wywołaniami podczas zbierania listy. Nowsza
serwery nie mają tego problemu.

nazwa-sieciowa sieciowy-UUID
Konwertuj identyfikator UUID sieci na nazwę sieci.

start netto sieć
Uruchom (wcześniej zdefiniowaną) nieaktywną sieć.

sieć-nieokreślona sieć
Cofnij zdefiniowanie konfiguracji sieci trwałej. Jeśli sieć jest aktywna, zrób to
przejściowy.

net-uuid Nazwa sieci
Konwertuj nazwę sieci na UUID sieci.

aktualizacja sieci sieć komenda Sekcja xml [--indeks-rodziców wskaźnik] [[--na żywo] [--konfig] |
[--obecny]]
Zaktualizuj daną sekcję istniejącej definicji sieci, wprowadzając zmiany
opcjonalnie ze skutkiem natychmiastowym, bez konieczności niszczenia i ponownego uruchamiania
sieci.

komenda to jedno z następujących słów: „dodaj najpierw”, „dodaj jako ostatni”, „dodaj” (synonim słowa „dodaj jako ostatni”), „usuń”,
lub „zmodyfikuj”.

Sekcja to jeden z „most”, „domena”, „ip”, „ip-dhcp-host”, „ip-dhcp-range”,
„forward”, „interfejs-forward”, „forward-pf”, „grupa portów”, „dns-host”, „dns-txt” lub
„dns-srv”, a nazwa każdej sekcji jest konkatenacją hierarchii elementów XML
co prowadzi do zmiany elementu. Na przykład „ip-dhcp-host” zmieni plik
element zawarty wewnątrz a element wewnątrz elementem
sieci.

xml jest albo tekstem kompletnego elementu xml zmienianego typu (np
"
kompletny element XML. Ujednoznacznienie odbywa się poprzez sprawdzenie pierwszego znaku
podany tekst - jeśli pierwszym znakiem jest "<", jest to tekst XML, jeśli pierwszym znakiem
nie jest „<”, jest to nazwa pliku zawierającego tekst XML, który ma zostać użyty.

--indeks-rodziców Opcja służy do określenia, który z kilku elementów nadrzędnych ma być uwzględniony
żądany element znajduje się w (opartym na 0). Na przykład dhcp element może znajdować się w dowolnym
jeden z wielu elementy w sieci; jeśli nie podano indeksu nadrzędnego,
„najbardziej odpowiedni” element zostanie wybrany (zwykle jedyny, który już
ma element), ale jeśli --indeks-rodziców podany jest ten konkretny przypadek
otrzyma modyfikację.

If --na żywo jest określony, wpływają na działającą sieć. Jeśli --konfig jest określony, wpływa
kolejne uruchomienie trwałej sieci. Jeśli --obecny jest określony, wpływa na
aktualny stan sieci. Obydwa --na żywo oraz --konfig można rozdawać flagi, ale --obecny is
Ekskluzywny. Nieokreślenie żadnej flagi jest równoznaczne z określeniem --obecny.

net-dhcp-leases sieć [mac]
Uzyskaj listę dzierżaw DHCP dla wszystkich interfejsów sieciowych podłączonych do danego wirtualnego
sieć lub ograniczone wyjście tylko dla jednego interfejsu if mac jest specyficzne.

INTERFACE POLECENIA

Poniższe polecenia manipulują interfejsami hosta. Często te interfejsy hosta mogą wtedy
być używane jako nazwa w domenie elementy (takie jak most utworzony przez system
interfejs), ale nie ma wymogu, aby interfejsy hosta były powiązane z żadnym konkretnym
XML konfiguracji gościa w ogóle.

Wiele poleceń dotyczących interfejsów hosta jest podobnych do tych używanych w przypadku domen
sposobem na nazwanie interfejsu jest jego nazwa lub adres MAC. Jednak przy użyciu MAC
adres dla Iface argument działa tylko wtedy, gdy ten adres jest unikalny (jeśli interfejs i
most ma ten sam adres MAC, co często ma miejsce, a następnie używa tego adresu MAC
powoduje błąd z powodu niejednoznaczności i zamiast tego należy odwołać się do nazwy).

mostek iface Interfejs most [--nie-stp] [opóźnienie] [--bez startu]
Utwórz urządzenie mostkowe o nazwie mosti podłącz istniejące urządzenie sieciowe Interfejs
do nowego mostu. Nowy most domyślnie uruchamia się natychmiast, z włączoną funkcją STP
i opóźnienie 0; ustawienia te można zmienić za pomocą --nie-stp, --bez startu, Oraz
całkowita liczba sekund dla opóźnienie. Cała konfiguracja adresu IP Interfejs będzie
przeniesiono do nowego urządzenia mostkowego.

Zobacz też iface-unbridge aby cofnąć tę operację.

definiowanie iface filet
Zdefiniuj nieaktywny trwały interfejs hosta fizycznego lub zmodyfikuj istniejący trwały
jeden z XML filet.

iface-zniszczyć Interfejs
Zniszcz (zatrzymaj) dany interfejs hosta, na przykład uruchamiając polecenie „if-down”, aby go wyłączyć
interfejs z aktywnego użytkowania. To wchodzi w życie natychmiast.

iface-dumppxml Interfejs [--nieaktywny]
Wyprowadź informacje o interfejsie hosta w postaci zrzutu XML na standardowe wyjście. Jeśli --nieaktywny is
określony, wówczas dane wyjściowe odzwierciedlają trwały stan interfejsu, który będzie
użyte przy następnym uruchomieniu.

edycja iface Interfejs
Edytuj plik konfiguracyjny XML dla interfejsu hosta.

Odpowiada to:

virsh iface-dumpxml iface > iface.xml
vi iface.xml (lub wprowadź zmiany w innym edytorze tekstu)
virsh iface — zdefiniuj plik iface.xml

z tą różnicą, że sprawdza pewne błędy.

Używany edytor może być dostarczony przez zmienne środowiskowe $VISUAL lub $EDITOR, oraz
domyślnie „vi”.

lista iface [--nieaktywny | --wszystko]
Zwraca listę aktywnych interfejsów hosta. Jeśli --wszystko jest określone, to również będzie
obejmują zdefiniowane, ale nieaktywne interfejsy. Jeśli --nieaktywny jest określony tylko jako nieaktywny
te zostaną wymienione.

nazwa-iface Interfejs
Konwertuj adres MAC interfejsu hosta na nazwę interfejsu, jeśli adres MAC jest unikalny wśród
interfejsy hosta.

Interfejs określa adres MAC interfejsu.

iface-mac Interfejs
Konwertuj nazwę interfejsu hosta na adres MAC.

Interfejs określa nazwę interfejsu.

iface start Interfejs
Uruchom (wcześniej zdefiniowany) interfejs hosta, na przykład uruchamiając polecenie „if-up”.

iface-unbridge most [--bez startu]
Zniszcz urządzenie mostkowe o nazwie most, zwalniając swój podstawowy interfejs z powrotem do
normalnego użytkowania i przeniesienia całej konfiguracji adresów IP z urządzenia mostkowego do
urządzenie bazowe. Podstawowy interfejs zostanie ponownie uruchomiony, chyba że --bez startu is
obecny; ta flaga jest obecna dla symetrii, ale ogólnie nie jest zalecana.

Zobacz też mostek iface do budowy mostu.

iface-niezdefiniowany Interfejs
Cofnij definicję konfiguracji nieaktywnego interfejsu hosta.

iface-rozpocznij
Utwórz migawkę bieżących ustawień interfejsu hosta, którą można później zatwierdzić
(zatwierdzenie iface) lub przywrócone (iface-wycofanie). Jeśli migawka już istnieje, to to
polecenie nie powiedzie się, dopóki poprzednia migawka nie zostanie zatwierdzona lub przywrócona.
Niezdefiniowane zachowanie skutkuje wprowadzeniem jakichkolwiek zewnętrznych zmian w interfejsach hosta na zewnątrz
interfejsu API libvirt pomiędzy początkiem migawki a jej ostatecznym zatwierdzeniem lub
wycofanie.

zatwierdzenie iface
Zadeklaruj wszystkie zmiany od ostatniej iface-rozpocznij jako działające i usuń wycofanie
punkt. Jeśli nie uruchomiono jeszcze żadnej migawki interfejsu, to polecenie to zrobi
zawieść.

iface-wycofanie
Przywróć wszystkie ustawienia interfejsu hosta do stanu zapisanego ostatnio iface-rozpocznij.
Jeśli nie uruchomiono jeszcze żadnej migawki interfejsu, wykonanie tego polecenia zakończy się niepowodzeniem.
Ponowne uruchomienie hosta służy również jako ukryty punkt wycofania.

MAGAZYNOWANIE POOL POLECENIA

Poniższe polecenia manipulują pulami pamięci. Libvirt ma możliwość zarządzania
różne rozwiązania do przechowywania, w tym pliki, surowe partycje i formaty specyficzne dla domeny,
używane do zapewnienia woluminów pamięci widocznych jako urządzenia w maszynach wirtualnych. Aby uzyskać więcej
szczegółowe informacje na temat tej funkcji można znaleźć w dokumentacji pod adresem
<http://libvirt.org/formatstorage.html> . Wiele poleceń dotyczących pul jest podobnych do
te używane dla domen.

znajdź źródła puli pamięci masowej rodzaj [srcSpec]
Zwraca kod XML opisujący wszystkie możliwe dostępne źródła puli pamięci, które można wykorzystać
aby utworzyć lub zdefiniować pulę pamięci danego rodzaj. Jeśli srcSpec jest zapewnione, jest to
plik zawierający kod XML, aby jeszcze bardziej ograniczyć zapytania dotyczące pul.

Nie wszystkie pule pamięci obsługują wykrywanie w ten sposób. Co więcej, dla tych, którzy to robią
obsługuje wykrywanie, aby zwrócić wartość, wymagane są tylko określone elementy XML
danych, podczas gdy inne elementy, a nawet atrybuty niektórych elementów są ignorowane, ponieważ są one ignorowane
nie są konieczne, aby znaleźć pulę na podstawie kryteriów wyszukiwania. Poniższe listy
obsługiwane rodzaj opcje i oczekiwane minimalne elementy XML użyte do wykonania
sprawdzić.

W przypadku puli „netfs” lub „gluster” minimalny oczekiwany wymagany kod XML to
element z atrybutem „name” opisującym używany adres IP lub nazwę hosta
znajdź basen. Atrybut „port” zostanie zignorowany, podobnie jak każdy inny dostarczony kod XML
elementy w srcSpec.

W przypadku puli „logicznej” zawartość pliku srcSpec plik są ignorowane, chociaż if
pod warunkiem, że plik musi przynajmniej istnieć.

W przypadku puli „iscsi” wymagany minimalny oczekiwany kod XML to element z a
Atrybut „name” opisujący adres IP lub nazwę hosta, która będzie używana do znalezienia puli
(adres serwera iSCSI). Opcjonalnie można jednak podać atrybut „port”.
domyślnie będzie to 3260. Opcjonalnie: an Element XML z „nazwą”
można podać atrybut w celu dalszego ograniczenia wyszukiwania obiektu docelowego iSCSI do określonego
inicjator dla pul pamięci masowej multi-iqn iSCSI.

find-storage-pool-sources-as rodzaj [gospodarz] [Port] [inicjator]
Zamiast dostarczać srcSpec Plik XML dla znajdź źródła puli pamięci masowej użyj tego polecenia
opcję, aby virsh wygenerował plik XML zapytania, korzystając z opcji opcjonalnej
argumenty. Polecenie zwróci ten sam wyjściowy kod XML, co znajdź źródła puli pamięci masowej.

Zastosowanie gospodarz do opisania konkretnego hosta używanego do przechowywania danych w sieci, takiego jak netfs,
gluster i iscsi rodzaj totalizator piłkarski.

Zastosowanie Port aby jeszcze bardziej ograniczyć, który port sieciowy ma być używany do połączenia, jeśli
wymagane przez określone zaplecze pamięci masowej, takie jak iscsi.

Zastosowanie inicjator aby jeszcze bardziej ograniczyć iscsi rodzaj przeszukiwanie puli do określonego celu
inicjatorzy.

autostart basenu basen-lub-uuid [--wyłączyć]
Skonfiguruj, czy basen powinien automatycznie uruchomić się podczas rozruchu.

budowa basenu basen-lub-uuid [--przepisać] [--bez nadpisywania]
Zbuduj zadaną pulę.

Opcje --przepisać oraz --bez nadpisywania może być używany tylko do budowa basenu system plików lub
pula dyskowa. W przypadku puli systemu plików, jeśli nie określono żadnego z nich, budowa basenu sprawia, że
katalog. Jeśli --bez nadpisywania jest określony, sprawdza, czy jest to system plików
już istnieje na urządzeniu docelowym, zwracając błąd, jeśli istnieje, lub używając mkfs
sformatuj urządzenie docelowe, jeśli nie. Jeśli --przepisać jest określony, mkfs jest zawsze wykonywany
a wszelkie istniejące dane na urządzeniu docelowym zostaną bezwarunkowo nadpisane. Na dysk
pula, jeśli żadna z nich nie została określona lub --bez nadpisywania jest specyficzne, budowa basenu będzie
użyj „parted --print”, aby ustalić, czy dysk miał już wcześniej etykietę
próbując taki stworzyć. Etykieta będzie widoczna tylko wtedy, gdy dysk jeszcze jej nie posiada
Utworzony. Jeśli --przepisać jest określony lub stwierdzono, że dysk nie
już go masz, do utworzenia etykiety formatu zostanie użyte polecenie „parted mklabel”.
określony przez typ formatu źródła puli lub „dos”, jeśli nie został określony dla puli.

tworzenie basenu filet [--budować] [[--przepisać] | [--bez nadpisywania]]
Utwórz i uruchom obiekt puli na podstawie pliku XML filet.

[--budować] [[--przepisać] | [--bez nadpisywania]] wykonaj a budowa basenu po utworzeniu w
aby wyeliminować potrzebę wydawania kolejnych poleceń w celu zbudowania puli. The --przepisać
oraz --bez nadpisywania flagi podlegają tym samym zasadom, co flagi budowa basenu. Jeśli tylko --budować is
pod warunkiem budowa basenu nazywa się bez flag.

tworzenie puli jako Nazwa rodzaj [--print-xml] [--host-źródłowy hosta] [--ścieżka-źródłowa ścieżka]
[--źródło-dev ścieżka] [--Nazwa źródła Nazwa] [--cel ścieżka] [--format-źródłowy format]
[--Typ uwierzytelniania Typ uwierzytelniania --auth-nazwa użytkownika nazwa użytkownika --tajne użycie zwyczaj] [[--nazwa-adaptera
Nazwa] | [--adapter-wwnn --adapter-wwpn] [--adapter-rodzic roślina mateczna]] [--budować]
[[--przepisać] | [--bez nadpisywania]]
Utwórz i uruchom obiekt puli Nazwa z surowych parametrów. Jeśli --print-xml is
określony, a następnie wydrukuj kod XML obiektu puli bez tworzenia puli.
W przeciwnym razie pula ma określoną wartość rodzaj. Podczas używania tworzenie puli jako dla puli
rodzaj „dysk”, istniejące partycje znalezione na dysku --źródło-dev ścieżka będzie używany do
zapełnij pulę dyskową. Dlatego sugeruje się użycie zdefiniuj pulę jako oraz basen-
budować z --przepisać w celu prawidłowego zainicjowania puli dyskowej.

[--host-źródłowy hosta] zapewnia źródłową nazwę hosta dla pul wspieranych przez pamięć masową
serwer zdalny (pula typów netfs, iscsi, rbd, Sheepdog, Gluster).

[--ścieżka-źródłowa ścieżka] udostępnia ścieżkę katalogu źródłowego dla pul obsługiwanych przez
katalogi (katalog typu puli).

[--źródło-dev ścieżka] zapewnia ścieżkę źródłową dla pul obsługiwanych przez urządzenia fizyczne
(typy puli fs, logiczna, dyskowa, iscsi, zfs).

[--Nazwa źródła Nazwa] udostępnia nazwę źródłową dla pul obsługiwanych przez magazyn o nazwie
element (typy puli logiczne, rbd, owczarek, gluster).

[--cel ścieżka] to ścieżka mapowania puli pamięci do pliku hosta
pomimo napiętego harmonogramu

[--format-źródłowy format] zawiera informacje o formacie puli (typy puli
fs, netfs, dysk, logiczne).

[--Typ uwierzytelniania Typ uwierzytelniania --auth-nazwa użytkownika nazwa użytkownika --tajne użycie zwyczaj] zapewnia
elementy wymagane do wygenerowania poświadczeń uwierzytelniających dla puli pamięci. The
Typ uwierzytelniania to albo rozdział dla iscsi rodzaj baseny lub ceph dla rbd rodzaj totalizator piłkarski.

[--nazwa-adaptera Nazwa] definiuje nazwę adaptera scsi_hostN, która będzie używana dla hosta_scsi
pula typu adaptera.

[--adapter-wwnn --adapter-wwpn [--adapter-rodzic roślina mateczna]] definiuje wwnn i wwpn to
być używany dla puli typów adapterów fc_host. Rodzic opcjonalnie podaje nazwę
urządzenie węzła scsi_hostN, które ma być używane dla karty vHBA.

[--budować] [[--przepisać] | [--bez nadpisywania]] wykonaj a budowa basenu po utworzeniu w
aby wyeliminować potrzebę wydawania kolejnych poleceń w celu zbudowania puli. The --przepisać
oraz --bez nadpisywania flagi podlegają tym samym zasadom, co flagi budowa basenu. Jeśli tylko --budować is
pod warunkiem budowa basenu nazywa się bez flag.

definicja puli filet
Zdefiniuj nieaktywną pulę pamięci trwałej lub zmodyfikuj istniejącą pulę pamięci trwałej
XML filet.

zdefiniuj pulę jako Nazwa rodzaj [--print-xml] [--host-źródłowy hosta] [--ścieżka-źródłowa ścieżka]
[--źródło-dev ścieżka] [--Nazwa źródła Nazwa] [--cel ścieżka] [--format-źródłowy format]
[--Typ uwierzytelniania Typ uwierzytelniania --auth-nazwa użytkownika nazwa użytkownika --tajne użycie zwyczaj] [[--nazwa-adaptera
Nazwa] | [--adapter-wwnn --adapter-wwpn] [--adapter-rodzic roślina mateczna]]
Utwórz obiekt puli, ale nie rozpoczynaj go Nazwa z surowych parametrów. Jeśli --print-xml
zostanie określony, a następnie wydrukuj kod XML obiektu puli bez definiowania puli.
W przeciwnym razie pula ma określoną wartość rodzaj.

Użyj tych samych argumentów co tworzenie puli jako, Z wyjątkiem --budować, --przepisać,
--bez nadpisywania opcje.

zniszczenie basenu basen-lub-uuid
Zniszcz (zatrzymaj) dany basen obiekt. Libvirt nie będzie już zarządzać pamięcią masową
opisane przez obiekt puli, ale surowe dane zawarte w puli nie ulegają zmianie,
i można je później odzyskać tworzenie basenu.

usuwanie puli basen-lub-uuid
Zniszcz zasoby wykorzystywane przez danego basen obiekt. Tej operacji nie można odzyskać.
basen obiekt będzie nadal istniał po tym poleceniu, gotowy do utworzenia nowego
woluminy magazynowe.

basen-dumppxml [--nieaktywny] basen-lub-uuid
Zwraca informacje XML na temat basen obiekt. --nieaktywny każe virshowi zrzucić
konfiguracja puli, która będzie używana przy następnym uruchomieniu puli, w przeciwieństwie do
bieżąca konfiguracja puli.

edycja basenu basen-lub-uuid
Edytuj plik konfiguracyjny XML dla puli pamięci.

Odpowiada to:

virsh basen-dumpxml basen > basen.xml
vi Pool.xml (lub wprowadź zmiany w innym edytorze tekstu)
virsh — zdefiniuj pulę.xml

z tą różnicą, że sprawdza pewne błędy.

Używany edytor może być dostarczony przez zmienne środowiskowe $VISUAL lub $EDITOR, oraz
domyślnie „vi”.

Informacje o basenie basen-lub-uuid
Zwraca podstawowe informacje o basen obiekt.

lista basenów [--nieaktywny] [--wszystko] [--uporczywy] [--przejściowy] [--automatyczny start] [--brak autostartu]
[[--Detale] [ ]
Lista obiektów puli znanych libvirt. Domyślnie na liście wyświetlane są tylko aktywne pule;
--nieaktywny wyświetla tylko nieaktywne pule i --wszystko wyświetla listę wszystkich basenów.

Ponadto istnieje kilka zestawów flag filtrujących. --uporczywy jest sporządzenie listy
trwałe baseny, --przejściowy jest wyświetlenie listy pul przejściowych. --automatyczny start wyświetla listę
baseny z automatycznym uruchamianiem, --brak autostartu wyświetla listę basenów z wyłączonym automatycznym uruchamianiem.

Możesz także chcieć wyświetlić listę pul z określonymi typami, używając rodzaj, typy puli muszą
być oddzielone przecinkiem, np. --type katalog,dysk. Prawidłowe typy pul to „dir”, „fs”,
„netfs”, „logiczny”, „dysk”, „iscsi”, „scsi”, „mpath”, „rbd”, „sheepdog” i „gluster”.

--Detale opcja instruuje virsha, aby dodatkowo wyświetlał trwałość puli i
informacje dotyczące przepustowości, jeśli są dostępne.

UWAGA: Podczas rozmowy ze starszymi serwerami polecenie to wymusza użycie szeregu interfejsów API
wezwania z nieodłączną rasą, w przypadku których pula może nie być wymieniona lub może pojawić się w większej liczbie
niż raz, jeśli zmieniał stan pomiędzy wywołaniami podczas zbierania listy. Nowsza
serwery nie mają tego problemu.

nazwa-basenu uuid
przekonwertować uuid do nazwy basenu.

odświeżanie basenu basen-lub-uuid
Odśwież listę woluminów zawartych w basen.

start basenu basen-lub-uuid [--budować] [[--przepisać] | [--bez nadpisywania]]
Uruchom magazyn basen, który jest wcześniej zdefiniowany, ale nieaktywny.

[--budować] [[--przepisać] | [--bez nadpisywania]] wykonaj a budowa basenu przed start basenu
aby upewnić się, że środowisko puli jest w oczekiwanym stanie, zamiast konieczności uruchamiania
polecenie kompilacji przed uruchomieniem. The --przepisać oraz --bez nadpisywania flagi podążają za
takie same zasady jak budowa basenu. Jeśli tylko --budować jest zatem zapewnione budowa basenu nazywa się z
żadnych flag.

Note: Pula pamięci oparta na zasobach zdalnych, takich jak „iscsi” lub (v)HBA
Kopiowana pula „scsi” może wymagać wielokrotnego odświeżenia, aby mieć wszystkie pliki
wykryte woluminy (patrz odświeżanie basenu). Dzieje się tak dlatego, że odpowiednie urządzenia głośności
może nie być obecny w systemie plików hosta podczas początkowego uruchamiania puli lub
bieżąca próba odświeżenia. Liczba ponownych prób odświeżenia zależy od sieci
połączenie i czas potrzebny hostowi na wyeksportowanie odpowiednich urządzeń.

basen-nieokreślony basen-lub-uuid
Usuń zdefiniowanie konfiguracji dla nieaktywnego basen.

basen-uuid basen
Zwraca UUID nazwanego basen.

TOM POLECENIA

vol-utwórz basen-lub-uuid FILE [--prealloc-metadane]
Utwórz wolumin z pliku XML . basen-lub-uuid to nazwa lub UUID magazynu
pula, w której chcesz utworzyć wolumin. FILE jest XML z definicją objętości. Jakiś
łatwy sposób na utworzenie pliku XML jest użycie vol-dumppxml polecenie uzyskania
definicja istniejącej objętości. [--prealloc-metadane] wstępnie przydziel metadane (dla
qcow2, które nie obsługują pełnej alokacji). Ta opcja tworzy rzadki obraz
plik z metadanymi, co skutkuje wyższą wydajnością w porównaniu do obrazów bez
wstępna alokacja i tylko nieznacznie wyższe początkowe wykorzystanie miejsca na dysku.

Przykład

virsh vol-dumpxml --pool Storagepool1 appvolume1 > newvolume.xml
vi newvolume.xml (lub wprowadź zmiany w innym edytorze tekstu)
virsh vol-utwórz różną pulę pamięci masowej nowy wolumen.xml

vol-utwórz-z basen-lub-uuid FILE [--pula wejściowa basen-lub-uuid] nazwa-vol lub klucz lub ścieżka
[--prealloc-metadane] [-- reflink]
Utwórz wolumin, używając innego woluminu jako danych wejściowych. basen-lub-uuid to nazwa lub UUID
pulę pamięci, w której ma zostać utworzony wolumen. FILE jest XML z głośnością
definicja. --pula wejściowa basen-lub-uuid to nazwa lub identyfikator UUID puli pamięci
głośność źródłowa jest włączona. nazwa-vol lub klucz lub ścieżka to nazwa, klucz lub ścieżka źródła
tom. [--prealloc-metadane] wstępnie przydziel metadane (dla obrazów qcow2, które tego nie robią
wspierać pełną alokację). Ta opcja tworzy plik obrazu rzadkiego z metadanymi,
co skutkuje wyższą wydajnością w porównaniu do obrazów bez wstępnej alokacji i tylko
nieco wyższe początkowe zużycie miejsca na dysku. Gdy -- reflink jest określony, wykonaj COW
kopia uproszczona, w której bloki danych są kopiowane tylko po modyfikacji. Jeśli tak nie jest
możliwe, kopia nie powiedzie się.

vol-utwórz-as basen-lub-uuid Nazwa Pojemność [--przydział rozmiar] [--format ciąg]
[--backing-t nazwa-vol lub klucz lub ścieżka] [--backing-vol-format ciąg]
[--prealloc-metadane]
Utwórz wolumin na podstawie zestawu argumentów. basen-lub-uuid to nazwa lub UUID pliku
pula pamięci, w której chcesz utworzyć wolumin. Nazwa to nazwa nowego tomu. Na dysk
puli, musi ona odpowiadać nazwie partycji określonej na podstawie urządzenia źródłowego puli
ścieżkę i następną dostępną partycję. Na przykład ścieżka urządzenia źródłowego /dev/sdb
i na dysku nie ma żadnych partycji, wówczas nazwą musi być sdb1, a następna nazwa musi być sdbXNUMX
będąc sdb2 i tak dalej. Pojemność to rozmiar woluminu, który ma zostać utworzony, jako skalowany
liczba całkowita (patrz UWAGI powyżej), domyślnie bajty, jeśli nie ma przyrostka. --przydział
rozmiar to początkowy rozmiar, który ma zostać przydzielony w wolumenie, również jako skalowana liczba całkowita
domyślnie bajty. --format ciąg jest używany w pulach pamięci opartych na plikach do określenia
format pliku woluminu, którego należy użyć; surowy, bochs, qcow, qcow2, vmdk, qed. Użyj rozszerzonego dla
pule pamięci dyskowej w celu utworzenia partycji rozszerzonej (inne wartości obowiązują
zaznaczone, ale nie zachowane po ponownym uruchomieniu libvirtd lub odświeżeniu puli).
--backing-t nazwa-vol lub klucz lub ścieżka to źródłowy wolumin podkładowy, który ma zostać użyty, jeśli
wykonanie migawki istniejącego woluminu. --backing-vol-format ciąg jest formatem
wolumin kopii zapasowej migawki; raw, bochs, qcow, qcow2, qed, vmdk, urządzenie_hosta. Te
są jednak przeznaczone dla pul pamięci opartych na plikach. [--prealloc-metadane] wstępnie przydzielić
metadane (dla obrazów qcow2, które nie obsługują pełnej alokacji). Ta opcja tworzy
rozrzedzony plik obrazu z metadanymi, co zapewnia wyższą wydajność w porównaniu z obrazami
bez wstępnej alokacji i tylko nieznacznie wyższe początkowe wykorzystanie miejsca na dysku.

klon-vol [--basen basen-lub-uuid] nazwa-vol lub klucz lub ścieżka Nazwa [--prealloc-metadane]
[-- reflink]
Sklonuj istniejący wolumin. Mniej wydajna, ale łatwiejsza do pisania wersja vol-stwórz-
od. --basen basen-lub-uuid to nazwa lub UUID puli pamięci, w której chcesz utworzyć
głośność w. nazwa-vol lub klucz lub ścieżka to nazwa, klucz lub ścieżka woluminu źródłowego.
Nazwa to nazwa nowego tomu. [--prealloc-metadane] wstępnie przydziel metadane (dla
qcow2, które nie obsługują pełnej alokacji). Ta opcja tworzy rzadki obraz
plik z metadanymi, co skutkuje wyższą wydajnością w porównaniu do obrazów bez
wstępna alokacja i tylko nieznacznie wyższe początkowe wykorzystanie miejsca na dysku. Gdy -- reflink is
określony, wykonaj uproszczoną kopię COW, w której bloki danych są kopiowane tylko wtedy, gdy
zmodyfikowany. Jeśli nie jest to możliwe, kopiowanie nie powiedzie się.

usuwanie-vol [--basen basen-lub-uuid] nazwa-vol lub klucz lub ścieżka [--usuń-migawki]
Usuń dany wolumin. --basen basen-lub-uuid to nazwa lub UUID puli pamięci
głośność jest włączona. nazwa-vol lub klucz lub ścieżka to nazwa, klucz lub ścieżka woluminu do
kasować.

--usuń-migawki flaga określa, że ​​wszystkie migawki powiązane z magazynem
należy również usunąć wolumin. Nie wszystkie sterowniki pamięci masowej obsługują tę opcję,
obecnie tylko rbd.

przesyłanie obj [--basen basen-lub-uuid] [--zrównoważyć bajtów] [--długość bajtów] nazwa-vol lub klucz lub ścieżka
plik-lokalny
Prześlij zawartość plik-lokalny do woluminu pamięci. --basen basen-lub-uuid jest
nazwa lub UUID puli pamięci, w której znajduje się wolumen. nazwa-vol lub klucz lub ścieżka jest
nazwa lub klucz lub ścieżka woluminu, do którego plik zostanie przesłany. --zrównoważyć jest
pozycję w wolumenie pamięci, od której należy rozpocząć zapisywanie danych. Wartość musi wynosić 0
lub większy. --długość to górna granica ilości danych do przesłania. Negatyw
wartość jest interpretowana jako długa i długa wartość bez znaku, która zasadniczo obejmuje wszystko
od przesunięcia do końca woluminu. Wystąpi błąd, jeśli plik-lokalny is
większa niż podana długość. Zobacz opis biblioteki libvirt
virStorageVolUpload API, aby uzyskać szczegółowe informacje dotyczące możliwych zmian wolumenu docelowego i puli
w wyniku odświeżenia puli podczas próby przesłania.

pobierz-vol [--basen basen-lub-uuid] [--zrównoważyć bajtów] [--długość bajtów] nazwa-objętości lub klucz-lub-
ścieżka plik-lokalny
Pobierz zawartość woluminu pamięci do plik-lokalny. --basen basen-lub-uuid jest
nazwa lub UUID puli pamięci, w której znajduje się wolumen. nazwa-vol lub klucz lub ścieżka jest
nazwę, klucz lub ścieżkę woluminu do pobrania. --zrównoważyć jest pozycja w
objętość pamięci, od której należy rozpocząć odczytywanie danych. Wartość musi wynosić 0 lub więcej.
--długość to górna granica ilości danych do pobrania. Wartość ujemna to
interpretowane jako długa i długa wartość bez znaku, która zasadniczo obejmuje wszystko od
przesunięte na koniec woluminu.

wyczyść [--basen basen-lub-uuid] [--algorytm algorytm] nazwa-vol lub klucz lub ścieżka
Wyczyść wolumin i upewnij się, że dane znajdujące się wcześniej na woluminie nie będą dostępne do przyszłych odczytów.
--basen basen-lub-uuid to nazwa lub UUID puli pamięci, w której znajduje się wolumen. Tom-
nazwa-lub-klucz-lub-ścieżka to nazwa, klucz lub ścieżka woluminu do wyczyszczenia. To jest możliwe
wybrać różne algorytmy wymazywania zamiast ponownego zapisywania woluminu zerami. Ten
można to zrobić za pomocą --algorytm przełącznik.

Utrzymany Algorytmy
zero - 1-przejście wszystkich zer
nnsa — 4-kartowy list polisy NNSA NAP-14.1-C (XVI-8) dla
odkażanie wymiennych i niewymiennych dysków twardych:
losowy x2, 0x00, sprawdź.
dod - 4-przebiegowa procedura DoD 5220.22-M sekcja 8-306 dla
dezynfekujące, wyjmowane i nieusuwalne, sztywne
dyski: losowe, 0x00, 0xff, sprawdź.
bsi - metoda 9-przebiegowa zalecana przez Niemieckie Centrum ds
Bezpieczeństwo w technologiach informatycznych
(http://www.bsi.bund.de): 0xff, 0xfe, 0xfd, 0xfb,
0xf7, 0xef, 0xdf, 0xbf, 0x7f.
gutmann – Kanoniczna sekwencja 35 przejść opisana w
Artykuł Gutmanna.
schneier – metoda 7-przebiegowa opisana przez Bruce’a Schneiera w
„Kryptografia Stosowana” (1996): 0x00, 0xff,
losowe x5.
pfitzner7 — metoda 7 losowych przejść Roya Pfitznera: losowa x7.
pfitzner33 — metoda 33 losowych przejść Roya Pfitznera: losowa x33.
losowy - wzór 1-przebiegowy: losowy.

Note: Dostępność algorytmów może być ograniczona wersją „scrubowania”
binarny zainstalowany na hoście.

vol-dumppxml [--basen basen-lub-uuid] nazwa-vol lub klucz lub ścieżka
Wyprowadź informacje o woluminie jako zrzut XML na standardowe wyjście. --basen basen-lub-uuid jest
nazwa lub UUID puli pamięci, w której znajduje się wolumen. nazwa-vol lub klucz lub ścieżka jest imię
lub klucz lub ścieżka woluminu, z którego ma zostać wyprowadzony kod XML.

tom-info [--basen basen-lub-uuid] nazwa-vol lub klucz lub ścieżka
Zwraca podstawowe informacje o danym wolumenie pamięci. --basen basen-lub-uuid jest
nazwa lub UUID puli pamięci, w której znajduje się wolumen. nazwa-vol lub klucz lub ścieżka jest imię
lub klucz lub ścieżka woluminu, dla którego mają zostać zwrócone informacje.

lista vol [--basen basen-lub-uuid] [--Detale]
Zwróć listę woluminów w danej puli pamięci. --basen basen-lub-uuid jest imię
lub UUID puli pamięci. The --Detale opcja instruuje virsha dodatkowo
wyświetlać informacje dotyczące typu woluminu i pojemności, jeśli są dostępne.

objętość basenu [--uid] vol-key-or-path
Zwróć nazwę puli lub UUID dla danego woluminu. Domyślna nazwa puli to
zwrócony. Jeśli --uid podana jest opcja, zamiast tego zwracany jest identyfikator UUID puli. vol-key-
lub-ścieżka to klucz lub ścieżka woluminu, dla którego mają zostać zwrócone informacje o puli.

ścieżka-vol [--basen basen-lub-uuid] nazwa-objętości lub klucz
Zwróć ścieżkę dla danego woluminu. --basen basen-lub-uuid to nazwa lub UUID pliku
pula pamięci, w której znajduje się wolumen. nazwa-objętości lub klucz to nazwa lub klucz woluminu
zwróć ścieżkę dla.

nazwa tomu vol-key-or-path
Zwróć nazwę danego woluminu. vol-key-or-path jest kluczem lub ścieżką woluminu
zwrócić nazwę.

vol-key [--basen basen-lub-uuid] nazwa-objętości lub ścieżka
Zwróć klawisz głośności dla danego woluminu. --basen basen-lub-uuid to nazwa lub UUID
pula pamięci, w której znajduje się wolumen. nazwa-objętości lub ścieżka to nazwa lub ścieżka woluminu
dla którego chcesz zwrócić klawisz głośności.

zmiana rozmiaru [--basen basen-lub-uuid] nazwa-objętości lub ścieżka basen-lub-uuid Pojemność [--przeznaczyć]
[--delta] [--kurczyć]
Zmień wielkość danego woluminu w bajtach. --basen basen-lub-uuid to imię lub
UUID puli pamięci, w której znajduje się wolumen. nazwa-vol lub klucz lub ścieżka to nazwa lub klucz
lub ścieżkę woluminu, którego rozmiar chcesz zmienić. Nowa pojemność może być niewielka, chyba że --przeznaczyć
jest specyficzne. Zwykle Pojemność to nowy rozmiar, ale jeśli --delta jest obecny, to to
jest dodawany do istniejącego rozmiaru. Próby zmniejszenia głośności zakończą się niepowodzeniem, chyba że
--kurczyć jest obecny; Pojemność nie może być ujemna, chyba że --kurczyć jest zapewnione, ale a
znak ujemny nie jest konieczny. Pojemność jest skalowaną liczbą całkowitą (patrz UWAGI powyżej), które
domyślnie bajty, jeśli nie ma przyrostka. To polecenie jest bezpieczne tylko do przechowywania
woluminy nieużywane przez aktywnego gościa; Zobacz też zmiana rozmiaru bloku do zmiany rozmiaru na żywo.

SEKRET POLECENIA

Poniższe polecenia manipulują „tajemnicami” (np. hasłami, hasłami i szyfrowaniem).
Klucze). Libvirt może przechowywać sekrety niezależnie od ich użycia, a inne obiekty (np
woluminy lub domeny) mogą odnosić się do kluczy tajnych do szyfrowania lub ewentualnie do innych zastosowań.
Sekrety są identyfikowane za pomocą UUID. Widziećhttp://libvirt.org/formatsecret.html> dla
dokumentacja formatu XML używanego do reprezentowania właściwości sekretów.

zdefiniuj sekret filet
Utwórz klucz tajny o właściwościach określonych w filet, bez powiązanego sekretu
wartość. Gdyby filet nie określa identyfikatora UUID, wybierz go automatycznie. Jeśli filet określa
UUID istniejącego sekretu, zastąp jego właściwości właściwościami zdefiniowanymi w filet,
bez wpływu na wartość tajną.

sekret-dumppxml tajemnica
Właściwości wyjściowe tajemnica (określony przez jego UUID) jako zrzut XML na standardowe wyjście.

wartość-zestawu-tajnego tajemnica base64
Ustaw wartość powiązaną z tajemnica (określony przez jego UUID) do wartości
Wartość zakodowana w formacie Base64 base64.

sekret-zyskuj-wartość tajemnica
Wyprowadź wartość powiązaną z tajemnica (określony przez jego UUID) na standardowe wyjście, zakodowane
przy użyciu Base64.

tajemnica-nieokreślona tajemnica
Usuń a tajemnica (określony przez jego UUID), w tym powiązaną wartość, jeśli istnieje.

lista tajnych [--efemeryczny] [--nie-efemeryczne] [--prywatny] [--nie-prywatny]
Zwraca listę sekretów. Możesz także filtrować zwrócone wpisy tajne według
--efemeryczny wymienić te efemeryczne, --nie-efemeryczne wymienić te nieefemeryczne,
--prywatny aby wyświetlić listę prywatnych i --nie-prywatny aby wymienić te nieprywatne.

MIGAWKA POLECENIA

Poniższe polecenia manipulują migawkami domeny. Migawki zajmują dysk, pamięć i
stan urządzenia domeny w danym momencie i zapisz go do wykorzystania w przyszłości. Mają wielu
używa, od zapisania „czystej” kopii obrazu systemu operacyjnego po zapisanie stanu domeny przed plikiem
potencjalnie destrukcyjna operacja. Zrzuty ekranu są identyfikowane za pomocą unikalnej nazwy. Widzieć
<http://libvirt.org/formatsnapshot.html> w celu uzyskania dokumentacji używanego formatu XML
reprezentują właściwości migawek.

tworzenie migawki domena [plik xml] {[--redefiniuj [--obecny]] | [--no-metadane] [--postój]
[--tylko dysk] [--reuse-external] [--cisza] [--atomowy] [--na żywo]}
Utwórz migawkę dla domeny domena o właściwościach określonych w plik xml.
Zwykle jedynymi właściwościami, które można ustawić dla migawki domeny, są: I
elementy, a także Jeśli --tylko dysk jest podawany; reszta
pola są ignorowane i automatycznie wypełniane przez libvirt. Jeśli plik xml jest całkowicie
pominięty, wówczas libvirt wybierze wartość dla wszystkich pól. Nowa migawka będzie
stać się aktualnym, zgodnie z listą prąd migawki.

If --postój zostanie określony, domena pozostanie w stanie nieaktywnym po
zostanie utworzona migawka.

If --tylko dysk zostanie określony, migawka będzie zawierać tylko stan dysku, a nie plik
zwykły punkt kontrolny systemu ze stanem maszyny wirtualnej. Migawki dysków są szybsze niż pełny system
punkty kontrolne, ale powrót do migawki dysku może wymagać powtórek fsck lub dziennika,
bo to tak jak ze stanem dysku w momencie gwałtownego wyciągnięcia przewodu zasilającego;
i mieszanie --postój oraz --tylko dysk traci wszelkie dane, które nie zostały zgrane na dysk w tym momencie
czas.

If --redefiniuj zostanie określony, wówczas wszystkie elementy XML utworzone przez snapshot-dumppxml jest
ważny; można tego użyć do migracji hierarchii migawek z jednego komputera na drugi
odtworzyć hierarchię na wypadek domeny przejściowej, która znika i pojawia się później
odtworzyć z tą samą nazwą i identyfikatorem UUID lub wprowadzić niewielkie zmiany w migawce
metadane (takie jak specyficzne dla hosta aspekty domeny XML osadzone w migawce).
Kiedy ta flaga jest dostarczona, plik xml argument jest obowiązkowy, a domena
bieżący zrzut nie zostanie zmieniony, chyba że plik --obecny flaga jest również podana.

If --no-metadane zostanie określony, wówczas zostaną utworzone dane migawki, ale zostaną utworzone wszystkie metadane
natychmiast odrzucane (to znaczy, że libvirt nie traktuje migawki jako bieżącej i
nie można powrócić do migawki, chyba że --redefiniuj jest później używany do nauczania libvirt
ponownie metadane).

If --reuse-external jest określony, a plik XML migawki żąda zewnętrznej migawki
z miejscem docelowym istniejącego pliku, to miejsce docelowe musi istnieć i być wcześniej
utworzone z właściwym formatem i metadanymi. Plik jest następnie ponownie wykorzystywany; w przeciwnym razie
migawka jest odrzucana, aby uniknąć utraty zawartości istniejących plików.

If --cisza zostanie określony, libvirt spróbuje użyć agenta gościa do zablokowania i odblokowania
zamontowane systemy plików domeny. Jeśli jednak domena nie ma agenta-gościa, snapshot
stworzenie zakończy się niepowodzeniem. Obecnie tego wymaga --tylko dysk również do zaliczenia.

If --atomowy zostanie określony, libvirt zagwarantuje, że migawka albo się powiedzie, albo
kończy się niepowodzeniem bez zmian; nie wszystkie hypervisory to obsługują. Jeśli ta flaga nie jest
określony, wówczas niektóre hypervisory mogą ulec awarii po częściowym wykonaniu akcji, oraz
zrzutxml należy zastosować, aby sprawdzić, czy nastąpiły jakiekolwiek częściowe zmiany.

If --na żywo jest określony, libvirt wykonuje migawkę, gdy gość jest uruchomiony. Ten
zwiększa rozmiar obrazu pamięci zewnętrznego punktu kontrolnego. To jest obecnie
obsługiwane tylko dla zewnętrznych punktów kontrolnych.

Istnienie metadanych migawki zapobiegnie próbom niezdefiniowany domena trwała.
Jednak w przypadku domen przejściowych metadane migawki są dyskretnie tracone, gdy domena
kończy działanie (czy to za pomocą polecenia, takiego jak zniszczyć lub przez wewnętrzne działanie gościa).

tworzenie migawki jako domena {[--print-xml] | [--no-metadane] [--postój] [--reuse-external]}
[Nazwa] [opis] [--tylko dysk [--cisza]] [--atomowy] [[--na żywo] [--specyfikacja pamięci specyfikacja mem]]
[--specyfikacja dysku] specyfikacja dysku] ...
Utwórz migawkę dla domeny domena z danym I ; jeśli albo
wartość zostanie pominięta, libvirt wybierze wartość. Jeśli --print-xml jest określony, a następnie XML
odpowiednie do tworzenie migawki jest wyprowadzany, zamiast faktycznie tworzyć migawkę.
W przeciwnym razie, jeśli --postój zostanie określony, po tym domena pozostanie w stanie nieaktywnym
zostanie utworzona migawka i jeśli --tylko dysk zostanie określony, migawka nie zostanie wykonana
uwzględnij stan maszyny wirtualnej.

--specyfikacja pamięci Opcja może służyć do kontrolowania, czy punkt kontrolny jest wewnętrzny, czy
zewnętrzny. The --specyfikacja pamięci flaga jest obowiązkowa, po której następuje a specyfikacja mem formy
[plik=]nazwa[,migawka=typ], gdzie typ może być Nie, wewnętrznylub zewnętrzny. Aby zawierało
dosłowny przecinek plik=nazwa, użyj drugiego przecinka. --specyfikacja pamięci nie może być użyty
Wraz z --tylko dysk.

--specyfikacja dysku Opcja może być używana do kontrolowania sposobu --tylko dysk i zewnętrzne punkty kontrolne
utwórz pliki zewnętrzne. Ta opcja może wystąpić wiele razy, w zależności od liczby
z elementy w domenie xml. Każdy jest w formie
dysk[,snapshot=typ][,sterownik=typ][,plik=nazwa], ZA specyfikacja dysku należy zapewnić dla dysków
wspierane przez urządzenia blokowe, ponieważ libvirt nie generuje dla nich automatycznie nazw plików. Do
wstaw dosłowny przecinek dysk lub plik=nazwa, użyj drugiego przecinka. A
dosłowny --specyfikacja dysku musi poprzedzać każdy specyfikacja dysku chyba, że ​​wszystkie trzy domena, Nazwa,
opis są również obecni. Na przykład specyfikacja dysku
„vda,snapshot=external,file=/path/to,,new” daje w wyniku następujący kod XML:




If --reuse-external jest określony, a domena XML lub specyfikacja dysku żądania opcji
zewnętrzną migawkę z miejscem docelowym istniejącego pliku, to miejsce docelowe musi
istnieją i mogą być wstępnie utworzone, z odpowiednim formatem i metadanymi. Plik jest następnie ponownie wykorzystywany;
w przeciwnym razie migawka zostanie odrzucona, aby uniknąć utraty zawartości istniejących plików.

If --cisza zostanie określony, libvirt spróbuje użyć agenta gościa do zablokowania i odblokowania
zamontowane systemy plików domeny. Jeśli jednak domena nie ma agenta-gościa, snapshot
stworzenie zakończy się niepowodzeniem. Obecnie tego wymaga --tylko dysk również do zaliczenia.

If --no-metadane zostanie określony, wówczas zostaną utworzone dane migawki, ale zostaną utworzone wszystkie metadane
natychmiast odrzucane (to znaczy, że libvirt nie traktuje migawki jako bieżącej i
nie można powrócić do migawki, chyba że tworzenie migawki jest później używany do nauczania libvirt
ponownie o metadanych). Ta flaga jest niezgodna z --print-xml.

If --atomowy zostanie określony, libvirt zagwarantuje, że migawka albo się powiedzie, albo
kończy się niepowodzeniem bez zmian; nie wszystkie hypervisory to obsługują. Jeśli ta flaga nie jest
określony, wówczas niektóre hypervisory mogą ulec awarii po częściowym wykonaniu akcji, oraz
zrzutxml należy zastosować, aby sprawdzić, czy nastąpiły jakiekolwiek częściowe zmiany.

If --na żywo jest określony, libvirt wykonuje migawkę, gdy gość jest uruchomiony. Ten
zwiększa rozmiar obrazu pamięci zewnętrznego punktu kontrolnego. To jest obecnie
obsługiwane tylko dla zewnętrznych punktów kontrolnych.

prąd migawki domena {[--Nazwa] | [--informacje Ochrony] | [nazwa migawki]}
Bez nazwa migawki, spowoduje to wygenerowanie migawki XML dla bieżącej domeny
migawka (jeśli istnieje). Jeśli --Nazwa jest określona, ​​tylko nazwa bieżącej migawki zamiast
pełny plik XML. W przeciwnym razie za pomocą --informacje Ochrony obejmie również kwestie wrażliwe na bezpieczeństwo
informacje w formacie XML.

Wraz z nazwa migawki, jest to żądanie, aby istniejący nazwany zrzut stał się plikiem
bieżącą migawkę, bez przywracania domeny.

edycja migawki domena [nazwa migawki] [--obecny] {[--Przemianować] | [--klon]}
Edytuj plik konfiguracyjny XML dla nazwa migawki domeny. Jeśli oba nazwa migawki
oraz --obecny są określone, wymuś także, aby edytowany zrzut stał się bieżącym
migawka. Jeśli nazwa migawki jest pominięty, to --obecny należy podać, aby edytować plik
aktualny zrzut ekranu.

Odpowiada to:

virsh snapshot-dumpxml nazwa domeny > snapshot.xml
vi snapshot.xml (lub wprowadź zmiany w innym edytorze tekstu)
virsh snapshot-utwórz dom snapshot.xml --redefine [--current]

z tą różnicą, że sprawdza pewne błędy.

Używany edytor może być dostarczony przez zmienne środowiskowe $VISUAL lub $EDITOR, oraz
domyślnie „vi”.

If --Przemianować zostanie określony, wówczas zmiany będą mogły zmienić nazwę migawki. Jeśli --klon is
określony, zmiana nazwy migawki spowoduje utworzenie klonu migawki
metadane. Jeśli nie określono żadnego z nich, zmiany nie mogą zmieniać nazwy migawki.
Należy pamiętać, że zmiany nazwy migawki należy dokonywać ostrożnie, ponieważ zawartość niektórych plików
migawki, takie jak migawki wewnętrzne w pojedynczym pliku qcow2, są dostępne tylko
od pierwotnej nazwy.

Informacje o migawce domena {migawka | --obecny}
Wyprowadź podstawowe informacje o nazwanym lub bieżący zrzut ekranu za pomocą
--obecny.

lista migawek domena [--metadane] [--no-metadane] [{--rodzic | --korzenie | [{--drzewo |
--Nazwa}]}] [{[--z] migawka | --obecny} [--potomków]] [--liście] [--bez liści]
[--nieaktywny] [--aktywny] [--tylko dysk] [--wewnętrzny] [--zewnętrzny]
Wyświetl listę wszystkich dostępnych migawek dla danej domeny, domyślnie wyświetlając kolumny
dla nazwy migawki, czasu utworzenia i stanu domeny.

If --rodzic jest określony, dodaj kolumnę do tabeli wyjściowej, podając nazwę
element nadrzędny każdej migawki. Jeśli --korzenie zostanie określony, lista zostanie przefiltrowana do just
migawki, które nie mają rodziców. Jeśli --drzewo zostanie określony, wynik będzie w drzewie
format, wyświetlając tylko nazwy migawek. Te trzy opcje wykluczają się wzajemnie. Jeśli
--Nazwa jest określony, drukowana jest tylko nazwa migawki. Ta opcja jest wzajemna
ekskluzywny z --drzewo.

If --z jest dostępna, przefiltruj listę do migawek, które są dziećmi danego
migawka; albo jeśli --obecny jest dostępna, rozpocznij od bieżącej migawki. Kiedy używany w
izolacja lub z --rodzic, lista jest ograniczona do bezpośrednich dzieci, chyba że
--potomków jest również obecny. Kiedy używany z --drzewo, Stosowanie --potomków is
ukryty. Ta opcja nie jest kompatybilna z --korzenie. Należy pamiętać, że punktem wyjścia
--z or --obecny nie jest uwzględniony na liście, chyba że --drzewo opcja jest również
prezent.

If --liście zostanie określony, lista zostanie przefiltrowana tylko do migawek, które nie mają
dzieci. Podobnie, jeśli --bez liści zostanie określony, lista zostanie przefiltrowana do just
migawki z dziećmi. (Zauważ, że pominięcie obu opcji nie powoduje filtrowania, natomiast
podanie obu opcji spowoduje wyświetlenie tej samej listy lub wystąpienie błędu, w zależności od tego
czy serwer rozpoznaje flagi). Opcje filtrowania nie są kompatybilne z
--drzewo.

If --metadane zostanie określony, lista zostanie przefiltrowana tylko do migawek, które obejmują
metadanych libvirt, a tym samym zapobiegłoby niezdefiniowany domeny trwałej lub zostać utracony
on zniszczyć domeny przejściowej. Podobnie, jeśli --no-metadane jest określony, lista
zostaną odfiltrowane do samych migawek, które istnieją, bez potrzeby stosowania metadanych libvirt.

If --nieaktywny zostanie określony, lista zostanie przefiltrowana według wykonanych migawek
kiedy domena została wyłączona. Jeśli --aktywny zostanie określony, lista zostanie przefiltrowana
migawki, które zostały wykonane, gdy domena była uruchomiona, i gdzie migawka zawiera
stan pamięci, aby powrócić do stanu działania. Jeśli --tylko dysk jest określony,
lista zostanie przefiltrowana do migawek wykonanych podczas działania domeny, ale
gdzie migawka zawiera tylko stan dysku.

If --wewnętrzny zostanie określony, lista zostanie przefiltrowana do migawek korzystających z plików wewnętrznych
przechowywanie istniejących obrazów dysków. Jeśli --zewnętrzny zostanie określony, lista będzie
filtrowane do migawek wykorzystujących pliki zewnętrzne do określania obrazów dysków lub stanu pamięci.

snapshot-dumppxml domena migawka [--informacje Ochrony]
Wyprowadź plik XML migawki dla nazwanej migawki domeny migawka, Za pomocą
--informacje Ochrony będą również zawierać informacje wrażliwe z punktu widzenia bezpieczeństwa. Używać snapshot-
aktualne aby łatwo uzyskać dostęp do kodu XML bieżącej migawki.

rodzic migawki domena {migawka | --obecny}
Wypisz nazwę nadrzędnej migawki, jeśli istnieje, dla danego migawka, lub dla
bieżący zrzut ekranu z --obecny.

przywracanie migawki domena {migawka | --obecny} [{--działanie | --pauza}] [--siła]
Przywróć daną domenę do migawki określonej przez migawkalub do prądu
migawka z --obecny. Bądź świadomy, że jest to działanie destrukcyjne; jakiekolwiek zmiany w
domena od czasu wykonania ostatniej migawki zostanie utracona. Należy również pamiętać, że stan
domeny po zakończeniu przywracania migawki będzie stan domeny w momencie
czas wykonania oryginalnej migawki.

Zwykle powrót do migawki pozostawia domenę w takim stanie, w jakim była w tamtym czasie
utworzono migawkę, z tą różnicą, że migawka dysku bez stanu maszyny wirtualnej opuszcza plik
domena w stanie nieaktywnym. Przechodząc albo --działanie or --pauza flaga będzie
wykonać dodatkowe zmiany stanu (takie jak uruchomienie nieaktywnej domeny lub wstrzymanie pliku
działająca domena). Ponieważ domeny przejściowe nie mogą być nieaktywne, wymagane jest ich użycie
jedna z tych flag podczas przywracania migawki dysku domeny przejściowej.

Istnieją dwa przypadki, w których przywracanie migawki wiąże się z dodatkowym ryzykiem, które wymaga:
zastosowanie --siła kontynuować. Jednym z nich jest przypadek migawki, w której brakuje pełnej domeny
informacje dotyczące przywracania konfiguracji (takie jak migawki utworzone przed wersją libvirt
0.9.5); ponieważ libvirt nie może udowodnić, że bieżąca konfiguracja jest zgodna z tą, która była
użyj w momencie tworzenia migawki, dostarczając --siła zapewnia libvirt, że snapshot
jest kompatybilny z bieżącą konfiguracją (a jeśli nie jest, domena prawdopodobnie
nie uruchomić). Drugi przypadek dotyczy powrotu z działającej domeny do aktywnej
określa, w którym miejscu należy utworzyć nowy hiperwizor, zamiast ponownie wykorzystywać istniejący
hypervisor, ponieważ wiąże się to z wadami, takimi jak uszkodzenie istniejącego VNC lub Spice
znajomości; ten warunek ma miejsce w przypadku aktywnej migawki, która korzysta z metody provably
niezgodna konfiguracja, a także z nieaktywną migawką, która jest połączona z
dotychczasowy --początek or --pauza flag.

usuwanie migawki domena {migawka | --obecny} [--metadane] [{--dzieci |
--tylko dla dzieci}]
Usuń migawkę dla nazwanej domeny migawkalub bieżący zrzut ekranu za pomocą
--obecny. Jeśli ta migawka zawiera migawki podrzędne, zmiany z tej migawki zostaną uwzględnione
wtopił się w dzieci. Jeśli --dzieci zostanie przekazany, a następnie usuń tę migawkę i inne
dzieci tej migawki. Jeśli --tylko dla dzieci zostanie przekazany, a następnie usuń wszystkie elementy podrzędne
tę migawkę, ale pozostaw tę migawkę nienaruszoną. Te dwie flagi są wzajemnie
wykluczają.

If --metadane jest określony, usuń tylko metadane migawki obsługiwane przez
libvirt, pozostawiając zawartość migawki nienaruszoną, aby można było uzyskać do niej dostęp za pomocą narzędzi zewnętrznych;
w przeciwnym razie usunięcie migawki powoduje również usunięcie zawartości danych z tego momentu.

NWFILTR POLECENIA

Poniższe polecenia manipulują filtrami sieciowymi. Filtry sieciowe umożliwiają filtrowanie plików
ruch sieciowy przychodzący i wychodzący do maszyn wirtualnych. Indywidualny ruch sieciowy
filtry są napisane w formacie XML i mogą zawierać odniesienia do innych filtrów sieciowych, opisz
reguły filtrowania ruchu lub zawierają oba. Filtry sieciowe odwołują się do wirtualnych
maszyny z poziomu opisu ich interfejsu. Do filtra sieciowego może odwoływać się:
interfejsy wielu maszyn wirtualnych.

definicja-nwfilter plik xml
Utwórz nowy filtr sieciowy znany libvirt. Jeśli filtr sieciowy o tej samej nazwie
już istnieje, zostanie zastąpiony nowym XML. Dowolna działająca maszyna wirtualna
odniesienie się do tego filtru sieciowego spowoduje dostosowanie jego reguł ruchu sieciowego. Jeśli za
z jakiegokolwiek powodu reguły filtrowania ruchu sieciowego nie mogą zostać utworzone przez żaden z nich
z uruchomionymi maszynami wirtualnymi, nowy plik XML zostanie odrzucony.

nwfilter-niezdefiniowany nazwa-nwfiltera
Usuń filtr sieciowy. Usunięcie nie powiedzie się, jeśli jakakolwiek działająca maszyna wirtualna jest
obecnie korzysta z tego filtra sieciowego.

lista-nwfilter
Lista wszystkich dostępnych filtrów sieciowych.

nwfilter-dumppxml nazwa-nwfiltera
Wyprowadź plik XML filtra sieciowego.

edycja-nwfilter nazwa-nwfiltera
Edytuj kod XML filtra sieciowego.

Odpowiada to:

virsh nwfilter-dumpxml mój filtr > mój filtr.xml
vi myfilter.xml (lub wprowadź zmiany w innym edytorze tekstu)
virsh nwfilter-define myfilter.xml

z tą różnicą, że sprawdza pewne błędy. Nowy filtr sieciowy może zostać odrzucony z powodu
z tego samego powodu, o którym mowa w definicja-nwfilter.

Używany edytor może być dostarczony przez zmienne środowiskowe $VISUAL lub $EDITOR, oraz
domyślnie „vi”.

SPECYFICZNE DO HYPERVISORA POLECENIA

UWAGA: Użycie poniższych poleceń jest strongly zniechęcony. Mogą powodować działanie libvirt
pogubić się i postępować źle podczas kolejnych operacji. Kiedy już ich użyjesz
poleceń, prosimy nie zgłaszać problemów twórcom libvirt; będą raporty
ignorowane. Jeśli okaże się, że te polecenia są jedynym sposobem na osiągnięcie czegoś, to
lepiej poprosić o dodanie tej funkcji jako obywatel pierwszej klasy w trybie zwykłym
biblioteka libvirt.

qemu-dołącz Pid
Dołącz zewnętrznie uruchomiony proces QEMU do sterownika libvirt QEMU. QEMU
proces musi zostać utworzony z połączeniem monitora przy użyciu sterownika UNIX.
W idealnym przypadku proces będzie miał również podany argument „-name”.

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

Nie oczekuje się, że wszystkie funkcje libvirt będą działać niezawodnie po dołączeniu do pliku
zewnętrznie uruchomiony proces QEMU. Mogą wystąpić problemy ze zmianą ABI gościa
migracja i funkcja hotplug lub hotplug urządzenia mogą nie działać. Załączone środowisko
należy traktować przede wszystkim jako tylko do odczytu.

polecenie-qemu-monitor domena { [--hmp] | [--piękny] } komenda...
Wyślij dowolne polecenie monitora komenda do domeny domena przez monitor qemu.
Wyniki polecenia zostaną wydrukowane na standardowe wyjście. Jeśli --hmp zostało przekazane, polecenie
jest uważane za polecenie ludzkiego monitora i libvirt automatycznie je skonwertuje
w razie potrzeby do QMP. W takim przypadku wynik również zostanie przeliczony z powrotem z QMP. Jeśli
--piękny jest podany, a monitor używa QMP, wówczas wydruk będzie ładny.
Jeśli podano więcej niż jeden argument komenda, są one połączone spacją
pomiędzy nimi przed przekazaniem pojedynczego polecenia do monitora.

polecenie-qemu-agent domena [--koniec czasu sekund | --sync | --blok] komenda...
Wyślij dowolne polecenie agenta gościa komenda do domeny domena za pośrednictwem agenta qemu.
--koniec czasu, --sync oraz --blok opcje są wyłączne. --koniec czasu wymaga przekroczenia limitu czasu
sekund sekund i to musi być pozytywne. Gdy --aysnc zostanie podane, polecenie czeka
przekroczenie limitu czasu, niezależnie od tego, czy zakończyło się sukcesem, czy niepowodzeniem. I kiedy --blok zostanie wydane, polecenie czeka
na zawsze z przekroczeniem limitu czasu blokowania.

zdarzenie-qemu-monitor [domena] [--wydarzenie Nazwa wydarzenia] [--pętla] [--koniec czasu sekund] [--piękny]
[--wyrażenie regularne] [--bez przypadku] [--znak czasu]
Poczekaj na wystąpienie dowolnych zdarzeń monitora QEMU i wydrukuj szczegóły zdarzeń
jak to się dzieje. Zdarzenia można opcjonalnie filtrować według domena or Nazwa wydarzenia,
Komendy QMP „query-events” można używać za pośrednictwem polecenie-qemu-monitor dowiedzieć się, jakie wydarzenia
są obsługiwane. Jeśli --wyrażenie regularne jest używany, Nazwa wydarzenia jest zamiast tego podstawowym wyrażeniem regularnym
ciągu dosłownego. Jeśli --bez przypadku jest używany, Nazwa wydarzenia będzie dopasowywane bez uwzględniania wielkości liter.

Domyślnie to polecenie jest jednorazowe i zwraca sukces po wystąpieniu zdarzenia; Ty
może wysłać SIGINT (zwykle przez „Ctrl-C”), aby natychmiast zakończyć. Jeśli --koniec czasu is
określony, polecenie rezygnuje z oczekiwania na zdarzenia po sekund upłynęły. Z
--pętla, polecenie wypisuje wszystkie zdarzenia aż do przekroczenia limitu czasu lub klawisza przerwania. Jeśli --piękny
jest określony, wszelkie szczegóły zdarzenia JSON są ładnie wydrukowane dla lepszej czytelności.

Kiedy --znak czasu zostanie użyty, przed wydarzeniem zostanie wydrukowany czytelny dla człowieka znacznik czasu,
a informacje o czasie dostarczone przez QEMU zostaną pominięte.

lxc-wprowadź-przestrzeń nazw domena -- /ścieżka/do/binarnego [arg1, [arg2, ...]]
Wprowadź przestrzeń nazw domena i wykonaj polecenie „/path/to/binary”, przekazując plik
żądane argumenty. Ścieżka binarna jest względna w stosunku do głównego systemu plików kontenera, a nie do
główny system plików hosta. Plik binarny odziedziczy zmienne środowiskowe/konsolę
widoczne dla virsha. To polecenie działa tylko po podłączeniu do sterownika hypervisora ​​LXC.
To polecenie powiedzie się tylko wtedy, gdy „/path/to/binary” ma status wyjścia 0.

ŚRODOWISKO

Można ustawić następujące zmienne środowiskowe, aby zmienić zachowanie „virsh”

VIRSH_DEBUG=<0 do 4>
Włącz pełne debugowanie poleceń virsh. Prawidłowe poziomy to

· VIRSH_DEBUG=0

DEBUGOWANIE - Wiadomości na WSZYSTKICH poziomach są rejestrowane

· VIRSH_DEBUG=1

INFO - Rejestruje komunikaty na poziomach INFO, UWAGA, OSTRZEŻENIE i BŁĄD

· VIRSH_DEBUG=2

UWAGA – rejestruje komunikaty na poziomach UWAGA, OSTRZEŻENIE i BŁĄD

· VIRSH_DEBUG=3

OSTRZEŻENIE – rejestruje komunikaty na poziomach OSTRZEŻENIE i BŁĄD

· VIRSH_DEBUG=4

BŁĄD — rejestrowane są tylko wiadomości na poziomie BŁĄD.

VIRSH_LOG_FILE="PLIK LOGOWANIA"
Plik do rejestrowania komunikatów debugowania virsha.

VIRSH_DEFAULT_CONNECT_URI
Domyślny hiperwizor, z którym chcesz się połączyć. Ustaw to na URI, w tym samym formacie co
akceptowane przez connect opcja. Ta zmienna środowiskowa została zastąpiona przestarzałą
globalny LIBVIRT_DEFAULT_URI zmienna służąca temu samemu celowi.

LIBVIRT_DEFAULT_URI
Domyślny hiperwizor, z którym chcesz się połączyć. Ustaw to na URI, w tym samym formacie co
akceptowane przez connect opcja. Zastępuje to domyślny identyfikator URI ustawiony w dowolnym kliencie
config i uniemożliwia libvirt sondowanie sterowników.

WIZUALNY
Edytor używany przez edit i powiązane opcje.

REDAKCJA
Edytor używany przez edit i powiązane opcje, jeśli nie ustawiono opcji „VISUAL”.

VIRSH_HISTSIZE
Liczba poleceń do zapamiętania w historii poleceń. Wartość domyślna to 500.

LIBVIRT_DEBUG=POZIOM
Włącz pełne debugowanie wszystkich wywołań API libvirt. Prawidłowe poziomy to

· LIBVIRT_DEBUG=1

Komunikaty na poziomie DEBUG lub wyższym

· LIBVIRT_DEBUG=2

Wiadomości na poziomie INFO lub wyższym

· LIBVIRT_DEBUG=3

Komunikaty na poziomie WARNING lub wyższym

· LIBVIRT_DEBUG=4

Komunikaty na poziomie ERROR lub wyższym

Aby uzyskać więcej informacji na temat opcji debugowania, skonsultuj się
"http://libvirt.org/logging.html"

Używaj virsh online, korzystając z usług onworks.net