
=begin коментар

libguestfs generated file
 WARNING: THIS FILE IS GENERATED FROM THE FOLLOWING FILES:
          generator/customize.ml
          and from the code in the generator/ subdirectory.
 ANY CHANGES YOU MAKE TO THIS FILE WILL BE LOST.

 © Red Hat Inc., 2009–2025

 Ця програма є вільним програмним забезпеченням; ви можете поширювати та/або
 змінювати її за умов дотримання GNU General Public License утому вигляді, що
 оприлюднений Free Software Foundation; версії 2 цієї Ліцензії, або (якщо
 забажаєте) будь-якої випущеної пізніше.

 Ця програма поширюється у сподіванні, що вона буде корисною, але БЕЗ
 БУДЬ-ЯКИХ ГАРАНТІЙНИХ ЗОБОВ’ЯЗАНЬ; навіть без очевидної гарантії
 ПРАЦЕЗДАТНОСТІ або ПРИДАТНОСТІ ДЛЯ ВИКОРИСТАННЯ З ПЕВНОЮ МЕТОЮ. Докладніше
 про це можна дізнатися з GNU General Public License.

 Ви маєте отримати копію GNU General Public License разом з цією програмою;
 якщо це не так, повідомте про факт за адресою Free Software Foundation, Inc.,
 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

=end коментар

=over 4

=item B<--append-line> ФАЙЛ:РЯДОК

Дописати один рядок тексту до файла C<ФАЙЛ>. Якщо файл ще не завершується порожнім рядком, такий рядок буде додано перед дописаним. Крім того, автоматично буде дописано символ нового рядка наприкінці рядка C<РЯДОК>.

Наприклад, (припускаємо, що у командній оболонці використовуються звичайні лапки) така команда:

 --append-line '/etc/hosts:10.0.0.1 foo'

додасть C<10.0.0.1 foo⏎> або C<⏎10.0.0.1 foo⏎> до файла; останній запис буде додано, лише якщо наявний файл ще не закінчується символом нового рядка.

C<⏎> позначає символ нового рядка, конкретне значення якого визначається за наявним вмістом файла, отже, команда обробляє файли однаково правильно для варіантів із завершеннями рядка у форматах  Unix і Windows. Це працює і для порожніх і ще не створених файлів.

Щоб додати декілька рядків, скористайтеся тим самим параметром декілька разів:

 --append-line '/etc/hosts:10.0.0.1 foo'
 --append-line '/etc/hosts:10.0.0.2 bar'

Щоб додати порожній рядок перед дописаним рядком, скористайтеся такою конструкцією:

 --append-line '/etc/hosts:'
 --append-line '/etc/hosts:10.0.0.1 foo'

=item B<--chmod> ПРАВА_ДОСТУПУ:ФАЙЛ

Змінити права доступу до файла C<ФАЙЛ> на C<ПРАВА_ДОСТУПУ>.

I<Зауваження>: типово C<ПРАВА_ДОСТУПУ> записуються у десятковому форматі, якщо ви не додасте початковий C<0> , щоб вказати вісімкове число, тобто скористаєтеся C<0700>, а не C<700>.

=item B<--chown> UID:GID:ШЛЯХ

Змінити користувача і ідентифікатор групи власника для файла або каталогу у гостьовій системі. Зауваження:

=over 4

=item *

Можна використовувати лише числові ідентифікатори користувача і групи, ці ідентифікатори у гостьовій системі можуть не збігатися з ідентифікаторами в основній.

=item *

Це не працюватиме у гостьових системах Windows.

=back

Приклад:

 virt-customize --chown '0:0:/var/log/audit.log'

Див. також I<--upload>.

=item B<--commands-from-file> НАЗВА_ФАЙЛА

Прочитати команди налаштовування з файла, по одній (разом із аргументами) на рядок.

Кожен рядок містить команду налаштовування та її аргументи, наприклад:

 delete /якийсь/файл
 install якийсь_пакунок
 password якийсь-користувач:password:його-новий-пароль

Порожні рядки ігноруються, а рядки, що починаються з C<#>, є коментарями і також ігноруються. Крім того, аргументи можна розділити на декілька рядків додаванням C<\> (символу продовження) наприкінці рядка. Приклад:

 edit /якийсь/файл:\
   s/^OPT=.*/OPT=ok/

