b21b50d8c51d76d89893b250603e65792ea9e46b
[guestfs-browser.git] / README
1 >>> This is alpha quality software.  Read 'HACKING' and 'TODO'. <<<
2
3 Guest filesystem browser
4 Copyright (C) 2010 Red Hat Inc.
5
6 To compile from source, install the prerequisites (run the ./configure
7 script and it will tell you what's missing).
8
9   autoreconf -i      # if using the git version
10   ./configure
11   make
12
13 We strongly suggest you run the program like this:
14
15   guestfs-browser [--verbose] [--write] --connect qemu:///system
16 or:
17   guestfs-browser [--verbose] [--write] disk.img
18
19 --verbose enables debug level messages and is recommended.
20
21 --write enables writes to the filesystems and is *not* recommended for
22 casual users.
23
24 --connect tells the program which libvirt URI to connect to.
25
26 Note that libguestfs cannot access remote storage, so accessing a
27 remote libvirt URI will usually not work.