guestfs-release-notes-1.48(1) Virtualization Support guestfs-release-notes-1.48(1)

guestfs-release-notes - یادداشت‌های انتشار libguestfs

این یادداشت‌های انتشار برای نگارش پایدار 1.48 از libguestfs است. این سند تغییرات عمده از نگارش 1.46 به بعد را شرح می‌دهد.

نگارش 1.48.0 از Libguestfs در ۱۴ مارس ۲۰۲۲ منتشر شد.

قابلیت‌های کم‌استفاده، آزمایشی یا ناامن زیر حذف شده‌اند:

قابلیت «Libguestfs live» یک ویژگی آزمایشی بود که (از نظر تئوری) به شما اجازه می‌داد به نمونه‌ای موجود از دیمن libguestfs در یک ماشین مهمانِ در حال اجرا متصل شوید. اگر تمایل به انجام چنین کاری دارید، توصیه می‌کنیم در عوض qemu-guest-agent را روی مهمان نصب کرده و از رابط‌های برنامه‌نویسی (API) ارائه‌شده توسط آن استفاده کنید. بک‌اند مرتبط "unix:" حذف شده است. گزینهٔ --live در guestfish(1) و guestmount(1) اکنون خطا چاپ می‌کند.

بک‌اند لینوکس حالت کاربر ("uml") حذف شده است. این یک هایپروایزر جایگزین بود که می‌توانست به جای qemu استفاده شود. این بک‌اند دارای محدودیت‌های بسیاری از جمله عدم پشتیبانی از شبکه و نبود قابلیت‌های بومی qemu مانند qcow2 یا دیسک‌های مبتنی بر شبکه بود. علاوه بر این، سرعت آن از KVM کمتر بود و عملکردهای خاصی نظیر بارگذاری/بارگیری حجیم به‌شدت کُند بودند. همچنین قابلیت UML در لینوکس که این بک‌اند بر پایه آن کار می‌کرد، اغلب به درستی عمل نمی‌کند.

رابط‌های برنامه‌نویسی 9pfs شامل "guestfs_list_9p" و "guestfs_mount_9p" منسوخ شده‌اند و اکنون خطا بازمی‌گردانند. این توابع مربوط به یک ویژگی آزمایشی برای انتقال مستقیم (passthrough) فایل‌سیستم‌های میزبان به اپلاینس (appliance) بودند. برای کارکرد آن، لازم بود خط فرمان qemu به‌صورت دستی تغییر داده شود و همچنین با مدل کلی libguestfs سازگاری مناسبی نداشت.

تابع "guestfs_add_drive" دیگر از اتصال گرم (افزودن درایو پس از راه‌اندازی) پشتیبانی نمی‌کند، و "guestfs_remove_drive" نیز منسوخ شده و اکنون یک خطا بازمی‌گرداند. اتصال گرم یک قابلیت ناموفق بود که پیاده‌سازی و نگهداری آن پیچیدگی زیادی داشت و همچنین کُند و ناامن بود. این ویژگی تنها با بک‌اند غیرپیش‌فرض libvirt کار می‌کرد و هرگز در بک‌اند پیش‌فرض "direct" پیاده‌سازی نشد.

اصلاح تخصیص و آزادسازی حافظهٔ فهرست‌های رشته در بایندینگ‌های golang (توسط Laszlo Ersek).

اصلاحات متعدد در بایندینگ‌های OCaml: رفع هشدارها، افزایش حداقل نگارش به OCaml 4.04 و جایگزینی قابلیت‌های گوناگون منسوخ‌شده با ویژگی‌های مدرن OCaml.

اجرای دستور "make distclean" در دایرکتوری rust اکنون فایل‌های موقت cargo را به‌طور کامل پاکسازی می‌کند.

اصلاح بازرسی نگارش‌های جدید Pardus GNU/Linux (توسط Laszlo Ersek).

افزودن پشتیبانی از Kylin (توسط Laszlo Ersek).

افزودن پشتیبانی از Rocky Linux (توسط Neil Hanlon).

بازرسی مهمان‌هایی که از رمزنگاری LUKS بر روی حجم‌های منطقی LVM استفاده می‌کنند اکنون باید بدون مشکل کار کند (توسط Laszlo Ersek).

رابط‌های برنامه‌نویسی جدید

هیچ API جدیدی در libguestfs 1.48 اضافه نشده است.

سایر تغییرات API

توابع "guestfs_list_9p" و "guestfs_mount_9p" منسوخ شده‌اند و اکنون خطا بازمی‌گردانند.

