virt-inspector - Dalam talian di Awan

JADUAL:

NAMA

virt-inspector - Paparkan versi sistem pengendalian dan maklumat lain tentang maya
mesin

SINOPSIS

virt-inspector [--options] -d domname

virt-inspector [--options] -a disk.img [-a disk.img ...]

Gaya lama:

nama dom pemeriksa virt

virt-inspector disk.img [disk.img ...]

DESCRIPTION

vir-inspektor memeriksa mesin maya atau imej cakera dan cuba menentukan versinya
sistem pengendalian dan maklumat lain tentang mesin maya.

Virt-inspector menghasilkan output XML untuk menyuap ke dalam program lain.

Dalam penggunaan biasa, gunakan "virt-inspector -d domname" dengan "domname" ialah domain libvirt
(lihat: "senarai virsh --semua").

Anda juga boleh menjalankan virt-inspector terus pada imej cakera daripada mesin maya tunggal.
Gunakan "virt-inspector -a disk.img". Dalam kes yang jarang berlaku, domain mempunyai beberapa peranti blok, dalam
yang mana anda harus menyenaraikan beberapa -a pilihan satu demi satu, dengan yang pertama
sepadan dengan tetamu / Dev / literasi, yang kedua kepada tetamu / dev / sdb dan sebagainya.

Anda juga boleh menjalankan virt-inspector pada cakera pemasangan, CD langsung, kekunci USB boleh but dan seumpamanya.

Virt-inspector hanya boleh memeriksa dan melaporkannya 1 domain at a masa. Untuk memeriksa beberapa
mesin maya, anda perlu menjalankan virt-inspector beberapa kali (contohnya, dari shell
skrip untuk gelung).

Oleh kerana virt-inspector memerlukan akses terus kepada imej tetamu, ia biasanya tidak akan berfungsi
sambungan libvirt jauh.

Semua maklumat yang tersedia daripada virt-inspector juga tersedia melalui teras
libguestfs inspection API (lihat "INSPECTION" dalam guestfs(3)). Maklumat yang sama juga boleh
diambil menggunakan guestfish atau melalui binding libguestfs dalam banyak bahasa pengaturcaraan (lihat
"MENDAPATKAN DATA PEMERIKSAAN DARIPADA API LIBGUESTFS").

PILIHAN

- membantu
Paparkan bantuan ringkas.

-a fail
--Tambah fail
Tambah fail yang sepatutnya imej cakera daripada mesin maya. Jika mesin maya
mempunyai berbilang peranti blok, anda mesti membekalkan kesemuanya dengan peranti berasingan -a pilihan.

Format imej cakera dikesan secara automatik. Untuk mengatasi ini dan memaksa a
format tertentu gunakan --format=.. pilihan.

-a URI
--Tambah URI
Tambah cakera jauh. Lihat "MENAMBAH STORAN JAUH" dalam ikan tetamu(1).

-c URI
--sambung URI
Jika menggunakan libvirt, sambung ke yang diberikan URI. Jika ditinggalkan, maka kami menyambung ke
hipervisor libvirt lalai.

Libvirt hanya digunakan jika anda menentukan "nama dom" pada baris arahan. Jika anda nyatakan
peranti blok tetamu secara langsung (-a), maka libvirt tidak digunakan sama sekali.

-d tetamu
--domain tetamu
Tambahkan semua cakera daripada tetamu libvirt bernama. UUID Domain boleh digunakan sebagai ganti
nama.

--kunci-gema
Apabila menggesa untuk kunci dan frasa laluan, virt-inspector biasanya mematikan bergema sedemikian
anda tidak dapat melihat apa yang anda taip. Jika anda tidak bimbang tentang serangan Tempest dan
tiada orang lain di dalam bilik yang anda boleh tentukan bendera ini untuk melihat apa yang anda taip.

--format=raw|qcow2|..
--format
Nyatakan format imej cakera yang diberikan pada baris arahan. Jika ini ditinggalkan maka
format dikesan secara automatik daripada kandungan imej cakera.

Jika imej cakera diminta daripada libvirt, maka program ini meminta libvirt untuk ini
maklumat. Dalam kes ini, nilai parameter format diabaikan.

Jika bekerja dengan imej cakera tetamu format mentah yang tidak dipercayai, anda harus memastikan formatnya
sentiasa dinyatakan.

