.\" Automatically generated by Podwrapper::Man 1.44.0 (Pod::Simple 3.40)
.\"
.\" 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
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    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
.\" ========================================================================
.\"
.IX Title "virt-customize 1"
.TH virt-customize 1 "2021-01-05" "libguestfs-1.44.0" "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 "НАЗВА"
virt-customize — налаштовування віртуальної машини
.SH "КОРОТКИЙ ОПИС"
.IX Header "КОРОТКИЙ ОПИС"
.Vb 7
\& virt\-customize
\&    [ \-a диск.img [ \-a диск.img ... ] | \-d назва домену ]
\&    [\-\-attach файл ISO] [\-\-attach\-format ФОРМАТ]
\&    [ \-c АДРЕСА | \-\-connect АДРЕСА ] [ \-n | \-\-dry\-run ]
\&    [ \-\-format ФОРМАТ] [ \-m МБ | \-\-memsize МБ ]
\&    [ \-\-network | \-\-no\-network ]
\&    [ \-q | \-\-quiet ] [\-\-smp N] [ \-v | \-\-verbose ] [\-x]
\&
\&
\&
\& virt\-customize [ \-V | \-\-version ]
.Ve
.SH "ОПИС"
.IX Header "ОПИС"
За допомогою virt-customize можна налаштувати віртуальну машину (образ
диска) встановленням пакунків, редагуванням файлів налаштувань тощо.
.PP
Virt-customize вносить зміни до гостьової системи або образу диска \fIна
місці\fR. Гостьова система має бути вимкненою. Якщо ви хочете зберегти наявний
вміст гостьової системи, \fIвам слід спочатку зробити її знімок, скопіювати
або клонувати її диск\fR.
.PP
Вам \fIне потрібно\fR запускати virt-customize від імені користувача
root. Фактично, запуск у такому режимі є нерекомендованим.
.PP
Пов'язані інструменти: \fBvirt\-sysprep\fR\|(1) і \fBvirt\-builder\fR\|(1).
.SH "ПАРАМЕТРИ"
.IX Header "ПАРАМЕТРИ"
.IP "\fB\-\-help\fR" 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR файл" 4
.IX Item "-a файл"
.PD 0
.IP "\fB\-\-add\fR файл" 4
.IX Item "--add файл"
.PD
Додати \fIфайл\fR, який має бути образом диска з віртуальної машини.
.Sp
Формат образу диска визначається автоматично. Щоб перевизначити його і
примусово використати певний формат, скористайтеся параметром \fI\-\-format\fR.
.IP "\fB\-a\fR адреса" 4
.IX Item "-a адреса"
.PD 0
.IP "\fB\-\-add\fR адреса" 4
.IX Item "--add адреса"
.PD
Додати віддалений диск. Формат адреси є сумісним із
guestfish. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1).
.IP "\fB\-\-attach\fR ФАЙЛ_ISO" 4
.IX Item "--attach ФАЙЛ_ISO"
Вказаний диск долучається до базової системи libguestfs. Цей диск
використовується для отримання даних додаткових сховищ програмного
забезпечення або інших даних для створення нетипової системи.
.Sp
Ймовірно, вам варто додати мітки для долучених дисків (або скористатися
назвою тому \s-1ISO\s0), щоб надалі монтувати диски за міткою у ваших скриптах
запуску:
.Sp
.Vb 2
\& mkdir /tmp/mount
\& mount LABEL=EXTRA /tmp/mount
.Ve
.Sp
Параметр \fI\-\-attach\fR можна вказати декілька разів, а форматом може бути
будь\-який формат образу (не лише \s-1ISO\s0).
.IP "\fB\-\-attach\-format\fR ФОРМАТ" 4
.IX Item "--attach-format ФОРМАТ"
Вказати формат диска для наступного параметра \fI\-\-attach\fR. Значенням
аргументу \f(CW\*(C`ФОРМАТ\*(C'\fR зазвичай є \f(CW\*(C`raw\*(C'\fR або \f(CW\*(C`qcow2\*(C'\fR.  Для образів \s-1ISO\s0
скористайтеся варіантом \f(CW\*(C`raw\*(C'\fR.
.IP "\fB\-\-colors\fR" 4
.IX Item "--colors"
.PD 0
.IP "\fB\-\-colours\fR" 4
.IX Item "--colours"
.PD
Використовувати послідовності символів \s-1ANSI\s0 для розфарбовування
повідомлень. Ці послідовності типово використовуються, якщо дані виводяться
на термінал tty.  Якщо дані, виведені програмою, спрямовуються до файла,
послідовності визначення кольорів \s-1ANSI\s0 буде вимкнено, якщо ви не додасте до
команди цей параметр.
.IP "\fB\-c\fR адреса" 4
.IX Item "-c адреса"
.PD 0
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо
пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR),
libvirt не буде використовуватися взагалі.
.IP "\fB\-d\fR гість" 4
.IX Item "-d гість"
.PD 0
.IP "\fB\-\-domain\fR гість" 4
.IX Item "--domain гість"
.PD
Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна
використовувати замість назв.
.IP "\fB\-n\fR" 4
.IX Item "-n"
.PD 0
.IP "\fB\-\-dry\-run\fR" 4
.IX Item "--dry-run"
.PD
Виконати тестову обробку гостьової системи у режимі «лише читання». Буде
виконано дію sysprep, але наприкінці усі зміни до диска буде відкинуто.
.IP "\fB\-\-echo\-keys\fR" 4
.IX Item "--echo-keys"
Типово, якщо virt-customize попросить вас ввести ключ або пароль, програма
не відтворюватиме введені символи на екрані. Якщо ви не боїтеся
TEMPEST\-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете
скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.
.IP "\fB\-\-format\fR raw|qcow2|.." 4
.IX Item "--format raw|qcow2|.."
.PD 0
.IP "\fB\-\-format\fR auto" 4
.IX Item "--format auto"
.PD
Типовим значенням для параметра \fI\-a\fR є автоматичне визначення формату
образу диска. Використання цього параметра примусово визначає значення
параметрів \fI\-a\fR формату диска у наступному рядку команди. Використання
параметра \fI\-\-format auto\fR перемикає програму у режим автоматичного
визначення у наступних параметрах \fI\-a\fR.
.Sp
Приклад:
.Sp
.Vb 1
\& virt\-customize \-\-format raw \-a диск.img
.Ve
.Sp
примусове встановлення формату без обробки (без автоматичного визначення)
для \fIdisk.img\fR.
.Sp
.Vb 1
\& virt\-customize \-\-format raw \-a диск.img \-\-format auto \-a іще_диск.img
.Ve
.Sp
примусове встановлення формату без обробки (без автоматичного визначення)
для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR.
.Sp
Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому
форматі, вам слід скористатися цим параметром для визначення формату
диска. Таким чином можна уникнути можливих проблем з захистом для
сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
.IP "\fB\-\-key\fR ВАРІАНТ" 4
.IX Item "--key ВАРІАНТ"
Specify a key for \s-1LUKS,\s0 to automatically open a \s-1LUKS\s0 device when using the
inspection.  \f(CW\*(C`ID\*(C'\fR can be either the libguestfs device name, or the \s-1UUID\s0 of
the \s-1LUKS\s0 device.
.RS 4
.ie n .IP "\fB\-\-key\fR ""ID"":key:KEY_STRING" 4
.el .IP "\fB\-\-key\fR \f(CWID\fR:key:KEY_STRING" 4
.IX Item "--key ID:key:KEY_STRING"
Використовувати вказаний \f(CW\*(C`РЯДОК_КЛЮЧА\*(C'\fR як пароль.
.ie n .IP "\fB\-\-key\fR ""ID"":file:FILENAME" 4
.el .IP "\fB\-\-key\fR \f(CWID\fR:file:FILENAME" 4
.IX Item "--key ID:file:FILENAME"
Прочитати пароль з файла \fIНАЗВА_ФАЙЛА\fR.
.RE
.RS 4
.RE
.IP "\fB\-\-keys\-from\-stdin\fR" 4
.IX Item "--keys-from-stdin"
Прочитати параметри ключа або пароля із джерела стандартного
введення. Типово програма намагається читати паролі від користувача
відкриттям \fI/dev/tty\fR.
.Sp
If there are multiple encrypted devices then you may need to supply multiple
keys on stdin, one per line.
.IP "\fB\-m\fR МБ" 4
.IX Item "-m МБ"
.PD 0
.IP "\fB\-\-memsize\fR МБ" 4
.IX Item "--memsize МБ"
.PD
Зміна обсягу пам'яті, наданого скриптам \fI\-\-run\fR. Збільште це значення, якщо
виявиться, що для використання скриптів \fI\-\-run\fR або параметра \fI\-\-install\fR
не вистачає пам'яті.
.Sp
Типові значення можна визначити за допомогою такої команди:
.Sp
.Vb 1
\& guestfish get\-memsize
.Ve
.IP "\fB\-\-network\fR" 4
.IX Item "--network"
.PD 0
.IP "\fB\-\-no\-network\fR" 4
.IX Item "--no-network"
.PD
Увімкнути чи вимкнути доступ до мережі для гостьової системи під час
встановлення.
.Sp
Типово увімкнено. Скористайтеся параметром \fI\-\-no\-network\fR, щоб вимкнути
доступ.
.Sp
У мережі працюватимуть лише вихідні з'єднання, а також буде декілька інших
незначних обмежень. Див. \*(L"МЕРЕЖА\*(R" in \fBvirt\-rescue\fR\|(1).
.Sp
Якщо ви скористаєтеся параметром \fI\-\-no\-network\fR, тоді інші параметри,
зокрема \fI\-\-install\fR, не працюватимуть.
.Sp
Це не вплине на доступність мережі для гостьової системи після її
завантаження, оскільки така доступність керується вашим гіпервізором або
хмарним середовищем і не має нічого спільного з virt-customize.
.Sp
Загалом кажучи, вам \fIне варто\fR використовувати \fI\-\-no\-network\fR. Але ось
декілька випадків, коли у вас може виникнути потреба у використанні цього
параметра:
.RS 4
.IP "1." 4
У модулі обробки libguestfs, яким ви користуєтеся, не передбачено підтримки
мережі.  (Див. \*(L"МОДУЛЬ\*(R" in \fBguestfs\fR\|(3)).
.IP "2." 4
Усе програмне забезпечення, яке ви маєте намір встановити, походить з
долученого образу \s-1ISO,\s0 отже потреби у мережі немає.
.IP "3." 4
Ви не хочете, щоб ненадійний код із гостьової системи намагався отримати
доступ до мережевого з'єднання вашої основної системи під час роботи
virt-customize. Таке, зокрема, може трапитися, якщо ви не довіряєте джерелу
шаблонів операційних систем.  (Див. \*(L"БЕЗПЕКА\*(R" нижче).
.IP "4." 4
Ви не хочете користуватися мережею основної системи (наприклад, через
захищеність або обмеженість середовища у ній).
.RE
.RS 4
.RE
.IP "\fB\-q\fR" 4
.IX Item "-q"
.PD 0
.IP "\fB\-\-quiet\fR" 4
.IX Item "--quiet"
.PD
Не виводити повідомлення до журналу.
.Sp
Для вмикання ведення докладного журналу окремих дій з файлами скористайтеся
\&\fI\-x\fR.
.IP "\fB\-\-smp\fR N" 4
.IX Item "--smp N"
Увімкнути N ≥ 2 віртуальних процесорів для використання у скриптах
\&\fI\-\-run\fR.
.IP "\fB\-v\fR" 4
.IX Item "-v"
.PD 0
.IP "\fB\-\-verbose\fR" 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
.IP "\fB\-V\fR" 4
.IX Item "-V"
.PD 0
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
.IP "\fB\-x\fR" 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.SS "Параметри налаштовування"
.IX Subsection "Параметри налаштовування"
.IP "\fB\-\-append\-line\fR ФАЙЛ:РЯДОК" 4
.IX Item "--append-line ФАЙЛ:РЯДОК"
Дописати один рядок тексту до файла \f(CW\*(C`ФАЙЛ\*(C'\fR. Якщо файл ще не завершується
порожнім рядком, такий рядок буде додано перед дописаним. Крім того,
автоматично буде дописано символ нового рядка наприкінці рядка \f(CW\*(C`РЯДОК\*(C'\fR.
.Sp
Наприклад, (припускаємо, що у командній оболонці використовуються звичайні
лапки) така команда:
.Sp
.Vb 1
\& \-\-append\-line \*(Aq/etc/hosts:10.0.0.1 foo\*(Aq
.Ve
.Sp
додасть \f(CW\*(C`10.0.0.1 foo⏎\*(C'\fR або \f(CW\*(C`⏎10.0.0.1 foo⏎\*(C'\fR до файла; останній запис буде
додано, лише якщо наявний файл ще не закінчується символом нового рядка.
.Sp
\&\f(CW\*(C`⏎\*(C'\fR позначає символ нового рядка, конкретне значення якого визначається за
наявним вмістом файла, отже, команда обробляє файли однаково правильно для
варіантів із завершеннями рядка у форматах  Unix і Windows. Це працює і для
порожніх і ще не створених файлів.
.Sp
Щоб додати декілька рядків, скористайтеся тим самим параметром декілька
разів:
.Sp
.Vb 2
\& \-\-append\-line \*(Aq/etc/hosts:10.0.0.1 foo\*(Aq
\& \-\-append\-line \*(Aq/etc/hosts:10.0.0.2 bar\*(Aq
.Ve
.Sp
Щоб додати порожній рядок перед дописаним рядком, скористайтеся такою
конструкцією:
.Sp
.Vb 2
\& \-\-append\-line \*(Aq/etc/hosts:\*(Aq
\& \-\-append\-line \*(Aq/etc/hosts:10.0.0.1 foo\*(Aq
.Ve
.IP "\fB\-\-chmod\fR ПРАВА_ДОСТУПУ:ФАЙЛ" 4
.IX Item "--chmod ПРАВА_ДОСТУПУ:ФАЙЛ"
Змінити права доступу до файла \f(CW\*(C`ФАЙЛ\*(C'\fR на \f(CW\*(C`ПРАВА_ДОСТУПУ\*(C'\fR.
.Sp
\&\fIЗауваження\fR: типово \f(CW\*(C`ПРАВА_ДОСТУПУ\*(C'\fR записуються у десятковому форматі,
якщо ви не додасте початковий \f(CW0\fR , щоб вказати вісімкове число, тобто
скористаєтеся \f(CW0700\fR, а не \f(CW700\fR.
.IP "\fB\-\-commands\-from\-file\fR НАЗВА_ФАЙЛА" 4
.IX Item "--commands-from-file НАЗВА_ФАЙЛА"
Прочитати команди налаштовування з файла, по одній (разом із аргументами) на
рядок.
.Sp
Кожен рядок містить команду налаштовування та її аргументи, наприклад:
.Sp
.Vb 3
\& delete /якийсь/файл
\& install якийсь_пакунок
\& password якийсь\-користувач:password:його\-новий\-пароль
.Ve
.Sp
Порожні рядки ігноруються, а рядки, що починаються з \f(CW\*(C`#\*(C'\fR, є коментарями і
також ігноруються. Крім того, аргументи можна розділити на декілька рядків
додаванням \f(CW\*(C`\e\*(C'\fR (символу продовження) наприкінці рядка. Приклад:
.Sp
.Vb 2
\& edit /якийсь/файл:\e
\&   s/^OPT=.*/OPT=ok/
.Ve
.Sp
Команди обробляються у тому самому порядку, у якому їх вказано у файлі, так,
наче їх вказано як \fI\-\-delete /якийсь/файл\fR у рядку команди.
.IP "\fB\-\-copy\fR ДЖЕРЕЛО:ПРИЗНАЧЕННЯ" 4
.IX Item "--copy ДЖЕРЕЛО:ПРИЗНАЧЕННЯ"
Копіювати файли або каталоги рекурсивно у межах гостьової системи.
.Sp
Не можна використовувати символи\-замінники.
.IP "\fB\-\-copy\-in\fR ЛОКАЛЬНИЙ_ШЛЯХ:ВІДДАЛЕНИЙ_КАТАЛОГ" 4
.IX Item "--copy-in ЛОКАЛЬНИЙ_ШЛЯХ:ВІДДАЛЕНИЙ_КАТАЛОГ"
Скопіювати локальні файли або каталоги рекурсивно до образу диска,
розташувавши його у каталозі \f(CW\*(C`ВІДДАЛЕНИЙ_КАТАЛОГ\*(C'\fR (який має існувати).
.Sp
Не можна використовувати символи\-замінники.
.IP "\fB\-\-delete\fR ШЛЯХ" 4
.IX Item "--delete ШЛЯХ"
Вилучити файл з гостьової системи. Або вилучити каталог (і увесь його вміст,
рекурсивно).
.Sp
Ви можете скористатися символами\-замінниками у вказаному шляху. Не забудьте
екранувати символи\-замінники у командній оболонці основної системи, якщо це
потрібно. Приклад:
.Sp
.Vb 1
\& virt\-customize \-\-delete \*(Aq/var/log/*.log\*(Aq.
.Ve
.Sp
Див. також \fI\-\-upload\fR, \fI\-\-scrub\fR.
.IP "\fB\-\-edit\fR ФАЙЛ:ВИРАЗ" 4
.IX Item "--edit ФАЙЛ:ВИРАЗ"
Редагувати \f(CW\*(C`ФАЙЛ\*(C'\fR з використанням виразу Perl \f(CW\*(C`ВИРАЗ\*(C'\fR.
.Sp
Слід подбати про належне розставлення лапок у виразі, щоб запобігти його
зміні у командній оболонці.
.Sp
Зауважте, що цим параметром можна буде скористатися, лише якщо встановлено
Perl 5.
.Sp
Див. \*(L"NON-INTERACTIVE \s-1EDITING\*(R"\s0 in \fBvirt\-edit\fR\|(1).
.IP "\fB\-\-firstboot\fR СКРИПТ" 4
.IX Item "--firstboot СКРИПТ"
Встановити \f(CW\*(C`СКРИПТ\*(C'\fR у гостьовій системі і запустити його під час першого
завантаження гостьової системи (від імені root, у останній частині процесу
завантаження).
.Sp
До скрипту, після встановлення до гостьової системи, буде автоматично
застосовано команду chmod +x.
.Sp
Альтернативна версія \fI\-\-firstboot\-command\fR є такою самою, але зручно
включає команду у однорядковому скрипті.
.Sp
Можна вказати декілька параметрів \fI\-\-firstboot\fR. Їх буде виконано у тому
самому порядку, у якому їх вказано у рядку команди.
.Sp
Будь ласка, зверніться до розділу \*(L"СКРИПТИ ПЕРШОГО
ЗАВАНТАЖЕННЯ\*(R" in \fBvirt\-builder\fR\|(1), щоб ознайомитися із відомостями щодо скриптів першого
завантаження і проблемами у їх використанні.
.Sp
Див. також \fI\-\-run\fR.
.IP "\fB\-\-firstboot\-command\fR 'КОМАНДА+ПАРАМЕТРИ'" 4
.IX Item "--firstboot-command 'КОМАНДА+ПАРАМЕТРИ'"
Виконати команду (разом із аргументами) у гостьовій системі під час першого
завантаження гостьової системи (від імені root, у останній частині процесу
завантаження).
.Sp
Можна вказати декілька параметрів \fI\-\-firstboot\fR. Їх буде виконано у тому
самому порядку, у якому їх вказано у рядку команди.
.Sp
Будь ласка, зверніться до розділу \*(L"СКРИПТИ ПЕРШОГО
ЗАВАНТАЖЕННЯ\*(R" in \fBvirt\-builder\fR\|(1), щоб ознайомитися із відомостями щодо скриптів першого
завантаження і проблемами у їх використанні.
.Sp
Див. також \fI\-\-run\fR.
.IP "\fB\-\-firstboot\-install\fR ПАКУНОК,ПАКУНОК.." 4
.IX Item "--firstboot-install ПАКУНОК,ПАКУНОК.."
Встановити іменовані пакунки (список значень, відокремлених комами). Ці
пакунки буде встановлено під час першого завантаження гостьової системи за
допомогою програми для керування пакунків гостьової системи (наприклад, apt,
yum тощо) і з'єднання із мережею гостьової системи.
.Sp
Огляд різних способів встановлення пакунків наведено у розділі
\&\*(L"ВСТАНОВЛЕННЯ ПАКУНКІВ\*(R" in \fBvirt\-builder\fR\|(1).
.IP "\fB\-\-hostname\fR НАЗВА_ВУЗЛА" 4
.IX Item "--hostname НАЗВА_ВУЗЛА"
Встановити як назву вузла гостьової системи значення \f(CW\*(C`НАЗВА_ВУЗЛА\*(C'\fR. Якщо
потрібно, можете скористатися форматом із крапкою,
«назва_вузла.назва_домену» (\s-1FQDN\s0).
.IP "\fB\-\-install\fR ПАКУНОК,ПАКУНОК.." 4
.IX Item "--install ПАКУНОК,ПАКУНОК.."
Встановити іменовані пакунки (список значень, відокремлених комами). Ці
пакунки буде встановлено під час збирання образу за допомогою програми для
керування пакунків гостьової системи (наприклад, apt, yum тощо) і з'єднання
із мережею основної системи.
.Sp
Огляд різних способів встановлення пакунків наведено у розділі
\&\*(L"ВСТАНОВЛЕННЯ ПАКУНКІВ\*(R" in \fBvirt\-builder\fR\|(1).
.Sp
Див. також \fI\-\-update\fR, \fI\-\-uninstall\fR.
.IP "\fB\-\-link\fR ПРИЗНАЧЕННЯ:ПОСИЛАННЯ[:ПОСИЛАННЯ..]" 4
.IX Item "--link ПРИЗНАЧЕННЯ:ПОСИЛАННЯ[:ПОСИЛАННЯ..]"
Створити символічне посилання або декілька посилань у гостьовій системі так,
щоб вони з \f(CW\*(C`ПОСИЛАННЯ\*(C'\fR вказували на \f(CW\*(C`ПРИЗНАЧЕННЯ\*(C'\fR.
.IP "\fB\-\-mkdir\fR КАТАЛОГ" 4
.IX Item "--mkdir КАТАЛОГ"
Створити каталог у гостьовій системі.
.Sp
Використовується \f(CW\*(C`mkdir \-p\*(C'\fR, отже буде створено усі проміжні
каталоги. Також команда працює, якщо каталог вже існує.
.IP "\fB\-\-move\fR ДЖЕРЕЛО:ПРИЗНАЧЕННЯ" 4
.IX Item "--move ДЖЕРЕЛО:ПРИЗНАЧЕННЯ"
Пересунути файли або каталоги у межах гостьової системи.
.Sp
Не можна використовувати символи\-замінники.
.IP "\fB\-\-no\-logfile\fR" 4
.IX Item "--no-logfile"
Витерти \f(CW\*(C`builder.log\*(C'\fR (файл журналу із командами збирання) з образу після
завершення збирання. Якщо ви не хочете явним чином показувати, як було
зібрано образ, скористайтеся цим параметром.
.Sp
Див. також \*(L"\s-1LOG FILE\*(R"\s0.
.IP "\fB\-\-password\fR КОРИСТУВАЧ:ВАРІАНТ" 4
.IX Item "--password КОРИСТУВАЧ:ВАРІАНТ"
Встановити пароль для користувача \f(CW\*(C`КОРИСТУВАЧ\*(C'\fR. (Зауважте, що за допомогою
цього параметра \fIне можна\fR створювати облікові записи користувачів.)
.Sp
Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів
користувачів описано у розділі \*(L"КОРИСТУВАЧІ І ПАРОЛІ\*(R" in \fBvirt\-builder\fR\|(1).
.IP "\fB\-\-password\-crypto\fR md5|sha256|sha512" 4
.IX Item "--password-crypto md5|sha256|sha512"
Якщо змінюється чи встановлюється пароль для гостьової системи, за допомогою
цього параметра можна встановити шифрування для цього пароля у значення
\&\f(CW\*(C`md5\*(C'\fR, \f(CW\*(C`sha256\*(C'\fR або \f(CW\*(C`sha512\*(C'\fR.
.Sp
Для використання значень \f(CW\*(C`sha256\*(C'\fR та \f(CW\*(C`sha512\*(C'\fR має бути встановлено glibc
≥ 2.7 (перевірте у \fBcrypt\fR\|(3) всередині гостьової системи).
.Sp
\&\f(CW\*(C`md5\*(C'\fR працюватиме з відносно давніми гостьовими системами Linux
(наприкладRHEL 3), але є незахищеним щодо новітніх способів атак.
.Sp
Типовим способом шифрування є \f(CW\*(C`sha512\*(C'\fR. Він використовується, якщо
libguestfs вдасться виявити у гостьовій системі підтримку \s-1SHA\-512.\s0 Якщо
такої підтримки не буде виявлено, використовуватиметься \f(CW\*(C`md5\*(C'\fR. За допомогою
цього параметра ви можете перевизначити автоматично визначений libguestfs
спосіб шифрування.
.Sp
Зауважте, що це не змінить типового шифрування, яке використовується
гостьовою системою, коли ви створюєте у ній нові облікові записи
користувачів. Якщо ви хочете змінити це шифрування, вам слід скористатися
параметром \fI\-\-edit\fR для внесення змін до \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR
(Fedora, \s-1RHEL\s0) або \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (Debian, Ubuntu).
.IP "\fB\-\-root\-password\fR ВАРІАНТ" 4
.IX Item "--root-password ВАРІАНТ"
Встановити пароль користувача root.
.Sp
Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR та способи налаштовування облікових записів
користувачів описано у розділі \*(L"КОРИСТУВАЧІ І ПАРОЛІ\*(R" in \fBvirt\-builder\fR\|(1).
.Sp
Зауваження: якщо у virt-builder ви \fIне встановите\fR \fI\-\-root\-password\fR, для
гостьової системи буде використано \fIвипадковий\fR пароль root.
.IP "\fB\-\-run\fR СКРИПТ" 4
.IX Item "--run СКРИПТ"
Виконати скрипт оболонки (або будь\-яку програму), яка називається \f(CW\*(C`СКРИПТ\*(C'\fR
у образі диска. Скрипт буде запущено у віртуалізованому режимі у малій
допоміжній системі, у пісочниці гостьової файлової системи.
.Sp
Для скрипту буде автоматично використано команду chmod +x.
.Sp
Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене
мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати
диски з даними (наприклад, файли \s-1ISO\s0), як ще один спосіб надання даних
(наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у
з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з
даними (\fI\-\-upload\fR).
.Sp
Можна вказати декілька параметрів \fI\-\-run\fR. Їх буде виконано у тому самому
порядку, у якому їх вказано у рядку команди.
.Sp
Див. також \fI\-\-firstboot\fR, \fI\-\-attach\fR, \fI\-\-upload\fR.
.IP "\fB\-\-run\-command\fR 'КОМАНДА+ПАРАМЕТРИ'" 4
.IX Item "--run-command 'КОМАНДА+ПАРАМЕТРИ'"
Виконати команду із аргументами у образі диска. Команду буде виконано у
віртуалізованому режимі у малій допоміжній системі, у пісочниці гостьової
файлової системи.
.Sp
Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене
мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати
диски з даними (наприклад, файли \s-1ISO\s0), як ще один спосіб надання даних
(наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у
з'єднанні із мережею (\fI\-\-attach\fR). Також ви можете вивантажувати файли з
даними (\fI\-\-upload\fR).
.Sp
Можна вказати декілька параметрів \fI\-\-run\-command\fR. Їх буде виконано у тому
самому порядку, у якому їх вказано у рядку команди.
.Sp
Див. також \fI\-\-firstboot\fR, \fI\-\-attach\fR, \fI\-\-upload\fR.
.IP "\fB\-\-scrub\fR ФАЙЛ" 4
.IX Item "--scrub ФАЙЛ"
Витерти файл з гостьової системи. Подібне до \fI\-\-delete\fR, окрім того, що:
.RS 4
.IP "\(bu" 4
Витирає дані так, що їх не можна буде відновити з гостьової системи.
.IP "\(bu" 4
Не може вилучати каталоги, лише звичайні файли.
.RE
.RS 4
.RE
.IP "\fB\-\-selinux\-relabel\fR" 4
.IX Item "--selinux-relabel"
Повторно встановити мітки для файлів у гостьовій системі так, щоб вони були
правильними з точки зору SELinux.
.Sp
Якщо буде використано цей параметр, програма спробує змінити мітки файлів
негайно, але якщо цього зробити не вдасться, вона змінить часову мітку файла
\&\fI/.autorelabel\fR на образі, щоб дію зі зміни міток було заплановано на
наступне завантаження образу.
.Sp
Вам слід використовувати цей параметр лише для гостьових систем із
підтримкою SELinux.
.IP "\fB\-\-sm\-attach\fR ВАРІАНТ" 4
.IX Item "--sm-attach ВАРІАНТ"
Долучити систему до буфера передплати за допомогою \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі
\&\*(L"SUBSCRIPTION-MANAGER\*(R" in \fBvirt\-builder\fR\|(1).
.IP "\fB\-\-sm\-credentials\fR ВАРІАНТ" 4
.IX Item "--sm-credentials ВАРІАНТ"
Встановити реєстраційні дані для \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі
\&\*(L"SUBSCRIPTION-MANAGER\*(R" in \fBvirt\-builder\fR\|(1).
.IP "\fB\-\-sm\-register\fR" 4
.IX Item "--sm-register"
Зареєструвати гостьову систему за допомогою \f(CW\*(C`subscription\-manager\*(C'\fR.
.Sp
Потребує встановлення реєстраційних даних за допомогою \fI\-\-sm\-credentials\fR.
.IP "\fB\-\-sm\-remove\fR" 4
.IX Item "--sm-remove"
Вилучити усі передплати з гостьової системи за допомогою
\&\f(CW\*(C`subscription\-manager\*(C'\fR.
.IP "\fB\-\-sm\-unregister\fR" 4
.IX Item "--sm-unregister"
Зняти гостьову систему з реєстрації за допомогою \f(CW\*(C`subscription\-manager\*(C'\fR.
.IP "\fB\-\-ssh\-inject\fR КОРИСТУВАЧ[:ВАРІАНТ]" 4
.IX Item "--ssh-inject КОРИСТУВАЧ[:ВАРІАНТ]"
Вставити ключ ssh так, щоб вказаний \f(CW\*(C`КОРИСТУВАЧ\*(C'\fR зміг увійти до системи з
використанням ssh без потреби у визначенні пароля. Запис користувача
\&\f(CW\*(C`КОРИСТУВАЧ\*(C'\fR має вже існувати у гостьовій системі.
.Sp
Формат поля \f(CW\*(C`ВАРІАНТ\*(C'\fR описано у розділі \*(L"КЛЮЧІ \s-1SSH\*(R"\s0 in \fBvirt\-builder\fR\|(1).
.Sp
Ви можете додати декілька параметрів \fI\-\-ssh\-inject\fR для різних
користувачів, а також для додавання декількох ключів для кожного з
користувачів.
.IP "\fB\-\-timezone\fR ЧАСОВИЙ_ПОЯС" 4
.IX Item "--timezone ЧАСОВИЙ_ПОЯС"
Встановити типовий часовий пояс гостьової системи у значення
\&\f(CW\*(C`ЧАСОВИЙ_ПОЯС\*(C'\fR. Скористайтеся рядком місця у форматі \f(CW\*(C`Europe/London\*(C'\fR
.IP "\fB\-\-touch\fR ФАЙЛ" 4
.IX Item "--touch ФАЙЛ"
Ця команда виконує подібну до \fBtouch\fR\|(1) дію над файлом \f(CW\*(C`ФАЙЛ\*(C'\fR.
.IP "\fB\-\-truncate\fR ФАЙЛ" 4
.IX Item "--truncate ФАЙЛ"
Ця команда обрізає файл \f(CW\*(C`ФАЙЛ\*(C'\fR до нульової довжини. Для її успішного
виконання файл має існувати.
.IP "\fB\-\-truncate\-recursive\fR ШЛЯХ" 4
.IX Item "--truncate-recursive ШЛЯХ"
Ця команда рекурсивно обрізає усі файли у каталозі \f(CW\*(C`ШЛЯХ\*(C'\fR до нульової
довжини.
.IP "\fB\-\-uninstall\fR ПАКУНОК,ПАКУНОК.." 4
.IX Item "--uninstall ПАКУНОК,ПАКУНОК.."
Вилучити іменовані пакунки (список значень, відокремлених комами). Ці
пакунки буде вилучено під час збирання образу за допомогою програми для
керування пакунків гостьової системи (наприклад, apt, yum тощо). З метою
виконання запиту також може бути вилучено пакунки, залежні від вилучених
пакунків.
.Sp
Див. також \fI\-\-install\fR, \fI\-\-update\fR.
.IP "\fB\-\-update\fR" 4
.IX Item "--update"
Виконує еквівалент \f(CW\*(C`yum update\*(C'\fR, \f(CW\*(C`apt\-get upgrade\*(C'\fR або якоїсь іншої
команди, яка потрібна для оновлення пакунків, які вже встановлено у шаблоні,
до найсвіжіших версій.
.Sp
Див. також \fI\-\-install\fR, \fI\-\-uninstall\fR.
.IP "\fB\-\-upload\fR ФАЙЛ:ПРИЗНАЧЕННЯ" 4
.IX Item "--upload ФАЙЛ:ПРИЗНАЧЕННЯ"
Вивантажити локальний файл \f(CW\*(C`ФАЙЛ\*(C'\fR до призначення \f(CW\*(C`ПРИЗНАЧЕННЯ\*(C'\fR на образі
диска. Буде збережено власника і права доступу, отже вам слід вказати такі
значення для цих параметрів, які мають бути на остаточному образі диска.
.Sp
Значенням параметра \f(CW\*(C`ПРИЗНАЧЕННЯ\*(C'\fR може бути назва остаточного файла. Цим
можна скористатися для перейменовування файла під час вивантаження.
.Sp
Якщо значенням параметра \f(CW\*(C`ПРИЗНАЧЕННЯ\*(C'\fR є назва каталогу (який вже має
існувати у гостьовій системі), файл буде вивантажено до вказаного каталогу,
назву файла з локальної файлової системи буде збережено.
.Sp
Див. також \fI\-\-mkdir\fR, \fI\-\-delete\fR, \fI\-\-scrub\fR.
.IP "\fB\-\-write\fR ФАЙЛ:ДАНІ" 4
.IX Item "--write ФАЙЛ:ДАНІ"
Записати \f(CW\*(C`ДАНІ\*(C'\fR до файла \f(CW\*(C`ФАЙЛ\*(C'\fR.
.SH "SELINUX"
.IX Header "SELINUX"
Для гостьових систем, у яких використовується SELinux, може знадобитися
спеціальна обробка, якщо використовуються дії, які створюють нові файли або
вносять зміни до наявних файлів.
.PP
Докладніший опис наведено у розділі \*(L"\s-1SELINUX\*(R"\s0 in \fBvirt\-builder\fR\|(1).
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
Ця програма повертає 0, якщо роботу виконано успішно, і 1, якщо сталися
помилки.
.SH "ЗМІННІ СЕРЕДОВИЩА"
.IX Header "ЗМІННІ СЕРЕДОВИЩА"
.ie n .IP """VIRT_TOOLS_DATA_DIR""" 4
.el .IP "\f(CWVIRT_TOOLS_DATA_DIR\fR" 4
.IX Item "VIRT_TOOLS_DATA_DIR"
Ця змінна визначає каталог, у якому містяться файли даних, які
використовуються для встановлення Windows з першим завантаженням.
.Sp
Зазвичай, потреби у встановленні власного значення немає. Якщо значення не
встановлено, буде використано вбудоване типове значення (щось схоже на
\&\fI/usr/share/virt\-tools\fR).
.Sp
Цей каталог може містити такі файли:
.RS 4
.IP "\fIrhsrvany.exe\fR" 4
.IX Item "rhsrvany.exe"
Це виконуваний файл для Windows RHSrvAny, який використовується для
встановлення скрипту «firstboot» у гостьові системи Windows. Він
знадобиться, якщо ви маєте намір використовувати параметри \fI\-\-firstboot\fR і
\&\fI\-\-firstboot\-command\fR для гостьових операційних систем Windows.
.Sp
Див. також \f(CW\*(C`https://github.com/rwmjones/rhsrvany\*(C'\fR
.IP "\fIpvvxsvc.exe\fR" 4
.IX Item "pvvxsvc.exe"
Це виконуваний файл Windows, що постачається разом із \s-1VMDP SUSE,\s0
використовується для встановлення скрипту «firstboot» у гостьові системи
Windows. Він знадобиться, якщо ви маєте намір використовувати параметри
\&\fI\-\-firstboot\fR і \fI\-\-firstboot\-command\fR для гостьових операційних систем
Windows.
.RE
.RS 4
.RE
.PP
Опис інших змінних середовища наведено у розділі \*(L"\s-1ENVIRONMENT
VARIABLES\*(R"\s0 in \fBguestfs\fR\|(3).
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-builder\fR\|(1), \fBvirt\-clone\fR\|(1),
\&\fBvirt\-rescue\fR\|(1), \fBvirt\-resize\fR\|(1), \fBvirt\-sparsify\fR\|(1),
\&\fBvirt\-sysprep\fR\|(1), \fBvirsh\fR\|(1), \fBlvcreate\fR\|(8), \fBqemu\-img\fR\|(1),
\&\fBscrub\fR\|(1), http://libguestfs.org/, http://libvirt.org/.
.SH "АВТОРИ"
.IX Header "АВТОРИ"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2011\-2020 Red Hat Inc.
.SH "LICENSE"
.IX Header "LICENSE"
This program is free software; you can redistribute it and/or modify it
under the terms of the \s-1GNU\s0 General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
.PP
This program is distributed in the hope that it will be useful, but
\&\s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0  See the \s-1GNU\s0
General Public License for more details.
.PP
You should have received a copy of the \s-1GNU\s0 General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, \s-1MA 02110\-1301 USA.\s0
.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.