تابع "guestfs_remove_drive" منسوخ شده و اکنون خطا بازمی‌گرداند.

در تابع "guestfs_xfs_admin" پارامتر "lazycounter" منسوخ شده است، چرا که دیگر در نگارش‌های اخیر XFS پشتیبانی نمی‌شود.

توابع مرتبط با پارتیشن‌ها اکنون با جدول‌های پارتیشن ناقص یا خراب MBR که توسط dosfstools نسخهٔ ۴.۲ یا بالاتر ایجاد شده‌اند، سازگاری دارند (توسط Laszlo Ersek).

در تابع "guestfs_md_create" پارامتر "chunk" نباید همراه با RAID 1 استفاده شود. پیش‌تر این پارامتر مجاز بود ولی نادیده گرفته می‌شد، اما اکنون منجر به خطا می‌شود (توسط Laszlo Ersek).

رفع و/یا بررسی و مهار هشدارهای متعدد کامپایلر (توسط Laszlo Ersek).

اصلاح نحوهٔ شناسایی کتابخانهٔ اختیاری Yara با استفاده از pkg-config به جای بررسی مستقیم فایل کتابخانه/سرآیند (توسط Laszlo Ersek).

به‌روزرسانی قواعد نادیده‌گیری (suppressions) ابزار valgrind برای glibc 2.35، OCaml 4.13 و libvirt 7.7. اجرای "make check-valgrind" دوباره کار می‌کند.

در صورت استفاده از libvirt نسخهٔ ۳.۸.۰ یا بالاتر، اکنون به جای اضافه کردن پارامترها به خط فرمان qemu، از عنصر <interface> برای ایجاد رابط شبکهٔ اپلاینس استفاده می‌شود (توسط Laszlo Ersek).

صفحهٔ guestfs-release-notes(1) یک پیوند خراب بود، اما اکنون به عنوان صفحه‌ای جدید که به یادداشت‌های انتشار هر نگارش پایدار پیوند می‌دهد، بازیابی شده است.

استفادهٔ صحیح از تابع strerror_r(3) در libc به دلیل امضاهای متفاوت در glibc و سایر پیاده‌سازی‌های libc دشوار است. یک تابع پوششی (wrapper) با نام "guestfs_int_strerror" برای پنهان کردن این تفاوت‌ها ایجاد شده است.

[RFE] libguestfs: افزودن پشتیبانی از Rocky Linux
رفع اشکال استفاده از strerror_r که باعث خرابی پیام‌های خطا می‌شد
xfs-admin: ناتوانی در غیرفعال کردن lazy-counters روی فایل‌سیستم V5
RFE: عدم موفقیت virt-inspector در تشخیص توزیع و برنامه‌ها در ایمیج Kylin-Desktop-V10
RFE: عدم موفقیت virt-inspector در تشخیص توزیع در ایمیج Pardus-19.5
دور زدن اشکال mkfs.vfat در نوشتن فایل‌سیستم/جدول پارتیشن خراب هنگام استفاده روی کل دستگاه بلوکی
RFE: ناتوانی Virt-v2v در تبدیل مهمان‌هایی که دارای پارتیشن رمزنگاری‌شده هستند

guestfs-examples(1), guestfs-faq(1), guestfs-performance(1), guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1), http://libguestfs.org

Copyright (C) 2009-2025 Red Hat Inc.

این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU GPL) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است؛ چه نگارش ۲ مجوز یا (به انتخاب خودتان) هر نگارش بالاتری، بازتوزیع کرده و/یا تغییر دهید.

این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر «مجوز عمومی همگانی گنو» را مطالعه کنید.

شما باید به همراه این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به نشانی زیر مکاتبه کنید: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

برای مشاهدهٔ فهرستی از باگ‌های ثبت‌شده برای libguestfs، از این پیوند استفاده کنید: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

برای ثبت یک باگ جدید برای libguestfs، از این پیوند استفاده کنید: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

هنگام گزارش یک باگ، لطفاً موارد زیر را ارائه دهید:

  • نگارش libguestfs.
  • نحوهٔ دریافت libguestfs (برای نمونه، نام توزیع لینوکس، کامپایل‌شده از سورس و غیره).
  • شرح دقیق باگ و ارائهٔ روشی برای بازتولید آن.
  • دستور libguestfs-test-tool(1) را اجرا کرده و خروجی کامل و ویرایش‌نشده آن را در گزارش باگ قرار دهید.
2026-07-14 libguestfs-1.60.1