Команди обробляються у тому самому порядку, у якому їх вказано у файлі, так, наче їх вказано як I<--delete /якийсь/файл> у рядку команди.

=item B<--copy> ДЖЕРЕЛО:ПРИЗНАЧЕННЯ

Копіювати файли або каталоги рекурсивно у межах гостьової системи.

Не можна використовувати символи-замінники.

=item B<--copy-in> ЛОКАЛЬНИЙ_ШЛЯХ:ВІДДАЛЕНИЙ_КАТАЛОГ

Скопіювати локальні файли або каталоги рекурсивно до образу диска, розташувавши його у каталозі C<ВІДДАЛЕНИЙ_КАТАЛОГ> (який має існувати).

Не можна використовувати символи-замінники.

=item B<--delete> ШЛЯХ

Вилучити файл з гостьової системи. Або вилучити каталог (і увесь його вміст, рекурсивно).

Ви можете скористатися символами-замінниками у вказаному шляху. Не забудьте екранувати символи-замінники у командній оболонці основної системи, якщо це потрібно. Приклад:

 virt-customize --delete '/var/log/*.log'.

Див. також I<--upload>, I<--scrub>.

=item B<--edit> ФАЙЛ:ВИРАЗ

Редагувати C<ФАЙЛ> з використанням виразу Perl C<ВИРАЗ>.

Слід подбати про належне розставлення лапок у виразі, щоб запобігти його зміні у командній оболонці.

Зауважте, що цим параметром можна буде скористатися, лише якщо встановлено Perl 5.

Див. L<virt-edit(1)/NON-INTERACTIVE EDITING>.

=item B<--firstboot> СКРИПТ

Встановити C<СКРИПТ> у гостьовій системі і запустити його під час першого завантаження гостьової системи (від імені root, у останній частині процесу завантаження).

До скрипту, після встановлення до гостьової системи, буде автоматично застосовано команду chmod +x.

Альтернативна версія I<--firstboot-command> є такою самою, але зручно включає команду у однорядковому скрипті.

Можна вказати декілька параметрів I<--firstboot>. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.

See also: L<virt-customize(1)/FIRSTBOOT>, I<--run>.

=item B<--firstboot-command> 'КОМАНДА+ПАРАМЕТРИ'

Виконати команду (разом із аргументами) у гостьовій системі під час першого завантаження гостьової системи (від імені root, у останній частині процесу завантаження).

Можна вказати декілька параметрів I<--firstboot>. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.

See also: L<virt-customize(1)/FIRSTBOOT>, I<--run>.

=item B<--firstboot-install> ПАКУНОК,ПАКУНОК..

Встановити іменовані пакунки (список значень, відокремлених комами). Ці пакунки буде встановлено під час першого завантаження гостьової системи за допомогою програми для керування пакунків гостьової системи (наприклад, apt, yum тощо) і з'єднання із мережею гостьової системи.

Огляд різних способів встановлення пакунків наведено у розділі L<virt-builder(1)/ВСТАНОВЛЕННЯ ПАКУНКІВ>.

=item B<--hostname> НАЗВА_ВУЗЛА

Встановити як назву вузла гостьової системи значення C<НАЗВА_ВУЗЛА>. Якщо потрібно, можете скористатися форматом із крапкою, «назва_вузла.назва_домену» (FQDN).

=item B<--install> ПАКУНОК,ПАКУНОК..

Встановити іменовані пакунки (список значень, відокремлених комами). Ці пакунки буде встановлено під час збирання образу за допомогою програми для керування пакунків гостьової системи (наприклад, apt, yum тощо) і з'єднання із мережею основної системи.

Огляд різних способів встановлення пакунків наведено у розділі L<virt-builder(1)/ВСТАНОВЛЕННЯ ПАКУНКІВ>.

Див. також I<--update>, I<--uninstall>.

=item B<--link> ПРИЗНАЧЕННЯ:ПОСИЛАННЯ[:ПОСИЛАННЯ..]

Створити символічне посилання або декілька посилань у гостьовій системі так, щоб вони з C<ПОСИЛАННЯ> вказували на C<ПРИЗНАЧЕННЯ>.

=item B<--mkdir> КАТАЛОГ

Створити каталог у гостьовій системі.

