.\" -*- 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.60 1"
.TH guestfs-release-notes-1.60 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.60 (RELEASE NOTES FOR LIBGUESTFS 1.60)"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.60"
این سند حاوی یادداشت‌های انتشار نسخه پایدار libguestfs 1.60 است\&.
در اینجا تغییرات عمده نسبت به نسخه 1.58 شرح داده شده است\&.
.PP
بسته Libguestfs 1.60.0 در تاریخ \fB۹ ژوئیه ۲۰۲۶\fR منتشر شد\&.
.SS "بازرسی سیستم (Inspection)"
.IX Subsection "Inspection"
افزودن پشتیبانی از توزیع‌های لینوکس Kylin، NeoKylin و Anolis (توسط grass lu)\&.
.PP
مهمان‌هایی که از جدول پارتیشن Veritas استفاده می‌کنند (که نوع پارتیشن Sun را مجدداً استفاده می‌کند) اکنون قابل بازرسی هستند\&.
.PP
ضدویروس Windows Defender در صورت وجود در مهمان‌های ویندوزی اکنون شناسایی می‌شود (Susant Sahani)\&.
.SS "رابط برنامه‌نویسی (API)"
.IX Subsection "API"
رابط برنامه‌نویسی جدید \f(CW\*(C`guestfs_xfs_info2\*(C'\fR\&. این تابع مشابه API موجود \&\f(CW\*(C`guestfs_xfs_info\*(C'\fR است اما یک جدول هش انعطاف‌پذیر برمی‌گرداند که امکان افزودن فیلدهای بیشتری را در آینده به خروجی فراهم می‌سازد\&.
.PP
تابع \&\f(CW\*(C`guestfs_get_hv\*(C'\fR اکنون هایپروایزر پیش‌فرض را برمی‌گرداند\&.
.PP
تابع \&\f(CW\*(C`guestfs_tar_in\*(C'\fR گزینه جدیدی با نام \f(CW\*(C`keepdirlink\*(C'\fR اضافه کرده است که پرچم \fI\-\-keep\-directory\-symlink\fR در tar را کنترل می‌کند (Anders Roxell)\&.
.PP
گزینه \f(CW\*(C`maxmem\*(C'\fR در تابع \&\f(CW\*(C`guestfs_xfs_repair\*(C'\fR اکنون در صورتی که مقدار maxmem بیش از حد کوچک باشد، پیام‌های خطای بهتری تولید می‌کند\&.
.PP
همه توابعی که پارامترهای کلید LUKS را دریافت می‌کنند اکنون می‌توانند از پیشوندهای \&\f(CW\*(C`text:...\*(C'\fR یا \f(CW\*(C`base64:...\*(C'\fR استفاده کنند، که اجازه می‌دهد کلیدهای باینری به صورت base64 کدگذاری شده و به این APIها ارسال شوند\&. ابزار \fBguestfish\fR\|(1) و سایر ابزارهایی که فایل کلید دریافت می‌کنند اکنون اجازه می‌دهند از فایل باینری استفاده شود\&.
.PP
توابع \&\f(CW\*(C`guestfs_command*\*(C'\fR و \f(CW\*(C`guestfs_sh*\*(C'\fR اکنون از یک bind mount برای جایگزینی \f(CW\*(C`/etc/resolv.conf\*(C'\fR درون ماشین مهمان استفاده می‌کنند، که اجازه می‌دهد این دستورات حتی هنگامی که این فایل به عنوان تغییرناپذیر (immutable) علامت‌گذاری شده است (تغییر رایجی که مدیران سیستم اعمال می‌کنند) به کار خود ادامه دهند (Srihari Parimi)\&.
.SS "ابزارها (Tools)"
.IX Subsection "Tools"
زیردستور جدید \f(CW\*(C`not\*(C'\fR در \fBguestfish\fR\|(1)، که وضعیت یک دستور را نقیض (وارونه) می‌کند\&.
.SS "پیوست‌های زبان‌های برنامه‌نویسی (Language bindings)"
.IX Subsection "Language bindings"
پیوست‌های GObject و Vala حذف شدند\&. این پیوست‌ها پیش‌تر در libguestfs 1.56 منسوخ شده بودند (Cole Robinson)\&.
.SS "مستندات (Documentation)"
.IX Subsection "Documentation"
تمام اطلاعات مربوط به اسکریپت‌های firstboot منتقل شده و در بخش "FIRSTBOOT" در \fBvirt\-customize\fR\|(1) تجمیع شدند (Srihari Parimi)\&.
.PP
اصلاح مستندات API تابع \f(CW\*(C`guestfs_copy_out\*(C'\fR\&.
.SS "تغییرات ساخت (Build changes)"
.IX Subsection "Build changes"
اصلاح وبهوک‌های Weblate (i18n) (توسط Rafael Fontenelle)\&.
.PP
اصلاح بیلد در شرایطی که libselinux در دسترس نیست (David Runge)\&.
.PP
یکپارچه‌سازی مداوم (CI) گیت‌هاب اکنون به طور جامع‌تری استفاده می‌شود (Cole Robinson)\&.
.PP
اصلاح دستور \f(CW\*(C`make dist\*(C'\fR هنگامی که پیوست‌های برخی از زبان‌ها غیرفعال است (Cole Robinson)\&.
.PP
گزینه \&\f(CW\*(C`./configure \-\-with\-qemu\*(C'\fR حذف شد\&.
.PP
متغیر \&\f(CW\*(C`CFLAGS\*(C'\fR اکنون در ابتدای فلگ‌های پیش‌فرض اضافه می‌شود، که اجازه می‌دهد فلگ‌های پیش‌فرض بازنویسی شوند\&. علاوه بر این، پرچم \fI\-fPIC\fR به فلگ‌های پیش‌فرض افزوده شد (Cole Robinson)\&.
.PP
برخی اسکریپت‌های تکمیل خودکار bash که دیگر توسط libguestfs استفاده نمی‌شدند (و به guestfs\-tools منتقل شده بودند) حذف گردیدند\&. همچنین گزینه‌های جدید \f(CW\*(C`./configure \&\-\-with\-bash\-completion\*(C'\fR و \f(CW\*(C`./configure \-\-with\-bash\-completion\-dir\*(C'\fR افزوده شدند (Christopher Byrne)\&.
.PP
دیگر پیونددهی بیش از حد (over-link) در پیوست‌های Lua با libxml2 و libvirt صورت نمی‌گیرد (David Runge)\&.
.PP
بهبود پشتیبانی اپلاینس در آرچ لینوکس (David Runge)\&.
.SS "بخش‌های داخلی (Internals)"
.IX Subsection "Internals"
ساده‌سازی آزمون مشخصه‌های qemu\&. بیشتر کد به طور کامل حذف شد و همچنین هنگام تشخیص در دسترس بودن KVM، دیگر یک ماشین مهمان خالی راه‌اندازی نمی‌کنیم (با تشکر از Daniel Berrange)\&. همچنین اگر qemu هنگام شناسایی در راه‌اندازی با خطا مواجه شود، اکنون خروجی خطای استاندارد (stderr) چاپ می‌شود (Hilko Bengen)\&.
.PP
استفاده از \fI\-cpu max\fR در معماری RISC\-V (با تشکر از Apache553)\&.
.PP
پشتیبانی بسیار مقدماتی از سیستم‌فایل اپل (APFS) در فدورا افزوده شد\&.
.PP
بسیاری از نشت‌های حافظه و توصیف‌گر فایل (fd) که توسط Claude Code شناسایی شده بودند، برطرف شدند (shivanayak)\&.
.PP
در اپلاینس libguestfs، تعداد نگاشت‌های حافظه قبل از پردازش (pre-process memory maps) افزایش یافت\&. این تغییر ممکن است به xfs_repair اجازه دهد روی سیستم‌های فایل بزرگ‌تر کار کند (Eric Sandeen)\&.
.PP
اصلاح DHCP در ماشین‌های سریع با وادار کردن آن به انتظار برای دریافت آدرس هنگام فعال بودن شبکه\&. علاوه بر این از \f(CW\*(C`dhcpcd \-\-debug\*(C'\fR استفاده می‌شود که مشاهده عملکرد درخواست‌های DHCP را آسان‌تر می‌کند (Cole Robinson)\&.
.PP
بهبودهای خروجی اشکال‌زدایی (Surya Gupta, Srihari Parimi)\&.
.PP
اصلاح پیوند نمادین bin/sbin در فدورا برای کاهش پیام‌های اضافی (Cole Robinson)\&.
.PP
بازنویسی پیاده‌سازی xfs_repair و luks_* در دیمن با زبان OCaml\&.
.PP
اطمینان از باز بودن توصیف‌گرهای فایل (fds) شماره ۰، ۱ و ۲ هنگام اجرای زیردستورها\&.
.SS "اشکالات رفع‌شده (Bugs fixed)"
.IX Subsection "Bugs fixed"
.IP https://issues.redhat.com/browse/RHEL\-129145 4
.IX Item "https://issues.redhat.com/browse/RHEL-129145"
درخواست قابلیت: تشخیص ضدویروس Windows Defender در صورت فعال بودن در نصب پیش‌فرض Windows 11
.IP https://issues.redhat.com/browse/RHEL\-143673 4
.IX Item "https://issues.redhat.com/browse/RHEL-143673"
افزودن API جدید xfs_info2 برای ارائه اطلاعات نسخه XFS
.IP https://issues.redhat.com/browse/RHEL\-165220 4
.IX Item "https://issues.redhat.com/browse/RHEL-165220"
شکست virt\-v2v با جدول پارتیشن sun و فضای ذخیره‌سازی Veritas به همراه: parted exited with status 1: Warning: The disk CHS geometry reported by the operating system does not match the geometry stored on the disk label
.IP https://issues.redhat.com/browse/RHEL\-165677 4
.IX Item "https://issues.redhat.com/browse/RHEL-165677"
توقف استفاده از xfs_repair \-m به دلیل اینکه حافظه مورد نیاز متناسب با اندازه سیستم‌فایل تغییر کرده و ریسک بالایی دارد
.IP https://issues.redhat.com/browse/RHEL\-170864 4
.IX Item "https://issues.redhat.com/browse/RHEL-170864"
شکست virt\-v2v با کلیدهای باینری LUKS در [virt\-v2v]
.IP https://issues.redhat.com/browse/RHEL\-171895 4
.IX Item "https://issues.redhat.com/browse/RHEL-171895"
شکست virt\-v2v با کلیدهای باینری LUKS در [libguestfs]
.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\-178287 4
.IX Item "https://issues.redhat.com/browse/RHEL-178287"
شکست virt\-v2v حین مهاجرت ماشین‌های مجازی RHEL 7 به دلیل خطاهای سیستم‌فایل XFS، که احتمالاً ناشی از اجرای xfs_repair در RHEL 10.1 در برابر سیستم‌فایل XFS متعلق به RHEL 7 است
.IP https://issues.redhat.com/browse/RHEL\-178556 4
.IX Item "https://issues.redhat.com/browse/RHEL-178556"
استفاده از bind mount برای بازنویسی /sysroot/etc/resolv.conf در طول عملیات "sh"
.IP https://github.com/libguestfs/libguestfs/issues/290 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/290"
1.58.0: ارجاع تعریف‌نشده به optgroup_selinuxrelabel_available
.IP https://github.com/libguestfs/libguestfs/issues/292 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/292"
در guestfs_int_get_cpu_model: استفاده از \-cpu max برای riscv
.IP https://github.com/libguestfs/libguestfs/issues/312 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/312"
تغییر ساختار به po4a
.IP https://github.com/libguestfs/libguestfs/issues/336 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/336"
آزمون ناپایدار network/test\-network.sh
.IP https://github.com/libguestfs/libguestfs/issues/359 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/359"
1.58.1: پیوست‌های Lua به libxml2 متصل می‌شوند اما به نظر نمی‌رسد از آن استفاده کنند
.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 "Adolfo Jayme Barrientos" 4
.IX Item "Adolfo Jayme Barrientos"
.PD 0
.IP "Anders Roxell" 4
.IX Item "Anders Roxell"
.IP "Andi Chandler" 4
.IX Item "Andi Chandler"
.IP "Arif Budiman" 4
.IX Item "Arif Budiman"
.IP "Christopher Byrne" 4
.IX Item "Christopher Byrne"
.IP "Cole Robinson" 4
.IX Item "Cole Robinson"
.IP "David Runge" 4
.IX Item "David Runge"
.IP "Emilio Herrera" 4
.IX Item "Emilio Herrera"
.IP "Ettore Atalan" 4
.IX Item "Ettore Atalan"
.IP "Fco. Javier F. Serrador" 4
.IX Item "Fco. Javier F. Serrador"
.IP grimst 4
.IX Item "grimst"
.IP "Hela Basa" 4
.IX Item "Hela Basa"
.IP "Hilko Bengen" 4
.IX Item "Hilko Bengen"
.IP "Jan Kuparinen" 4
.IX Item "Jan Kuparinen"
.IP "Krascovict Petrov" 4
.IX Item "Krascovict Petrov"
.IP "Léane GRASSER" 4
.IX Item "Léane GRASSER"
.IP Nathan95 4
.IX Item "Nathan95"
.IP "Pavel Borecki" 4
.IX Item "Pavel Borecki"
.IP "Piotr Drąg" 4
.IX Item "Piotr Drąg"
.IP "Rafael Fontenelle" 4
.IX Item "Rafael Fontenelle"
.IP "Richard W.M. Jones" 4
.IX Item "Richard W.M. Jones"
.IP "Ricky Tigg" 4
.IX Item "Ricky Tigg"
.IP shivanayak 4
.IX Item "shivanayak"
.IP "Srihari Parimi" 4
.IX Item "Srihari Parimi"
.IP "Surya Gupta" 4
.IX Item "Surya Gupta"
.IP "Susant Sahani" 4
.IX Item "Susant Sahani"
.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 "zhanchun li" 4
.IX Item "zhanchun li"
.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 آن را درون گزارش اشکال جای‌گذاری کنید\&.