.\" -*- 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.58 1" .TH guestfs-release-notes-1.58 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.58 (RELEASE NOTES FOR LIBGUESTFS 1.58)" .IX Header "RELEASE NOTES FOR LIBGUESTFS 1.58" این سند حاوی یادداشت‌های انتشار نسخه پایدار libguestfs 1.58 است\&. در اینجا تغییرات عمده نسبت به نسخه 1.56 شرح داده شده است\&. .PP بسته Libguestfs 1.58.0 در تاریخ \fB۵ ژانویه ۲۰۲۶\fR منتشر شد\&. .SS "بازرسی سیستم (Inspection)" .IX Subsection "Inspection" اصلاح بازرسی مهمان‌های SLES 15 دارای سیستم‌فایل رمزشده Btrfs، از طریق تجزیه صحیح \fI/etc/crypttab\fR (Cole Robinson)\&. .PP درایوهای نام‌گذاری‌شده ویندوز (مانند \f(CW\*(C`D:\*(C'\fR) که به دیسک‌های کاملاً خالی اشاره دارند، اکنون به جای ایجاد خطا نادیده گرفته می‌شوند (با تشکر از Ming Xie, Ameen Barakat)\&. .PP کدهای موجود در virt\-v2v که نرم‌افزارهای ضدویروس (AV) ویندوز را شناسایی می‌کردند اکنون بخشی از فرآیند بازرسی شده‌اند\&. کد جدید طیف گسترده‌تری از ضدویروس‌ها را شناسایی می‌کند\&. .SS "رابط برنامه‌نویسی (API)" .IX Subsection "API" تابع \&\f(CW\*(C`guestfs_selinux_relabel\*(C'\fR منسوخ شد و با تابع جدید \&\f(CW\*(C`guestfs_setfiles\*(C'\fR جایگزین گردید\&. این API جدید همچنین از گزینه \fI\-A\fR در \fBsetfiles\fR\|(8) برای کاهش مصرف حافظه استفاده می‌کند\&. .PP رابط برنامه‌نویسی جدید \f(CW\*(C`guestfs_ntfs_chmod\*(C'\fR که مجوزهای مسیرهای ویندوز را تغییر می‌دهد (Cole Robinson)\&. .PP در فهرست ساختارهای برگردانده‌شده توسط \&\f(CW\*(C`guestfs_inspect_get_applications2\*(C'\fR، یک فیلد جدید به نام \f(CW\*(C`app2_class\*(C'\fR افزوده شده است\&. این فیلد برنامه را بر اساس کاربرد اصلی آن طبقه‌بندی می‌کند، اما در حال حاضر فقط مقدار \f(CW"antivirus"\fR برای ضدویروس‌های ویندوز در اینجا برگردانده می‌شود\&. .PP رابط برنامه‌نویسی جدید \f(CW\*(C`guestfs_inspect_get_windows_group_policy\*(C'\fR که گزارش می‌دهد آیا اشیاء سیاست گروهی (GPO) در ماشین مهمان ویندوزی یافت شده‌اند یا خیر\&. .PP تابع \&\f(CW\*(C`guestfs_btrfs_subvolume_show\*(C'\fR گاهی اوقات هنگام پردازش اسنپ‌شات‌های یک زیرحجم Btrfs دچار کرش می‌شد\&. علاوه بر این، در هر API که نام دستگاه مرتبط با یک حجم Btrfs را برمی‌گرداند، ممکن بود نام دستگاه به درستی ترجمه نشود و نام اشتباهی برگردانده شود\&. (هر دو مشکل توسط Arye Yurkovsky برطرف شدند\&.) .PP رفع نشت حافظه در \f(CW\*(C`guestfs_filesystem_walk\*(C'\fR (Susant Sahani)\&. .PP در \f(CW\*(C`guestfs_disk_create\*(C'\fR، هنگام ساخت دستگاه‌های بلوکی خام (raw block devices)، خطاهای فراخوانی سیستمی \fBclose\fR\|(2) بررسی می‌شوند تا مطمئن شویم هیچ خطای I/O معوقه‌ای از قلم نیفتد (Susant Sahani)\&. .PP در چندین API مرتبط با LVM، این امکان وجود داشت که برای حجم‌های منطقی ناقص (مثلاً حجم‌هایی که یک حجم فیزیکی آن‌ها غایب است) یک شکست داخلی رخ دهد\&. این مورد با نادیده گرفتن این حجم‌های منطقی برطرف شد (Arye Yurkovsky)\&. .SS "پیوست‌های زبان‌های برنامه‌نویسی (Language bindings)" .IX Subsection "Language bindings" توجه داشته باشید که پیوست‌های GObject / Javascript در نسخه بعدی libguestfs حذف خواهند شد\&. .PP هشدارهای منسوخ‌شدگی روبی برطرف شدند (Cole Robinson)\&. .SS "مستندات (Documentation)" .IX Subsection "Documentation" اصلاح پیوندهای مربوط به مستندات ntfs\-3g (Cole Robinson)\&. .SS "تغییرات ساخت (Build changes)" .IX Subsection "Build changes" اکنون libvirt ≥ 11.10.0 با پشتیبانی passt الزامی است\&. .PP اکنون qemu ≥ 7.2.0 الزامی است\&. .PP اصلاح کامپایل guestmount در macOS (با تشکر از Mohamed Akram)\&. .PP یکپارچه‌سازی مداوم (CI) پایه‌ای در گیت‌هاب پیاده‌سازی شده است\&. اکنون در چند پلتفرم رایج، درخواست‌های پول ریکوئست معادل \f(CW\*(C`./configure \-\-enable\-werror && make && make check\*(C'\fR را اجرا می‌کنند\&. .PP چندین آزمون منسوخ حذف شدند و مجموعه آزمون‌ها به طور کلی اصلاح شده و در برابر پیش‌نیازهای مفقود و سایر مشکلات رایج مقاوم‌تر شدند (Cole Robinson)\&. .PP در خروجی آزمون‌ها، دیگر مسیرهای مطلق را برای نام آزمون‌ها چاپ نمی‌کنیم (Cole Robinson)\&. .PP استفاده از \&\f(CW\*(C`AM_GNU_GETTEXT\*(C'\fR به طور کامل حذف شد و با یک بررسی ساده برای LIBINTL جایگزین گردید (Cole Robinson)\&. .PP فایل \&\fIbuild\-aux/config.rpath\fR حذف شد زیرا دیگر عملاً استفاده نمی‌شد (Cole Robinson)\&. .PP اصلاح مشکلات const\-correctness ناشی از تغییرات توابع \fBstrchr\fR\|(3) و \&\fBstrrchr\fR\|(3) در استاندارد C23\&. .SS "بخش‌های داخلی (Internals)" .IX Subsection "Internals" اگر ماژول کرنل لینوکس \f(CW\*(C`sit.ko\*(C'\fR بارگذاری شود، یک دستگاه شبکه \f(CW\*(C`sit0\*(C'\fR (نوعی تونل IPv6) در اپلاینس ایجاد می‌شود\&. این دستگاه نادیده گرفته می‌شود زیرا شبکه اپلاینس را مختل می‌کرد (با تشکر از Srikanth Aithal, Stefano Brivio)\&. .PP در بک‌اند direct با فرض qemu ≥ 7.2.0، شناسایی قابلیت‌های qemu ساده‌تر شد\&. .PP در بک‌اند libvirt: .IP \(bu 4 اصلاح سازگاری با SeaBIOS 1.17 (با تشکر از Gerd Hoffmann)\&. .IP \(bu 4 تغییراتی در نحوه مدیریت خطاهای فراخوانی \&\f(CW\*(C`virDomainDestroyFlags\*(C'\fR در libvirt هنگام خاموش کردن اپلاینس اعمال شد\&. در صورت بروز خطا و فعال بودن حالت اشکال‌زدایی (debug)، پیام خطا چاپ می‌شود (اما همچنان غیرمهلک است)\&. همچنین به جای busy looping، بین تلاش‌های مجدد درنگ (sleep) صورت می‌گیرد\&. .IP \(bu 4 بک‌اند libvirt اکنون یک دستگاه virtio\-rng را بدون قیدوشرط به اپلاینس اضافه می‌کند تا همیشه انتروپی مناسبی (برای عملیات رمزنگاری) داشته باشیم\&. .IP \(bu 4 هنگام اجرا به عنوان کاربر ریشه (root)، برچسب‌گذاری مجدد صریح سوکت حذف شد و اجازه داده شد خود libvirt کار برچسب‌گذاری مجدد سوکت‌ها را انجام دهد (Cole Robinson)\&. .IP \(bu 4 فعال‌سازی sVirt برای اپلاینس، که گاهی به طور تصادفی غیرفعال می‌شد (Cole Robinson)\&. .PP در حین بازرسی مهمان‌های لینوکس/یونیکس، محتویات فایل‌های \&\fI/etc/fstab\fR مهمان و برخی فایل‌های mdadm در خروجی اشکال‌زدایی نوشته می‌شوند\&. این کار به اشکال‌زدایی مسائل بازرسی کمک می‌کند (با تشکر از Ming Xie)\&. .PP هنگام راه‌اندازی اپلاینس، در صورت فعال بودن اشکال‌زدایی، اطلاعات دستورات \&\fBlsblk\fR\|(8) و \fBblkid\fR\|(8) در خروجی دیباگ ثبت می‌شوند (با تشکر از Ming Xie)\&. .PP در مولد کد، ساختار \f(CWStringList(Pathname)\fR برای توابع OCaml پیاده‌سازی شد\&. .PP افزودن پیام‌های اشکال‌زدایی بیشتر در توابع بازرسی ریجستری ویندوز برای تسهیل پیگیری رخدادها\&. .PP اکنون از رشته‌های چندخطی تحت‌اللفظی \f(CW\*(C`{|...|}\*(C'\fR در OCaml برای مواردی مانند بچ‌فایل‌های واقعی ویندوز که به مهمان تزریق می‌کنیم، عبارات منظم، و مستندات POD در مولد استفاده می‌شود (با تشکر از Nicolas Ojeda Bar)\&. .PP فراخوانی‌های داخلی به \fBpcre2_match\fR\|(3) که خطای غیرمنتظره‌ای برمی‌گردانند اکنون یک پیام اشکال‌زدایی منتشر می‌کنند، اگرچه خطا همچنان نادیده گرفته می‌شود\&. .PP پاک‌سازی‌های متعدد در سراسر کد (Susant Sahani)\&. .PP اصلاح ترتیب گنجاندن هدر فایل پایتون به دلیل تغییرات در نسخه اخیر Python 3.14\&. .PP برخی از اسکریپت‌های آزمون که قبلاً به زبان Perl نوشته شده بودند به Python بازنویسی شدند (Susant Sahani)\&. .SS "اشکالات رفع‌شده (Bugs fixed)" .IX Subsection "Bugs fixed" .IP https://issues.redhat.com/browse/RHEL\-104352 4 .IX Item "https://issues.redhat.com/browse/RHEL-104352" تغییر مجوز پوشه ساخته‌شده guestfs .IP https://issues.redhat.com/browse/RHEL\-106490 4 .IX Item "https://issues.redhat.com/browse/RHEL-106490" افزودن دستورهای "lsblk"، "cat /etc/fstab" و "blkid" به لاگ دیباگ v2v .IP https://issues.redhat.com/browse/RHEL\-108803 4 .IX Item "https://issues.redhat.com/browse/RHEL-108803" شکست Parted در خواندن دیسک خالی "virt\-v2v: error: libguestfs error: inspect_os: parted: /dev/sdb: parted exited with status 1: Error: /dev/sdb: unrecognised disk label: Invalid argument" [rhel\-9.7] .IP https://issues.redhat.com/browse/RHEL\-111165 4 .IX Item "https://issues.redhat.com/browse/RHEL-111165" [فقط آزمون] شکست virt\-v2v ماشین مجازی RHEL 8.10 به دلیل فراخوانی oom\-killer توسط setfiles .IP https://issues.redhat.com/browse/RHEL\-111505 4 .IX Item "https://issues.redhat.com/browse/RHEL-111505" مصرف بالای حافظه در ابزار \*(Aqsetfiles\*(Aq / تابع \*(Aqrestorecon_sb\*(Aq .IP https://issues.redhat.com/browse/RHEL\-113397 4 .IX Item "https://issues.redhat.com/browse/RHEL-113397" [تسک توسعه]: اشتراک‌های موجود ماشین مهمان گاهی نمایش داده نمی‌شوند مگر اینکه از گزینه‌های \-\-sm\-remove و \-\-sm\-unregister برای حذف همه اشتراک‌ها از مهمان استفاده شود .IP https://issues.redhat.com/browse/RHEL\-113398 4 .IX Item "https://issues.redhat.com/browse/RHEL-113398" [تسک توسعه]: ابزار Virt\-v2v در صورت حذف پروفایل مصرف‌کننده از مهمان، نمی‌تواند از گزینه‌های \-\-sm\-remove و \-\-sm\-unregister برای حذف اشتراک‌ها از مهمان استفاده کند .IP https://issues.redhat.com/browse/RHEL\-114292 4 .IX Item "https://issues.redhat.com/browse/RHEL-114292" استفاده از گزینه setfiles \-A هنگام برچسب‌گذاری مجدد .IP https://issues.redhat.com/browse/RHEL\-121076 4 .IX Item "https://issues.redhat.com/browse/RHEL-121076" [libguestfs] [aarch64] شکست libguestfs\-test\-tool با LIBGUESTFS_BACKEND=direct .IP https://issues.redhat.com/browse/RHEL\-125846 4 .IX Item "https://issues.redhat.com/browse/RHEL-125846" تشخیص حضور ضدویروس/GPO در یک ماشین مجازی توسط virt\-inspector .IP https://issues.redhat.com/browse/RHEL\-93584 4 .IX Item "https://issues.redhat.com/browse/RHEL-93584" ناتوانی virt\-v2v در تبدیل مهمان sles15sp6 با سیستم‌فایل رمزشده btrfs .IP https://github.com/libguestfs/libguestfs/issues/180 4 .IX Item "https://github.com/libguestfs/libguestfs/issues/180" شکست در ساخت با macFUSE .IP https://github.com/libguestfs/libguestfs/issues/234 4 .IX Item "https://github.com/libguestfs/libguestfs/issues/234" شکست‌های make \-j8 check در وضعیت فعال بودن selinux enforcing .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" .IP "Arye Yurkovsky" 4 .IX Item "Arye Yurkovsky" .PD 0 .IP "Cole Robinson" 4 .IX Item "Cole Robinson" .IP "Ettore Atalan" 4 .IX Item "Ettore Atalan" .IP "Fco. Javier F. Serrador" 4 .IX Item "Fco. Javier F. Serrador" .IP "Pavel Borecki" 4 .IX Item "Pavel Borecki" .IP "Richard W.M. Jones" 4 .IX Item "Richard W.M. Jones" .IP "Susant Sahani" 4 .IX Item "Susant Sahani" .IP "Yuri Chornoivan" 4 .IX Item "Yuri Chornoivan" .PD .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" Copyright (C) 2009\-2026 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 آن را درون گزارش اشکال جای‌گذاری کنید\&.