1GUESTFS-BROWSER(1)          Virtualization Support          GUESTFS-BROWSER(1)
2
3
4

NAME

6       guestfs-browser - Guest filesystem browser
7

SYNOPSIS

9        guestfs-browser [--options]
10
11        guestfs-browser [--options] -d domname
12
13        guestfs-browser [--options] -a disk.img [-a disk.img [...]]
14

DESCRIPTION

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

OPTIONS

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

SEE ALSO

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

AUTHOR

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)
Impressum