libguestfs-tools.conf(5) Virtualization Support libguestfs-tools.conf(5)NAME
/etc/libguestfs-tools.conf - configuration file for guestfish,
guestmount, virt-rescue
SYNOPSIS
/etc/libguestfs-tools.conf
$HOME/.libguestfs-tools.rc
DESCRIPTION
"/etc/libguestfs-tools.conf" or "$HOME/.libguestfs-tools.rc" changes
the defaults for the following programs only:
· guestfish(1)
· guestmount(1)
· virt-rescue(1)
There is currently only one setting which is controlled by this file.
Adding (or uncommenting):
read_only = true;
changes these programs so they act as if the --ro flag was given on the
command line. You can use this to make the programs safe against
accidental modification of a live guest (users would have to explicitly
add the --rw flag to modify guests). This is not the default because
it is not backwards compatible. See also "OPENING DISKS FOR READ AND
WRITE" in guestfish(1).
Note that the semicolon is required.
"/etc/libguestfs-tools.conf" is the global configuration file for all
of the above programs. Local users can override the global
configuration by copying this file into ".libguestfs-tools.rc" in their
home directory and modifying it accordingly.
This file is parsed by the libconfig library. For more information
about the format, see:
http://www.hyperrealm.com/libconfig/libconfig_manual.html
SEE ALSO
"OPENING DISKS FOR READ AND WRITE" in guestfish(1), guestmount(1),
virt-rescue(1), http://libguestfs.org/.
AUTHORS
Richard W.M. Jones ("rjones at redhat dot com")
COPYRIGHT
Copyright (C) 2011-2013 Red Hat Inc.
LICENSE
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
BUGS
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
To report a new bug against libguestfs, use this link:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
When reporting a bug, please supply:
· The version of libguestfs.
· Where you got libguestfs (eg. which Linux distro, compiled from
source, etc)
· Describe the bug accurately and give a way to reproduce it.
· Run libguestfs-test-tool(1) and paste the complete, unedited output
into the bug report.
libguestfs-1.22.6 2013-08-24 libguestfs-tools.conf(5)
