libguestfs-tools.conf(5)

1libguestfs-tools.conf(5)    Virtualization Support    libguestfs-tools.conf(5)
2
3
4

NAME

6       libguestfs-tools.conf - configuration file for guestfish, guestmount,
7       virt-rescue
8

SYNOPSIS

10        /etc/libguestfs-tools.conf
11
12        $XDG_CONFIG_DIRS/libguestfs/libguestfs-tools.conf
13
14        $HOME/.libguestfs-tools.rc
15
16        $XDG_CONFIG_HOME/libguestfs/libguestfs-tools.conf
17

DESCRIPTION

19       libguestfs-tools.conf (or $HOME/.libguestfs-tools.rc) changes the
20       defaults for the following programs only:
21
22       ·   guestfish(1)
23
24       ·   guestmount(1)
25
26       ·   virt-rescue(1)
27
28       There is currently only one setting which is controlled by this file.
29       Adding (or uncommenting):
30
31        read_only = true;
32
33       changes these programs so they act as if the --ro flag was given on the
34       command line.  You can use this to make the programs safe against
35       accidental modification of a live guest (users would have to explicitly
36       add the --rw flag to modify guests).  This is not the default because
37       it is not backwards compatible.  See also "OPENING DISKS FOR READ AND
38       WRITE" in guestfish(1).
39
40       Note that the semicolon is required.
41
42       This file is parsed by the libconfig library.  For more information
43       about the format, see:
44       http://www.hyperrealm.com/libconfig/libconfig_manual.html
45

FILE LOCATION

47       The order of the configuration files being read is, by importance:
48
49       ·   $XDG_CONFIG_HOME/libguestfs/libguestfs-tools.conf ($XDG_CONFIG_HOME
50           is $HOME/.config if not set).
51
52       ·   $HOME/.libguestfs-tools.rc
53
54       ·   $XDG_CONFIG_DIRS/libguestfs/libguestfs-tools.conf (where
55           $XDG_CONFIG_DIRS means any of the directories in that environment
56           variable, or just /etc/xdg if not set)
57
58       ·   /etc/libguestfs-tools.conf
59
60       This means local users can override the system configuration by copying
61       the configuration file (or creating it anew) into
62       $XDG_CONFIG_HOME/libguestfs/libguestfs-tools.conf.
63
64       /etc/libguestfs-tools.conf and $HOME/.libguestfs-tools.rc are the old
65       non-XDG paths which are read for compatibility.
66

AUTHORS

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

COPYRIGHT

76       Copyright (C) 2011-2018 Red Hat Inc.
77

LICENSE

79       This program is free software; you can redistribute it and/or modify it
80       under the terms of the GNU General Public License as published by the
81       Free Software Foundation; either version 2 of the License, or (at your
82       option) any later version.
83
84       This program is distributed in the hope that it will be useful, but
85       WITHOUT ANY WARRANTY; without even the implied warranty of
86       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
87       General Public License for more details.
88
89       You should have received a copy of the GNU General Public License along
90       with this program; if not, write to the Free Software Foundation, Inc.,
91       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
92

BUGS

94       To get a list of bugs against libguestfs, use this link:
95       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
96
97       To report a new bug against libguestfs, use this link:
98       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
99
100       When reporting a bug, please supply:
101
102       ·   The version of libguestfs.
103
104       ·   Where you got libguestfs (eg. which Linux distro, compiled from
105           source, etc)
106
107       ·   Describe the bug accurately and give a way to reproduce it.
108
109       ·   Run libguestfs-test-tool(1) and paste the complete, unedited output
110           into the bug report.
111
112
113
114libguestfs-1.38.2                 2018-05-15          libguestfs-tools.conf(5)