--kunci-dari-stdin
Baca parameter kunci atau frasa laluan daripada stdin. Lalainya ialah cuba membaca
frasa laluan daripada pengguna dengan membuka /dev/tty.

-v
--verbose
Dayakan mesej verbose untuk nyahpepijat.

-V
--versi
Paparkan nombor versi dan keluar.

-x Dayakan pengesanan panggilan API libguestfs.

--xpath pertanyaan
Lakukan pertanyaan XPath pada XML pada stdin dan cetak hasilnya pada stdout. Di dalam ini
mod virt-inspector hanya menjalankan pertanyaan XPath; semua fungsi pemeriksaan lain adalah
kurang upaya. Lihat "XPATH QUERIES" di bawah untuk beberapa contoh.

GAYA LAMA COMMAND LINE HUJAH

Versi sebelumnya virt-inspector membenarkan anda menulis sama ada:

virt-inspector disk.img [disk.img ...]

or

nama tetamu virt-inspector

sedangkan dalam versi ini anda harus menggunakan -a or -d masing-masing untuk mengelakkan kes mengelirukan
di mana imej cakera mungkin mempunyai nama yang sama dengan tetamu.

Untuk keserasian gaya lama masih disokong.

XML FORMAT

XML virt-inspector diterangkan dengan tepat dalam fail skema RELAX NG virt-inspector.rng
yang dibekalkan dengan libguestfs. Bahagian ini hanyalah gambaran keseluruhan.

Elemen peringkat atas ialah , dan ia mengandungi satu atau lebih
elemen. Anda hanya akan melihat lebih daripada satu elemen jika maya
mesin adalah berbilang but, yang semakin jarang ditemui dalam VM dunia sebenar.


Di dalam tag ialah pelbagai medan pilihan yang menerangkan operasi
sistem, seni binanya, rentetan deskriptif "nama produk", jenis OS dan sebagainya,
seperti dalam contoh ini:



/dev/sda2/ Akar>
tingkap
i386
tingkap
Windows 7 Enterprise
Pelanggan
6
1
/Windows
dipasang

Secara ringkas, ialah kelas sistem pengendalian (sesuatu seperti "linux" atau "windows"),
ialah pengedaran (cth. "fedora" tetapi banyak distro lain diiktiraf) dan
ialah seni bina tetamu. Bidang lain agak jelas, tetapi
kerana medan ini diambil terus daripada API pemeriksaan libguestfs yang anda boleh temui
maklumat tepat daripada "INSPECTION" dalam guestfs(3).

The elemen ialah peranti sistem fail akar, tetapi dari sudut pandangan libguestfs
(peranti blok mungkin mempunyai nama yang sama sekali berbeza di dalam VM itu sendiri).


Tetamu yang tidak*x seperti biasanya mempunyai berbilang sistem fail yang dipasang pada pelbagai
titik lekap, dan ini diterangkan dalam elemen yang kelihatan seperti ini:



...

/
/ boot


Seperti dengan , peranti adalah dari sudut pandangan libguestfs, dan mungkin mempunyai sepenuhnya
nama yang berbeza di dalam tetamu. Hanya sistem fail yang boleh dipasang muncul dalam senarai ini, bukan
perkara seperti menukar peranti.


adalah seperti tetapi meliputi semua sistem fail kepunyaan tetamu,
termasuk swap dan partition kosong. (Dalam kes jarang tetamu berbilang but, ia meliputi
sistem fail kepunyaan OS ini atau dikongsi dengan OS ini dan OS lain).

Anda mungkin melihat sesuatu seperti ini:



...


samb4
Fedora-13-x86_64
<uuid>e6a4db1e-15c2-477b-ac2a-699181c396aa</uuid>


Elemen pilihan dalam ialah jenis sistem fail, label dan
UUID.


Elemen yang berkaitan , dan huraikan
aplikasi yang dipasang dalam mesin maya.

, jika ada, menerangkan sistem pembungkusan yang digunakan. Nilai biasa akan
menjadi "rpm" dan "deb".

, jika ada, menerangkan pengurus pakej. Nilai biasa termasuk
"yum", "up2date" dan "apt"

menyenaraikan pakej atau aplikasi yang dipasang.



...


coreutils
8.5
1


Medan versi dan keluaran mungkin tidak tersedia untuk sesetengah jenis tetamu. Bidang lain
adalah mungkin, lihat "guestfs_inspect_list_applications" dalam guestfs(3).


