virsh - Dalam talian di Awan

JADUAL:

NAMA

virsh - antara muka pengguna pengurusan

SINOPSIS

dara [OPTION]... [COMMAND_STRING]

dara [OPTION]... COMMAND [ARG]...

DESCRIPTION

. dara program ialah antara muka utama untuk menguruskan domain tetamu virsh. Program boleh
digunakan untuk membuat, menjeda dan menutup domain. Ia juga boleh digunakan untuk menyenaraikan semasa
domain. Libvirt ialah kit alat C untuk berinteraksi dengan keupayaan virtualisasi terkini
versi Linux (dan OS lain). Ia adalah perisian percuma yang tersedia di bawah GNU Lesser
Lesen Awam Am. Virtualisasi Sistem Pengendalian Linux bermaksud keupayaan untuk
menjalankan berbilang contoh Sistem Pengendalian secara serentak pada satu sistem perkakasan di mana
sumber asas didorong oleh contoh Linux. Perpustakaan bertujuan untuk menyediakan panjang
jangka API C stabil. Ia kini menyokong Xen, QEMU, KVM, LXC, OpenVZ, VirtualBox dan
VMware ESX.

Struktur asas penggunaan kebanyakan virsh ialah:

virsh [PILIHAN]... [ARG]...

Lokasi arahan adalah salah satu daripada arahan yang disenaraikan di bawah; domain ialah id domain berangka, atau
nama domain, atau domain UUID; dan ARGS adalah pilihan khusus arahan. Terdapat beberapa
pengecualian kepada peraturan ini dalam kes di mana arahan berkenaan bertindak pada semua domain,
keseluruhan mesin, atau terus pada hypervisor xen. Pengecualian tersebut akan jelas untuk
setiap perintah tersebut. Nota: adalah dibenarkan untuk memberikan nama angka kepada domain,
namun, berbuat demikian akan menghasilkan domain yang hanya boleh dikenal pasti oleh id domain. Dalam
erti kata lain, jika nilai berangka dibekalkan, ia akan ditafsirkan sebagai id domain, bukan sebagai
Nama.

. dara program boleh digunakan sama ada untuk menjalankan satu COMMAND dengan memberi arahan dan yang
argumen pada baris arahan shell, atau a COMMAND_STRING yang merupakan hujah shell tunggal
terdiri daripada berbilang COMMAND tindakan dan hujah mereka digabungkan dengan ruang putih, dan
dipisahkan oleh koma bertitik antara arahan. dalam COMMAND_STRING, virsh memahami
tunggal, berganda dan garis miring ke belakang yang sama terlepas sebagai cangkerang, walaupun anda mesti menambah satu lagi
lapisan shell melarikan diri dalam mencipta hujah shell tunggal. Jika tiada arahan diberikan
baris arahan, dara kemudian akan memulakan penterjemah minimum menunggu arahan anda,
dan juga berhenti arahan kemudiannya akan keluar dari program.

. dara program memahami perkara berikut PILIHAN.

-c, --sambung URI
Sambung kepada yang ditentukan URI, seolah-olah oleh menyambung arahan, bukannya lalai
sambungan.

-d, --nyahpepijat LEVEL
Dayakan mesej nyahpepijat pada integer LEVEL dan ke atas. LEVEL boleh berkisar antara 0 hingga 4
(lalai). Lihat dokumentasi bagi VIRSH_DEBUG pembolehubah persekitaran di bawah untuk
penerangan masing-masing LEVEL.

-e, --melarikan diri rentetan
Tetapkan urutan pelarian alternatif untuk konsul perintah. Secara lalai, telnet ^] digunakan.
Aksara yang dibenarkan apabila menggunakan notasi topi ialah: aksara abjad, @, [, ], \, ^,
_.

-h, - membantu
Abaikan semua hujah lain, dan berkelakuan seolah-olah membantu arahan diberikan sebaliknya.

-k, --keepalive-selang INTERVAL
Tetapkan sebuah INTERVAL (dalam saat) untuk menghantar mesej keepalive untuk menyemak sama ada
sambungan ke pelayan masih hidup. Menetapkan selang kepada 0 melumpuhkan klien
mekanisme keepalive.

-K, --keepalive-count COUNT
Tetapkan beberapa kali mesej keepalive boleh dihantar tanpa mendapat jawapan daripada
pelayan tanpa menandakan sambungan mati. Tiada kesan pada tetapan ini dalam
kes yang INTERVAL ditetapkan ke 0.

-l, --log FAIL
Keluarkan butiran pengelogan ke FAIL.

-q, --senyap
Elakkan mesej maklumat tambahan.

-r, --baca sahaja
Buat sambungan awal baca sahaja, seolah-olah oleh --baca sahaja pilihan untuk menyambung
perintah.

-t, --masa
Output maklumat masa berlalu untuk setiap arahan.

-v, --version[=short]
Abaikan semua hujah lain dan cetak versi perpustakaan libvirt virsh
yang datang dari

-V, --version=panjang
Abaikan semua hujah lain dan cetak versi perpustakaan libvirt virsh
datang dari dan pilihan dan pemandu yang mana dihimpunkan.

NOTA

jambatan dara operasi bergantung pada perpustakaan libvirt yang dapat menyambung ke yang sudah
menjalankan perkhidmatan libvirtd. Ini biasanya boleh dilakukan menggunakan arahan invoke-rc.d libvirtd
permulaan.

jambatan dara arahan memerlukan keistimewaan root untuk dijalankan kerana saluran komunikasi yang digunakan
untuk bercakap dengan hypervisor. Berjalan sebagai bukan akar akan mengembalikan ralat.

jambatan dara arahan bertindak serentak, kecuali mungkin penutupan, setvcpus dan setmem. Dalam
kes tersebut fakta bahawa dara program dikembalikan, mungkin tidak bermakna tindakan telah selesai
dan anda mesti membuat tinjauan secara berkala untuk mengesan bahawa tetamu telah menyelesaikan operasi.

dara berusaha untuk keserasian ke belakang. walaupun membantu arahan hanya menyenaraikan
penggunaan pilihan arahan, jika versi lama dara menyokong ejaan alternatif
daripada arahan atau pilihan (seperti --terowong bukan --terowong), kemudian skrip menggunakan
ejaan lama itu akan terus berfungsi.

Beberapa dara arahan mengambil integer berskala pilihan; jika tiada skala disediakan, maka
lalai disenaraikan dalam arahan (atas sebab sejarah, beberapa arahan lalai kepada
bait, manakala arahan lain lalai kepada kibibait). Yang berikut tidak sensitif huruf
akhiran boleh digunakan untuk memilih skala tertentu:
b, bait bait 1
KB kilobait 1,000
k, KiB kibibait 1,024
MB megabait 1,000,000
M, MiB mebibait 1,048,576
GB gigabait 1,000,000,000
G, GiB gibibait 1,073,741,824
Terabait TB 1,000,000,000,000
T, TiB tebibait 1,099,511,627,776
PB petabait 1,000,000,000,000,000
P, PiB pebibait 1,125,899,906,842,624
EB exabait 1,000,000,000,000,000,000
E, EiB exbibait 1,152,921,504,606,846,976

UMUM PERINTAH

Perintah berikut adalah generik iaitu tidak khusus untuk domain.

membantu [arahan-atau-kumpulan]
Ini menyenaraikan setiap perintah virsh. Apabila digunakan tanpa pilihan, semua arahan adalah
disenaraikan, satu setiap baris, dikumpulkan ke dalam kategori yang berkaitan, memaparkan kata kunci untuk setiap baris
kumpulan.

Untuk memaparkan hanya arahan untuk kumpulan tertentu, berikan kata kunci untuk kumpulan itu sebagai
pilihan. Sebagai contoh:

virsh # bantuan hos

Hos dan Hipervisor (kata kunci bantuan 'hos'):
keupayaan keupayaan
model cpu menunjukkan model CPU untuk seni bina
sambung (semula)sambung ke hipervisor
freecell NUMA memori bebas
nama hos mencetak nama hos hipervisor
qemu-attach Lampirkan pada proses QEMU sedia ada
qemu-monitor-command Perintah Monitor QEMU
qemu-agent-command Perintah Ejen Tetamu QEMU
sysinfo mencetak sysinfo hipervisor
uri mencetak URI kanonik hipervisor

Untuk memaparkan maklumat terperinci bagi arahan tertentu, berikan namanya sebagai pilihan
sebaliknya. Sebagai contoh:

virsh # senarai bantuan
NAMA
senarai - senaraikan domain

SINOPSIS
senarai [--tidak aktif] [--semua]

DESCRIPTION
Mengembalikan senarai domain.

PILIHAN
--senarai tidak aktif domain tidak aktif
--semua senarai domain tidak aktif & aktif

berhenti, keluar
berhenti dari terminal interaktif ini

versi [--daemon]
Akan mencetak maklumat versi utama tentang bahan binaan ini. Jika --daemon is
ditentukan maka versi daemon libvirt disertakan dalam output.

Contoh

$ versi virsh
Disusun terhadap perpustakaan: libvirt 1.2.3
Menggunakan perpustakaan: libvirt 1.2.3
Menggunakan API: QEMU 1.2.3
Menjalankan hipervisor: QEMU 2.0.50

$ versi virsh --daemon
Disusun terhadap perpustakaan: libvirt 1.2.3
Menggunakan perpustakaan: libvirt 1.2.3
Menggunakan API: QEMU 1.2.3
Menjalankan hipervisor: QEMU 2.0.50
Berlari menentang daemon: 1.2.6

cd [direktori]
Akan menukar direktori semasa kepada direktori. Direktori lalai untuk cd arahan
ialah direktori rumah atau, jika tiada LAMAN UTAMA pembolehubah dalam persekitaran, akar
direktori.

Perintah ini hanya tersedia dalam mod interaktif.

jentera Akan mencetak direktori semasa.

menyambung [URI] [--baca sahaja]
(Re)-Sambung ke hypervisor. Apabila shell pertama kali dimulakan, ini secara automatik
berlari dengan URI parameter yang diminta oleh pilihan "-c" pada baris arahan. The URI
parameter menentukan cara menyambung ke hypervisor. Halaman dokumentasi di
<http://libvirt.org/uri.html> senaraikan nilai yang disokong, tetapi yang paling biasa ialah:

xen:///
ini digunakan untuk menyambung ke hipervisor Xen tempatan

qemu:///system
sambung secara setempat sebagai akar kepada daemon yang menyelia domain QEMU dan KVM

qemu:///session
sambung secara setempat sebagai pengguna biasa ke set domain QEMU dan KVM sendiri

lxc:///
sambung ke bekas linux tempatan

Untuk mencari URI yang sedang digunakan, semak uri arahan didokumenkan di bawah.

Untuk akses jauh lihat halaman dokumentasi dihttp://libvirt.org/uri.html> bagaimana
untuk membuat URI. The --baca sahaja pilihan membenarkan sambungan baca sahaja

uri Mencetak URI kanonik hypervisor, boleh berguna dalam mod shell.

nama hos
Cetak nama hos hypervisor.

sysinfo
Cetak perwakilan XML bagi sysinfo hipervisor, jika tersedia.

nodeinfo
Mengembalikan maklumat asas tentang nod, seperti nombor dan jenis CPU, dan saiz nod
ingatan fizikal. Output sepadan dengan struktur virNodeInfo. Secara khusus,
Medan "soket CPU" bermaksud bilangan soket CPU bagi setiap sel NUMA. Maklumat tersebut
paparan libvirt bergantung pada apa yang mungkin disediakan oleh setiap seni bina.

nodecpumap [--cantik]
Memaparkan jumlah bilangan CPU nod, bilangan CPU dalam talian dan senarai
CPU dalam talian.

Dengan --cantik CPU dalam talian dicetak sebagai julat dan bukannya senarai.

nodecputats [cpu] [--peratus]
Mengembalikan statistik cpu nod. Jika cpu ditentukan, ini akan mencetak cpu yang ditentukan
statistik sahaja. Jika --peratus ditentukan, ini akan mencetak peratusan setiap jenis
statistik cpu selama 1 saat.

nodememstats [sel]
Mengembalikan statistik memori nod. Jika sel ditentukan, ini akan mencetak ditentukan
statistik sel sahaja.

nodesuspend [sasaran] [tempoh]
Meletakkan nod (mesin hos) ke dalam keadaan tidur seluruh sistem dan jadualkan nod
Sampukan Jam-Masa Nyata untuk menyambung semula nod selepas tempoh masa yang ditentukan oleh
tempoh keluar. sasaran menentukan keadaan tempat hos akan digantung,
ia boleh menjadi "mem" (gantung kepada RAM), "cakera" (gantung kepada cakera), atau "hibrid" (gantung kepada
kedua-dua RAM dan cakera). tempoh menentukan tempoh masa dalam saat yang
hos perlu digantung, sekurang-kurangnya 60 saat.

nod-memori-tala [shm-halaman-untuk-imbas] [shm-sleep-millisecs] [shm-gabung-merentas-nod]
Membolehkan anda memaparkan atau menetapkan parameter memori nod. shm-halaman-untuk-imbas boleh
digunakan untuk menetapkan bilangan halaman untuk diimbas sebelum perkhidmatan memori dikongsi pergi ke
tidur; shm-sleep-millisecs boleh digunakan untuk menetapkan bilangan millisec yang dikongsi
perkhidmatan memori harus tidur sebelum imbasan seterusnya; shm-gabung-merentas-nod menyatakan jika
halaman daripada nod numa yang berbeza boleh digabungkan. Apabila ditetapkan kepada 0, hanya halaman yang
secara fizikal berada dalam kawasan memori nod NUMA yang sama boleh digabungkan. Apabila ditetapkan kepada 1,
halaman daripada semua nod boleh digabungkan. Lalai kepada 1.

Nota: Pada masa ini "perkhidmatan memori yang dikongsi" hanya bermaksud KSM (Kernel Samepage Merging).

keupayaan
Cetak dokumen XML yang menerangkan keupayaan hypervisor yang kita ada sekarang
berhubung dengan. Ini termasuk bahagian tentang keupayaan hos dari segi CPU dan
ciri, dan satu set penerangan untuk setiap jenis tetamu yang boleh dimaya.
Untuk penerangan yang lebih lengkap lihat:
<http://libvirt.org/formatcaps.html> XML juga menunjukkan maklumat topologi NUMA
jika ada.

kebolehkuasaan [virttype] [emulatorbin] [gerbang] [mesin]
Cetak dokumen XML yang menerangkan keupayaan domain untuk hypervisor kami
disambungkan kepada menggunakan maklumat sama ada bersumberkan daripada domain sedia ada atau diambil daripada
yang dara keupayaan pengeluaran. Ini mungkin berguna jika anda berhasrat untuk membuat domain baharu
dan ingin tahu jika misalnya ia boleh menggunakan VFIO dengan mencipta domain untuk
hypervisor dengan emulator dan seni bina khusus.

Setiap hypervisor akan mempunyai keperluan yang berbeza mengenai pilihan yang diperlukan
dan yang merupakan pilihan. Hypervisor boleh menyokong menyediakan nilai lalai untuk mana-mana
pilihan.

. virttype pilihan menentukan jenis virtualisasi yang digunakan. Nilai yang akan digunakan ialah
sama ada daripada atribut 'jenis' bagi elemen peringkat atas daripada domain
XML atau atribut 'jenis' yang terdapat dalam setiap satu unsur daripada dara
keupayaan pengeluaran. The emulatorbin pilihan menentukan laluan ke emulator. The
nilai yang akan digunakan ialah sama ada elemen dalam XML domain atau dara
keupayaan pengeluaran. The gerbang pilihan menentukan seni bina yang akan digunakan untuk
domain. Nilai yang akan digunakan ialah sama ada atribut "arch" daripada XML domain
unsur dan subelemen atau atribut "nama" an unsur
daripada dara keupayaan pengeluaran. The mesin menentukan jenis mesin untuk
emulator. Nilai yang akan digunakan ialah sama ada atribut "mesin" daripada XML domain
unsur dan subelemen atau satu daripada senarai mesin daripada dara
keupayaan output untuk seni bina dan jenis domain tertentu.

Untuk hypervisor qemu, a virttype sama ada 'qemu' atau 'kvm' mesti dibekalkan bersama
dengan sama ada emulatorbin or gerbang untuk menjana output untuk lalai
mesin. Membekalkan a mesin nilai akan menjana output untuk mesin tertentu.

inject-nmi domain
Suntikan NMI kepada tetamu.

senarai [--tidak aktif | --semua] [--terurus-simpan] [--tajuk] { [--meja] | --nama | --uuuid }
[--berterusan] [--sementara] [--dengan-terurus-simpan] [--tanpa-terurus-simpan] [--autostart]
[--tiada-autostart] [--dengan-snapshot] [--tanpa-snapshot] [--berjalan negara] [--negeri-jeda]
[--negeri-tutup] [--negeri-lain]
Mencetak maklumat tentang domain sedia ada. Jika tiada pilihan dinyatakan, ia akan dicetak
maklumat tentang menjalankan domain.

Contoh format untuk senarai adalah seperti berikut:

dara senarai
Negeri Nama Id
-------------------------------------------------- -
0 Domain-0 berjalan
2 fedora berhenti seketika

Nama ialah nama domain. ID id angka domain. Negeri ialah keadaan larian
(lihat di bawah).

NEGERI

Medan Negeri menyenaraikan 8 keadaan untuk domain, dan dalam mana domain semasa berada.

berlari
Domain sedang berjalan pada CPU

terbiar
Domain melahu, dan tidak berjalan atau boleh dijalankan. Ini boleh disebabkan kerana
domain sedang menunggu di IO (keadaan menunggu tradisional) atau telah tidur kerana
tiada apa-apa lagi yang boleh dilakukannya.

dihentikan sementara
Domain telah dijeda, biasanya berlaku melalui pentadbir berjalan
dara Menggantung. Apabila dalam keadaan dijeda domain masih akan menggunakan yang diperuntukkan
sumber seperti ingatan, tetapi tidak akan layak untuk penjadualan oleh hypervisor.

penutupan
Domain sedang dalam proses penutupan, iaitu sistem pengendalian tetamu telah
telah dimaklumkan dan sepatutnya dalam proses menghentikan operasinya dengan anggun.

menutup off
Domain tidak berjalan. Biasanya ini menunjukkan domain telah ditutup
sepenuhnya, atau belum dimulakan.

terhempas
Domain telah ranap, yang sentiasa berakhir dengan ganas. Biasanya negeri ini boleh
hanya berlaku jika domain telah dikonfigurasikan untuk tidak dimulakan semula apabila ranap.

mati
Domain sedang dalam proses untuk mati, tetapi belum ditutup sepenuhnya atau ranap.

pmsuspended
Domain telah digantung oleh pengurusan kuasa tetamu, contohnya dimasukkan ke dalam s3
negeri.

Biasanya hanya domain aktif disenaraikan. Untuk menyenaraikan domain tidak aktif tentukan --tidak aktif
or --semua untuk menyenaraikan kedua-dua domain aktif dan tidak aktif.

Untuk menapis lagi senarai domain, anda boleh menentukan satu atau lebih bendera penapisan
disokong oleh senarai perintah. Bendera ini dikumpulkan mengikut fungsi. Menentukan satu atau
lebih banyak bendera daripada kumpulan membolehkan kumpulan penapis. Ambil perhatian bahawa beberapa gabungan bendera
mungkin tidak membuahkan hasil. Bendera dan kumpulan penapisan yang disokong:

Kegigihan
Bendera --berterusan digunakan untuk memasukkan domain berterusan dalam senarai yang dikembalikan. Kepada
sertakan domain sementara tentukan --sementara.

Kewujudan of berjaya menyelamatkan gambar
Untuk menyenaraikan domain yang mempunyai imej simpan terurus, nyatakan bendera --dengan-terurus-simpan. Untuk
domain yang tidak mempunyai imej simpan terurus nyatakan --tanpa-terurus-simpan.

domain adalah
Bendera penapis berikut memilih domain mengikut keadaannya: --berjalan negara khususnya
menjalankan domain, --negeri-jeda untuk domain yang dijeda, --negeri-tutup untuk berpaling
luar domain dan --negeri-lain untuk semua negeri lain sebagai sandaran.

Automula domain
Untuk menyenaraikan domain autostart gunakan bendera --autostart. Untuk menyenaraikan domain dengan ini
ciri penggunaan dilumpuhkan --tiada-autostart.

Tangkapan kewujudan
Domain yang mempunyai imej syot kilat boleh disenaraikan menggunakan bendera --dengan-snapshot,
domain tanpa syot kilat --tanpa-snapshot.

Apabila bercakap dengan pelayan lama, arahan ini terpaksa menggunakan satu siri panggilan API
dengan kaum yang wujud, di mana domain mungkin tidak disenaraikan atau mungkin muncul lebih daripada
sekali jika ia menukar keadaan antara panggilan semasa senarai sedang dikumpulkan. Lebih baru
pelayan tidak mempunyai masalah ini.

If --terurus-simpan ditentukan, kemudian domain yang telah berjaya menyimpan keadaan (hanya
mungkin jika mereka berada dalam menutup off nyatakan, jadi anda perlu nyatakan --tidak aktif or --semua
untuk menyenaraikannya) sebaliknya akan ditunjukkan sebagai disimpan dalam penyenaraian. Bendera ini boleh digunakan
hanya dengan lalai --meja pengeluaran. Ambil perhatian bahawa bendera ini tidak menapis senarai
domain.

If --nama ditentukan, nama domain dicetak dan bukannya jadual yang diformatkan
setiap baris. Jika --uuuid adalah UUID domain yang ditentukan dicetak bukannya nama. Bendera
--meja menentukan bahawa output berformat jadual warisan harus digunakan. Ini adalah
lalai. Semua ini adalah saling eksklusif.

If --tajuk ditentukan, maka perihalan domain pendek (tajuk) dicetak dalam
lajur tambahan. Bendera ini hanya boleh digunakan dengan lalai --meja output.

Contoh:

dara senarai --tajuk
Nama Id Tajuk Negeri
-------------------------------------------------- ------------------------
0 Domain-0 menjalankan Pelayan Mel 1
2 fedora berhenti seketika

freecell [{ [--selno] cellno | --semua }]
Mencetak jumlah memori yang tersedia pada mesin atau dalam sel NUMA. The
arahan freecell boleh menyediakan satu daripada tiga paparan berbeza memori yang tersedia pada
mesin bergantung pada pilihan yang ditentukan. Tanpa pilihan, ia memaparkan
jumlah memori percuma pada mesin. Dengan pilihan --semua, ia memaparkan memori percuma
dalam setiap sel dan jumlah memori percuma pada mesin. Akhirnya, dengan angka
hujah atau dengan --cellno tambah nombor sel ia akan memaparkan memori percuma untuk
sel yang ditentukan sahaja.

halaman bebas [{ [--selno] cellno [--saiz halaman] saiz halaman | --semua }]
Mencetak jumlah halaman yang tersedia dalam sel NUMA. cellno merujuk kepada NUMA
sel yang anda minati. saiz halaman ialah integer berskala (lihat NOTA di atas).
Sebagai alternatif, jika --semua digunakan, maklumat tentang setiap kemungkinan gabungan sel NUMA dan
saiz halaman dicetak.

peruntukan [--saiz halaman] saiz halaman [--bilangan halaman] pagecount [[--selno] cellno] [--Tambah]
[--semua]
Tukar saiz kumpulan halaman daripada saiz halaman pada tuan rumah. Jika --Tambah ditentukan, maka
pagecount halaman ditambahkan ke dalam kolam. Namun, jika --Tambah tidak dinyatakan, maka
pagecount diambil sebagai saiz mutlak kolam yang baharu (ini boleh digunakan untuk membebaskan beberapa
halaman dan saiz kolam ke bawah). The cellno pengubah suai boleh digunakan untuk menyempitkan
pengubahsuaian turun kepada sel NUMA hos tunggal. Di hujung spektrum yang lain terletak --semua
yang melaksanakan pengubahsuaian pada semua sel NUMA.

cpu-baseline FAIL [--ciri-ciri] [--boleh berhijrah]
Kirakan CPU garis dasar yang akan disokong oleh semua CPU hos yang diberikan . The
senarai CPU hos dibina dengan mengekstrak semua elemen daripada . Oleh itu,
boleh mengandungi sama ada satu set elemen yang dipisahkan oleh baris baru atau pun satu set
daripada lengkap elemen yang dicetak oleh keupayaan perintah. Jika --ciri-ciri is
ditentukan maka penerangan XML yang terhasil akan secara eksplisit menyertakan semua ciri yang
membentuk CPU, tanpa ciri pilihan ini yang merupakan sebahagian daripada model CPU tidak akan
disenaraikan dalam huraian XML. Jika --boleh berhijrah ditentukan, ciri yang menyekat
migrasi tidak akan disertakan dalam CPU yang terhasil.

cpu-bandingkan FAIL [--kesilapan]
Bandingkan definisi CPU daripada XML dengan CPU hos. XML mungkin mengandungi
sama ada definisi CPU hos atau tetamu. Definisi CPU hos ialah unsur dan
kandungannya seperti yang dicetak oleh keupayaan perintah. Definisi CPU tetamu ialah
elemen dan kandungannya daripada definisi XML domain. Untuk maklumat lanjut tentang CPU tetamu
definisi lihat:http://libvirt.org/formatdomain.html#elemenCPU>. Jika --kesilapan is
ditentukan, arahan akan mengembalikan ralat apabila CPU yang diberikan tidak serasi dengan
CPU hos dan mesej yang memberikan butiran lanjut tentang ketidakserasian akan menjadi
dicetak.

model cpu gerbang
Cetak senarai model CPU yang dikenali untuk seni bina yang ditentukan.

echo [- cengkaman] [--xml] [berhujah...]
Gema balik masing-masing berhujah, dipisahkan oleh ruang. Jika - cengkaman ditentukan, maka output akan
dipetik tunggal jika perlu, supaya ia sesuai untuk digunakan semula dalam konteks shell.
If --xml ditentukan, maka output akan dikeluarkan untuk digunakan dalam XML.

DOMAIN PERINTAH

Perintah berikut memanipulasi domain secara langsung, seperti yang dinyatakan sebelum ini kebanyakan arahan
ambil domain sebagai parameter pertama. The domain boleh ditentukan sebagai integer pendek, nama
atau UUID penuh.

autostart [--lumpuhkan] domain
Konfigurasikan domain untuk dimulakan secara automatik semasa but.

pilihan --lumpuhkan melumpuhkan automula.

konsul domain [nama dev] [--selamat] [- kekuatan]
Sambungkan konsol bersiri maya untuk tetamu. Pilihan nama dev parameter
merujuk kepada alias peranti konsol ganti, peranti bersiri atau selari
dikonfigurasikan untuk tetamu. Jika ditinggalkan, konsol utama akan dibuka.

Jika bendera --selamat ditentukan, sambungan hanya dicuba jika pemandu
menyokong pengendalian konsol yang selamat. Bendera ini menyatakan bahawa pelayan perlu memastikan
akses eksklusif kepada peranti konsol. Secara pilihan - kekuatan bendera boleh ditentukan,
meminta untuk memutuskan sambungan mana-mana sesi sedia ada, seperti dalam kes rosak
sambungan.

mewujudkan FAIL [--konsol] [--jeda] [--autodestroy] [--lulus-fds N, M,...]
Buat domain daripada XML . Cara mudah untuk mencipta XML ialah menggunakan
dumpxml arahan untuk mendapatkan definisi tetamu yang sedia ada. Domain akan menjadi
dijeda jika --jeda pilihan digunakan dan disokong oleh pemandu; jika tidak ia akan
berlari. Jika --konsol diminta, lampirkan pada konsol selepas penciptaan. Jika
--autodestroy diminta, maka tetamu itu akan dimusnahkan secara automatik apabila virsh
menutup sambungannya ke libvirt, atau sebaliknya keluar.

