.\" -*- 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.4 1"
.TH guestfs-release-notes-1.4 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.4 \- یادداشت‌های انتشار نسخه ۱.۴ ابزار libguestfs
.SH "یادداشت‌های انتشار LIBGUESTFS 1.4 (RELEASE NOTES FOR LIBGUESTFS 1.4)"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.4"
این یادداشت‌های انتشار تنها تفاوت‌ها نسبت به تفکیک شاخه پایدار/توسعه پیشین (1.2.0) را پوشش می‌دهند. برای گزارش تغییرات تفصیلی، لطفاً مخزن گیت یا فایل ChangeLog توزیع‌شده در بسته تاربال را مشاهده کنید.
.SS "ویژگی‌های جدید (New features)"
.IX Subsection "New features"
.Vb 2
\& \- ابزار guestfish به شما امکان می‌دهد یک ایمیج دیسک آماده انتخاب کنید، مانند:
\&     guestfish \-N fs:ext4
\&
\& \- افزودن پشتیبانی از نوشتن به ماژول guestmount (FUSE).
\&
\& \- ابزار virt\-resize اکنون می‌تواند اندازه محتوای پارتیشن‌ها و حجم‌های منطقی
\&   (LV) در سیستم مهمان را تغییر دهد، همچنین پشتیبانی بهتری از کوچک کردن سیستم‌های مهمان داریم.
\&
\& \- اسکریپت تکمیل خودکار با کلید Tab در Bash برای guestfish.
\&
\& \- افزودن پشتیبانی از ZFS به virt\-rescue.
\&
\& \- ابزار جدید \*(Aqvirt\-make\-fs\*(Aq برای ایجاد سیستم‌های فایل به همراه محتوا.
\&
\& \- امکان استفاده از پسوندها در هر پارامتر عددی guestfish، مانند "1M".
\&
\& \- دستور \*(Aqman\*(Aq در guestfish که صفحه راهنما را باز می‌کند.
\&
\& \- پشتیبانی guestfish از ساختار "heredoc" برای آپلود فایل‌ها:
\&     upload \-<<_end_ /foo
\&     content
\&     _end_
\&
\& \- برخی دستورات guestfish اکنون خروجی خود را در مبنای هشت (octal) یا شانزده (hex)
\&   در صورت لزوم چاپ می‌کنند (RHBZ#583242).
\&
\& \- امکان استفاده از پیشوند خط تیره در خط فرمان guestfish. این کار هرگونه خطای
\&   دستور دوم را نادیده می‌گیرد:           (RHBZ#578407)
\&     guestfish \-\- cmd1 : \-cmd2 : cmd3
\&
\& \- دستور guestfish \-h / help اکنون برای دستورات ناموجود یک خطا برمی‌گرداند
\&   (RHBZ#597145).
\&
\& \- دستور جدید \*(Aqsupported\*(Aq در guestfish برای فهرست کردن گروه‌های اختیاری
\&   دستوراتی که توسط دیمن / پیکربندی پشتیبانی می‌شوند.
\&
\& \- ابزارهای virt\-inspector و guestfish \-i اکنون برای نام‌فایل‌هایی که
\&   شامل فاصله خالی هستند کار می‌کنند (RHBZ#507810).
\&
\& \- تغییر پروتکل برای استفاده از آدرس‌های محلی پیوند (link\-local)، جهت جلوگیری
\&   از تداخل با هر آدرسی که ممکن است میزبان استفاده کند
\&   (RHBZ#588763).
\&
\& \- ابزار libguestfs اکنون زمان و منطقه زمانی صحیح را در هنگام تغییرات
\&   سیستم فایل تنظیم می‌کند.
\&
\& \- مرتب‌سازی دامنه‌ها به ترتیب الفبایی در virt\-df.
\&
\& \- کارکرد درست دستور mkfs\-b برای FAT و NTFS از طریق نگاشت پارامتر اندازه بلوک
\&   به اندازه کلاستر (cluster size) (RHBZ#599464).
\&
\& \- افزودن شماره نسخه‌ها به ماژول‌های Perl (RHBZ#521674).
\&
\& \- بومی‌سازی اکنون برای تمام ابزارهای libguestfs کار می‌کند (RHBZ#559963).
\&
\& \- ابزارها اکنون از ماشین‌های مجازی با ساختار فایل‌سیستم روی ایمیج (filesystem\-on\-image)
\&   پشتیبانی می‌کنند (RHBZ#590167).
\&
\& \- گزینه \*(Aq\-t\*(Aq در virt\-list\-partitions برای نمایش اندازه کل دیسک‌ها.
\&
\& \- گنجاندن لنزهای بیشتر Augeas در اپلاینس supermin (Matthew Booth).
\&
\& \- افزودن کال‌بک‌های خطا و بستن.
\&
\& \- افزودن متد صریح close در رابط برنامه‌نویسی Perl.
\&
\& \- اصلاحات متعدد برای سازگاری با RHEL 5.
\&
\& \- اصلاحات متعدد برای سازگاری با Debian/Ubuntu.
\&
\& \- بازنگری‌های متعدد برای بهبود مستندات.
.Ve
.SS "امنیت (Security)"
.IX Subsection "Security"
.Vb 3
\& \- رفع یک حمله منع سرویس (DoS) بالقوه در virt\-inspector و virt\-v2v در صورتی که یک
\&   ایمیج دیسک دستکاری‌شده حاوی یک دستگاه کاراکتری به جای یکی از فایل‌های
\&   پیکربندی خوانده‌شده زیر /etc باشد (RHBZ#582484).
.Ve
.SS "رابط‌های برنامه‌نویسی جدید (New APIs)"
.IX Subsection "New APIs"
.Vb 10
\& \- aug\-clear \- پاک کردن مسیر Augeas
\& \- available\-all\-groups \- بازگرداندن فهرستی از تمام گروه‌های اختیاری
\& \- base64\-in \- آپلود داده‌های کدگذاری‌شده با base64 به فایل
\& \- base64\-out \- دانلود فایل و کدگذاری آن به صورت base64
\& \- checksum\-device \- محاسبه چکسام روی محتویات یک دستگاه
\& \- checksums\-out \- محاسبه چکسام چندین فایل در یک پوشه
\& \- debug\-upload \- آپلود یک فایل به اپلاینس
\& \- fallocate64 \- تخصیص از پیش فضا به یک فایل در فایل‌سیستم مهمان
\& \- fill\-pattern \- پر کردن یک فایل با یک الگوی تکرارشونده از بایت‌ها
\& \- get\-umask \- دریافت umask فعلی
\& \- lvresize\-free \- گسترش یک LV برای پر کردن فضای خالی
\& \- ntfsresize \- تغییر اندازه یک فایل‌سیستم NTFS
\& \- ntfsresize\-size \- تغییر اندازه یک فایل‌سیستم NTFS (با اندازه معین)
\& \- part\-del \- حذف یک پارتیشن
\& \- part\-get\-bootable \- دریافت فلگ بوت‌پذیر بودن یک پارتیشن
\& \- part\-get\-mbr\-id \- دریافت بایت نوع MBR یک پارتیشن
\& \- part\-set\-mbr\-id \- تنظیم بایت نوع MBR یک پارتیشن
\& \- pvresize\-size \- تغییر اندازه یک حجم فیزیکی (با اندازه معین)
\& \- pwrite \- نوشتن در بخشی از یک فایل
\& \- resize2fs\-size \- تغییر اندازه یک سیستم فایل ext2/3/4 (با اندازه معین)
\& \- txz\-in \- باز کردن بسته فشرده tarball به پوشه (RHBZ#580556)
\& \- txz\-out \- بسته‌بندی پوشه در یک tarball فشرده (RHBZ#580556)
\& \- vfs\-label \- دریافت برچسب سیستم فایل
\& \- vfs\-uuid \- دریافت UUID سیستم فایل
\& \- vgscan \- پویش مجدد برای حجم‌های فیزیکی، گروه‌های حجم و حجم‌های منطقی LVM
\& \- write \- ایجاد یک فایل جدید
\& \- zero\-device \- نوشتن صفر در تمام یک دستگاه
.Ve
.SS "سازوکارهای داخلی (Internals)"
.IX Subsection "Internals"
.Vb 9
\& \- گسترش مولد کد برای پشتیبانی از آزمودن ویژگی‌های اختیاری.
\& \- بررسی‌های سخت‌گیرانه‌تر روی پارامترهای ورودی بسیاری از فراخوانی‌ها (RHBZ#501893 RHBZ#501894)
\& \- گسترش پروتکل برای پشتیبانی از ارسال بافرهای داده دلخواه ۸ بیتی.
\& \- انتشار فایل \*(AqBUGS\*(Aq همراه با نسخه‌های جدید که خلاصه‌ای از اشکالات موجود در
\&   پایگاه داده Bugzilla رد هت است.
\& \- انتشار فایل \*(AqRELEASE\-NOTES\*(Aq همراه با نسخه‌ها، شامل یادداشت‌های انتشار.
\& \- یکپارچه‌سازی فرایند ساخت اپلاینس supermin در یک مکان واحد، درون febootstrap 2.7.
\& \- اصلاح کد پروتکل برای مدیریت حالتی که هر دو طرف هم‌زمان پیام لغو ارسال می‌کنند.
.Ve
.SS "باگ‌های رفع‌شده (Bugs fixed)"
.IX Subsection "Bugs fixed"
.Vb 10
\& \- 612178 ابزار guestfish: استفاده از گزینه \-m همزمان با گزینه \-\-listen باعث متوقف شدن اپلاینس می‌شود
\& \- 610880 ابزار libguestfs باید دسترسی‌های خواندن وسیع‌تری روی tmpdir تنظیم کند، تا در برخی شرایط هنگام اجرا با umask 077 کار کند
\& \- 604691 اتصالات OCaml در برابر رشته‌ها ایمن (thread safe) نیستند
\& \- 603870 به‌روزرسانی‌های ترجمه اسپانیایی
\& \- 602592 [RFE] فراهم کردن تابع guestfs_close در اتصالات perl
\& \- 600977 ابزار virt\-df \-h \-\-csv با خطای "Argument .. isn\*(Aqt numeric in printf"
\& \- 599464 دستور mkfs\-b از vfat/ntfs پشتیبانی نمی‌کند
\& \- 598807 کار نکردن add_cdrom در RHEL 6
\& \- 598309 شکست part\-list و چندین دستور دیگر روی libguestfs در RHEL5
\& \- 597145 دستور \*(Aqhelp\*(Aq در guestfish باید با وضعیت خروج خطا برای دستورات ناشناخته همراه باشد
\& \- 597135 دستور write\-file در guestfish پارامتر "size" را بررسی نمی‌کند
\& \- 597118 باید هشداری در راهنمای mke2journal\-L برای طول برچسب داده شود
\& \- 597112 دستور get\-e2uuid باید به جای "tune2fs \-l" از blkid برای دریافت UUID فایل‌سیستم استفاده کند
\& \- 596776 عدم شناسایی نام‌های مستعار modprobe توسط virt\-inspector در سیستم‌های مهمان RHEL 3
\& \- 596763 به‌روزرسانی‌های ترجمه اسپانیایی
\& \- 593292 به‌روزرسانی‌های ترجمه اسپانیایی
\& \- 592883 عدم امکان ویرایش فایل‌ها روی ایمیج‌های مانت‌شده با دستور guestmount
\& \- 592360 به‌روزرسانی‌های ترجمه اسپانیایی
\& \- 591250 چاپ خطای "tar_in: tar subcommand failed on directory" توسط virt\-tar اگر آرشیو فشرده باشد یا فرمت درستی نداشته باشد
\& \- 591155 چاپ خطای "tar_in: tar subcommand failed on directory" توسط virt\-tar اگر یک ایمیج دیسک قابل نوشتن نباشد
\& \- 591142 ابزار virt\-inspector باید برای ایمیج‌های دیسک ناشناخته خطا صادر کند
\& \- 590167 ابزار virt\-inspector و سایر ابزارهای virt باید بتوانند ماشین‌های مجازی filesystem\-on\-image را مدیریت کنند
\& \- 589039 دستور read\-file در guestfish هنگام خواندن فایل‌های بزرگ باعث قفل شدن دیمن می‌شود
\& \- 588851 تابع ()guestfs_launch مقدار \-1 برمی‌گرداند اما NULL == ()guestfs_last_error است
\& \- 588763 ابزار libguestfs باید از آدرس‌های غیرعمومی یا پیوند محلی برای شبکه اپلاینس استفاده کند
\& \- 588733 به‌روزرسانی‌های ترجمه اسپانیایی
\& \- 588651 دستور \*(Aqstrings\-e\*(Aq در guestfish پیام خطا یا راهنمایی مناسبی ارائه نمی‌دهد
\& \- 587484 دستور lvresize نمی‌تواند اندازه یک حجم را کاهش دهد
\& \- 585961 به‌روزرسانی‌های ترجمه اسپانیایی
\& \- 585223 ابزار ntfsresize باید از کوچک کردن فایل‌های سیستم پشتیبانی کند
\& \- 585222 ابزار pvresize باید از کوچک کردن PVها پشتیبانی کند
\& \- 585221 ابزار resize2fs باید از کوچک کردن سیستم‌های فایل پشتیبانی کند
\& \- 584038 به‌روزرسانی‌های ترجمه اسپانیایی
\& \- 583554 [FEAT] دستور mknod\-mode برای تنظیم صریح حالت مورد نیاز است
\& \- 583242 [RFE] دستور guestfish باید خروجی‌ها را در مبنای مناسبی چاپ کند (مانند هشت برای مودها)
\& \- 582993 ابزار guestfish هنگام تکمیل کلید Tab برای مسیرهای حساس به حروف بزرگ و کوچک کلمات را پاک می‌کند
\& \- 582953 اطلاعات راهنمای گمراه‌کننده درباره دستور lvcreate
\& \- 582948 دستور mknod دستگاه‌های بلوکی، کاراکتری یا FIFO ایجاد نمی‌کند
\& \- 582929 دستور mknod مقادیر نامعتبر mode را بررسی نمی‌کند
\& \- 582901 دستورات chmod/umask در guestfish مقدار نامعتبر mode را بررسی نمی‌کنند
\& \- 582899 دستور guestfish:sparse از فهرست تکمیل خودکار دستورات جا افتاده است
\& \- 582891 [درخواست ویژگی] رفتار و مقدار بازگشتی دستور umask در guestfish باید تغییر کند
\& \- 582548 در [mknod] هنگامی که حالت به طور صریح تنظیم شده است umask نباید اعمال شود
\& \- 582484 برخی از زیردستورات guestfish نمی‌توانند فایل‌های ویژه را به درستی مدیریت کنند
\& \- 582252 به‌روزرسانی‌های ترجمه اسپانیایی
\& \- 581501 به‌روزرسانی‌های ترجمه اسپانیایی
\& \- 580650 هشدار virt\-inspector: "No grub default specified at /usr/lib/perl5/Sys/Guestfs/Lib.pm at [...]"
\& \- 580556 درخواست از libguestfs برای پشتیبانی از بسته‌های آرشیو .txz
\& \- 580246 قفل شدن دستور tar\-in در صورت آپلود حجمی بیش از فضای موجود
\& \- 580016 دستور aug\-ls در guestfish متغیر augeas را به عنوان آرگومان نمی‌پذیرد
\& \- 579664 ابزار guestfish در صورت عدم وجود فضای کافی برای تخصیص ایمیج خطایی گزارش نمی‌کند
\& \- 579608 دستورات متعدد در guestfish برای پیوندهای نمادین کار نمی‌کنند
\& \- 579155 قفل شدن libguestfs در صورتی که qemu راه‌اندازی نشود (در حالت null vmchannel)
\& \- 578407 پیشوند \*(Aq\-\*(Aq در زیردستور توسط guestfish در حالت کنترل از راه دور مدیریت نمی‌شود
\& \- 576879 قطع هماهنگی پروتکل libguestfs در صورت استفاده از \*(Aqupload\*(Aq قبل از مانت کردن دیسک‌ها
\& \- 559963 برنامه‌های Perl مربوط به libguestfs زبان محلی را تنظیم می‌کنند اما همچنان بومی‌سازی کار نمی‌کند
\& \- 521674 ماژول‌های Perl بدون نسخه هستند اما باید شماره نسخه داشته باشند
\& \- 516096 شرایط رقابتی (race condition) در test_swapon_label_0: /sbin/blockdev: BLKRRPART: Device or resource busy
\& \- 507810 ابزار guestfish \-i / virt\-inspector نمی‌تواند فاصله‌های خالی را در نام فایل‌ها مدیریت کند
\& \- 502533 به‌روزرسانی ترجمه لهستانی libguestfs
\& \- 501894 برخی پارامترهای رشته‌ای باید از نوع OptString باشند
\& \- 501893 پارامترهای رشته‌ای باید برای != NULL بررسی شوند
\& \- 501889 دستور write\-file از رشته‌های حاوی ASCII NUL پشتیبانی نمی‌کند
\& \- 484986 شکست grub\-install روی دیسک virtio
.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 آن در گزارش اشکال.