.\" -*- 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.42 1"
.TH guestfs-release-notes-1.42 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.42 \- یادداشت‌های انتشار نسخه ۱.۴۲ ابزار libguestfs
.SH "یادداشت‌های انتشار LIBGUESTFS 1.42 (RELEASE NOTES FOR LIBGUESTFS 1.42)"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.42"
لطفاً توجه داشته باشید که ابزارهای virt\-v2v، virt\-p2v و ابزارهای تحلیل بوت از بسته / مخزن libguestfs به پروژه‌های مجزا منتقل شده‌اند. ببینید:
.IP \(bu 4
https://github.com/libguestfs/virt\-v2v
.IP \(bu 4
https://github.com/libguestfs/virt\-p2v
.IP \(bu 4
https://github.com/libguestfs/libguestfs\-analysis\-tools
.PP
آن پروژه‌ها اکنون در چرخه انتشار جداگانه‌ای قرار دارند. یادداشت‌های انتشار آن‌ها نیز به طور جداگانه منتشر می‌شود.
.SS "ویژگی‌های جدید (New features)"
.IX Subsection "New features"
افزودن پشتیبانی از زبان Vala (Corentin Noël).
.PP
افزودن پشتیبانی از زبان Rust
(Hiroyuki Katsura، با حمایت Google Summer of Code).
.PP
بیلدهای بازتولیدپذیر (Chris Lamb).
.PP
دیسک‌های Advanced Format (که از بخش‌های ۴ کیلوبایتی استفاده می‌کنند) اکنون می‌توانند توسط libguestfs پردازش شوند. از پارامتر اختیاری جدید \f(CW\*(C`blocksize\*(C'\fR در تابع \&\f(CW\*(C`guestfs_add_drive_opts\*(C'\fR و گزینه جدید \fI\-\-blocksize\fR که به چندین ابزار اضافه شده است استفاده کنید (Nikolay Ivanets).
.PP
سیستم‌عامل Windows CompactOS (فشرده‌سازی فایل NTFS) اکنون پشتیبانی می‌شود.
.PP
\fIویژگی‌های جدید در ابزارهای موجود (New features in existing tools)\fR
.IX Subsection "New features in existing tools"
.PP
خروجی پیشرفته ماشین‌خوان در ابزارهای مختلف virt اکنون از خروجی JSON و نوشتن لاگ‌ها در یک توصیف‌کننده فایل شماره‌گذاری‌شده (numbered file descriptor) پشتیبانی می‌کند (Pino Toscano).
.PP
ابزار virt\-filesystems اکنون اندازه کل فایل‌سیستم را دقیق‌تر گزارش می‌دهد، به عنوان مثال در مواردی که سیستم فایل تمام دستگاه حاوی خود را اشغال نمی‌کند (Pino Toscano).
.PP
\fIاتصالات زبان‌های برنامه‌نویسی (Language bindings)\fR
.IX Subsection "Language bindings"
.PP
نسخه Python ≥ 2.7 الزامی است.
.PP
اتصالات پایتون اکنون به طور گسترده‌تری آزمایش شده‌اند
(Hiroyuki Katsura).
.PP
اتصالات پایتون اکنون باید با Python ≥ 3.8 کار کنند.
.PP
اصلاحات متعدد برای جلوگیری از بروز کرش در اتصالات پایتون
(Sam Eiderman).
.PP
اتصالات OCaml با \f(CW\*(C`\-DCAML_NAME_SPACE\*(C'\fR کامپایل می‌شوند
تا اطمینان حاصل شود که هیچ نمادی بدون فضای نام -caml_ استفاده نشود
(Pino Toscano).
.PP
اتصالات OCaml اکنون باید با نسخه‌های OCaml 4.09 و 4.10 کار کنند.
.PP
زبان Erlang کتابخانه قدیمی \f(CW\*(C`erl_interface\*(C'\fR را که ما برای اتصالات Erlang استفاده می‌کردیم منسوخ کرده است. این کتابخانه در OTP 22 حذف خواهد شد، که پشتیبانی از Erlang را به طور دائمی مختل می‌کند مگر اینکه فردی برای به‌روزرسانی اتصالات Erlang در libguestfs پیش‌قدم شود.
.PP
اصلاح سازگاری با cgo جدیدتر برای اتصالات Go
(Tomáš Golembiovský).
.PP
مدیریت خطای API در Go اکنون اصولی‌تر (idiomatic) است (Csaba Henk).
.PP
به‌روزرسانی مستندات درباره نحوه مدیریت پارامترهای بولی در اتصالات Ruby
(Csaba Henk).
.PP
\fIبازرسی (Inspection)\fR
.IX Subsection "Inspection"
.PP
ابزار libguestfs اکنون می‌تواند آیکون‌های سیستم‌های مهمان Gentoo، نگارش‌های جدیدتر SUSE و OpenMandriva را استخراج کند. استخراج آیکون‌های RHEL بهبود یافته است
(Pino Toscano).
.PP
کد بازرسی شناسه‌های osinfo را برای نسخه‌های جدیدتر ویندوز و توزیع‌های غلتان لینوکس برمی‌گرداند (Pino Toscano).
.PP
توزیع OpenMandriva اکنون شناسایی می‌شود (Bernhard Rosenkränzer).
.PP
بهبودهای تشخیص در Arch Linux (Pino Toscano).
.PP
\fIمعماری‌ها و بسترهای اجرایی (Architectures and platforms)\fR
.IX Subsection "Architectures and platforms"
.PP
ابزار libguestfs اکنون می‌تواند روی OpenMandriva کامپایل شود (Bernhard Rosenkränzer).
.PP
اصلاح اوبونتو برای فعال‌سازی پشتیبانی شبکه (Ioanna Alifieraki).
.PP
\fIسایر موارد (Other)\fR
.IX Subsection "Other"
.PP
استفاده از رابط‌های برنامه‌نویسی منسوخ‌شده (deprecated) در libguestfs اکنون به طور پیش‌فرض هشدارهای منسوخ‌شدگی کامپایلر را نمایش می‌دهد، در حالی که قبلاً باید این هشدارها را فعال می‌کردید. برای خاموش کردن این هشدارها از \f(CW\*(C`\-DGUESTFS_NO_WARN_DEPRECATED=1\*(C'\fR استفاده کنید. یک ویژگی جدید این است که اکنون در صورت تمایل می‌توانید توابع منسوخ‌شده را با استفاده از \f(CW\*(C`\-DGUESTFS_NO_DEPRECATED=1\*(C'\fR به طور کامل غیرفعال کنید (Pino Toscano).
.PP
اصلاح hostname در الگوهای virt\-builder (Pino Toscano).
.PP
فایل بزرگ و یکتای یادداشت‌های انتشار اکنون به اسناد متعددی تفکیک شده که بر اساس نسخه سازمان‌دهی شده‌اند.
.PP
گزینه \f(CW\*(C`\-\-key\*(C'\fR در چندین ابزار دچار مشکل بود، به ویژه اگر تلاش می‌کردید از این گزینه برای ارسال چندین کلید استفاده کنید. این اشکال برطرف شده و یک آزمون پسرفت اضافه شده است.
.PP
استثناهای Augeas که در دیمن رخ می‌دهند (مثلاً حین بازرسی) اکنون خطاهای دقیق‌تری تولید می‌کنند (Pino Toscano).
.SS "امنیت (Security)"
.IX Subsection "Security"
هیچ مشکل امنیتی در این نسخه یافت نشد.
.SS "رابط برنامه‌نویسی (API)"
.IX Subsection "API"
\fIرابط‌های برنامه‌نویسی جدید (New APIs)\fR
.IX Subsection "New APIs"
.PP
تابع \&\f(CW\*(C`luks_uuid\*(C'\fR مقدار UUID یک دستگاه LUKS را برمی‌گرداند (Pino Toscano).
.PP
\fIسایر تغییرات API (Other API changes)\fR
.IX Subsection "Other API changes"
.PP
سازگاری با خروجی جدید دستور \f(CW\*(C`btrfs scrub\*(C'\fR. هیچ تغییر قابل مشاهده‌ای در سطح API وجود ندارد.
.PP
پارامتر اختیاری جدید \f(CW\*(C`blocksize\*(C'\fR به \f(CW\*(C`guestfs_add_drive_opts\*(C'\fR اضافه شده تا از دیسک‌های Advanced Format پشتیبانی کند (Nikolay Ivanets).
.SS "تغییرات ساخت (Build changes)"
.IX Subsection "Build changes"
حداقل نسخه مورد نیاز Augeas برابر با 1.2.0 است (Pino Toscano).
.PP
پوشه فرعی \&\f(CW\*(C`common/\*(C'\fR اکنون یک زیرماژول گیت مشترک با پروژه virt\-v2v است.
.PP
نسخه Supermin ≥ 5.1.18 مورد نیاز است.
.PP
چندین باگ در نسخه‌های 5.10.0 و 6.0 نرم‌افزار libvirt وجود داشت که بر libguestfs تأثیر می‌گذاشت. اکیداً توصیه می‌شود از libvirt 6.1 که این باگ‌ها در آن برطرف شده‌اند استفاده کنید (نسخه‌های libvirt < 5.10.0 نیز مناسب هستند).
.PP
بسیاری از ماژول‌های gnulib که استفاده نمی‌شدند یا فقط در چند جا به کار رفته بودند حذف شده‌اند (Pino Toscano).
.PP
اصلاحات متعدد برای حالت‌هایی که دایرکتوری ساخت با دایرکتوری کد منبع متفاوت است (builddir != sourcedir) (Pino Toscano).
.PP
زیرشاخه جدید \f(CW\*(C`bundled/\*(C'\fR شامل یک کتابخانه همراه است که اکنون استفاده می‌کنیم: \f(CW\*(C`ocaml\-augeas\*(C'\fR
(Pino Toscano).
.PP
اصلاح مشکلات سازگاری هنگام کامپایل با GCC 10.
.SS "سازوکارهای داخلی (Internals)"
.IX Subsection "Internals"
هنگام پیوند دادن برنامه‌های OCaml، قواعد بی‌صدا (silent rules) ابزار automake و فلگ \f(CW\*(C`V=1\*(C'\fR اکنون هر دو رعایت می‌شوند (Pino Toscano).
.PP
تابع \&\f(CW\*(C`guestfs_device_index\*(C'\fR به جای دیمن، در کد کتابخانه بازپیاده‌سازی شد. این تغییر نباید هیچ تأثیر قابل مشاهده‌ای داشته باشد.
.PP
از آنجا که هسته لینوکس 5.6 دستگاه‌های \f(CW\*(C`/dev/sdX\*(C'\fR را به صورت موازی شماره‌گذاری می‌کند، libguestfs تغییر یافت تا نام دستگاه‌های API را به نام دستگاه‌های اپلاینس نگاشت کند، و سپس هنگام بازگرداندن نام‌ها از اپلاینس، نگاشت معکوس را انجام دهد. این امر نباید اثر مشهودی داشته باشد، اما ممکن است پیام‌های اشکال‌زدایی تا حدی گیج‌کننده تولید کند، زیرا نام دستگاه‌ها در گزارش دیباگ ممکن است با نام دستگاه‌های ارسالی به APIها مطابقت نداشته باشد. علاوه بر این، گزینه \&\f(CW\*(C`root=UUID=...\*(C'\fR همواره به اپلاینس ارسال می‌شود (به جای نام بردن از دستگاه حاوی فایل‌سیستم ریشه).
.PP
انتظار داریم سرویس مدیریت رشته‌های ترجمه‌شده را از Zanata به Weblate منتقل کنیم. برای اطلاعات بیشتر ببینید:
https://bugzilla.redhat.com/1787301
.SS "باگ‌های رفع‌شده (Bugs fixed)"
.IX Subsection "Bugs fixed"
.IP https://bugzilla.redhat.com/1773520 4
.IX Item "https://bugzilla.redhat.com/1773520"
خطای نقض حافظه (Segfault) در اتصالات پایتون برای guestfs_int_py_event_callback_wrapper
.IP https://bugzilla.redhat.com/1746699 4
.IX Item "https://bugzilla.redhat.com/1746699"
عدم امکان وارد کردن مهمان از دامنه export به دامنه data در rhv4.3 به دلیل خطای "Invalid parameter: \*(AqDiskType=1\*(Aq"
.IP https://bugzilla.redhat.com/1733168 4
.IX Item "https://bugzilla.redhat.com/1733168"
ابزار virt\-v2v: استفاده از scp \-T در حالت vmx \-it ssh \-i
.IP https://bugzilla.redhat.com/1723305 4
.IX Item "https://bugzilla.redhat.com/1723305"
حذف اطلاعات "export PATH=/path/to/nbdkit\-1.1.x:$PATH" در صفحه راهنمای virt\-v2v\-input\-vmware
.IP https://bugzilla.redhat.com/1705482 4
.IX Item "https://bugzilla.redhat.com/1705482"
پایتون 3.8 نیازمند استفاده از متغیر embed- در فایل pkgconf است که باعث شکست ساخت اتصالات پایتون 3.8 در libguestfs می‌شود
.IP https://bugzilla.redhat.com/1703463 4
.IX Item "https://bugzilla.redhat.com/1703463"
عدم توانایی libguestfs در بازرسی دیسک‌های با فشرده‌سازی NTFS ویندوز ۱۰، خطای "unsupported reparse point"
.IP https://bugzilla.redhat.com/1694268 4
.IX Item "https://bugzilla.redhat.com/1694268"
[وصله] افزودن پشتیبانی از OpenMandriva
.IP https://bugzilla.redhat.com/1691659 4
.IX Item "https://bugzilla.redhat.com/1691659"
ابزار virt\-v2v باید پیامی هنگام نصب موفق qemu\-guest\-agent در مهمان در طول تبدیل نمایش دهد
.IP https://bugzilla.redhat.com/1690574 4
.IX Item "https://bugzilla.redhat.com/1690574"
شکست virt\-v2v در وارد کردن مهمان هنگام نیافتن `file_architecture` برای یک فایل
.IP https://bugzilla.redhat.com/1680361 4
.IX Item "https://bugzilla.redhat.com/1680361"
[v2v][RHV][Scale] مهاجرت v2v به RHV به دلیل اتمام مهلت زمانی در انتظار نهایی‌سازی انتقال شکست خورد
.IP https://bugzilla.redhat.com/1661871 4
.IX Item "https://bugzilla.redhat.com/1661871"
استفاده نادرست اتصالات پایتون از str برای APIهای دارای RBufferOut/FBuffer در پایتون ۳
.IP https://bugzilla.redhat.com/1626503 4
.IX Item "https://bugzilla.redhat.com/1626503"
ناتوانی در حفظ پیکربندی آدرس IP ایستا پس از مهاجرت ماشین مجازی
.IP https://bugzilla.redhat.com/1612653 4
.IX Item "https://bugzilla.redhat.com/1612653"
مهمان پس از تبدیل با rhv\-upload هیچ دیسکی ندارد اگر دامنه داده مقصد نام مشابهی با دامنه داده دیگر در rhv4.2 داشته باشد
.IP https://bugzilla.redhat.com/1605242 4
.IX Item "https://bugzilla.redhat.com/1605242"
به‌روزرسانی اطلاعات nbdkit برای vddk در صفحه راهنمای v2v
.IP https://bugzilla.redhat.com/1584678 4
.IX Item "https://bugzilla.redhat.com/1584678"
در W2K12r2 سرویس rhev\-apt به صورت غیرتعاملی اجرا نمی‌شود و هنگام شروع سرویس rhev\-apt از خط فرمان شرایط رقابتی ایجاد می‌شود
.IP https://bugzilla.redhat.com/1518539 4
.IX Item "https://bugzilla.redhat.com/1518539"
شبکه Macvtap در حین تبدیل v2v از دست خواهد رفت
.IP https://bugzilla.redhat.com/1351000 4
.IX Item "https://bugzilla.redhat.com/1351000"
دستور virt\-customize \-\-commands\-from\-file در صورت وجود فاصله خالی اضافی در فایل با شکست مواجه می‌شود
.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"
Ioanna Alifieraki
.PP
Sam Eiderman
.PP
Tomáš Golembiovský
.PP
Csaba Henk
.PP
Nikolay Ivanets
.PP
Richard W.M. Jones
.PP
Hiroyuki Katsura
.PP
Chris Lamb
.PP
Corentin Noël
.PP
Bernhard Rosenkränzer
.PP
Pino Toscano
.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 آن در گزارش اشکال.