1GUESTFS-BROWSER(1) Virtualization Support GUESTFS-BROWSER(1)
2
3
4
6 guestfs-browser - Guest filesystem browser
7
9 guestfs-browser [--options]
10
11 guestfs-browser [--options] -d domname
12
13 guestfs-browser [--options] -a disk.img [-a disk.img [...]]
14
16 The guest filesystem browser is a graphical program for browsing
17 virtual machine filesystems and disk images interactively.
18
19 If you need to make scripted changes or browse disk images from the
20 command line, we suggest you look at guestfish(1) or virt-rescue(1)
21 instead. If you want to mount a disk image or virtual machine disk on
22 the host, use guestmount(1).
23
24 To start guestfs-browser with an empty window, use:
25
26 guestfs-browser
27
28 To start guestfs-browser pointing to a disk image file called
29 "disk.img", use:
30
31 guestfs-browser -a disk.img
32
33 To start guestfs-browser pointing to a libvirt domain called "guest",
34 use:
35
36 guestfs-browser [-c libvirtURI] -d guest
37
38 Note that this only works for local libvirt guests (at least the
39 browser must be able to read the disks locally).
40
41 The program does not need to be run as root, unless root is required in
42 order to access the disk images. Currently guestfs-browser only
43 accesses the disk image read only. It is therefore safe to use
44 guestfs-browser on live virtual machines, but you may see strange or
45 inconsistent results.
46
48 -a
49 --add
50 Add file which should be a disk image. You can supply multiple
51 disk images by repeating this option.
52
53 The format of the disk image is auto-detected. To override this
54 and force a particular format use the --format=.. option.
55
56 -c URI
57 --connect URI
58 If using libvirt, connect to the given URI. If omitted, then we
59 connect to the default libvirt hypervisor.
60
61 If you specify guest block devices directly (-a), then libvirt is
62 not used at all.
63
64 -d guest
65 --domain guest
66 Add all the disks from the named libvirt guest.
67
68 --format raw|qcow2|..
69 --format ""
70 The default for the -a option is to auto-detect the format of the
71 disk image. Using this forces the disk format for -a options which
72 follow on the command line. Using --format with no argument
73 switches back to auto-detection for subsequent -a options.
74
75 For example:
76
77 guestfs-browser --format raw -a disk.img
78
79 forces raw format (no auto-detection) for "disk.img".
80
81 guestfs-browser --format raw -a disk.img --format "" -a another.img
82
83 forces raw format (no auto-detection) for "disk.img" and reverts to
84 auto-detection for "another.img".
85
86 If you have untrusted raw-format guest disk images, you should use
87 this option to specify the disk format. This avoids a possible
88 security problem with malicious guests (CVE-2010-3851).
89
90 -v
91 --verbose
92 Enable verbose messages for debugging.
93
94 -V
95 --version
96 Display version number and exit.
97
98 -x Enable tracing of libguestfs API calls.
99
101 guestfs(3), guestfish(1), virt-cat(1), virt-edit(1), virt-rescue(1),
102 http://people.redhat.com/~rjones/guestfs-browser/
103 <http://people.redhat.com/~rjones/guestfs-browser/>,
104 <http://libguestfs.org/>.
105
107 Richard W.M. Jones <http://people.redhat.com/~rjones/>
108
110 Copyright (C) 2010 Red Hat Inc.
111
112 This program is free software; you can redistribute it and/or modify it
113 under the terms of the GNU General Public License as published by the
114 Free Software Foundation; either version 2 of the License, or (at your
115 option) any later version.
116
117 This program is distributed in the hope that it will be useful, but
118 WITHOUT ANY WARRANTY; without even the implied warranty of
119 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
120 General Public License for more details.
121
122 You should have received a copy of the GNU General Public License along
123 with this program; if not, write to the Free Software Foundation, Inc.,
124 675 Mass Ave, Cambridge, MA 02139, USA.
125
126
127
128guestfs-browser-0.2.1 2013-01-28 GUESTFS-BROWSER(1)