libguestfs-tools.conf (5)

NAME
SYNOPSIS
DESCRIPTION
SEE ALSO
AUTHORS
COPYRIGHT
LICENSE
BUGS

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

AUTHORS

Richard W.M. Jones ("rjones at redhat dot com")

COPYRIGHT

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.