If --lulus-fds ditentukan, hujahnya ialah senarai fail terbuka yang dipisahkan koma
deskriptor yang harus disampaikan kepada tetamu. Deskriptor fail akan di-
bernombor dalam tetamu, bermula dari 3. Ini hanya disokong dengan berasaskan bekas
virtualisasi.

Contoh

virsh dumpxml > domain.xml
vi domain.xml (atau buat perubahan dengan editor teks anda yang lain)
virsh buat domain.xml

menentukan FAIL
Tentukan domain daripada XML . Takrif domain didaftarkan tetapi tidak
bermula. Jika domain sudah berjalan, perubahan akan berkuat kuasa pada but seterusnya.

menurun domain [[--hidup] [--config] | [--semasa]] [--tajuk] [--edit] [--baharu-desc Baru
penerangan atau mesej tajuk]
Tunjukkan atau ubah suai perihalan dan tajuk domain. Nilai ini adalah medan pengguna yang
membenarkan untuk menyimpan data teks sewenang-wenangnya untuk membolehkan pengenalan domain yang mudah. Tajuk
sepatutnya pendek, walaupun ia tidak dikuatkuasakan. (Lihat juga metadata yang berfungsi dengan XML
metadata domain berasaskan.)

Flags --hidup or --config pilih sama ada arahan ini berfungsi secara langsung atau berterusan
definisi domain. Jika kedua-duanya --hidup and --config dinyatakan, iaitu --config
pilihan diutamakan untuk mendapatkan penerangan semasa dan kedua-dua konfigurasi langsung
dan konfigurasi dikemas kini semasa menetapkan penerangan. --semasa adalah eksklusif dan
tersirat jika tiada satu pun daripada ini dinyatakan.

Bendera --edit menentukan bahawa editor dengan kandungan perihalan atau tajuk semasa
hendaklah dibuka dan kandungannya disimpan semula selepas itu.

Bendera --tajuk memilih operasi pada medan tajuk dan bukannya penerangan.

Jika tiada satu pun --edit and --baharu-desc dinyatakan nota atau penerangan dipaparkan
bukannya diubah suai.

memusnahkan domain [--anggun]
Tamatkan domain dengan serta-merta domain. Ini tidak memberi peluang kepada OS domain
untuk bertindak balas, dan ia sama dengan mencabut kord kuasa pada mesin fizikal.
Dalam kebanyakan kes anda akan mahu menggunakan penutupan arahan sebaliknya. Walau bagaimanapun, ini berlaku
tidak memadamkan sebarang volum storan yang digunakan oleh tetamu, dan jika domain itu berterusan, ia
boleh dimulakan semula kemudian.

If domain adalah sementara, maka metadata mana-mana syot kilat akan hilang sebaik sahaja tetamu
berhenti berjalan, tetapi kandungan syot kilat masih wujud, dan domain baharu dengan yang sama
name dan UUID boleh memulihkan metadata syot kilat dengan snapshot-buat.

If --anggun dinyatakan, jangan gunakan langkah melampau (cth SIGKILL) apabila
tetamu tidak berhenti selepas tamat masa yang munasabah; kembalikan ralat sebaliknya.

domblkstat domain [peranti blok] [--manusia]
Dapatkan statistik blok peranti untuk domain yang sedang berjalan. A peranti blok sepadan dengan yang unik
nama sasaran ( ) atau fail sumber ( ) untuk salah satu daripada
peranti cakera yang dilampirkan domain (Lihat juga senarai domblk untuk menyenaraikan nama-nama ini). hidup
domain lxc atau qemu, mengetepikan peranti blok menghasilkan statistik blok peranti secara ringkas
untuk keseluruhan domain.

Penggunaan --manusia untuk output yang lebih mudah dibaca oleh manusia.

Ketersediaan medan ini bergantung pada hypervisor. Medan yang tidak disokong tiada
daripada keluaran. Medan lain mungkin muncul jika berkomunikasi dengan versi yang lebih baharu
libvirtd.

penjelasan of bidang (medan muncul dalam susunan berikut):
rd_req - kiraan operasi baca
rd_bytes - kiraan bait yang dibaca
wr_req - kiraan operasi tulis
wr_bytes - kiraan bait bertulis
kesilapan - kiraan ralat
flush_operations - kiraan operasi flush
rd_total_times - jumlah masa operasi membaca yang diambil (ns)
wr_total_times - jumlah masa operasi menulis yang diambil (ns)
flush_total_times - jumlah masa operasi flush diambil (ns)
<-- medan lain yang disediakan oleh hypervisor -->

domifaddr domain [antara muka] [--penuh] [--sumber pajakan|ejen]
Dapatkan senarai antara muka domain yang sedang berjalan bersama-sama dengan alamat IP dan MAC mereka, atau
keluaran terhad hanya untuk satu antara muka jika antara muka dinyatakan. Perhatikan bahawa antara muka
boleh bergantung kepada pemandu, ia boleh menjadi nama dalam OS tetamu atau nama yang anda akan lihat
dalam domain XML. Selain itu, keseluruhan arahan mungkin memerlukan ejen tetamu untuk dikonfigurasikan
untuk domain pertanyaan di bawah beberapa pemacu, terutamanya qemu. Jika --penuh dinyatakan, iaitu
nama antara muka sentiasa dipaparkan apabila antara muka mempunyai berbilang alamat atau alias,
jika tidak, ia hanya memaparkan nama antara muka untuk alamat pertama, dan "-" untuk
yang lain. The --sumber argumen menentukan sumber data yang hendak digunakan untuk alamat,
pada masa ini salah satu daripada 'pajakan' untuk membaca pajakan DHCP, atau 'ejen' untuk menanyakan OS tetamu melalui
ejen. Jika tidak dinyatakan, 'pajakan' ialah lalai.

dominfstat domain peranti antara muka
Dapatkan statistik antara muka rangkaian untuk domain yang sedang berjalan.

pautan set-dominf domain peranti antara muka adalah [--config]
Ubah suai keadaan pautan antara muka maya domain. Nilai yang mungkin untuk keadaan ialah
"atas dan bawah". Jika --config ditentukan, hanya konfigurasi berterusan bagi
domain diubah suai, untuk tujuan keserasian, --berterusan adalah alias daripada --config.
peranti antara muka boleh menjadi nama sasaran antara muka atau alamat MAC.

domif-getlink domain peranti antara muka [--config]
Keadaan pautan pertanyaan bagi antara muka maya domain. Jika --config ditentukan, pertanyaan
konfigurasi berterusan, untuk tujuan keserasian, --berterusan adalah alias daripada
--config.

peranti antara muka boleh menjadi nama sasaran antara muka atau alamat MAC.

domiftune domain peranti antara muka [[--config] [--hidup] | [--semasa]] [--masuk
purata, puncak, pecah, lantai] [--keluar purata, puncak, pecah]
Tetapkan atau tanya parameter lebar jalur antara muka rangkaian domain. peranti antara muka
boleh menjadi nama sasaran antara muka ( ), atau alamat MAC.

Jika tidak --masuk or --keluar ditentukan, arahan ini akan bertanya dan menunjukkan
tetapan lebar jalur. Jika tidak, ia akan menetapkan lebar jalur masuk atau keluar.
purata, puncak, pecah, lantai adalah sama seperti dalam perintah attach-interface. Nilai untuk
purata, puncak and lantai dinyatakan dalam kilobait sesaat, manakala pecah is
dinyatakan dalam kilobait dalam satu letusan pada puncak kelajuan seperti yang diterangkan dalam XML Rangkaian
dokumentasi dihttp://libvirt.org/formatnetwork.html#elementQoS>.

Untuk mengosongkan tetapan masuk atau keluar, gunakan --masuk or --keluar hormat dengan
nilai purata sifar.

If --hidup ditentukan, menjejaskan tetamu yang sedang berjalan. Jika --config ditentukan, mempengaruhi
but seterusnya tetamu yang gigih. Jika --semasa ditentukan, menjejaskan tetamu semasa
negeri. Kedua-duanya --hidup and --config bendera boleh diberikan, tetapi --semasa adalah eksklusif. Jika tidak
bendera ditentukan, tingkah laku berbeza bergantung pada hipervisor.

dommemstat domain [--tempoh saat] [[--config] [--hidup] | [--semasa]]
Dapatkan statistik memori untuk domain yang sedang berjalan.

Bergantung pada hipervisor, pelbagai statistik boleh dikembalikan

Untuk QEMU/KVM dengan belon memori, tetapkan pilihan --tempoh kepada nilai yang lebih besar
daripada 0 dalam saat akan membolehkan pemandu belon mengembalikan statistik tambahan yang
akan dipaparkan oleh yang berikutnya dommemstat arahan. Menetapkan --tempoh kepada 0 kehendak
hentikan pengumpulan pemandu belon, tetapi tidak mengosongkan statistik dalam belon
pemandu. Memerlukan sekurang-kurangnya QEMU/KVM 1.5 untuk dijalankan pada hos.

. --hidup, --config, dan --semasa bendera hanya sah apabila menggunakan --tempoh
pilihan untuk menetapkan tempoh pengumpulan untuk pemandu belon. Jika --hidup is
ditentukan, hanya tempoh pengumpulan tetamu yang sedang berjalan terjejas. Jika --config is
ditentukan, menjejaskan but seterusnya tetamu yang berterusan. Jika --semasa dinyatakan,
mempengaruhi keadaan tetamu semasa.

Kedua-dua --hidup and --config bendera boleh diberikan, tetapi --semasa adalah eksklusif. Jika tiada bendera
ditentukan, tingkah laku adalah berbeza bergantung pada keadaan tetamu.

domblkerror domain
Tunjukkan ralat pada peranti sekat. Perintah ini biasanya berguna apabila domstate arahan
mengatakan bahawa domain telah dijeda kerana ralat I/O. The domblkerror arahan menyenaraikan semua
menyekat peranti dalam keadaan ralat dan ralat yang dilihat pada setiap satu daripadanya.

domblkinfo domain peranti blok
Dapatkan maklumat saiz peranti sekat untuk domain. A peranti blok sepadan dengan yang unik
nama sasaran ( ) atau fail sumber ( ) untuk salah satu daripada
peranti cakera yang dilampirkan domain (Lihat juga senarai domblk untuk menyenaraikan nama-nama ini).

senarai domblk domain [--tidak aktif] [--perincian]
Cetak jadual yang menunjukkan maklumat ringkas semua peranti blok yang dikaitkan dengannya
domain. Jika --tidak aktif ditentukan, tanya peranti blok yang akan digunakan pada
but seterusnya, bukannya yang sedang digunakan oleh domain yang sedang berjalan. Jika --perincian is
ditentukan, jenis cakera dan nilai peranti juga akan dicetak. Konteks lain yang
memerlukan nama peranti blok (seperti domblkinfo or snapshot-buat untuk gambar cakera)
akan menerima sama ada nama sumber sasaran atau unik yang dicetak oleh arahan ini.

domstats [--mentah] [--kuatkuasakan] [--sandaran] [--negeri] [--cpu-jumlah] [--belon] [--vcpu]
[--antara muka] [--sekat] [[--senarai-aktif] [--senarai-tidak aktif] [--senarai-berterusan]
[--senarai-sementara] [--list-running] [--senarai-dijeda] [--senarai-tutup] [--senarai-lain]] |
[domain ...]
Dapatkan statistik untuk berbilang atau semua domain. Tanpa sebarang hujah arahan ini dicetak
semua statistik yang tersedia untuk semua domain.

Senarai domain untuk mengumpulkan statistik boleh dihadkan sama ada dengan menyenaraikan domain
sebagai senarai yang diasingkan ruang, atau dengan menentukan salah satu bendera penapisan --senarai-*. (The
pendekatan tidak boleh digabungkan.)

Secara lalai beberapa medan yang dikembalikan mungkin ditukar kepada nilai yang lebih mesra manusia
oleh satu set pencetak cantik. Untuk menyekat tingkah laku ini gunakan --mentah bendera.

Kumpulan statistik individu boleh dipilih melalui bendera tertentu. Secara lalai semua
kumpulan statistik yang disokong dikembalikan. Bendera kumpulan statistik yang disokong ialah:
--negeri, --cpu-jumlah, --belon, --vcpu, --antara muka, --sekat.

Semasa memilih --negeri kumpulan medan berikut dikembalikan: "state.state" -
keadaan VM, dikembalikan sebagai nombor daripada enum virDomainState, "state.reason" - sebab
untuk memasuki keadaan yang diberikan, dikembalikan sebagai int daripada virDomain*Reason enum yang sepadan dengan
negeri yang diberi.

--cpu-jumlah pulangan: "cpu.time" - jumlah masa cpu yang dibelanjakan untuk domain ini dalam nanosaat,
"cpu.user" - masa cpu pengguna dihabiskan dalam nanosaat, "cpu.system" - masa cpu sistem dibelanjakan
dalam nanosaat

--belon kembali: "balloon.current" - memori dalam kiB yang sedang digunakan,
"belon.maksimum" - memori maksimum dalam kiB dibenarkan

--vcpu pulangan: "vcpu.current" - bilangan semasa CPU maya dalam talian, "vcpu.maximum"
- bilangan maksimum CPU maya dalam talian, "vcpu. .state" - keadaan CPU maya
, sebagai nombor daripada enum virVcpuState, "vcpu. .masa" - masa cpu maya yang dibelanjakan oleh
CPU maya

--antara muka pulangan: "net.count" - bilangan antara muka rangkaian pada domain ini,
"bersih. .name" - nama antara muka , "bersih. .rx.bytes" - bilangan bait
diterima, "bersih. .rx.pkts" - bilangan paket yang diterima, "net. .rx.errs" -
bilangan ralat terima, "net. .rx.drop" - bilangan paket terima digugurkan,
"bersih. .tx.bytes" - bilangan bait yang dihantar, "net. .tx.pkts" - bilangan
paket dihantar, "net. .tx.errs" - bilangan ralat penghantaran,
"bersih. .tx.drop" - bilangan paket penghantaran digugurkan

--sekat mengembalikan maklumat tentang cakera yang dikaitkan dengan setiap domain. Menggunakan
--sandaran bendera memanjangkan maklumat ini untuk merangkumi semua sumber dalam rantaian sokongan,
bukannya lalai mengehadkan maklumat kepada lapisan aktif untuk setiap tetamu
cakera. Maklumat yang disenaraikan termasuk: "block.count" - bilangan peranti yang disekat
disenaraikan, "blok. .name" - nama sasaran peranti blok (sama
nama untuk berbilang entri jika --sandaran hadir), "blok. .backingIndex" - bila
--sandaran hadir, sepadan dengan indeks disenaraikan dalam domain XML
untuk fail sokongan, "block. .path" - sumber fail peranti blok , jika ia adalah a
fail tempatan atau peranti sekat, "block. .rd.reqs" - bilangan permintaan baca,
"sekat. .rd.bytes" - bilangan bait baca, "block. .rd.times" - jumlah masa
(ns) dibelanjakan untuk membaca, "block. .wr.reqs" - bilangan permintaan tulis,
"sekat. .wr.bytes" - bilangan bait bertulis, "block. .wr.times" - jumlah masa
(ns) dibelanjakan untuk menulis, "block. .fl.reqs" - jumlah permintaan flush,
"sekat. .fl.times" - jumlah masa (ns) yang dibelanjakan untuk pembilasan cache, "block. .errors"
- Xen sahaja: nilai 'oo_req', "block. .peruntukan" - mengimbangi penulisan tertinggi
sektor dalam bait, "block. .capacity" - saiz logik fail sumber dalam bait,
"sekat. .fizikal" - saiz fizikal fail sumber dalam bait

Memilih kumpulan statistik tertentu tidak menjamin bahawa daemon menyokong
kumpulan statistik yang dipilih. Bendera --kuatkuasakan memaksa arahan gagal jika daemon
tidak menyokong kumpulan yang dipilih.

senarai domain domain [--tidak aktif]
Cetak jadual yang menunjukkan maklumat ringkas semua antara muka maya yang dikaitkan dengan
domain. Jika --tidak aktif ditentukan, tanya antara muka maya yang akan digunakan pada
but seterusnya, bukannya yang sedang digunakan oleh domain yang sedang berjalan. Konteks lain
yang memerlukan alamat MAC antara muka maya (seperti detach-interface or domin-
setlink) akan menerima alamat MAC yang dicetak oleh arahan ini.

blockcommit domain jalan [jalur lebar] [asas] [--cetek] [bahagian] [--padam] [--jaga-saudara]
[--tunggu [--async] [--verbose]] [--masa tamat saat] [--aktif] [{--pangsi | --simpan-tindih}]
Kurangkan panjang rantai imej sandaran, dengan melakukan perubahan di bahagian atas
rantai (fail syot kilat atau delta) ke dalam imej sandaran. Secara lalai, arahan ini
cuba meratakan keseluruhan rantai. Jika asas dan / atau bahagian dinyatakan sebagai fail
dalam rantaian sokongan, maka operasi dikekang untuk melakukan perkara itu sahaja
bahagian rantai; --cetek boleh digunakan sebagai ganti asas untuk menyatakan segera
fail sokongan imej teratas yang terhasil untuk dilakukan. Fail sedang dilakukan
menjadi tidak sah, mungkin sebaik sahaja operasi bermula; menggunakan --padam
flag akan cuba mengalih keluar fail yang tidak sah ini apabila berjaya menyiapkan
operasi komit. Apabila --jaga-saudara bendera digunakan, laluan fail sokongan
akan kekal relatif.

Bila bahagian ditinggalkan atau dinyatakan sebagai imej aktif, ia juga mungkin untuk ditentukan
--aktif untuk mencetuskan komit aktif dua fasa. Pada fasa pertama, bahagian disalin ke dalam
asas dan kerja itu hanya boleh dibatalkan, dengan bahagian atas masih mengandungi data yang belum berada di pangkalan.
Dalam fasa kedua, bahagian and asas kekal sama sehingga panggilan ke kerja sekatan dengan
--menggugurkan kandungan bendera (menjaga bahagian atas sebagai imej aktif yang menjejaki perubahan dari titik itu
masa) atau --pangsi bendera (menjadikan asas imej aktif baharu dan bahagian atas yang tidak sah).

Secara lalai, arahan ini kembali secepat mungkin, dan data untuk keseluruhan cakera adalah
komited di latar belakang; kemajuan operasi boleh disemak dengan
kerja sekatan. Walau bagaimanapun, sekiranya --tunggu ditentukan, maka arahan ini akan menyekat sehingga
operasi selesai (atau untuk --aktif, memasuki fasa kedua), atau sehingga operasi
dibatalkan kerana pilihan timeout dalam beberapa saat berlalu atau SIGINT dihantar (biasanya
dengan "Ctrl-C"). menggunakan --verbose bersama-sama dengan --tunggu akan menghasilkan status berkala
kemas kini. Jika pembatalan kerja dicetuskan, --async akan mengembalikan kawalan kepada pengguna sebagai
secepat mungkin, jika tidak, arahan itu boleh terus menyekat sedikit masa lagi
sehingga kerja selesai membersihkan. menggunakan --pangsi adalah singkatan untuk menggabungkan --aktif
--tunggu dengan automatik kerja sekatan --pangsi; dan menggunakan --simpan-tindih adalah singkatan untuk
menggabungkan --aktif --tunggu dengan automatik kerja sekatan --menggugurkan kandungan.

jalan menentukan laluan cakera yang layak sepenuhnya; ia sepadan dengan sasaran yang unik
nama ( ) atau fail sumber ( ) untuk salah satu cakera
peranti yang dilampirkan pada domain (Lihat juga senarai domblk untuk menyenaraikan nama-nama ini). jalur lebar
menentukan had lebar jalur penyalinan dalam MiB/s, walaupun untuk qemu, ia mungkin bukan sifar sahaja
untuk domain dalam talian. Menentukan nilai negatif ditafsirkan sebagai panjang yang tidak ditandatangani
nilai panjang atau pada asasnya tidak terhad. Hypervisor boleh memilih sama ada untuk menolak
nilai atau tukarkannya kepada nilai maksimum yang dibenarkan.

salinan blok domain jalan { destinasi [format] [--blockdev] | --xml fail } [--cetek]
[--guna semula-luaran] [jalur lebar] [--tunggu [--async] [--verbose]] [{--pangsi | --selesai}]
[--masa tamat saat] [butiran] [bersaiz buf]
Salin rantai imej sokongan cakera ke destinasi. sama ada destinasi sebagai fail destinasi
nama, atau --xml dengan nama fail XML yang mengandungi peringkat teratas unsur
menerangkan destinasi, mesti ada. Selain itu, jika destinasi diberikan, format
hendaklah dinyatakan untuk mengisytiharkan format destinasi (jika format ditinggalkan,
maka libvirt akan menggunakan semula format sumber, atau dengan --guna semula-luaran akan
terpaksa menyiasat format destinasi, yang boleh menjadi lubang keselamatan yang berpotensi).
Perintah menyokong --mentah sebagai sinonim bendera boolean untuk --format=mentah. Semasa menggunakan
destinasi, destinasi dianggap sebagai fail biasa melainkan --blockdev digunakan untuk memberi isyarat
bahawa ia adalah peranti blok. Secara lalai, arahan ini meratakan keseluruhan rantai; tetapi kalau
--cetek ditentukan, salinan berkongsi rantai sokongan.

If --guna semula-luaran ditentukan, maka destinasi mestilah wujud dan mencukupi
ruang untuk menyimpan salinan. Jika --cetek digunakan bersama dengan --guna semula-luaran kemudian
imej yang telah dibuat mesti mempunyai kandungan yang boleh dilihat oleh tetamu yang sama dengan yang boleh dilihat oleh tetamu
kandungan fail sandaran imej asal. Ini boleh digunakan untuk mengubah suai
menyandarkan nama fail pada destinasi.

Secara lalai, kerja salin berjalan di latar belakang, dan terdiri daripada dua fasa.
Pada mulanya, kerja mesti menyalin semua data daripada sumber, dan semasa fasa ini, tugas itu
hanya boleh dibatalkan untuk kembali ke cakera sumber, tanpa jaminan tentang
destinasi. Selepas fasa ini selesai, kedua-dua sumber dan destinasi kekal
dicerminkan sehingga panggilan ke kerja sekatan dengan --menggugurkan kandungan and --pangsi bendera berputar ke atas
salinan, atau panggilan tanpa --pangsi meninggalkan destinasi sebagai salinan setia itu
titik dalam masa. Namun, jika --tunggu ditentukan, maka arahan ini akan menyekat sehingga
fasa pencerminan bermula, atau batalkan operasi jika pilihan timeout dalam beberapa saat
berlalu atau SIGINT dihantar (biasanya dengan "Ctrl-C"). menggunakan --verbose bersama-sama dengan --tunggu
akan menghasilkan kemas kini status berkala. menggunakan --pangsi (sama seperti kerja sekatan --pangsi) Atau
--selesai (sama seperti kerja sekatan --menggugurkan kandungan) membayangkan --tunggu, dan juga akan menamatkan
bekerja dengan bersih dan bukannya meninggalkan perkara dalam fasa pencerminan. Jika pembatalan kerja adalah
dicetuskan oleh tamat masa atau oleh --selesai, --async akan mengembalikan kawalan kepada pengguna secepat
mungkin, jika tidak arahan itu boleh terus menyekat sedikit masa lagi sehingga
kerja itu sebenarnya telah dibatalkan.

jalan menentukan laluan cakera yang layak sepenuhnya. jalur lebar menentukan penyalinan
had lebar jalur dalam MiB/s. Menentukan nilai negatif ditafsirkan sebagai tidak ditandatangani
nilai panjang panjang yang mungkin pada asasnya tidak terhad, tetapi kemungkinan besar akan melimpah;
adalah lebih selamat untuk menggunakan 0 untuk tujuan itu. Menentukan butiran membolehkan penalaan halus
butiran yang akan disalin apabila kawasan kotor dikesan; nilai yang lebih besar
mencetuskan kurang overhed I/O tetapi mungkin akhirnya menyalin lebih banyak data secara keseluruhan (nilai lalai
biasanya betul); hypervisor mungkin mengehadkan ini menjadi kuasa dua atau jatuh ke dalam
julat tertentu. Menentukan bersaiz buf akan mengawal berapa banyak data boleh serentak
dalam penerbangan semasa salinan; nilai yang lebih besar menggunakan lebih banyak memori tetapi mungkin membenarkan lebih cepat
penyiapan (nilai lalai biasanya betul).

tarik sekat domain jalan [jalur lebar] [asas] [--tunggu [--verbose] [--masa tamat saat]
[--async]] [--jaga-saudara]
Isi cakera daripada rantai imej sandarannya. Secara lalai, arahan ini meratakan
keseluruhan rantai; tetapi kalau asas ditentukan, mengandungi nama salah satu sandaran
fail dalam rantaian, maka fail itu menjadi fail sandaran baharu dan hanya fail
bahagian perantaraan rantai ditarik. Setelah semua data yang diminta dari sandaran
rantai imej telah ditarik, cakera tidak lagi bergantung pada bahagian sandaran itu
rantai.

Secara lalai, arahan ini kembali secepat mungkin, dan data untuk keseluruhan cakera adalah
ditarik di latar belakang; kemajuan operasi boleh disemak dengan kerja sekatan.
Walau bagaimanapun, sekiranya --tunggu ditentukan, maka arahan ini akan menyekat sehingga operasi
selesai, atau batalkan operasi jika pilihan timeout dalam beberapa saat berlalu atau
SIGINT dihantar (biasanya dengan "Ctrl-C"). menggunakan --verbose bersama-sama dengan --tunggu akan
menghasilkan kemas kini status berkala. Jika pembatalan kerja dicetuskan, --async akan
kembalikan kawalan kepada pengguna secepat mungkin, jika tidak, arahan itu boleh diteruskan
sekat sedikit masa lagi sehingga kerja selesai membersihkan.

Menggunakan --jaga-saudara bendera akan mengekalkan nama rantai belakang relatif.

jalan menentukan laluan cakera yang layak sepenuhnya; ia sepadan dengan sasaran yang unik
nama ( ) atau fail sumber ( ) untuk salah satu cakera
peranti yang dilampirkan pada domain (Lihat juga senarai domblk untuk menyenaraikan nama-nama ini). jalur lebar
menentukan had lebar jalur penyalinan dalam MiB/s. Menentukan nilai negatif ditafsirkan
sebagai nilai panjang panjang yang tidak ditandatangani atau pada dasarnya tidak terhad. Hypervisor boleh memilih
sama ada untuk menolak nilai atau menukarnya kepada nilai maksimum yang dibenarkan.

blkdeviotune domain peranti [[--config] [--hidup] | [--semasa]] [[jumlah-bait-saat] | [baca-
bait-saat] [tulis-bait-saat]] [[total-iops-sec] | [baca-iops-saat] [write-iops-sec]]
[[jumlah-bait-saat-maks] | [baca-bait-saat-maks] [write-bait-sec-maks]] [[total-iops-sec-maks]
| [baca-iops-sec-maks] [write-iops-sec-maks]] [saiz-iops-sek]
Tetapkan atau tanya parameter io cakera blok untuk peranti blok domain. peranti
menentukan nama sasaran yang unik ( ) atau fail sumber (
file='name'/>) untuk salah satu peranti cakera yang dilampirkan domain (Lihat juga senarai domblk khususnya
menyenaraikan nama-nama ini).