Untuk sistem pengendalian seperti Windows yang menggunakan huruf pemacu, virt-inspector dapat mencari
mengetahui cara huruf pemacu memetakan ke sistem fail.



...

/dev/sda2
/dev/sdb1


Dalam contoh di atas, memandu peta C ke sistem fail pada partition kedua pada yang pertama
cakera, dan pemacu E memetakan ke sistem fail pada partition pertama pada cakera kedua.

Ambil perhatian bahawa ini hanya meliputi pemetaan sistem fail tempatan kekal, bukan perkara seperti rangkaian
saham. Tambahan pula, titik lekap volum NTFS mungkin tidak disenaraikan di sini.


Virt-inspector kadangkala dapat mengekstrak ikon atau logo untuk tetamu. Ikonnya ialah
dikembalikan sebagai data PNG berkod base64. Ambil perhatian bahawa ikon boleh menjadi sangat besar dan tinggi
berkualiti.



...

iVBORw0KGgoAAAANSUhEUgAAGAAAABg[.......]
[... banyak baris data base64 ...]


Untuk memaparkan ikon, anda perlu mengekstraknya dan menukar data base64 kembali kepada binari
fail. Gunakan pertanyaan XPath atau hanya editor untuk mengekstrak data, kemudian gunakan coreutils
base64(1) program untuk melakukan penukaran kembali kepada fail PNG:

base64 -i -d < icon.data > icon.png

MEMERIKSA MEMASANG CAKERA, LIVE CD
Virt-inspector boleh mengesan beberapa pemasang sistem pengendalian pada cakera pemasangan, CD langsung,
kekunci USB boleh boot dan banyak lagi.

Dalam kes ini tag akan mengandungi "pemasang" dan medan lain mungkin ada
menunjukkan CD langsung, pemasang rangkaian atau satu bahagian CD berbilang bahagian. Sebagai contoh:



/dev/sda/ Akar>
linux
i386
ubuntu
Ubuntu 10.10 "Maverick Meerkat"
10
10
pemasang

XPATH PERTANYAAN

Virt-inspector termasuk sokongan terbina dalam untuk menjalankan pertanyaan XPath. Alasan untuk
termasuk sokongan XPath secara langsung dalam virt-inspektor adalah semata-mata bahawa tidak ada yang baik dan
program baris arahan yang tersedia secara meluas yang boleh melakukan pertanyaan XPath. Satu-satunya yang baik ialah
xmlstarlet(1) dan itu tidak tersedia pada Red Hat Enterprise Linux.

Untuk melaksanakan pertanyaan XPath, gunakan --xpath pilihan. Ambil perhatian bahawa dalam mod ini, vir-inspector
hanya membaca XML dari stdin dan mengeluarkan hasil pertanyaan pada stdout. Semua pemeriksaan lain
ciri dilumpuhkan dalam mod ini.

Sebagai contoh:

$ virt-inspector -d Tetamu | virt-inspector --xpath '//filesystems'


samb4
[...]

$ virt-inspector -d Tetamu | \
virt-inspector --xpath "string(//filesystem[@dev='/dev/sda1']/type)"
ext4

$ virt-inspector -d Tetamu | \
virt-inspector --xpath 'string(//icon)' | asas64 -i -d | paparan -
[memaparkan ikon tetamu, jika ada]

MENDAPAT PEMERIKSAAN DATA DARIPADA THE LIBGUESTFS API

Dalam versi awal libguestfs, virt-inspector ialah skrip Perl besar yang mengandungi
banyak heuristik untuk memeriksa tetamu. Ini mempunyai beberapa masalah: untuk melakukannya
pemeriksaan daripada alatan lain (seperti guestfish) kami terpaksa memanggil skrip Perl ini; dan
ia memberi keistimewaan Perl berbanding bahasa lain yang disokong oleh libguestfs.

Oleh libguestfs 1.8 kami telah menulis semula kod Perl dalam C, dan memasukkan semuanya ke dalam
teras libguestfs API (guestfs(3)). Sekarang virt-inspector hanyalah program C yang nipis di atas
teras C API. Semua maklumat pemeriksaan tersedia daripada semua bahasa pengaturcaraan
yang libguestfs menyokong, dan dari guestfish.

Untuk penerangan tentang API pemeriksaan C, baca "INSPECTION" dalam guestfs(3).

Sebagai contoh kod menggunakan API pemeriksaan C, cari inspect-vm.c yang kapal dengan
libguestfs.

