.\" -*- 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.54 1"
.TH guestfs-tools-release-notes-1.54 1 2026-07-11 guestfs-tools-1.56.0 "پشتیبانی مجازی‌سازی"
.\" 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.54)"
.IX Header "RELEASE NOTES FOR GUESTFS TOOLS 1.54"
این‌ها یادداشت‌های انتشار برای نسخه پایدار ۱.۵۴ ابزارهای guestfs هستند.
این سند تغییرات عمده نسبت به نسخه ۱.۵۲ را شرح می‌دهد.
.PP
ابزارهای Guestfs نسخه ۱.۵۴.۰ در \fB۲۱ مه ۲۰۲۵\fR منتشر شد.
.SS "مکان جدید مخزن"
.IX Subsection "New repository location"
مخزن بالادستی گیت اکنون در این نشانی قرار دارد:
https://github.com/libguestfs/guestfs\-tools
.SS virt\-customize
.IX Subsection "virt-customize"
گزینه جدید \fI\-\-inject\-blnsvr\fR اضافه شده است که می‌تواند برای تزریق سرور بالن‌سازی حافظه ویندوز (Windows memory balloon server) به ماشین‌های مهمان استفاده شود.
.PP
گزینه \&\fI\-\-inject\-virtio\-win\fR دیگر از روش \f(CW\*(C`osinfo\*(C'\fR (استفاده از libosinfo برای اطلاعات درایور virtio\-win) پشتیبانی نمی‌کند، زیرا دیگر نگهداری نمی‌شود و بسیار قدیمی شده بود. روش پیش‌فرض با استفاده از نام پوشه‌های virtio\-win در همه موارد قابل اعتمادتر بوده و ترجیح داده می‌شود (Cole Robinson).
.SS virt\-drivers
.IX Subsection "virt-drivers"
مدیریت خروجی‌های حجیم دستور \fBrpm\fR\|(1) هنگام فهرست کردن درایورها در برخی مهمان‌های SUSE.
.SS virt\-make\-fs
.IX Subsection "virt-make-fs"
استفاده از گزینه \fI\-S\fR در دستور \fBfile\fR\|(1) برای غیرفعال کردن محافظت seccomp در زمانی که از گزینه \fI\-z\fR دستور \fBfile\fR\|(1) نیز استفاده می‌کنیم، زیرا این دو گزینه ناسازگار هستند و در برخی توزیع‌های لینوکس باعث خرابی و کرش می‌شوند.
.SS virt\-resize
.IX Subsection "virt-resize"
اصلاح محاسبه دیسک هدف. در برخی موارد همراه با گزینه \&\fI\-\-resize\fR این محاسبه به درستی انجام نمی‌شد و ایجاد پارتیشن در مقصد با یک خطای گیج‌کننده شکست می‌خورد.
.PP
اکنون برای پیام‌های اشکال‌زدایی (debug) به طور یکدست از stderr استفاده می‌کنیم.
.SS "تغییرات عمومی"
.IX Subsection "Common changes"
افزودن پشتیبانی از معماری LoongArch (توسط liuxiang از Loongson).
.PP
رفع اشکال ساخت بایت‌کد OCaml (توسط Jerry James، Ilya Leoshkevich).
.PP
اجازه استفاده از شناسه‌های URI با فرمت \f(CW\*(C`nbd+unix://\*(C'\fR در پارامترهای \fI\-a\fR برای چندین ابزار.
.PP
افزودن نمایه git\-publish (توسط Kashyap Chamarthy).
.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
افزودن پشتیبانی از GCC 14 و 15.
.PP
برخی ماکروهای منسوخ‌شده autoconf دیگر استفاده نمی‌شوند.
.PP
رفع برخی مشکلات هنگام ساخت روی macOS (توسط Mohamed Akram).
.PP
رفع سازگاری با GNU gettext 0.25.
.SS "بخش‌های داخلی (Internals)"
.IX Subsection "Internals"
آزمون‌ها اصلاح شدند تا از مجموعه‌ای از توابع مشترک استفاده کنند و استفاده از ماکروی ناآشنای \f(CW$TEST_FUNCTIONS\fR حذف شد، مشابه روشی که در nbdkit به کار می‌بریم.
.PP
برخی توابع داخلی List و String در OCaml که استفاده می‌کردیم، با توابع stdlib خود OCaml جایگزین شدند که نگهداری کد را کاهش می‌دهد.
.SS "اشکالات رفع‌شده"
.IX Subsection "Bugs fixed"
.IP https://issues.redhat.com/browse/RHEL\-32099 4
.IX Item "https://issues.redhat.com/browse/RHEL-32099"
مقاوم‌سازی grub2\-mkconfig برای جلوگیری از بازنویسی فایل /boot/efi/EFI/redhat/grub.cfg
.IP https://issues.redhat.com/browse/RHEL\-67560 4
.IX Item "https://issues.redhat.com/browse/RHEL-67560"
بهبود اطلاعات خطا هنگام استفاده از گزینه‌های virt\-customize برای سیستم‌عامل مهمان ناسازگار [rhel\-9.7]
.IP https://issues.redhat.com/browse/RHEL\-67565 4
.IX Item "https://issues.redhat.com/browse/RHEL-67565"
بهبود اطلاعات خطا هنگام استفاده از گزینه‌های virt\-customize برای سیستم‌عامل مهمان ناسازگار [rhel\-10.1]
.IP https://issues.redhat.com/browse/RHEL\-77989 4
.IX Item "https://issues.redhat.com/browse/RHEL-77989"
مهاجرت CentOS 9 از VMWare به Openshift Virt شکست می‌خورد [rhel\-9.6]
.IP https://issues.redhat.com/browse/RHEL\-80214 4
.IX Item "https://issues.redhat.com/browse/RHEL-80214"
دستور virt\-drivers روی مهمان opensuse در صورت نصب بودن kernel\-source شکست می‌خورد
.IP https://github.com/libguestfs/guestfs\-tools/issues/16 4
.IX Item "https://github.com/libguestfs/guestfs-tools/issues/16"
مشکلات ساخت روی macOS
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
http://libguestfs.org
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
.IP "Jerry James" 4
.IX Item "Jerry James"
.PD 0
.IP "Kashyap Chamarthy" 4
.IX Item "Kashyap Chamarthy"
.IP "Richard W.M. Jones" 4
.IX Item "Richard W.M. Jones"
.IP liuxiang 4
.IX Item "liuxiang"
.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 آن را در گزارش باگ قرار دهید.