.\" -*- 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.8 1"
.TH guestfs-release-notes-1.8 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.8 (RELEASE NOTES FOR LIBGUESTFS 1.8)"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.8"
این یادداشت‌های انتشار تنها تفاوت‌ها نسبت به انشعاب پایدار/توسعه پیشین (1.6.0)
را پوشش می‌دهند. برای گزارش تفصیلی تغییرات، لطفاً مخزن git یا فایل ChangeLog
توزیع‌شده در بسته فشرده (tarball) را ببینید.
.SS "ویژگی‌های جدید (New features)"
.IX Subsection "New features"
.Vb 1
\& \- پشتیبانی و بسته‌ها برای Debian و Ubuntu.
\&
\& \- ساخت‌های روزانه از مخزن git روی Debian و Ubuntu برای کاهش خطر
\&   پس‌رفت‌ها (regressions).
\&
\& \- پورت به \*(Aqpacman\*(Aq در ArchLinux (با تشکر از Thomas S Hatch).
\&
\& \- ابزارهای زیر به C بازنویسی شده‌اند (در اصل در Perl بودند):
\&
\&     . virt\-cat
\&     . virt\-df
\&     . virt\-inspector
\&     . virt\-ls
\&     . virt\-rescue
\&
\& \- برخی از ابزارهای C مهمان‌های رمزنگاری‌شده را به طور خودکار پشتیبانی می‌کنند. این
\&   قابلیت در این ابزارها پشتیبانی می‌شود: guestfish، guestmount، virt\-cat، virt\-inspector،
\&   virt\-ls.
\&
\& \- ابزار جدید virt\-filesystems (در C) که جایگزینی برای
\&   virt\-list\-filesystems و virt\-list\-partitions است، و مجموعه‌ی بزرگ‌تری
\&   از عملکردهای آن ابزارها را دارد.
\&
\& \- ابزارهای guestfish، guestmount و ابزارهای C از تجزیه‌ی یکپارچه‌ی گزینه‌های
\&   خط فرمان استفاده می‌کنند، بنابراین از بسیاری از گزینه‌های مشترک مانند \*(Aq\-a disk.img\*(Aq،
\&   \*(Aq\-d libvirt\-domain\*(Aq، \*(Aq\-x\*(Aq، \*(Aq\-v\*(Aq پشتیبانی می‌کنند. تجزیه‌ی قدیمی
\&   گزینه‌های خط فرمان برای سازگاری در اسکریپت‌ها و غیره حفظ شده است.
\&
\& \- ابزار guestfish دیگر هیچ وابستگی به Perl ندارد.
\&
\& \- صفحات راهنمای جدید شامل مثال‌های برنامه‌نویسی: guestfs\-examples(3) (C/C++)،
\&   guestfs\-ocaml(3)، guestfs\-python(3)، guestfs\-ruby(3).
\&
\& \- حالت ردیابی (Trace mode) مقادیر بازگشتی از توابع API را چاپ می‌کند.
\&
\& \- ابزار virt\-inspector می‌تواند برنامه‌های نصب‌شده در مهمان‌های Windows را
\&   همراه با اطلاعات بسیار زیادی درباره‌ی آن برنامه‌ها فهرست کند.
\&
\& \- افزودن پشتیبانی برای بازرسی: Linux Mint، Mandriva، FreeBSD.
\&
\& \- گزینه‌ی \-\-rw در guestfish (در حال حاضر بدون تأثیر) برای صریح کردن
\&   دسترسی‌های نوشتن بالقوه خطرناک.
\&
\& \- گزینه‌های \-\-listen \-\-csh در guestfish برای سازگاری با csh و tcsh (با تشکر
\&   از Eric Blake).
\&
\& \- اولین نسخه‌ی بالادستی که هر تابع API را معرفی کرده است، اکنون در
\&   guestfs(3) مستند شده است.
\&
\& \- تابع guestfs_last_errno به شما اجازه می‌دهد تا errno را از
\&   دیمن بازیابی کنید که به درستی به سیستم‌عامل محلی ترجمه شده است.
\&
\& \- توابع اکنون می‌توانند پارامترهای اختیاری داشته باشند.
\&
\& \- نوارهای پیشرفت و اعلانات پیشرفت اکنون می‌توانند برای دستورهای
\&   بارگذاری (upload) رخ دهند.
\&
\& \- سازنده‌ی appliance دقت بیشتری به خرج می‌دهد تا فایل‌های موقت را در
\&   /tmp باقی نگذارد.
\&
\& \- دستورهای getfattr/setfattr به virt\-rescue اضافه شدند.
\&
\& \- فایل ROADMAP شامل نقشه‌ی راه و اهداف برای انتشار‌های آینده است.
.Ve
.SS "امنیت (Security)"
.IX Subsection "Security"
.Vb 1
\& \- بخش جدید SECURITY در مستندات API در guestfs(3).
\&
\& \- ابزار virt\-inspector دیگر هیچ دستوری را در ماشین مهمان اجرا نمی‌کند.
\&
\& \- کد بازرسی در اجتناب از فایل‌های بسیار بزرگ از مهمان‌ها که قبلاً ممکن
\&   بود باعث بروز منع سرویس (denial of service) شوند، دقت بیشتری به خرج می‌دهد.
\&
\& \- فراخوانی‌های FUSE به درون guestmount اکنون هنگام استفاده از guestmount \-x
\&   ردیابی می‌شوند.
.Ve
.SS "APIهای جدید (New APIs)"
.IX Subsection "New APIs"
.Vb 10
\& \- add\-domain
\& \- add\-drive\-opts
\& \- getxattr
\& \- inspect\-get\-hostname
\& \- inspect\-get\-package\-format
\& \- inspect\-get\-package\-management
\& \- inspect\-get\-roots
\& \- inspect\-list\-applications
\& \- lgetxattr
\& \- mkfs\-opts
.Ve
.SS "سازوکارهای درونی (Internals)"
.IX Subsection "Internals"
.Vb 1
\& \- برنامه‌های C اکنون دقیقاً فقط با کتابخانه‌هایی که استفاده می‌کنند پیوند می‌خورند.
\&
\& \- کتابخانه‌های PCRE، libmagic، hivex و libvirt اکنون برای ساخت کاملاً
\&   اختیاری هستند.
\&
\& \- نشت‌های حافظه و نشت‌های توصیف‌گر فایل متعددی رفع شدند.
\&
\& \- افزودن یک لفاف POD برای یکپارچه‌سازی تولید صفحات راهنما و فایل‌های HTML
\&   در تمامی برنامه‌ها.
\&
\& \- سورس‌کد شامل ایمیج‌های ساختگی از مهمان‌های Fedora، Debian، Ubuntu و
\&   Windows است.
\&
\& \- اتصالات زبان Ruby دارای قاعده‌ی \*(Aqmake install\*(Aq هستند.
\&
\& \- فایل سرآیند <guestfs.h> اکنون یک فایل واحد است.
\&
\& \- فایل سرآیند <guestfs.h> نیازی به هدرهای XDR ندارد.
\&
\& \- کتابخانه‌ی ocaml xml\-light دیگر برای ساخت مورد نیاز نیست (با تشکر
\&   از Maxim Koltsov).
\&
\& \- گزینه‌ی ./configure \-\-disable\-[...] برای اتصالات هر زبان (با تشکر
\&   از Maxim Koltsov).
\&
\& \- برنامه‌ی قدیمی ocaml\-viewer حذف شد (به جای آن از guestfs\-browser استفاده کنید).
\&
\& \- نوع جدید آزمون C API با نام \*(AqInitScratchFS\*(Aq باعث می‌شود آزمون‌ها کمی
\&   سریع‌تر اجرا شوند.
\&
\& \- بسته‌های مستثنی‌شده در appliance اکنون در یک فایل مجزا با نام
\&   appliance/excludelist.in فهرست شده‌اند و می‌توانند به ازای هر توزیع سفارشی‌سازی شوند.
.Ve
.SS "باگ‌های رفع‌شده (Bugs fixed)"
.IX Subsection "Bugs fixed"
.Vb 6
\& \- 663407 تابع readlink و readlinklist در برخی مسیرها /sysroot/ برمی‌گردانند
\& \- 661280 ابزار virt\-rescue: وحشت (panic) هنگام خاموش شدن: "/sbin/reboot: No such file or directory"
\& \- 657499 نوع نادرست checksum باعث شکست umount می‌شود
\& \- 655554 مسیرهای کل دیسک توسط virt\-inspector استاندارد (canonical) نمی‌شوند
\& \- 654638 بروزرسانی openssl به 1.0.0b؛ وابستگی libguestfs به نام‌های دقیق فایل
\& \- 652796 اتصالات ruby توسط \*(Aqmake install\*(Aq نصب نمی‌شوند، از این رو از توزیع دودویی حذف شده‌اند
.Ve
.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 "AUTHOR"
Richard W.M. Jones
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2025 Red Hat Inc.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public 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 را در گزارش باگ جای‌گذاری کنید.