File: libguestfs-make-fixed-appliance.pod

package info (click to toggle)
libguestfs 1%3A1.44.0-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 118,932 kB
  • sloc: ansic: 458,017; ml: 51,424; sh: 13,191; java: 9,578; makefile: 7,931; cs: 6,328; haskell: 5,674; python: 3,871; perl: 3,528; erlang: 2,446; xml: 1,347; ruby: 350; pascal: 257; javascript: 157; lex: 135; yacc: 128; cpp: 10
file content (153 lines) | stat: -rw-r--r-- 6,104 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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153

=head1 НАЗВА

libguestfs-make-fixed-appliance - створити базову систему для libguestfs

=head1 КОРОТКИЙ ОПИС

 libguestfs-make-fixed-appliance [--параметри] КАТАЛОГ_ВИВЕДЕННЯ

 libguestfs-make-fixed-appliance [--параметри] --xz

=head1 ОПИС

libguestfs-make-fixed-appliance надає вам змогу створити попередньо зібрану
бінарну базову систему для libguestfs.

B<Зауважте, що у звичайних користувачів не повинно виникнути потреби у
запуску цієї програми>.

Декілька причин, з яких у вас I<може> виникнути потребу у використанні цього
інструмента:

=over 4

=item *

Ви хочете створити самодостатню базову систему libguestfs, яку можна
скопіювати на інший комп'ютер або платформу, де не передбачено підтримки
L<supermin(1)>.

=item *

На вашому комп'ютері декілька користувачів і ви хочете уникнути дублювання
сховища даних або додаткової затримки через наявність декількох кешованих
копій базової системи.

=item *

Вам потрібна дуже передбачувана щодо швидкодії система з libguestfs
(див. L<guestfs-performance(1)>).

=back

Щоб краще зрозуміти потребу у цьому інструменті, ознайомтеся із розділом
L<guestfs-internals(1)/БАЗОВА СИСТЕМА>.

Замість використання цього інструмента, ви можете отримати базові системи зі
сторінки  L<http://libguestfs.org/download/binaries/appliance/>.  Ці базові
системи було створено за допомогою цього інструмента.

Передбачено два способи використання цього інструмента.

=over 4

=item *

Вказати каталог виведення даних, приклад:

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

Якщо каталогу виведення даних ще не існує, його буде створено. У цьому
каталозі буде створено чотири файли:

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

Зауважте, що C<I<КАТАЛОГ_ВИВЕДЕННЯ>/root> є розрідженим файлом, отже, слід
бути обережним з його копіюванням.

Після цього ви зможете запускати libguestfs (можливо, після копіювання цього
каталогу на інший комп'ютер) після встановлення для змінної середовища
LIBGUESTFS_PATH значення C<КАТАЛОГ_ВИВЕДЕННЯ>.

=item *

Альтернативним підходом є використання параметра I<--xz> для створення
стисненого архіву:

 libguestfs-make-fixed-appliance --xz

Буде створено архів у I<поточному> каталозі з назвою:

 appliance-<ВЕРСІЯ>.tar.xz

(де C<ВЕРСІЯ> — версія libguestfs). У архіві міститься чотири файла:

 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>

Замість створення базової системи у каталозі виведення результатів, створити
стиснений архів базової системи у поточному каталозі із назвою
F<appliance-I<ВЕРСІЯ>.tar.xz>, де C<ВЕРСІЯ> — це версія libguestfs.

Використання I<--xz> може потребувати додаткового часу. Якщо все буде
нормально, інструмент спрацює без будь-яких додаткових повідомлень.

=back

=head1 УМОВИ ЛІЦЕНЗУВАННЯ

Базова система є повним бінарним дистрибутивом Linux. Якщо ви поширюватимете
його, можливо, вам доведеться поширювати також відповідні файли з початковим
кодом, щоб зберегти сумісність із умовами ліцензування програмного
забезпечення у базовій системі (зокрема 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 (C) 2009-2020 Red Hat Inc.