inspect-vm.c juga telah diterjemahkan ke dalam bahasa lain. Sebagai contoh, inspect_vm.pl is
terjemahan Perl, dan terdapat terjemahan lain untuk OCaml, Python, dll. Lihat "MENGGUNAKAN
LIBGUESTFS DENGAN BAHASA PENGATURCARAAN LAIN" dalam guestfs(3) untuk senarai halaman manual yang
mengandungi kod contoh ini.

MENDAPAT PEMERIKSAAN DATA DARIPADA IKAN TETAMU
Jika anda menggunakan ikan tamu -i pilihan, kemudian API pemeriksaan C utama "guestfs_inspect_os" masuk
guestfs(3) dipanggil. Ini bersamaan dengan perintah guestfish "inspect-os". Awak boleh
panggil juga arahan guestfish ini dengan tangan.

"inspect-os" melakukan pemeriksaan pada imej cakera semasa, mengembalikan senarai
sistem pengendalian ditemui. Setiap OS diwakili oleh peranti sistem fail akarnya. Di dalam
kebanyakan kes, arahan ini tidak mencetak apa-apa (tiada OS ditemui), atau peranti akar tunggal,
tetapi berhati-hati bahawa ia boleh mencetak berbilang baris jika terdapat berbilang OS atau jika ada
pasang CD yang dilampirkan pada tetamu.

$ guestfish --ro -a F15x32.img
> lari
> inspect-os
/dev/vg_f15x32/lv_root

Menggunakan peranti akar, anda boleh mendapatkan maklumat lanjut tentang tetamu:

> inspect-get-type /dev/vg_f15x32/lv_root
linux
> inspect-get-distro /dev/vg_f15x32/lv_root
fedora
> inspect-get-major-version /dev/vg_f15x32/lv_root
15
> inspect-get-product-name /dev/vg_f15x32/lv_root
Keluaran Fedora 15 (Lovelock)

Pengehadan guestfish menyukarkan untuk menetapkan peranti akar kepada pembolehubah (sejak
guestfish tidak mempunyai pembolehubah), jadi jika anda ingin melakukan ini secara berulang, anda lebih baik
berhenti menulis skrip menggunakan salah satu bahasa lain yang disokong oleh API libguestfs.

Untuk menyenaraikan aplikasi, anda perlu memasang cakera terlebih dahulu:

> inspect-get-mountpoints /dev/vg_f15x32/lv_root
/: /dev/vg_f15x32/lv_root
/ boot: /dev/vda1
> mount-ro /dev/vg_f15x32/lv_root /
> mount-ro /dev/vda1 / boot

dan kemudian panggil inspect-list-applications API:

> inspect-list-applications /dev/vg_f15x32/lv_root | kepala -28
[0] = {
app_name: ConsoleKit
app_display_name:
app_epoch: 0
versi_aplikasi: 0.4.5
keluaran_aplikasi: 1.fc15
app_install_path:
app_trans_path:
app_publisher:
app_url:
app_source_package:
app_summary:
app_description:
}
[1] = {
app_name: ConsoleKit-libs
app_display_name:
app_epoch: 0
versi_aplikasi: 0.4.5
keluaran_aplikasi: 1.fc15
app_install_path:
app_trans_path:
app_publisher:
app_url:
app_source_package:
app_summary:
app_description:
}

Untuk memaparkan ikon untuk tetamu, ambil perhatian bahawa sistem fail juga mesti dipasang seperti di atas.
Anda kemudian boleh melakukan:

> inspect-get-icon /dev/vg_f15x32/lv_root | paparan -

TUA VERSIONS OF PEMERIKSA DARA

Seperti yang diterangkan di atas, versi awal libguestfs dihantar dengan virt-inspector yang berbeza
atur cara yang ditulis dalam Perl (versi semasa ditulis dalam C). Output XML Perl
virt-inspector adalah berbeza dan ia juga boleh mengeluarkan dalam format lain seperti teks.

Virt-inspector lama tidak lagi disokong atau dihantar dengan libguestfs.

Untuk mengelirukan lagi, dalam Red Hat Enterprise Linux 6 kami menghantar dua versi virt-
pemeriksa dengan nama yang berbeza:

virt-inspector versi Perl Lama.
virt-inspector2 Versi C baharu.

EXIT STATUS

Program ini mengembalikan 0 jika berjaya, atau bukan sifar jika terdapat ralat.

Gunakan virt-inspector dalam talian menggunakan perkhidmatan onworks.net