Manpages

НАЗВА

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

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

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

Нові можливості
libvirt і sVirt (контейнер SELinux)

Ви можете, якщо хочете, скористатися libvirt для запуску і керування базовою системою за допомогою:

Для захисту базової системи libguestfs використовується SVirt (контейнер SELinux), якщо вибрано модуль обробки libvirt.

virtio-scsi, більша кількість дисків, з’єднання у «гарячому» режимі

Тепер типово використовується virtio-scsi, якщо цей інтерфейс доступний. Це набагато збільшує кількість дисків, які можна додати до одного дескриптора libguestfs (аж до 255).

Тепер можна додавати і вилучати диски після запуску у «гарячому» режимі.

Libguestfs тепер може працювати із > 25 дисками, в усіх програмних інтерфейсах, засобах та тестах.

Тепер ви можете додавати до дисків мітку і посилатися на них за міткою (/dev/disk/guestfs/МІТКА) замість використання назв пристроїв (/dev/sda).

Нові можливості бібліотеки

Через програмний інтерфейс читаються і записуються списки керування доступом POSIX (ACL) та можливості файлової системи Linux.

Реалізовано підтримку динамічних дисків Windows. Метадані можна лише читати (не можна вносити зміни до томів або створювати томи). Втім дані та файлові системи на томах можна монтувати, читати та записувати (Matthew Booth).

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

Повторно реалізовано декілька програмних інтерфейсів libguestfs так, що у них більше немає жодних обмежень на виведення даних. Серед повторно реалізованих програмних інтерфейсів такі: "guestfs_cat", "guestfs_find", "guestfs_read_file", "guestfs_read_lines", "guestfs_write", "guestfs_write_append", "guestfs_lstatlist", "guestfs_lxattrlist", "guestfs_readlinklist", "guestfs_ls".

virt tools

"guestfish touch 'win:c:\новий_файл'" тепер працює як слід.

У "guestfish" реалізовано новий параметр --network, за допомогою якого можна увімкнути для користувача мережу у libguestfs.

Уможливлено встановлення змінної середовища "GUESTFISH_PS1" для використання форматованих запитів щодо команд у "guestfish".

Тепер у virt-rescue доступні команди "rsync", "ssh", "less" та "lrzip". Крім того, для створення нарощувальних копій можна скористатися "rsync" за допомогою програмного інтерфейсу.

"virt-sparsify" використовує qcow2 v3 для підвищення ефективності.

Поліпшення у "virt-sysprep":

"virt-make-fs" тепер може створювати віртуальні дискети (VFD).

У "guestmount" реалізовано параметр --pid-file, яким можна скористатися для уникнення конкуренції між демонтуванням файлової системи і використанням підлеглого образу диска.

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

У цьому випуску додано повноцінні прив’язки до Lua (дякуємо Jerome Vuarand за багато пропозицій).

У Ruby хеш для необов’язкових аргументів є необов’язковим.

У Python необов’язкові аргументи тепер не використовують спеціальних «сторожових» значень, отже як необов’язковий параметр можна передавати будь-яке ціле число.

Прив’язки до Erlang тепер постачаються із прикладами і тестами.

Прив’язки до Erlang тепер обробляють 64-бітові цілі параметри належним чином.

Автоматизовані «bindtests» тепер тестують правильність передавання 64-бітових параметрів. У результатів виявлено і виправлено декілька вад у прив’язках до мов програмування.

Поліпшено обробку блокування та впроваджено функції, які не блокують обробку. Це має зробити виклики libguestfs ефективнішими.

перевірка

Тепер передбачено обробку гостьових систем Windows без обмежень на розмір реєстру. Додавання програмного інтерфейсу hivex до програмного інтерфейсу libguestfs зробило інспектування на внесення змір до реєстру Windows у гостьових системах набагато ефективнішим.

Поліпшено підтримку гостьових систем SuSE (Olaf Hering).

Реалізовано повернення даних щодо архітектури встановлених програм (John Eckersberg).

Реалізовано підтримку Windows 8.

Тепер підтримується Fedora 18.

Засіб інспектування ISO, CD та DVD тепер може використовувати базу даних libosinfo.

порти

Libguestfs без базової системи можна зібрати у Mac OS X (Masami HIRATA).

