Manpages

НАЗВА

guestfs-release-notes - нотатки щодо випусків libguestfs

НОТАТКИ ЩОДО ВИПУСКУ LIBGUESTFS 1.32

Ці нотатки щодо випуску стосуються лише відмінностей від попереднього стабільного випуску (1.30.0). Докладний журнал змін є частиною журналу змін сховища git. Його також наведено у файлі ChangeLog, який є частиною архіву tar із кодом бібліотеки.

Нові можливості
Нові інструменти

Новий засіб virt-v2v-copy-to-local(1), який є допоміжним для virt-v2v(1), надає вам змогу перетворювати початкові гостьові системи, до яких virt-v2v не може отримати безпосередній доступ.

Нові можливості у наявних інструментах

Virt-customize тепер знає, як записати породжувач випадковості до CirrOS (Pino Toscano).

У Fedora virt-customize запускає dnf(8) з прапорцем --best, забезпечуючи те, що програма завжди оновлює систему до найсвіжіших доступних пакунків.

Virt-builder тепер містить 32-бітові шаблони для Fedora.

Параметр virt-builder і virt-customize --install тепер працює у 32-бітових гостьових системах Fedora. Раніше його використання призводило до спроби встановити 64-бітові пакунки (Jan Sedlák).

Virt-builder тепер може отримувати образи для хмар за допомогою метаданих Simple Streams v1.0 (Pino Toscano).

Virt-builder тепер може отримувати хмарні образи openSUSE без додаткових налаштовувань (Cédric Bosdonnat).

Virt-customize тепер використовує стійкіше типове шифрування паролів (SHA-512) у openSUSE ≥ 11 (Pino Toscano).

Virt-builder тепер правильно обробляє вихідні назви файлів, що містять символи двокрапок (":"), і створює тимчасові файли у каталогу кешу libguestfs безпосередньо, замість типового /tmp (Pino Toscano).

Virt-resize має новий параметр --unknown-filesystems для керування тим, що робити, якщо програму попросять змінити розмір файлової системи, спосіб зміни якої libguestfs не є відомим.

Virt-v2v тепер має прапорець або режим --in-place, який уможливлює перетворення на місці гостьових систем (Roman Kagan).

Virt-v2v має параметр --compressed для створення стиснених файлів виведення qcow2.

Virt-v2v тепер може правильно отримувати шлях до датацентру VMware (dcPath) від libvirt, замість визначення його за допомогою алгоритму, який іноді визначає помилкову відповідь (Matthias Bolte, Tingting Zheng).

Virt-v2v тепер правильно обробляє розміри оперативної пам’яті для 64-бітових гостьових систем, якщо програму запущено у 32-бітовій основній системі.

Прив’язки до мов програмування

У програмах мовами Perl і Python програмний інтерфейс "get_program_name" тепер повертає справжню назву програми, а не помилковий рядок "perl" або "python".

Прив’язки до Python тепер можна зібрати для іншої версії libguestfs, що уможливлює збирання модуля pip для будь-якої версії libguestfs (замість строгої вимоги щодо однакових версій модуля pip і libguestfs).

Поліпшено якість документації Ruby rdoc (Pino Toscano).

У скриптах Perl більше немає рядка із жорсткою прив’язкою до розташування інтерпретатора perl, замість цього використовується env(1) (Pino Toscano).

У програмах мовою OCaml дескриптор guestfs помилково вказував на загальну кореневу файлову систему, тобто його ніколи не можна було обробити засобом збирання сміття. Якщо ви не викликали функцію "close" явним чином, дескриптор не закривався, аж доки не завершувала роботу уся програма. Тепер цю помилку виправлено, отже дескриптори можуть прибиратися засобом збирання сміття у звичний спосіб. Це призвело до зміни програмного інтерфейсу функції OCaml "Guestfs.event_callback". Зауважте, що прив’язки до мов, відмінних від C, не мають гарантій щодо незмінності програмного інтерфейсу та бінарної сумісності, хоча ми і намагаємося не змінювати їх, але у цьому випадку зміна була важливою, оскільки надала змогу виправити дуже серйозну ваду.

Перевірка