Використовується S<C<mkdir -p>>, отже буде створено усі проміжні каталоги. Також команда працює, якщо каталог вже існує.

=item B<--move> ДЖЕРЕЛО:ПРИЗНАЧЕННЯ

Пересунути файли або каталоги у межах гостьової системи.

Не можна використовувати символи-замінники.

=item B<--no-logfile>

Витерти C<builder.log> (файл журналу із командами збирання) з образу після завершення збирання. Якщо ви не хочете явним чином показувати, як було зібрано образ, скористайтеся цим параметром.

Див. також L</LOG FILE>.

=item B<--no-selinux-relabel>

Не намагатися виправити мітки SELinux файлів у гостьовій системі.

У гостьових системах, де передбачено підтримку SELinux, під час налаштовування буде автоматично змінено мітки файлів так, щоб вони мали належні мітки SELinux. Зміну міток буде виконано негайно, але якщо цього зробити не вдасться, вона змінить часову мітку файла F</.autorelabel> на образі, щоб дію зі зміни міток було заплановано на наступне завантаження образу. Цей параметр вимикає автоматичну зміну міток.

Параметр ні на що не вплине у гостьових системах, де не передбачено підтримки SELinux.

=item B<--password> КОРИСТУВАЧ:ВАРІАНТ

Встановити пароль для користувача C<КОРИСТУВАЧ>. (Зауважте, що за допомогою цього параметра I<не можна> створювати облікові записи користувачів.)

Формат поля C<ВАРІАНТ> та способи налаштовування облікових записів користувачів описано у розділі L<virt-builder(1)/КОРИСТУВАЧІ І ПАРОЛІ>.

=item B<--password-crypto> md5|sha256|sha512

Якщо змінюється чи встановлюється пароль для гостьової системи, за допомогою цього параметра можна встановити шифрування для цього пароля у значення C<md5>, C<sha256> або C<sha512>.

Для використання значень C<sha256> та C<sha512> має бути встановлено glibc E<ge> 2.7 (перевірте у crypt(3) всередині гостьової системи).

C<md5> працюватиме з відносно давніми гостьовими системами Linux (наприкладRHEL 3), але є незахищеним щодо новітніх способів атак.

Типовим способом шифрування є C<sha512>. Він використовується, якщо libguestfs вдасться виявити у гостьовій системі підтримку SHA-512. Якщо такої підтримки не буде виявлено, використовуватиметься C<md5>. За допомогою цього параметра ви можете перевизначити автоматично визначений libguestfs спосіб шифрування.

Зауважте, що це не змінить типового шифрування, яке використовується гостьовою системою, коли ви створюєте у ній нові облікові записи користувачів. Якщо ви хочете змінити це шифрування, вам слід скористатися параметром I<--edit> для внесення змін до C</etc/sysconfig/authconfig> (Fedora, RHEL) або C</etc/pam.d/common-password> (Debian, Ubuntu).

=item B<--root-password> ВАРІАНТ

Встановити пароль користувача root.

Формат поля C<ВАРІАНТ> та способи налаштовування облікових записів користувачів описано у розділі L<virt-builder(1)/КОРИСТУВАЧІ І ПАРОЛІ>.

Зауваження: якщо у virt-builder ви I<не встановите> I<--root-password>, для гостьової системи буде використано I<випадковий> пароль root.

=item B<--run> СКРИПТ

Виконати скрипт оболонки (або будь-яку програму), яка називається C<СКРИПТ> у образі диска. Скрипт буде запущено у віртуалізованому режимі у малій допоміжній системі, у пісочниці гостьової файлової системи.

Для скрипту буде автоматично використано команду chmod +x.

Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли ISO), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (I<--attach>). Також ви можете вивантажувати файли з даними (I<--upload>).

Можна вказати декілька параметрів I<--run>. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.

Див. також I<--firstboot>, I<--attach>, I<--upload>.

=item B<--run-command> 'КОМАНДА+ПАРАМЕТРИ'

Виконати команду із аргументами у образі диска. Команду буде виконано у віртуалізованому режимі у малій допоміжній системі, у пісочниці гостьової файлової системи.

