.\" -*- 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.10 1"
.TH guestfs-release-notes-1.10 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\-1.10 \- یادداشت‌های انتشار نسخه ۱.۱۰ ابزار libguestfs
.SH "یادداشت‌های انتشار LIBGUESTFS 1.10 (RELEASE NOTES FOR LIBGUESTFS 1.10)"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.10"
این یادداشت‌های انتشار تنها تفاوت‌ها نسبت به تفکیک شاخه پایدار/توسعه پیشین (1.8.0) را پوشش می‌دهند. برای گزارش تغییرات تفصیلی، لطفاً مخزن گیت یا فایل ChangeLog توزیع‌شده در بسته تاربال را مشاهده کنید.
.SS "ویژگی‌های جدید (New features)"
.IX Subsection "New features"
.Vb 4
\& \- امکان استفاده از libguestfs و ابزارهای آن برای ماشین‌های مجازی زنده (در حال اجرا).
\&   گزینه‌های \*(Aqguestfish \-\-live\*(Aq و \*(Aqguestmount \-\-live\*(Aq و (برای
\&   رابط سطح پایین) رابط‌های برنامه‌نویسی جدید set\-attach\-method و
\&   get\-attach\-method را مشاهده کنید.
\&
\& \- ابزارهای virt جدید:
\&   virt\-copy\-in, virt\-copy\-out, virt\-tar\-in, virt\-tar\-out.
\&
\& \- قابلیت دریافت نگاشت حروف درایو برای سیستم‌های مهمان ویندوز در libguestfs.
\&
\& \- نمایش نگاشت حروف درایو برای سیستم‌های مهمان ویندوز توسط virt\-inspector.
\&
\& \- امکان استفاده از حروف درایو در برنامه‌های virt\-edit و guestfish
\&   هنگام کار بر روی سیستم‌های مهمان ویندوز.
\&
\& \- اجرای virt\-resize روی میزبان‌های ۳۲ بیتی.
\&
\& \- امکان بررسی دیسک‌های نصب و دیسک‌های زنده (Live CD) بسیاری از
\&   سیستم‌عامل‌های مختلف.
\&
\& \- قابلیت <! cmd در guestfish که دستور شل را اجرا کرده و نتیجه را درون‌خطی قرار می‌دهد.
\&
\& \- پشتیبانی هم‌زمان guestfish، guestmount و virt\-rescue از گزینه‌های \-\-ro و \-\-rw
\&   و امکان انتخاب حالت پیش‌فرض از طریق فایل پیکربندی
\&   (/etc/libguestfs\-tools.conf).
\&
\& \- رابط برنامه‌نویسی رویدادهای جدید (Event API) که امکان ثبت بیش از یک کال‌بک برای
\&   هر رویداد را فراهم کرده، فراخوانی API از سایر زبان‌ها را ممکن می‌سازد
\&   و اجازه می‌دهد تقریباً تمام پیام‌های لاگ، اشکال‌زدایی و ردگیری به جای stderr
\&   تغییر مسیر داده شوند.
\&
\& \- انطباق بیشتر با استاندارد سلسله‌مراتب فایل‌سیستم (FHS) برای فایل‌های موقت، از جمله استفاده از /var/tmp
\&   برای فایل‌های بزرگ کَش‌شده که باید پس از راه‌اندازی مجدد باقی بمانند (به‌جای /tmp).
\&
\& \- گزینه \-m در guestfish و guestmount که اجازه ارسال گزینه‌های مانت
\&   به فایل‌سیستم زیربنایی را می‌دهد.
\&
\& \- قابلیت mkfs\-opts برای مشخص کردن ویژگی‌های فایل‌سیستم.
\&
\& \- مدیریت هوشمندانه‌تر نقاط مانت، که امکان کارکرد هماهنگ و صحیح دستورهای mkmountpoint، mount
\&   و umount\-all را فراهم می‌کند.
\&
\& \- پیام‌های ردگیری اکنون دارای یک پیشوند متمایز هستند تا بتوان
\&   آن‌ها را به راحتی از خروجی اشکال‌زدایی با grep جدا کرد.
\&
\& \- دستور guestfs_launch (دستور \*(Aqrun\*(Aq در guestfish) اکنون در صورتی که اجرای آن بیش از ۵
\&   ثانیه طول بکشد، پیام‌های پیشرفت (نوار پیشرفت guestfish) تولید می‌کند.
\&
\& \- چندین دستور طولانی‌مدت که امکان تخمین زمان پایان آن‌ها وجود ندارد رویدادهای پیشرفت "حالت نبض" (pulse mode)
\&   تولید می‌کنند. نوار پیشرفت در guestfish برای نمایش این رویدادها به‌روزرسانی شده است.
\&
\& \- انتشار کدهای نمونه جدید به زبان‌های: C، Perl، Python، OCaml و Ruby.
\&
\& \- برنامه نمونه جدید virt\-dhcp\-address.
\&
\& \- بهبود چشمگیر اتصالات (bindings) زبان‌های Java و Ruby.
\&
\& \- افزودن روشی در زبان Perl برای دریافت errno آخرین خطا.
\&
\& \- سازگاری اتصالات پایتون با rpyc (با تشکر از Erez Shinan).
\&
\& \- استفاده از Transifex برای مدیریت ترجمه‌ها:
\&   http://www.transifex.net/projects/p/libguestfs
\&
\& \- پشتیبانی از توزیع‌های Red Hat Desktop و Slackware در بخش بازرسی (Inspection).
\&
\& \- رفع خطای بازرسی برای سیستم‌های مهمان ویندوز دارای دو یا
\&   چند دیسک.
\&
\& \- توانایی تفکیک میان Windows 2008 Server
\&   و Windows 7 در بخش بازرسی.
\&
\& \- قابلیت تشخیص برنامه‌های ۳۲ بیتی نصب‌شده در ویندوز ۶۴ بیتی
\&   که بر روی شبیه‌ساز WOW64 اجرا می‌شوند.
\&
\& \- رفع باگ قدیمی RHBZ#576879 از طریق یک سری اصلاحات پروتکلی
\&   که قبلاً باعث می‌شد خطاها در حین دستور upload هماهنگی پروتکل را از بین ببرند.
\&
\& \- نشان‌واره (لوگوی) جدید!
.Ve
.SS "امنیت (Security)"
.IX Subsection "Security"
.Vb 1
\&  [هیچ]
.Ve
.SS "رابط‌های برنامه‌نویسی جدید (New APIs)"
.IX Subsection "New APIs"
.Vb 4
\&  first\-private, get\-attach\-method, inspect\-get\-drive\-mappings,
\&  inspect\-get\-product\-variant,
\&  inspect\-get\-windows\-current\-control\-set, next\-private, resize2fs\-M,
\&  set\-attach\-method.
.Ve
.SS "ساختار داخلی (Internals)"
.IX Subsection "Internals"
.Vb 2
\& \- فایل \*(AqHACKING\*(Aq منسوخ شده است. محتوای آن به
\&   بخشی از صفحه راهنمای guestfs(3) منتقل شده است.
\&
\& \- ساده‌سازی ابزار libguestfs\-test\-tool. این ابزار دیگر نیازی به باینری استاتیک
\&   ندارد و تلاشی برای ساخت فایل ISO نمی‌کند.
\&
\& \- فایل‌های تولیدشده توسط rpcgen با فلگ \-fno\-strict\-aliasing کامپایل می‌شوند
\&   که ایمن‌تر خواهد بود (با تشکر از Matt Booth).
\&
\& \- بازنویسی ابزار virt\-resize به زبان OCaml.
\&
\& \- آزمایش guestfish و ابزارهای دیگر با valgrind و رفع برخی از نشت‌های حافظه.
.Ve
.SS "باگ‌های رفع‌شده (Bugs fixed)"
.IX Subsection "Bugs fixed"
.Vb 10
\& \- 502533 به‌روزرسانی ترجمه لهستانی libguestfs
\& \- 576879 قطع هماهنگی پروتکل libguestfs در صورت استفاده از \*(Aqupload\*(Aq قبل از مانت کردن دیسک‌ها
\& \- 599503 مستندسازی عدم امکان ترکیب دستورهای mkmountpoint و umount\-all
\& \- 617440 عدم موفقیت guestfish در گسترش تیلدا (\*(Aq~\*(Aq) در زمان تنظیم نبودن متغیر محیطی $HOME
\& \- 664558 درخواست ویژگی: امکان تنظیم کال‌بک لاگ در اتصالات Ruby
\& \- 665358 تکمیل ترجمه پنجابی (pa_IN)
\& \- 666577 خطای فایل‌سیستم ناشناخته در libguestfs برای /dev/fd0
\& \- 667610 باگ‌های متعدد و نشت حافظه در اتصالات Ruby برای libguestfs
\& \- 668112 خطای دستور virt\-filesystems روی سیستم مهمان با برچسب فایل‌سیستم آسیب‌دیده
\& \- 668574 تلاش guestfish \-i برای مانت همه موارد از /etc/fstab و شکست با خطا هنگام نبود دستگاه
\& \- 673479 افزودن یک رشته مناسب برای grep به خروجی LIBGUESTFS_TRACE
\& \- 674130 خطای کد بازرسی برای سیستم مهمان ویندوز با دو دیسک
\& \- 682756 خطای نقض حافظه (segfault) در ردگیری libguestfs هنگام بازگرداندن خطا توسط list\-filesystems
\& \- 682979 تشخیص اشتباه Red Hat desktop به عنوان \*(Aqredhat\-based\*(Aq به جای \*(Aqredhat\*(Aq توسط libguestfs
\& \- 690819 شکست mkfs در ایجاد فایل‌سیستم روی دیسک با رابط \*(Aqide\*(Aq
\& \- 691389 عدم کارکرد ویژگی‌های توسعه‌یافته (Extended attributes) در guestmount (FUSE)
\& \- 691724 گزارش فایل‌سیستم ناشناخته /dev/vda1 توسط virt\-inspector
\& \- 692545 خطای inspect\-list\-applications در تشخیص برنامه‌های ۳۲ بیتی نصب‌شده تحت شبیه‌ساز WOW64 در ویندوز ۶۴ بیتی
\& \- 693324 پذیرش فقط نوع \*(Aqlist\*(Aq برای پارامتر lines در رابط پایتون sfdisk
.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 "نویسنده (AUTHOR)"
.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 GPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد؛ نسخه ۲ یا (به انتخاب خودتان) هر نسخه بالاتر، بازتوزیع کرده یا تغییر دهید.
.PP
این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانتی؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «اجازه‌نامه عمومی همگانی گنو» مراجعه کنید.
.PP
شما باید به همراه این برنامه یک نسخه از اجازه‌نامه عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت به شرکت بنیاد نرم‌افزارهای آزاد به آدرس زیر بنویسید:
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 آن در گزارش اشکال.