Jump to content

libguestfs

From Wikipedia, the free encyclopedia

This is an old revision of this page, as edited by Sdkb (talk | contribs) at 18:27, 21 September 2023 (Correcting section link formatting, general fixes). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.

libguestfs
Developer(s)Richard Jones
Initial releaseApril 4, 2009; 15 years ago (2009-04-04)[1]
Stable release
1.40 / February 8, 2019; 5 years ago (2019-02-08)[2]
Written inC; utilities in OCaml Perl, et al.
Operating systemLinux
TypeVirtualization
LicenseLGPL, GPL
Websitelibguestfs.org

libguestfs is a C library and a set of tools for accessing and modifying virtual disk images used in platform virtualization. The tools can be used for viewing and editing virtual machines (VMs) managed by libvirt and files inside VMs, scripting changes to VMs, creating VMs, and much else besides.[3] It was created because of security issues, when virtual disk images are mounted directly on the host system.[4]

libguestfs can access nearly any type of file system including: all known types of Linux filesystem (ext2/3/4, XFS, btrfs, etc.), any Windows filesystem (VFAT and NTFS), any Mac OS X and BSD filesystems, LVM2 volume management, MBR and GPT disk partitions, raw disks, qcow2, VirtualBox VDI, VMWare VMDK, Hyper-V VHD/VHDX, on files, local devices, CD and DVD ISOs, SD cards, or remotely over FTP, HTTP, SSH, iSCSI, NBD, GlusterFS, Ceph, Sheepdog, and much more. libguestfs does not require root permissions.

The functionality is available through a shell called guestfish. There is a rescue shell called virt-rescue for fixing unbootable virtual machines. Multiple tools are available modeled after ordinary Unix commands, such as virt-cat and virt-tar.[5]

libguestfs is also an API that can be linked with C and C++ management programs and has bindings for Perl, Python, Ruby, Java, OCaml, PHP, Haskell, Erlang, Lua, Golang and C#. It can be used from shell scripts or in the command line. Using the FUSE module guest filesystems can be mounted on the host with the guestmount command.[6]

libguestfs is implemented using the Kernel-based Virtual Machine for the Linux kernel.[7]

See also

References

  1. ^ "Historical releases of libguestfs".
  2. ^ "libguestfs 1.40 stable".
  3. ^ "Description from home page".
  4. ^ "A reminder why you should never mount guest disk images on the host OS".
  5. ^ "Features in Fedora 12".
  6. ^ "Description from home page".
  7. ^ "Internal description of libguestfs".