.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Podwrapper::Man 1.60.1 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "guestfs-release-notes-1.48 1" .TH guestfs-release-notes-1.48 1 2026-07-14 libguestfs-1.60.1 "Virtualization Support" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" guestfs\-release\-notes \- یادداشت‌های انتشار libguestfs .SH "یادداشت‌های انتشار LIBGUESTFS 1.48 (RELEASE NOTES FOR LIBGUESTFS 1.48)" .IX Header "RELEASE NOTES FOR LIBGUESTFS 1.48" این یادداشت‌های انتشار برای نگارش پایدار 1.48 از libguestfs است. این سند تغییرات عمده از نگارش 1.46 به بعد را شرح می‌دهد. .PP نگارش 1.48.0 از Libguestfs در \fB۱۴ مارس ۲۰۲۲\fR منتشر شد. .SS "برخی قابلیت‌های حذف‌شده (Some features removed)" .IX Subsection "Some features removed" قابلیت‌های کم‌استفاده، آزمایشی یا ناامن زیر حذف شده‌اند: .PP قابلیت «Libguestfs live» یک ویژگی آزمایشی بود که (از نظر تئوری) به شما اجازه می‌داد به نمونه‌ای موجود از دیمن libguestfs در یک ماشین مهمانِ در حال اجرا متصل شوید. اگر تمایل به انجام چنین کاری دارید، توصیه می‌کنیم در عوض qemu\-guest\-agent را روی مهمان نصب کرده و از رابط‌های برنامه‌نویسی (API) ارائه‌شده توسط آن استفاده کنید. بک‌اند مرتبط \f(CW\*(C`unix:\*(C'\fR حذف شده است. گزینهٔ \&\fI\-\-live\fR در \fBguestfish\fR\|(1) و \fBguestmount\fR\|(1) اکنون خطا چاپ می‌کند. .PP بک‌اند لینوکس حالت کاربر (\f(CW\*(C`uml\*(C'\fR) حذف شده است. این یک هایپروایزر جایگزین بود که می‌توانست به جای qemu استفاده شود. این بک‌اند دارای محدودیت‌های بسیاری از جمله عدم پشتیبانی از شبکه و نبود قابلیت‌های بومی qemu مانند qcow2 یا دیسک‌های مبتنی بر شبکه بود. علاوه بر این، سرعت آن از KVM کمتر بود و عملکردهای خاصی نظیر بارگذاری/بارگیری حجیم به‌شدت کُند بودند. همچنین قابلیت UML در لینوکس که این بک‌اند بر پایه آن کار می‌کرد، اغلب به درستی عمل نمی‌کند. .PP رابط‌های برنامه‌نویسی 9pfs شامل \f(CW\*(C`guestfs_list_9p\*(C'\fR و \f(CW\*(C`guestfs_mount_9p\*(C'\fR منسوخ شده‌اند و اکنون خطا بازمی‌گردانند. این توابع مربوط به یک ویژگی آزمایشی برای انتقال مستقیم (passthrough) فایل‌سیستم‌های میزبان به اپلاینس (appliance) بودند. برای کارکرد آن، لازم بود خط فرمان qemu به‌صورت دستی تغییر داده شود و همچنین با مدل کلی libguestfs سازگاری مناسبی نداشت. .PP تابع \&\f(CW\*(C`guestfs_add_drive\*(C'\fR دیگر از اتصال گرم (افزودن درایو پس از راه‌اندازی) پشتیبانی نمی‌کند، و \f(CW\*(C`guestfs_remove_drive\*(C'\fR نیز منسوخ شده و اکنون یک خطا بازمی‌گرداند. اتصال گرم یک قابلیت ناموفق بود که پیاده‌سازی و نگهداری آن پیچیدگی زیادی داشت و همچنین کُند و ناامن بود. این ویژگی تنها با بک‌اند غیرپیش‌فرض libvirt کار می‌کرد و هرگز در بک‌اند پیش‌فرض "direct" پیاده‌سازی نشد. .SS "اتصال‌های زبان (Language bindings)" .IX Subsection "Language bindings" اصلاح تخصیص و آزادسازی حافظهٔ فهرست‌های رشته در بایندینگ‌های golang (توسط Laszlo Ersek). .PP اصلاحات متعدد در بایندینگ‌های OCaml: رفع هشدارها، افزایش حداقل نگارش به OCaml 4.04 و جایگزینی قابلیت‌های گوناگون منسوخ‌شده با ویژگی‌های مدرن OCaml. .PP اجرای دستور \f(CW\*(C`make distclean\*(C'\fR در دایرکتوری \fIrust\fR اکنون فایل‌های موقت cargo را به‌طور کامل پاکسازی می‌کند. .SS "بازرسی (Inspection)" .IX Subsection "Inspection" اصلاح بازرسی نگارش‌های جدید Pardus GNU/Linux (توسط Laszlo Ersek). .PP افزودن پشتیبانی از Kylin (توسط Laszlo Ersek). .PP افزودن پشتیبانی از Rocky Linux (توسط Neil Hanlon). .PP بازرسی مهمان‌هایی که از رمزنگاری LUKS بر روی حجم‌های منطقی LVM استفاده می‌کنند اکنون باید بدون مشکل کار کند (توسط Laszlo Ersek). .SS "رابط برنامه‌نویسی (API)" .IX Subsection "API" \fIرابط‌های برنامه‌نویسی جدید\fR .IX Subsection "New APIs" .PP هیچ API جدیدی در libguestfs 1.48 اضافه نشده است. .PP \fIسایر تغییرات API\fR .IX Subsection "Other API changes" .PP توابع \&\f(CW\*(C`guestfs_list_9p\*(C'\fR و \f(CW\*(C`guestfs_mount_9p\*(C'\fR منسوخ شده‌اند و اکنون خطا بازمی‌گردانند. .PP تابع \&\f(CW\*(C`guestfs_remove_drive\*(C'\fR منسوخ شده و اکنون خطا بازمی‌گرداند. .PP در تابع \f(CW\*(C`guestfs_xfs_admin\*(C'\fR پارامتر \f(CW\*(C`lazycounter\*(C'\fR منسوخ شده است، چرا که دیگر در نگارش‌های اخیر XFS پشتیبانی نمی‌شود. .PP توابع مرتبط با پارتیشن‌ها اکنون با جدول‌های پارتیشن ناقص یا خراب MBR که توسط dosfstools نسخهٔ ۴.۲ یا بالاتر ایجاد شده‌اند، سازگاری دارند (توسط Laszlo Ersek). .PP در تابع \f(CW\*(C`guestfs_md_create\*(C'\fR پارامتر \f(CW\*(C`chunk\*(C'\fR نباید همراه با RAID 1 استفاده شود. پیش‌تر این پارامتر مجاز بود ولی نادیده گرفته می‌شد، اما اکنون منجر به خطا می‌شود (توسط Laszlo Ersek). .SS "تغییرات ساخت (Build changes)" .IX Subsection "Build changes" رفع و/یا بررسی و مهار هشدارهای متعدد کامپایلر (توسط Laszlo Ersek). .PP اصلاح نحوهٔ شناسایی کتابخانهٔ اختیاری Yara با استفاده از pkg\-config به جای بررسی مستقیم فایل کتابخانه/سرآیند (توسط Laszlo Ersek). .PP به‌روزرسانی قواعد نادیده‌گیری (suppressions) ابزار valgrind برای glibc 2.35، OCaml 4.13 و libvirt 7.7. اجرای \f(CW\*(C`make check\-valgrind\*(C'\fR دوباره کار می‌کند. .PP در صورت استفاده از libvirt نسخهٔ ۳.۸.۰ یا بالاتر، اکنون به جای اضافه کردن پارامترها به خط فرمان qemu، از عنصر برای ایجاد رابط شبکهٔ اپلاینس استفاده می‌شود (توسط Laszlo Ersek). .PP صفحهٔ \fBguestfs\-release\-notes\fR\|(1) یک پیوند خراب بود، اما اکنون به عنوان صفحه‌ای جدید که به یادداشت‌های انتشار هر نگارش پایدار پیوند می‌دهد، بازیابی شده است. .SS "سازوکارهای داخلی (Internals)" .IX Subsection "Internals" استفادهٔ صحیح از تابع \fBstrerror_r\fR\|(3) در libc به دلیل امضاهای متفاوت در glibc و سایر پیاده‌سازی‌های libc دشوار است. یک تابع پوششی (wrapper) با نام \&\f(CW\*(C`guestfs_int_strerror\*(C'\fR برای پنهان کردن این تفاوت‌ها ایجاد شده است. .SS "باگ‌های برطرف‌شده (Bugs fixed)" .IX Subsection "Bugs fixed" .IP https://bugzilla.redhat.com/2030709 4 .IX Item "https://bugzilla.redhat.com/2030709" [RFE] libguestfs: افزودن پشتیبانی از Rocky Linux .IP https://bugzilla.redhat.com/2030396 4 .IX Item "https://bugzilla.redhat.com/2030396" رفع اشکال استفاده از strerror_r که باعث خرابی پیام‌های خطا می‌شد .IP https://bugzilla.redhat.com/2024022 4 .IX Item "https://bugzilla.redhat.com/2024022" xfs\-admin: ناتوانی در غیرفعال کردن lazy\-counters روی فایل‌سیستم V5 .IP https://bugzilla.redhat.com/1995391 4 .IX Item "https://bugzilla.redhat.com/1995391" RFE: عدم موفقیت virt\-inspector در تشخیص توزیع و برنامه‌ها در ایمیج Kylin\-Desktop\-V10 .IP https://bugzilla.redhat.com/1993842 4 .IX Item "https://bugzilla.redhat.com/1993842" RFE: عدم موفقیت virt\-inspector در تشخیص توزیع در ایمیج Pardus\-19.5 .IP https://bugzilla.redhat.com/1931821 4 .IX Item "https://bugzilla.redhat.com/1931821" دور زدن اشکال mkfs.vfat در نوشتن فایل‌سیستم/جدول پارتیشن خراب هنگام استفاده روی کل دستگاه بلوکی .IP https://bugzilla.redhat.com/1451665 4 .IX Item "https://bugzilla.redhat.com/1451665" RFE: ناتوانی Virt\-v2v در تبدیل مهمان‌هایی که دارای پارتیشن رمزنگاری‌شده هستند .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBguestfs\-examples\fR\|(1), \&\fBguestfs\-faq\fR\|(1), \&\fBguestfs\-performance\fR\|(1), \&\fBguestfs\-recipes\fR\|(1), \&\fBguestfs\-testing\fR\|(1), \&\fBguestfs\fR\|(3), \&\fBguestfish\fR\|(1), http://libguestfs.org .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" .IP "Laszlo Ersek" 4 .IX Item "Laszlo Ersek" .PD 0 .IP "Neil Hanlon" 4 .IX Item "Neil Hanlon" .IP "Richard W.M. Jones" 4 .IX Item "Richard W.M. Jones" .PD .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "COPYRIGHT" Copyright (C) 2009\-2025 Red Hat Inc. .SH "مجوز (LICENSE)" .IX Header "LICENSE" این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU GPL) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است؛ چه نگارش ۲ مجوز یا (به انتخاب خودتان) هر نگارش بالاتری، بازتوزیع کرده و/یا تغییر دهید. .PP این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر «مجوز عمومی همگانی گنو» را مطالعه کنید. .PP شما باید به همراه این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به نشانی زیر مکاتبه کنید: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA. .SH "گزارش باگ‌ها (BUGS)" .IX Header "BUGS" برای مشاهدهٔ فهرستی از باگ‌های ثبت‌شده برای libguestfs، از این پیوند استفاده کنید: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools .PP برای ثبت یک باگ جدید برای libguestfs، از این پیوند استفاده کنید: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools .PP هنگام گزارش یک باگ، لطفاً موارد زیر را ارائه دهید: .IP \(bu 4 نگارش libguestfs. .IP \(bu 4 نحوهٔ دریافت libguestfs (برای نمونه، نام توزیع لینوکس، کامپایل‌شده از سورس و غیره). .IP \(bu 4 شرح دقیق باگ و ارائهٔ روشی برای بازتولید آن. .IP \(bu 4 دستور \fBlibguestfs\-test\-tool\fR\|(1) را اجرا کرده و خروجی \fBکامل و ویرایش‌نشده\fR آن را در گزارش باگ قرار دهید.