Provided by: libguestfs0t64_1.52.2-3ubuntu2_amd64 
НАЗВА
guestfs-release-notes - нотатки щодо випусків libguestfs
НОТАТКИ ЩОДО ВИПУСКУ LIBGUESTFS 1.26
Ці нотатки щодо випуску стосуються лише відмінностей від попереднього стабільного випуску
(1.24.0). Докладний журнал змін є частиною журналу змін сховища git. Його також наведено у
файлі ChangeLog, який є частиною архіву tar із кодом бібліотеки.
Нові можливості
Інструменти
virt-customize(1) — новий інструмент для налаштовування образів дисків віртуальної машини.
За його допомогою ви можете встановлювати пакунки, редагувати файли налаштувань, запускати
скрипти, встановлювати паролі тощо. virt-builder(1) і virt-sysprep(1) використовують virt-
customize. Параметри командного рядка усіх цих інструментів тепер є ідентичними.
virt-diff(1) — новий інструмент для показу відмінностей між файловими системами двох
віртуальних машин. Основним його призначенням є показ файлів, які було змінено між двома
знімками віртуальної машини.
Значно розширено можливості virt-builder(1). Передбачено набагато більше способів
налаштовування віртуальної машини. Можливе отримання шаблонів з декількох сховищ.
Паралелізована внутрішня реалізація xzcat пришвидшує розпаковування шаблонів. Virt-builder
використовує оптимізований планувальник для вибору найшвидшого способу побудови
віртуальної машини. Тепер простіше користуватися virt-builder з інших програм. Додано
підтримку перекладу метаданих. Реалізовано ефективнішу процедуру повторного встановлення
міток SELinux для файлів. Можлива побудова гостьових систем для декількох архітектур.
Поліпшено повідомлення щодо помилок. (Pino Toscano)
У virt-sparsify(1) передбачено новий параметр --in-place. Його використання призводить до
розрідження системи на місці (без її копіювання), що набагато пришвидшує виконання
завдання. (Значна допомога з боку Paolo Bonzini)
virt-sysprep(1) може вилучати і витирати файли під керуванням користувача. Ви можете
заблокувати облікові записи користувачів або встановити випадкові паролі для облікових
записів. Можна вилучати більше файлів журналу. Можна скасовувати передплату гостьових
систем у Red Hat Subscription Manager. Новий гнучкий спосіб вмикати і вимикати дії.
(Wanlong Gao, Pino Toscano)
У virt-win-reg(1) передбачено можливість використовувати адреси для визначення віддалених
образів дисків.
virt-format(1) тепер може повертати отримане додаткове вільне місце основній системі.
guestfish(1) має додаткові змінні середовища для надання можливості точнішого
налаштовування за допомогою запиту "><fs>". Guestfish тепер читає його (нечасто
використовуваний) файл налаштувань у іншому порядку так, що локальні параметри
перевизначають загальні параметри. (Pino Toscano)
virt-make-fs(1) було переписано на C, але програма лишилася незмінною за функціональними
можливостями і використанням командного рядка.
Прив’язки до мов програмування
Прив'язки до OCaml містять новий модуль "Guestfs.Errno", який використовується для
перевірки номерів помилок, які повертає "Guestfs.last_errno".
Відновлення працездатності тестів PHP. (Pino Toscano)
Перевірка
Засіб інспектування тепер може розпізнавати образи портативних систем Debian.
Архітектури
На ARMv7 (32-бітових) тепер передбачено підтримку пришвидшення KVM.
Передбачено підтримку Aarch64 (ARM 64-бітових), але частина, пов'язана із базовою
системою, ще не працює.
Виправлено і удосконалено підтримку PPC64.
Безпека
Відмова у обслуговуванні при інспектуванні образів дисків із пошкодженими томами btrfs
Можна було спричинити аварійне завершення роботи libguestfs (та програм, які
використовують libguestfs як бібліотеку) передаванням їм образу диска, на якому
містився пошкоджений том btrfs.
Причиною було розіменування нульового вказівника, яке спричиняло відмову в
обслуговуванні. Ми вважаємо, що ширше використання цієї вразливості неможливе.
Див. внесок d70ceb4cbea165c960710576efac5a5716055486 із виправленням. Це виправлено
включено до стабільних гілок libguestfs ≥ 1.26.0, ≥ 1.24.6 та ≥ 1.22.8, а також до
RHEL ≥ 7.0. Старіші версії libguestfs не є вразливими.
Якісніше створення випадкових паролів root та породжувачів псевдовипадкових послідовностей
Виявлено і виправлено дві пов'язаних із захистом вади під час створення випадкових
паролів root та породжувачів псевдовипадкових послідовностей чисел. По-перше, ми
більше не читаємо зайві байти з /dev/urandom (більшу частину даних з якого ми просто
відкидали). По-друге, ми змінили код, щоб уникнути нерівномірного розподілу за
лишками. Ми вважаємо, що цими вразливостями не можна скористатися. (Обидві зміни
запропоновано Edwin Török)
API
Тепер перевіряється коректність параметрів GUID, коли їх передають до викликів програмного
інтерфейсу. Раніше можна було передати довільний рядок. (Pino Toscano)
Нові програмні інтерфейси
"guestfs_add_drive_opts": новий параметр "discard"
За допомогою нового параметра "discard" можливий точніший контроль над підтримкою
відкидання та обрізання для певного диска. Це уможливлює створення розрідженіших
файлів у основній системі, коли ви вилучаєте файли або надсилаєте виклик до
програмного інтерфейсу "guestfs_fstrim".
"guestfs_add_domain": нові параметри: "cachemode", "discard"
Ці параметри передаються під час додавання дисків домену.
"guestfs_blkdiscard"
Відкинути усі блоки на пристрої guestfs. У поєднанні із описаним вище параметром
"discard" це робить файл у основній системі розрідженим.
"guestfs_blkdiscardzeroes"
Для перевірки того, чи відкинуті блоки читаються як нульові.
"guestfs_compare_*"
"guestfs_copy_*"
Для усіх структури, повернути через програмний інтерфейс, libguestfs тепер створює
функції "guestfs_compare_*" і "guestfs_copy_*", за допомогою яких можна порівнювати і
копіювати структури.
"guestfs_copy_attributes"
Копіювання атрибутів (зокрема прав доступу, xattrs, прав власності) з одного файла до
іншого. (Pino Toscano)
"guestfs_disk_create"
Гнучкий програмний інтерфейс для створення порожніх образів дисків з нуля. Надає змогу
обійтися без викликів зовнішніх програм, зокрема qemu-img(1).
"guestfs_get_backend_settings"
"guestfs_set_backend_settings"
Окремі параметри для різних модулів обробки (можна також встановити за допомогою
змінної середовища "LIBGUESTFS_BACKEND_SETTINGS"). Основним призначенням є примусовий
режим TCG у заснованих на qemu модулях обробки. Приклад:
export LIBGUESTFS_BACKEND=direct
export LIBGUESTFS_BACKEND_SETTINGS=force_tcg
"guestfs_part_get_name"
Отримання мітки або назви розділу (для образів дисків GPT).
Зміни у збиранні
Для збирання libguestfs 1.26 потрібні такі додаткові пакунки:
supermin ≥ 5
Для збирання цієї версії libguestfs потрібен supermin версії 5.
flex, bison
Virt-builder тепер використовує справжній засіб обробки для свого файла метаданих,
отже ці інструменти тепер є обов'язковими.
xz Тепер це обов'язкова частина для збирання там, де раніше (теоретично) вона була
необов'язковою.
Внутрішня частина роботи програми
Переписано засіб видобування повідомлень PO, що мало зробити його стійкішим. (Pino
Toscano)
"podwrapper" повідомляє про помилку, якщо не знайдено аргумент зразка для --insert або
--verbatim.
Libguestfs тепер передає параметр qemu -enable-fips для вмикання FIPS, якщо у qemu
передбачено його підтримку.
Якщо ви не хочете вказувати типовий гіпервізор, можете скористатися "./configure
--without-qemu".
Накладки copy-on-write [COW], які використовуються, наприклад, для придатних лише для
читання дисків, тепер створюються за допомогою вбудованого програмного інтерфейсу
(".create_cow_overlay").
Модуль обробки libvirt використовує якийсь вигадливий макрос C для створення XML. Ці є
простішими і безпечнішими.
Було змінено формат файла ChangeLog. Тепер він такий самий як у "git log". Нетиповий
формат більше не використовується.
Змінено процедуру запуску базової системи:
• Базова система libguestfs тепер ініціалізує LVM у той самий спосіб, у який це робиться
на фізичних машинах.
• Базова система libguestfs не записує порожній рядок до /proc/sys/kernel/hotplug під
час запуску.
Зауважте, що вам слід налаштувати ваше ядро так, щоб у ньому було
"CONFIG_UEVENT_HELPER_PATH=""", інакше ви матимете справу із дивними помилками LVM (це
стосується будь-якої машини Linux, не лише libguestfs). (Peter Rajnoha)
Libguestfs тепер можна зібрати на архітектурах, де є ocamlc(1), але немає ocamlopt(1).
(Hilko Bengen, Olaf Hering)
Не можна використовувати "./configure --disable-daemon --enable-appliance". Така
комбінація усе одно не мала сенсу. Тепер її заборонено явним чином у скрипті configure.
Файл packagelist використовує "m4" для розгортання макросів замість "cpp".
Виправлені вади
https://bugzilla.redhat.com/1073906
java bindings inspect_list_applications2 throws
java.lang.ArrayIndexOutOfBoundsException:
https://bugzilla.redhat.com/1063374
[RFE] enable subscription manager clean or unregister operation to sysprep
https://bugzilla.redhat.com/1060404
virt-resize does not preserve GPT partition names
https://bugzilla.redhat.com/1057504
mount-local should give a clearer error if root is not mounted
https://bugzilla.redhat.com/1056290
virt-sparsify overwrites block devices if used as output files
https://bugzilla.redhat.com/1055452
libguestfs: error: invalid backend: appliance
https://bugzilla.redhat.com/1054761
guestfs_pvs prints "unknown device" if a physical volume is missing
https://bugzilla.redhat.com/1053847
Recommended default clock/timer settings
https://bugzilla.redhat.com/1046509
ruby-libguestfs throws "expecting 0 or 1 arguments" on Guestfs::Guestfs.new
https://bugzilla.redhat.com/1045450
Cannot inspect cirros 0.3.1 disk image fully
https://bugzilla.redhat.com/1045033
LIBVIRT_DEFAULT_URI=qemu:///system breaks libguestfs
https://bugzilla.redhat.com/1044585
virt-builder network (eg. --install) doesn't work if resolv.conf sets nameserver
127.0.0.1
https://bugzilla.redhat.com/1044014
When SSSD is installed, libvirt configuration requires authentication, but not clear
to user
https://bugzilla.redhat.com/1039995
virt-make-fs fails making fat/vfat whole disk: Device partition expected, not making
filesystem on entire device '/dev/sda' (use -I to override)
https://bugzilla.redhat.com/1039540
virt-sysprep to delete more logfiles
https://bugzilla.redhat.com/1033207
RFE: libguestfs inspection does not recognize Free4NAS live CD
https://bugzilla.redhat.com/1028660
RFE: virt-sysprep/virt-builder повинні мати можливість блокувати обліковий запис
користувача
https://bugzilla.redhat.com/1026688
libguestfs fails examining libvirt guest with ceph drives: rbd: image name must begin
with a '/'
https://bugzilla.redhat.com/1022431
virt-builder не працює, якщо не існує $HOME/.cache
https://bugzilla.redhat.com/1022184
libguestfs: не слід використовувати файл jar із зазначенням версії
https://bugzilla.redhat.com/1020806
Усі дії libguestfs із LVM завершуються невдало у Debian/Ubuntu
https://bugzilla.redhat.com/1008417
Need update helpout of part-set-gpt-type
https://bugzilla.redhat.com/953907
virt-sysprep does not correctly set the hostname on Debian/Ubuntu
https://bugzilla.redhat.com/923355
guestfish виводить у повідомленнях про помилки «\n» буквально
https://bugzilla.redhat.com/660687
guestmount: "touch" command fails: touch: setting times of `timestamp': Invalid
argument
https://bugzilla.redhat.com/593511
[RFE] function to get partition name
https://bugzilla.redhat.com/563450
list-devices returns devices of different types out of order
ТАКОЖ ПЕРЕГЛЯНЬТЕ
guestfs-examples(1), guestfs-faq(1), guestfs-performance(1), guestfs-recipes(1),
guestfs-testing(1), guestfs(3), guestfish(1), http://libguestfs.org/
АВТОР
Richard W.M. Jones
АВТОРСЬКІ ПРАВА
Copyright (C) 2009-2023 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.