X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=README;h=272203580ccd9f49e1e774d0dc7f62c935ebd7a2;hp=659feb93742b2f5bd06777501e03200f649c4c9d;hb=108d7a134c5d26b967fa7162d9b80b40112c2869;hpb=ca03635a4c83afbe9b51fe846a8b3d5361462a90 diff --git a/README b/README index 659feb9..2722035 100644 --- a/README +++ b/README @@ -15,7 +15,7 @@ Requirements - recent QEMU >= 0.13 with virtio-serial support - kernel >= 2.6.34 with virtio-serial support enabled. virtio-block - and virtio-serial support are not required but highly recommended. + support is not required but comes highly recommended. - febootstrap >= 3.0 (recommended >= 3.3) *NB*: febootstrap 2.x WILL NOT WORK @@ -113,6 +113,36 @@ this command as root: make install +You can run guestfish, guestmount and the virt tools without needing +to install, using the "run" script in the top directory. This script +sets up some environment variables. For example: + + ./run ./fish/guestfish [usual guestfish args ...] + + ./run ./inspector/virt-inspector [usual virt-inspector args ...] + +If you are already in the fish/ subdirectory, then the following +command will also work: + + ../run ./guestfish [...] + +You can also make a symlink (note: NOT a hard link) from your $PATH to +the run script, eg: + + cd ~/bin + ln -s ~/libguestfs/run libguestfs-run + cd ~/libguestfs + libguestfs-run ./inspector/virt-inspector [...] + +You can also run the C programs under valgrind like this: + + ./run valgrind [valgrind opts...] ./cat/virt-cat [virt-cat opts...] + +This also works with sudo (eg. if you need root access for libvirt or +to access a block device): + + sudo ./run ./cat/virt-cat -d LinuxGuest /etc/passwd + qemu ---------------------------------------------------------------------- @@ -216,7 +246,7 @@ appliance. You will need to port the febootstrap first Copyright and license information ---------------------------------------------------------------------- -Copyright (C) 2009-2010 Red Hat Inc. +Copyright (C) 2009-2011 Red Hat Inc. The library is distributed under the LGPLv2+. The programs are distributed under the GPLv2+. Please see the files COPYING and