File: libguestfs-tools.conf.pod

package info (click to toggle)
libguestfs 1%3A1.40.2-2
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 123,660 kB
  • sloc: ansic: 460,074; ml: 63,059; sh: 14,955; java: 9,512; makefile: 9,133; cs: 6,300; haskell: 5,652; python: 3,856; perl: 3,619; erlang: 2,435; xml: 1,683; ruby: 350; pascal: 255; lex: 135; yacc: 128; cpp: 10
file content (102 lines) | stat: -rw-r--r-- 2,282 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

=head1 名前

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

=head1 書式

 /etc/libguestfs-tools.conf

 $XDG_CONFIG_DIRS/libguestfs/libguestfs-tools.conf

 $HOME/.libguestfs-tools.rc

 $XDG_CONFIG_HOME/libguestfs/libguestfs-tools.conf

=head1 説明

F<libguestfs-tools.conf> (or F<$HOME/.libguestfs-tools.rc>) changes the
defaults for the following programs only:

=over 4

=item *

L<guestfish(1)>

=item *

L<guestmount(1)>

=item *

L<virt-rescue(1)>

=back

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 I<--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 I<--rw>
flag to modify guests).  This is not the default because it is not backwards
compatible.  See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>.

Note that B<the semicolon is required>.

This file is parsed by the libconfig library.  For more information about
the format, see:
L<http://www.hyperrealm.com/libconfig/libconfig_manual.html>

=head1 FILE LOCATION

The order of the configuration files being read is, by importance:

=over 4

=item *

$XDG_CONFIG_HOME/libguestfs/libguestfs-tools.conf (C<$XDG_CONFIG_HOME> is
F<$HOME/.config> if not set).

=item *

$HOME/.libguestfs-tools.rc

=item *

$XDG_CONFIG_DIRS/libguestfs/libguestfs-tools.conf (where C<$XDG_CONFIG_DIRS>
means any of the directories in that environment variable, or just
F</etc/xdg> if not set)

=item *

/etc/libguestfs-tools.conf

=back

This means local users can override the system configuration by copying the
configuration file (or creating it anew) into
F<$XDG_CONFIG_HOME/libguestfs/libguestfs-tools.conf>.

F</etc/libguestfs-tools.conf> and F<$HOME/.libguestfs-tools.rc> are the old
non-XDG paths which are read for compatibility.

=head1 関連項目

L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>, L<guestmount(1)>,
L<virt-rescue(1)>, L<http://libguestfs.org/>,
L<http://standards.freedesktop.org/basedir-spec/latest/>.

=head1 著者

Richard W.M. Jones (C<rjones at redhat dot com>)

=head1 COPYRIGHT

Copyright (C) 2011-2019 Red Hat Inc.