.\" -*- 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.12 1"
.TH guestfs-release-notes-1.12 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.12 (RELEASE NOTES FOR LIBGUESTFS 1.12)"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.12"
این یادداشت‌های انتشار تنها تفاوت‌ها نسبت به انشعاب پایدار/توسعه قبلی (1.10.0) را پوشش می‌دهند. برای گزارش تغییرات تفصیلی، لطفاً به مخزن گیت یا فایل ChangeLog توزیع‌شده در تاربال مراجعه کنید.
.SS "قابلیت‌های جدید (New features)"
.IX Subsection "New features"
\fIguestfish\fR
.IX Subsection "guestfish"
.PP
.Vb 2
\&   \- رشته‌های guestfish می‌توانند از توالی‌های گریز استفاده کنند؛
\&     مانند: ><fs> write /foo "line 1\enline 2\en"
\&
\&   \- دستور write\-append در guestfish می‌تواند برای افزودن به انتهای فایل‌ها استفاده شود.
\&
\&   \- آپلودها و دانلودهای طولانی‌مدت فایل را می‌توان از طریق API یا با زدن ^C در guestfish لغو کرد.
\&
\&   \- دستور جدید "display" در guestfish برای نمایش فایل‌های گرافیکی داخل مهمان‌ها.
\&
\&   \- در guestfish، تکمیل خودکار با کلید تب (Tab completion) اکنون روی دستگاه‌های /dev/mapper کار می‌کند.
.Ve
.PP
\fIvirt\-inspector\fR
.IX Subsection "virt-inspector"
.PP
.Vb 1
\&   \- رابط API بازرسی می‌تواند آیکون یا لوگوی مهمان‌های خاصی را دریافت کند.
\&
\&   \- ابزار virt\-inspector شامل لوگو و نام میزبان (hostname) برای مهمان‌های خاص می‌شود.
\&
\&   \- ابزار virt\-inspector اکنون می‌تواند شماره نسخه و انتشار بسته‌های RPM را دریافت کند.
\&
\&   \- توزیع‌های CentOS و Scientific Linux اکنون توسط رابط API بازرسی به عنوان توزیع‌های مجزا در نظر گرفته می‌شوند.
.Ve
.PP
\fIvirt\-resize\fR
.IX Subsection "virt-resize"
.PP
.Vb 1
\&   \- ابزار virt\-resize اکنون می‌تواند فایل‌سیستم btrfs را مدیریت کند.
\&
\&   \- گزینه جدید virt\-resize به نام \-\-ntfsresize\-force اجازه می‌دهد ماشین‌های مجازی ویندوز چندین بار تغییر اندازه داده شوند.
.Ve
.PP
\fIسایر ابزارهای virt (other virt tools)\fR
.IX Subsection "other virt tools"
.PP
.Vb 4
\&   \- ابزارهای guestfish، guestmount، virt\-cat، virt\-df، virt\-edit، virt\-filesystems،
\&     virt\-inspector، virt\-ls و virt\-rescue اکنون به شما امکان می‌دهند با استفاده از
\&     گزینه "\-d UUID" یک مهمان را با UUID مشخص کنید. این قابلیت استفاده از آن‌ها را
\&     از طریق برنامه‌های دیگر مطمئن‌تر می‌سازد.
\&
\&   \- گزینه virt\-ls \-lR امکان پیمایش پیچیده فایل‌ها و تحلیل مهمان را فراهم می‌کند.
\&
\&   \- ابزار virt\-win\-reg از کلیدهای HKEY_USERS\e<SID> و HKEY_USERS\e<username> پشتیبانی می‌کند.
\&
\&   \- گزینه جدید virt\-win\-reg به نام \-\-unsafe\-printable\-strings اجازه می‌دهد رشته‌های
\&     قابل چاپ در خروجی نمایش داده شوند (به‌صورت ناامن: پیش از استفاده مستندات را بخوانید).
\&
\&   \- ابزار virt\-edit مجدداً با زبان C بازنویسی شده است.
.Ve
.PP
\fIرابط برنامه‌نویسی و بایندینگ‌های زبان‌ها (API and language bindings)\fR
.IX Subsection "API and language bindings"
.PP
.Vb 2
\&   \- زبان Java اکنون به طور کامل پشتیبانی می‌شود.
\&     ببینید: http://libguestfs.org/guestfs\-java.3.html
\&
\&   \- زبان JRuby از طریق بایندینگ‌های Java پشتیبانی می‌شود.
\&
\&   \- تابع guestfs_close اکنون در پیام‌های ردگیری (trace) ظاهر می‌شود.
\&
\&   \- بایندینگ پایتون متد صریح ()g.close را اضافه می‌کند.
\&
\&   \- برنامه‌های پایتون اکنون می‌توانند از API رویدادهای جدید استفاده کنند.
\&
\&   \- قفل مفسر پایتون (GIL) در حین فراخوانی‌های libguestfs آزاد می‌شود و به برنامه‌های
\&     چندنخی پایتون اجازه می‌دهد به درستی کار کنند.
\&
\&   \- فایل‌سیستم‌های 9pfs (فایل‌سیستم‌های Plan 9 صادر شده از میزبان) اکنون پشتیبانی می‌شوند.
\&
\&   \- افزودن پرچم DGUESTFS_WARN_DEPRECATED=1\- جهت هشدار درباره استفاده از توابع منسوخ API در برنامه‌های C.
\&
\&   \- صفحه راهنمای جدید guestfs\-recipes(1) همراه با دستورالعمل‌ها و الگوها.
\&
\&   \- تابع mkfs\-opts اکنون می‌تواند اندازه inode و اندازه بخش (sector) را روی فایل‌سیستم‌های ایجادشده تنظیم کند (با تشکر از Nikita Menkovich).
\&
\&   \- تابع guestfs_last_errno اکنون از OCaml (به‌صورت (()g#last_errno)) در دسترس است.
.Ve
.SS "امنیت (Security)"
.IX Subsection "Security"
.Vb 3
\& \- مقدار optargs_bitmask حتی برای فراخوانی‌هایی که هیچ آرگومان اختیاری
\&   ندارند نیز بررسی می‌شود. این کار از اکسپلویت احتمالی در دیمن توسط فراخوان‌های
\&   غیرقابل اعتماد جلوگیری می‌کند.
.Ve
.SS "رابط‌های جدید (New APIs)"
.IX Subsection "New APIs"
.Vb 3
\&  btrfs\-filesystem\-resize, get\-pgroup, inspect\-get\-icon, is\-zero,
\&  is\-zero\-device, list\-9p, list\-dm\-devices, mount\-9p, ntfsresize\-opts,
\&  set\-pgroup, write\-append
.Ve
.SS "بخش‌های درونی (Internals)"
.IX Subsection "Internals"
.Vb 2
\& \- ابزار Coverity (ابزار تحلیل ایستای کد) روی سراسر کدبیس اجرا شد و
\&   اصلاحات متعددی اعمال گردید.
\&
\& \- ماژول Generator اکنون می‌تواند توابعی را که RBufferOut برمی‌گردانند و
\&   آرگومان‌های اختیاری دارند مدیریت کند.
\&
\& \- سازگاری با Perl 5.14.
\&
\& \- سازگاری با gcc 4.6.
\&
\& \- اجرای بررسی‌های ایمنی روی QEMU.
\&
\& \- آزمون‌های C API اکنون می‌توانند فراخوانی‌های دارای آرگومان‌های اختیاری را به طور کامل آزمایش کنند.
\&
\& \- استفاده از configure \-\-enable\-install\-daemon/. برای نصب usr/sbin/guestfsd/.
\&
\& \- دایرکتوری po\-docs اکنون تمامی صفحات راهنما را پوشش می‌دهد.
\&
\& \- خروجی خطای استاندارد (stderr) از پردازش qemu اکنون توسط زیرسیستم رویدادها دریافت می‌شود.
.Ve
.SS "اشکالات برطرف‌شده (Bugs fixed)"
.IX Subsection "Bugs fixed"
.Vb 7
\& \- 602997 part\-get\-bootable gives wrong result with an unordered part layout
\& \- 661280 virt\-rescue: panic when shutting down: "/sbin/reboot: No such file or directory"
\& \- 700369 qemu\-system\-x86_64 says \*(AqKVM not supported for this target\*(Aq
\& \- 705200 guestmount attempt results in access denied
\& \- 714981 \*(Aqlist\-filesystems\*(Aq does not know about virtio 9p filesystems or detect existing mounts
\& \- 717786 libguestfs python bindings should have an explicit close call
\& \- 721275 virt\-resize in F16 should support btrfs
.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) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه 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 آن در گزارش باگ.