summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorRichard W.M. Jones <rjones@redhat.com>2011-04-15 21:43:20 +0100
committerRichard W.M. Jones <rjones@redhat.com>2011-04-16 08:32:44 +0100
commit5790f5bfafb12cc2ed9365461bf66e0fdfde7150 (patch)
tree3536d84023161f43882c4dd7df54f51f17ebe2f7 /README
parent0108d7861d4cc9a1f0d87d89080d1be7750e54b5 (diff)
downloadlibguestfs-5790f5bfafb12cc2ed9365461bf66e0fdfde7150.tar.gz
libguestfs-5790f5bfafb12cc2ed9365461bf66e0fdfde7150.tar.xz
libguestfs-5790f5bfafb12cc2ed9365461bf66e0fdfde7150.zip
Remove ad-hoc run*locally scripts, replace with './run'
Remove all the run*locally scripts and replace with a single top level ./run shell script.
Diffstat (limited to 'README')
-rw-r--r--README28
1 files changed, 28 insertions, 0 deletions
diff --git a/README b/README
index 4abc0453..3960b613 100644
--- a/README
+++ b/README
@@ -113,6 +113,34 @@ this command as root:
make install
+You can run 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 ./inspector/virt-inspector [usual virt-inspector args ...]
+
+If you are already in the inspector/ subdirectory, then the following
+command will also work:
+
+ ../run ./virt-inspector [...]
+
+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
----------------------------------------------------------------------