RHEL 5 тепер явним чином підтримується у гілці «oldlinux» основного сховища git.

Реалізовано підтримку 64-бітової архітектури PowerPC. Крім того, libguestfs було проінспектовано на вади, пов’язані із порядком байтів. Виявлені вади було виправлено.

фонова служба

Включено сторінку підручника для фонової служби (guestfsd(8)).

Безпека
Файл журналу guestfish

Файл журналу $HOME/.guestfish тепер створюється із правами доступу 0600 (раніше використовувалася маска 0644), отже, його більше не зможуть читати сторонні користувачі.

CVE-2012-2690

У старих версіях програми "virt-edit" та команди "edit" "guestfish" створювався новий файл, у якому зберігалися зміни, але не встановлювалися права доступу та інші параметри так, щоб вони збігалися із параметрами старого редагованого файла. У результаті після редагування конфіденційного файла, зокрема /etc/shadow, він ставав доступним для сторонніх користувачів.

Цій ваді було надано код CVE-2012-2690. Її було виправлено у libguestfs ≥ 1.16.

Докладніші дані можна знайти на сторінці https://bugzilla.redhat.com/show_bug.cgi?id=788642

Нові програмні інтерфейси
acl-delete-def-file
acl-get-file
acl-set-file
canonical-device-name
cap-get-file
cap-set-file
create-flags
device-index
disk-has-backing-file
disk-format
disk-virtual-size
filesystem-available
fill-dir
fstrim
get-cachedir
get-libvirt-requested-credentials
get-libvirt-requested-credential-prompt
get-libvirt-requested-credential-challenge
get-libvirt-requested-credential-defresult
get-tmpdir
hivex-close
hivex-commit
hivex-node-add-child
hivex-node-children
hivex-node-delete-child
hivex-node-get-child
hivex-node-get-value
hivex-node-name
hivex-node-parent
hivex-node-set-value
hivex-node-values
hivex-open
hivex-root
hivex-value-key
hivex-value-type
hivex-value-utf8
hivex-value-value
inspect-list-applications2 (John Eckersberg)
list-ldm-volumes
list-ldm-partitions
ldmtool-create-all
ldmtool-diskgroup-disks
ldmtool-diskgroup-name
ldmtool-diskgroup-volumes
ldmtool-remove-all
ldmtool-scan
ldmtool-scan-devices
ldmtool-volume-hint
ldmtool-volume-partitions
ldmtool-volume-type
ls0
max-disks
mke2fs (Wanlong Gao)
mklost-and-found
mkswap [додано додаткові аргументи label та uuid]
mktemp (Wanlong Gao)
nr-devices
parse-environment
parse-environment-list
rm-f
rsync
rsync-in
rsync-out
set-cachedir
set-libvirt-supported-credentials
set-libvirt-requested-credential
set-tmpdir
shutdown [зворотне портування на 1.16 та 1.18]
tar-in [додано прапорець compress]
tar-out [додано прапорці compress, numericowner, excludes]
umount [додано додаткові аргументи force і lazy]
utsname
xfs-admin (Wanlong Gao)
xfs-growfs (Wanlong Gao)
xfs-info (Wanlong Gao)
xfs-repair (Wanlong Gao)

Лише у програмному інтерфейсі C:

guestfs_push_error_handler
guestfs_pop_error_handler

Внутрішня частина роботи програми
qemu ≥ 1.1 є обов’язковою (бажаною є версія ≥ 1.2).

febootstrap ≥ 3.20 є обов’язковою.

libvirt є необов’язковою, але якщо ви хочете користуватися новим модулем libvirt для запуску базової системи, тоді обов’язковою є libvirt ≥ 0.10.2.

Для усього коду було виконано перевірку Coverity. Виправлено багато вад (дякуємо Ondrej Vasik, Kamil Dudka).

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

Змінено спосіб, у який програмні інтерфейси і структури libguestfs представляються у генераторі, так, щоб використовувалися структури OCaml замість кортежів. Це робить описи у генераторів гнучкішими та простішими для розуміння. Подробиці викладено у внесках 39d1a7db і eb185eef.

Поділ коду бібліотеки на більшу кількість файлів:

