.\" -*- 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.56 1" .TH guestfs-release-notes-1.56 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.56 (RELEASE NOTES FOR LIBGUESTFS 1.56)" .IX Header "RELEASE NOTES FOR LIBGUESTFS 1.56" این یادداشت‌های انتشار مربوط به نسخهٔ پایدار libguestfs 1.56 است. در این بخش تغییرات عمده نسبت به نسخهٔ 1.54 شرح داده شده است. .PP نسخهٔ Libguestfs 1.56.0 در \fB۱۱ ژوئن ۲۰۲۵\fR منتشر شد. .SS "بازرسی (Inspection)" .IX Subsection "Inspection" افزودن پشتیبانی از Windows 2025 (با تشکر از Ming Xie). .PP افزودن پشتیبانی از TencentOS (توسط Denise Cheng). .PP بازرسی ماشین‌های مهمان Ubuntu 22+ که از پیکربندی تفکیک‌شدهٔ \fI/usr\fR استفاده می‌کنند، اکنون به‌درستی عمل می‌کند (با تشکر از Jaroslav Spanko و Daniel Berrange). .PP بازرسی ماشین‌های مهمانی که نقاط اتصال ریشهٔ تکراری دارند اکنون به‌درستی کار می‌کند. .PP بازرسی ماشین‌های مهمان SUSE Linux که از اسنپ‌شات‌های btrfs استفاده می‌کنند، اکنون اسنپ‌شات‌هایی را که محتوای فایل‌سیستم ریشه را منعکس می‌کنند نادیده می‌گیرد (با تشکر از Ming Xie). .PP بازرسی ماشین‌های مهمان SUSE Linux >= 15 اکنون نام کوتاه osinfo صحیح (مانند \f(CW"sle15"\fR) را بازمی‌گرداند (با تشکر از Ming Xie). .SS "رابط برنامه‌نویسی (API)" .IX Subsection "API" رابط‌های برنامه‌نویسی جدید \f(CW\*(C`command_out\*(C'\fR و \f(CW\*(C`sh_out\*(C'\fR که به شما اجازه می‌دهند خروجی دستورهای مهمان را که فراتر از محدودیت پروتکل خروجی تولید می‌کنند، دریافت کنید. .PP رابط برنامه‌نویسی جدید \f(CW\*(C`btrfs_scrub_full\*(C'\fR که یک عملیات کامل پویش و تصحیح Btrfs را به‌صورت همگام اجرا می‌کند. این رابط بیشتر شبیه fsck برای سایر فایل‌سیستم‌ها عمل می‌کند. .PP رابط برنامه‌نویسی \f(CW\*(C`fstrim\*(C'\fR تغییر کرده است تا چندین مشکل موجود در هسته‌های بالادستی و هسته‌های RHEL 9 در رابطه با پشتیبانی از XFS را دور بزند (Eric Sandeen، Dave Chinner). .PP رابط برنامه‌نویسی موجود \f(CW\*(C`e2fsck\*(C'\fR دارای یک گزینهٔ جدید به نام \f(CW\*(C`FORCENO\*(C'\fR شده است که استفاده از فلگ \fI\-n\fR خط فرمان را امکان‌پذیر می‌سازد. .SS "اتصالات زبان‌های برنامه‌نویسی (Language bindings)" .IX Subsection "Language bindings" پیش از این، مقدار \f(CW\*(C`\-L../lib/.libs\*(C'\fR در اتصالات توزیع‌شدهٔ OCaml تعبیه می‌شد. این مورد اصلاح شده است. .PP اتصالات GObject منسوخ شده‌اند و در libguestfs\ 1.58 حذف خواهند شد. .SS "تغییرات ساخت (Build changes)" .IX Subsection "Build changes" اکنون json\-c الزامی است. این بسته جایگزین Jansson شده است که پیش‌تر برای تجزیهٔ فایل‌های ورودی JSON استفاده می‌شد. .PP اکنون OCaml ≥ 4.08 مورد نیاز است. .PP دیگر از OCaml oUnit استفاده نمی‌شود. .PP اکنون فرض می‌کنیم که \f(CW\*(C`_\|_attribute_\|_((cleanup))\*(C'\fR همیشه عمل می‌کند. این مورد نیازمند gcc یا Clang است. .PP رفع سازگاری با \fBfile\fR\|(1) ≥ 5.46. .PP رفع سازگاری با Fedora ≥ 42 که پوشهٔ \fI/usr/sbin\fR را درون \&\fI/usr/bin\fR ادغام می‌کند. .PP رفع سازگاری با جدیدترین نگارش کامپایلر Rust (توسط Jacob Reger). .PP ابزارهای \&\fBlex\fR\|(1)، \fByacc\fR\|(1) و libmagic (بخشی از \fBfile\fR\|(1)) مدت‌ها بود که توسط libguestfs مورد نیاز نبودند، اما همچنان توسط اسکریپت \&\fI./configure\fR بررسی می‌شدند. این مورد برطرف شده است و آن‌ها دیگر وابستگی ساخت محسوب نمی‌شوند (با تشکر از Mohamed Akram). .PP هنگام استفاده از \f(CW\*(C`./configure \-\-disable\-daemon\*(C'\fR، دیگر نیازی به augeas و hivex نیست (با تشکر از Mohamed Akram). .PP پشتیبانی از \&\f(CW\*(C`zfs\-fuse\*(C'\fR متوقف شده است. نگهداری از این پروژه در بالادست متوقف شده است (با تشکر از Paul Bolle، Gwyn Ciesla و Timothée Ravier). .PP رفع سازگاری با GNU gettext 0.25. .SS "سازوکارهای داخلی (Internals)" .IX Subsection "Internals" تست‌ها تغییر یافتند تا از مجموعه‌ای از توابع مشترک استفاده کرده و به‌کارگیری ماکروی عجیب \f(CW$TEST_FUNCTIONS\fR حذف گردد، مشابه شیوه‌ای که در nbdkit عمل می‌کنیم. .PP رفع مشکل شکست dhcpcd روی رابط پوششی (stub) مربوط به systemd\-resolved (توسط Thomas Wouters). .PP افزودن پشتیبانی از dhcpcd و sfdisk روی Debian (توسط Daniel Gomez). .PP چاپ utsname هسته در خروجی اشکال‌زدایی (debug). .PP رابط‌های برنامه‌نویسی قدیمی \f(CW\*(C`pvs_full\*(C'\fR، \f(CW\*(C`vgs_full\*(C'\fR و \f(CW\*(C`lvs_full\*(C'\fR به‌طور کامل در OCaml بازنویسی شدند. .PP برخی ماکروهای منسوخ autoconf دیگر استفاده نمی‌شوند. .PP هنگام ایجاد یک دستگاه بلوکی، دیگر اخطار نادرستی دربارهٔ \f(CW\*(C`BLKDISCARD\*(C'\fR صادر نمی‌شود. .PP برخی از توابع داخلی List و String در OCaml که مورد استفاده قرار می‌گرفتند، با توابع stdlib رسمی OCaml جایگزین شدند که هزینهٔ نگهداری کد را کاهش می‌دهد. .PP اگر دستورهای \fBqemu\-img\fR\|(1) در زمان ایجاد اسنپ‌شات با شکست مواجه شوند، اطمینان حاصل می‌شود که stderr دستور qemu دریافت و چاپ شود (توسط Cole Robinson). .SS "باگ‌های رفع‌شده (Bugs fixed)" .IX Subsection "Bugs fixed" .IP https://issues.redhat.com/browse/RHEL\-62935 4 .IX Item "https://issues.redhat.com/browse/RHEL-62935" [rhel 9.6] نمایش نادرست نگارش ویندوز مهمان win2025 در طول تبدیل v2v .IP https://issues.redhat.com/browse/RHEL\-80159 4 .IX Item "https://issues.redhat.com/browse/RHEL-80159" افزودن APIهای جدید جهت مجاز کردن خروجی دستور بیشتر از 4MB .IP https://issues.redhat.com/browse/RHEL\-87493 4 .IX Item "https://issues.redhat.com/browse/RHEL-87493" شکست ماشین مجازی Ubuntu 22.04 از VMware با خطای Inspection field ‘i_arch’ was ‘unknown’ [rhel\-9.7] .IP https://issues.redhat.com/browse/RHEL\-88450 4 .IX Item "https://issues.redhat.com/browse/RHEL-88450" عملیات fstrim روی فایل‌سیستم XFS ایجادشده توسط RHEL 7.2 به میزان مورد انتظار پاک‌سازی انجام نمی‌دهد .IP https://issues.redhat.com/browse/RHEL\-88508 4 .IX Item "https://issues.redhat.com/browse/RHEL-88508" اجرای دو بارهٔ fstrim جهت دور زدن رفتار نادرست fstrim در هستهٔ RHEL 9 .IP https://issues.redhat.com/browse/RHEL\-90168 4 .IX Item "https://issues.redhat.com/browse/RHEL-90168" دستور virt\-v2v با خطای mount exited with status 32: mount: /sysroot: /dev/sda2 already mounted on /sysroot. [rhel\-9.7] با شکست مواجه می‌شود .IP https://issues.redhat.com/browse/RHEL\-92239 4 .IX Item "https://issues.redhat.com/browse/RHEL-92239" عدم دریافت خطا هنگام باز کردن قالب نادرست ایمیج در حالت فقط‌خواندنی [rhel\-10.1] .IP https://issues.redhat.com/browse/RHEL\-93109 4 .IX Item "https://issues.redhat.com/browse/RHEL-93109" درخواست قابلیت (RFE): بررسی و انجام کار مفید با btrfsvol:...snapshots در مهمان‌های SUSE Linux .IP https://issues.redhat.com/browse/RHEL\-95791 4 .IX Item "https://issues.redhat.com/browse/RHEL-95791" تولید osinfo اشتباه توسط libguestfs برای ماشین‌های مهمان SLES 15 [rhel\-9.6] .IP https://github.com/libguestfs/libguestfs/issues/155 4 .IX Item "https://github.com/libguestfs/libguestfs/issues/155" 1.54.0: شکست gdisk/test\-expand\-gpt.pl .IP https://github.com/libguestfs/libguestfs/issues/162 4 .IX Item "https://github.com/libguestfs/libguestfs/issues/162" شکست جدید مجموعه آزمون در c\-api همراه با file\-5.46 .IP https://github.com/libguestfs/libguestfs/issues/167 4 .IX Item "https://github.com/libguestfs/libguestfs/issues/167" Weblate | رشته‌های متنی منبع اشتباه .IP https://github.com/libguestfs/libguestfs/issues/182 4 .IX Item "https://github.com/libguestfs/libguestfs/issues/182" sed: خطای RE: دنبالهٔ بایت نامعتبر در ساخت .IP https://github.com/libguestfs/libguestfs/issues/183 4 .IX Item "https://github.com/libguestfs/libguestfs/issues/183" شکست نصب bash\-completion در macOS .IP https://github.com/libguestfs/libguestfs/issues/184 4 .IX Item "https://github.com/libguestfs/libguestfs/issues/184" نیاز به augeas، hivex و libmagic حتی در زمانی که دیمن غیرفعال است .IP https://github.com/libguestfs/libguestfs/issues/191 4 .IX Item "https://github.com/libguestfs/libguestfs/issues/191" شکست در ساخت ocaml/examples .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 "Cole Robinson" 4 .IX Item "Cole Robinson" .PD 0 .IP "Daniel Gomez" 4 .IX Item "Daniel Gomez" .IP "Denise Cheng" 4 .IX Item "Denise Cheng" .IP "Ettore Atalan" 4 .IX Item "Ettore Atalan" .IP "Jacob Reger" 4 .IX Item "Jacob Reger" .IP "Krascovict Petrov" 4 .IX Item "Krascovict Petrov" .IP "Léane GRASSER" 4 .IX Item "Léane GRASSER" .IP "Richard W.M. Jones" 4 .IX Item "Richard W.M. Jones" .IP "Ricky Tigg" 4 .IX Item "Ricky Tigg" .IP "Thomas Wouters" 4 .IX Item "Thomas Wouters" .IP "Yuri Chornoivan" 4 .IX Item "Yuri Chornoivan" .PD .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر (C) 2009\-2025 متعلق به Red Hat Inc است. .SH "مجوز (LICENSE)" .IX Header "LICENSE" این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانهٔ عمومی همگانی گنو» که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، دوباره توزیع کرده و/یا تغییر دهید؛ چه نسخهٔ 2 این پروانه و چه (به انتخاب خودتان) هر نسخهٔ بعدی دیگر. .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 آن در گزارش باگ.