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 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191
|
.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 1.54.1 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds C`
. ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
. if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
. \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "libguestfs-make-fixed-appliance 1"
.TH libguestfs-make-fixed-appliance 1 2025-02-18 libguestfs-1.54.1 "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH НАЗВА
.IX Header "НАЗВА"
libguestfs\-make\-fixed\-appliance \- створити базову систему для libguestfs
.SH "КОРОТКИЙ ОПИС"
.IX Header "КОРОТКИЙ ОПИС"
.Vb 1
\& libguestfs\-make\-fixed\-appliance [\-\-параметри] КАТАЛОГ_ВИВЕДЕННЯ
\&
\& libguestfs\-make\-fixed\-appliance [\-\-параметри] \-\-xz
.Ve
.SH ОПИС
.IX Header "ОПИС"
libguestfs\-make\-fixed\-appliance надає вам змогу створити попередньо зібрану бінарну базову систему для libguestfs.
.PP
\&\fBЗауважте, що у звичайних користувачів не повинно виникнути потреби у запуску цієї програми\fR.
.PP
Декілька причин, з яких у вас \fIможе\fR виникнути потребу у використанні цього інструмента:
.IP \(bu 4
Ви хочете створити самодостатню базову систему libguestfs, яку можна скопіювати на інший комп\*(Aqютер або платформу, де не передбачено підтримки \fBsupermin\fR\|(1).
.IP \(bu 4
На вашому комп\*(Aqютері декілька користувачів і ви хочете уникнути дублювання сховища даних або додаткової затримки через наявність декількох кешованих копій базової системи.
.IP \(bu 4
Вам потрібна дуже передбачувана щодо швидкодії система з libguestfs (див. \fBguestfs\-performance\fR\|(1)).
.PP
Щоб краще зрозуміти потребу у цьому інструменті, ознайомтеся із розділом "БАЗОВА СИСТЕМА" in \fBguestfs\-internals\fR\|(1).
.PP
Замість використання цього інструмента, ви можете отримати базові системи зі сторінки http://libguestfs.org/download/binaries/appliance/. Ці базові системи було створено за допомогою цього інструмента.
.PP
Передбачено два способи використання цього інструмента.
.IP \(bu 4
Вказати каталог виведення даних, приклад:
.Sp
.Vb 1
\& libguestfs\-make\-fixed\-appliance /usr/local/lib/guestfs/appliance
.Ve
.Sp
Якщо каталогу виведення даних ще не існує, його буде створено. У цьому каталозі буде створено чотири файли:
.Sp
.Vb 4
\& <OUTPUTDIR>/kernel
\& <OUTPUTDIR>/initrd
\& <OUTPUTDIR>/root
\& <OUTPUTDIR>/README.fixed
.Ve
.Sp
Зауважте, що \f(CW\*(C`\fR\f(CIКАТАЛОГ_ВИВЕДЕННЯ\fR\f(CW/root\*(C'\fR є розрідженим файлом, отже, слід бути обережним з його копіюванням.
.Sp
Після цього ви зможете запускати libguestfs (можливо, після копіювання цього каталогу на інший комп\*(Aqютер) після встановлення для змінної середовища LIBGUESTFS_PATH значення \f(CW\*(C`КАТАЛОГ_ВИВЕДЕННЯ\*(C'\fR.
.IP \(bu 4
Альтернативним підходом є використання параметра \fI\-\-xz\fR для створення стисненого архіву:
.Sp
.Vb 1
\& libguestfs\-make\-fixed\-appliance \-\-xz
.Ve
.Sp
Буде створено архів у \fIпоточному\fR каталозі з назвою:
.Sp
.Vb 1
\& appliance\-<ВЕРСІЯ>.tar.xz
.Ve
.Sp
(де \f(CW\*(C`ВЕРСІЯ\*(C'\fR — версія libguestfs). У архіві міститься чотири файла:
.Sp
.Vb 4
\& appliance/kernel
\& appliance/initrd
\& appliance/root
\& appliance/README.fixed
.Ve
.Sp
Зауважте, що \f(CW\*(C`appliance/root\*(C'\fR є розрідженим файлом, тому слід бути обережним під час його копіювання.
.SH ПАРАМЕТРИ
.IX Header "ПАРАМЕТРИ"
.IP \fB\-\-help\fR 4
.IX Item "--help"
Показати коротку довідку з користування і завершити роботу.
.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
.IP \fB\-\-xz\fR 4
.IX Item "--xz"
Замість створення базової системи у каталозі виведення результатів, створити стиснений архів базової системи у поточному каталозі із назвою \fIappliance\-ВЕРСІЯ.tar.xz\fR, де \f(CW\*(C`ВЕРСІЯ\*(C'\fR — це версія libguestfs.
.Sp
Використання \fI\-\-xz\fR може потребувати додаткового часу. Якщо все буде нормально, інструмент спрацює без будь\-яких додаткових повідомлень.
.SH "УМОВИ ЛІЦЕНЗУВАННЯ"
.IX Header "УМОВИ ЛІЦЕНЗУВАННЯ"
Базова система є повним бінарним дистрибутивом Linux. Якщо ви поширюватимете його, можливо, вам доведеться поширювати також відповідні файли з початковим кодом, щоб зберегти сумісність із умовами ліцензування програмного забезпечення у базовій системі (зокрема GNU General Public License).
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
libguestfs\-make\-fixed\-appliance повертає \fI0\fR, якщо базову систему було зібрано без помилок.
.SH "ЗМІННІ СЕРЕДОВИЩА"
.IX Header "ЗМІННІ СЕРЕДОВИЩА"
Повний список змінних середовища, які можуть вплинути на роботу libguestfs, можна знайти на сторінці підручника \fBguestfs\fR\|(3).
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBsupermin\fR\|(1), \fBxz\fR\|(1), http://libguestfs.org/, http://qemu.org/.
.SH АВТОРИ
.IX Header "АВТОРИ"
Richard W.M. Jones (\f(CW\*(C`rjones at redhat dot com\*(C'\fR)
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2009\-2023 Red Hat Inc.
.SH LICENSE
.IX Header "LICENSE"
.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
.PP
To report a new bug against libguestfs, use this link:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
.IP \(bu 4
The version of libguestfs.
.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.
|