File: libguestfs-make-fixed-appliance.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 (127 lines) | stat: -rw-r--r-- 4,020 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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

=head1 名前

libguestfs-make-fixed-appliance - libguestfs 向け "fixed appliance" (固定アプライアンス) を作成します

=head1 書式

 libguestfs-make-fixed-appliance [--options] OUTPUTDIR

 libguestfs-make-fixed-appliance [--options] --xz

=head1 説明

libguestfs-make-fixed-appliance により、事前に構築されたバイナリーの libguestfs 向けアプライアンスを作成できます。

B<Note that ordinary users should not need to run this tool>.

Some reasons why you I<might> want to use this include:

=over 4

=item *

You want to make a self-contained libguestfs appliance that can be copied to another machine or platform that doesn't support L<supermin(1)>.

=item *

You have multiple users on the same machine and want to avoid the storage duplication and start-up overhead of having multiple cached copies of the appliance.

=item *

You want to have very predictable performance from libguestfs (see L<guestfs-performance(1)>).

=back

For deeper understanding of why you might need this tool, read L<guestfs-internals(1)/FIXED APPLIANCE>.

Instead of running this tool, you can download fixed appliances from L<http://libguestfs.org/download/binaries/appliance/>.  These appliances were made using this tool.

このツールを使用する方法が二つあります。

=over 4

=item *

出力ディレクトリーを指定します、たとえば:

 libguestfs-make-fixed-appliance /usr/local/lib/guestfs/appliance

出力ディレクトリーが存在しなければ、作成されます。4 つのファイルがこのディレクトリーに作成されます:

 <OUTPUTDIR>/kernel
 <OUTPUTDIR>/initrd
 <OUTPUTDIR>/root
 <OUTPUTDIR>/README.fixed

C<I<OUTPUTDIR>/root> はスパースなファイルのため、これをコピーするときに注意する必要があります。

You can then run libguestfs (possibly after copying this directory to another machine) by setting the environment variable LIBGUESTFS_PATH to C<OUTPUTDIR>.

=item *

圧縮 tar ファイルを作成する、もう一つの方法は I<--xz> オプションを使用することです:

 libguestfs-make-fixed-appliance --xz

これは呼び出した I<カレント> ディレクトリーに tar ファイルを作成します:

 appliance-<VERSION>.tar.xz

(ここで C<VERSION> は libguestfs のバージョンです)。  tar ファイルは 4 つのファイルを含みます:

 appliance/kernel
 appliance/initrd
 appliance/root
 appliance/README.fixed

C<appliance/root> はスパースファイルであるため、コピーするときには気をつける必要があるため、注意してください。

=back

=head1 オプション

=over 4

=item B<--help>

簡単な使用法を表示して、終了します。

=item B<-V>

=item B<--version>

バージョン番号を表示して、終了します。

=item B<--xz>

Instead of creating the appliance in an output directory, create a compressed tarball of the appliance in the current directory called F<appliance-I<VERSION>.tar.xz> where C<VERSION> is the version of libguestfs.

Using I<--xz> can take some time.  If working normally, the tool is completely silent when it is running.

=back

=head1 ライセンス

The fixed appliance is a complete Linux binary distro.  If you distribute it, you may need to distribute corresponding source files to remain in legal compliance with the licenses of the software in the appliance (such as the GNU General Public License).

=head1 終了ステータス

アプライアンスがエラーなくビルドされると、libguestfs-make-fixed-appliance は I<0> を返します。

=head1 環境変数

libguestfs に影響する環境変数の完全な一覧は L<guestfs(3)> マニュアルページを参照してください。

=head1 関連項目

L<guestfs(3)>, L<supermin(1)>, L<xz(1)>, L<http://libguestfs.org/>, L<http://qemu.org/>.

=head1 著者

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

=head1 COPYRIGHT

Copyright (C) 2009-2020 Red Hat Inc.