guestfs-release-notes-1.26(1)

НАЗВА
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.