Якщо у libguestfs передбачено підтримку цього, буде доступним обмежене мережеве з'єднання, але лише для вихідних з'єднань. Ви також можете долучати диски з даними (наприклад, файли ISO), як ще один спосіб надання даних (наприклад, пакунків із програмним забезпеченням) для скрипту без потреби у з'єднанні із мережею (I<--attach>). Також ви можете вивантажувати файли з даними (I<--upload>).

Можна вказати декілька параметрів I<--run-command>. Їх буде виконано у тому самому порядку, у якому їх вказано у рядку команди.

Див. також I<--firstboot>, I<--attach>, I<--upload>.

=item B<--scrub> ФАЙЛ

Витерти файл з гостьової системи. Подібне до I<--delete>, окрім того, що:

=over 4

=item *

Витирає дані так, що їх не можна буде відновити з гостьової системи.

=item *

Не може вилучати каталоги, лише звичайні файли.

=back

=item B<--selinux-relabel>

Це параметр, який залишено для сумісності. Він ні на що не впливає.

=item B<--ssh-inject> КОРИСТУВАЧ[:ВАРІАНТ]

Вставити ключ ssh так, щоб вказаний C<КОРИСТУВАЧ> зміг увійти до системи з використанням ssh без потреби у визначенні пароля. Запис користувача C<КОРИСТУВАЧ> має вже існувати у гостьовій системі.

Формат поля C<ВАРІАНТ> описано у розділі L<virt-builder(1)/КЛЮЧІ SSH>.

Ви можете додати декілька параметрів I<--ssh-inject> для різних користувачів, а також для додавання декількох ключів для кожного з користувачів.

=item B<--tar-in> ФАЙЛ-TAR:ВІДДАЛЕНИЙ-КАТАЛОГ

Скопіювати локальні файли або каталоги з локального файла tar із назвою C<ФАЙЛ-TAR> рекурсивно до образу диска, розташувавши його у каталозі C<ВІДДАЛЕНИЙ_КАТАЛОГ> (який має існувати). Зауважте, що файл tar має бути не стиснуто (файли F<.tar.gz> не працюватимуть)

=item B<--timezone> ЧАСОВИЙ_ПОЯС

Встановити типовий часовий пояс гостьової системи у значення C<ЧАСОВИЙ_ПОЯС>. Скористайтеся рядком місця у форматі C<Europe/London>

=item B<--touch> ФАЙЛ

Ця команда виконує подібну до L<touch(1)> дію над файлом C<ФАЙЛ>.

=item B<--truncate> ФАЙЛ

Ця команда обрізає файл C<ФАЙЛ> до нульової довжини. Для її успішного виконання файл має існувати.

=item B<--truncate-recursive> ШЛЯХ

Ця команда рекурсивно обрізає усі файли у каталозі C<ШЛЯХ> до нульової довжини.

=item B<--uninstall> ПАКУНОК,ПАКУНОК..

Вилучити іменовані пакунки (список значень, відокремлених комами). Ці пакунки буде вилучено під час збирання образу за допомогою програми для керування пакунків гостьової системи (наприклад, apt, yum тощо). З метою виконання запиту також може бути вилучено пакунки, залежні від вилучених пакунків.

Див. також I<--install>, I<--update>.

=item B<--update>

Виконує еквівалент C<yum update>, C<apt-get upgrade> або якоїсь іншої команди, яка потрібна для оновлення пакунків, які вже встановлено у шаблоні, до найсвіжіших версій.

Див. також I<--install>, I<--uninstall>.

=item B<--upload> ФАЙЛ:ПРИЗНАЧЕННЯ

Вивантажити локальний файл C<ФАЙЛ> до призначення C<ПРИЗНАЧЕННЯ> на образі диска. Буде збережено власника і права доступу, отже вам слід вказати такі значення для цих параметрів, які мають бути на остаточному образі диска.

Значенням параметра C<ПРИЗНАЧЕННЯ> може бути назва остаточного файла. Цим можна скористатися для перейменовування файла під час вивантаження.

Якщо значенням параметра C<ПРИЗНАЧЕННЯ> є назва каталогу (який вже має існувати у гостьовій системі), файл буде вивантажено до вказаного каталогу, назву файла з локальної файлової системи буде збережено.

Див. також I<--mkdir>, I<--delete>, I<--scrub>.

=item B<--write> ФАЙЛ:ДАНІ

Записати C<ДАНІ> до файла C<ФАЙЛ>.

=back

