.\" -*- 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.46 1" .TH guestfs-release-notes-1.46 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.46 (RELEASE NOTES FOR LIBGUESTFS 1.46)" .IX Header "RELEASE NOTES FOR LIBGUESTFS 1.46" خبر بزرگ در این انتشار این است که ابزارهای virt مانند \&\fBvirt\-builder\fR\|(1)، \fBvirt\-cat\fR\|(1)، \fBvirt\-customize\fR\|(1)، \&\fBvirt\-df\fR\|(1) و موارد بسیار دیگر به یک پروژه جدید منتقل شده‌اند. مخزن موقت برای پروژه جدید guestfs\-tools تا زمان راه‌اندازی جایگاه دائمی آن در gitlab در اینجا قرار دارد: https://github.com/rwmjones/guestfs\-tools بایگانی‌های فشرده (tarball) حاوی این ابزارها نیز در اینجا موجودند: https://download.libguestfs.org/guestfs\-tools .PP جداسازی تمام ابزارها و انتقال آن‌ها به یک مخزن جدید، ساخت و مدیریت libguestfs را کمی ساده‌تر و آسان‌تر کرده است و به ما اجازه می‌دهد تنها بر روی ارائه API تمرکز کنیم. .PP توجه داشته باشید که ابزارهای \fBguestfish\fR\|(1) (که در واقع یک «API پوسته» است)، \&\fBguestmount\fR\|(1)، \fBlibguestfs\-test\-tool\fR\|(1) و \fBvirt\-rescue\fR\|(1) همچنان بخشی از مخزن libguestfs هستند. .PP خبر نه چندان بزرگ دیگر این است که برای ارتباطات IRC از FreeNode به Libera Chat نقل مکان کرده‌ایم. کانال جدید در Libera با نام \f(CW\*(C`#guestfs\*(C'\fR شناخته می‌شود (با تشکر از Daniel Berrangé). .SS "اتصال‌های زبانی (Language bindings)" .IX Subsection "Language bindings" اکنون libguestfs با Go 1.16 سازگار است و یک ماژول Go تعریف می‌کند (با تشکر از Gianfranco Costamagna). .PP نشت‌های حافظه در APIهای Python که ساختارها (structs) را بازمی‌گرداندند برطرف شده است (با تشکر از 朱丹). .PP مجوز کد Python PyPi از GPLv2+ به LGPLv2+ تغییر یافته است. .SS "بازرسی (Inspection)" .IX Subsection "Inspection" بازرسی (inspection) سیستم‌های مهمان RPM اکنون به جای تلاش برای تجزیه مستقیم پایگاه‌داده Berkeley DB، از librpm استفاده می‌کند. از آنجا که اکثر مهمان‌های مبتنی بر RPM پایگاه‌داده BDB را با sqlite جایگزین کرده‌اند، این تغییر به ما امکان می‌دهد مهمان‌های جدیدتر را بخوانیم و در عین حال سازگاری با مهمان‌های قدیمی‌تر را حفظ کنیم (با تشکر از Panu Matilainen). .PP بازرسی RHEL 8+ با پیکربندی مجزای /usr قابل اطمینان‌تر شده است. .PP بازرسی Windows Server 2022 اکنون باید به درستی کار کند (Yongkui Guo). .SS "رابط برنامه‌نویسی کاربردی (API)" .IX Subsection "API" \fIAPIهای جدید\fR .IX Subsection "New APIs" .PP هیچ API جدیدی در libguestfs 1.46 اضافه نشده است. .PP \fIسایر تغییرات API\fR .IX Subsection "Other API changes" .PP خروجی API \f(CW\*(C`guestfs_cap_get_file\*(C'\fR به دلیل تغییراتی در libcap زیرین کمی تغییر کرده است. از نظر فنی این شکستن سازگاری API محسوب نمی‌شود، زیرا خروجی جدید توصیفی همچنان معتبر اما فشرده‌تر از قابلیت‌های فایل است؛ با این حال، به دلیل متفاوت بودن ممکن است برای کاربران این API مشکلاتی ایجاد کند. .PP اکنون API \f(CW\*(C`guestfs_mkfs_btrfs\*(C'\fR پارامتر \f(CW\*(C`allocstart\*(C'\fR را نادیده می‌گیرد، زیرا از نسخه btrfs 4.14.1 منسوخ و سپس حذف شد. .PP اکنون APIهای \f(CW\*(C`guestfs_isoinfo_*\*(C'\fR به جای استفاده از ابزار خارجی، به طور مستقیم «توصیف‌کننده حجم اصلی دیسک نوری» (CD Primary Volume Descriptor) را تجزیه می‌کنند. رفتار APIها باید دقیقاً همانند گذشته به نظر برسد (با تشکر از Thomas Schmitt). .PP اکنون می‌توانید ماشین مجازی (appliance) را وادار به استفاده از KVM کنید تا در صورت عدم پشتیبانی با خطا مواجه شود (Sam Eiderman). .PP به دلیل تغییری در نسخه ۵ فایل‌سیستم XFS، غیرفعال کردن lazy\-counters دیگر عمل نمی‌کند. این API همچنان برای نسخه‌های قبلی XFS کار می‌کند (Laszlo Ersek). .SS "تغییرات ساخت (Build changes)" .IX Subsection "Build changes" فرایند ساخت اکنون به جای PCRE از PCRE2 استفاده کرده و به آن نیاز دارد. .PP در صورت فعال بودن libvirt، این نسخه به libvirt ≥ 7.1.0 نیاز دارد. .PP بسته gnulib دیگر همراه با libguestfs عرضه نمی‌شود، که این امر ساخت از مخزن git را بسیار ساده‌تر می‌کند. .PP ماژول Perl \f(CW\*(C`Sys::Virt\*(C'\fR (اتصال‌های libvirt برای Perl) دیگر توسط libguestfs الزامی نیست. .PP کد با هر دو قابلیت LTO و \fI\-fanalyzer\fR کامپایلر GCC کامپایل شده و بسیاری از باگ‌ها و هشدارها برطرف شده‌اند. .PP امکان کامپایل پروژه‌هایی مانند guestfs\-tools و virt\-v2v با نسخه‌های محلی ساخته‌شده (اما نصب‌نشده) از libguestfs فراهم شد (Laszlo Ersek). .PP اکنون آزمون‌ها به صورت موازی اجرا می‌شوند (به همراه اصلاحات متعدد دیگر توسط Laszlo Ersek). .PP راهکاری برای پسرفت مربوط به RAID0 در لینوکس 3.14/5.4 اعمال شد (Laszlo Ersek). .PP پشتیبانی از معماری RISC\-V (توسط Heinrich Schuchardt). .PP پشتیبانی از ساخت روی توزیع‌های Alma Linux و Cloud Linux (توسط Александр Кравченко). .PP اصلاح سازگاری برای کامپایل با OCaml 4.12. .PP فایل بایگانی فشرده (tarball) دیگر شامل فایل \fIChangeLog\fR نیست. برای دسترسی به تاریخچه تغییرات دقیق، لطفاً به مخزن git بالادست مراجعه کنید. .PP عدم فرض استفاده از bash در اسکریپت \fI./configure\fR (توسط Martin Kletzander). .PP اصلاح گزینه \fI./configure \-\-with\-distro\fR (توسط Alexandre Iooss). .PP اصلاحات گوناگون برای qemu 6.1. .PP اصلاح ایجاد وابستگی‌های appliance در توزیع Debian (توسط Hilko Bengen). .PP به‌روزرسانی بسته‌های appliance در SUSE و چندین بهبود دیگر در اسکریپت init (توسط Olaf Hering). .SS "ساختار داخلی (Internals)" .IX Subsection "Internals" اکنون از ویژگی \fI\-cpu max\fR در qemu / libvirt برای انتخاب بهترین CPU جهت اجرای appliance استفاده می‌شود. این کار باید عملکرد مواردی مانند دیسک‌های رمزگذاری‌شده را بهبود دهد (Daniel Berrangé). .PP هنگام ارسال UUID سیستم‌فایل appliance به supermin، اکنون آن را مستقیماً از داخل appliance می‌خوانیم و دیگر از برنامه \fBfile\fR\|(1) استفاده نمی‌کنیم. این روش قابل اطمینان‌تر است، به خصوص با توجه به اینکه خروجی برنامه file اغلب تغییر کرده یا با خطا مواجه می‌شد. .PP گزینه \fI\-enable\-fips\fR در qemu دیگر استفاده نمی‌شود. نیازی به آن نبود و توسط qemu منسوخ شده است. .PP در Fedora، افزودن وابستگی به glibc\-gconv\-extra جهت رفع مشکل API \f(CW\*(C`guestfs_syslinux\*(C'\fR (توسط Yongkui Guo). .PP دیگر از option ROM مربوط به sga (آداپتور گرافیک سریال) qemu استفاده نمی‌شود و به جای آن از ویژگی معادل در seabios بهره گرفته می‌شود. .SS "باگ‌های رفع‌شده (Bugs fixed)" .IX Subsection "Bugs fixed" .IP https://bugzilla.redhat.com/2002325 4 .IX Item "https://bugzilla.redhat.com/2002325" استفاده از \-machine graphics=off به جای دستگاه sga .IP https://bugzilla.redhat.com/2001636 4 .IX Item "https://bugzilla.redhat.com/2001636" [RFE] libguestfs: افزودن قابلیت تشخیص AlmaLinux و CloudLinux .IP https://bugzilla.redhat.com/1997446 4 .IX Item "https://bugzilla.redhat.com/1997446" هنگام کار با تصویر windows server 2022 مقدار osinfo صحیح نیست .IP https://bugzilla.redhat.com/1990720 4 .IX Item "https://bugzilla.redhat.com/1990720" syslinux: عدم موفقیت در ایجاد ldlinux.sys .IP https://bugzilla.redhat.com/1985912 4 .IX Item "https://bugzilla.redhat.com/1985912" تابع lstatns دارای نشت حافظه است. (python3) .IP https://bugzilla.redhat.com/1960217 4 .IX Item "https://bugzilla.redhat.com/1960217" [پسرفت] ls: پس از اجرای guestmount پیوند نمادین خوانده نمی‌شود .IP https://bugzilla.redhat.com/1949683 4 .IX Item "https://bugzilla.redhat.com/1949683" virt\-v2v: خطا: بازرسی نتوانست سیستم مهمان (یا ماشین فیزیکی) مبدأ را تشخیص دهد .IP https://bugzilla.redhat.com/1938982 4 .IX Item "https://bugzilla.redhat.com/1938982" انتقال libguestfs از PCRE به PCRE2 .IP https://bugzilla.redhat.com/1930996 4 .IX Item "https://bugzilla.redhat.com/1930996" [پسرفت] lvcreate دوباره در پاک‌سازی امضاها با شکست مواجه می‌شود .IP https://bugzilla.redhat.com/1930133 4 .IX Item "https://bugzilla.redhat.com/1930133" ابزار Virt\-v2v نمی‌تواند مهمان rhel8 را که پارتیشن usr مستقل دارد تبدیل کند .IP https://bugzilla.redhat.com/1915646 4 .IX Item "https://bugzilla.redhat.com/1915646" libguestfs\-1.44.0 \- مسیر guestfs appliance خراب است .IP https://bugzilla.redhat.com/1911177 4 .IX Item "https://bugzilla.redhat.com/1911177" ترکیب virt\-builder + virt\-install یک ماشین مجازی می‌سازد که نمی‌تواند fedora 33 را بوت کند .IP https://bugzilla.redhat.com/1766487 4 .IX Item "https://bugzilla.redhat.com/1766487" فرض نادرست libguestfs مبنی بر اینکه rpmdb در قالب Berkeley DB است .IP https://bugzilla.redhat.com/1409024 4 .IX Item "https://bugzilla.redhat.com/1409024" [Debian] نبود db_dump باعث لغو فرایند بازرسی می‌شود .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 "Alexandre Iooss" 4 .IX Item "Alexandre Iooss" .PD 0 .IP "Daniel P. Berrangé" 4 .IX Item "Daniel P. Berrangé" .IP "Heinrich Schuchardt" 4 .IX Item "Heinrich Schuchardt" .IP "Hilko Bengen" 4 .IX Item "Hilko Bengen" .IP "Laszlo Ersek" 4 .IX Item "Laszlo Ersek" .IP "Martin Kletzander" 4 .IX Item "Martin Kletzander" .IP "Remi Collet" 4 .IX Item "Remi Collet" .IP "Richard W.M. Jones" 4 .IX Item "Richard W.M. Jones" .IP "Sam Eiderman" 4 .IX Item "Sam Eiderman" .PD .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "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 در گزارش باگ.