X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=README;h=9efcb9bafd5795110d4f6a7cda7d4cef18279d87;hp=fe3de961335ddd585d35fdfe96b373c0c33b223e;hb=fa7c8bb79b45aecdf65ed93635a42f3fdf301134;hpb=64a5ae0e969754c709974104a83e6d1dbb4c2764 diff --git a/README b/README index fe3de96..9efcb9b 100644 --- a/README +++ b/README @@ -16,9 +16,8 @@ LVs, what filesystem is in each LV, etc.). It can also run commands 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 -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. +programs (or management programs written in OCaml, Perl, Python, Ruby or Java). +You can also use it from shell scripts or the command line. Libguestfs was written by Richard W.M. Jones (rjones@redhat.com). For discussion please use the fedora-virt mailing list: @@ -29,20 +28,34 @@ For discussion please use the fedora-virt mailing list: Requirements ---------------------------------------------------------------------- -- recent QEMU with vmchannel support +- recent QEMU >= 0.10 with vmchannel support + http://lists.gnu.org/archive/html/qemu-devel/2009-02/msg01042.html -- febootstrap >= 1.2 +- febootstrap >= 1.5 - XDR, rpcgen +- (Optional) Augeas (http://augeas.net/) + - perldoc (pod2man, pod2text) to generate the manual pages and other documentation. -- (Optional) OCaml if you want to modify the code or rebuild certain -generated files. +- (Optional) Readline to have nicer command-line editing in guestfish. + +- (Optional) OCaml if you want to rebuild the generated files, and +also to build the OCaml bindings - (Optional) local Fedora mirror +- (Optional) Perl if you want to build the perl bindings + +- (Optional) Python if you want to build the python bindings + +- (Optional) Ruby, rake if you want to build the ruby bindings + +- (Optional) Java, JNI, jpackage-utils if you want to build the java +bindings + Running ./configure will check you have all the requirements installed on your machine. @@ -69,6 +82,26 @@ these commands as root: make install +Note on using KVM +---------------------------------------------------------------------- + +If you are using x86-64, then by default the configure script will +look for qemu-kvm (KVM support). You will need a reasonably recent +processor for this to work. KVM is much faster than using plain QEMU. + +You may also need to enable KVM support for non-root users, by following +these instructions: + + http://www.linux-kvm.org/page/FAQ#How_can_I_use_kvm_with_a_non-privileged_user.3F + +On some systems, this will work too: + + chmod o+rw /dev/kvm + +On some systems, the chmod will not survive a reboot, and you will +need to make edits to the udev configuration. + + Notes on cross-architecture support ----------------------------------------------------------------------