.\" -*- 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.52 1" .TH guestfs-release-notes-1.52 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.52 (RELEASE NOTES FOR LIBGUESTFS 1.52)" .IX Header "RELEASE NOTES FOR LIBGUESTFS 1.52" این سند، یادداشت‌های انتشار نسخهٔ پایدار 1.52 از libguestfs است. در اینجا تغییرات عمده نسبت به نسخهٔ 1.50 توصیف شده است. .PP نسخهٔ 1.52.0 از libguestfs در \fB۵ ژانویه ۲۰۲۴\fR منتشر شد. .SS "اتصالات زبان (Language bindings)" .IX Subsection "Language bindings" اتصالات پایتون اکنون از \f(CW\*(C`bytes\*(C'\fR (به جای \f(CW\*(C`str\*(C'\fR) برای پیام فراخوانی بازگشتی رویداد (event callback) استفاده می‌کنند، چرا که ممکن است حاوی داده‌های اختیاری ۸ بیتی باشد (با تشکر از Yonatan Shtarkman). .PP همچنین در اتصالات پایتون، یک خرابی (crash) نادر برطرف شده و از نشت حافظه در فراخوانی‌های بازگشتی رویداد جلوگیری شد (با تشکر از Yonatan Shtarkman، Laszlo Ersek، Eric Blake). .PP پشتیبانی از OCaml 5 اضافه شد، و اکنون OCaml ≥ 4.07 حداقل نسخهٔ مورد نیاز است (با تشکر از Guillaume Munch\-Maccagnoni، Jerry James، Josh Berdine، Jürgen Hötzel، Vincent Laviron). .PP اتصالات OCaml اکنون در طول فراخوانی‌های \&\f(CW\*(C`guestfs_close\*(C'\fR قفل زمان‌اجرا (runtime lock) را آزاد می‌کنند، چرا که این فراخوانی ممکن است زمان‌بر باشد (برای مثال ممکن است نیاز به خاموش کردن appliance و همگام‌سازی دیسک‌ها داشته باشد). .SS "بازرسی (Inspection)" .IX Subsection "Inspection" پشتیبانی از OpencloudOS (cunshunxia@tencent). .SS "رابط برنامه‌نویسی (API)" .IX Subsection "API" برچسب‌گذاری مجدد SELinux اکنون به‌صورت موازی اجرا می‌شود، به این معنی که بسیار سریع‌تر است (Andrey Drobyshev). .PP افزودن پشتیبانی از روش‌های فشرده‌سازی lzma و zstd در APIهای tar (مانند \&\f(CW\*(C`guestfs_tar_in\*(C'\fR) (Zixun LI). .PP پیش از این، \&\f(CW\*(C`guestfs_pvs_full\*(C'\fR همیشه نام صحیح دستگاه‌ها را بازنمی‌گرداند. این مورد اکنون برطرف شده است. .PP تابع \&\f(CW\*(C`guestfs_btrfs_filesystem_balance\*(C'\fR اصلاح شد تا اکنون با ابزارهای مدرن‌تر btrfs کار کند (Jürgen Hötzel). .SS "ابزارها (Tools)" .IX Subsection "Tools" گزینهٔ \fI\-\-key\fR در \fBguestfish\fR\|(1) اکنون نام‌های LVM مانند \&\fI/dev/mapper/rhel_bootp\-\-73\-\-75\-\-123\-root\fR را تشخیص می‌دهد (Laszlo Ersek). .PP گزینهٔ \fI\-\-key\fR در guestfish همچنین از گزینشگر جدید \fI\-\-key\ all:...\fR برای آزمودن کلید یکسان روی تمام دستگاه‌ها پشتیبانی می‌کند. .PP در \fBguestmount\fR\|(1) از فراخوانی \f(CWfclose(NULL)\fR در مسیرهای بروز خطا که ممکن بود در برخی پلتفرم‌ها منجر به خرابی (crash) شود، جلوگیری شد. .SS "تغییرات ساخت (Build changes)" .IX Subsection "Build changes" فایل \f(CW\*(C`RELEASES\*(C'\fR (که تاریخ‌های انتشار را فهرست می‌کرد) حذف شده و با یک ماکروی سادهٔ \f(CW\*(C`RELEASE_DATE\*(C'\fR در \fI./configure\fR جایگزین شده است. این امر باید ساخت را ساده‌تر کند. .PP به‌صورت اختیاری می‌توان از \fBpasst\fR\|(1) برای شبکه استفاده کرد (Laszlo Ersek). .PP اکنون در پلتفرم‌های Red Hat از \&\fBdhcpcd\fR\|(8) با اولویت بالاتری نسبت به dh\-client استفاده می‌شود. .PP وابستگی‌های قدیمی روبی \f(CW\*(C`MiniTest\*(C'\fR و \f(CW\*(C`Test::Unit\*(C'\fR با بستهٔ جدید \&\f(CW\*(C`Minitest\*(C'\fR جایگزین شدند. .PP برطرف‌سازی مشکلات سازگاری با libxml2 2.12. .SS "سازوکار‌های داخلی (Internals)" .IX Subsection "Internals" در معماری x86\-64 اکنون هنگام اجرای appliance از نوع ماشین مدرن‌تر q35 استفاده می‌شود. این کار باید عملکرد را کمی بهبود دهد و توجه توسعهٔ بیشتری از سوی جامعه qemu به آن اختصاص یافته است. این تغییر باید برای کاربران libguestfs نامحسوس باشد. .PP برطرف‌سازی خطای segmentation fault در زمانی که متغیر محیطی \f(CW\*(C`TERM\*(C'\fR روی \&\f(CW\*(C`dumb\*(C'\fR تنظیم شده بود (Daisuke HATAYAMA). .PP جلوگیری از نمایش هشدار در توزیع‌های جدید فدورا که فاقد \fI/selinux\fR هستند (Andrey Drobyshev). .PP اصلاح ساخت در OpenSUSE LEAP 15 یا سایر توزیع‌ها با دستور \fBfile\fR\|(1) که گزینهٔ \fI\-S\fR را پشتیبانی نمی‌کرد (با تشکر از Olaf Hering). .SS "باگ‌های برطرف‌شده (Bugs fixed)" .IX Subsection "Bugs fixed" .IP https://bugzilla.redhat.com/2247057 4 .IX Item "https://bugzilla.redhat.com/2247057" حذف وابستگی به dhcp\-client در libguestfs .IP https://bugzilla.redhat.com/2184967 4 .IX Item "https://bugzilla.redhat.com/2184967" درخواست قابلیت (RFE): پشتیبانی از passt برای شبکه appliance، به عنوان بک‌اند شبکه فضای کاربری QEMU .IP https://bugzilla.redhat.com/2168578 4 .IX Item "https://bugzilla.redhat.com/2168578" استفاده از نوع ماشین q35 برای appliance مربوط به libguestfs .IP https://bugzilla.redhat.com/1910039 4 .IX Item "https://bugzilla.redhat.com/1910039" عدم کارکرد virt\-dib با نسخه‌های جدیدتر diskimage\-builder در RHEL8 .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 "Andrey Drobyshev" 4 .IX Item "Andrey Drobyshev" .PD 0 .IP cunshunxia 4 .IX Item "cunshunxia" .IP "Emilio Herrera" 4 .IX Item "Emilio Herrera" .IP grimst 4 .IX Item "grimst" .IP "HATAYAMA Daisuke" 4 .IX Item "HATAYAMA Daisuke" .IP "Jan Kuparinen" 4 .IX Item "Jan Kuparinen" .IP "Jürgen Hötzel" 4 .IX Item "Jürgen Hötzel" .IP "Laszlo Ersek" 4 .IX Item "Laszlo Ersek" .IP "Pavel Borecki" 4 .IX Item "Pavel Borecki" .IP "Richard W.M. Jones" 4 .IX Item "Richard W.M. Jones" .IP "Temuri Doghonadze" 4 .IX Item "Temuri Doghonadze" .IP "Tian Shixiong" 4 .IX Item "Tian Shixiong" .IP "Yuri Chornoivan" 4 .IX Item "Yuri Chornoivan" .IP "Zixun LI" 4 .IX Item "Zixun LI" .PD .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "COPYRIGHT" Copyright (C) 2009\-2025 Red Hat Inc. .SH "مجوز (LICENSE)" .IX Header "LICENSE" این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU General Public License) طبق آنچه بنیاد نرم‌افزار آزاد منتشر کرده است، بازتوزیع کرده یا تغییر دهید؛ چه نسخهٔ ۲ پروانه یا (به دلخواه خودتان) هر نسخهٔ بالاتر بعدی. .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 آن در گزارش باگ.