libguestfs-tools.conf - configuration file for guestfish, guestmount,
) changes the defaults for the
following programs only:
There is currently only one setting which is controlled by this file. Adding (or
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
flag to modify guests). This is not the default because it is not
backwards compatible. See also "OPENING DISKS FOR READ AND WRITE" in
Note that the semicolon is required
This file is parsed by the libconfig library. For more information about the
format, see: http://www.hyperrealm.com/libconfig/libconfig_manual.html
The order of the configuration files being read is, by importance:
($XDG_CONFIG_HOME is $HOME/.config if not set).
- $XDG_CONFIG_DIRS/libguestfs/libguestfs-tools.conf (where
$XDG_CONFIG_DIRS means any of the directories in that environment
variable, or just /etc/xdg if not set)
This means local users can override the system configuration by copying the
configuration file (or creating it anew) into
are the old non-XDG paths
which are read for compatibility.
"OPENING DISKS FOR READ AND WRITE" in guestfish
Richard W.M. Jones ("rjones at redhat dot com")
Copyright (C) 2011-2017 Red Hat Inc.
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
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.
To get a list of bugs against libguestfs, use this link:
To report a new bug against libguestfs, use this link:
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
- Run libguestfs-test-tool(1) and paste the
complete, unedited output into the bug report.