mirror of
https://github.com/libguestfs/libguestfs.git
synced 2026-03-22 07:03:38 +00:00
83474887ed
Seeing `g.add_drive_opt :readonly => 1` allows one to imply that ensuring writable access to drive should happen via `g.add_drive_opt :readonly => 0`. However, the passed option value gets passed down to C according to Ruby Boolean semantics, that is, any value apart from `false` and `nil` will be true (see RTEST in Ruby C API). So its more idiomatic and provides a better hint if we use `g.add_drive_opt :readonly => true` in Ruby samples.
64 lines
1.6 KiB
Ruby
64 lines
1.6 KiB
Ruby
# Example showing how to inspect a virtual machine disk.
|
|
|
|
require 'guestfs'
|
|
|
|
if ARGV.length == 0
|
|
puts "usage: inspect_vm disk.img"
|
|
exit 1
|
|
end
|
|
disk = ARGV[0]
|
|
|
|
g = Guestfs::Guestfs.new()
|
|
|
|
# Attach the disk image read-only to libguestfs.
|
|
g.add_drive_opts(disk, :readonly => true)
|
|
|
|
# Run the libguestfs back-end.
|
|
g.launch()
|
|
|
|
# Ask libguestfs to inspect for operating systems.
|
|
roots = g.inspect_os()
|
|
if roots.length == 0
|
|
puts "inspect_vm: no operating systems found"
|
|
exit 1
|
|
end
|
|
|
|
for root in roots do
|
|
printf("Root device: %s\n", root)
|
|
|
|
# Print basic information about the operating system.
|
|
printf(" Product name: %s\n", g.inspect_get_product_name(root))
|
|
printf(" Version: %d.%d\n",
|
|
g.inspect_get_major_version(root),
|
|
g.inspect_get_minor_version(root))
|
|
printf(" Type: %s\n", g.inspect_get_type(root))
|
|
printf(" Distro: %s\n", g.inspect_get_distro(root))
|
|
|
|
# Mount up the disks, like guestfish -i.
|
|
#
|
|
# Sort keys by length, shortest first, so that we end up
|
|
# mounting the filesystems in the correct order.
|
|
mps = g.inspect_get_mountpoints(root)
|
|
mps = mps.sort {|a,b| a[0].length <=> b[0].length}
|
|
for mp in mps do
|
|
begin
|
|
g.mount_ro(mp[1], mp[0])
|
|
rescue Guestfs::Error => msg
|
|
printf("%s (ignored)\n", msg)
|
|
end
|
|
end
|
|
|
|
# If /etc/issue.net file exists, print up to 3 lines.
|
|
filename = "/etc/issue.net"
|
|
if g.is_file filename then
|
|
printf("--- %s ---\n", filename)
|
|
lines = g.head_n(3, filename)
|
|
for line in lines do
|
|
puts line
|
|
end
|
|
end
|
|
|
|
# Unmount everything.
|
|
g.umount_all()
|
|
end
|