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

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

این سند حاوی یادداشت‌های انتشار نسخه پایدار libguestfs 1.60 است. در اینجا تغییرات عمده نسبت به نسخه 1.58 شرح داده شده است.

بسته Libguestfs 1.60.0 در تاریخ ۹ ژوئیه ۲۰۲۶ منتشر شد.

افزودن پشتیبانی از توزیع‌های لینوکس Kylin، NeoKylin و Anolis (توسط grass lu).

مهمان‌هایی که از جدول پارتیشن Veritas استفاده می‌کنند (که نوع پارتیشن Sun را مجدداً استفاده می‌کند) اکنون قابل بازرسی هستند.

ضدویروس Windows Defender در صورت وجود در مهمان‌های ویندوزی اکنون شناسایی می‌شود (Susant Sahani).

رابط برنامه‌نویسی جدید "guestfs_xfs_info2". این تابع مشابه API موجود "guestfs_xfs_info" است اما یک جدول هش انعطاف‌پذیر برمی‌گرداند که امکان افزودن فیلدهای بیشتری را در آینده به خروجی فراهم می‌سازد.

تابع "guestfs_get_hv" اکنون هایپروایزر پیش‌فرض را برمی‌گرداند.

تابع "guestfs_tar_in" گزینه جدیدی با نام "keepdirlink" اضافه کرده است که پرچم --keep-directory-symlink در tar را کنترل می‌کند (Anders Roxell).

گزینه "maxmem" در تابع "guestfs_xfs_repair" اکنون در صورتی که مقدار maxmem بیش از حد کوچک باشد، پیام‌های خطای بهتری تولید می‌کند.

همه توابعی که پارامترهای کلید LUKS را دریافت می‌کنند اکنون می‌توانند از پیشوندهای "text:..." یا "base64:..." استفاده کنند، که اجازه می‌دهد کلیدهای باینری به صورت base64 کدگذاری شده و به این APIها ارسال شوند. ابزار guestfish(1) و سایر ابزارهایی که فایل کلید دریافت می‌کنند اکنون اجازه می‌دهند از فایل باینری استفاده شود.

توابع "guestfs_command*" و "guestfs_sh*" اکنون از یک bind mount برای جایگزینی "/etc/resolv.conf" درون ماشین مهمان استفاده می‌کنند، که اجازه می‌دهد این دستورات حتی هنگامی که این فایل به عنوان تغییرناپذیر (immutable) علامت‌گذاری شده است (تغییر رایجی که مدیران سیستم اعمال می‌کنند) به کار خود ادامه دهند (Srihari Parimi).

زیردستور جدید "not" در guestfish(1)، که وضعیت یک دستور را نقیض (وارونه) می‌کند.

پیوست‌های GObject و Vala حذف شدند. این پیوست‌ها پیش‌تر در libguestfs 1.56 منسوخ شده بودند (Cole Robinson).

تمام اطلاعات مربوط به اسکریپت‌های firstboot منتقل شده و در بخش "FIRSTBOOT" در virt-customize(1) تجمیع شدند (Srihari Parimi).

اصلاح مستندات API تابع "guestfs_copy_out".

اصلاح وبهوک‌های Weblate (i18n) (توسط Rafael Fontenelle).

اصلاح بیلد در شرایطی که libselinux در دسترس نیست (David Runge).

یکپارچه‌سازی مداوم (CI) گیت‌هاب اکنون به طور جامع‌تری استفاده می‌شود (Cole Robinson).

اصلاح دستور "make dist" هنگامی که پیوست‌های برخی از زبان‌ها غیرفعال است (Cole Robinson).

گزینه "./configure --with-qemu" حذف شد.

متغیر "CFLAGS" اکنون در ابتدای فلگ‌های پیش‌فرض اضافه می‌شود، که اجازه می‌دهد فلگ‌های پیش‌فرض بازنویسی شوند. علاوه بر این، پرچم -fPIC به فلگ‌های پیش‌فرض افزوده شد (Cole Robinson).

برخی اسکریپت‌های تکمیل خودکار bash که دیگر توسط libguestfs استفاده نمی‌شدند (و به guestfs-tools منتقل شده بودند) حذف گردیدند. همچنین گزینه‌های جدید "./configure --with-bash-completion" و "./configure --with-bash-completion-dir" افزوده شدند (Christopher Byrne).

دیگر پیونددهی بیش از حد (over-link) در پیوست‌های Lua با libxml2 و libvirt صورت نمی‌گیرد (David Runge).

بهبود پشتیبانی اپلاینس در آرچ لینوکس (David Runge).

ساده‌سازی آزمون مشخصه‌های qemu. بیشتر کد به طور کامل حذف شد و همچنین هنگام تشخیص در دسترس بودن KVM، دیگر یک ماشین مهمان خالی راه‌اندازی نمی‌کنیم (با تشکر از Daniel Berrange). همچنین اگر qemu هنگام شناسایی در راه‌اندازی با خطا مواجه شود، اکنون خروجی خطای استاندارد (stderr) چاپ می‌شود (Hilko Bengen).

استفاده از -cpu max در معماری RISC-V (با تشکر از Apache553).

پشتیبانی بسیار مقدماتی از سیستم‌فایل اپل (APFS) در فدورا افزوده شد.

بسیاری از نشت‌های حافظه و توصیف‌گر فایل (fd) که توسط Claude Code شناسایی شده بودند، برطرف شدند (shivanayak).

در اپلاینس libguestfs، تعداد نگاشت‌های حافظه قبل از پردازش (pre-process memory maps) افزایش یافت. این تغییر ممکن است به xfs_repair اجازه دهد روی سیستم‌های فایل بزرگ‌تر کار کند (Eric Sandeen).

اصلاح DHCP در ماشین‌های سریع با وادار کردن آن به انتظار برای دریافت آدرس هنگام فعال بودن شبکه. علاوه بر این از "dhcpcd --debug" استفاده می‌شود که مشاهده عملکرد درخواست‌های DHCP را آسان‌تر می‌کند (Cole Robinson).

بهبودهای خروجی اشکال‌زدایی (Surya Gupta, Srihari Parimi).

اصلاح پیوند نمادین bin/sbin در فدورا برای کاهش پیام‌های اضافی (Cole Robinson).

بازنویسی پیاده‌سازی xfs_repair و luks_* در دیمن با زبان OCaml.

اطمینان از باز بودن توصیف‌گرهای فایل (fds) شماره ۰، ۱ و ۲ هنگام اجرای زیردستورها.

درخواست قابلیت: تشخیص ضدویروس Windows Defender در صورت فعال بودن در نصب پیش‌فرض Windows 11
افزودن API جدید xfs_info2 برای ارائه اطلاعات نسخه XFS
شکست virt-v2v با جدول پارتیشن sun و فضای ذخیره‌سازی Veritas به همراه: parted exited with status 1: Warning: The disk CHS geometry reported by the operating system does not match the geometry stored on the disk label
توقف استفاده از xfs_repair -m به دلیل اینکه حافظه مورد نیاز متناسب با اندازه سیستم‌فایل تغییر کرده و ریسک بالایی دارد
شکست virt-v2v با کلیدهای باینری LUKS در [virt-v2v]
شکست virt-v2v با کلیدهای باینری LUKS در [libguestfs]
شکست virt-v2v با کلیدهای باینری LUKS در [guestfs-tools]
شکست virt-v2v حین مهاجرت ماشین‌های مجازی RHEL 7 به دلیل خطاهای سیستم‌فایل XFS، که احتمالاً ناشی از اجرای xfs_repair در RHEL 10.1 در برابر سیستم‌فایل XFS متعلق به RHEL 7 است
استفاده از bind mount برای بازنویسی /sysroot/etc/resolv.conf در طول عملیات "sh"
1.58.0: ارجاع تعریف‌نشده به optgroup_selinuxrelabel_available
در guestfs_int_get_cpu_model: استفاده از -cpu max برای riscv
تغییر ساختار به po4a
آزمون ناپایدار network/test-network.sh
1.58.1: پیوست‌های Lua به libxml2 متصل می‌شوند اما به نظر نمی‌رسد از آن استفاده کنند

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-2026 Red Hat Inc.

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

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

شما باید به همراه این برنامه نسخه‌ای از «مجوز عمومی همگانی گنو» را دریافت کرده باشید؛ در غیر این صورت به نشانی 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