Тепер розпізнаються Alpine Linux та засіб керування пакунками APK, ALT Linux, Frugalware та PLD Linux (Pino Toscano).

Якщо існує /etc/os-release дані з нього матимуть пріоритет над безпосереднім інспектуванням гостьових систем Linux (Pino Toscano).

Тепер повертається правильна версія ядра для гостьових систем Windows ≥ 10.

Документація

Велику сторінку підручника з guestfs(3) поділено на декілька окремих сторінок підручника: guestfs-hacking(1) guestfs-internals(1) guestfs-security(1). Ця документація міститься у новому каталозі docs ієрархії коду.

Архітектури і платформи

У новій версії libguestfs передбачено підтримку 64-бітовий платформ ARM з vGICv3.

Безпека
Див. також guestfs-security(1).
"CVE-2015-5745"

https://bugzilla.redhat.com/1251157

Це не вразливість у libguestfs, але оскільки ми завжди надаємо порт virtio-serial для кожної гостьової системи (оскільки так здійснюється обмін даними між гостьовою і основною системами), можливе проникнення з базової системи до процесу qemu основної системи. Це може стосуватися таких випадків:

ваша програма libguestfs запускає ненадійні програми з гостьової системи (за допомогою "guestfs_sh" тощо) або

у коді файлових систем ядра буде виявлено іншу властивість (наприклад), яка надає змогу відповідним чином створеній файловій системі захопити контроль над базовою системою.

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

Права доступу virt-customize до .ssh, .ssh/authorized_keys

https://bugzilla.redhat.com/1260778.

Раніше, якщо надходила команда щодо вставляння ключа SSH до гостьової системи, virt-customize (а отже, virt-builder) створювала каталог .ssh і файл .ssh/authorized_keys із надто широким доступом, що надавало стороннім користувачам доступ до читання цих даних. Тепер цей каталог і файл створюються з правами доступу 0700 і 0600, відповідно, що збігається із правилами, які використовує програма ssh-copy-id(1).

API
Нові програмні інтерфейси

"guestfs_get_identifier"
"guestfs_set_identifier"

Отримати або встановити окремий для обробника ідентифікатор. Основним ефектом цього є зміна виведення trace з такого:

libguestfs: trace: foo

на таке:

libguestfs: trace: ID: foo

що спрощує стеження за трасуванням у багатопотокових програма або там, де програма використовує декілька дескрипторів (особливо virt-v2v).

"guestfs_vfs_minimum_size"

Повертає мінімальний розмір файлової системи (після стискання). Передбачено підтримку ext2/3/4, XFS і btrfs, у майбутньому можлива підтримка інших файлових систем (Maxim Perevedentsev).

Інші зміни у програмному інтерфейсі
"guestfs_disk_create": додано "preallocation" =
"off"/"metadata"/"full".

Для raw це уможливлює "off" як синонім "sparse" (робить сумісним із qcow2). Для qcow2 це уможливлює "sparse" як синонім "off".

Це також додає "full", який відповідає повному розміщенню, але використовує posix_fallocate(3) для забезпечення ефективності.

"guestfs_tar_in": нові параметри "xattrs", "selinux", "acl".
"guestfs_tar_out": нові параметри "xattrs", "selinux", "acl".

Ці додаткові параметри керують тим, чи буде відновлено розширені атрибути, контексти SELinux і/або ACL POSIX з /, збережених у архівах tar.

"guestfs_add_drive"

Наявними параметрами "username" і "secret" можна скористатися для надання підтримки розпізнавання для iSCSI (Pino Toscano).

Зміни у збиранні
Вилучено параметр "./configure --enable-valgrind-daemon".

Тепер libguestfs не можна зібрати на дистрибутивах ери RHEL 5 (близько 2007 року). Див. гілку "oldlinux", якщо вам потрібна (обмежена) підтримка RHEL 5.

Virt-p2v тепер можна зібрати на дистрибутивах Linux ери RHEL 6 (близько 2010 року).

Тепер для збирання з git потрібен OCaml ≥ 3.11 (випущено у 2008 році).

Для збирання прив’язок до Perl тепер потрібен "Module::Build" (замість "ExtUtils::MakeMaker").

