.\" -*- 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.50 1" .TH guestfs-release-notes-1.50 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.50 (RELEASE NOTES FOR LIBGUESTFS 1.50)" .IX Header "RELEASE NOTES FOR LIBGUESTFS 1.50" این سند حاوی یادداشت‌های انتشار نسخه پایدار libguestfs 1.50 است\&. در اینجا تغییرات عمده نسبت به نسخه 1.48 شرح داده شده است\&. .PP بسته Libguestfs 1.50.0 در تاریخ \fB۷ فوریه ۲۰۲۳\fR منتشر شد\&. .SS "پیوست‌های زبان‌های برنامه‌نویسی (Language bindings)" .IX Subsection "Language bindings" اصلاح پیوست‌های PHP برای PHP8 (Geoff Amey)\&. .PP رفع هشدارهای گوناگون مربوط به منسوخ‌شدگی (deprecation) در پیوست‌های GObject\&. .PP دیگر از کتابخانه منسوخ‌شده distutils در پایتون استفاده نمی‌شود (با تشکر از Miro Hrončok)\&. .SS "بازرسی سیستم (Inspection)" .IX Subsection "Inspection" هنگام فهرست‌کردن بسته‌ها در مهمان‌های مبتنی بر RPM، رابط برنامه‌نویسی (API) بازرسی دیگر امضاهای بسته‌ها را بررسی نمی‌کند\&. دلیل این امر آن است که librpm جدیدتر استفاده‌شده توسط libguestfs امضاهای ذخیره‌شده در مهمان‌های قدیمی‌تر، مانند SHA1 در RHEL 6 را متوجه نمی‌شود (با تشکر از Panu Matilainen)\&. .PP تابع "guestfs_inspect_get_hostname" در \fBguestfs\fR\|(3) اکنون می‌تواند فایل‌های \&\fI/etc/hostname\fR حاوی کامنت را مدیریت و پردازش کند (با تشکر از Dawid Zamirski)\&. .PP تابع "guestfs_file_architecture" در \fBguestfs\fR\|(3) اکنون قادر است فایل‌های فشرده‌شده با الگوریتم zstd را تحلیل کند\&. .PP تابع "guestfs_inspect_get_osinfo" در \fBguestfs\fR\|(3) اکنون فیلد osinfo صحیحی را برای Windows 11 برمی‌گرداند\&. با این حال به دلیل تصمیمات شرکت مایکروسافت، این مهمان‌ها همچنان نام محصول و رشته‌های دیگری را برمی‌گردانند که آن‌ها را به عنوان Windows 10 شناسایی می‌کند (با تشکر از Yaakov Selkowitz, Yongkui Guo)\&. .SS "رابط برنامه‌نویسی (API)" .IX Subsection "API" \fIرابط‌های برنامه‌نویسی جدید (New APIs)\fR .IX Subsection "New APIs" .PP تابع "guestfs_device_name" در \fBguestfs\fR\|(3) یک API جدید برای خواندن نام دستگاه مرتبط با یک درایو است، برای نمونه فراخوانی آن با \f(CW0\fR مقدار \f(CW\*(C`/dev/sda\*(C'\fR را برمی‌گرداند\&. .PP تابع "guestfs_clevis_luks_unlock" در \fBguestfs\fR\|(3) یک API جدید برای باز کردن قفل دیسک‌ها با استفاده از طرح رمزنگاری کامل دیسک مبتنی بر شبکه Clevis/Tang است\&. افزون بر این، پشتیبانی از آن در guestfish و guestmount نیز پیاده‌سازی شده است (Laszlo Ersek)\&. .PP تابع "guestfs_inspect_get_build_id" در \fBguestfs\fR\|(3) یک API جدید برای خواندن شناسه بیلد (build ID) از برخی مهمان‌های لینوکس و ویندوز است\&. این شناسه در لینوکس کاربرد گسترده‌ای ندارد، اما برای ویندوز در شناسایی ویندوز ۱۱ حیاتی است\&. .PP \fIسایر تغییرات API (Other API changes)\fR .IX Subsection "Other API changes" .PP در API تابع "guestfs_add_drive" در \fBguestfs\fR\|(3)، فیلدهای \f(CW\*(C`name\*(C'\fR و \f(CW\*(C`iface\*(C'\fR استفاده نمی‌شوند\&. مقدار \f(CW\*(C`name\*(C'\fR تقریباً از سال ۲۰۱۷ استفاده نشده بود، اما مستندات به تازگی برای انعکاس این موضوع به‌روزرسانی شده‌اند\&. فیلد \&\f(CW\*(C`iface\*(C'\fR نیز هرگز برای بک‌اند libvirt مجاز نبوده و با بک‌اند direct هم به درستی کار نمی‌کرد (Laszlo Ersek)\&. .PP تابع "guestfs_readdir" در \fBguestfs\fR\|(3) دیگر محدود به حداکثر اندازه پیام نیست و می‌تواند دایرکتوری‌ها را با هر اندازه‌ای بخواند (Laszlo Ersek)\&. .SS "تغییرات ساخت (Build changes)" .IX Subsection "Build changes" \&\fBتوجه\fR داشته باشید که پیوست‌های Augeas برای libguestfs دیگر همراه با libguestfs عرضه نمی‌شوند و باید به صورت جداگانه ساخته شوند\&. ببینید: https://people.redhat.com/~rjones/augeas برای RHEL 7+، بازسازی بسته Fedora Rawhide کارساز خواهد بود\&. .PP \&\fBتوجه\fR داشته باشید که libguestfs اکنون به حداقل OCaml 4.04 نیاز دارد\&. این بسته روی RHEL 6 کامپایل نخواهد شد\&. .PP \&\fBتوجه\fR داشته باشید که zstd اکنون یک پیش‌نیاز الزامی است\&. .PP ابزار OCaml gettext دیگر پیش‌نیاز libguestfs نیست\&. (از gettext ساده همچنان به صورت اختیاری برای ترجمه فایل‌های منبع C استفاده می‌شود\&.) .PP افزودن پشتیبانی از OCaml 4.14\&. .PP اصلاح ساخت برای توابع غایب stdlib در OCaml 4.04\&. .PP اصلاح گزینه \f(CW\*(C`./configure \-\-disable\-ocaml\*(C'\fR\&. برای ساخت libguestfs همچنان OCaml الزامی است، اما اکنون این گزینه پیوست‌های OCaml مربوط به API را به درستی غیرفعال می‌کند\&. .PP افزودن پشتیبانی از بیلد روی توزیع‌های Artix، Rocky و Virtuozzo (Halil Tezcan KARABULUT, Neil Hanlon, Andrey Drobyshev)\&. علاوه بر این، در هنگام تشخیص توزیع محلی، ابتدا به \f(CW$ID_LIKE\fR در \fI/etc/os\-release\fR پیش از \f(CW$ID\fR نگاه می‌کنیم که در آرچ لینوکس کمک‌کننده است (با تشکر از S D Rausty)\&. .PP افزودن پشتیبانی مقدماتی برای کامپایل libguestfs در macOS\&. .PP اصلاح توضیحات وب‌سایت درباره کلون‌کردن مخزن libguestfs (Kashyap Chamarthy)\&. .PP دیگر از printf سفارشی glibc استفاده نمی‌کنیم\&. .PP دیگر از \f(CW\*(C`LD_PRELOAD=libSegFault.so\*(C'\fR در اپلاینس استفاده نمی‌کنیم\&. این ویژگی در glibc 2.35 حذف شد\&. .PP دیگر از پروب‌های dtrace / systemtap استفاده نمی‌کنیم\&. .SS "بخش‌های داخلی (Internals)" .IX Subsection "Internals" اصلاح آزمون‌های رگرسیون برای استفاده از مسیرهای صحیح (Nikolay Shirokovskiy)\&. .PP بهبودهای گوناگون در مدیریت اپلاینس qcow2 (Andrey Drobyshev)\&. .PP غیرفعال‌سازی جدول‌های صفحه‌بندی ۵ سطحی (5-level page tables) در qemu\&. این کار مانع از بروز اشکال در نسخه‌های قدیمی‌تر qemu می‌شود\&. .PP غیرفعال‌سازی devicesfile مربوط به LVM2 در اپلاینس، زیرا با حجم‌های منطقی (LV) کلون‌شده‌ای که UUID یکسانی دارند تداخل ایجاد می‌کند (Laszlo Ersek)\&. .PP عدم استفاده از \f(CW\*(C`\-cpu max\*(C'\fR در معماری RISC\-V زیرا هنوز توسط شبیه‌ساز TCG در qemu برای آن معماری پشتیبانی نمی‌شود\&. این قابلیت پس از پشتیبانی در qemu مجدداً فعال خواهد شد\&. .PP جلوگیری از یک هَنگ نادر که هنگام راه‌اندازی اپلاینس رخ می‌داد\&. مشخص شد علت این رخداد، استفاده از فراخوانی ناامن \fBsetenv\fR\|(3) میان fork و exec بوده است (با تشکر از Siddhesh Poyarekar)\&. .PP هنگام اجرای دستور file در داخل اپلاینس، اکنون seccomp غیرفعال می‌شود زیرا با پردازش فایل‌های فشرده‌شده تداخل دارد (با تشکر از David Runge, Toolybird)\&. .SS "اشکالات رفع‌شده (Bugs fixed)" .IX Subsection "Bugs fixed" .IP https://bugzilla.redhat.com/2108425 4 .IX Item "https://bugzilla.redhat.com/2108425" کامپایل libguestfs\-1.48.4 با خطای Error: static declaration of ‘caml_alloc_initialized_string’ follows non\-static declaration شکست می‌خورد .IP https://bugzilla.redhat.com/2064182 4 .IX Item "https://bugzilla.redhat.com/2064182" الزام امضاهای SHA 1 برای بازرسی بسته‌ها در مهمان‌های RHEL 6 .IP https://bugzilla.redhat.com/2033247 4 .IX Item "https://bugzilla.redhat.com/2033247" مستندسازی محدودیت دیسک‌های رمزگذاری‌شده RBD .IP https://bugzilla.redhat.com/2012658 4 .IX Item "https://bugzilla.redhat.com/2012658" ناتوانی libguestfs در تشخیص ایمیج مهمان Windows 11 .IP https://bugzilla.redhat.com/1965941 4 .IX Item "https://bugzilla.redhat.com/1965941" شکست lvm\-set\-filter در guestfish با جدیدترین بسته lvm2 .IP https://bugzilla.redhat.com/1844341 4 .IX Item "https://bugzilla.redhat.com/1844341" فهرست شدن دستگاه بلوکی تکراری هنگامی که iface بر روی \*(Aqvirtio\*(Aq تنظیم شده باشد .IP https://bugzilla.redhat.com/1809453 4 .IX Item "https://bugzilla.redhat.com/1809453" [درخواست قابلیت] افزودن پشتیبانی از دیسک‌های رمزگذاری‌شده با LUKS به وسیله Clevis و Tang .IP https://bugzilla.redhat.com/1794518 4 .IX Item "https://bugzilla.redhat.com/1794518" بازنویسی نحوه استفاده libguestfs از setfiles به گونه‌ای که روی بیت‌های تغییرناپذیر (immutable) در ext4 متوقف نشود .IP https://bugzilla.redhat.com/1674392 4 .IX Item "https://bugzilla.redhat.com/1674392" عدم دریافت خروجی از فهرست دایرکتوری در صورت وجود تعداد بسیار زیادی فایل در آن پوشه (برگرداندن مقدار NULL) .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" \&\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 "Adolfo Jayme Barrientos" 4 .IX Item "Adolfo Jayme Barrientos" .PD 0 .IP "Andrey Drobyshev" 4 .IX Item "Andrey Drobyshev" .IP "Emilio Herrera" 4 .IX Item "Emilio Herrera" .IP "Ettore Atalan" 4 .IX Item "Ettore Atalan" .IP "Geoff Amey" 4 .IX Item "Geoff Amey" .IP "Hela Basa" 4 .IX Item "Hela Basa" .IP "Jan Kuparinen" 4 .IX Item "Jan Kuparinen" .IP "Kashyap Chamarthy" 4 .IX Item "Kashyap Chamarthy" .IP "Laszlo Ersek" 4 .IX Item "Laszlo Ersek" .IP "Marcin Stanclik" 4 .IX Item "Marcin Stanclik" .IP "Michał Smyk" 4 .IX Item "Michał Smyk" .IP "Neil Hanlon" 4 .IX Item "Neil Hanlon" .IP "Nikolay Shirokovskiy" 4 .IX Item "Nikolay Shirokovskiy" .IP "Pavel Borecki" 4 .IX Item "Pavel Borecki" .IP "Piotr Drąg" 4 .IX Item "Piotr Drąg" .IP "Richard W.M. Jones" 4 .IX Item "Richard W.M. Jones" .IP "Ricky Tigg" 4 .IX Item "Ricky Tigg" .IP "Temuri Doghonadze" 4 .IX Item "Temuri Doghonadze" .IP "Yuri Chornoivan" 4 .IX Item "Yuri Chornoivan" .PD .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 آن را درون گزارش اشکال جای‌گذاری کنید\&.