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

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

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

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

اتصالات پایتون اکنون از "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 و همگام‌سازی دیسک‌ها داشته باشد).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

حذف وابستگی به dhcp-client در libguestfs
درخواست قابلیت (RFE): پشتیبانی از passt برای شبکه appliance، به عنوان بک‌اند شبکه فضای کاربری QEMU
استفاده از نوع ماشین q35 برای appliance مربوط به libguestfs
عدم کارکرد virt-dib با نسخه‌های جدیدتر diskimage-builder در RHEL8

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 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