.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Podwrapper::Man 1.56.0 (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-tools-release-notes-1.50 1" .TH guestfs-tools-release-notes-1.50 1 2026-07-11 guestfs-tools-1.56.0 "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\-tools\-release\-notes\-1.50 \- یادداشت‌های انتشار ابزارهای guestfs نسخه ۱.۵۰ .SH "یادداشت‌های انتشار ابزارهای GUESTFS ۱.۵۰ (RELEASE NOTES FOR GUESTFS TOOLS 1.50)" .IX Header "RELEASE NOTES FOR GUESTFS TOOLS 1.50" این یادداشت‌های انتشار مربوط به انتشار پایدار ۱.۵۰ مجموعه ابزارهای guestfs است. این سند تغییرات عمده اعمال‌شده از نسخه ۱.۴۸ تاکنون را شرح می‌دهد. .PP ابزارهای Guestfs نسخه ۱.۵۰.۰ در تاریخ \fB۷ فوریه ۲۰۲۳\fR منتشر شد. .SS "امنیت (Security)" .IX Subsection "Security" .IP CVE\-2022\-2211 4 .IX Item "CVE-2022-2211" https://bugzilla.redhat.com/show_bug.cgi?id=2100862 .Sp یک سرریز بافر در گزینه \fI\-\-key\fR چندین ابزار guestfs کشف شد. برای اطلاعات بیشتر در مورد این باگ با شدت کم، گزارش باگ بالا را ببینید (Laszlo Ersek). .SS "ابزار جدید virt\-drivers (New virt\-drivers tool)" .IX Subsection "New virt-drivers tool" این ابزار جدید می‌تواند یک ایمیج دیسک را بررسی کرده و موارد زیر را مشخص کند: .IP \(bu 4 آیا برای بوت شدن از BIOS استفاده می‌کند یا UEFI .IP \(bu 4 از چه بوت‌لودری استفاده می‌کند (فقط لینوکس) .IP \(bu 4 چه هسته‌هایی ممکن است در زمان بوت انتخاب شوند (فقط لینوکس) .IP \(bu 4 چه درایورهای دستگاهی (ماژول‌های کرنل) نصب شده‌اند .PP این قابلیت برای تشخیص نحوه (یا امکان) بوت شدن یک سیستم مهمان روی یک هایپروایزر مجازی‌سازی مفید است. .SS virt\-customize .IX Subsection "virt-customize" اکنون گزینه \&\fI\-\-selinux\-relabel\fR برای مهمان‌های دارای SELinux پیش‌فرض است. دیگر نیازی به تعیین این فلگ ندارید. در موارد نادری که مایل نیستید مهمان پس از سفارشی‌سازی مجدداً برچسب‌گذاری شود، می‌توانید از \&\fI\-\-no\-selinux\-relabel\fR استفاده کنید. توجه داشته باشید که این گزینه برای مهمان‌های فاقد SELinux نیاز نیست و به طور خودکار کار درست انجام خواهد شد (Laszlo Ersek). .PP عملیات‌های جدید \fI\-\-inject\-qemu\-ga\fR و \fI\-\-inject\-virtio\-win\fR اضافه شده‌اند که به ترتیب عامل مهمان QEMU و درایورهای virtio\-win را به مهمان‌های ویندوز تزریق می‌کنند. .PP اکنون از مهمان‌های راکی لینوکس (Rocky Linux) پشتیبانی می‌شود (با تشکر از Harry Benson). .SS virt\-inspector .IX Subsection "virt-inspector" ابزار Virt\-inspector اکنون در صورت استفاده از libguestfs نسخه ۱.۵۰ یا بالاتر، عنصر جدید حاوی شناسه ساخت (build ID) مهمان را در خروجی نمایش می‌دهد. .SS virt\-sysprep .IX Subsection "virt-sysprep" عملیات جدید \f(CW\*(C`lvm\-system\-devices\*(C'\fR برای حذف فایل \&\fIsystem.devices\fR مربوط به LVM2 اضافه شده است. این کار از بروز مشکلات مشخصی هنگام شبیه‌سازی یک ماشین مجازی جلوگیری می‌کند (Laszlo Ersek). .PP ابزار Virt\-sysprep اکنون از مهمان‌هایی که از حجم‌های منطقی LUKS روی LVM استفاده می‌کنند پشتیبانی می‌کند (Laszlo Ersek). .SS "تغییرات عمومی (Common changes)" .IX Subsection "Common changes" تمامی ابزارهایی که از گزینه \fI\-\-key\fR پشتیبانی می‌کنند اکنون می‌توانند از Clevis/Tang برای رمزگشایی رمزنگاری کامل دیسک با استفاده از این طرح تحت شبکه استفاده کنند (Laszlo Ersek). .SS "تغییرات ساخت و کامپایل (Build changes)" .IX Subsection "Build changes" \&\fBتوجه داشته باشید\fR که libguestfs اکنون به حداقل OCaml نسخه ۴.۰۴ نیاز دارد. این برنامه روی RHEL 6 کامپایل نخواهد شد. .PP \&\fBتوجه داشته باشید\fR که libosinfo یک وابستگی الزامی جدید است. .PP اکنون از OCaml نسخه ۴.۱۴ پشتیبانی می‌شود. .PP گزینه‌های \f(CW\*(C`./configure \-\-disable\-ocaml\*(C'\fR و \f(CW\*(C`./configure \-\-disable\-perl\*(C'\fR اکنون به ترتیب ابزارهای مبتنی بر OCaml و Perl را غیرفعال می‌کنند (با تشکر از Simon Walter). .PP پشتیبانی آزمایشی برای کامپایل روی macOS. .PP هنگام اجرای \f(CW\*(C`make check\-valgrind\*(C'\fR ، گزارش‌های Valgrind دیگر در فایل‌های جداگانه زیر \fItmp/\fR نوشته نمی‌شوند. در عوض خروجی در فایل معمولی \fItest\-name.log\fR نوشته می‌شود. .SS "باگ‌های رفع‌شده (Bugs fixed)" .IX Subsection "Bugs fixed" .IP https://bugzilla.redhat.com/2133443 4 .IX Item "https://bugzilla.redhat.com/2133443" درخواست بهبود (RFE): پشتیبانی از راکی لینوکس در virt\-customize .IP https://bugzilla.redhat.com/2106286 4 .IX Item "https://bugzilla.redhat.com/2106286" virt\-sysprep: تلاش برای پشتیبانی از LUKS روی حجم منطقی (LV) .IP https://bugzilla.redhat.com/2089748 4 .IX Item "https://bugzilla.redhat.com/2089748" حذف گزینه «\-\-selinux\-relabel» اسکریپت‌های موجود را دچار اختلال می‌کرد .IP https://bugzilla.redhat.com/2075718 4 .IX Item "https://bugzilla.redhat.com/2075718" اجبار به استفاده از «\-\-selinux\-relabel» با توجه به اینکه محصولات Red Hat به صورت پیش‌فرض SELinux را فعال دارند، بصری و شهودی نبود. .IP https://bugzilla.redhat.com/2072493 4 .IX Item "https://bugzilla.redhat.com/2072493" [RFE] درخواست افزودن عملیات پاک‌سازی lvm system.devices به virt\-sysprep .IP https://bugzilla.redhat.com/2059545 4 .IX Item "https://bugzilla.redhat.com/2059545" [RHEL 9.0][Nutanix] پارتیشن lvm بنام «home» همراه با دیسک SCSI چه در ماشین مجازی کلون‌شده جدید و چه در بازیابی از یک اسنپ‌شات از دست می‌رفت .IP https://bugzilla.redhat.com/2028764 4 .IX Item "https://bugzilla.redhat.com/2028764" نصب بسته qemu\-guest\-agent در طول فرایند تبدیل .IP https://bugzilla.redhat.com/1809453 4 .IX Item "https://bugzilla.redhat.com/1809453" [RFE] افزودن پشتیبانی از دیسک‌های رمزنگاری‌شده LUKS با Clevis و Tang .IP https://bugzilla.redhat.com/1554735 4 .IX Item "https://bugzilla.redhat.com/1554735" درخواست بهبود: در customize گزینه \-\-selinux\-relabel باید پیش‌فرض باشد و از \-\-no\-selinux\-relabel برای انصراف استفاده شود .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" http://libguestfs.org .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" .IP "Laszlo Ersek" 4 .IX Item "Laszlo Ersek" .PD 0 .IP "Richard W.M. Jones" 4 .IX Item "Richard W.M. Jones" .PD .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" Copyright (C) 2009\-2025 Red Hat Inc. .SH "مجوز (LICENSE)" .IX Header "LICENSE" این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط «بنیاد نرم‌افزارهای آزاد» (Free Software Foundation) منتشر شده است، چه نسخه ۲ مجوز یا (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده یا تغییر دهید. .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 آن را در گزارش باگ قرار دهید.