Scroll to navigation

libguestfs-make-fixed-appliance(1) Virtualization Support libguestfs-make-fixed-appliance(1)

НАЗВА

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

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

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

ОПИС

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

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

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

  • Ви хочете створити самодостатню базову систему libguestfs, яку можна скопіювати на інший комп'ютер або платформу, де не передбачено підтримки supermin(1).
  • На вашому комп'ютері декілька користувачів і ви хочете уникнути дублювання сховища даних або додаткової затримки через наявність декількох кешованих копій базової системи.
  • Вам потрібна дуже передбачувана щодо швидкодії система з libguestfs (див. guestfs-performance(1)).

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

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

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

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

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

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

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

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

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

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

     libguestfs-make-fixed-appliance --xz
        

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

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

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

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

    Зауважте, що "appliance/root" є розрідженим файлом, тому слід бути обережним під час його копіювання.

ПАРАМЕТРИ

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

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

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

Базова система є повним бінарним дистрибутивом Linux. Якщо ви поширюватимете його, можливо, вам доведеться поширювати також відповідні файли з початковим кодом, щоб зберегти сумісність із умовами ліцензування програмного забезпечення у базовій системі (зокрема GNU General Public License).

СТАН ВИХОДУ

libguestfs-make-fixed-appliance повертає 0, якщо базову систему було зібрано без помилок.

ЗМІННІ СЕРЕДОВИЩА

Повний список змінних середовища, які можуть вплинути на роботу libguestfs, можна знайти на сторінці підручника guestfs(3).

ТАКОЖ ПЕРЕГЛЯНЬТЕ

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

АВТОРИ

Richard W.M. Jones ("rjones at redhat dot com")

АВТОРСЬКІ ПРАВА

Copyright (C) 2009-2020 Red Hat Inc.

LICENSE

BUGS

To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

When reporting a bug, please supply:

  • The version of libguestfs.
  • Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
  • Describe the bug accurately and give a way to reproduce it.
  • Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.
2021-01-05 libguestfs-1.44.0