guestfs-building(1) Virtualization Support guestfs-building(1) (NAME) guestfs-building - libguestfs (DESCRIPTION) libguestfs . : o . o (). o . o . (REQUIREMENTS) Fedora Red Hat Enterprise Linux (RHEL) dnf(8) : dnf builddep libguestfs dnf install autoconf automake libtool gettext-devel yum(8) : yum-builddep libguestfs yum install autoconf automake libtool gettext-devel (Debian or Ubuntu) APT : apt-get build-dep libguestfs apt-get install autoconf automake libtool-bin gettext http://packages.debian.org/source/libguestfs "build-depends" "build-depends-indep" . (Full list of requirements) appliance/packagelist.in . ( ). : libguestfs "make clean" . supermin : make -C appliance clean-supermin-appliance qemu >= 7.2.0 . qemu-img >= 7.2.0 . kernel >= 2.6.34 . : "virtio-pci", "virtio-serial", "virtio-block", "virtio-net". supermin >= 5.1.18 . " " . XDR (tirpc, glibc or other) . XDR "" glibc tirpc . "rpcgen" / API libguestfs . Gcc or Clang . "__attribute__((cleanup))" GCC Clang . Perl . . virt . Perl "Pod::Man" Perl "Pod::Simple" . Perl. OCaml >= 4.08 OCaml findlib . autoconf automake gettext . . cpio . gperf . realpath . PCRE2 ( ) . xorriso, genisoimage or mkisofs . libxml2 . ncurses . augeas >= 1.2.0 . ocaml-augeas . OCaml Augeas : http://people.redhat.com/~rjones/augeas xz . zstd . json-c >= 0.14 . po4a . . hivex >= 1.2.7 ocaml-hivex . ocaml-hivex OCaml hivex . libvirt >= 11.10.0 . libvirt . xmllint . . libconfig . libguestfs /etc/libguestfs-tools.conf. libselinux . libvirt (sVirt) . readline . guestfish(1). acl . ACL POSIX. libcap . (capabilities) . libldm . ldmtool(1) (Windows Dynamic Disks). sd-journal . systemd. gdisk . GPT. netpbm . . icoutils . . librpm . RPM. Perl "Expect" . virt-rescue(1) . FUSE . guestmount(1) / mount-local fusermount(1) libfuse . static glibc . . qemu-nbd . qemu-nbd . Perl "Module::Build" >= 0.19 Perl "Test::More" . Perl . Python >= 3.6 . . libguestfs 1.42.1 . Python "unittest" . . Ruby rake rubygem-minitest rubygem-rdoc . Ruby . Java >= 1.6 . Java JNI jpackage-utils . GHC . . PHP phpize . PHP . LUA . LUA . Erlang >= 23 ei . Erlang . Erlang <= 22 libguestfs <= 1.42 . golang >= 1.1.1 . Go . valgrind . . libvirt-python . libvirt libguestfs. Perl "libintl" . bash-completion . bash. libtsk . (forensics) . yara >= 4.0.0 . . (BUILDING FROM GIT) "autoconf" "automake" "gettext" OCaml findlib po4a . git clone https://github.com/libguestfs/libguestfs cd libguestfs git submodule update --init autoreconf -i ./configure make (BUILDING FROM TARBALLS) () http://download.libguestfs.org . GnuPG "rich@annexia.org" : https://pgp.mit.edu/pks/lookup?op=vindex&search=0x91738F73E1B768A0 : "F777 4FB1 AD07 4A7E 8C87 67EA 9173 8F73 E1B7 68A0". : cd libguestfs-1.xx.yy ./configure make (RUNNING THE TESTS) root ! Libguestfs . . : make quickcheck : make check . guestfs-hacking(1) . (INSTALLING) "make install" ! libguestfs . ./run . : make INSTALLDIRS=vendor DESTDIR=[temp-build-dir] install ./run (THE ./run SCRIPT) ./run guestfish(1) guestmount(1) virt . . : ./run guestfish [usual guestfish args ...] ./run virt-inspector [usual virt-inspector args ...] ./run libguestfs $PATH guestfish virt-inspector ( guestfish ). . libguestfs : /path/to/libguestfs/run ./my_program [...] C valgrind : ./run valgrind [valgrind opts...] virt-cat [virt-cat opts...] gdb: ./run gdb --args virt-cat [virt-cat opts...] sudo ( libvirt ): sudo ./run virt-cat -d LinuxGuest /etc/passwd : LIBGUESTFS_HV=/my/qemu ./run guestfish : ./run env LIBGUESTFS_HV=/my/qemu guestfish local* (local* FILES) local* git . libguestfs . localconfigure configure . : . localenv ./configure.sh \ -C \ --enable-werror \ "$@" libguestfs : ./localconfigure && make localenv "make" (source) . : # Skip this test, it is broken. export SKIP_TEST_BTRFS_FSCK=1 localenv Makefile ( Makefile ). localconfigure source . ./configure (SELECTED ./configure SETTINGS) "./configure" . : ./configure --help . --disable-appliance --disable-daemon " " . --disable-erlang --disable-golang --disable-haskell --disable-lua --disable-ocaml --disable-perl --disable-php --disable-python --disable-ruby "./configure" . OCaml () Perl . OCaml libguestfs . --disable-ocaml . --disable-fuse FUSE API guestmount(1). --disable-static libguestfs . --enable-install-daemon guestfsd(8) "make install" ( supermin "" ). "libguestfs live" . --enable-werror ( "-Werror"). (patches) . . --with-default-backend=libvirt libguestfs qemu ( "BACKEND" guestfs(3)). "direct" libguestfs qemu . Fedora Red Hat Enterprise Linux (RHEL) "libvirt" ( RHEL) qemu libvirt . libguestfs $LIBGUESTFS_BACKEND ( API) . --with-distro=REDHAT|DEBIAN|... Libguestfs ( appliance/packagelist.in ). . libguestfs --with-distro ( --with-distro=REDHAT Red Hat CentOS ). (upstream) . --with-extra="distroname=version,libvirt,..." --with-extra="local" "extra" "guestfs_version" guestfs(3) --version virt . libvirt . / "local" . --without-libvirt libguestfs libvirt libvirt . --with-qemu="bin1 bin2 ..." qemu ( ). "LIBGUESTFS_HV" . --with-supermin-packager-config=yum.conf --packager-config supermin(1) . ( yum/dnf/apt ). libguestfs . "libguestfs.spec" ( " " ). --with-supermin-extra-options="--opt1 --opt2 ..." supermin(1). appliance/make.sh.in . PYTHON ( "python3"). "./configure" . SUPERMIN supermin(1) . supermin supermin . RHEL 7 libguestfs "SUPERMIN=/usr/bin/supermin5" . QEMU KVM (NOTES ABOUT QEMU AND KVM) qemu . qemu . qemu . qemu " qemu" ( qemu ). "QEMU WRAPPERS" guestfs(3) . qemu-kvm ( KVM) . KVM qemu . KVM : http://www.linux-kvm.org/page/FAQ#How_can_I_use_kvm_with_a_non-privileged_user.3F : chmod 0666 /dev/kvm chmod udev . CLANG (LLVM) GCC (USING CLANG (LLVM) INSTEAD OF GCC) export CC=clang ./configure make (USING A PREBUILT BINARY APPLIANCE) libguestfs guestfs-internals(1) . supermin(1) libguestfs : http://libguestfs.org/download/binaries/appliance libguestfs : ./configure --disable-appliance --disable-daemon make $LIBGUESTFS_PATH : export LIBGUESTFS_PATH=/usr/local/lib/guestfs/appliance libguestfs virt ./run ( ). (BUILDING A PACKAGE FOR FEDORA) spec : http://pkgs.fedoraproject.org/cgit/rpms/libguestfs.git Libguestfs (Koji) . RED HAT ENTERPRISE LINUX Red Hat Enterprise Linux (RHEL) libguestfs . () : o RHEL . "libguestfs live" . o (upstream) (backport) . RHEL "rhel-x.y" . RHEL 7.3 : https://github.com/libguestfs/libguestfs/commits/rhel-7.3 spec RHEL libguestfs https://git.centos.org/project/rpms https://wiki.centos.org/Sources . (SEE ALSO) guestfs(3), guestfs-examples(3), guestfs-hacking(1), guestfs-internals(1), guestfs-performance(1), guestfs-release-notes(1), guestfs-testing(1), libguestfs-test-tool(1), libguestfs-make-fixed-appliance(1), http://libguestfs.org (AUTHORS) Richard W.M. Jones ("rjones at redhat dot com") (COPYRIGHT) Copyright (C) 2009-2025 Red Hat Inc. (LICENSE) (LGPL) 2 ( ) / . . . : 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) . libguestfs-1.60.1 2026-07-14 guestfs-building(1)