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


نام (NAME)
       guestfs-release-notes - یادداشت‌های انتشار libguestfs

یادداشت‌های انتشار LIBGUESTFS 1.52 (RELEASE NOTES FOR LIBGUESTFS 1.52)
       این سند، یادداشت‌های انتشار نسخهٔ پایدار 1.52 از libguestfs است.  در
       اینجا تغییرات عمده نسبت به نسخهٔ 1.50 توصیف شده است.

       نسخهٔ 1.52.0 از libguestfs در ۵ ژانویه ۲۰۲۴ منتشر شد.

   اتصالات زبان (Language bindings)
       اتصالات پایتون اکنون از "bytes" (به جای "str") برای پیام فراخوانی
       بازگشتی رویداد (event callback) استفاده می‌کنند، چرا که ممکن است حاوی
       داده‌های اختیاری ۸ بیتی باشد (با تشکر از Yonatan Shtarkman).

       همچنین در اتصالات پایتون، یک خرابی (crash) نادر برطرف شده و از نشت
       حافظه در فراخوانی‌های بازگشتی رویداد جلوگیری شد (با تشکر از Yonatan
       Shtarkman، Laszlo Ersek، Eric Blake).

       پشتیبانی از OCaml 5 اضافه شد، و اکنون OCaml ≥ 4.07 حداقل نسخهٔ مورد نیاز
       است (با تشکر از Guillaume Munch-Maccagnoni، Jerry James، Josh Berdine،
       Jürgen Hötzel، Vincent Laviron).

       اتصالات OCaml اکنون در طول فراخوانی‌های "guestfs_close" قفل زمان‌اجرا
       (runtime lock) را آزاد می‌کنند، چرا که این فراخوانی ممکن است زمان‌بر باشد
       (برای مثال ممکن است نیاز به خاموش کردن appliance و همگام‌سازی دیسک‌ها
       داشته باشد).

   بازرسی (Inspection)
       پشتیبانی از OpencloudOS (cunshunxia@tencent).

   رابط برنامه‌نویسی (API)
       برچسب‌گذاری مجدد SELinux اکنون به‌صورت موازی اجرا می‌شود، به این معنی که
       بسیار سریع‌تر است (Andrey Drobyshev).

       افزودن پشتیبانی از روش‌های فشرده‌سازی lzma و zstd در APIهای tar (مانند
       "guestfs_tar_in") (Zixun LI).

       پیش از این، "guestfs_pvs_full" همیشه نام صحیح دستگاه‌ها را بازنمی‌گرداند.
       این مورد اکنون برطرف شده است.

       تابع "guestfs_btrfs_filesystem_balance" اصلاح شد تا اکنون با ابزارهای
       مدرن‌تر btrfs کار کند (Jürgen Hötzel).

   ابزارها (Tools)
       گزینهٔ --key در guestfish(1) اکنون نام‌های LVM مانند
       /dev/mapper/rhel_bootp--73--75--123-root را تشخیص می‌دهد (Laszlo Ersek).

       گزینهٔ --key در guestfish همچنین از گزینشگر جدید --key all:... برای
       آزمودن کلید یکسان روی تمام دستگاه‌ها پشتیبانی می‌کند.

       در guestmount(1) از فراخوانی fclose(NULL) در مسیرهای بروز خطا که ممکن
       بود در برخی پلتفرم‌ها منجر به خرابی (crash) شود، جلوگیری شد.

   تغییرات ساخت (Build changes)
       فایل "RELEASES" (که تاریخ‌های انتشار را فهرست می‌کرد) حذف شده و با یک
       ماکروی سادهٔ "RELEASE_DATE" در ./configure جایگزین شده است. این امر باید
       ساخت را ساده‌تر کند.

       به‌صورت اختیاری می‌توان از passt(1) برای شبکه استفاده کرد (Laszlo Ersek).

       اکنون در پلتفرم‌های Red Hat از dhcpcd(8) با اولویت بالاتری نسبت به
       dh-client استفاده می‌شود.

       وابستگی‌های قدیمی روبی "MiniTest" و "Test::Unit" با بستهٔ جدید "Minitest"
       جایگزین شدند.

       برطرف‌سازی مشکلات سازگاری با libxml2 2.12.

   سازوکار‌های داخلی (Internals)
       در معماری x86-64 اکنون هنگام اجرای appliance از نوع ماشین مدرن‌تر q35
       استفاده می‌شود. این کار باید عملکرد را کمی بهبود دهد و توجه توسعهٔ بیشتری
       از سوی جامعه qemu به آن اختصاص یافته است. این تغییر باید برای کاربران
       libguestfs نامحسوس باشد.

       برطرف‌سازی خطای segmentation fault در زمانی که متغیر محیطی "TERM" روی
       "dumb" تنظیم شده بود (Daisuke HATAYAMA).

       جلوگیری از نمایش هشدار در توزیع‌های جدید فدورا که فاقد /selinux هستند
       (Andrey Drobyshev).

       اصلاح ساخت در OpenSUSE LEAP 15 یا سایر توزیع‌ها با دستور file(1) که
       گزینهٔ -S را پشتیبانی نمی‌کرد (با تشکر از Olaf Hering).

   باگ‌های برطرف‌شده (Bugs fixed)
       https://bugzilla.redhat.com/2247057
           حذف وابستگی به dhcp-client در libguestfs

       https://bugzilla.redhat.com/2184967
           درخواست قابلیت (RFE): پشتیبانی از passt برای شبکه appliance، به
           عنوان بک‌اند شبکه فضای کاربری QEMU

       https://bugzilla.redhat.com/2168578
           استفاده از نوع ماشین q35 برای appliance مربوط به libguestfs

       https://bugzilla.redhat.com/1910039
           عدم کارکرد virt-dib با نسخه‌های جدیدتر diskimage-builder در RHEL8

همچنین ببینید (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)
       Andrey Drobyshev
       cunshunxia
       Emilio Herrera
       grimst
       HATAYAMA Daisuke
       Jan Kuparinen
       Jürgen Hötzel
       Laszlo Ersek
       Pavel Borecki
       Richard W.M. Jones
       Temuri Doghonadze
       Tian Shixiong
       Yuri Chornoivan
       Zixun 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.52(1)