.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Podwrapper::Man 1.56.0 (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-tools-release-notes-1.56 1" .TH guestfs-tools-release-notes-1.56 1 2026-07-11 guestfs-tools-1.56.0 "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\-tools\-release\-notes \- یادداشت‌های انتشار ابزارهای guestfs .SH "یادداشت‌های انتشار ابزارهای GUESTFS نسخه ۱.۵۶ (RELEASE NOTES FOR GUESTFS TOOLS 1.56)" .IX Header "RELEASE NOTES FOR GUESTFS TOOLS 1.56" این سند شامل یادداشت‌های انتشار نسخهٔ پایدار ۱.۵۶ ابزارهای guestfs است. این یادداشت‌ها تغییرات عمده را از نسخهٔ ۱.۵۴ تا کنون شرح می‌دهند. .PP مجموعه ابزارهای Guestfs نسخهٔ 1.56.0 در \fB۹ ژوئیه ۲۰۲۶\fR منتشر شد. .SS virt\-builder .IX Subsection "virt-builder" رفع مشکل ساخت قالب \f(CW\*(C`debian\-13\*(C'\fR (توسط pulsarrush). .PP استفاده از HTTPS برای دریافت قالب‌ها (توسط Xiang Hua Chen). .SS virt\-customize .IX Subsection "virt-customize" رفع مشکل برچسب‌گذاری مجدد SELinux برای سیستم‌های مهمان با ساختار «/usr تفکیک‌شده» (split /usr). .PP رفع مشکل Windows Update و دستور \f(CW\*(C`pnputil /e\*(C'\fR در سیستم‌های مهمان Windows پس از تزریق درایورهای virtio\-win (توسط Cole Robinson). .PP هنگام تزریق درایورهای virtio\-win در سیستم‌های مهمان Windows، فایل \&\fIblnsvr.exe\fR (سرویس‌دهندهٔ balloon) نیز نصب می‌شود (توسط Cole Robinson). .PP رفع مشکل نصب درایورهای Windows Vista و Windows 2008 Server R1 (توسط Cole Robinson). .PP حذف قابلیت subscription\-manager در RHEL (توسط Cole Robinson). .PP چاپ مقادیر \f(CW\*(C`%USERNAME%\*(C'\fR و \f(CW\*(C`%USERDOMAIN%\*(C'\fR مربوط به Windows در اسکریپت‌های firstboot، که می‌تواند برای عیب‌یابی خطاهای ناشی از دسترسی‌های ناکافی به کار رود (توسط Ming Xie). .PP اسکریپت‌های firstboot ویندوز اکنون می‌توانند با کد 250 خارج شوند، به این معنی که پس از اجرای اسکریپت نیازی به راه‌اندازی مجدد نیست. اسکریپت بعدی در توالی بلافاصله اجرا خواهد شد (توسط Srihari Parimi). .PP در ویندوز، پس از اجرای تمامی اسکریپت‌های firstboot یک فایل نشانگر ایجاد می‌شود که می‌تواند نشان‌دهندهٔ پایان یافتن فرایند firstboot باشد. .SS virt\-inspector .IX Subsection "virt-inspector" افزودن عنصر \f(CW\*(C`\*(C'\fR در صورت شناسایی Windows Group Policy درون سیستم مهمان. .PP عنصر جدید \f(CW\*(C`\*(C'\fR برای مشخص کردن دسته‌بندی برنامه‌ها، مانند ضدویروس. .PP برای سیستم‌های فایل XFS، شناسهٔ جدید \f(CW\*(C`\*(C'\fR برای مشخص کردن نسخهٔ ۴ یا ۵ XFS اضافه شد (این مورد در خروجی \fBvirt\-filesystems\fR\|(1) نیز نمایش داده می‌شود). .PP افزودن پشتیبانی از Kylin ،NeoKylin و Anolis Linux (توسط grass lu). .SS virt\-sysprep .IX Subsection "virt-sysprep" افزودن یک عملیات جدید برای پاک‌سازی فایل‌های تاریخچهٔ zsh (توسط Fazle Arefin). .SS "تغییرات عمومی (Common changes)" .IX Subsection "Common changes" برخی از اسکریپت‌های تکمیل دستور bash که دیگر توسط guestfs\-tools استفاده نمی‌شدند حذف شدند. همچنین گزینه‌های جدید \f(CW\*(C`./configure \-\-with\-bash\-completion\*(C'\fR و \&\f(CW\*(C`./configure \-\-with\-bash\-completion\-dir\*(C'\fR اضافه شدند (توسط Christopher Byrne). .PP تمامی ابزارهایی که یک فایل کلید LUKS می‌پذیرند اکنون امکان استفاده از فایل باینری را نیز فراهم می‌کنند. .SS "مستندات (Documentation)" .IX Subsection "Documentation" استفاده از گزینهٔ \fI\-cpu max\fR در qemu در مستندات مربوط به اجرای سیستم‌های مهمان virt\-builder. .PP تمامی اطلاعات مربوط به اسکریپت‌های firstboot به بخش «FIRSTBOOT» در \fBvirt\-customize\fR\|(1) منتقل و یکپارچه‌سازی شد (توسط Srihari Parimi). .PP بخش زیادی از مستندات منسوخ در صفحهٔ راهنمای \fBvirt\-sysprep\fR\|(1) حذف شد. .SS "تغییرات ساخت (Build changes)" .IX Subsection "Build changes" رفع مشکل وب‌هوک‌های Weblate (بین‌المللی‌سازی/i18n) (توسط Rafael Fontenelle). .PP اصلاحاتی برای OCaml 5. .PP افزودن Github CI (توسط Cole Robinson). .PP حذف ماکروی \f(CW\*(C`AM_GNU_GETTEXT\*(C'\fR و جایگزینی آن با بررسی‌های ساده‌ترِ \f(CW\*(C`LIBINTL\*(C'\fR (توسط Cole Robinson). .PP ساخت تجزیه‌کنندهٔ مبتنی بر Bison با پرچم \fI\-Wno\-yacc\fR جهت کاهش هشدارهای سازگاری yacc که اهمیتی ندارند (توسط Cole Robinson). .PP هشدارهای مختلف هنگام ساخت پاک‌سازی شدند (توسط Cole Robinson). .PP متغیر \&\f(CW\*(C`CFLAGS\*(C'\fR اکنون پیش از مقادیر پیش‌فرض قرار می‌گیرد تا امکان بازنویسی آن‌ها فراهم شود. علاوه بر این، \fI\-fPIC\fR به پرچم‌های پیش‌فرض اضافه شد (توسط Cole Robinson). .PP بسیاری از نشت‌های حافظه که توسط Claude Code شناسایی شده بودند برطرف شدند (توسط shivanayak). .SS "سازوکار داخلی (Internals)" .IX Subsection "Internals" لیترال‌های رشته‌ای نقل‌قول‌شده در OCaml (\f(CW\*(C`{|..|}\*(C'\fR) در سرتاسر کد به کار گرفته شدند تا گنجاندن عینی اسکریپت‌ها، کدها، عبارات باقاعده و موارد مشابه آسان‌تر شود. .PP کدهای منبع برای \fBvirt\-cat\fR\|(1)، \fBvirt\-filesystems\fR\|(1)، \&\fBvirt\-log\fR\|(1)، \fBvirt\-ls\fR\|(1) و \fBvirt\-tail\fR\|(1) قبلاً بدون دلیل خاصی از یک دایرکتوری مبدأ مشترک (\fIcat/\fR) استفاده می‌کردند. این برنامه‌ها به دایرکتوری‌های جداگانه منتقل شدند. .SS "باگ‌های برطرف‌شده (Bugs fixed)" .IX Subsection "Bugs fixed" .IP https://issues.redhat.com/browse/RHEL\-100682 4 .IX Item "https://issues.redhat.com/browse/RHEL-100682" نصب درایورها هنگام firstboot گاهی اوقات به دلیل در دسترس نبودن سرویس PnP شکست می‌خورد [rhel\-9.7] .IP https://issues.redhat.com/browse/RHEL\-108174 4 .IX Item "https://issues.redhat.com/browse/RHEL-108174" قابلیت selinux\-relabel در مرزهای سیستم فایل کار نمی‌کند (زیرا setfiles این‌گونه عمل نمی‌کند) [rhel\-9.7] .IP https://issues.redhat.com/browse/RHEL\-125955 4 .IX Item "https://issues.redhat.com/browse/RHEL-125955" تشخیص حضور ضدویروس یا GPO در ماشین مجازی توسط virt\-inspector [guestfs tools] .IP https://issues.redhat.com/browse/RHEL\-144074 4 .IX Item "https://issues.redhat.com/browse/RHEL-144074" ارائهٔ نسخهٔ XFS در virt\-filesystems .IP https://issues.redhat.com/browse/RHEL\-170706 4 .IX Item "https://issues.redhat.com/browse/RHEL-170706" اسکریپت‌های firstboot در virt\-customize (در Windows) باید بتوانند از راه‌اندازی مجدد صرف‌نظر کنند .IP https://issues.redhat.com/browse/RHEL\-170708 4 .IX Item "https://issues.redhat.com/browse/RHEL-170708" مستندسازی این که کد خروج 249 به معنای تلاش مجدد برای اجرای اسکریپت firstboot است (فقط Windows) .IP https://issues.redhat.com/browse/RHEL\-171896 4 .IX Item "https://issues.redhat.com/browse/RHEL-171896" خطای virt\-v2v در مواجهه با کلیدهای باینری LUKS [guestfs\-tools] .IP https://issues.redhat.com/browse/RHEL\-94873 4 .IX Item "https://issues.redhat.com/browse/RHEL-94873" نیاز به به‌روزرسانی uri به https:// در فایل‌های پیکربندی درون /etc/virt\-builder/repos.d [rhel\-10.1] .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" http://libguestfs.org .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" .IP "Christopher Byrne" 4 .IX Item "Christopher Byrne" .PD 0 .IP "Cole Robinson" 4 .IX Item "Cole Robinson" .IP "Fazle Arefin" 4 .IX Item "Fazle Arefin" .IP "Fco. Javier F. Serrador" 4 .IX Item "Fco. Javier F. Serrador" .IP pulsarrush 4 .IX Item "pulsarrush" .IP "Rafael Fontenelle" 4 .IX Item "Rafael Fontenelle" .IP "Richard W.M. Jones" 4 .IX Item "Richard W.M. Jones" .IP "Srihari Parimi" 4 .IX Item "Srihari Parimi" .IP "Temuri Doghonadze" 4 .IX Item "Temuri Doghonadze" .IP "Yuri Chornoivan" 4 .IX Item "Yuri Chornoivan" .PD .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "COPYRIGHT" Copyright (C) 2009\-2026 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 آن را درون گزارش باگ قرار دهید.