.\" -*- 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.14 1"
.TH guestfs-release-notes-1.14 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.14 (RELEASE NOTES FOR LIBGUESTFS 1.14)"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.14"
این یادداشت‌های انتشار تنها تفاوت‌ها نسبت به تفکیک شاخهٔ پایدار/توسعه قبلی (1.12.0) را پوشش می‌دهند. برای مشاهدهٔ گزارش تفصیلی تغییرات، لطفاً مخزن git یا فایل ChangeLog ارائه‌شده در tarball را ببینید.
.SS "ویژگی‌های جدید (New features)"
.IX Subsection "New features"
.Vb 1
\&  اتصال‌های (bindings) زبان Erlang.
\&
\&  ابزار virt\-alignment\-scan، ابزاری جدید برای بررسی هم‌ترازی
\&  پارتیشن‌ها درون ماشین‌های مجازی یا تصاویر دیسک است.
\&
\&  ابزار virt\-sparsify، ابزاری جدید برای خلوت‌سازی (sparse کردن)
\&  تصاویر دیسک ماشین مجازی است.
\&
\&  ابزار virt\-sysprep، ابزاری جدید برای ساده‌تر کردن کلون‌گیری
\&  از مهمان‌ها بر پایهٔ یک الگو (template) است.
.Ve
.PP
\fIguestfish\fR
.IX Subsection "guestfish"
.PP
.Vb 1
\&   \- دستورهای جدید setenv و unsetenv برای تنظیم متغیرهای محیطی.
\&
\&   \- نام فایل ورودی و شماره خط در پیام‌های خطا چاپ می‌شود.
\&
\&   \- نوارهای پیشرفت guestfish اکنون یک «کتابخانهٔ کوچک» (mini\-library)
\&     هستند که توسط سایر ابزارها نیز استفاده می‌شوند.
.Ve
.PP
\fIguestmount\fR
.IX Subsection "guestmount"
.PP
.Vb 1
\&   \- گزینهٔ \-\-live (برای دسترسی به ماشین‌های مجازی زنده/در حال اجرا) اکنون کار می‌کند.
.Ve
.PP
\fIvirt\-cat\fR
.IX Subsection "virt-cat"
.PP
.Vb 1
\&   \- ابزار virt\-cat اکنون می‌تواند مسیرها و حروف درایو Windows را مدیریت کند (RHBZ#693359).
.Ve
.PP
\fIvirt\-filesystems\fR
.IX Subsection "virt-filesystems"
.PP
.Vb 1
\&   \- بایت نوع پارتیشن MBR در خروجی \-\-long نمایش داده می‌شود.
.Ve
.PP
\fIvirt\-make\-fs\fR
.IX Subsection "virt-make-fs"
.PP
.Vb 2
\&   \- اکنون virt\-make\-fs بایت نوع پارتیشن MBR را به‌درستی تنظیم می‌کند
\&     که سازگاری با Windows را بهبود می‌بخشد (RHBZ#746295).
.Ve
.PP
\fIvirt\-resize\fR
.IX Subsection "virt-resize"
.PP
.Vb 2
\&   \- ابزار virt\-resize اکنون می‌تواند با مهمان‌هایی که از پارتیشن‌های گسترش‌یافته
\&     (extended) و منطقی (logical) استفاده می‌کنند، به‌ویژه مهمان‌های Ubuntu کار کند.
\&
\&   \- اکنون virt\-resize می‌تواند اولین پارتیشن مهمان‌های Windows را هم‌تراز کند
\&     که باعث بهبود کارایی می‌شود. گزینهٔ جدید \-\-align\-first در virt\-resize این
\&     رفتار را کنترل می‌کند.
\&
\&   \- پرچم \-\-machine\-readable در virt\-resize امکان استفاده از virt\-resize را
\&     توسط سایر برنامه‌ها فراهم می‌کند.
\&
\&   \- پارتیشن‌ها اکنون به‌طور پیش‌فرض با ۱۲۸ سکتور (معمولاً 64K) هم‌تراز
\&     می‌شوند. این امر کارایی را در فضاهای ذخیره‌سازی پیشرفته (high\-end) افزایش
\&     می‌دهد. گزینهٔ جدید \-\-alignment در virt\-resize امکان تغییر این هم‌ترازی را
\&     فراهم می‌سازد.
.Ve
.PP
\fIvirt\-win\-reg\fR
.IX Subsection "virt-win-reg"
.PP
.Vb 2
\&   \- نحو (syntax) حذف کلیدها و مقادیر رجیستری در صفحه راهنما (man page)
\&     مستند شده است (RHBZ#737944).
.Ve
.PP
\fIکتابخانه (library)\fR
.IX Subsection "library"
.PP
.Vb 1
\&   \- نویسه‌های غیرقابل‌چاپ به‌درستی در خروجی اشکال‌زدایی (debug) گریز (escape) داده می‌شوند.
\&
\&   \- رویداد GUESTFS_EVENT_ENTER یک نوع رویداد جدید است که هنگام فراخوانی هر یک
\&     از توابع libguestfs تولید می‌شود.
\&
\&   \- کتابخانه شامل پروب‌های (probes) مربوط به systemtap/DTrace است.
\&
\&   \- کتابخانه اکنون می‌تواند بدون hivex کامپایل شود (RHBZ#723474).
.Ve
.PP
\fIبازرسی (inspection)\fR
.IX Subsection "inspection"
.PP
.Vb 1
\&   \- بهبود شناسایی دیسک‌های Windows.
\&
\&   \- افزودن پشتیبانی از:
\&         ttylinux \- یک لینوکس کمینه
\&         Mageia (با تشکر از Michael Scherer)
\&         OpenSUSE و zypper (با تشکر از Michael Scherer و Vincent Untz)
\&         نشان‌های تصویری Ubuntu (با تشکر از Michael Scherer)
\&         NetBSD و pkgsrc (با تشکر از Michael Scherer)
\&
\&   \- پشتیبانی از برخی انواع مهمان‌ها که در /etc/fstab از /dev/root استفاده می‌کنند.
\&
\&   \- رفع مشکل مدیریت مهمان‌های دارای بیش از ۲۶ دیسک (با تشکر از Matthew Booth)
\&
\&   \- افزودن پشتیبانی از مهمان‌های دارای دیسک‌های HP Smart Array (با تشکر از Matthew Booth)
.Ve.PP
\fIfebootstrap\fR
.IX Subsection "febootstrap"
.PP
.Vb 2
\&   \- متغیرهای محیطی FEBOOTSTRAP_KERNEL و FEBOOTSTRAP_MODULES را می‌توان
\&     برای انتخاب این‌که از کدام کرنل برای appliance استفاده شود، تنظیم کرد.
.Ve
.PP
\fImisc (متفرقه)\fR
.IX Subsection "misc"
.PP
.Vb 1
\&   \- پشتیبانی از ArchLinux اکنون با Linux 3.0 کار می‌کند (با تشکر از Erik Nolte)
\&
\&   \- دیسک‌های libvirt با علامت <readonly/> اکنون هنگام استفاده از گزینه
\&     \*(Aq\-d\*(Aq در virt\-tools به‌صورت فقط‌خواندنی (readonly) اضافه می‌شوند.
.Ve
.SS "امنیت (Security)"
.IX Subsection "Security"
.Vb 1
\&  (هیچ مشکل امنیتی در این نسخه یافت یا برطرف نشد)
.Ve
.SS "رابط‌های جدید (New APIs)"
.IX Subsection "New APIs"
.Vb 3
\&  compress\-out, compress\-device\-out, copy\-device\-to\-device,
\&  copy\-device\-to\-file, copy\-file\-to\-device, copy\-file\-to\-file,
\&  get\-smp, part\-to\-partnum, set\-smp.
\&
\&  رابط mount دیگر گزینه‌های \-o sync,noatime را به‌طور ضمنی اضافه نمی‌کند.
\&
\&  تابع add\-domain دارای یک پارامتر اختیاری جدید \*(Aqreadonlydisk\*(Aq است تا
\&  نحوه مدیریت دیسک‌های <readonly/> را کنترل کند.
.Ve
.SS "سازوکار درونی (Internals)"
.IX Subsection "Internals"
.Vb 2
\& \- ابزار Coverity روی کدهای منبع اجرا شد و باگ‌های بیشتری شناسایی و
\&   برطرف شدند.
\&
\& \- اکنون کتابخانه PCRE برای ساخت libguestfs مورد نیاز است.
\&
\& \- قابلیت APIC اکنون حالت پیش‌فرض برای appliance است. شما همچنین می‌توانید
\&   پشتیبانی از SMP را در appliance فعال کنید.
\&
\& \- اتصالات OCaml اکنون در طول callbackها قفل GC را به‌درستی دریافت می‌کنند.
\&
\& \- ساخت‌های خارج از درخت کد (Out of tree) اکنون باید به‌درستی کار کنند (با تشکر از Hilko Bengen).
\&
\& \- بسته‌سازها می‌توانند از ./configure \-\-with\-extra="..." برای تنظیم
\&   رشته نسخه اضافی استفاده کنند.
\&
\& \- رابط‌های برنامه‌نویسی zero و zero\-device: اگر بلوک‌ها از قبل حاوی صفر باشند،
\&   صفرها بازنویسی نمی‌شوند تا فضای ذخیره‌سازی زیرین بی‌جهت غیرتنک (non\-sparse) نشود.
\&
\& \- رابط‌های برنامه‌نویسی is\-zero و is\-zero\-device: این توابع بهینه‌سازی شده‌اند
\&   تا تشخیص صفر سریع‌تر انجام شود.
.Ve
.SS "باگ‌های رفع‌شده (Bugs fixed)"
.IX Subsection "Bugs fixed"
.Vb 10
\& \- 748266 برنامه libguestfs باید نسخه‌هایی از qemu را که به گزینه \-machine pc نیاز دارند، تشخیص دهد
\& \- 747290 برنامه libguestfs تگ <readonly/> را در libvirt XML نادیده می‌گیرد
\& \- 747287 پیام خطای گمراه‌کننده هنگام رد دسترسی (permission denied) در زمان باز کردن ایمیج دیسک
\& \- 746295 ابزار virt\-make\-fs شناسه پارتیشن را تنظیم نمی‌کند
\& \- 744795 قابلیت guestmount \-\-live قابل استفاده نیست
\& \- 737944 نحو خط‌تیره (کلید حذف) در virt\-win\-reg ممکن است اشتباه باشد و مستندسازی نشده است
\& \- 733297 مدیریت‌کننده‌های رویداد ruby با خطای "exception in callback: wrong argument type Proc (expected Data)" شکست می‌خورند
\& \- 731744 برنامه libguestfs باید نویسه‌های خاص/غیرقابل‌چاپ را در خروجی اشکال‌زدایی گریزدهی (escape) کند
\& \- 729887 کرش کردن appliance هنگام اجرای aug_init با flags=4
\& \- 729075 برنامه libguestfs پارتیشن Hp_recovery را با فایل‌سیستم ریشه Windows اشتباه می‌گیرد
\& \- 727178 خطای error: luks_open: cryptsetup: error while loading shared libraries: libfipscheck.so.1: cannot open shared object file: No such file or directory
\& \- 726739 خطای libguestfs: error: aug_get: no matching node, trying to find hostname
\& \- 723474 در صورت نصب نبودن hivex و/یا pcre، کامپایل libguestfs شکست می‌خورد
\& \- 693359 ابزارهای virt\-cat و virt\-edit مسیرهای حساس به حروف کوچک و بزرگ در NTFS را به‌درستی مدیریت نمی‌کنند
\& \- 678231 ابزار virt\-inspector یک شناسه UUID ناشناخته برای فایل‌سیستم گزارش می‌دهد
\& \- 671082 برنامه libguestfs با kernel\-rt کار نمی‌کند
\& \- 666578 خطای libguestfs: unknown filesystem label SWAP\-sda2
\& \- 642821 ابزار virt\-resize روی یک ایمیج دیسک با پارتیشن منطقی swap از کار می‌افتد
.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 "AUTHORS"
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) که توسط «بنیاد نرم‌افزارهای آزاد» منتشر شده است، چه نسخهٔ ۲ مجوز و چه (به انتخاب خودتان) هر نسخهٔ جدیدتری، بازتوزیع کرده یا تغییر دهید.
.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 آن در گزارش باگ.