virt-inspector(1) Virtualization Support virt-inspector(1) (NAME) virt-inspector - (SYNOPSIS) virt-inspector [--options] -d domname virt-inspector [--options] -a disk.img [-a disk.img ...] : virt-inspector domname virt-inspector disk.img [disk.img ...] (DESCRIPTION) virt-inspector . Virt-inspector XML . "virt-inspector -d domname" "domname" libvirt (: "virsh list --all"). virt-inspector . "virt-inspector -a disk.img" . -a /dev/sda /dev/sdb . virt-inspector (Live CD) USB . Virt-inspector . virt-inspector ( for ). virt-inspector libvirt . virt-inspector API libguestfs ( "INSPECTION" guestfs(3) ). guestfish libguestfs ( " API LIBGUESTFS" ). virt-drivers(1) . (OPTIONS) --help . -a file --add file file . -a . . --format=.. . -a URI --add URI . "ADDING REMOTE STORAGE" guestfish(1) . --blocksize=512 --blocksize=4096 --blocksize . . --blocksize . "guestfs_add_drive_opts" guestfs(3) . -c URI --connect URI libvirt URI . libvirt . libvirt "domname" . (-a) libvirt . -d guest --domain guest libvirt . UUID . --echo-keys virt-inspector (echo) . (Tempest) . --format=raw|qcow2|.. --format . . libvirt libvirt . format . (raw) . --key SELECTOR LUKS LUKS . --key NAME:key:KEY_STRING --key UUID:key:KEY_STRING --key all:key:KEY_STRING "NAME" libguestfs ( "/dev/sda1"). "UUID" . "all" . "KEY_STRING" . --key NAME:file:FILENAME --key UUID:file:FILENAME --key all:file:FILENAME FILENAME. --key NAME:clevis --key UUID:clevis --key all:clevis Clevis . (NBDE) "ENCRYPTED DISKS" guestfs(3) . QEMU libguestfs . --keys-from-stdin (stdin). /dev/tty . stdin . --no-applications virt-inspector ( ) . XML . --no-icon virt-inspector () ( "icon" ). XML . -v --verbose . -V --version . -x API libguestfs. --xpath query XPath XML stdin (stdout). virt-inspector XPath . " XPATH" . (OLD-STYLE COMMAND LINE ARGUMENTS) virt-inspector : virt-inspector disk.img [disk.img ...] virt-inspector guestname -a -d . . XML (XML FORMAT) XML virt-inspector RELAX NG virt-inspector.rng libguestfs . . . (Multi-boot) . " " : /dev/sda2 windows i386 windows Windows 7 Enterprise Client 6 1 /Windows ( "linux" "windows") ( "fedora" ) . API libguestfs "INSPECTION" guestfs(3) . libguestfs ( ). (Un*x-like) (Mountpoint) : ... / /boot libguestfs . Swap. Swap . ( ). : ... ext4 e6a4db1e-15c2-477b-ac2a-699181c396aa : (Label) (UUID). . . "rpm" "deb" . . "yum" "up2date" "apt" . . ... coreutils 8.5 1 version release . "guestfs_inspect_list_applications" guestfs(3) . virt-inspector . ... /dev/sda2 /dev/sdb1 C E . . NTFS . Virt-inspector . PNG Base64 . . ... iVBORw0KGgoAAAANSUhEUgAAAGAAAABg[.......] [... many lines of base64 data ...] Base64 . XPath base64(1) coreutils PNG : base64 -i -d < icon.data > icon.png XPATH (XPATH QUERIES) Virt-inspector XPath . XPath virt-inspector XPath . xmlstarlet(1) . XPath --xpath . virt-inspector XML stdin stdout . . : $ virt-inspector -d Guest | virt-inspector --xpath '//filesystems' ext4 [...] $ virt-inspector -d Guest | \ virt-inspector --xpath "string(//filesystem[@dev='/dev/sda1']/type)" ext4 $ virt-inspector -d Guest | \ virt-inspector --xpath 'string(//icon)' | base64 -i -d | display - [ ] API LIBGUESTFS (GETTING INSPECTION DATA FROM THE LIBGUESTFS API) libguestfs virt-inspector Perl ( ) . : ( guestfish) Perl libguestfs . libguestfs 1.8 Perl C API libguestfs (guestfs(3)). virt-inspector C API C . libguestfs guestfish . C inspection API "INSPECTION" guestfs(3) . C inspection API inspect-vm.c libguestfs . inspect-vm.c . inspect_vm.pl OCaml Python . "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES" guestfs(3) . GUESTFISH (GETTING INSPECTION DATA FROM GUESTFISH) -i guestfish API C "guestfs_inspect_os" guestfs(3) . "inspect-os" guestfish . guestfish . "inspect-os" . . ( ) CD . $ guestfish --ro -a F15x32.img > run > inspect-os /dev/vg_f15x32/lv_root : > 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 Fedora release 15 (Lovelock) guestfish ( guestfish ) API libguestfs . (mount) : > 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 API inspect-list-applications : > inspect-list-applications /dev/vg_f15x32/lv_root | head -28 [0] = { app_name: ConsoleKit app_display_name: app_epoch: 0 app_version: 0.4.5 app_release: 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 app_version: 0.4.5 app_release: 1.fc15 app_install_path: app_trans_path: app_publisher: app_url: app_source_package: app_summary: app_description: } . : > inspect-get-icon /dev/vg_f15x32/lv_root | display - VIRT-INSPECTOR (OLD VERSIONS OF VIRT-INSPECTOR) libguestfs virt-inspector Perl ( C ). XML . virt-inspector libguestfs . virt-inspector : virt-inspector Perl. virt-inspector2 C. (EXIT STATUS) 0 . (SEE ALSO) guestfs(3), guestfish(1), http://www.w3.org/TR/xpath, base64(1), xmlstarlet(1), virt-drivers(1), http://libguestfs.org. (AUTHORS) o Richard W.M. Jones http://people.redhat.com/~rjones o Matthew Booth mbooth@redhat.com (COPYRIGHT) Copyright (C) 2010-2025 Red Hat Inc. (LICENSE) (GNU GPL) ( ) . . . : Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. (BUGS) libguestfs : https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools libguestfs : https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools : o libguestfs. o libguestfs ( ). o . o libguestfs-test-tool(1) . guestfs-tools-1.56.0 2026-07-11 virt-inspector(1)