.\" -*- 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.22 1"
.TH guestfs-release-notes-1.22 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.22 (RELEASE NOTES FOR LIBGUESTFS 1.22)"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.22"
این یادداشت‌های انتشار تنها تفاوت‌ها را نسبت به تفکیک شاخه پایدار/توسعه پیشین
(1.20.0) پوشش می‌دهند. برای مشاهده گزارش تفصیلی تغییرات، لطفاً مخزن git یا فایل
ChangeLog توزیع‌شده در tarball را بررسی کنید.
.SS "قابلیت‌های جدید (New features)"
.IX Subsection "New features"
\fIرابط برنامه‌نویسی (API)\fR
.IX Subsection "API"
.PP
دسترسی از راه دور به دیسک‌ها:
.IP \(bu 4
دستگاه بلوکی شبکه Network Block Device (nbd)
.IP \(bu 4
پوسته امن Secure Shell (ssh)
.IP \(bu 4
HTTP و HTTPS
.IP \(bu 4
FTP و FTPS
.IP \(bu 4
iSCSI
.IP \(bu 4
Gluster
.IP \(bu 4
Ceph/rbd
(Mike Kelly)
.IP \(bu 4
Sheepdog
.IP \(bu 4
TFTP
.PP
اکنون می‌توان با استفاده از API، بوت‌لودرهای SYSLINUX و EXTLINUX را روی
تصویرهای دیسک نصب کرد.
.PP
بخش بازرسی (Inspection) اکنون می‌تواند با فایل‌سیستم‌هایی مانند btrfs که زیرحجم‌های
(subvolumes) آن‌ها به‌طور جداگانه قابل سوار کردن هستند کار کند (Matthew Booth).
.PP
«روش‌های اتصال» (Attach methods) اکنون با عنوان «backends» شناخته می‌شوند. سازگاری
با کدهای موجود حفظ شده است.
.PP
نام‌های فایل تا زمانی که نسخه جدیدتری از QEMU استفاده شود، می‌توانند شامل \*(Aq:\*(Aq باشند.
.PP
\fIابزارها (Tools)\fR
.IX Subsection "Tools"
.PP
دستورهای virt\-alignment\-scan و virt\-df چندین ماشین مهمان را به‌طور موازی پویش می‌کنند.
.PP
دستور guestmount اکنون در تقریباً تمامی موارد errno را به‌طور دقیق به فضای کاربری بازمی‌گرداند.
.PP
دستور guestfish و ابزارهای دیگر اکنون می‌توانند از ساختاری شبیه به URI برای دسترسی
به دیسک‌های راه دور استفاده کنند، مانند:
.PP
.Vb 1
\& guestfish \-a ssh://example.com/path/to/disk.img
.Ve
.PP
دستورهای guestfish و guestmount اکنون امکان مشخص کردن نوع فایل‌سیستم را هنگام
سوار کردن (mount) فراهم می‌کنند که امنیت بیشتری دارد (Dave Vasilevsky).
.PP
دستور guestfish اکنون «پوسته فایل‌سیستم مهمان» (guest filesystem shell) است.
.PP
دستور guestfish برای مقادیر بولی فقط \f(CW1\fR \f(CW\*(C`true\*(C'\fR \f(CW\*(C`t\*(C'\fR \f(CW\*(C`yes\*(C'\fR \f(CW\*(C`y\*(C'\fR \f(CW\*(C`on\*(C'\fR \f(CW0\fR
\&\f(CW\*(C`false\*(C'\fR \f(CW\*(C`f\*(C'\fR \f(CW\*(C`no\*(C'\fR \f(CW\*(C`n\*(C'\fR \f(CW\*(C`off\*(C'\fR را می‌پذیرد (بدون حساسیت به بزرگی و کوچکی حروف)،
و برای تمامی رشته‌های دیگر خطا می‌دهد.
.PP
ابزار جدید \f(CW\*(C`guestunmount\*(C'\fR برای پیاده کردن (unmount) ایمن فایل‌سیستم‌های FUSE.
.PP
پرچم \&\f(CW\*(C`guestmount \-\-no\-fork\*(C'\fR مانع از دیمن شدن guestmount در پس‌زمینه می‌شود.
.PP
دستور virt\-resize اکنون به‌طور پیش‌فرض از رونوشت‌های کم‌پشت (sparse copies) استفاده می‌کند
که فضای قابل توجهی را برای ماشین‌های مهمانی که بخش عمده آن‌ها خالی است صرفه‌جویی می‌کند.
.PP
تکمیل با کلید Tab در Bash از نو بازنویسی شده است و اکنون از بیشتر ابزارها پشتیبانی می‌کند
و گزینه‌های \f(CW\*(C`\-\-long\*(C'\fR را به‌درستی با Tab کامل می‌نماید. علاوه بر این،
اسکریپت‌های تکمیل خودکار bash برحسب تقاضا بارگیری می‌شوند.
.PP
\fIپیوندهای زبانی (Language bindings)\fR
.IX Subsection "Language bindings"
.PP
رابط Java API اکنون از رویدادها پشتیبانی می‌کند.
.PP
شیء Python اکنون از کلاس پایه \f(CW\*(C`object\*(C'\fR ارث‌بری می‌کند.
.PP
متدهای Python که پیش از این فهرستی از چندتایی‌ها (tuples) را برمی‌گرداندند، اکنون می‌توانند
به گونه‌ای تنظیم شوند که یک dict پایتون برگردانند. برای حفظ سازگاری عقروعلی،
باید این قابلیت را با استفاده از گزینه سازنده
\&\f(CW\*(C`guestfs.GuestFS\ (python_return_dict=True)\*(C'\fR فعال کنید.
.PP
پیوندهای PHP اکنون به‌درستی آزمایش شده‌اند و اصلاحات متعددی دریافت کرده‌اند.
.PP
کتابخانه دیرزمانی منسوخ‌شده Perl با نام \f(CW\*(C`Sys::Guestfs::Lib\*(C'\fR حذف شده است.
https://www.redhat.com/archives/libguestfs/2013\-April/msg00001.html
.PP
\fIمثال‌ها (Examples)\fR
.IX Subsection "Examples"
.PP
برنامه نمونه جدیدی که نحوه فعال‌سازی اشکال‌زدایی و دریافت پیام‌های گزارش (log)
را نشان می‌دهد.
.PP
\fIسایر (Other)\fR
.IX Subsection "Other"
.PP
توزیع‌کنندگان می‌توانند با دستور زیر بسته‌های اضافی دلخواه را به appliance اضافه کنند:
.PP
.Vb 1
\& ./configure \-\-with\-extra\-packages="list of package names"
.Ve
.PP
توزیع‌کنندگان می‌توانند استفاده کنند از:
.PP.Vb 1
\& ./configure \-\-with\-supermin\-extra\-options="..."
.Ve
.PP
برای افزودن گزینه‌های دلخواه اضافی به supermin.
.SS "امنیت (Security)"
.IX Subsection "Security"
هیچ مشکل امنیتی در این نسخه یافت نشد.
.SS "APIهای جدید (New APIs)"
.IX Subsection "New APIs"
.Vb 10
\& cp\-r
\& extlinux
\& feature\-available
\& get\-program
\& is\-whole\-device
\& part\-get\-gpt\-type
\& part\-set\-gpt\-type
\& rename
\& set\-program
\& syslinux
.Ve
.PP
فقط در C:
.PP
.Vb 1
\& guestfs_event_to_string
.Ve
.SS "مسائل داخلی (Internals)"
.IX Subsection "Internals"
ابزار febootstrap اکنون به «supermin» تغییر نام داده است. Libguestfs می‌تواند از هر دو استفاده کند، اما اکنون «supermin» را ترجیح می‌دهد.
http://people.redhat.com/~rjones/supermin
.PP
برای ساخت libguestfs به libxml2 نیاز است.
.PP
برنامه hivexregedit (از hivex) برای ساخت از طریق git مورد نیاز است.
.PP
توابع داخلی دیگر قابل استفاده نیستند مگر اینکه فراخواننده \f(CW\*(C`\-DGUESTFS_PRIVATE=1\*(C'\fR را تعریف کند.
.PP
فعال‌سازی هشدارهای کامپایلر C در بایندینگ‌های Python و Ruby.
.PP
اگر libvirt از qemu/KVM پشتیبانی نکند (برای مثال اگر اتصال پیش‌فرض libvirt به Xen باشد)، اجرای برنامه فوراً و به روشنی با خطا متوقف می‌شود.
.PP
قاعده \f(CW\*(C`make print\-subdirs\*(C'\fR، برای اجرای گزینشی آزمون‌ها مفید است.
.PP
اصلاحات متعددی برای مجاز دانستن ساخت‌های تفکیک‌شده (sourcedir != builddir) اعمال شد.
.PP
اصلاحات متعددی در بایندینگ‌های Haskell.
.PP
اکنون APIهای \f(CW\*(C`ln\*(C'\fR و \f(CW\*(C`ln\-f\*(C'\fR مقدار \f(CW\*(C`errno\*(C'\fR را به درستی ثبت می‌کنند.
.PP
آزمون‌های بایندینگ زبان‌ها (عمدتاً) از یک طرح شماره‌گذاری استاندارد استفاده می‌کنند و هدف آن‌ها آزمایش همان محدوده از قابلیت‌ها در هر زبان است. همچنین تعداد دفعات راه‌اندازی مورد نیاز کاهش یافته است تا این آزمون‌ها بسیار سریع‌تر اجرا شوند.
.PP
کد کتابخانه در ساختار داخلی از \f(CW\*(C`_\|_attribute_\|_((cleanup))\*(C'\fR در GCC (در صورت در دسترس بودن) برای ساده‌سازی تخصیص حافظه استفاده می‌کند.
.PP
فایل‌های هدر داخلی بازسازمان‌دهی شده‌اند. توضیحات درون \&\fIsrc/guestfs\-internal*.h\fR را ببینید.
.PP
کد داخلی به اشتراک گذاشته‌شده بین کتابخانه و برخی ابزارها اکنون در یک کتابخانه ایستا به نام \f(CW\*(C`libutils\*(C'\fR قرار دارد.
.PP
تقریباً تمام زیرپوشه‌ها اکنون می‌توانند از ساخت موازی استفاده کنند، اگرچه توجه داشته باشید که دایرکتوری‌های سطح بالا همچنان به صورت متوالی ساخته می‌شوند.
.PP
استفاده از \f(CW\*(C`PATH_MAX\*(C'\fR و \f(CW\*(C`NAME_MAX\*(C'\fR از کد حذف شده است.
.PP
اکنون API جاوا به JVM ≥ 1.6 نیاز دارد.
.PP
اجبار به استفاده از \f(CW\*(C`serial\-tests\*(C'\fR با automake ≥ 1.12.
.PP
استفاده از سوکت‌ها در لایه پروتکل کتابخانه انتزاعی شده است، که اجازه می‌دهد سایر لایه‌های غیر POSIX در آینده اضافه شوند (به \&\fIsrc/conn\-socket.c\fR مراجعه کنید).
.PP
در صورت موجود بودن، از \f(CW\*(C`qemu\-img info \-\-output json\*(C'\fR برای تجزیه امن‌تر خروجی این دستور استفاده می‌شود.
.PP
توزیع‌ها اکنون می‌توانند از \f(CW\*(C`make INSTALLDIRS=vendor install\*(C'\fR برای قرار دادن بایندینگ‌های Ruby در vendordir استفاده کنند. این امر پچ غیربالادستی (non-upstream) مشترک بین Fedora و Debian را حذف می‌کند.
.PP
فایل‌های لاگ Valgrind اکنون در \fItmp/valgrind\-DATE\-PID.log\fR نوشته می‌شوند.
.PP
دستور \f(CW\*(C`make clean\*(C'\fR دایرکتوری محلی \f(CW\*(C`tmp/\*(C'\fR را پاک می‌کند.
.PP
آزمون‌های C API با استفاده از یک زبان تولیدکننده انعطاف‌پذیرتر بازنویسی شده‌اند که امکان اجرای کد C دلخواه را در طول آزمون‌ها فراهم می‌کند..SS "باگ‌های برطرف‌شده (Bugs fixed)"
.IX Subsection "Bugs fixed"
.IP https://bugzilla.redhat.com/961812 4
.IX Item "https://bugzilla.redhat.com/961812"
خطای Segfault در inspect\-fs.c در کد mountable
.IP https://bugzilla.redhat.com/957772 4
.IX Item "https://bugzilla.redhat.com/957772"
خطای نقل‌قول در tar\-out و base64\-out
.IP https://bugzilla.redhat.com/957380 4
.IX Item "https://bugzilla.redhat.com/957380"
خطای libguestfs: error: btrfsvol:/dev/sda2/root: root device not found: only call this function with a root device previously returned by guestfs_inspect_os
.IP https://bugzilla.redhat.com/948324 4
.IX Item "https://bugzilla.redhat.com/948324"
شکست فرایند بازرسی (inspection) در صورت نصب نبودن libosinfo
.IP https://bugzilla.redhat.com/928995 4
.IX Item "https://bugzilla.redhat.com/928995"
اجرای دستور file روی فایل با اندازه صفر اکنون به جای "empty" رشته "empty " را تولید می‌کند
.IP https://bugzilla.redhat.com/921292 4
.IX Item "https://bugzilla.redhat.com/921292"
خطای qemu: could not open disk image /tmp/.../snapshot1: Permission denied
.IP https://bugzilla.redhat.com/921040 4
.IX Item "https://bugzilla.redhat.com/921040"
پیام "error: external command failed, see earlier error messages" باید تغییر کند
.IP https://bugzilla.redhat.com/920225 4
.IX Item "https://bugzilla.redhat.com/920225"
ابزار libguestfs باید از \-\-output json (در صورت پشتیبانی) برای تجزیه امن خروجی دستور qemu\-img استفاده کند
.IP https://bugzilla.redhat.com/916780 4
.IX Item "https://bugzilla.redhat.com/916780"
درخواست ویژگی: guestmount \-\-with\-cleanup\-pipefd
.IP https://bugzilla.redhat.com/914934 4
.IX Item "https://bugzilla.redhat.com/914934"
کشته شدن guestfsd توسط oom\-killer هنگام tar\-in حجم زیادی از داده‌ها
.IP https://bugzilla.redhat.com/914931 4
.IX Item "https://bugzilla.redhat.com/914931"
دستورهای FileIn در صورتی که appliance در حین کپی فایل متوقف شود، باعث segfault می‌شوند
.IP https://bugzilla.redhat.com/913145 4
.IX Item "https://bugzilla.redhat.com/913145"
نشتی‌های حافظه متفرقه در virNetClientProgramCall در libvirt 1.0.2
.IP https://bugzilla.redhat.com/912499 4
.IX Item "https://bugzilla.redhat.com/912499"
بافت امنیتی (security context) روی فایل تصویر بازنشانی می‌شود
.IP https://bugzilla.redhat.com/909836 4
.IX Item "https://bugzilla.redhat.com/909836"
ابزار libguestfs\-test\-tool با گزینه \-\-qemu دچار segfault می‌شود
.IP https://bugzilla.redhat.com/909624 4
.IX Item "https://bugzilla.redhat.com/909624"
بازگشت غیردنباله‌ای غیرمنتظره در recv_from_daemon منجر به سرریز پشته (stack overflow) در فراخوانی‌های بسیار طولانی API که پیام‌های پیشرفت ارسال می‌کنند می‌شود
.IP https://bugzilla.redhat.com/908322 4
.IX Item "https://bugzilla.redhat.com/908322"
شکست virt\-tar روی نام‌های دایرکتوری ناموجود: "error in chunked encoding at /home/rjones/d/libguestfs/tools/virt\-tar line 272."
.IP https://bugzilla.redhat.com/908321 4
.IX Item "https://bugzilla.redhat.com/908321"
شکست virt\-cat روی نام‌های دایرکتوری: "/dev/stdout: error in chunked encoding"
.IP https://bugzilla.redhat.com/907554 4
.IX Item "https://bugzilla.redhat.com/907554"
استفاده از btrfs باعث از کار افتادن متعاقب سیستم‌فایل ntfs\-3g می‌شود
.IP https://bugzilla.redhat.com/905341 4
.IX Item "https://bugzilla.redhat.com/905341"
خطای "No such file or directory" هنگام اجرای "hivex\-commit"
.IP https://bugzilla.redhat.com/903620 4
.IX Item "https://bugzilla.redhat.com/903620"
از کار افتادن btrfs_subvolume_list به دلیل تغییر در خروجی فهرست زیرحجم‌ها
.IP https://bugzilla.redhat.com/895910 4
.IX Item "https://bugzilla.redhat.com/895910"
دستور guestmount: فراخوانی \fBrename()\fR به اشتباه پیوندهای نمادین را دنبال می‌کند
.IP https://bugzilla.redhat.com/895905 4
.IX Item "https://bugzilla.redhat.com/895905"
دستور guestmount: فراخوانی \fBlink()\fR به نادرستی ENOENT را بازمی‌گرداند در حالی که باید EXDEV باشد
.IP https://bugzilla.redhat.com/895904 4
.IX Item "https://bugzilla.redhat.com/895904"
دستور checksums\-out در محاسبه چکسام‌های تمام فایل‌های عادی موجود در دایرکتوری با شکست مواجه می‌شود
.IP https://bugzilla.redhat.com/894545 4
.IX Item "https://bugzilla.redhat.com/894545"
شکست در ساخت از مبدأ (FTBFS) برای libguestfs روی Fedora 19 به دلیل نسخه جدید ruby
.IP https://bugzilla.redhat.com/890027 4
.IX Item "https://bugzilla.redhat.com/890027"
دستور virt\-sysprep: تنظیم صحیح hostname، domain name و pretty name روی Fedora 18
.IP https://bugzilla.redhat.com/887971 4
.IX Item "https://bugzilla.redhat.com/887971"
شکست pvcreate در صورتی که پارتیشن حاوی امضای swap باشد
.IP https://bugzilla.redhat.com/887520 4
.IX Item "https://bugzilla.redhat.com/887520"
خطای zero_free_space: open: /sysroot//ujqqq135.rd3: Cannot allocate memory
.IP https://bugzilla.redhat.com/886915 4
.IX Item "https://bugzilla.redhat.com/886915"
ابزار libguestfs با attach\-method مربوط به libvirt در صورت پیش‌فرض بودن هایپروایزر Xen با خطای غیرمعمولی مواجه می‌شود
.IP https://bugzilla.redhat.com/847549 4
.IX Item "https://bugzilla.redhat.com/847549"
افزودن دیسک virtio\-scsi با طول صفر باعث بروز این خطا می‌شود: qemu\-kvm: hw/scsi\-bus.c:1568: scsi_req_complete: Assertion \`req\->status == \-1\*(Aq failed.
.IP https://bugzilla.redhat.com/811649 4
.IX Item "https://bugzilla.redhat.com/811649"
ناتوانی libguestfs در باز کردن تصاویر دیسکی که پیوند نمادین به فایل‌های حاوی نویسه \*(Aq:\*(Aq (دونقطه) هستند
.IP https://bugzilla.redhat.com/664558 4
.IX Item "https://bugzilla.redhat.com/664558"
درخواست بهبود (RFE): امکان تنظیم callback لاگ در بایندینگ‌های Ruby.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) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، بازتوزیع کرده و/یا تغییر دهید؛ چه نسخهٔ ۲ مجوز و چه (به انتخاب خودتان) هر نسخهٔ بالاتری.
.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 در گزارش باگ.