Збирання має пришвидшитися (особливо нарощувальне повторне збирання), оскільки виконано певну роботу із зменшення тривалості збирання.

Для запуску генератора під час збирання потрібні OCaml і модуль findlib OCaml. Раніше збирання завершувалося помилкою, якщо не було встановлено findlib.

Тести "make check" тепер виконуються у паралельному режимі (у межах кожного з каталогів тестування).

"make install" тепер встановлює файли OCaml bindtests.* правильно.

"make install" тепер можна запускати двічі. Раніше, під час другого запуску видавалося повідомлення про помилку.

"make clean" тепер має вилучати майже усі файли, які створює "make".

Додано нове правило "make installcheck", яке уможливлює тестування встановленої версії libguestfs.

Внутрішня частина роботи програми
Певних зусиль було докладено до мінімізації розміру базової системи, що зменшило об’єм тимчасового диска і час, потрібний на обробку у libguestfs.

Базова система тепер передає назву NIC до dhcpd, це виправляє повисання під час роботи базової системи у деяких дистрибутивах (Cédric Bosdonnat).

Тепер створюється "Guestfs.Errno" OCaml (Pino Toscano).

У засобах мовою OCaml загальний код тепер обробляє --debug-gc, --verbose та інші загальні параметри (Roman Kagan, Pino Toscano).

Комплекс тестування virt-v2v надає нам змогу завантажувати тестовані гостьові системи у фіксовані моменти часу у минулому, забезпечуючи надійну роботу системи повторної активації Windows.

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

Використано програму "deheader" для вилучення невикористаних інструкцій "#include".

У засобах мовою OCaml модулі "Char" і "String" тепер наявно посилаються на модулі "Common_utils.Char" і "Common_utils.String" (замість модулів зі stdlib). Модулі "Common_utils" містять декілька додаткових допоміжних функцій для роботи із символами і рядками, а також приховування деяких незахищених функцій у stdlib.

Тепер запускається набагато більше тестів virt-v2v, навіть якщо не встановлено rhsrvany і virtio-win (Roman Kagan).

Величезний файл configure.ac було поділено на декілька менших файлів із назвами m4/guestfs_*.m4.

Застарілі каталоги tests/data і tests/guests було пересунуто до test-data/. Цей новий каталог верхнього рівня містить усі дані засобів тестування, які є спільними, великим і/або використовуються у декількох тестах.

Створено новий каталог верхнього рівня website/, який містить загальнодоступні дані сайта http://libguestfs.org (або більшу частину цих даних).

Нечітке тестування засобів інспектування (tests/fuzz) було вилучено.

Virt-p2v тепер зберігає виведення dmesg фізичної машини джерела до каталогу діагностичних даних сервера перетворення, що діагностику у випадку нестачі драйверів, мікропрограми тощо.

Виправлені вади
https://bugzilla.redhat.com/1294956

set-label повертає помилкове повідомлення про помилку, якщо встановлено мітку файлової системи ext3/ext4

https://bugzilla.redhat.com/1288733

Add a Fedora 23 32-bit base image for virt-builder

https://bugzilla.redhat.com/1288201

virt-builder записує тимчасові файли до /tmp

https://bugzilla.redhat.com/1285847

virt-resize не копіює логічні розділи

https://bugzilla.redhat.com/1281578

virt-inspector повертає версію 6.3 для образів win10 (має повертати 10.0)

https://bugzilla.redhat.com/1281577

virt-inspector --xpath segfault on attribute get

https://bugzilla.redhat.com/1280029

libguestfs can run commands with stdin not open (or worse still, connected to arbitrary guest-chosen random devices)

https://bugzilla.redhat.com/1279273

Про параметр стискання для qcow2

https://bugzilla.redhat.com/1278878

guestfish should be able to handle LVM thin layouts

https://bugzilla.redhat.com/1278382

DNF python programming error when run from virt-builder

https://bugzilla.redhat.com/1278371

inspection returns arch="unknown" for Windows guest if file command is not installed

https://bugzilla.redhat.com/1277274

Document permissions needed for non-admin users to use virt-v2v