Jika tiada had dinyatakan, ia akan menanyakan tetapan had I/O semasa. Jika tidak, ubah
had dengan bendera ini: --jumlah-bait-saat menentukan jumlah had pemprosesan dalam
bait sesaat. --baca-bait-saat menentukan had daya baca dalam bait per
kedua. --tulis-bait-saat menentukan had pemprosesan tulis dalam bait sesaat.
--total-iops-sec menentukan jumlah had operasi I/O sesaat. --baca-iops-saat
menentukan had operasi I/O baca sesaat. --tulis-iops-saat menentukan I/O tulis
had operasi sesaat. --jumlah-bait-saat-maks menentukan jumlah pemprosesan maksimum
had dalam bait sesaat. --read-bait-sec-maks menentukan daya baca maksimum
had dalam bait sesaat. --write-bait-sec-maks menentukan daya tulis maksimum
had dalam bait sesaat. --total-iops-sec-maks menentukan jumlah maksimum I/O
had operasi sesaat. --read-iops-sec-maks menentukan I/O bacaan maksimum
had operasi sesaat. --write-iops-sec-maks menentukan I/O tulis maksimum
had operasi sesaat. --saiz-iops-sec menentukan saiz had operasi I/O setiap
kedua.

Versi lama virsh hanya menerima pilihan ini dengan garis bawah dan bukannya sempang,
seperti dalam --total_bait_sec.

Nilai bait dan iops adalah bebas, tetapi menetapkan hanya satu nilai (seperti
--read-bytes-sec) menetapkan semula dua yang lain dalam kategori itu kepada tidak terhad. 0 yang jelas
juga membersihkan sebarang had. Nilai bukan sifar untuk jumlah tertentu tidak boleh dicampur dengan bukan-
nilai sifar untuk membaca atau menulis.

If --hidup ditentukan, menjejaskan tetamu yang sedang berjalan. Jika --config ditentukan, mempengaruhi
but seterusnya tetamu yang gigih. Jika --semasa ditentukan, menjejaskan tetamu semasa
negeri. Apabila menetapkan parameter io cakera kedua-duanya --hidup and --config bendera mungkin
diberikan, tetapi --semasa adalah eksklusif. Untuk pertanyaan hanya satu daripada --hidup, --config or
--semasa boleh ditentukan. Jika tiada bendera dinyatakan, tingkah laku adalah berbeza bergantung
pada hypervisor.

kerja sekatan domain jalan { [--menggugurkan kandungan] [--async] [--pangsi] | [--maklumat] [--mentah] [--bait] |
[jalur lebar] }
Urus operasi blok aktif. Terdapat tiga mod yang saling eksklusif: --maklumat,
jalur lebar, dan --menggugurkan kandungan. --async and --pangsi membayangkan mod pengguguran; --mentah membayangkan maklumat
mod; dan jika tiada mod diberikan, --maklumat mod diandaikan.

jalan menentukan laluan cakera yang layak sepenuhnya; ia sepadan dengan sasaran yang unik
nama ( ) atau fail sumber ( ) untuk salah satu cakera
peranti yang dilampirkan pada domain (Lihat juga senarai domblk untuk menyenaraikan nama-nama ini).

In --menggugurkan kandungan mod, kerja aktif pada cakera yang ditentukan akan dibatalkan. Jika --async is
juga dinyatakan, arahan ini akan kembali serta-merta, dan bukannya menunggu
pembatalan untuk diselesaikan. Jika --pangsi ditentukan, ini meminta salinan aktif
atau kerja komit aktif dipangsi ke imej baharu.

In --maklumat mod, maklumat kerja aktif pada cakera yang ditentukan akan dicetak. Oleh
lalai, output ialah satu baris ringkasan yang boleh dibaca manusia; format ini mungkin berubah
versi masa hadapan. Menambah --mentah menyenaraikan setiap medan struct, dalam format yang stabil. Jika
yang --bait bendera ditetapkan, maka ralat arahan keluar jika pelayan tidak dapat membekalkan
resolusi bait/s; apabila meninggalkan bendera, output mentah disenaraikan dalam MiB/s dan manusia-
output boleh dibaca secara automatik memilih resolusi terbaik yang disokong oleh pelayan.

jalur lebar boleh digunakan untuk menetapkan had lebar jalur untuk kerja aktif. Menentukan a
nilai negatif ditafsirkan sebagai nilai panjang panjang yang tidak ditandatangani atau pada asasnya tidak terhad.
Hipervisor boleh memilih sama ada untuk menolak nilai atau menukarnya kepada maksimum
nilai dibenarkan.

saiz sekat domain jalan saiz
Ubah saiz peranti blok domain semasa domain sedang berjalan, jalan menentukan
laluan mutlak peranti blok; ia sepadan dengan nama sasaran yang unik (
dev='name'/>) atau fail sumber ( ) untuk salah satu peranti cakera
dilampirkan kepada domain (Lihat juga senarai domblk untuk menyenaraikan nama-nama ini).

saiz ialah integer berskala (lihat NOTA di atas) yang lalai kepada KiB (blok 1024
bait) jika tiada akhiran. Anda mesti menggunakan akhiran "B" untuk mendapatkan bait (perhatikan bahawa
atas sebab sejarah, ini berbeza daripada vol-saiz yang lalai kepada bait tanpa a
akhiran).

domdisplay domain [--sertakan-kata laluan] [[- jenis] jenis]
Keluarkan URI yang boleh digunakan untuk menyambung ke paparan grafik domain melalui
VNC, SPICE atau RDP. Jenis paparan grafik tertentu boleh dipilih menggunakan
jenis parameter (cth "vnc", "rempah", "rdp"). Jika --sertakan-kata laluan dinyatakan, iaitu
Kata laluan saluran SPICE akan disertakan dalam URI.

domfsinfo domain
Tunjukkan senarai sistem fail yang dipasang dalam domain yang sedang berjalan. Senarai itu mengandungi
titik lekap, nama peranti yang dipasang dalam tetamu, jenis sistem fail dan unik
nama sasaran yang digunakan dalam domain XML ( ).

Ambil perhatian bahawa arahan ini memerlukan ejen tetamu yang dikonfigurasikan dan dijalankan dalam domain
OS tetamu.

domfsfreeze domain [[--titik lekap] titik lekap...]
Bekukan sistem fail yang dipasang dalam domain yang sedang berjalan untuk bersedia untuk konsisten
syot kilat.

. --titik lekap pilihan mengambil parameter titik lekap, yang merupakan laluan titik pelekap bagi
sistem fail akan dibekukan. Pilihan ini boleh berlaku beberapa kali. Jika ini tidak
ditentukan, setiap sistem fail yang dipasang dibekukan.

Catatan: snapshot-buat perintah mempunyai a --diam pilihan untuk membekukan dan mencairkan
sistem fail secara automatik untuk memastikan syot kilat konsisten. domfsfreeze perintah hanyalah
diperlukan apabila pengguna ingin menggunakan ciri syot kilat asli peranti storan
tidak disokong oleh libvirt.

domfshaw domain [[--titik lekap] titik lekap...]
Sistem fail yang dipasang cair dalam domain yang sedang berjalan, yang telah dibekukan oleh
arahan domfsfreeze.

. --titik lekap pilihan mengambil parameter titik lekap, yang merupakan laluan titik pelekap bagi
sistem fail yang akan dicairkan. Pilihan ini boleh berlaku beberapa kali. Jika ini tidak
ditentukan, setiap sistem fail yang dipasang dicairkan.

domfstrim domain [--minimum bait] [--titik lekap mountPoint]
Keluarkan arahan fstrim pada semua sistem fail yang dipasang dalam domain yang sedang berjalan. Ia membuang
blok yang tidak digunakan oleh sistem fail. Jika --minimum bait dinyatakan, ia
memberitahu panjang kernel tetamu julat bebas bersebelahan. Lebih kecil daripada ini boleh diabaikan
(ini adalah petunjuk dan tetamu mungkin tidak menghormatinya). Dengan meningkatkan nilai ini,
operasi fstrim akan selesai dengan lebih cepat untuk sistem fail yang bebas berpecah-belah teruk
ruang, walaupun tidak semua blok akan dibuang. Nilai lalai ialah sifar, bermakna
"buang setiap blok percuma". Lebih-lebih lagi, jika pengguna mahu memangkas hanya satu titik lekap, ia
boleh ditentukan melalui pilihan --titik lekap parameter.

domhostname domain
Mengembalikan nama hos domain, jika hipervisor menyediakannya.

dominfo domain
Mengembalikan maklumat asas tentang domain.

domuuid nama-domain-atau-id
Tukar nama domain atau id kepada UUID domain

domid nama-domain-atau-uuid
Tukar nama domain (atau UUID) kepada id domain

domjobabort domain
Hentikan kerja domain yang sedang dijalankan.

domjobinfo domain [--selesai]
Mengembalikan maklumat tentang kerja yang dijalankan pada domain. --selesai suruh virsh balik
maklumat tentang kerja yang baru selesai. Statistik kerja yang telah siap adalah
dimusnahkan secara automatik sebaik sahaja dibaca atau apabila libvirtd dimulakan semula. Perhatikan masa itu
maklumat yang dikembalikan untuk penghijrahan yang lengkap mungkin tidak relevan sepenuhnya melainkan kedua-duanya
hos sumber dan destinasi telah menyegerakkan masa (iaitu, daemon NTP sedang berjalan
kedua-duanya).

nama dom domain-id-atau-uuid
Tukar Id domain (atau UUID) kepada nama domain

domrename domain nama baru
Namakan semula domain. Perintah ini menukar nama domain semasa kepada nama baharu yang dinyatakan dalam
hujah kedua.

Nota: Domain mestilah tidak aktif dan tanpa syot kilat.

domstate domain [--sebab]
Mengembalikan keadaan tentang domain. --sebab memberitahu virsh untuk juga mencetak sebab untuk
negeri.

domcontrol domain
Mengembalikan keadaan antara muka kepada VMM yang digunakan untuk mengawal domain. Bagi negeri selain daripada
"ok" atau "ralat" arahan juga mencetak bilangan saat berlalu sejak kawalan
antara muka memasuki keadaan semasanya.

domtime domain { [--sekarang] [--cantik] [--segerak] [--masa masa] }
Mendapat atau menetapkan masa sistem domain. Apabila dijalankan tanpa sebarang hujah (tetapi domain),
masa sistem domain semasa dicetak. The --cantik pengubah suai boleh digunakan untuk
mencetak masa dalam bentuk yang lebih mudah dibaca oleh manusia.

Bila --masa masa ditentukan, masa domain tidak diperoleh tetapi ditetapkan sebaliknya. The
--sekarang pengubah suai bertindak seperti jika ia adalah alias untuk --masa $sekarang, yang bermaksud ia menetapkan
masa yang pada masa ini pada tuan rumah virsh sedang berjalan di. Dalam kedua-dua kes (tetapan dan
mendapat), masa adalah dalam saat berbanding Epoch 1970-01-01 di UTC. The --segerak
mengubah suai tingkah laku yang ditetapkan sedikit: Masa berlalu diabaikan, tetapi masa untuk ditetapkan adalah
baca daripada RTC domain sebaliknya. Sila ambil perhatian, bahawa sesetengah hypervisor mungkin memerlukan tetamu
ejen untuk dikonfigurasikan untuk mendapatkan atau menetapkan masa tetamu.

domxml-dari-asli format config
Tukar fail config dalam format konfigurasi tetamu asli yang dinamakan oleh format kepada
format XML domain. Untuk hipervisor QEMU/KVM, format hujah mestilah qemu-argv. Untuk
Hypervisor Xen, yang format hujah mungkin xen-xm, xen-xl, Atau xen-sxpr. Untuk LXC
hypervisor, yang format hujah mestilah lxc-tools.

domxml-ke-asli format xml
Tukar fail xml dalam format XML domain kepada format konfigurasi tetamu asli
dinamakan oleh format. Untuk hipervisor QEMU/KVM, format hujah mestilah qemu-argv. Untuk
Hypervisor Xen, yang format hujah mungkin xen-xm, xen-xl, Atau xen-sxpr. Untuk LXC
hypervisor, yang format hujah mestilah lxc-tools.

membuang domain corefilepath [--bypass-cache] { [--hidup] | [--crash] | [--set semula] } [--verbose]
[--ingatan sahaja] [--format rentetan]
Membuang teras domain ke fail untuk analisis. Jika --hidup ditentukan, domain
terus berjalan sehingga pembuangan teras selesai, bukannya berhenti di hadapan. Jika
--crash ditentukan, domain dihentikan dengan status ranap, bukan semata-mata
ditinggalkan dalam keadaan berhenti seketika. Jika --set semula ditentukan, domain ditetapkan semula selepas berjaya
pembuangan. Perhatikan, ketiga-tiga suis ini adalah saling eksklusif. Jika --bypass-cache is
dinyatakan, simpan akan mengelakkan cache sistem fail, walaupun ini boleh melambatkan fail
operasi. Jika --ingatan sahaja ditentukan, fail itu ialah fail elf, dan hanya akan disertakan
memori domain dan nilai daftar sepunya cpu. Ia sangat berguna jika domain menggunakan
peranti hos secara langsung. --format rentetan digunakan untuk menentukan format 'memori sahaja'
membuang, dan rentetan boleh menjadi salah satu daripada mereka: elf, kdump-zlib(format kdump-compressed with
zlib-compressed), kdump-lzo(format kdump-compressed dengan lzo-compressed),
kdump-snappy(format kdump-compressed dengan snappy-compressed).

Kemajuan boleh dipantau menggunakan domjobinfo perintah virsh dan dibatalkan dengan
domjobabort perintah (dihantar oleh contoh virsh lain). Pilihan lain ialah menghantar SIGINT
(biasanya dengan "Ctrl-C") untuk proses virsh berjalan membuang perintah. --verbose memaparkan
kemajuan tempat pembuangan sampah.

NOTA: Sesetengah hipervisor mungkin memerlukan pengguna memastikan kebenaran yang betul dihidupkan secara manual
fail dan laluan yang ditentukan oleh hujah corefilepath.

dumpxml domain [--tidak aktif] [--maklumat-keselamatan] [--kemas kini-cpu] [--boleh berhijrah]
Keluarkan maklumat domain sebagai dump XML ke stdout, format ini boleh digunakan oleh
mewujudkan perintah. Pilihan tambahan yang mempengaruhi pembuangan XML boleh digunakan. --tidak aktif
memberitahu virsh untuk membuang konfigurasi domain yang akan digunakan pada permulaan domain seterusnya
berbanding dengan konfigurasi domain semasa. menggunakan --maklumat-keselamatan juga akan
sertakan maklumat sensitif keselamatan dalam pembuangan XML. --kemas kini-cpu mengemas kini domain
Keperluan CPU mengikut CPU hos. Dengan --boleh berhijrah seseorang boleh meminta XML itu
sesuai untuk migrasi, iaitu, serasi dengan keluaran libvirt yang lebih lama dan mungkin
dipinda dengan pilihan masa jalan dalaman. Pilihan ini mungkin membolehkan yang lain secara automatik
pilihan (--kemas kini-cpu, --maklumat-keselamatan, ...) sebagai keperluan.

mengedit domain
Edit fail konfigurasi XML untuk domain, yang akan menjejaskan but seterusnya bagi
tetamu.

Ini bersamaan dengan:

virsh dumpxml --inactive --security-info domain > domain.xml
vi domain.xml (atau buat perubahan dengan editor teks anda yang lain)
virsh tentukan domain.xml

kecuali ia melakukan beberapa pemeriksaan ralat.

Editor yang digunakan boleh dibekalkan oleh pembolehubah persekitaran $VISUAL atau $EDITOR, dan
lalai kepada "vi".

kategori acara {[domain] { kategori acara | --semua } [--gelung] [--masa tamat saat] [--cap masa] | --senarai}
Tunggu kelas peristiwa domain berlaku dan cetak butiran peristiwa yang sesuai sebagai
mereka berlaku. Acara boleh ditapis secara pilihan oleh domain. Menggunakan --senarai sebagai
hanya hujah yang akan menyediakan senarai yang mungkin kategori acara nilai yang diketahui oleh pelanggan ini,
walaupun sambungan mungkin tidak membenarkan pendaftaran untuk semua acara ini. Ia juga
boleh digunakan --semua bukan kategori acara untuk mendaftar untuk semua jenis acara yang mungkin di
sekali.

Secara lalai, arahan ini adalah satu pukulan, dan mengembalikan kejayaan sebaik sahaja peristiwa berlaku; awak
boleh menghantar SIGINT (biasanya melalui "Ctrl-C") untuk berhenti serta-merta. Jika --masa tamat is
ditentukan, arahan berhenti menunggu acara selepas itu saat telah berlalu. Dengan
--gelung, arahan mencetak semua acara sehingga tamat masa atau kunci gangguan.

Bila --cap masa digunakan, cap waktu yang boleh dibaca manusia akan dicetak sebelum acara.

iothreadinfo domain [[--hidup] [--config] | [--semasa]]
Paparkan maklumat IOThreads domain asas termasuk ID IOThread dan CPU
Perkaitan untuk setiap IOThread.

If --hidup ditentukan, dapatkan data IOThreads daripada tetamu yang sedang berjalan. Jika tetamu itu
tidak berjalan, ralat dikembalikan. Jika --config ditentukan, dapatkan data IOThreads
dari but seterusnya tetamu yang gigih. Jika --semasa dinyatakan atau --hidup and
--config tidak dinyatakan, kemudian dapatkan data IOThread berdasarkan tetamu semasa
negeri.

iothreadpin domain iothread cpulist [[--hidup] [--config] | [--semasa]]
Tukar penyematan domain IOThread untuk menjadi tuan rumah CPU fizikal. Untuk mendapatkan semula a
senarai semua IOThreads, gunakan iothreadinfo. Untuk menyematkan an iothread nyatakan cpulist
dikehendaki untuk ID IOThread seperti yang disenaraikan dalam iothreadinfo output.

cpulist ialah senarai nombor CPU fizikal. Sintaksnya ialah senarai dipisahkan koma dan a
penanda khas menggunakan '-' dan '^' (cth. '0-4', '0-3,^2') juga boleh dibenarkan. '-'
menandakan julat dan '^' menandakan eksklusif. Jika anda ingin menetapkan semula iothreadpin
tetapan, iaitu, untuk menyematkan an iothread kepada semua cpus fizikal, nyatakan 'r' sebagai a
cpulist.

If --hidup ditentukan, menjejaskan tetamu yang sedang berjalan. Jika tetamu tidak berjalan, ralat
dikembalikan. Sekiranya --config ditentukan, menjejaskan but seterusnya tetamu yang berterusan.
If --semasa dinyatakan atau --hidup and --config tidak dinyatakan, menjejaskan arus
negeri tetamu. Kedua-duanya --hidup and --config bendera boleh diberikan jika cpulist hadir, tetapi
--semasa adalah eksklusif. Jika tiada bendera dinyatakan, tingkah laku berbeza bergantung pada
hipervisor.

Nota: Ungkapan dinilai secara berurutan, jadi "0-15,^8" adalah sama dengan
"9-14,0-7,15" tetapi tidak sama dengan "^8,0-15".

iothreadadd domain iothread_id [[--config] [--hidup] | [--semasa]]
Tambahkan IOThread baharu pada domain menggunakan yang ditentukan iothread_id. Jika iothread_id
sudah wujud, arahan itu akan gagal. The iothread_id mestilah lebih besar daripada sifar.

If --hidup ditentukan, menjejaskan tetamu yang sedang berjalan. Jika tetamu tidak menjalankan ralat
dikembalikan. Sekiranya --config ditentukan, menjejaskan but seterusnya tetamu yang berterusan.
If --semasa dinyatakan atau --hidup and --config tidak dinyatakan, menjejaskan arus
negeri tetamu.

iothreaddel domain iothread_id [[--config] [--hidup] | [--semasa]]
Padamkan IOThread daripada domain menggunakan yang ditentukan iothread_id. Jika IOThread adalah
pada masa ini diberikan kepada sumber cakera seperti melalui attach-disk perintah, kemudian
percubaan untuk mengeluarkan IOThread akan gagal. Sekiranya iothread_id tidak wujud ralat
akan berlaku.

If --hidup ditentukan, menjejaskan tetamu yang sedang berjalan. Jika tetamu tidak menjalankan ralat
dikembalikan. Sekiranya --config ditentukan, menjejaskan but seterusnya tetamu yang berterusan.
If --semasa dinyatakan atau --hidup and --config tidak dinyatakan, menjejaskan arus
negeri tetamu.

managedsave domain [--bypass-cache] [{--berlari | --jeda}] [--verbose]
Simpan dan musnahkan (berhenti) domain yang sedang berjalan, supaya ia boleh dimulakan semula dari keadaan yang sama
di kemudian hari. Apabila dara permulaan arahan seterusnya dijalankan untuk domain, ia akan
secara automatik dimulakan dari keadaan yang disimpan ini. Jika --bypass-cache dinyatakan, iaitu
save akan mengelakkan cache sistem fail, walaupun ini mungkin melambatkan operasi.

Kemajuan boleh dipantau menggunakan domjobinfo perintah virsh dan dibatalkan dengan
domjobabort perintah (dihantar oleh contoh virsh lain). Pilihan lain ialah menghantar SIGINT
(biasanya dengan "Ctrl-C") untuk proses virsh berjalan managedsave perintah. --verbose
memaparkan kemajuan simpan.

Biasanya, memulakan simpanan terurus akan memutuskan antara berjalan atau dijeda berdasarkan
nyatakan domain berada semasa simpanan dilakukan; lulus sama ada --berlari or
--jeda bendera akan membenarkan mengatasi yang menyatakan permulaan patut guna.

. dominfo arahan boleh digunakan untuk bertanya sama ada domain pada masa ini mempunyai mana-mana terurus
menyimpan imej.

managedsave-remove domain
Keluarkan managedsave nyatakan fail untuk domain, jika ia wujud. Ini memastikan domain
akan melakukan but penuh apabila ia dimulakan seterusnya.

maxvcpus [jenis]
Sediakan bilangan maksimum CPU maya yang disokong untuk VM tetamu mengenai perkara ini
sambungan. Jika disediakan, jenis parameter mestilah atribut jenis yang sah untuk
elemen XML.

statistik cpu domain [--jumlah] [permulaan] [mengira]
Menyediakan maklumat statistik cpu domain. Domain sepatutnya berjalan. Lalai
ia menunjukkan statistik untuk semua CPU, dan jumlahnya. guna --jumlah hanya untuk jumlah statistik, permulaan
hanya untuk statistik per-cpu CPU daripada permulaan, mengira hanya untuk mengira statistik CPU.

metadata domain [[--hidup] [--config] | [--semasa]] [--edit] [uri] [utama] [menetapkan] [--buang]
Tunjukkan atau ubah suai metadata XML tersuai domain. Metadata ialah XML yang ditakrifkan pengguna
yang membolehkan untuk menyimpan data XML sewenang-wenangnya dalam definisi domain. Berbilang berasingan
kepingan metadata tersuai boleh disimpan dalam XML domain. Kepingan dikenal pasti oleh
ruang nama XML peribadi yang disediakan melalui uri hujah. (Lihat juga menurun yang berfungsi dengan
metadata teks domain.)

Flags --hidup or --config pilih sama ada arahan ini berfungsi secara langsung atau berterusan
definisi domain. Jika kedua-duanya --hidup and --config dinyatakan, iaitu --config
pilihan diutamakan untuk mendapatkan penerangan semasa dan kedua-dua konfigurasi langsung
dan konfigurasi dikemas kini semasa menetapkan penerangan. --semasa adalah eksklusif dan
tersirat jika tiada satu pun daripada ini dinyatakan.

Bendera --buang menentukan bahawa elemen metadata yang ditentukan oleh uri hujah sepatutnya
dialih keluar daripada dikemas kini.

Bendera --edit menentukan bahawa editor dengan metadata yang dikenal pasti oleh uri hujah
hendaklah dibuka dan kandungannya disimpan semula selepas itu. Jika tidak kandungan baru
boleh disediakan melalui menetapkan hujah.

Apabila menetapkan metadata melalui --edit or menetapkan yang utama hujah mesti dinyatakan dan digunakan
untuk mengawal elemen tersuai untuk mengikatnya pada ruang nama peribadi.

Jika tiada satu pun --edit and menetapkan ditentukan metadata XML yang sepadan dengan uri
ruang nama dipaparkan dan bukannya diubah suai.

berhijrah [--hidup] [--luar talian] [--langsung] [--p2p [--terowong]] [--berterusan]
[--udefinesource] [--gantung] [--copy-storage-semua] [--copy-storage-inc]
[--perlindungan-perubahan] [--tidak selamat] [--verbose] [--dimampatkan] [- kesalahan-atas-kesilapan]
[--auto-tumpu] domain desturi [migrateuri] [grafikuri] [mendengar-alamat] [dname]
[--masa tamat saat] [--xml fail] [--pindah-cakera senarai cakera]
Pindahkan domain ke hos lain. Tambah --hidup untuk migrasi secara langsung; <--p2p> untuk
migrasi rakan-2-rakan; --langsung untuk migrasi langsung; atau --terowong untuk terowong
penghijrahan. --luar talian memindahkan definisi domain tanpa memulakan domain pada
destinasi dan tanpa menghentikannya pada hos sumber. Penghijrahan luar talian boleh digunakan
dengan domain tidak aktif dan ia mesti digunakan dengan --berterusan pilihan. --berterusan
meninggalkan domain berterusan pada hos destinasi, --udefinesource tidak mentakrifkan
domain pada hos sumber, dan --gantung meninggalkan domain dijeda pada destinasi
tuan rumah. --copy-storage-semua menunjukkan penghijrahan dengan storan bukan kongsi dengan cakera penuh
salinan, --copy-storage-inc menunjukkan penghijrahan dengan storan tidak dikongsi dengan tambahan
salinan (imej asas yang sama dikongsi antara sumber dan destinasi). Dalam kedua-dua kes cakera
imej perlu wujud pada hos destinasi, the --salinan-storan-... pilihan hanya memberitahu
libvirt untuk memindahkan data daripada imej pada hos sumber kepada imej yang terdapat di
tempat yang sama pada hos destinasi. Secara lalai, hanya imej bukan baca sahaja yang tidak dikongsi
dipindahkan. guna --pindah-cakera untuk menyatakan secara eksplisit senarai sasaran cakera kepada
pindahkan melalui dipisahkan koma senarai cakera hujah. --perlindungan-perubahan menguatkuasakan itu
tiada perubahan konfigurasi yang tidak serasi akan dibuat pada domain semasa penghijrahan
sedang dijalankan; bendera ini didayakan secara tersirat apabila disokong oleh hipervisor, tetapi boleh
digunakan secara eksplisit untuk menolak penghijrahan jika hipervisor tidak mempunyai perlindungan perubahan
sokongan. --verbose memaparkan kemajuan migrasi. --dimampatkan mengaktifkan
pemampatan halaman memori yang perlu dipindahkan berulang kali semasa hidup
penghijrahan. - kesalahan-atas-kesilapan membatalkan penghijrahan jika ralat lembut (contohnya I/O
ralat) berlaku semasa penghijrahan. --auto-tumpu memaksa penumpuan semasa hidup
penghijrahan.

Nota: Hipervisor individu biasanya tidak menyokong semua jenis migrasi yang mungkin.
Sebagai contoh, QEMU tidak menyokong penghijrahan langsung.

Dalam sesetengah kes, libvirt mungkin menolak untuk memindahkan domain kerana berbuat demikian boleh menyebabkan
masalah yang berpotensi seperti rasuah data, dan dengan itu penghijrahan dipertimbangkan
tidak selamat. Untuk domain QEMU, ini mungkin berlaku jika domain menggunakan cakera tanpa secara eksplisit
menetapkan mod cache kepada "tiada". Memindahkan domain sedemikian adalah tidak selamat melainkan imej cakera
disimpan pada sistem fail berkelompok yang koheren, seperti GFS2 atau GPFS. Jika anda pasti
penghijrahan adalah selamat atau anda hanya tidak peduli, gunakan --tidak selamat untuk memaksa penghijrahan.

