X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;ds=sidebyside;f=README;h=3e4da74dc21e41d5eecba3f29e3a7b11f90fc046;hb=4567839859befc5aa9e1eee942dc2ba0701516e2;hp=369295cfdaf8200d3075122e8d542239216b4cf1;hpb=6ed48042e4a8b009b5e38efbf4766a2676a33935;p=libguestfs.git diff --git a/README b/README index 369295c..3e4da74 100644 --- a/README +++ b/README @@ -1,4 +1,4 @@ -libguestfs is a library for accessing and modifying guest disk images. +Libguestfs is a library for accessing and modifying guest disk images. Amongst the things this is good for: making batch configuration changes to guests, getting disk used/free statistics (see also: virt-df), migrating between virtualization systems (see also: @@ -6,22 +6,21 @@ virt-p2v), performing partial backups, performing partial guest clones, cloning guests and changing registry/UUID/hostname info, and much else besides. -libguestfs uses Linux kernel and qemu code, and can access any type of +Libguestfs uses Linux kernel and qemu code, and can access any type of guest filesystem that Linux and qemu can, including but not limited to: ext2/3/4, btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2, vmdk. -libguestfs provides ways to enumerate guest storage (eg. partitions, +Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what filesystem is in each LV, etc.). It can also run commands -in the context of the guest. Also you can mount guest filesystems on -the host (requires root privs and NFS). +in the context of the guest. Also you can access filesystems over FTP. -libguestfs is a library that can be linked with C and C++ management +Libguestfs is a library that can be linked with C and C++ management programs (or management programs written in other languages, if people contribute the language bindings). You can also use it from shell scripts or the command line. -libguestfs was written by Richard W.M. Jones (rjones@redhat.com). +Libguestfs was written by Richard W.M. Jones (rjones@redhat.com). For discussion please use the fedora-virt mailing list: https://www.redhat.com/mailman/listinfo/fedora-virt @@ -36,6 +35,11 @@ Requirements - XDR, rpcgen +- (Optional) perldoc to generate the manual pages + +- (Optional) OCaml if you want to modify the code or rebuild certain +generated files. + - (Optional) local Fedora mirror Running ./configure will check you have all the requirements installed @@ -69,7 +73,7 @@ Notes on cross-architecture support At the moment we basically don't support cross-architecture or 32-on-64. This limits what is possible for some guests. Filesystem -operations and NFS export will work fine, but running commands in +operations and FTP export will work fine, but running commands in guests may not be possible. To enable this requires work for cross-architecture and 32-on-64 @@ -93,6 +97,13 @@ choose a Fedora mirror which is close to you, set this with './configure --with-mirror=[...]', and then proxy the whole lot through squid by setting http_proxy environment variable). +You will also need to substantially increase the squid configuration +limits: +http://fedoraproject.org/wiki/Using_Mock_to_test_package_builds#Using_Squid_to_Speed_Up_Mock_package_downloads + +IntelligentMirror is another possibility, although I couldn't get it +to work for me. + Copyright and license information ----------------------------------------------------------------------