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


نام (NAME)
       guestfs-release-notes-1.54 - یادداشت‌های انتشار نسخه ۱.۵۴ ابزار
       libguestfs

یادداشت‌های انتشار LIBGUESTFS 1.54 (RELEASE NOTES FOR LIBGUESTFS 1.54)
       این‌ها یادداشت‌های انتشار نسخه پایدار ۱.۵۴ از libguestfs هستند.  این سند
       تغییرات عمده از نسخه ۱.۵۲ را تشریح می‌کند.

       نسخه 1.54.0 از Libguestfs در ۸ اکتبر ۲۰۲۴ منتشر شد.

   بازرسی (Inspection)
       افزودن شناسایی Circle Linux (توسط Bella Zhang).

       افزودن پشتیبانی از LoongArch (توسط liuxiang).

       افزودن شناسایی Kylin (توسط grass-lu).

       افزودن شناسایی openEuler (توسط Wang Guoquan).

       اکنون "PARTUUID" و "PARTLABEL" در فایل /etc/fstab مهمان شناسایی و تحلیل
       می‌شوند.

   رابط برنامه‌نویسی کاربردی (API)
       توابع جدید API شامل "findfs_partuuid" و "findfs_partlabel". از این
       توابع می‌توان برای جستجوی کارآمد یک سیستم‌فایل بر اساس UUID یا برچسب
       پارتیشن GPT استفاده کرد.

       پشتیبانی از انواع دستگاه‌های غیرفعال یا کم‌کاربرد زیر حذف شده است:
       Gluster، Sheepdog، TFTP.

       افزودن الگوریتم خلاصه‌سازی پیام GOST R34.11-94 به توابع API مربوط به
       checksum (توسط Alexey Shabalin).

       امکان استفاده از نشانی‌های اینترنتی "nbd+unix://" (NBD روی سوکت دامنه
       یونیکس) در guestfish و سایر بخش‌ها.

       توابع مختلف "part_*" (پارتیشن) مربوط به GPT بازپیاده‌سازی شده‌اند تا به
       جای sgdisk از sfdisk بسته util-linux استفاده کنند. بسته util-linux به
       طور گسترده‌تری در دسترس است، بنابراین این کار در حالت معمول وابستگی‌ها را
       کاهش می‌دهد. یک API اختیاری باقی مانده است که همچنان از sgdisk استفاده
       می‌کند. (با تشکر از Yongkui Guo).

       افزودن گزینه فرعی "cipher" به "cryptsetup_open" (توسط Jonatan Pålsson).

       به دلیل وجود یک اشکال، تابع API با نام "part_get_gpt_attributes" ممکن
       بود مقدار بازگشتی را از ۶۴ به ۳۲ بیت کوتاه کند. این مشکل رفع شده است.

   تغییرات ساخت (Build changes)
       رفع سازگاری btrfs با تغییرات هسته در لینوکس 6.7.

       حذف برخی کدهای سازگاری برای نسخه‌های util-linux (sfdisk) قبل از سال
       ۲۰۱۴.

       انتقال CFLAGS هنگام ساخت بایندرهای Perl. به طور خاص این بدان معناست که
       -g باید به درستی منتقل شود و نمادهای اشکال‌زدایی (debugging symbols) را
       فعال کند.

       رفع مشکل ساخت در macOS (توسط Antonio Caggiano).

   بخش‌های داخلی (Internals)
       ابزار Libguestfs اکنون دیگر استفاده از "LIBGUESTFS_BACKEND=direct" را
       توصیه نخواهد کرد. این مورد قبلاً هنگامی که libvirt موفق به راه‌اندازی
       اپلاینس نمی‌شد نمایش داده می‌شد. با این حال به نظر می‌رسد که این پیام
       اکنون بیش از فایده، آسیب می‌رساند.

       رفع تولید پارامتر --chown در virt-customize (توسط Yongkui Guo).

       در اپلاینس، کاهش زمان راه‌اندازی هنگامی که به dhcp نیازی نیست (توسط Olaf
       Hering).

       یک بن‌بست (deadlock) در اپلاینس که ناشی از یک پسرفت (regression) در
       لینوکس 6.11 بود دور زده شد. این بن‌بست در لینوکس 6.12 نیز برطرف شد.

   اشکالات رفع‌شده (Bugs fixed)
       https://bugzilla.redhat.com/2303267
           قفل‌شدن‌های نادر هنگام راه‌اندازی اپلاینس، در زمان 'echo noop' در
           /sys/block/{h,s,ub,v}d*/queue/scheduler

       https://issues.redhat.com/browse/RHEL-35998
           حذف وابستگی libguestfs -> gdisk

       https://issues.redhat.com/browse/RHEL-46596
           بخش بازرسی libguestfs با PARTLABEL=<label> در /etc/fstab آشنایی
           ندارد

       https://github.com/libguestfs/libguestfs/issues/136
           1.52.0: شکست آزمون‌های c_api/tests مربوط به btrfs (عدم امکان ایجاد
           گروه سهمیه: آرگومان نامعتبر)

       https://github.com/libguestfs/libguestfs/issues/138
           نام نادرست استثنا (exception) در راهنمای پایتون

       https://github.com/libguestfs/libguestfs/issues/145
            1.52.1: Rust test 410_close_event fails

همچنین ببینید (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)
       Alexey Shabalin
       Andi Chandler
       Antonio Caggiano
       Bella Zhang
       grass-lu
       Jonatan Pålsson
       Jürgen Hötzel
       liuxiang
       Olaf Hering
       Richard W.M. Jones
       Wang Guoquan
       Yuri Chornoivan
       zhanchun li

حق نشر (COPYRIGHT)
       Copyright (C) 2009-2025 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) را اجرا کرده و خروجی کامل و
           ویرایش‌نشده آن را در گزارش اشکال قرار دهید.

libguestfs-1.60.1                 2026-07-14     guestfs-release-notes-1.54(1)