dname digunakan untuk menamakan semula domain kepada nama baharu semasa penghijrahan, yang juga biasanya
boleh diketepikan. Begitu juga, --xml fail biasanya ditinggalkan, tetapi boleh digunakan untuk membekalkan
fail XML alternatif untuk digunakan pada destinasi untuk membekalkan set perubahan yang lebih besar kepada
mana-mana bahagian khusus hos bagi domain XML, seperti perakaunan untuk penamaan
perbezaan antara sumber dan destinasi dalam mengakses storan asas.

--masa tamat saat memaksa tetamu untuk menangguhkan apabila penghijrahan langsung melebihi jumlah itu
saat, dan kemudian penghijrahan akan selesai di luar talian. Ia hanya boleh digunakan dengan
--hidup.

Menjalankan migrasi boleh dibatalkan dengan mengganggu virsh (biasanya menggunakan "Ctrl-C") atau dengan
domjobabort arahan dihantar dari contoh virsh lain.

. desturi and migrateuri parameter boleh digunakan untuk mengawal destinasi mana yang
kegunaan migrasi. desturi adalah penting untuk migrasi terurus, tetapi tidak digunakan untuk langsung
penghijrahan; migrateuri diperlukan untuk penghijrahan langsung, tetapi biasanya boleh
ditentukan secara automatik untuk penghijrahan terurus.

Nota: The desturi parameter untuk migrasi normal dan migrasi peer2peer mempunyai berbeza
semantik:

· penghijrahan biasa: yang desturi ialah alamat hos sasaran seperti yang dilihat dari
mesin pelanggan.

· peer2peer migrasi: yang desturi ialah alamat hos sasaran seperti yang dilihat dari
mesin sumber.

Bila migrateuri tidak dinyatakan, libvirt akan menentukan hypervisor secara automatik
URI tertentu. Sesetengah hypervisor, termasuk QEMU, mempunyai "hos_hijrah" pilihan
parameter konfigurasi (berguna apabila hos mempunyai berbilang antara muka rangkaian). Jika
ini tidak ditentukan, libvirt menentukan nama dengan mencari hos sasaran
nama hos yang dikonfigurasikan.

Terdapat beberapa senario di mana menentukan migrateuri boleh membantu:

· Nama hos yang dikonfigurasikan tidak betul, atau DNS rosak. Jika hos mempunyai nama hos
yang tidak akan memutuskan untuk memadankan salah satu alamat IP awamnya, maka libvirt akan
menjana URI yang salah. Dalam kes ini migrateuri hendaklah secara eksplisit
ditentukan, menggunakan alamat IP, atau nama hos yang betul.

· Hos mempunyai pelbagai antara muka rangkaian. Jika hos mempunyai berbilang rangkaian
antara muka, adalah wajar untuk aliran data migrasi dihantar melalui a
antara muka khusus untuk sebab keselamatan atau prestasi. Dalam kes ini
migrateuri hendaklah dinyatakan secara eksplisit, menggunakan alamat IP yang dikaitkan dengan
rangkaian yang akan digunakan.

· Tembok api mengehadkan port yang tersedia. Apabila libvirt menjana a
URI penghijrahan, ia akan memilih nombor port menggunakan peraturan khusus hypervisor. Beberapa
hypervisor hanya memerlukan satu port untuk dibuka dalam tembok api, manakala yang lain
memerlukan julat keseluruhan nombor port. Dalam kes kedua migrateuri mungkin
ditentukan untuk memilih nombor port tertentu di luar julat lalai untuk
mematuhi dasar tembok api tempatan.

Lihathttp://libvirt.org/migration.html#uris> untuk mendapatkan butiran lanjut tentang URI migrasi.

Pilihan grafikuri mengatasi parameter sambungan yang digunakan secara automatik
menyambung semula pelanggan grafik pada penghujung penghijrahan. Jika ditinggalkan, libvirt akan
kira parameter berdasarkan alamat IP hos sasaran. Sekiranya pelanggan tidak
mempunyai akses terus kepada hos virtualisasi rangkaian yang disambungkan dan perlu
sambung melalui proksi, grafikuri boleh digunakan untuk menentukan alamat pelanggan
harus menyambung ke. URI dibentuk seperti berikut:

protocol://hostname[:port]/[?parameters]

dengan protokol sama ada "rempah" atau "vnc" dan parameter ialah senarai protokol
parameter khusus dipisahkan oleh '&'. Parameter yang dikenali pada masa ini ialah "tlsPort"
dan "tlsSubject". Sebagai contoh,

rempah ratus://target.host.com:1234/?tlsPort=4567

Pilihan mendengar-alamat menetapkan alamat dengar hipervisor itu pada destinasi
sebelah harus mengikat untuk migrasi masuk. Kedua-dua alamat IPv4 dan IPv6 diterima
serta nama hos (penyelesaian dilakukan di destinasi). Sesetengah hypervisor tidak
menyokong ciri ini dan akan mengembalikan ralat jika parameter ini digunakan.

hijrah-setmaxdowntime domain downtime
Tetapkan masa henti maksimum yang boleh diterima untuk domain yang sedang dipindahkan secara langsung ke domain lain
tuan rumah. The downtime ialah beberapa milisaat tetamu dibenarkan turun di
tamat penghijrahan hidup.

hijrah-compcache domain [--saiz bait]
Menetapkan dan/atau mendapat saiz cache (dalam bait) yang digunakan untuk memampatkan berulang kali
halaman memori yang dipindahkan semasa penghijrahan langsung. Apabila dipanggil tanpa saiz, arahan
hanya mencetak saiz semasa cache mampatan. Bila saiz dinyatakan, iaitu
hypervisor diminta menukar cache mampatan kepada saiz bait dan kemudian arus
saiz dicetak (hasilnya mungkin berbeza daripada saiz yang diminta kerana pembundaran yang dilakukan oleh
hipervisor). The saiz pilihan sepatutnya digunakan semasa domain sedang
berhijrah langsung sebagai tindak balas kepada kemajuan migrasi dan peningkatan bilangan pemampatan
cache terlepas yang diperolehi daripada domjobinfo.

berhijrah-setspeed domain jalur lebar
Tetapkan lebar jalur penghijrahan maksimum (dalam MiB/s) untuk domain yang sedang dipindahkan ke
hos lain. jalur lebar ditafsirkan sebagai nilai panjang panjang yang tidak ditandatangani. Menentukan a
nilai negatif menyebabkan nilai pada dasarnya tidak terhad diberikan kepada
hipervisor. Hipervisor boleh memilih sama ada untuk menolak nilai atau menukarnya kepada
nilai maksimum yang dibenarkan.

berhijrah-getspeed domain
Dapatkan lebar jalur penghijrahan maksimum (dalam MiB/s) untuk domain.

numatune domain [--mod mod] [--nodeset nodeset] [[--config] [--hidup] | [--semasa]]
Tetapkan atau dapatkan parameter numa domain, sepadan dengan elemen daripada
domain XML. Tanpa bendera, tetapan semasa dipaparkan.