https://bugzilla.redhat.com/1277122

RFE: virt-sparsify: make ’--in-place’ sparsification safe to abort (gracefully or ungracefully)

https://bugzilla.redhat.com/1277074

Virt-p2v client shouldn’t present the vdsm option because it’s not usable

https://bugzilla.redhat.com/1276540

virt-v2v fails to convert Windows raw image: error "device name is not a partition"

https://bugzilla.redhat.com/1275806

virt-builder: error: [file] is not a regular file in the guest

https://bugzilla.redhat.com/1270011

Simplestreams test fails: virt-builder: error: the value for the key ’size’ is not an integer

https://bugzilla.redhat.com/1267032

guestfish copy-in command behaves oddly/unexpectedly with wildcards

https://bugzilla.redhat.com/1262983

python: Cannot compile pip module if installed libguestfs != pip guestfs version

https://bugzilla.redhat.com/1262127

Better diagnostic message when virbr0 doesn’t exist

https://bugzilla.redhat.com/1261436

No warning shows when convert a win7 guest with AVG AntiVirus installed

https://bugzilla.redhat.com/1260778

virt-builder --ssh-inject doesn’t set proper permissions on created files

https://bugzilla.redhat.com/1260689

RFE: V2V to check and warn user to disable group policy and anti virus on Windows guests

https://bugzilla.redhat.com/1260590

Wrong graphics protocal and video type set for guest after convert to rhev 3.6 by virt-v2v

https://bugzilla.redhat.com/1258342

extra slashes in vcenter URL confuses virt-v2v

https://bugzilla.redhat.com/1257895

[RHEV][V2V] virt-v2v ignores NIC if interface source/@network or source/@bridge is an empty string

https://bugzilla.redhat.com/1256405

virt-builder created Fedora 22 32bit disk image cannot be updated

https://bugzilla.redhat.com/1256222

virt-p2v no GUI mode:error opening control connection to $ip:22:unexpected …rompt

https://bugzilla.redhat.com/1251909

Option -oa preallocated -of qcow2 of virt-v2v didn’t work efficiently

https://bugzilla.redhat.com/1250715

v2v: у шляхах пробіли слід екранувати, ось так: %20

https://bugzilla.redhat.com/1248678

Закрити усі вхідні порти на образі ISO virt-p2v

https://bugzilla.redhat.com/1246882

man virt-customize показував короткий опис двічі

https://bugzilla.redhat.com/1242853

mount-loop failed to setup loop device: No such file or directory

https://bugzilla.redhat.com/1237136

BUG: unable to handle kernel NULL pointer dereference at <addr> in function __blkg_lookup

https://bugzilla.redhat.com/1230412

virt-v2v should ignore bogus kernel entries in grub config

https://bugzilla.redhat.com/1229119

Unrelated info in fstab makes virt-v2v fail with unclear error info

https://bugzilla.redhat.com/1227609

virt-p2v: Using "Back" button causes output list to be repopulated multiple times

https://bugzilla.redhat.com/1225789

Wrong video driver is installed for rhel5.11 guest after conversion to libvirt

https://bugzilla.redhat.com/1204131

RFE: virt-builder creates qcow v3 images, add build option for qcow v2

https://bugzilla.redhat.com/1176801

File /etc/sysconfig/kernel isn’t updated when convert XenPV guest with regular kernel installed

https://bugzilla.redhat.com/1174551

"lstatnslist" and "lstatlist" don’t give an error if the API is used wrongly

https://bugzilla.redhat.com/1168223

koji spin-livecd cannot build a working live CD

https://bugzilla.redhat.com/1165785

mount-loop command fails: mount failed: Unknown error -1

https://bugzilla.redhat.com/1164708

set-label can only set <=127 bytes for btrfs and <=126 bytes for ntfs filesystem which not meet the help message. Also for ntfs it should give a warning message when the length >128 bytes

https://bugzilla.redhat.com/1020216

libvirt fails to shut down domain: could not destroy libvirt domain: Requested operation is not valid: domain is not running

https://bugzilla.redhat.com/1011907

mount-loop failed to setup loop device: No such file or directory

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

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.