File: libguestfs-tools.conf.pod

package info (click to toggle)
libguestfs 1%3A1.48.6-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 98,368 kB
  • sloc: ansic: 376,405; ml: 38,310; sh: 10,217; java: 9,578; cs: 6,328; haskell: 5,674; makefile: 5,165; python: 3,800; perl: 2,454; erlang: 2,446; ruby: 350; xml: 303; pascal: 257; javascript: 157; cpp: 10
file content (85 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

=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-2020 Red Hat Inc.