POD (документація) тепер створюється з використанням переписаної програми на Perl, а не pod2* + скриптів оболонки.

Сторінки підручника тепер містять стабільні дати (Hilko Bengen).

Пропущені тести тепер виходять із кодом 77, отже потрапляють до "SKIP:" у виведених "make check" даних.

Паралельний тест щодо mount-local було переписано на C (RHBZ#838081).

Тепер передбачено підтримку Ruby 1.8.5 (хоча перевага надається Ruby ≥ 1.9).

Прив’язки до Perl тепер можна вимкнути за допомогою "./configure --disable-perl" (Wulf C. Krueger). Зауважте, що сам інтерпретатор Perl усе ще потрібен для збирання libguestfs.

Прив’язки до Java тепер можна увімкнути або вимкнути за допомогою "./configure --with-java" або "./configure --without-java" (Wulf C. Krueger).

Нові параметри налаштування: "./configure --enable-code-profiling" і "./configure --enable-code-coverage".

Декілька виправлень щодо використання 64-бітових цілих чисел у прив’язках до мов програмування.

Модуль базової системи тепер використовує sgabios замість vgabios (Dan Berrange).

Скрипт "./run" тепер встановлює достатньо змінних середовища, щоб можна було запускати програми на OCaml, Python, Ruby, Java, GJS, Erlang, Lua.

Реалізовано прапорець "./run --test" для запуску тестів із мінімальним виведенням. Також скрипт виводить час, який було витрачено на кожен із тестів.

Скрипт "./run" тепер збирає шляхи накопичувально, тобто ви можете скористатися "./run" двічі або скористатися скриптами "./run" libguestfs і libvirt разом.

Тепер можна видобути список зовнішніх команд, потрібних для роботи фонової служби, що робить збирання базової системи на деяких дистрибутивах простішим (Olaf Hering).

Тепер під час виконання "make check" виконується тестування "virt-rescue".

Генератор тепер вилучає невикористані створені файли. Це допомагає, якщо виконуються маневри модифікаціями коду за допомогою git rebase, git bisect тощо.

Тести тепер запускаються у окремому каталозі "tmp/" верхнього рівня у ієрархії коду. Це надає змогу створювати мітки для каталогу для SELinux (sVirt), а також спрощує чищення ієрархії коду.

Розширено діапазон роботи "make syntax-check" і усунено багато проблем у основному коді, які було виявлено за допомогою перевірки синтаксису (дякуємо Jim Meyering).

До створених файлів додано режим Emacs (-*- foo -*-).

Виведення смужки поступу тепер надсилається до /dev/tty, отже не потрапляє до звичайних виведених програмою даних. virt-resize і virt-sparsify тепер придушують дані смужки поступу, якщо стандартним виведенням не є tty.

Впроваджено параметр "./configure --without-libvirt". Він є корисним для тестування того, чи можна зібрати код без libvirt.

Впроваджено вбудовану мінібібліотеку для запуску команд. Це надало нам змогу переспрямувати повідомлення про помилки від зовнішніх команд до записів подій.

Повністю переглянуто код для обробки тимчасових каталогів та кешу базової системи.

Код для тимчасового ігнорування або вимикання повідомлень про помилки тепер виглядає так:

guestfs_push_error_handler (g, NULL, NULL);
guestfs_mkdir (g, "/foo"); /* Нам все одно, якщо спроба буде невдалою. */
guestfs_pop_error_handler (g);

Усунено каталог "tests/extra". «Додаткові тести» тепер поділено на декілька окремих цілей, наприклад "make check-valgrind". Скористайтеся командою "make help", щоб дізнатися більше про ці цілі.

Ядру базової системи тепер передається параметр "lpj", якщо використовується TCG. Це має поліпшити стабільність відліку часу (дякуємо Marcelo Tosatti, Olaf Hering).

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

Інструменти libguestfs показують повідомлення про незрозумілі помилки, якщо TMPDIR не є абсолютним шляхом

https://bugzilla.redhat.com/882299

Windows 8 guest disks can’t be mounted: "The NTFS partition is in an unsafe state. Please resume and shutdown Windows fully (no hibernation or fast restarting), or mount the volume read-only with the ’ro’ mount option."

https://bugzilla.redhat.com/881953

libguestfs: перехід на /etc/hostname, /etc/vconsole.conf, /etc/locale.conf

https://bugzilla.redhat.com/880801

virt-df із двома параметрами -a options показує некоректну назву образу диска

https://bugzilla.redhat.com/879416

libguestfs-test-tool pauses when you use --help option

https://bugzilla.redhat.com/876579

mke2fs API does not apply block device naming translation to journaldevice optarg

https://bugzilla.redhat.com/860235

SELinux policy ought to allow qemu to write to unconfined_u:object_r:user_tmp_t:s0

https://bugzilla.redhat.com/859949

RFE: inspect-list-applications does not return the architecture of RPM packages

https://bugzilla.redhat.com/859885

inspect-list-applications does not list all installed RPM packages with same name and different versions

https://bugzilla.redhat.com/859876

guestfish printed paths are not canonicalized

https://bugzilla.redhat.com/859875

Progress bar output should go to tty(?) stderr(?)

https://bugzilla.redhat.com/858696

virt-sysprep reports Guestfs.Error("read_lines: fopen: /etc/sysconfig/network: No such file or directory") on some Fedora guests

https://bugzilla.redhat.com/858128

libguestfs fail to list devices added by add-drive-ro-with-if twice

https://bugzilla.redhat.com/858126

virt-inspector fail to work with some windows guests

https://bugzilla.redhat.com/853762

virt-sparsify should use a more robust method to detect the input format

https://bugzilla.redhat.com/853393

libvirt doesn’t label console, serial sockets

https://bugzilla.redhat.com/853159

virt-rescue у Fedora 18 повністю непрацездатний

https://bugzilla.redhat.com/852394

libguestfs inspection limits registries to 100 MiB

https://bugzilla.redhat.com/852194

virt-sparsify --compress не працює, якщо дані виводяться у необробленому форматі (raw)

https://bugzilla.redhat.com/847881

RFE: allow extra arguments (like --exclude) to tar-out

https://bugzilla.redhat.com/847880

tar-out should allow (or force) --numeric-owner

https://bugzilla.redhat.com/845522

guestfish "copy-out / localdir" command fails with "No such file or directory"

https://bugzilla.redhat.com/845488

Long filenames on NTFS cause tar-out, copy-out etc to fail with error "Cannot open: File name too long"

https://bugzilla.redhat.com/842307

RFE: Need help designing and implementing selinux policy for libguestfs/sVirt

https://bugzilla.redhat.com/840572

virt-make-fs / tar-in має підтримувати vfat належним чином

https://bugzilla.redhat.com/840115

guestfish touch problem - case_sensitive_path API expects the file to exist

https://bugzilla.redhat.com/836710

Втрата даних під час запису до файлів дисків у форматі qcow2

https://bugzilla.redhat.com/834712

lvresize, lvresize-free fail unnecessarily if you don’t change the size of the LV: "New size (nn extents) matches existing size (nn extents)"

https://bugzilla.redhat.com/824716

compress-device-out didn’t support bzip2

https://bugzilla.redhat.com/824043

guestfish unrecognized mount option gives confusing error message

https://bugzilla.redhat.com/823887

Файли із китайськими ієрогліфами у назвах не можна створити у файловій системі vfat

https://bugzilla.redhat.com/823885

virt-make-fs cannot create vfat filesystem containing filesystems with Chinese characters

https://bugzilla.redhat.com/823883

virt-make-fs -t fat не працює, повідомляючи про незрозумілу помилку

https://bugzilla.redhat.com/823821

Inspection fails when /etc/HOSTNAME is empty

https://bugzilla.redhat.com/801117

libguestfs cannot get icon for Windows 8

https://bugzilla.redhat.com/798979

Ubuntu install CDs from oneiric onwards are not recognized: "multi-boot operating systems are not supported"

https://bugzilla.redhat.com/782167

libguestfs doesn’t recognize Windows Dynamic disks in some configurations, eg. spanned

https://bugzilla.redhat.com/713678

Not all febootstrap messages are redirected to log callbacks

https://bugzilla.redhat.com/627675

libguestfs inspector code cannot handle /dev/disk/by-id/* paths

https://bugzilla.redhat.com/602997

part-get-bootable gives wrong result with an unordered part layout

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

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: