| guestfs-release-notes-1.60(1) | Virtualization Support | guestfs-release-notes-1.60(1) |
نام (NAME)
guestfs-release-notes - یادداشتهای انتشار libguestfs
یادداشتهای انتشار LIBGUESTFS 1.60 (RELEASE NOTES FOR LIBGUESTFS 1.60)
این سند حاوی یادداشتهای انتشار نسخه پایدار libguestfs 1.60 است. در اینجا تغییرات عمده نسبت به نسخه 1.58 شرح داده شده است.
بسته Libguestfs 1.60.0 در تاریخ ۹ ژوئیه ۲۰۲۶ منتشر شد.
بازرسی سیستم (Inspection)
افزودن پشتیبانی از توزیعهای لینوکس Kylin، NeoKylin و Anolis (توسط grass lu).
مهمانهایی که از جدول پارتیشن Veritas استفاده میکنند (که نوع پارتیشن Sun را مجدداً استفاده میکند) اکنون قابل بازرسی هستند.
ضدویروس Windows Defender در صورت وجود در مهمانهای ویندوزی اکنون شناسایی میشود (Susant Sahani).
رابط برنامهنویسی (API)
رابط برنامهنویسی جدید "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).
ابزارها (Tools)
زیردستور جدید "not" در guestfish(1)، که وضعیت یک دستور را نقیض (وارونه) میکند.
پیوستهای زبانهای برنامهنویسی (Language bindings)
پیوستهای GObject و Vala حذف شدند. این پیوستها پیشتر در libguestfs 1.56 منسوخ شده بودند (Cole Robinson).
مستندات (Documentation)
تمام اطلاعات مربوط به اسکریپتهای firstboot منتقل شده و در بخش "FIRSTBOOT" در virt-customize(1) تجمیع شدند (Srihari Parimi).
اصلاح مستندات API تابع "guestfs_copy_out".
تغییرات ساخت (Build changes)
اصلاح وبهوکهای 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).
بخشهای داخلی (Internals)
سادهسازی آزمون مشخصههای 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) شماره ۰، ۱ و ۲ هنگام اجرای زیردستورها.
اشکالات رفعشده (Bugs fixed)
- https://issues.redhat.com/browse/RHEL-129145
- درخواست قابلیت: تشخیص ضدویروس Windows Defender در صورت فعال بودن در نصب پیشفرض Windows 11
- https://issues.redhat.com/browse/RHEL-143673
- افزودن API جدید xfs_info2 برای ارائه اطلاعات نسخه XFS
- https://issues.redhat.com/browse/RHEL-165220
- شکست 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
- https://issues.redhat.com/browse/RHEL-165677
- توقف استفاده از xfs_repair -m به دلیل اینکه حافظه مورد نیاز متناسب با اندازه سیستمفایل تغییر کرده و ریسک بالایی دارد
- https://issues.redhat.com/browse/RHEL-170864
- شکست virt-v2v با کلیدهای باینری LUKS در [virt-v2v]
- https://issues.redhat.com/browse/RHEL-171895
- شکست virt-v2v با کلیدهای باینری LUKS در [libguestfs]
- https://issues.redhat.com/browse/RHEL-171896
- شکست virt-v2v با کلیدهای باینری LUKS در [guestfs-tools]
- https://issues.redhat.com/browse/RHEL-178287
- شکست virt-v2v حین مهاجرت ماشینهای مجازی RHEL 7 به دلیل خطاهای سیستمفایل XFS، که احتمالاً ناشی از اجرای xfs_repair در RHEL 10.1 در برابر سیستمفایل XFS متعلق به RHEL 7 است
- https://issues.redhat.com/browse/RHEL-178556
- استفاده از bind mount برای بازنویسی /sysroot/etc/resolv.conf در طول عملیات "sh"
- https://github.com/libguestfs/libguestfs/issues/290
- 1.58.0: ارجاع تعریفنشده به optgroup_selinuxrelabel_available
- https://github.com/libguestfs/libguestfs/issues/292
- در guestfs_int_get_cpu_model: استفاده از -cpu max برای riscv
- https://github.com/libguestfs/libguestfs/issues/312
- تغییر ساختار به po4a
- https://github.com/libguestfs/libguestfs/issues/336
- آزمون ناپایدار network/test-network.sh
- https://github.com/libguestfs/libguestfs/issues/359
- 1.58.1: پیوستهای Lua به libxml2 متصل میشوند اما به نظر نمیرسد از آن استفاده کنند
همچنین ببینید (SEE ALSO)
guestfs-examples(1), guestfs-faq(1), guestfs-performance(1), guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1), http://libguestfs.org
نویسندگان (AUTHORS)
- Adolfo Jayme Barrientos
- Anders Roxell
- Andi Chandler
- Arif Budiman
- Christopher Byrne
- Cole Robinson
- David Runge
- Emilio Herrera
- Ettore Atalan
- Fco. Javier F. Serrador
- grimst
- Hela Basa
- Hilko Bengen
- Jan Kuparinen
- Krascovict Petrov
- Léane GRASSER
- Nathan95
- Pavel Borecki
- Piotr Drąg
- Rafael Fontenelle
- Richard W.M. Jones
- Ricky Tigg
- shivanayak
- Srihari Parimi
- Surya Gupta
- Susant Sahani
- Temuri Doghonadze
- Tian Shixiong
- Yuri Chornoivan
- zhanchun li
حق نشر (COPYRIGHT)
Copyright (C) 2009-2026 Red Hat Inc.
مجوز (LICENSE)
این برنامه نرمافزار آزاد است؛ شما میتوانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) طبق آنچه توسط بنیاد نرمافزارهای آزاد منتشر شده است، بازتوزیع کرده و/یا تغییر دهید؛ چه نسخه ۲ مجوز یا (به انتخاب خودتان) هر نسخه پس از آن.
این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی تجاریبودن یا مناسببودن برای یک هدف خاص. برای جزئیات بیشتر به «مجوز عمومی همگانی گنو» مراجعه فرمایید.
شما باید به همراه این برنامه نسخهای از «مجوز عمومی همگانی گنو» را دریافت کرده باشید؛ در غیر این صورت به نشانی Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA نامه بنویسید.
اشکالات (BUGS)
برای دریافت فهرستی از اشکالات 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 |