mod boleh menjadi salah satu daripada `ketat', `interleave' dan `pilihan' atau mana-mana nombor yang sah daripada
virDomainNumatuneMemMode enum sekiranya daemon menyokongnya. Untuk domain yang sedang berjalan,
mod tidak boleh ditukar dan nodeset boleh ditukar hanya jika domain itu
dimulakan dengan cara `ketat'.

nodeset ialah senarai nod numa yang digunakan oleh hos untuk menjalankan domain. Sintaksnya
ialah senarai dipisahkan koma, dengan '-' untuk julat dan '^' untuk mengecualikan nod.

If --hidup ditentukan, tetapkan maklumat penjadual tetamu yang sedang berjalan. Jika --config is
ditentukan, menjejaskan but seterusnya tetamu yang berterusan. Jika --semasa dinyatakan,
mempengaruhi keadaan tetamu semasa.

reboot domain [--mod SENARAI MODE]
But semula domain. Ini bertindak seolah-olah domain itu mempunyai reboot arahan dijalankan daripada
konsol. Perintah itu kembali sebaik sahaja ia telah melaksanakan tindakan but semula, yang mungkin
menjadi ketara sebelum domain benar-benar but semula.

Gelagat tepat domain apabila ia but semula ditetapkan oleh on_reboot parameter dalam
takrifan XML domain.

Secara lalai, hypervisor akan cuba memilih kaedah penutupan yang sesuai. Untuk menentukan satu
kaedah alternatif, yang --mod parameter boleh menentukan senarai dipisahkan koma yang
termasuk "acpi", "agent", "initctl", "signal" dan "paravirt". Urutan di mana
pemandu akan mencuba setiap mod tidak ditentukan, dan tidak berkaitan dengan pesanan yang ditentukan
dara. Untuk kawalan ketat ke atas pesanan, gunakan mod tunggal pada satu masa dan ulangi
perintah.

menetapkan semula domain
Tetapkan semula domain dengan segera tanpa sebarang penutupan tetamu. menetapkan semula mencontohi tetapan semula kuasa
butang pada mesin, di mana semua perkakasan tetamu melihat set baris RST dan memulakan semula
keadaan dalaman.

Nota: Tetapkan semula tanpa sebarang penutupan OS tetamu berisiko kehilangan data.

memulihkan fail negeri [--bypass-cache] [--xml fail] [{--berlari | --jeda}]
Memulihkan domain daripada a dara menyelamatkan fail negeri. Lihat menyelamatkan untuk maklumat lanjut.

If --bypass-cache ditentukan, pemulihan akan mengelakkan cache sistem fail, walaupun
ini boleh melambatkan operasi.

--xml fail biasanya ditinggalkan, tetapi boleh digunakan untuk membekalkan fail XML alternatif untuk
gunakan pada tetamu yang dipulihkan dengan perubahan hanya dalam bahagian khusus hos bagi
domain XML. Sebagai contoh, ia boleh digunakan untuk mengambil kira perbezaan penamaan fail dalam
storan asas disebabkan oleh syot kilat cakera yang diambil selepas tetamu disimpan.

Biasanya, memulihkan imej yang disimpan akan menggunakan keadaan yang dirakam dalam imej simpan ke
tentukan antara berlari atau dijeda; lulus sama ada --berlari or --jeda bendera akan
benarkan mengatasi keadaan mana domain harus dimulakan.

Nota: Untuk mengelakkan kandungan sistem fail rosak dalam domain, anda tidak seharusnya menggunakan semula
fail keadaan yang disimpan untuk satu saat memulihkan melainkan anda juga telah mengembalikan semua storan
jilid kembali ke kandungan yang sama seperti semasa fail keadaan dicipta.

menyelamatkan domain fail negeri [--bypass-cache] [--xml fail] [{--berlari | --jeda}] [--verbose]
Menyimpan domain yang sedang berjalan (RAM, tetapi bukan keadaan cakera) ke fail keadaan supaya ia boleh
dipulihkan kemudian. Setelah disimpan, domain tidak lagi akan berjalan pada sistem, oleh itu
memori yang diperuntukkan untuk domain akan menjadi percuma untuk digunakan oleh domain lain. dara
memulihkan dipulihkan daripada fail keadaan ini. Jika --bypass-cache ditentukan, simpan akan
elakkan cache sistem fail, walaupun ini mungkin melambatkan operasi.

Kemajuan boleh dipantau menggunakan domjobinfo perintah virsh dan dibatalkan dengan
domjobabort perintah (dihantar oleh contoh virsh lain). Pilihan lain ialah menghantar SIGINT
(biasanya dengan "Ctrl-C") untuk proses virsh berjalan menyelamatkan perintah. --verbose memaparkan
kemajuan menyelamatkan.

Ini lebih kurang sama dengan melakukan hibernate pada komputer yang sedang berjalan, dengan semua
batasan yang sama. Sambungan rangkaian terbuka mungkin terputus apabila dipulihkan, sebagai TCP
tamat masa mungkin telah tamat tempoh.

--xml fail biasanya ditinggalkan, tetapi boleh digunakan untuk membekalkan fail XML alternatif untuk
gunakan pada tetamu yang dipulihkan dengan perubahan hanya dalam bahagian khusus hos bagi
domain XML. Sebagai contoh, ia boleh digunakan untuk mengambil kira perbezaan penamaan fail itu
dirancang untuk dibuat melalui petikan cakera storan asas selepas tetamu
disimpan.

Biasanya, memulihkan imej yang disimpan akan memutuskan antara berjalan atau dijeda berdasarkan
nyatakan domain berada semasa simpanan dilakukan; lulus sama ada --berlari or
--jeda bendera akan membenarkan mengatasi yang menyatakan memulihkan patut guna.

Fail keadaan yang disimpan domain menganggap bahawa imej cakera tidak akan berubah antara
penciptaan dan titik pemulihan. Untuk titik pemulihan sistem yang lebih lengkap, di mana cakera
keadaan disimpan bersama keadaan memori, lihat gambar keluarga perintah.

save-image-define fail xml [{--berlari | --jeda}]
Kemas kini XML domain yang akan digunakan apabila fail kemudiannya digunakan dalam memulihkan
arahan. The xml argumen mestilah nama fail yang mengandungi XML alternatif, dengan
perubahan hanya dalam bahagian khusus hos bagi domain XML. Sebagai contoh, ia boleh
digunakan untuk mengambil kira perbezaan penamaan fail yang terhasil daripada mencipta syot kilat cakera
storan asas selepas tetamu disimpan.

Simpan imej merekodkan sama ada domain harus dipulihkan kepada berjalan atau dijeda
negeri. Biasanya, arahan ini tidak mengubah keadaan yang direkodkan; lulus sama ada
--berlari or --jeda bendera akan membenarkan mengatasi yang menyatakan memulihkan patut guna.

save-image-dumpxml fail [--maklumat-keselamatan]
Ekstrak XML domain yang berkuat kuasa pada masa fail keadaan disimpan fail adalah
dicipta dengan menyelamatkan perintah. menggunakan --maklumat-keselamatan juga akan merangkumi keselamatan
maklumat sensitif.

simpan-gambar-edit fail [{--berlari | --jeda}]
Edit konfigurasi XML yang dikaitkan dengan fail keadaan yang disimpan fail dicipta oleh menyelamatkan
perintah.

Simpan imej merekodkan sama ada domain harus dipulihkan kepada berjalan atau dijeda
negeri. Biasanya, arahan ini tidak mengubah keadaan yang direkodkan; lulus sama ada
--berlari or --jeda bendera akan membenarkan mengatasi yang menyatakan memulihkan patut guna.

Ini bersamaan dengan:

virsh save-image-dumpxml state-file > state-file.xml
vi state-file.xml (atau buat perubahan dengan editor teks anda yang lain)
virsh save-image-define state-file state-file-xml

kecuali ia melakukan beberapa pemeriksaan ralat.

Editor yang digunakan boleh dibekalkan oleh pembolehubah persekitaran $VISUAL atau $EDITOR, dan
lalai kepada "vi".

info jadual domain [[--config] [--hidup] | [--semasa]] [[--set] parameter=nilai]...
info jadual [--berat nombor] [--cap nombor] domain
Membolehkan anda menunjukkan (dan menetapkan) parameter penjadual domain. Parameter yang tersedia
bagi setiap hypervisor ialah:

LXC (penjadual posix): cpu_shares, vcpu_period, vcpu_quota

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

Xen (penjadual kredit): berat, topi

ESX (penjadual peruntukan): tempahan, had, saham

If --hidup ditentukan, tetapkan maklumat penjadual tetamu yang sedang berjalan. Jika --config is
ditentukan, menjejaskan but seterusnya tetamu yang berterusan. Jika --semasa dinyatakan,
mempengaruhi keadaan tetamu semasa.

Nota: Parameter cpu_shares mempunyai julat nilai yang sah 0-262144; Nilai negatif
dibalut kepada positif, dan nilai yang lebih besar dihadkan pada maksimum. Oleh itu, -1
ialah singkatan yang berguna untuk 262144. Pada kernel Linux, nilai 0 dan 1 ialah
ditukar secara automatik kepada nilai minimum 2.

Nota: Parameter berat dan topi ditakrifkan hanya untuk penjadual XEN_CREDIT dan
kini TERDAPAT.

Nota: Parameter vcpu_period/emulator_period mempunyai julat nilai yang sah
1000-1000000 atau 0 dan parameter vcpu_quota/emulator_quota mempunyai nilai yang sah
julat 1000-18446744073709551 atau kurang daripada 0. Nilai 0 untuk mana-mana parameter ialah
sama seperti tidak menyatakan parameter itu.

tangkapan skrin domain [imagefilepath] [--skrin screenID]
Mengambil tangkapan skrin konsol domain semasa dan menyimpannya ke dalam fail. Secara pilihan,
jika hipervisor menyokong lebih banyak paparan untuk domain, screenID membolehkan untuk menentukan yang mana
skrin akan ditangkap. Ia adalah nombor berjujukan skrin. Dalam kes berbilang
kad grafik, kepala disenaraikan sebelum peranti, contohnya mempunyai dua kad grafik,
kedua-duanya dengan empat kepala, ID skrin 5 mengalamatkan kepala kedua pada kad kedua.

kunci hantar domain [--set kod set kod] [--masa tahan masa tahan] kod kunci...
Huraikan kod kunci urutan sebagai ketukan kekunci untuk dihantar ke domain. setiap kod kunci boleh juga
menjadi nilai angka atau nama simbolik daripada set kod yang sepadan. Jika --masa tahan
diberikan, setiap ketukan kekunci akan ditahan selama milisaat itu. Set kod lalai
is linux, tetapi penggunaan --set kod pilihan membolehkan set kod lain dipilih.

Jika berbilang kod kunci ditentukan, semuanya dihantar serentak kepada tetamu, dan
ia mungkin diterima secara rawak. Jika anda memerlukan penekanan kekunci yang berbeza, anda mesti menggunakan
berbilang seruan kunci hantar.

linux
Nilai angka adalah yang ditakrifkan oleh subsistem peristiwa input generik Linux.
Nama simbolik sepadan dengan nama makro pemalar kunci Linux yang sepadan.

xt Nilai berangka adalah yang ditakrifkan oleh pengawal papan kekunci XT asal. Tidak
nama simbolik disediakan

atset1
Nilai angka adalah yang ditakrifkan oleh pengawal papan kekunci AT, set 1 (aka XT
set serasi). Keycoes lanjutan daripada atset1 mungkin berbeza daripada kod kunci lanjutan dalam
yang xt set kod. Tiada nama simbolik disediakan

atset2
Nilai berangka adalah yang ditakrifkan oleh pengawal papan kekunci AT, set 2. No
nama simbolik disediakan

atset3
Nilai angka adalah yang ditakrifkan oleh pengawal papan kekunci AT, set 3 (aka
Set serasi PS/2). Tiada nama simbolik disediakan

os_x
Nilai angka adalah yang ditakrifkan oleh subsistem input papan kekunci OS-X. The
nama simbolik sepadan dengan nama makro pemalar kunci OS-X yang sepadan

xt_kbd
Nilai angka adalah yang ditakrifkan oleh peranti Linux KBD. Ini adalah varian
pada set kod XT asal, tetapi selalunya dengan pengekodan berbeza untuk dilanjutkan
kod kunci. Tiada nama simbolik disediakan.

win32
Nilai angka adalah yang ditakrifkan oleh subsistem input papan kekunci Win32. The
nama simbolik sepadan dengan nama makro pemalar kunci Win32 yang sepadan

usb Nilai angka adalah yang ditakrifkan oleh spesifikasi USB HID untuk papan kekunci
input. Tiada nama simbolik disediakan

rfb Nilai angka adalah yang ditakrifkan oleh sambungan RFB untuk menghantar mentah
kod kunci. Ini adalah varian pada set kod XT, tetapi kod kunci lanjutan mempunyai
bit rendah set bait kedua, bukannya bit tinggi bait pertama. Tidak
nama simbolik disediakan.

Contoh
# hantar tiga pukulan 'k', 'e', ​​'y', menggunakan set kod xt. ini
# semuanya ditekan serentak dan mungkin diterima oleh tetamu
# dalam susunan rawak
virsh send-key dom --codeset xt 37 18 21

# hantar satu lejang 'right-ctrl+C'
virsh hantar-kunci dom KEY_RIGHTCTRL KEY_C

# hantar tab, ditahan selama 1 saat
kunci hantar virsh --holdtime 1000 0xf

hantar-isyarat-proses domain-id pid tanda tangan
Hantar isyarat tanda tangan kepada proses yang dikenal pasti oleh pid berjalan dalam domain maya
domain-id. Yang pid ialah ID proses dalam ruang nama domain maya.

. tanda tangan hujah mungkin sama ada nombor pemalar isyarat integer, atau salah satu daripada
nama simbolik:

"tidak", "hup", "int", "berhenti", "sakit",
"perangkap", "abrt", "bas", "fpe", "bunuh",
"usr1", "segv", "usr2", "paip", "alrm",
"istilah", "stkflt", "chld", "cont", "stop",
"tstp", "ttin", "ttou", "urg", "xcpu",
"xfsz", "vtalrm", "prof", "winch", "poll",
"pwr", "sys", "rt0", "rt1", "rt2", "rt3",
"rt4", "rt5", "rt6", "rt7", "rt8", "rt9",
"rt10", "rt11", "rt12", "rt13", "rt14", "rt15",
"rt16", "rt17", "rt18", "rt19", "rt20", "rt21",
"rt22", "rt23", "rt24", "rt25", "rt26", "rt27",
"rt28", "rt29", "rt30", "rt31", "rt32"

Nama simbol boleh dipilih sebagai awalan dengan 'sig' atau 'sig_' dan mungkin dalam
huruf besar atau huruf kecil.

Contoh
virsh hantar-proses-isyarat myguest 1 15
virsh hantar-proses-isyarat myguest 1 penggal
virsh hantar-proses-isyarat myguest 1 sigterm
virsh hantar-proses-isyarat myguest 1 SIG_HUP

setem domain saiz [[--config] [--hidup] | [--semasa]]
Tukar peruntukan memori untuk domain tetamu. Jika --hidup ditentukan, lakukan a
belon ingatan tetamu yang sedang berlari. Jika --config ditentukan, menjejaskan but seterusnya
tetamu yang gigih. Jika --semasa ditentukan, mempengaruhi keadaan tetamu semasa. Kedua-duanya
--hidup and --config bendera boleh diberikan, tetapi --semasa adalah eksklusif. Jika tiada bendera
ditentukan, tingkah laku adalah berbeza bergantung pada hipervisor.

saiz ialah integer berskala (lihat NOTA atas); ia lalai kepada kibibait (blok 1024
bait) melainkan anda memberikan akhiran (dan nama pilihan yang lebih lama --kilobait boleh didapati
sebagai sinonim yang tidak digunakan lagi). Libvirt membulatkan ke kibibait terdekat. Beberapa
hypervisor memerlukan butiran yang lebih besar daripada KiB, dan permintaan yang tidak genap
berbilang akan dibundarkan ke atas. Sebagai contoh, vSphere/ESX membundarkan parameter kepada
mebibait (1024 kibibait).

Untuk Xen, anda hanya boleh melaraskan memori domain yang sedang berjalan jika domain itu adalah
paravirtual atau menjalankan pemandu belon PV.

Untuk LXC, nilai yang ditetapkan ialah nilai cgroups untuk limit_in_bait atau maksimum
jumlah memori pengguna (termasuk cache fail). Apabila melihat memori di dalam
bekas, ini adalah / proc / meminfo Nilai "MemTotal". Apabila melihat nilai daripada
hos, gunakan dara memtune perintah. Untuk melihat memori semasa yang digunakan dan
nilai maksimum yang dibenarkan untuk menetapkan memori, gunakan dara dominfo perintah.

tetapkan-pengguna-kata laluan domain pengguna kata laluan [--disulitkan]
Tetapkan kata laluan untuk pengguna akaun dalam domain tetamu.

If --disulitkan ditentukan, kata laluan diandaikan telah disulitkan oleh
kaedah yang diperlukan oleh OS tetamu.

Untuk QEMU/KVM, ini memerlukan ejen tetamu dikonfigurasikan dan dijalankan.

setmaxmem domain saiz [[--config] [--hidup] | [--semasa]]
Tukar had peruntukan memori maksimum untuk domain tetamu. Jika --hidup is
ditentukan, menjejaskan tetamu yang sedang berjalan. Jika --config ditentukan, menjejaskan but seterusnya
tetamu yang gigih. Jika --semasa ditentukan, mempengaruhi keadaan tetamu semasa. Kedua-duanya
--hidup and --config bendera boleh diberikan, tetapi --semasa adalah eksklusif. Jika tiada bendera
ditentukan, tingkah laku adalah berbeza bergantung pada hipervisor.

Sesetengah hipervisor seperti QEMU/KVM tidak menyokong perubahan langsung (terutamanya meningkat)
daripada had ingatan maksimum. Malah perubahan konfigurasi yang berterusan mungkin tidak
dilakukan dengan beberapa hipervisor/konfigurasi (cth pada domain yang didayakan NUMA pada QEMU).
Untuk perubahan konfigurasi yang kompleks gunakan arahan mengedit sebaliknya).

saiz ialah integer berskala (lihat NOTA atas); ia lalai kepada kibibait (blok 1024
bait) melainkan anda memberikan akhiran (dan nama pilihan yang lebih lama --kilobait boleh didapati
sebagai sinonim yang tidak digunakan lagi). Libvirt membulatkan ke kibibait terdekat. Beberapa
hypervisor memerlukan butiran yang lebih besar daripada KiB, dan permintaan yang tidak genap
berbilang akan dibundarkan ke atas. Sebagai contoh, vSphere/ESX membundarkan parameter kepada
mebibait (1024 kibibait).

memtune domain [--had-keras saiz] [--had-lembut saiz] [--swap-hard-had saiz]
[--min-jaminan saiz] [[--config] [--hidup] | [--semasa]]
Membolehkan anda memaparkan atau menetapkan parameter memori domain. Tanpa bendera, arus
tetapan dipaparkan; dengan bendera, had yang sesuai dilaraskan jika disokong oleh
hipervisor itu. Sokongan LXC dan QEMU/KVM --had-keras, --had-lembut, dan
--swap-hard-had. --min-jaminan hanya disokong oleh hipervisor ESX. Setiap
had ini ialah integer berskala (lihat NOTA di atas), dengan kibibait lalai
(blok 1024 bait) jika tiada akhiran hadir. Libvirt membulatkan kepada yang terdekat
kibibait. Sesetengah hypervisor memerlukan butiran yang lebih besar daripada KiB, dan memintanya
bukan gandaan genap akan dibundarkan ke atas. Sebagai contoh, vSphere/ESX membulatkan
parameter sehingga mebibait (1024 kibibait).

If --hidup ditentukan, menjejaskan tetamu yang sedang berjalan. Jika --config ditentukan, mempengaruhi
but seterusnya tetamu yang gigih. Jika --semasa ditentukan, menjejaskan tetamu semasa
negeri. Kedua-duanya --hidup and --config bendera boleh diberikan, tetapi --semasa adalah eksklusif. Jika tidak
bendera ditentukan, tingkah laku berbeza bergantung pada hipervisor.

Untuk QEMU/KVM, parameter digunakan pada proses QEMU secara keseluruhan. Justeru, apabila
mengira mereka, seseorang perlu menambah RAM tetamu, RAM video tetamu, dan beberapa memori
overhed QEMU itu sendiri. Bahagian terakhir sukar ditentukan jadi seseorang perlu meneka dan
cuba.

Untuk LXC, nilai had_keras yang dipaparkan ialah tetapan memori semasa daripada XML atau
hasil daripada a dara setem perintah.

--had-keras
Memori maksimum yang boleh digunakan oleh tetamu.

--had-lembut
Had ingatan untuk dikuatkuasakan semasa perbalahan ingatan.

--swap-hard-had
Memori maksimum ditambah pertukaran yang boleh digunakan oleh tetamu. Ini mesti lebih daripada sukar-
nilai had yang disediakan.

--min-jaminan
Peruntukan memori minimum yang dijamin untuk tetamu.

Menentukan -1 sebagai nilai untuk had ini ditafsirkan sebagai tidak terhad.

blkiotune domain [--berat berat] [--peranti-berat berat peranti]
[--device-read-iops-sec peranti-baca-iops-saat] [--device-write-iops-sec peranti-tulis-iop-
sec] [--peranti-baca-bait-saat peranti-baca-bait-saat] [--device-write-bait-sec peranti-
tulis-bait-saat] [[--config] [--hidup] | [--semasa]]
Paparkan atau tetapkan parameter blkio. Sokongan QEMU/KVM --berat. --berat berada dalam julat
[100, 1000]. Selepas kernel 2.6.39, nilai boleh berada dalam julat [10, 1000].

berat peranti ialah rentetan tunggal yang menyenaraikan satu atau lebih pasangan peranti/berat, dalam
format /path/to/device,weight,/path/to/device,weight. Setiap berat adalah dalam julat
[100, 1000], [10, 1000] selepas kernel 2.6.39, atau nilai 0 untuk mengalih keluar peranti itu daripada
penyenaraian setiap peranti. Hanya peranti yang disenaraikan dalam rentetan diubah suai; mana-mana yang sedia ada
berat setiap peranti untuk peranti lain kekal tidak berubah.

peranti-baca-iops-saat ialah rentetan tunggal yang menyenaraikan satu atau lebih peranti/read_iops_sec
berpasangan, masukkan format /path/to/device,read_iops_sec,/path/to/device,read_iops_sec.
Setiap read_iops_sec ialah nombor yang jenisnya unsigned int, nilai 0 untuk mengalih keluarnya
peranti daripada penyenaraian setiap keputusan. Hanya peranti yang disenaraikan dalam rentetan diubah suai;
sebarang read_iops_sec setiap peranti sedia ada untuk peranti lain kekal tidak berubah.

peranti-tulis-iops-saat ialah rentetan tunggal yang menyenaraikan satu atau lebih peranti/write_iops_sec
pasangan, int format
/path/to/device,write_iops_sec,/path/to/device,write_iops_sec. Setiap write_iops_sec ialah
nombor yang jenisnya tidak ditandatangani int, nilai 0 untuk mengalih keluar peranti itu daripada setiap keputusan
penyenaraian. Hanya peranti yang disenaraikan dalam rentetan diubah suai; mana-mana setiap peranti sedia ada
write_iops_sec untuk peranti lain kekal tidak berubah.

peranti-baca-bait-saat ialah rentetan tunggal yang menyenaraikan satu atau lebih peranti/read_bytes_sec
pasangan, int format
/path/to/device,read_bytes_sec,/path/to/device,read_bytes_sec. Setiap read_bytes_sec ialah
nombor yang jenis tidak ditandatangani panjang panjang, nilai 0 untuk mengalih keluar peranti itu daripada per-
penyenaraian keputusan. Hanya peranti yang disenaraikan dalam rentetan diubah suai; mana-mana per-
peranti read_bytes_sec untuk peranti lain kekal tidak berubah.

peranti-tulis-bait-saat ialah rentetan tunggal yang menyenaraikan satu atau lebih peranti/write_bytes_sec
pasangan, int format
/path/to/device,write_bytes_sec,/path/to/device,write_bytes_sec. Setiap write_bait_sec
ialah nombor yang jenis tidak ditandatangani panjang panjang, nilai 0 untuk mengalih keluar peranti itu daripada per-
penyenaraian keputusan. Hanya peranti yang disenaraikan dalam rentetan diubah suai; mana-mana per-
peranti write_bytes_sec untuk peranti lain kekal tidak berubah.

If --hidup ditentukan, menjejaskan tetamu yang sedang berjalan. Jika --config ditentukan, mempengaruhi
but seterusnya tetamu yang gigih. Jika --semasa ditentukan, menjejaskan tetamu semasa
negeri. Kedua-duanya --hidup and --config bendera boleh diberikan, tetapi --semasa adalah eksklusif. Jika tidak
bendera ditentukan, tingkah laku berbeza bergantung pada hipervisor.

setvcpus domain mengira [--maksimum] [[--config] [--hidup] | [--semasa]] [--tetamu]
Tukar bilangan CPU maya yang aktif dalam domain tetamu. Secara lalai, arahan ini
berfungsi pada domain tetamu aktif. Untuk menukar tetapan bagi domain tetamu yang tidak aktif,
menggunakan --config bendera.

. mengira nilai mungkin dihadkan oleh hos, hipervisor atau had yang datang daripada
perihalan asal domain tetamu. Untuk Xen, anda hanya boleh melaraskan maya
CPU domain yang sedang berjalan jika domain itu diparavirtualkan.

Jika --config bendera ditentukan, perubahan dibuat pada konfigurasi XML yang disimpan
untuk domain tetamu, dan hanya akan berkuat kuasa apabila domain tetamu dimulakan seterusnya.

If --hidup ditentukan, domain tetamu mesti aktif dan perubahan berlaku
serta merta. Kedua-dua --config and --hidup bendera boleh dinyatakan bersama jika
disokong oleh hypervisor. Jika arahan ini dijalankan sebelum tetamu selesai
but, tetamu mungkin gagal memproses perubahan.

If --semasa ditentukan, mempengaruhi keadaan tetamu semasa.

Apabila tiada bendera diberikan, --hidup bendera diandaikan dan domain tetamu mestilah
aktif. Dalam keadaan ini terpulang kepada hypervisor sama ada --config bendera adalah
juga diandaikan, dan oleh itu sama ada konfigurasi XML dilaraskan untuk membuat
berubah berterusan.

If --tetamu ditentukan, maka kiraan cpus diubah suai dalam tetamu dan bukannya
hipervisor itu. Bendera ini hanya boleh digunakan untuk domain langsung dan mungkin memerlukan ejen tetamu
untuk dikonfigurasikan dalam tetamu.

. --maksimum flag mengawal bilangan maksimum cpus maya yang boleh dipasang panas
pada kali seterusnya domain dibut. Oleh itu, ia mesti hanya digunakan dengan --config
bendera, dan bukan dengan --hidup atau --semasa bendera.

penutupan domain [--mod SENARAI MODE]
Anggun menutup domain. Ini menyelaras dengan OS domain untuk dilaksanakan
penutupan yang anggun, jadi tiada jaminan bahawa ia akan berjaya, dan mungkin mengambil masa yang lama
tempoh masa berubah-ubah bergantung pada perkhidmatan yang mesti ditutup dalam domain.

Gelagat tepat domain apabila ia dimatikan ditetapkan oleh on_shutdown parameter
dalam definisi XML domain.

If domain adalah sementara, maka metadata mana-mana syot kilat akan hilang sebaik sahaja tetamu
berhenti berjalan, tetapi kandungan syot kilat masih wujud, dan domain baharu dengan yang sama
name dan UUID boleh memulihkan metadata syot kilat dengan snapshot-buat.

Secara lalai, hypervisor akan cuba memilih kaedah penutupan yang sesuai. Untuk menentukan satu
kaedah alternatif, yang --mod parameter boleh menentukan senarai dipisahkan koma yang
termasuk "acpi", "agent", "initctl", "signal" dan "paravirt". Urutan di mana
pemandu akan mencuba setiap mod tidak ditentukan, dan tidak berkaitan dengan pesanan yang ditentukan
dara. Untuk kawalan ketat ke atas pesanan, gunakan mod tunggal pada satu masa dan ulangi
perintah.

permulaan nama-domain-atau-uuid [--konsol] [--jeda] [--autodestroy] [--bypass-cache]
[--paksa-but] [--lulus-fds N, M,...]
Mulakan domain tidak aktif (yang ditakrifkan sebelum ini), sama ada dari yang terakhir managedsave negeri,
atau melalui but baharu jika tiada keadaan simpan terurus hadir. Domain akan dijeda jika
yang --jeda pilihan digunakan dan disokong oleh pemandu; jika tidak ia akan berjalan.
If --konsol diminta, lampirkan pada konsol selepas penciptaan. Jika --autodestroy is
diminta, maka tetamu itu akan dimusnahkan secara automatik apabila virsh menutupnya
sambungan ke libvirt, atau sebaliknya keluar. Jika --bypass-cache dinyatakan, dan
keadaan managedsave wujud, pemulihan akan mengelakkan cache sistem fail, walaupun ini
boleh melambatkan operasi. Jika --paksa-but ditentukan, kemudian managedsave keadaan
dibuang dan but baru berlaku.

If --lulus-fds ditentukan, hujahnya ialah senarai fail terbuka yang dipisahkan koma
deskriptor yang harus disampaikan kepada tetamu. Deskriptor fail akan di-
dinomborkan dalam tetamu, bermula dari 3. Ini hanya disokong dengan berasaskan bekas
virtualisasi.

Menggantung domain
Gantungkan domain yang sedang berjalan. Ia disimpan dalam ingatan tetapi tidak akan dijadualkan lagi.

resume domain
Mengalihkan domain keluar daripada keadaan yang digantung. Ini akan membolehkan yang digantung sebelum ini
domain kini layak untuk penjadualan oleh hypervisor asas.

dompmsuspend domain sasaran [--tempoh]
Gantung domain yang sedang berjalan ke dalam salah satu keadaan ini (mungkin sasaran nilai):
mem bersamaan dengan keadaan S3 ACPI
cakera setara dengan keadaan ACPI S4
RAM hibrid disimpan ke cakera tetapi tidak dimatikan

. --tempoh argumen menentukan bilangan saat sebelum domain dibangkitkan
selepas ia digantung (lihat juga dompmwakeup). Lalai ialah 0 untuk penggantungan tanpa had
masa. (Ciri ini pada masa ini tidak disokong oleh mana-mana pemacu hipervisor dan 0 sepatutnya
digunakan.).

Ambil perhatian bahawa arahan ini memerlukan ejen tetamu yang dikonfigurasikan dan dijalankan dalam domain
OS tetamu.

Berhati-hati bahawa sekurang-kurangnya untuk QEMU, proses domain akan ditamatkan apabila disasarkan
cakera digunakan dan proses baharu akan dilancarkan apabila libvirt diminta untuk membangunkan fail
domain. Akibat daripada ini, sebarang perubahan masa jalan, seperti palam panas peranti atau memori
tetapan, hilang melainkan perubahan sedemikian dibuat dengan --config bendera.

dompmwakeup domain
Bangunkan domain daripada keadaan pmsuspended (sama ada digantung oleh dompmsuspend atau daripada
tetamu itu sendiri). Menyuntik bangun ke dalam tetamu yang berada dalam keadaan pmsuspended, sebaliknya
daripada menunggu tempoh yang diminta sebelum ini (jika ada) tamat. Operasi ini
tidak semestinya gagal jika domain sedang berjalan.

ttyconsole domain
Keluarkan peranti yang digunakan untuk konsol TTY domain. Jika maklumat itu tidak
tersedia proses akan menyediakan kod keluar 1.

undefine domain [--terurus-simpan] [--snapshots-metadata] [--nvram] [ {--penyimpanan jumlahnya |
--buang-semua-storan [--padam-snapshot]} --lap-penyimpanan]
Nyahtakrifkan domain. Jika domain sedang berjalan, ini menukarnya kepada domain sementara,
tanpa menghentikannya. Jika domain tidak aktif, konfigurasi domain dialih keluar.

. --terurus-simpan bendera menjamin bahawa mana-mana imej simpan terurus (lihat managedsave
arahan) juga dibersihkan. Tanpa bendera, cuba untuk menyahtakrif domain dengan a
imej simpan terurus akan gagal.

. --snapshots-metadata bendera menjamin bahawa sebarang syot kilat (lihat senarai gambar
command) juga dibersihkan apabila menyahdefinisikan domain yang tidak aktif. Tanpa bendera,
percubaan untuk menyahtakrif domain yang tidak aktif dengan metadata syot kilat akan gagal. Sekiranya
domain aktif, bendera ini diabaikan.

. --nvram flag memastikan tiada fail nvram (/domain/os/nvram/) tertinggal. Sekiranya
domain mempunyai fail nvram dan bendera ditinggalkan, undefine akan gagal.

. --penyimpanan bendera mengambil parameter jumlahnya, yang merupakan senarai dipisahkan koma bagi
nama sasaran volum atau laluan sumber volum storan untuk dialih keluar bersama-sama dengan
domain yang tidak ditentukan. Jilid boleh tidak ditentukan dan dengan itu dialih keluar hanya pada domain yang tidak aktif.
Pemadaman volum hanya cuba selepas domain tidak ditentukan; jika tidak semua
volum yang diminta boleh dipadamkan, mesej ralat menunjukkan apa yang masih kekal
belakang. Jika laluan volum tidak ditemui dalam takrifan domain, ia dianggap seolah-olah
kelantangan berjaya dipadamkan. Hanya jilid yang diuruskan oleh libvirt dalam kumpulan storan boleh
dikeluarkan dengan cara ini. (Lihat senarai domblk untuk senarai nama sasaran yang dikaitkan dengan a
domain). Contoh: --storage vda,/path/to/storage.img

. --buang-semua-storan flag menentukan bahawa semua volum storan domain
harus dihapuskan.

. --padam-snapshot flag menentukan bahawa sebarang syot kilat yang dikaitkan dengan storan
kelantangan harus dipadamkan juga. Memerlukan --buang-semua-storan bendera menjadi
disediakan. Tidak semua pemacu storan menyokong pilihan ini, pada masa ini hanya rbd.

Bendera --lap-penyimpanan menyatakan bahawa isipadu storan hendaklah dipadamkan sebelum ini
penyingkiran.

NOTA: Untuk domain yang tidak aktif, nama domain atau UUID mesti digunakan sebagai domain.

vcpucount domain [{--maksimum | --aktif} {--config | --hidup | --semasa}] [--tetamu]
Cetak maklumat tentang kiraan cpu maya yang diberikan domain. Jika tiada bendera
ditentukan, semua kiraan yang mungkin disenaraikan dalam jadual; jika tidak, output adalah terhad
kepada hanya nilai angka yang diminta. Atas sebab sejarah, jadual menyenaraikan
labelkan "semasa" pada baris yang boleh ditanya secara berasingan melalui --aktif bendera,
bukannya berkaitan dengan --semasa bendera.

--maksimum meminta maklumat tentang had maksimum vcpus yang boleh ditambahkan oleh domain melalui
setvcpus, Manakala --aktif menunjukkan penggunaan semasa; kedua-dua bendera ini tidak boleh kedua-duanya
dinyatakan. --config memerlukan domain yang berterusan dan meminta maklumat mengenai
pada kali seterusnya domain akan dibut, --hidup memerlukan domain dan senarai yang sedang berjalan
nilai semasa, dan --semasa pertanyaan mengikut keadaan semasa domain
(bersesuaian dengan --hidup jika berlari, atau --config jika tidak aktif); tiga bendera ini ialah
saling eksklusif.

If --tetamu ditentukan, maka kiraan cpus dilaporkan dari perspektif
tetamu. Bendera ini hanya boleh digunakan untuk domain langsung dan mungkin memerlukan ejen tetamu
dikonfigurasikan dalam tetamu.

vcpuinfo domain [--cantik]
Mengembalikan maklumat asas tentang CPU maya domain, seperti bilangan vCPU,
masa berjalan, pertalian dengan pemproses fizikal.

Dengan --cantik, pertalian cpu ditunjukkan sebagai julat.

vcpupin domain [vcpu] [cpulist] [[--hidup] [--config] | [--semasa]]
Tanya atau tukar penyematan VCPU domain untuk mengehoskan CPU fizikal. Untuk menyematkan satu
vcpu, nyatakan cpulist; jika tidak, anda boleh bertanya satu vcpu atau tinggalkan vcpu untuk menyenaraikan semua di
sekali.

cpulist ialah senarai nombor CPU fizikal. Sintaksnya ialah senarai dipisahkan koma dan a
penanda khas menggunakan '-' dan '^' (cth. '0-4', '0-3,^2') juga boleh dibenarkan. '-'
menandakan julat dan '^' menandakan eksklusif. Untuk menyematkan vcpu kepada semua fizikal
cpus tentukan 'r' sebagai a cpulist. Jika --hidup ditentukan, menjejaskan tetamu yang sedang berjalan. Jika
--config ditentukan, menjejaskan but seterusnya tetamu yang berterusan. Jika --semasa is
ditentukan, mempengaruhi keadaan tetamu semasa. Kedua-duanya --hidup and --config bendera mungkin
diberikan jika cpulist hadir, tetapi --semasa adalah eksklusif. Jika tiada bendera dinyatakan,
tingkah laku adalah berbeza bergantung kepada hypervisor.

Nota: Ungkapan dinilai secara berurutan, jadi "0-15,^8" adalah sama dengan
"9-14,0-7,15" tetapi tidak sama dengan "^8,0-15".

emulatorpin domain [cpulist] [[--hidup] [--config] | [--semasa]]
Tanya atau tukar penyematan utas emulator domain untuk mengehoskan CPU fizikal.

Lihat vcpupin khususnya cpulist.

If --hidup ditentukan, menjejaskan tetamu yang sedang berjalan. Jika --config ditentukan, mempengaruhi
but seterusnya tetamu yang gigih. Jika --semasa ditentukan, menjejaskan tetamu semasa
negeri. Kedua-duanya --hidup and --config bendera boleh diberikan jika cpulist hadir, tetapi
--semasa adalah eksklusif. Jika tiada bendera dinyatakan, tingkah laku berbeza bergantung pada
hipervisor.

vncdisplay domain
Keluarkan alamat IP dan nombor port untuk paparan VNC. Jika maklumat itu tidak
tersedia proses akan menyediakan kod keluar 1.

PERANTI PERINTAH

Perintah berikut memanipulasi peranti yang dikaitkan dengan domain. The domain boleh
ditentukan sebagai integer pendek, nama atau UUID penuh. Untuk lebih memahami nilai
dibenarkan sebagai pilihan untuk arahan membaca dokumentasi di
<http://libvirt.org/formatdomain.html> pada format bahagian peranti untuk mendapatkan
set nilai yang paling tepat diterima.

attach-device domain FAIL [[[--hidup] [--config] | [--semasa]] | [--berterusan]]
Lampirkan peranti pada domain, menggunakan definisi peranti dalam fail XML menggunakan peranti
elemen definisi seperti atau sebagai elemen peringkat atasan. Lihat
dokumentasi dihttp://libvirt.org/formatdomain.html#elementsDevices> untuk dipelajari
Format XML libvirt untuk peranti. Jika --config ditentukan arahan mengubah
konfigurasi domain berterusan dengan lampiran peranti berkuat kuasa pada kali seterusnya
libvirt memulakan domain. Untuk peranti cdrom dan liut, arahan ini hanya menggantikan
media dalam peranti sedia ada; pertimbangkan untuk menggunakan kemas kini-peranti untuk kegunaan ini. Untuk
peranti hos passthrough, lihat juga nodedev-detach, diperlukan jika peranti PCI tidak
gunakan mod terurus.

If --hidup ditentukan, menjejaskan domain yang sedang berjalan. Jika --config ditentukan, mempengaruhi
permulaan domain berterusan seterusnya. Jika --semasa ditentukan, mempengaruhi arus
keadaan domain. Kedua-duanya --hidup and --config bendera boleh diberikan, tetapi --semasa is
eksklusif. Apabila tiada bendera dinyatakan API warisan digunakan yang tingkah lakunya bergantung pada
pemandu hipervisor.

Untuk tujuan keserasian, --berterusan berkelakuan seperti --config untuk domain luar talian,
dan seperti --hidup --config untuk domain yang sedang berjalan.

Nota: penggunaan fail XML definisi peranti separa boleh membawa kepada hasil yang tidak dijangka sebagai
sesetengah medan mungkin dijana secara automatik dan dengan itu sepadan dengan peranti selain daripada yang dijangkakan.

attach-disk domain sumber sasaran [[[--hidup] [--config] | [--semasa]] | [--berterusan]]
[--bas sasaran bas] [--pemandu pemandu] [--pemacu kecil pemacu kecil] [--iothread iothread] [--cache
cache] [- jenis jenis] [--mod mod] [--Jenis sumber Jenis sumber] [--siri siri] [--wwn www]
[--rawio] [--alamat alamat] [--pelbagai fungsi] [--print-xml]
Lampirkan peranti cakera baharu pada domain. sumber ialah laluan untuk fail dan peranti.
sasaran mengawal bas atau peranti di mana cakera terdedah kepada OS tetamu. Ia
menunjukkan nama peranti "logik"; pilihan bas sasaran atribut menentukan
jenis peranti cakera untuk dicontohi; nilai yang mungkin adalah khusus pemacu, dengan nilai biasa
nilai menjadi ide, scsi, virtio, Xen, usb, SATA, Atau sd, jika ditinggalkan, jenis bas ialah
disimpulkan daripada gaya nama peranti (cth peranti bernama 'sda' biasanya akan
dieksport menggunakan bas SCSI). pemandu boleh fail, ketuk or phy untuk hipervisor Xen
bergantung pada jenis akses; atau qemu untuk emulator QEMU. Butiran lanjut kepada
pemandu boleh dilalui menggunakan pemacu kecil. Untuk Xen pemacu kecil boleh aio, manakala untuk QEMU
subpemacu harus sepadan dengan format sumber cakera, seperti mentah or qcow2.
Hipervisor lalai akan digunakan jika pemacu kecil tidak dinyatakan. Walau bagaimanapun, lalai
mungkin tidak betul, esp. untuk QEMU atas sebab keselamatan ia dikonfigurasikan untuk tidak
mengesan format cakera. jenis boleh menunjukkan Mon, cdrom or liut sebagai alternatif kepada
lalai cakera, walaupun penggunaan ini hanya menggantikan media dalam maya sedia ada
cdrom atau peranti liut; pertimbangkan untuk menggunakan kemas kini-peranti untuk kegunaan ini sebaliknya. mod boleh
nyatakan dua mod tertentu baca sahaja or boleh dikongsi. Jenis sumber boleh menunjukkan jenis
sumber (blok|fail) cache boleh menjadi salah satu daripada "lalai", "tiada", "tulis lalu",
"tulis balik", "directsync" atau "tidak selamat". iothread ialah nombor dalam julat
domain IOThreads yang mana cakera ini boleh dilampirkan (QEMU sahaja). siri adalah bersiri
peranti cakera. www ialah wwn peranti cakera. rawio menunjukkan cakera memerlukan rawio
keupayaan. alamat ialah alamat peranti cakera dalam bentuk
pci:domain.bus.slot.function, scsi:controller.bus.unit, ide:controller.bus.unit atau
ccw:cssid.ssid.devno. Peranti Virtio-ccw mesti mempunyai cssid mereka ditetapkan kepada 0xfe.
pelbagai fungsi menunjukkan alamat pci yang ditentukan ialah alamat peranti pci pelbagai fungsi.

If --print-xml ditentukan, maka XML cakera yang akan dilampirkan ialah
dicetak sebaliknya.

If --hidup ditentukan, menjejaskan domain yang sedang berjalan. Jika --config ditentukan, mempengaruhi
permulaan domain berterusan seterusnya. Jika --semasa ditentukan, mempengaruhi arus
keadaan domain. Kedua-duanya --hidup and --config bendera boleh diberikan, tetapi --semasa is
eksklusif. Apabila tiada bendera dinyatakan API warisan digunakan yang tingkah lakunya bergantung pada
pemandu hipervisor.

Untuk tujuan keserasian, --berterusan berkelakuan seperti --config untuk domain luar talian,
dan seperti --hidup --config untuk domain yang sedang berjalan. Begitu juga, --boleh dikongsi adalah alias untuk
--mod boleh dikongsi.

attach-interface domain jenis sumber [[[--hidup] [--config] | [--semasa]] | [--berterusan]]
[--sasaran sasaran] [--Mac mac] [--skrip skrip] [--model model] [--masuk
purata, puncak, pecah, lantai] [--keluar purata, puncak, pecah] [--diuruskan] [--print-xml]
Lampirkan antara muka rangkaian baharu pada domain.

jenis boleh menjadi salah satu:

rangkaian untuk menunjukkan sambungan melalui rangkaian maya libvirt,

jambatan untuk menunjukkan sambungan melalui peranti jambatan pada hos,

terus untuk menunjukkan sambungan terus ke salah satu antara muka rangkaian hos atau
jambatan,

hostdev untuk menunjukkan sambungan menggunakan laluan masuk peranti PCI pada hos.

sumber menunjukkan sumber sambungan. Sumber bergantung pada jenis
antara muka:

rangkaian nama rangkaian maya,

jambatan nama peranti jambatan,

terus nama antara muka atau jambatan hos,

hostdev alamat PCI antara muka hos yang diformatkan sebagai
domain:bas:slot.function.

--sasaran digunakan untuk menentukan peranti ketik/macvtap yang akan digunakan untuk menyambungkan domain tersebut
sumber. Nama yang bermula dengan 'vnet' dianggap sebagai dijana secara automatik dan adalah
dikosongkan/dijana semula setiap kali antara muka dilampirkan.

--Mac menentukan alamat MAC antara muka rangkaian; jika alamat MAC tidak
diberikan, alamat baharu akan dijana secara automatik (dan disimpan dalam persistent
konfigurasi jika "--config" diberikan pada baris arahan).

--skrip digunakan untuk menentukan laluan ke skrip tersuai untuk dipanggil semasa dilampirkan
jambatan - ini akan dipanggil bukannya skrip lalai bukan sebagai tambahan kepadanya.
Ini sah hanya untuk antara muka jambatan jenis dan hanya untuk domain Xen.

--model menentukan model peranti rangkaian untuk dipersembahkan kepada domain.

--masuk and --keluar mengawal lebar jalur antara muka. Sekurang-kurangnya satu daripada
yang purata, lantai pasangan mesti dinyatakan. Dua lagi puncak and pecah adalah pilihan,
jadi "purata,puncak", "purata,,letup", "purata,,,lantai", "purata" dan ",,,lantai" ialah
juga sah. Nilai untuk purata, lantai and puncak dinyatakan dalam kilobait sesaat,
manakala pecah dinyatakan dalam kilobait dalam satu letusan pada puncak kelajuan seperti yang diterangkan dalam
dokumentasi Rangkaian XML dihttp://libvirt.org/formatnetwork.html#elementQoS>.

--diuruskan hanya boleh digunakan untuk hostdev taip dan beritahu libvirt bahawa antara muka harus
diuruskan, yang bermaksud dipisahkan dan disambung semula daripada/ke hos oleh libvirt.

If --print-xml ditentukan, maka XML antara muka yang akan dilampirkan ialah
dicetak sebaliknya.

If --hidup ditentukan, menjejaskan domain yang sedang berjalan. Jika --config ditentukan, mempengaruhi
permulaan domain berterusan seterusnya. Jika --semasa ditentukan, mempengaruhi arus
keadaan domain. Kedua-duanya --hidup and --config bendera boleh diberikan, tetapi --semasa is
eksklusif. Apabila tiada bendera dinyatakan API warisan digunakan yang tingkah lakunya bergantung pada
pemandu hipervisor.

Untuk tujuan keserasian, --berterusan berkelakuan seperti --config untuk domain luar talian,
dan seperti --hidup --config untuk domain yang sedang berjalan.

Nota: nilai sasaran pilihan ialah nama peranti yang akan dibuat sebagai bahagian belakang
pada nod. Jika tidak disediakan peranti bernama "vnetN" atau "vifN" akan dibuat
secara automatik.

detach-device domain FAIL [[[--hidup] [--config] | [--semasa]] | [--berterusan]]
Tanggalkan peranti daripada domain, ambil jenis penerangan XML yang sama seperti arahan
attach-device. Untuk peranti hos laluan, lihat juga nodedev-attach semula, diperlukan jika
peranti tidak menggunakan mod terurus.

Nota: Perihalan XML peranti yang dibekalkan hendaklah sekhususnya
definisi dalam XML domain. Set atribut yang digunakan untuk memadankan peranti ialah
dalaman kepada pemandu. Menggunakan definisi separa, atau cuba menanggalkan peranti
yang tidak terdapat dalam XML domain, tetapi berkongsi beberapa atribut khusus dengan satu
yang ada, boleh membawa kepada hasil yang tidak dijangka.

If --hidup ditentukan, menjejaskan domain yang sedang berjalan. Jika --config ditentukan, mempengaruhi
permulaan domain berterusan seterusnya. Jika --semasa ditentukan, mempengaruhi arus
keadaan domain. Kedua-duanya --hidup and --config bendera boleh diberikan, tetapi --semasa is
eksklusif. Apabila tiada bendera dinyatakan API warisan digunakan yang tingkah lakunya bergantung pada
pemandu hipervisor.

Untuk tujuan keserasian, --berterusan berkelakuan seperti --config untuk domain luar talian,
dan seperti --hidup --config untuk domain yang sedang berjalan.

Ambil perhatian bahawa versi lama virsh digunakan --config sebagai alias untuk --berterusan.

detach-cakera domain sasaran [[[--hidup] [--config] | [--semasa]] | [--berterusan]]
Tanggalkan peranti cakera daripada domain. The sasaran ialah peranti seperti yang dilihat dari domain.

If --hidup ditentukan, menjejaskan domain yang sedang berjalan. Jika --config ditentukan, mempengaruhi
permulaan domain berterusan seterusnya. Jika --semasa ditentukan, mempengaruhi arus
keadaan domain. Kedua-duanya --hidup and --config bendera boleh diberikan, tetapi --semasa is
eksklusif. Apabila tiada bendera dinyatakan API warisan digunakan yang tingkah lakunya bergantung pada
pemandu hipervisor.

Untuk tujuan keserasian, --berterusan berkelakuan seperti --config untuk domain luar talian,
dan seperti --hidup --config untuk domain yang sedang berjalan.

Ambil perhatian bahawa versi lama virsh digunakan --config sebagai alias untuk --berterusan.

detach-interface domain jenis [--Mac mac] [[[--hidup] [--config] | [--semasa]] |
[--berterusan]]
Tanggalkan antara muka rangkaian daripada domain. jenis boleh jadi sama ada rangkaian untuk menunjukkan a
peranti rangkaian fizikal atau jambatan untuk menunjukkan jambatan kepada peranti. Ia disyorkan
untuk menggunakan mac pilihan untuk membezakan antara antara muka jika lebih daripada satu
hadir pada domain.

If --hidup ditentukan, menjejaskan domain yang sedang berjalan. Jika --config ditentukan, mempengaruhi
permulaan domain berterusan seterusnya. Jika --semasa ditentukan, mempengaruhi arus
keadaan domain. Kedua-duanya --hidup and --config bendera boleh diberikan, tetapi --semasa is
eksklusif. Apabila tiada bendera dinyatakan API warisan digunakan yang tingkah lakunya bergantung pada
pemandu hipervisor.

Untuk tujuan keserasian, --berterusan berkelakuan seperti --config untuk domain luar talian,
dan seperti --hidup --config untuk domain yang sedang berjalan.

Ambil perhatian bahawa versi lama virsh digunakan --config sebagai alias untuk --berterusan.

kemas kini-peranti domain fail [- kekuatan] [[[--hidup] [--config] | [--semasa]] | [--berterusan]]
Kemas kini ciri peranti yang dikaitkan dengan domain, berdasarkan peranti
definisi dalam XML fail. Yang - kekuatan pilihan boleh digunakan untuk memaksa kemas kini peranti,
cth, untuk mengeluarkan CD-ROM walaupun ia dikunci/dilekapkan dalam domain. Lihat
dokumentasi dihttp://libvirt.org/formatdomain.html#elementsDevices> untuk dipelajari
Format XML libvirt untuk peranti.

If --hidup ditentukan, menjejaskan domain yang sedang berjalan. Jika --config ditentukan, mempengaruhi
permulaan domain berterusan seterusnya. Jika --semasa ditentukan, mempengaruhi arus
keadaan domain. Kedua-duanya --hidup and --config bendera boleh diberikan, tetapi --semasa is
eksklusif. Tidak menyatakan sebarang bendera adalah sama dengan menyatakan --semasa.

Untuk tujuan keserasian, --berterusan berkelakuan seperti --config untuk domain luar talian,
dan seperti --hidup --config untuk domain yang sedang berjalan.

Ambil perhatian bahawa versi lama virsh digunakan --config sebagai alias untuk --berterusan.

Nota: penggunaan fail XML definisi peranti separa boleh membawa kepada hasil yang tidak dijangka sebagai
sesetengah medan mungkin dijana secara automatik dan dengan itu sepadan dengan peranti selain daripada yang dijangkakan.

tukar-media domain jalan [--lepaskan] [--masukkan] [- kemas kini] [sumber] [- kekuatan] [[--hidup]
[--config] | [--semasa]] [--print-xml] [--sekat]
Tukar media CDROM atau pemacu liut. jalan boleh menjadi laluan yang layak sepenuhnya atau
nama sasaran unik ( ) peranti cakera. sumber menentukan laluan
daripada media yang akan dimasukkan atau dikemas kini. Bendera --sekat membenarkan untuk menetapkan jenis sandaran masuk
kes peranti blok digunakan sebagai media untuk CDROM atau pemacu liut dan bukannya fail.

--lepaskan menunjukkan media akan dikeluarkan. --masukkan menunjukkan media akan
dimasukkan. sumber mesti dinyatakan. Jika peranti mempunyai sumber (cth
file='media'>), dan sumber tidak dinyatakan, - kemas kini adalah sama dengan --lepaskan. Jika
peranti tidak mempunyai sumber, dan sumber dinyatakan, - kemas kini adalah sama dengan --masukkan. Jika
peranti mempunyai sumber, dan sumber dinyatakan, - kemas kini berkelakuan seperti gabungan
--lepaskan and --masukkan. Jika tiada --lepaskan, --masukkan, dan - kemas kini dinyatakan,
- kemas kini digunakan secara lalai. The - kekuatan pilihan boleh digunakan untuk memaksa menukar media.
If --hidup ditentukan, ubah konfigurasi langsung tetamu yang sedang berjalan. Jika --config is
ditentukan, ubah konfigurasi berterusan, kesan diperhatikan pada but seterusnya. --semasa
boleh salah satu atau kedua-duanya tinggal and config, bergantung pada pelaksanaan hypervisor.
Kedua-dua --hidup and --config bendera boleh diberikan, tetapi --semasa adalah eksklusif. Jika tiada bendera
ditentukan, tingkah laku adalah berbeza bergantung pada hipervisor. Jika --print-xml is
ditentukan, XML yang akan digunakan untuk menukar media dicetak dan bukannya menukar
media.

NODEDEV PERINTAH

Perintah berikut memanipulasi peranti hos yang bertujuan untuk dihantar ke
domain tetamu melalui elemen dalam domain bahagian. Kunci peranti nod
biasanya ditentukan oleh nama bas diikuti dengan alamatnya, menggunakan garis bawah antara
semua komponen, seperti pci_0000_00_02_1, usb_1_5_3 atau net_eth1_00_27_13_6a_fe_00. The
senarai nodedev memberikan senarai penuh peranti hos yang diketahui oleh libvirt, walaupun ini
termasuk peranti yang tidak boleh diberikan kepada tetamu (contohnya, cuba menanggalkan
Peranti PCI yang mengawal pengawal cakera keras hos tempat imej cakera tetamu
hidup boleh menyebabkan sistem hos terkunci atau but semula).

Untuk maklumat lanjut tentang definisi peranti nod lihat:http://libvirt.org/formatnode.html>.

Peranti laluan tidak boleh digunakan secara serentak oleh hos dan domain tetamunya, mahupun
oleh berbilang tetamu aktif serentak. Sekiranya perihalan peranti PCI termasuk
atribut itu terurus='ya', dan pemacu hipervisor menyokongnya, kemudian peranti itu masuk
mod terurus dan cuba menggunakan peranti laluan itu dalam kehendak tetamu yang aktif
secara automatik berkelakuan seolah-olah nodedev-detach (permulaan tetamu, palam panas peranti) dan nodedev-
pasang semula (hentian tetamu, cabut panas peranti) telah dipanggil di titik yang betul. Jika peranti PCI
tidak ditandakan sebagai terurus, maka ia mesti ditanggalkan secara manual sebelum tetamu boleh menggunakannya, dan
disambung semula secara manual untuk dikembalikan kepada hos. Juga, jika peranti ditanggalkan secara manual,
maka hos tidak mendapatkan semula kawalan ke atas peranti tanpa pasang semula yang sepadan, walaupun jika
tetamu menggunakan peranti dalam mod terurus.

nodedev-create FAIL
Cipta peranti pada nod hos yang kemudiannya boleh diberikan kepada mesin maya.
Biasanya, libvirt dapat menentukan secara automatik nod hos yang tersedia
untuk digunakan, tetapi ini membenarkan pendaftaran perkakasan hos yang tidak dilakukan oleh libvirt
mengesan secara automatik. fail mengandungi xml untuk peringkat teratas penerangan tentang a
peranti nod.

nodedev-memusnahkan peranti
Musnahkan (hentikan) peranti pada hos. peranti boleh sama ada nama peranti atau pasangan wwn masuk
Format "wwnn,wwpn" (hanya berfungsi untuk vHBA pada masa ini). Ambil perhatian bahawa ini menjadikan libvirt berhenti
menguruskan peranti hos, malah mungkin menjadikan peranti itu tidak boleh digunakan oleh seluruh peranti
hos fizikal sehingga but semula.

nodedev-detach mengangguk [--pemandu backend_driver]
Lepaskan mengangguk daripada hos, supaya ia boleh digunakan dengan selamat oleh tetamu melalui
melalui. Ini diterbalikkan dengan nodedev-attach semula, dan dilakukan secara automatik untuk
peranti terurus. Untuk tujuan keserasian, arahan ini juga boleh dieja
nodedev-dettach.

Pemacu bahagian belakang yang berbeza menjangkakan peranti akan diikat pada peranti tiruan yang berbeza.
Sebagai contoh, pemacu hujung belakang "kvm" QEMU (lalai) menjangkakan peranti akan terikat
kepada pci-stub, tetapi pemacu hujung belakang "vfio" menjangkakan peranti itu terikat kepada vfio-pci.
. --pemandu parameter boleh digunakan untuk menentukan pemacu bahagian belakang yang dikehendaki.

nodedev-dumpxml peranti
Buang a Perwakilan XML untuk peranti nod yang diberikan, termasuk sedemikian
maklumat sebagai nama peranti, bas yang memiliki peranti, vendor dan id produk,
dan sebarang keupayaan peranti yang boleh digunakan oleh libvirt (seperti sama ada tetapan semula peranti adalah
disokong). peranti boleh sama ada nama peranti atau pasangan wwn dalam format "wwnn,wwpn" (hanya
berfungsi untuk HBA).

senarai nodedev topi --pokok
Senaraikan semua peranti yang tersedia pada nod yang diketahui oleh libvirt. topi digunakan
untuk menapis senarai mengikut jenis keupayaan, jenis mesti dipisahkan dengan koma, cth
--cap pci,scsi, jenis keupayaan yang sah termasuk 'sistem', 'pci', 'usb_device', 'usb',
'net', 'scsi_host', 'scsi_target', 'scsi', 'storage', 'fc_host', 'vports',
'scsi_generic'. Jika --pokok digunakan, output diformatkan dalam pokok yang mewakili
ibu bapa setiap nod. topi and --pokok saling eksklusif.

nodedev-attach semula mengangguk
Istiharkan itu mengangguk tidak lagi digunakan oleh mana-mana tetamu, dan hos boleh menyambung semula
penggunaan biasa peranti. Ini dilakukan secara automatik untuk peranti PCI dalam mod terurus
dan peranti USB, tetapi mesti dilakukan secara eksplisit untuk memadankan sebarang eksplisit nodedev-detach.

nodedev-reset mengangguk
Cetuskan tetapan semula peranti untuk mengangguk, berguna sebelum memindahkan peranti nod antara
laluan tetamu atau hos. Libvirt selalunya akan melakukan tindakan ini secara tersirat apabila
diperlukan, tetapi arahan ini membenarkan tetapan semula eksplisit apabila diperlukan.

VIRTUAL RANGKAIAN PERINTAH

Perintah berikut memanipulasi rangkaian. Libvirt mempunyai keupayaan untuk menentukan maya
rangkaian yang kemudiannya boleh digunakan oleh domain dan dipautkan ke peranti rangkaian sebenar. Untuk lebih
maklumat terperinci tentang ciri ini lihat dokumentasi di
<http://libvirt.org/formatnetwork.html> . Banyak arahan untuk rangkaian maya adalah
serupa dengan yang digunakan untuk domain, tetapi cara untuk menamakan rangkaian maya adalah sama ada dengan
namanya atau UUID.

net-autostart rangkaian [--lumpuhkan]
Konfigurasikan rangkaian maya untuk dimulakan secara automatik semasa but. The --lumpuhkan pilihan
lumpuhkan automula.

net-create fail
Buat rangkaian maya sementara (sementara) daripada XML fail dan instantiate
(mulakan) rangkaian. Lihat dokumentasi dihttp://libvirt.org/formatnetwork.html>
untuk mendapatkan penerangan tentang format rangkaian XML yang digunakan oleh libvirt.

net-define fail
Tentukan rangkaian maya berterusan yang tidak aktif atau ubah suai rangkaian berterusan sedia ada
daripada XML fail.

jaring-musnah rangkaian
Musnahkan (berhenti) rangkaian maya sementara atau berterusan yang ditentukan oleh namanya
atau UUID. Ini berkuat kuasa serta-merta.

net-dumpxml rangkaian [--tidak aktif]
Keluarkan maklumat rangkaian maya sebagai pembuangan XML ke stdout. Jika --tidak aktif is
ditentukan, maka fungsi fizikal tidak dikembangkan ke dalam maya yang berkaitan
fungsi.

bersih-edit rangkaian
Edit fail konfigurasi XML untuk rangkaian.

Ini bersamaan dengan:

virsh net-dumpxml --rangkaian tidak aktif > network.xml
vi network.xml (atau buat perubahan dengan editor teks anda yang lain)
virsh net-define network.xml

kecuali ia melakukan beberapa pemeriksaan ralat.

Editor yang digunakan boleh dibekalkan oleh pembolehubah persekitaran $VISUAL atau $EDITOR, dan
lalai kepada "vi".

net-event {[rangkaian] kategori acara [--gelung] [--masa tamat saat] [--cap masa] | --senarai}
Tunggu kelas acara rangkaian berlaku dan cetak butiran acara yang sesuai
seperti yang berlaku. Acara boleh ditapis secara pilihan oleh rangkaian. Menggunakan --senarai as
satu-satunya hujah akan menyediakan senarai yang mungkin kategori acara nilai yang diketahui oleh pelanggan ini,
walaupun sambungan mungkin tidak membenarkan pendaftaran untuk semua acara ini.

Secara lalai, arahan ini adalah satu pukulan, dan mengembalikan kejayaan sebaik sahaja peristiwa berlaku; awak
boleh menghantar SIGINT (biasanya melalui "Ctrl-C") untuk berhenti serta-merta. Jika --masa tamat is
ditentukan, arahan berhenti menunggu acara selepas itu saat telah berlalu. Dengan
--gelung, arahan mencetak semua acara sehingga tamat masa atau kunci gangguan.

Bila --cap masa digunakan, cap waktu yang boleh dibaca manusia akan dicetak sebelum acara.

net-info rangkaian
Mengembalikan maklumat asas tentang rangkaian objek.

senarai bersih [--tidak aktif | --semua] { [--meja] | --nama | --uuuid } [--berterusan]
[<--sementara>] [--autostart] [<--tiada-autostart>]
Mengembalikan senarai rangkaian aktif, jika --semua dinyatakan ini juga akan termasuk
rangkaian yang ditakrifkan tetapi tidak aktif, jika --tidak aktif ditentukan hanya yang tidak aktif akan
disenaraikan. Anda juga mungkin mahu menapis rangkaian yang dikembalikan dengan --berterusan untuk disenaraikan
yang gigih, --sementara untuk menyenaraikan yang sementara, --autostart untuk menyenaraikan
yang dengan automula didayakan, dan --tiada-autostart untuk menyenaraikan yang mempunyai autostart
kurang upaya.

If --nama ditentukan, nama rangkaian dicetak dan bukannya jadual yang diformatkan
setiap baris. Jika --uuuid adalah ditentukan UUID rangkaian dicetak bukannya nama. Bendera
--meja menentukan bahawa output berformat jadual warisan harus digunakan. Ini adalah
lalai. Semua ini adalah saling eksklusif.

NOTA: Apabila bercakap dengan pelayan lama, arahan ini terpaksa menggunakan satu siri API
panggilan dengan kaum yang wujud, di mana kolam mungkin tidak disenaraikan atau mungkin muncul lebih banyak
daripada sekali jika ia menukar keadaan antara panggilan semasa senarai sedang dikumpulkan. Lebih baru
pelayan tidak mempunyai masalah ini.

nama bersih rangkaian-UUID
Tukar UUID rangkaian kepada nama rangkaian.

net-start rangkaian
Mulakan rangkaian tidak aktif (yang ditakrifkan sebelum ini).

net-undefine rangkaian
Nyahtakrifkan konfigurasi untuk rangkaian yang berterusan. Jika rangkaian aktif, buat
sementara.

net-uuid nama rangkaian
Tukar nama rangkaian kepada UUID rangkaian.

kemas kini bersih rangkaian arahan seksyen xml [--induk-indeks indeks] [[--hidup] [--config] |
[--semasa]]
Kemas kini bahagian yang diberikan bagi definisi rangkaian sedia ada, dengan perubahan
pilihan berkuat kuasa serta-merta, tanpa perlu memusnahkan dan memulakan semula
rangkaian.

arahan ialah salah satu daripada "tambah-dahulu", "tambah-akhir", "tambah" (sinonim untuk tambah-akhir), "padam",
atau "ubah suai".

seksyen ialah salah satu daripada "jambatan", "domain", "ip", "ip-dhcp-host", "ip-dhcp-range",
"forward", "forward-interface", "forward-pf", "portgroup", "dns-host", "dns-txt", atau
"dns-srv", setiap bahagian dinamakan oleh gabungan hierarki elemen xml
membawa kepada perubahan elemen. Contohnya, "ip-dhcp-host" akan menukar
elemen yang terkandung di dalam elemen di dalam elemen bagi
rangkaian.

xml ialah sama ada teks elemen xml lengkap daripada jenis yang diubah (cth.
"", atau nama fail yang mengandungi
elemen xml lengkap. Nyahkekaburan dilakukan dengan melihat watak pertama
teks yang disediakan - jika aksara pertama ialah "<", ia ialah teks xml, jika aksara pertama
bukan "<", ia adalah nama fail yang mengandungi teks xml yang akan digunakan.

. --induk-indeks pilihan digunakan untuk menentukan mana antara beberapa elemen induk yang
elemen yang diminta berada dalam (berasaskan 0). Sebagai contoh, elemen dhcp boleh berada dalam mana-mana
satu daripada berbilang elemen dalam rangkaian; jika indeks induk tidak disediakan,
"paling sesuai" elemen akan dipilih (biasanya satu-satunya yang sudah
mempunyai elemen ), tetapi jika --induk-indeks diberikan, contoh tertentu itu
akan mendapat pengubahsuaian.

If --hidup ditentukan, menjejaskan rangkaian yang sedang berjalan. Jika --config ditentukan, mempengaruhi
permulaan rangkaian yang berterusan seterusnya. Jika --semasa ditentukan, mempengaruhi
keadaan rangkaian semasa. Kedua-duanya --hidup and --config bendera boleh diberikan, tetapi --semasa is
eksklusif. Tidak menyatakan sebarang bendera adalah sama dengan menyatakan --semasa.

net-dhcp-leases rangkaian [mac]
Dapatkan senarai pajakan dhcp untuk semua antara muka rangkaian yang disambungkan ke maya yang diberikan
rangkaian atau keluaran terhad hanya untuk satu antara muka jika mac dinyatakan.

INTERFACE PERINTAH

Perintah berikut memanipulasi antara muka hos. Selalunya, antara muka hos ini boleh
digunakan dengan nama dalam domain elemen (seperti jambatan yang dicipta sistem
antara muka), tetapi tidak ada keperluan bahawa antara muka hos terikat kepada mana-mana tertentu
XML konfigurasi tetamu sama sekali.

Banyak arahan untuk antara muka hos adalah serupa dengan yang digunakan untuk domain, dan
cara untuk menamakan antara muka adalah sama ada dengan namanya atau alamat MACnya. Walau bagaimanapun, menggunakan MAC
alamat untuk sebuah saya menghadapi argumen hanya berfungsi apabila alamat itu unik (jika antara muka dan
jambatan berkongsi alamat MAC yang sama, yang sering berlaku, kemudian menggunakan alamat MAC tersebut
mengakibatkan ralat disebabkan oleh kekaburan, dan anda mesti menggunakan nama sebaliknya).

iface-bridge antara muka jambatan [--tidak-stp] [kelewatan] [--tidak-mula]
Buat peranti jambatan bernama jambatan, dan pasangkan peranti rangkaian sedia ada antara muka
ke jambatan baru. Jambatan baharu lalai untuk dimulakan serta-merta, dengan STP didayakan
dan kelewatan 0; tetapan ini boleh diubah dengan --tidak-stp, --tidak-mula, Dan
nombor integer saat untuk kelewatan. Semua konfigurasi alamat IP bagi antara muka akan
dipindahkan ke peranti jambatan baharu.

Lihat juga iface-unbridge untuk membatalkan operasi ini.

iface-define fail
Tentukan antara muka hos fizikal berterusan yang tidak aktif atau ubah suai tetapan sedia ada
satu daripada XML fail.

iface-musnah antara muka
Musnahkan (berhenti) antara muka hos yang diberikan, seperti dengan menjalankan "jika-bawah" untuk melumpuhkan itu
antara muka daripada penggunaan aktif. Ini berkuat kuasa serta-merta.

iface-dumpxml antara muka [--tidak aktif]
Keluarkan maklumat antara muka hos sebagai pembuangan XML ke stdout. Jika --tidak aktif is
ditentukan, maka output mencerminkan keadaan berterusan antara muka yang akan
digunakan pada kali seterusnya ia dimulakan.

iface-edit antara muka
Edit fail konfigurasi XML untuk antara muka hos.

Ini bersamaan dengan:

virsh iface-dumpxml iface > iface.xml
vi iface.xml (atau buat perubahan dengan editor teks anda yang lain)
virsh iface-define iface.xml

kecuali ia melakukan beberapa pemeriksaan ralat.

Editor yang digunakan boleh dibekalkan oleh pembolehubah persekitaran $VISUAL atau $EDITOR, dan
lalai kepada "vi".

iface-list [--tidak aktif | --semua]
Mengembalikan senarai antara muka hos yang aktif. Jika --semua dinyatakan kehendak ini juga
termasuk antara muka yang ditakrifkan tetapi tidak aktif. Jika --tidak aktif ditentukan hanya yang tidak aktif
yang akan disenaraikan.

iface-name antara muka
Tukar MAC antara muka hos kepada nama antara muka, jika alamat MAC adalah unik di kalangan
antara muka hos.

antara muka menentukan alamat MAC antara muka.

iface-mac antara muka
Tukar nama antara muka hos kepada alamat MAC.

antara muka menentukan nama antara muka.

iface-start antara muka
Mulakan antara muka hos (yang ditakrifkan sebelum ini), seperti dengan menjalankan "jika-up".

iface-unbridge jambatan [--tidak-mula]
Runtuhkan peranti jambatan bernama jambatan, melepaskan antara muka asasnya kembali ke
penggunaan biasa, dan memindahkan semua konfigurasi alamat IP dari peranti jambatan ke
peranti asas. Antara muka asas dimulakan semula melainkan --tidak-mula is
hadir; bendera ini hadir untuk simetri, tetapi biasanya tidak disyorkan.

Lihat juga iface-bridge untuk membuat jambatan.

iface-undefine antara muka
Nyahtakrifkan konfigurasi untuk antara muka hos yang tidak aktif.

iface-mulakan
Cipta gambar tetapan antara muka hos semasa, yang kemudiannya boleh dilakukan
(iface-commit) atau dipulihkan (iface-rollback). Jika syot kilat sudah wujud, maka ini
arahan akan gagal sehingga syot kilat sebelumnya telah dilakukan atau dipulihkan.
Tingkah laku yang tidak ditentukan akan terhasil jika sebarang perubahan luaran dibuat pada antara muka hos di luar
API libvirt antara permulaan syot kilat dan komit akhirnya atau
kembalikan.

iface-commit
Isytiharkan semua perubahan sejak yang lalu iface-mulakan sebagai berfungsi, dan padamkan rollback
titik. Jika tiada petikan antara muka telah dimulakan, maka arahan ini akan
gagal.

iface-rollback
Kembalikan semua tetapan antara muka hos kembali kepada keadaan yang direkodkan pada masa lalu iface-mulakan.
Jika tiada petikan antara muka telah dimulakan, maka arahan ini akan gagal.
But semula hos juga berfungsi sebagai titik balik tersirat.

PENYIMPANAN POOL PERINTAH

Perintah berikut memanipulasi kumpulan simpanan. Libvirt mempunyai keupayaan untuk mengurus
pelbagai penyelesaian storan, termasuk fail, partition mentah dan format khusus domain,
digunakan untuk menyediakan volum storan yang boleh dilihat sebagai peranti dalam mesin maya. Untuk lebih
maklumat terperinci tentang ciri ini, lihat dokumentasi di
<http://libvirt.org/formatstorage.html> . Banyak arahan untuk kolam adalah serupa dengan
yang digunakan untuk domain.

cari-storan-pool-sources jenis [srcSpec]
Mengembalikan XML yang menerangkan semua kemungkinan sumber kumpulan storan tersedia yang boleh digunakan
untuk mencipta atau mentakrifkan kumpulan storan sesuatu yang diberikan jenis. Jika srcSpec disediakan, ia adalah a
fail yang mengandungi XML untuk mengehadkan lagi pertanyaan untuk kumpulan.

Tidak semua kolam storan menyokong penemuan dengan cara ini. Tambahan pula, bagi mereka yang melakukannya
sokongan penemuan, hanya elemen XML tertentu diperlukan untuk mengembalikan sah
data, manakala elemen lain dan juga atribut beberapa elemen diabaikan kerana ia
tidak perlu mencari kolam berdasarkan kriteria carian. Senarai berikut
yang disokong jenis pilihan dan elemen XML minimum yang dijangka digunakan untuk melaksanakan
carian.

Untuk kumpulan "netfs" atau "gluster", jangkaan XML minimum yang diperlukan ialah
elemen dengan atribut "nama" yang menerangkan alamat IP atau nama hos yang akan digunakan
cari kolam. Atribut "port" akan diabaikan seperti mana-mana XML lain yang disediakan
unsur dalam srcSpec.

Untuk kolam "logik", kandungannya srcSpec fail diabaikan, walaupun jika
dengan syarat fail mesti wujud sekurang-kurangnya.

Untuk kumpulan "iscsi", jangkaan minimum XML yang diperlukan ialah elemen dengan a
atribut "name" yang menerangkan alamat IP atau nama hos yang akan digunakan untuk mencari kumpulan
(alamat pelayan iSCSI). Secara pilihan, atribut "port" mungkin disediakan, walaupun
ia akan lalai kepada 3260. Secara pilihan, elemen XML dengan "nama"
atribut boleh disediakan untuk mengehadkan lagi carian sasaran iSCSI kepada yang khusus
pemula untuk kumpulan storan iSCSI berbilang iqn.

cari-storage-pool-sources-as jenis [tuan rumah] [pelabuhan] [pemula]
Daripada menyediakan srcSpec Fail XML untuk cari-storan-pool-sources gunakan arahan ini
pilihan untuk membolehkan virsh menjana fail XML pertanyaan menggunakan pilihan
hujah. Perintah akan mengembalikan XML output yang sama seperti cari-storan-pool-sources.

Penggunaan tuan rumah untuk menerangkan hos tertentu untuk digunakan untuk storan rangkaian, seperti netfs,
gluster, dan iscsi jenis kolam.

Penggunaan pelabuhan untuk mengehadkan lagi port rangkaian yang mana untuk digunakan untuk sambungan jika
diperlukan oleh bahagian belakang storan khusus, seperti iscsi.

Penggunaan pemula untuk mengehadkan lagi iscsi jenis carian kumpulan kepada sasaran tertentu
pemula.

kolam-autostart kolam-atau-uuid [--lumpuhkan]
Konfigurasikan sama ada kolam hendaklah bermula secara automatik semasa but.

bina kolam kolam-atau-uuid [--tulis ganti] [--tiada-tulis ganti]
Bina kolam yang diberikan.

Pilihan --tulis ganti and --tiada-tulis ganti hanya boleh digunakan untuk bina kolam sistem fail atau
kolam cakera. Untuk kumpulan sistem fail jika kedua-duanya tidak dinyatakan, bina kolam membuat
direktori tersebut. Jika --tiada-tulis ganti ditentukan, ia menyiasat untuk menentukan sama ada sistem fail
sudah wujud pada peranti sasaran, mengembalikan ralat jika wujud, atau menggunakan mkfs to
format peranti sasaran jika tidak. Jika --tulis ganti ditentukan, mkfs sentiasa dilaksanakan
dan sebarang data sedia ada pada peranti sasaran ditimpa tanpa syarat. Untuk cakera
kolam, jika kedua-duanya tidak dinyatakan atau --tiada-tulis ganti dinyatakan, bina kolam akan
gunakan 'parted --print' untuk menentukan sama ada cakera sudah mempunyai label sebelum ini
cuba mencipta satu. Hanya jika cakera belum mempunyainya akan diberi label
dicipta. Jika --tulis ganti ditentukan atau telah ditentukan bahawa cakera tidak
sudah mempunyai satu, 'mklabel berpisah' akan digunakan untuk membuat label format
ditentukan oleh jenis format sumber kolam atau "dos" jika tidak dinyatakan untuk kolam.

kolam-buat fail [--bina] [[--tulis ganti] | [--tiada-tulis ganti]]
Cipta dan mulakan objek kolam daripada XML fail.

[--bina] [[--tulis ganti] | [--tiada-tulis ganti]] melaksanakan a bina kolam selepas penciptaan dalam
untuk menghapuskan keperluan untuk arahan susulan untuk membina kolam. The --tulis ganti
and --tiada-tulis ganti bendera mengikut peraturan yang sama seperti bina kolam. Jika sekadar --bina is
disediakan, maka bina kolam dipanggil tanpa bendera.

pool-create-as nama jenis [--print-xml] [--source-host nama hos] [--laluan-sumber jalan]
[--source-dev jalan] [--nama-sumber nama] [--sasaran jalan] [--format-sumber format]
[--jenis-auth authtype --auth-nama pengguna nama pengguna --rahsia-penggunaan penggunaan] [[--nama-penyesuai
nama] | [--penyesuai-wwnn --penyesuai-wwpn] [--penyesuai-induk ibu bapa]] [--bina]
[[--tulis ganti] | [--tiada-tulis ganti]]
Buat dan mulakan objek kolam nama daripada parameter mentah. Jika --print-xml is
ditentukan, kemudian cetak XML objek kolam tanpa mencipta kolam.
Jika tidak, kolam mempunyai yang ditentukan jenis. Semasa menggunakan pool-create-as untuk kolam
jenis "cakera", partition sedia ada yang terdapat pada --source-dev jalan akan digunakan untuk
mengisi kolam cakera. Oleh itu, adalah dicadangkan untuk digunakan pool-define-as and kolam-
membina dengan --tulis ganti untuk memulakan kumpulan cakera dengan betul.

[--source-host nama hos] menyediakan nama hos sumber untuk kumpulan yang disokong oleh storan daripada
pelayan jauh (jenis pool netfs, iscsi, rbd, sheepdog, gluster).

[--laluan-sumber jalan] menyediakan laluan direktori sumber untuk kumpulan yang disokong oleh
direktori (dir jenis kolam).

[--source-dev jalan] menyediakan laluan sumber untuk kumpulan yang disokong oleh peranti fizikal
(jenis kolam fs, logik, cakera, iscsi, zfs).

[--nama-sumber nama] menyediakan nama sumber untuk kumpulan yang disokong oleh storan daripada yang dinamakan
elemen (jenis kolam logik, rbd, anjing gembala, gluster).

[--sasaran jalan] ialah laluan untuk pemetaan kolam storan ke dalam fail hos
sistem.

[--format-sumber format] menyediakan maklumat tentang format kolam (jenis kolam
fs, netfs, cakera, logik).

[--jenis-auth authtype --auth-nama pengguna nama pengguna --rahsia-penggunaan penggunaan] menyediakan
elemen yang diperlukan untuk menjana bukti kelayakan pengesahan untuk kumpulan storan. The
authtype adalah sama ada bab untuk iscsi jenis kolam atau ceph untuk rbd jenis kolam.

[--nama-penyesuai nama] mentakrifkan nama penyesuai scsi_hostN untuk digunakan untuk scsi_host
kolam jenis penyesuai.

[--penyesuai-wwnn --penyesuai-wwpn [--penyesuai-induk ibu bapa]] mentakrifkan wwnn dan wwpn kepada
digunakan untuk kumpulan jenis penyesuai fc_host. Ibu bapa secara pilihan memberikan nama
peranti nod scsi_hostN untuk digunakan untuk vHBA.

[--bina] [[--tulis ganti] | [--tiada-tulis ganti]] melaksanakan a bina kolam selepas penciptaan dalam
untuk menghapuskan keperluan untuk arahan susulan untuk membina kolam. The --tulis ganti
and --tiada-tulis ganti bendera mengikut peraturan yang sama seperti bina kolam. Jika sekadar --bina is
disediakan, maka bina kolam dipanggil tanpa bendera.

pool-define fail
Tentukan kumpulan storan berterusan yang tidak aktif atau ubah suai kumpulan storan berterusan sedia ada daripada
XML fail.

pool-define-as nama jenis [--print-xml] [--source-host nama hos] [--laluan-sumber jalan]
[--source-dev jalan] [--nama-sumber nama] [--sasaran jalan] [--format-sumber format]
[--jenis-auth authtype --auth-nama pengguna nama pengguna --rahsia-penggunaan penggunaan] [[--nama-penyesuai
nama] | [--penyesuai-wwnn --penyesuai-wwpn] [--penyesuai-induk ibu bapa]]
Buat, tetapi jangan mulakan, objek kolam nama daripada parameter mentah. Jika --print-xml
ditentukan, kemudian cetak XML objek kolam tanpa menentukan kolam.
Jika tidak, kolam mempunyai yang ditentukan jenis.

Gunakan hujah yang sama seperti pool-create-as, kecuali untuk --bina, --tulis ganti, dan
--tiada-tulis ganti pilihan.

kolam-musnah kolam-atau-uuid
Memusnahkan (menghentikan) yang diberikan kolam objek. Libvirt tidak lagi akan mengurus storan
diterangkan oleh objek kolam, tetapi data mentah yang terkandung dalam kolam tidak diubah,
dan kemudian boleh dipulihkan dengan kolam-buat.

pool-delete kolam-atau-uuid
Musnahkan sumber yang digunakan oleh yang diberi kolam objek. Operasi ini tidak boleh dipulihkan.
. kolam objek masih wujud selepas arahan ini, sedia untuk penciptaan yang baharu
volum simpanan.

pool-dumpxml [--tidak aktif] kolam-atau-uuid
Mengembalikan maklumat XML tentang kolam objek. --tidak aktif suruh virsh buang
konfigurasi kolam yang akan digunakan pada permulaan kolam seterusnya berbanding dengan
konfigurasi kolam semasa.

kolam-edit kolam-atau-uuid
Edit fail konfigurasi XML untuk kolam storan.

Ini bersamaan dengan:

virsh pool-dumpxml pool > pool.xml
vi pool.xml (atau buat perubahan dengan editor teks anda yang lain)
virsh pool-define pool.xml

kecuali ia melakukan beberapa pemeriksaan ralat.

Editor yang digunakan boleh dibekalkan oleh pembolehubah persekitaran $VISUAL atau $EDITOR, dan
lalai kepada "vi".

kolam-info kolam-atau-uuid
Mengembalikan maklumat asas tentang kolam objek.

senarai kolam [--tidak aktif] [--semua] [--berterusan] [--sementara] [--autostart] [--tiada-autostart]
[[--perincian] []
Senaraikan objek kolam yang diketahui oleh libvirt. Secara lalai, hanya kumpulan aktif disenaraikan;
--tidak aktif hanya menyenaraikan kumpulan yang tidak aktif, dan --semua menyenaraikan semua kolam.

Selain itu, terdapat beberapa set bendera penapisan. --berterusan adalah untuk menyenaraikan
kolam berterusan, --sementara adalah untuk menyenaraikan kolam sementara. --autostart menyenaraikan
kolam autostart, --tiada-autostart menyenaraikan kumpulan dengan automula dilumpuhkan.

Anda juga mungkin mahu menyenaraikan kolam dengan jenis tertentu menggunakan jenis, jenis kolam mestilah
dipisahkan dengan koma, mis. --taip dir, cakera. Jenis kolam yang sah termasuk 'dir', 'fs',
'netfs', 'logical', 'disk', 'iscsi', 'scsi', 'mpath', 'rbd', 'sheepdog' dan 'gluster'.

. --perincian pilihan mengarahkan virsh untuk tambahan memaparkan kegigihan kolam dan
maklumat berkaitan kapasiti jika ada.

NOTA: Apabila bercakap dengan pelayan lama, arahan ini terpaksa menggunakan satu siri API
panggilan dengan kaum yang wujud, di mana kolam mungkin tidak disenaraikan atau mungkin muncul lebih banyak
daripada sekali jika ia menukar keadaan antara panggilan semasa senarai sedang dikumpulkan. Lebih baru
pelayan tidak mempunyai masalah ini.

nama kolam uuid
Tukarkan uuid kepada nama kolam.

menyegarkan kolam kolam-atau-uuid
Muat semula senarai jilid yang terkandung dalam kolam.

kolam-permulaan kolam-atau-uuid [--bina] [[--tulis ganti] | [--tiada-tulis ganti]]
Mulakan storan kolam, yang sebelum ini ditakrifkan tetapi tidak aktif.

[--bina] [[--tulis ganti] | [--tiada-tulis ganti]] melaksanakan a bina kolam sebelum kolam-permulaan
untuk memastikan persekitaran kolam berada dalam keadaan yang dijangka dan bukannya perlu menjalankan
bina arahan sebelum dimulakan. The --tulis ganti and --tiada-tulis ganti bendera mengikut
peraturan yang sama seperti bina kolam. Jika sekadar --bina disediakan, maka bina kolam dipanggil dengan
tiada bendera.

Nota: Kumpulan storan yang bergantung pada sumber jauh seperti "iscsi" atau (v)HBA
kolam "scsi" yang disokong mungkin perlu dimuat semula beberapa kali untuk mendapatkan semua
volum dikesan (lihat menyegarkan kolam). Ini kerana peranti volum yang sepadan
mungkin tidak terdapat dalam sistem fail hos semasa permulaan kumpulan awal atau
percubaan muat semula semasa. Bilangan percubaan semula muat semula bergantung pada rangkaian
sambungan dan masa yang diambil oleh hos untuk mengeksport peranti yang sepadan.

pool-undefine kolam-atau-uuid
Nyahtakrifkan konfigurasi untuk yang tidak aktif kolam.

kolam-uuid kolam
Mengembalikan UUID yang dinamakan kolam.

VOLUME PERINTAH

vol-create kolam-atau-uuid FAIL [--prealloc-metadata]
Buat volum daripada XML . kolam-atau-uuid ialah nama atau UUID storan
pool untuk mencipta volum masuk. FAIL ialah XML dengan definisi volum. An
cara mudah untuk mencipta XML adalah dengan menggunakan vol-dumpxml perintah untuk mendapatkan
definisi volum sedia ada. [--prealloc-metadata] praperuntukkan metadata (untuk
imej qcow2 yang tidak menyokong peruntukan penuh). Pilihan ini mencipta imej yang jarang
fail dengan metadata, menghasilkan prestasi yang lebih tinggi berbanding imej dengan no
praperuntukan dan hanya lebih tinggi sedikit penggunaan ruang cakera awal.

Contoh

virsh vol-dumpxml --pool storagepool1 appvolume1 > newvolume.xml
vi newvolume.xml (atau buat perubahan dengan editor teks anda yang lain)
virsh vol-create differentstoragepool newvolume.xml

vol-cipta-daripada kolam-atau-uuid FAIL [--inputpool kolam-atau-uuid] vol-name-or-key-or-path
[--prealloc-metadata] [--pautan semula]
Buat volum, menggunakan volum lain sebagai input. kolam-atau-uuid ialah nama atau UUID bagi
kolam storan untuk mencipta volum masuk. FAIL ialah XML dengan kelantangan
definisi. --inputpool kolam-atau-uuid ialah nama atau uuid bagi kumpulan simpanan itu
volum sumber masuk. vol-name-or-key-or-path ialah nama atau kunci atau laluan sumber
isipadu. [--prealloc-metadata] praperuntukkan metadata (untuk imej qcow2 yang tidak
menyokong peruntukan penuh). Pilihan ini mencipta fail imej yang jarang dengan metadata,
menghasilkan prestasi yang lebih tinggi berbanding imej tanpa praperuntukan dan sahaja
penggunaan ruang cakera awal yang lebih tinggi sedikit. Bila --pautan semula ditentukan, lakukan LEMBU
salinan ringan, di mana blok data disalin hanya apabila diubah suai. Jika ini tidak
mungkin, salinan gagal.

vol-create-as kolam-atau-uuid nama kapasiti [--peruntukan saiz] [--format rentetan]
[--backing-vol vol-name-or-key-or-path] [--backing-vol-format rentetan]
[--prealloc-metadata]
Buat volum daripada set hujah. kolam-atau-uuid ialah nama atau UUID bagi
kolam simpanan untuk mencipta volum masuk. nama ialah nama jilid baharu. Untuk cakera
pool, ini mesti sepadan dengan nama partition seperti yang ditentukan daripada peranti sumber pool
laluan dan partition yang tersedia seterusnya. Contohnya, laluan peranti sumber /dev/sdb
dan tiada partition pada cakera, maka nama mestilah sdb1 dengan nama seterusnya
menjadi sdb2 dan seterusnya. kapasiti ialah saiz volum yang akan dibuat, sebagai skala
integer (lihat NOTA di atas), lalai kepada bait jika tiada akhiran. --peruntukan
saiz ialah saiz awal yang akan diperuntukkan dalam volum, juga sebagai integer berskala
lalai kepada bait. --format rentetan digunakan dalam kumpulan storan berasaskan fail untuk ditentukan
format fail volum untuk digunakan; mentah, bochs, qcow, qcow2, vmdk, qed. Gunakan lanjutan untuk
kumpulan storan cakera untuk mencipta partition lanjutan (nilai lain ialah kesahihan
diperiksa tetapi tidak dipelihara apabila libvirtd dimulakan semula atau kolam disegarkan).
--backing-vol vol-name-or-key-or-path ialah volum sokongan sumber yang akan digunakan jika
mengambil gambar volum sedia ada. --backing-vol-format rentetan ialah format
kelantangan sandaran syot kilat; mentah, bochs, qcow, qcow2, qed, vmdk, host_device. Ini
Walau bagaimanapun, dimaksudkan untuk kumpulan storan berasaskan fail. [--prealloc-metadata] praperuntukkan
metadata (untuk imej qcow2 yang tidak menyokong peruntukan penuh). Pilihan ini mewujudkan a
fail imej yang jarang dengan metadata, menghasilkan prestasi yang lebih tinggi berbanding dengan imej
tanpa praperuntukan dan hanya penggunaan ruang cakera awal yang lebih tinggi sedikit.

klon voltan [--kolam kolam-atau-uuid] vol-name-or-key-or-path nama [--prealloc-metadata]
[--pautan semula]
Klonkan volum sedia ada. Kurang berkuasa, tetapi lebih mudah untuk ditaip, versi vol-create-
dari. --kolam kolam-atau-uuid ialah nama atau UUID kolam storan untuk mencipta
isipadu masuk. vol-name-or-key-or-path ialah nama atau kunci atau laluan volum sumber.
nama ialah nama jilid baharu. [--prealloc-metadata] praperuntukkan metadata (untuk
imej qcow2 yang tidak menyokong peruntukan penuh). Pilihan ini mencipta imej yang jarang
fail dengan metadata, menghasilkan prestasi yang lebih tinggi berbanding imej dengan no
praperuntukan dan hanya lebih tinggi sedikit penggunaan ruang cakera awal. Bila --pautan semula is
ditentukan, lakukan salinan ringan COW, di mana blok data disalin hanya apabila
diubahsuai. Jika ini tidak mungkin, salinan gagal.

vol-delete [--kolam kolam-atau-uuid] vol-name-or-key-or-path [--padam-snapshot]
Padamkan kelantangan yang diberikan. --kolam kolam-atau-uuid ialah nama atau UUID bagi kumpulan storan
isipadu masuk. vol-name-or-key-or-path ialah nama atau kunci atau laluan volum ke
padam.

. --padam-snapshot flag menentukan bahawa sebarang syot kilat yang dikaitkan dengan storan
kelantangan harus dipadamkan juga. Tidak semua pemacu storan menyokong pilihan ini,
pada masa ini hanya rbd.

muat naik vol [--kolam kolam-atau-uuid] [--offset bait] [--panjang bait] vol-name-or-key-or-path
fail tempatan
Muat naik kandungan fail tempatan kepada volum simpanan. --kolam kolam-atau-uuid adalah
nama atau UUID kumpulan storan yang isipadunya. vol-name-or-key-or-path adalah
nama atau kunci atau laluan kelantangan tempat fail akan dimuat naik. --offset adalah
kedudukan dalam volum storan untuk mula menulis data. Nilai mestilah 0
atau lebih besar. --panjang ialah sempadan atas jumlah data yang akan dimuat naik. A negatif
nilai ditafsirkan sebagai nilai panjang yang tidak ditandatangani untuk pada dasarnya merangkumi segala-galanya
dari offset ke penghujung volum. Ralat akan berlaku jika fail tempatan is
lebih besar daripada panjang yang ditetapkan. Lihat penerangan untuk libvirt
virStorageVolUpload API untuk butiran mengenai kemungkinan volum sasaran dan perubahan kumpulan
hasil daripada penyegaran kolam apabila muat naik cuba.

muat turun vol [--kolam kolam-atau-uuid] [--offset bait] [--panjang bait] vol-name-or-key-or-
jalan fail tempatan
Muat turun kandungan volum storan ke fail tempatan. --kolam kolam-atau-uuid adalah
nama atau UUID kumpulan storan yang isipadunya. vol-name-or-key-or-path adalah
nama atau kunci atau laluan volum untuk dimuat turun. --offset ialah kedudukan dalam
volum storan untuk mula membaca data. Nilai mestilah 0 atau lebih besar.
--panjang ialah sempadan atas jumlah data yang akan dimuat turun. Nilai negatif ialah
ditafsirkan sebagai nilai panjang panjang yang tidak ditandatangani untuk pada dasarnya merangkumi segala-galanya daripada
mengimbangi ke penghujung volum.

vol-lap [--kolam kolam-atau-uuid] [--algoritma algoritma] vol-name-or-key-or-path
Lap kelantangan, pastikan data sebelumnya pada kelantangan tidak boleh diakses untuk bacaan akan datang.
--kolam kolam-atau-uuid ialah nama atau UUID bagi kumpulan storan yang isipadunya. vol-
nama-atau-kunci-atau-laluan ialah nama atau kunci atau laluan kelantangan untuk dipadam. Ia adalah mungkin
untuk memilih algoritma lap yang berbeza dan bukannya menulis semula volum dengan sifar. ini
boleh dilakukan melalui --algoritma suis.

Disokong algoritma
sifar - 1-lulus semua sifar
nnsa - Surat Polisi NNSA 4-lulus NAP-14.1-C (XVI-8) untuk
membersihkan cakera keras boleh tanggal dan tidak boleh tanggal:
rawak x2, 0x00, sahkan.
dod - prosedur 4-lulus DoD 5220.22-M seksyen 8-306 untuk
sanitizing boleh tanggal dan tidak boleh tanggal tegar
cakera: rawak, 0x00, 0xff, sahkan.
bsi - kaedah 9-lulus yang disyorkan oleh Pusat Jerman
Keselamatan dalam Teknologi Maklumat
(http://www.bsi.bund.de): 0xff, 0xfe, 0xfd, 0xfb,
0xf7, 0xef, 0xdf, 0xbf, 0x7f.
gutmann - Urutan 35-laluan kanonik yang diterangkan dalam
kertas Gutmann.
schneier - kaedah 7-laluan yang diterangkan oleh Bruce Schneier dalam
"Kriptografi Gunaan" (1996): 0x00, 0xff,
rawak x5.
pfitzner7 - Kaedah 7-random-pass Roy Pfitzner: rawak x7.
pfitzner33 - Kaedah 33-random-pass Roy Pfitzner: rawak x33.
rawak - corak 1-laluan: rawak.

Nota: Ketersediaan algoritma mungkin dihadkan oleh versi "scrub"
binari dipasang pada hos.

vol-dumpxml [--kolam kolam-atau-uuid] vol-name-or-key-or-path
Keluarkan maklumat volum sebagai pembuangan XML ke stdout. --kolam kolam-atau-uuid adalah
nama atau UUID kumpulan storan yang isipadunya. vol-name-or-key-or-path adalah namanya
atau kunci atau laluan volum untuk mengeluarkan XML.

vol-info [--kolam kolam-atau-uuid] vol-name-or-key-or-path
Mengembalikan maklumat asas tentang volum storan yang diberikan. --kolam kolam-atau-uuid adalah
nama atau UUID kumpulan storan yang isipadunya. vol-name-or-key-or-path adalah namanya
atau kunci atau laluan volum untuk mengembalikan maklumat.

vol-senarai [--kolam kolam-atau-uuid] [--perincian]
Kembalikan senarai volum dalam kumpulan storan yang diberikan. --kolam kolam-atau-uuid adalah namanya
atau UUID kolam storan. The --perincian pilihan mengarahkan virsh untuk tambahan
paparan jenis volum dan maklumat berkaitan kapasiti jika ada.

vol-pool [--uuuid] vol-key-or-path
Kembalikan nama kolam atau UUID untuk volum tertentu. Secara lalai, nama kolam ialah
dikembalikan. Sekiranya --uuuid pilihan diberikan, UUID kolam dikembalikan sebaliknya. vol-key-
atau-jalan ialah kunci atau laluan volum untuk mengembalikan maklumat kumpulan.

laluan vol [--kolam kolam-atau-uuid] vol-nama-atau-kunci
Kembalikan laluan untuk volum tertentu. --kolam kolam-atau-uuid ialah nama atau UUID bagi
kolam simpanan isipadu dalam. vol-nama-atau-kunci ialah nama atau kunci kelantangan kepada
kembalikan jalan untuk.

nama vol vol-key-or-path
Kembalikan nama untuk volum tertentu. vol-key-or-path ialah kunci atau laluan kelantangan
untuk mengembalikan nama untuk.

kekunci vol [--kolam kolam-atau-uuid] vol-nama-atau-laluan
Kembalikan kekunci kelantangan untuk kelantangan tertentu. --kolam kolam-atau-uuid ialah nama atau UUID bagi
kolam simpanan isipadunya. vol-nama-atau-laluan ialah nama atau laluan kelantangan
untuk mengembalikan kekunci kelantangan untuk.

vol-saiz [--kolam kolam-atau-uuid] vol-nama-atau-laluan kolam-atau-uuid kapasiti [--peruntukkan]
[--delta] [--mengecut]
Ubah saiz kapasiti volum yang diberikan, dalam bait. --kolam kolam-atau-uuid ialah nama atau
UUID kumpulan storan isipadunya. vol-name-or-key-or-path ialah nama atau kunci
atau laluan volum untuk mengubah saiz. Kapasiti baharu mungkin jarang melainkan --peruntukkan
dinyatakan. Biasanya, kapasiti adalah saiz baru, tetapi jika --delta hadir, maka ia
ditambah kepada saiz sedia ada. Percubaan untuk mengecilkan kelantangan akan gagal melainkan
--mengecut hadir; kapasiti tidak boleh negatif melainkan --mengecut disediakan, tetapi a
tanda negatif tidak perlu. kapasiti ialah integer berskala (lihat NOTA di atas), yang
lalai kepada bait jika tiada akhiran. Perintah ini hanya selamat untuk penyimpanan
jilid yang tidak digunakan oleh tetamu aktif; lihat juga saiz sekat untuk mengubah saiz secara langsung.

RAHSIA PERINTAH

Perintah berikut memanipulasi "rahsia" (cth. kata laluan, frasa laluan dan penyulitan
kunci). Libvirt boleh menyimpan rahsia secara bebas daripada penggunaannya, dan objek lain (cth.
jilid atau domain) boleh merujuk kepada rahsia untuk penyulitan atau mungkin kegunaan lain.
Rahsia dikenal pasti menggunakan UUID. Lihat <http://libvirt.org/formatsecret.html> untuk
dokumentasi format XML yang digunakan untuk mewakili sifat rahsia.

rahsia-takrifkan fail
Cipta rahsia dengan sifat yang dinyatakan dalam fail, tanpa rahsia yang berkaitan
nilai. Sekiranya fail tidak menyatakan UUID, pilih satu secara automatik. Jika fail menyatakan
UUID bagi rahsia sedia ada, gantikan sifatnya dengan sifat yang ditakrifkan dalam fail,
tanpa menjejaskan nilai rahsia.

rahsia-dumpxml rahsia
Sifat keluaran bagi rahsia (dinyatakan oleh UUIDnya) sebagai pembuangan XML ke stdout.

nilai-set rahsia rahsia base64
Tetapkan nilai yang dikaitkan dengan rahsia (dinyatakan oleh UUIDnya) kepada nilai
Nilai berkod Base64 base64.

rahsia-dapat-nilai rahsia
Keluarkan nilai yang berkaitan dengan rahsia (dinyatakan oleh UUIDnya) untuk stdout, dikodkan
menggunakan Base64.

rahsia-tidak jelas rahsia
Padamkan a rahsia (dinyatakan oleh UUIDnya), termasuk nilai yang berkaitan, jika ada.

senarai rahsia [--sementara] [--tidak bersifat sementara] [--swasta] [--tidak-peribadi]
Mengembalikan senarai rahsia. Anda juga mungkin ingin menapis rahsia yang dikembalikan dengan
--sementara untuk menyenaraikan yang fana, --tidak bersifat sementara untuk menyenaraikan yang bukan sementara,
--swasta untuk menyenaraikan yang peribadi, dan --tidak-peribadi untuk menyenaraikan yang bukan persendirian.

GAMBAR GAMBAR PERINTAH

Perintah berikut memanipulasi syot kilat domain. Syot kilat mengambil cakera, memori dan
keadaan peranti domain pada titik masa dan simpan untuk kegunaan masa hadapan. Mereka mempunyai banyak
kegunaan, daripada menyimpan salinan "bersih" imej OS kepada menyimpan keadaan domain sebelum a
operasi yang berpotensi merosakkan. Syot kilat dikenal pasti dengan nama yang unik. Lihat
<http://libvirt.org/formatsnapshot.html> untuk dokumentasi format XML yang digunakan
mewakili sifat syot kilat.

snapshot-buat domain [xmlfile] {[--takrif semula [--semasa]] | [--tiada-metadata] [--berhenti]
[--cakera sahaja] [--guna semula-luaran] [--diam] [--atom] [--hidup]}
Cipta gambar untuk domain domain dengan sifat yang dinyatakan dalam xmlfile.
Biasanya, satu-satunya sifat yang boleh ditetapkan untuk petikan domain ialah dan
elemen , serta jika --cakera sahaja diberikan; selebihnya
medan diabaikan, dan diisi secara automatik oleh libvirt. Jika xmlfile sepenuhnya
ditinggalkan, maka libvirt akan memilih nilai untuk semua medan. Gambar baharu akan
menjadi terkini, seperti yang disenaraikan oleh syot kilat semasa.

If --berhenti ditentukan, domain akan dibiarkan dalam keadaan tidak aktif selepas
syot kilat dibuat.

If --cakera sahaja ditentukan, syot kilat hanya akan menyertakan keadaan cakera dan bukannya keadaan cakera
pusat pemeriksaan sistem biasa dengan keadaan vm. Syot kilat cakera adalah lebih pantas daripada sistem penuh
pusat pemeriksaan, tetapi berbalik kepada syot kilat cakera mungkin memerlukan siaran semula fsck atau jurnal,
kerana ia adalah seperti keadaan cakera pada titik apabila kord kuasa ditarik secara tiba-tiba;
dan mencampurkan --berhenti and --cakera sahaja kehilangan sebarang data yang tidak disalurkan ke cakera pada
pada bila-bila masa.

If --takrif semula ditentukan, maka semua elemen XML dihasilkan oleh petikan-dumpxml adalah
sah; ini boleh digunakan untuk memindahkan hierarki syot kilat dari satu mesin ke mesin lain, ke
cipta semula hierarki untuk kes domain sementara yang hilang dan kemudiannya
dicipta semula dengan nama dan UUID yang sama, atau untuk membuat sedikit perubahan dalam syot kilat
metadata (seperti aspek khusus hos bagi domain XML yang dibenamkan dalam syot kilat).
Apabila bendera ini dibekalkan, xmlfile hujah adalah wajib, dan domain
syot kilat semasa tidak akan diubah melainkan --semasa bendera juga diberikan.

If --tiada-metadata ditentukan, maka data syot kilat dibuat, tetapi sebarang metadata adalah
segera dibuang (iaitu, libvirt tidak menganggap syot kilat sebagai semasa, dan
tidak boleh kembali kepada syot kilat melainkan --takrif semula kemudiannya digunakan untuk mengajar libvirt tentang
metadata semula).

If --guna semula-luaran ditentukan, dan XML syot kilat meminta syot kilat luaran
dengan destinasi fail sedia ada, maka destinasi mesti wujud dan pra-
dibuat dengan format dan metadata yang betul. Fail itu kemudiannya digunakan semula; jika tidak, a
syot kilat ditolak untuk mengelakkan kehilangan kandungan fail sedia ada.

If --diam ditentukan, libvirt akan cuba menggunakan ejen tetamu untuk membekukan dan menyahbeku
sistem fail yang dipasang domain. Walau bagaimanapun, jika domain tidak mempunyai ejen tetamu, gambar
penciptaan akan gagal. Pada masa ini, ini memerlukan --cakera sahaja untuk dilalui juga.

If --atom ditentukan, libvirt akan menjamin bahawa syot kilat itu berjaya, atau
gagal tanpa perubahan; tidak semua hypervisor menyokong ini. Jika bendera ini tidak
ditentukan, maka sesetengah hipervisor mungkin gagal selepas melakukan sebahagian tindakan, dan
dumpxml mesti digunakan untuk melihat sama ada sebarang perubahan separa berlaku.

If --hidup ditentukan, libvirt mengambil gambar semasa tetamu sedang berjalan. ini
meningkatkan saiz imej memori pusat pemeriksaan luaran. Ini pada masa ini
disokong hanya untuk pusat pemeriksaan luaran.

Kewujudan metadata syot kilat akan menghalang percubaan untuk undefine domain yang berterusan.
Walau bagaimanapun, untuk domain sementara, metadata syot kilat hilang secara senyap apabila domain tersebut
berhenti berjalan (sama ada dengan arahan seperti memusnahkan atau dengan tindakan tetamu dalaman).

snapshot-create-as domain {[--print-xml] | [--tiada-metadata] [--berhenti] [--guna semula-luaran]}
[nama] [Penerangan] [--cakera sahaja [--diam]] [--atom] [[--hidup] [--memspec memspec]]
[--diskspec] diskspec]...
Cipta gambar untuk domain domain dengan dan yang diberikan; jika sama ada
nilai ditinggalkan, libvirt akan memilih nilai. Jika --print-xml ditentukan, kemudian XML
sesuai untuk snapshot-buat adalah output, dan bukannya membuat syot kilat.
Jika tidak, sekiranya --berhenti ditentukan, domain akan dibiarkan dalam keadaan tidak aktif selepas
syot kilat dicipta, dan jika --cakera sahaja ditentukan, syot kilat tidak akan
sertakan keadaan vm.

. --memspec pilihan boleh digunakan untuk mengawal sama ada pusat pemeriksaan adalah dalaman atau
luaran. The --memspec bendera adalah wajib, diikuti dengan a memspec daripada borang tersebut
[file=]nama[,snapshot=jenis], di mana jenis boleh tidak, dalaman, Atau luar. Untuk memasukkan
koma literal dalam fail=nama, lepaskannya dengan koma kedua. --memspec tidak boleh digunakan
Bersama-sama dengan --cakera sahaja.

. --diskspec pilihan boleh digunakan untuk mengawal bagaimana --cakera sahaja dan pusat pemeriksaan luar
buat fail luaran. Pilihan ini boleh berlaku beberapa kali, mengikut nombor
daripada elemen dalam domain xml. Setiap ada dalam borang
cakera[,snapshot=type][,driver=type][,file=name]. A diskspec mesti disediakan untuk cakera
disokong oleh peranti sekat kerana libvirt tidak menjana nama fail secara automatik untuk mereka. Kepada
sertakan koma literal dalam cakera atau dalam fail=nama, lepaskannya dengan koma kedua. A
literal --diskspec mesti mendahului masing-masing diskspec melainkan ketiga-tiganya domain, nama, dan
Penerangan turut hadir. Sebagai contoh, spesifikasi cakera daripada
"vda,snapshot=external,file=/path/to,,new" menghasilkan XML berikut:




If --guna semula-luaran ditentukan, dan domain XML atau diskspec permintaan pilihan an
petikan luaran dengan destinasi fail sedia ada, maka destinasi mesti
wujud dan pra-dicipta dengan format dan metadata yang betul. Fail itu kemudiannya digunakan semula;
jika tidak, syot kilat ditolak untuk mengelakkan kehilangan kandungan fail sedia ada.

If --diam ditentukan, libvirt akan cuba menggunakan ejen tetamu untuk membekukan dan menyahbeku
sistem fail yang dipasang domain. Walau bagaimanapun, jika domain tidak mempunyai ejen tetamu, gambar
penciptaan akan gagal. Pada masa ini, ini memerlukan --cakera sahaja untuk dilalui juga.

If --tiada-metadata ditentukan, maka data syot kilat dibuat, tetapi sebarang metadata adalah
segera dibuang (iaitu, libvirt tidak menganggap syot kilat sebagai semasa, dan
tidak boleh kembali kepada syot kilat melainkan snapshot-buat kemudiannya digunakan untuk mengajar libvirt
tentang metadata sekali lagi). Bendera ini tidak serasi dengan --print-xml.

If --atom ditentukan, libvirt akan menjamin bahawa syot kilat itu berjaya, atau
gagal tanpa perubahan; tidak semua hypervisor menyokong ini. Jika bendera ini tidak
ditentukan, maka sesetengah hipervisor mungkin gagal selepas melakukan sebahagian tindakan, dan
dumpxml mesti digunakan untuk melihat sama ada sebarang perubahan separa berlaku.

If --hidup ditentukan, libvirt mengambil gambar semasa tetamu sedang berjalan. ini
meningkatkan saiz imej memori pusat pemeriksaan luaran. Ini pada masa ini
disokong hanya untuk pusat pemeriksaan luaran.

syot kilat semasa domain {[--nama] | [--maklumat-keselamatan] | [nama gambar]}
Tanpa nama gambar, ini akan mengeluarkan XML syot kilat untuk semasa domain
syot kilat (jika ada). Jika --nama ditentukan, hanya nama syot kilat semasa dan bukannya
xml penuh. Jika tidak, menggunakan --maklumat-keselamatan juga akan termasuk sensitif keselamatan
maklumat dalam XML.

Dengan nama gambar, ini adalah permintaan untuk menjadikan snapshot bernama sedia ada menjadi
petikan semasa, tanpa membalikkan domain.

gambar-edit domain [nama gambar] [--semasa] {[--menamakan semula] | [--klon]}
Edit fail konfigurasi XML untuk nama gambar daripada domain. Jika kedua-duanya nama gambar
and --semasa ditentukan, juga memaksa syot kilat yang diedit menjadi semasa
syot kilat. Jika nama gambar ditinggalkan, maka --semasa mesti dibekalkan, untuk mengedit
syot kilat semasa.

Ini bersamaan dengan:

virsh snapshot-dumpxml nama dom > snapshot.xml
vi snapshot.xml (atau buat perubahan dengan editor teks anda yang lain)
virsh snapshot-create dom snapshot.xml --redefine [--current]

kecuali ia melakukan beberapa pemeriksaan ralat.

Editor yang digunakan boleh dibekalkan oleh pembolehubah persekitaran $VISUAL atau $EDITOR, dan
lalai kepada "vi".

If --menamakan semula ditentukan, maka suntingan boleh menukar nama syot kilat. Jika --klon is
ditentukan, kemudian menukar nama syot kilat akan mencipta klon syot kilat
metadata. Jika kedua-duanya tidak dinyatakan, maka suntingan tidak boleh menukar nama syot kilat.
Ambil perhatian bahawa menukar nama syot kilat mesti dilakukan dengan berhati-hati, kerana kandungan beberapa
syot kilat, seperti syot kilat dalaman dalam satu fail qcow2, hanya boleh diakses
daripada nama asal.

snapshot-info domain {gambar | --semasa}
Keluarkan maklumat asas tentang bernama, atau syot kilat semasa dengan
--semasa.

senarai gambar domain [--metadata] [--tiada-metadata] [{--ibu bapa | --akar | [{--pokok |
--nama}]}] [{[--dari] gambar | --semasa} [--keturunan]] [--daun] [--tiada-daun]
[--tidak aktif] [--aktif] [--cakera sahaja] [--dalaman] [--luaran]
Senaraikan semua petikan yang tersedia untuk domain yang diberikan, lalai untuk menunjukkan lajur
untuk nama syot kilat, masa penciptaan dan keadaan domain.

If --ibu bapa ditentukan, tambahkan lajur pada jadual output yang memberi nama
ibu bapa setiap syot kilat. Jika --akar ditentukan, senarai akan ditapis kepada hanya
gambar yang tiada ibu bapa. Jika --pokok ditentukan, output akan berada dalam pokok
format, menyenaraikan hanya nama syot kilat. Ketiga-tiga pilihan ini adalah saling eksklusif. Jika
--nama ditentukan hanya nama syot kilat dicetak. Pilihan ini adalah bersama
eksklusif dengan --pokok.

If --dari disediakan, tapis senarai kepada syot kilat yang merupakan anak-anak yang diberikan
gambar; atau jika --semasa disediakan, mulakan pada syot kilat semasa. Apabila digunakan dalam
pengasingan atau dengan --ibu bapa, senarai itu terhad kepada kanak-kanak langsung melainkan
--keturunan turut hadir. Apabila digunakan dengan --pokok, Penggunaan --keturunan is
tersirat. Pilihan ini tidak serasi dengan --akar. Perhatikan bahawa titik permulaan bagi
--dari or --semasa tidak termasuk dalam senarai melainkan --pokok pilihan juga
Sekarang.

If --daun ditentukan, senarai akan ditapis kepada syot kilat sahaja yang tidak mempunyai
kanak-kanak. Begitu juga jika --tiada-daun ditentukan, senarai akan ditapis kepada hanya
gambar bersama kanak-kanak. (Perhatikan bahawa mengecualikan kedua-dua pilihan tidak melakukan penapisan, manakala
menyediakan kedua-dua pilihan sama ada akan menghasilkan senarai yang sama atau ralat bergantung kepada
sama ada pelayan mengenali bendera). Pilihan penapisan tidak serasi dengan
--pokok.

If --metadata ditentukan, senarai akan ditapis kepada syot kilat sahaja yang melibatkan
metadata libvirt, dan dengan itu akan menghalang undefine daripada domain yang berterusan, atau hilang
on memusnahkan daripada domain sementara. Begitu juga jika --tiada-metadata dinyatakan, senarai
akan ditapis kepada hanya syot kilat yang wujud tanpa memerlukan metadata libvirt.

If --tidak aktif ditentukan, senarai akan ditapis kepada syot kilat yang diambil
apabila domain dimatikan. Jika --aktif ditentukan, senarai akan ditapis ke
syot kilat yang diambil semasa domain dijalankan dan tempat syot kilat termasuk
keadaan memori untuk kembali kepada keadaan berjalan itu. Jika --cakera sahaja dinyatakan, iaitu
senarai akan ditapis kepada syot kilat yang diambil semasa domain sedang berjalan, tetapi
di mana syot kilat termasuk keadaan cakera sahaja.

If --dalaman ditentukan, senarai akan ditapis kepada syot kilat yang menggunakan dalaman
penyimpanan imej cakera sedia ada. Jika --luaran ditentukan, senarainya adalah
ditapis kepada syot kilat yang menggunakan fail luaran untuk imej cakera atau keadaan memori.

petikan-dumpxml domain gambar [--maklumat-keselamatan]
Keluarkan XML syot kilat untuk syot kilat domain bernama gambar. Menggunakan
--maklumat-keselamatan juga akan memasukkan maklumat sensitif keselamatan. guna snapshot-
semasa untuk mengakses XML syot kilat semasa dengan mudah.

gambar-induk domain {gambar | --semasa}
Keluarkan nama syot kilat induk, jika ada, untuk yang diberikan gambar, atau untuk
syot kilat semasa dengan --semasa.

syot kilat-kembali domain {gambar | --semasa} [{--berlari | --jeda}] [- kekuatan]
Kembalikan domain yang diberikan kepada syot kilat yang ditentukan oleh gambar, atau kepada arus
syot kilat dengan --semasa. Sedar bahawa ini adalah tindakan yang merosakkan; sebarang perubahan dalam
domain sejak gambar terakhir diambil akan hilang. Juga ambil perhatian bahawa negeri
daripada domain selepas snapshot-revert selesai akan menjadi keadaan domain di
masa syot kilat asal diambil.

Biasanya, berbalik kepada syot kilat meninggalkan domain dalam keadaan seperti pada masa itu
syot kilat dicipta, kecuali syot kilat cakera tanpa keadaan vm meninggalkannya
domain dalam keadaan tidak aktif. Lulus sama ada --berlari or --jeda bendera akan
melakukan perubahan keadaan tambahan (seperti but domain tidak aktif, atau menjeda a
menjalankan domain). Memandangkan domain sementara tidak boleh tidak aktif, ia perlu digunakan
salah satu daripada bendera ini apabila berbalik kepada petikan cakera bagi domain sementara.

Terdapat dua kes di mana pengembalian syot kilat melibatkan risiko tambahan, yang memerlukan
penggunaan - kekuatan untuk meneruskan. Salah satunya ialah kes syot kilat yang tidak mempunyai domain penuh
maklumat untuk memulihkan konfigurasi (seperti syot kilat yang dibuat sebelum libvirt
0.9.5); kerana libvirt tidak dapat membuktikan bahawa konfigurasi semasa sepadan dengan apa yang ada
gunakan pada masa syot kilat, membekalkan - kekuatan memastikan libvirt bahawa gambar itu
adalah serasi dengan konfigurasi semasa (dan jika tidak, domain mungkin akan
gagal berlari). Yang lain ialah kes berbalik daripada domain yang sedang berjalan kepada yang aktif
nyatakan di mana hypervisor baharu perlu dibuat dan bukannya menggunakan semula yang sedia ada
hypervisor, kerana ia menunjukkan kelemahan seperti memecahkan mana-mana VNC atau Spice sedia ada
sambungan; keadaan ini berlaku dengan syot kilat aktif yang menggunakan bukti
konfigurasi tidak serasi, serta dengan syot kilat tidak aktif yang digabungkan dengan
yang --mula or --jeda bendera.

gambar-padam domain {gambar | --semasa} [--metadata] [{--kanak-kanak |
--kanak-kanak sahaja}]
Padamkan petikan untuk domain bernama gambar, atau syot kilat semasa dengan
--semasa. Jika syot kilat ini mempunyai syot kilat kanak-kanak, perubahan daripada syot kilat ini ialah
digabungkan ke dalam kanak-kanak. Jika --kanak-kanak diluluskan, kemudian padamkan syot kilat ini dan mana-mana
kanak-kanak gambar ini. Jika --kanak-kanak sahaja diluluskan, kemudian padamkan mana-mana anak daripada
syot kilat ini, tetapi biarkan syot kilat ini utuh. Kedua-dua bendera ini adalah satu sama lain
eksklusif.

If --metadata ditentukan, kemudian hanya padamkan metadata syot kilat yang diselenggara oleh
libvirt, sambil membiarkan kandungan syot kilat utuh untuk akses oleh alat luaran;
sebaliknya memadamkan syot kilat turut mengalih keluar kandungan data dari masa itu.

NWFILTER PERINTAH

Perintah berikut memanipulasi penapis rangkaian. Penapis rangkaian membenarkan penapisan
trafik rangkaian yang datang dari dan pergi ke mesin maya. Trafik rangkaian individu
penapis ditulis dalam XML dan mungkin mengandungi rujukan kepada penapis rangkaian lain, huraikan
peraturan penapisan lalu lintas, atau mengandungi kedua-duanya. Penapis rangkaian dirujuk oleh maya
mesin dari dalam penerangan antara muka mereka. Penapis rangkaian boleh dirujuk oleh
antara muka berbilang mesin maya.

nwfilter-define xmlfile
Buat penapis rangkaian baharu dikenali libvirt. Jika penapis rangkaian dengan nama yang sama
sudah wujud, ia akan digantikan dengan XML baharu. Sebarang mesin maya yang sedang berjalan
merujuk penapis rangkaian ini akan menyesuaikan peraturan trafik rangkaiannya. Jika untuk
sebarang sebab peraturan penapisan trafik rangkaian tidak boleh digunakan oleh mana-mana
menjalankan mesin maya, maka XML baharu akan ditolak.

nwfilter-undefine nwfilter-name
Padamkan penapis rangkaian. Pemadaman akan gagal jika ada mesin maya yang sedang berjalan
sedang menggunakan penapis rangkaian ini.

nwfilter-list
Senaraikan semua penapis rangkaian yang tersedia.

nwfilter-dumpxml nwfilter-name
Keluarkan XML penapis rangkaian.

nwfilter-edit nwfilter-name
Edit XML penapis rangkaian.

Ini bersamaan dengan:

virsh nwfilter-dumpxml myfilter > myfilter.xml
vi myfilter.xml (atau buat perubahan dengan editor teks anda yang lain)
virsh nwfilter-define myfilter.xml

kecuali ia melakukan beberapa pemeriksaan ralat. Penapis rangkaian baharu mungkin ditolak kerana
atas sebab yang sama seperti yang disebutkan dalam nwfilter-define.

Editor yang digunakan boleh dibekalkan oleh pembolehubah persekitaran $VISUAL atau $EDITOR, dan
lalai kepada "vi".

KHUSUS HIPERVISOR PERINTAH

NOTA: Penggunaan arahan berikut adalah kuat berkecil hati. Mereka boleh menyebabkan libvirt kepada
menjadi keliru dan melakukan perkara yang salah pada operasi seterusnya. Sebaik sahaja anda telah menggunakan ini
arahan, sila jangan laporkan masalah kepada pembangun libvirt; laporan akan menjadi
diabaikan. Jika anda mendapati bahawa arahan ini adalah satu-satunya cara untuk mencapai sesuatu, maka
adalah lebih baik untuk meminta ciri itu ditambahkan sebagai warganegara kelas pertama dalam biasa
perpustakaan libvirt.

qemu-attach pid
Lampirkan proses QEMU yang dilancarkan secara luaran pada pemacu libvirt QEMU. QEMU
proses mesti telah dibuat dengan sambungan monitor menggunakan pemacu UNIX.
Sebaik-baiknya proses itu juga mempunyai hujah '-name' yang ditentukan.

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

Tidak semua fungsi libvirt dijangka berfungsi dengan pasti selepas dilampirkan pada an
proses QEMU yang dilancarkan secara luaran. Mungkin terdapat masalah dengan perubahan ABI tetamu
migrasi dan palam panas peranti atau palam hotun mungkin tidak berfungsi. Persekitaran yang melekat
hendaklah dipertimbangkan terutamanya baca sahaja.

qemu-monitor-command domain { [--hmp] | [--cantik] } arahan...
Hantar arahan monitor sewenang-wenangnya arahan kepada domain domain melalui monitor qemu.
Keputusan arahan akan dicetak pada stdout. Jika --hmp telah diluluskan, perintah itu
dianggap sebagai arahan monitor manusia dan libvirt akan menukarnya secara automatik
ke dalam QMP jika diperlukan. Dalam kes itu, keputusan juga akan ditukar kembali daripada QMP. Jika
--cantik diberikan, dan monitor menggunakan QMP, maka output akan dicetak dengan cantik.
Jika lebih daripada satu hujah diperuntukkan arahan, ia digabungkan dengan ruang
di antara sebelum menghantar satu arahan ke monitor.

qemu-agent-command domain [--masa tamat saat | --async | --sekat] arahan...
Hantar arahan ejen tetamu sewenang-wenangnya arahan kepada domain domain melalui ejen qemu.
--masa tamat, --async and --sekat pilihan adalah eksklusif. --masa tamat memerlukan tamat masa
saat saat dan ia mestilah positif. Bila --aysnc diberikan, perintah menunggu
tamat masa sama ada berjaya atau gagal. Dan bila --sekat diberikan, perintah menunggu
selama-lamanya dengan menyekat tamat masa.

qemu-monitor-event [domain] [--acara nama acara] [--gelung] [--masa tamat saat] [--cantik]
[--regex] [--tiada-kes] [--cap masa]
Tunggu acara pemantauan QEMU sewenang-wenangnya berlaku dan cetak butiran acara
seperti yang berlaku. Acara boleh ditapis secara pilihan oleh domain or nama acara. Yang
Perintah QMP 'query-events' boleh digunakan melalui qemu-monitor-command untuk mengetahui peristiwa apa
disokong. Jika --regex digunakan, nama acara sebaliknya ialah ungkapan biasa asas
daripada rentetan literal. Jika --tiada-kes digunakan, nama acara akan dipadankan secara tidak sensitif huruf.

Secara lalai, arahan ini adalah satu pukulan, dan mengembalikan kejayaan sebaik sahaja peristiwa berlaku; awak
boleh menghantar SIGINT (biasanya melalui "Ctrl-C") untuk berhenti serta-merta. Jika --masa tamat is
ditentukan, arahan berhenti menunggu acara selepas itu saat telah berlalu. Dengan
--gelung, arahan mencetak semua acara sehingga tamat masa atau kunci gangguan. Jika --cantik
ditentukan, sebarang butiran acara JSON dicetak cantik untuk kebolehbacaan yang lebih baik.

Bila --cap masa digunakan, cap waktu yang boleh dibaca manusia akan dicetak sebelum acara,
dan maklumat masa yang diberikan oleh QEMU akan ditinggalkan.

lxc-masuk-ruang nama domain -- /path/to/binary [arg1, [arg2, ...]]
Masukkan ruang nama bagi domain dan laksanakan arahan "/path/to/binary" yang melepasi
diminta args. Laluan binari adalah relatif kepada sistem fail akar kontena, bukan
sistem fail akar hos. Binari akan mewarisi pembolehubah persekitaran / konsol
kelihatan kepada virsh. Perintah ini hanya berfungsi apabila disambungkan kepada pemacu hipervisor LXC.
Perintah ini berjaya hanya jika "/path/to/binary" mempunyai 0 status keluar.

PERSEKITARAN

Pembolehubah persekitaran berikut boleh ditetapkan untuk mengubah tingkah laku "virsh"

VIRSH_DEBUG=
Hidupkan penyahpepijatan verbose perintah virsh. Tahap yang sah adalah

· VIRSH_DEBUG=0

DEBUG - Mesej di SEMUA peringkat dilog

· VIRSH_DEBUG=1

INFO - Log mesej pada tahap INFO, NOTIS, AMARAN dan RALAT

· VIRSH_DEBUG=2

NOTIS - Log mesej pada tahap NOTIS, AMARAN dan RALAT

· VIRSH_DEBUG=3

AMARAN - Log mesej pada tahap AMARAN dan RALAT

· VIRSH_DEBUG=4

ERROR - Mesej pada tahap ERROR sahaja akan dilog.

VIRSH_LOG_FILE="LOGFILE"
Fail untuk log mesej nyahpepijat virsh.

VIRSH_DEFAULT_CONNECT_URI
Hipervisor untuk disambungkan secara lalai. Tetapkan ini kepada URI, dalam format yang sama seperti
diterima oleh menyambung pilihan. Pembolehubah persekitaran ini ditamatkan untuk memihak kepada
global LIBVIRT_DEFAULT_URI pembolehubah yang mempunyai tujuan yang sama.

LIBVIRT_DEFAULT_URI
Hipervisor untuk disambungkan secara lalai. Tetapkan ini kepada URI, dalam format yang sama seperti
diterima oleh menyambung pilihan. Ini mengatasi URI lalai yang ditetapkan dalam mana-mana pelanggan
config dan menghalang libvirt daripada menyelidik pemandu.

VISUAL
Editor untuk digunakan oleh mengedit dan pilihan yang berkaitan.

EDITOR
Editor untuk digunakan oleh mengedit dan pilihan yang berkaitan, jika "VISUAL" tidak ditetapkan.

VIRSH_HISTSIZE
Bilangan arahan yang perlu diingat dalam sejarah arahan. Nilai lalai ialah 500.

LIBVIRT_DEBUG=TINGKAT
Hidupkan penyahpepijatan verbose semua panggilan API libvirt. Tahap yang sah adalah

· LIBVIRT_DEBUG=1

Mesej pada tahap DEBUG atau lebih tinggi

· LIBVIRT_DEBUG=2

Mesej pada tahap INFO atau lebih tinggi

· LIBVIRT_DEBUG=3

Mesej pada tahap AMARAN atau lebih tinggi

· LIBVIRT_DEBUG=4

Mesej pada tahap ERROR atau lebih tinggi

Untuk maklumat lanjut tentang pilihan penyahpepijatan rujuk
"http://libvirt.org/logging.html"

Gunakan virsh dalam talian menggunakan perkhidmatan onworks.net