guestfs-release-notes-1.34(1) Virtualization Support guestfs-release-notes-1.34(1)

guestfs-release-notes-1.34 - یادداشت‌های انتشار libguestfs نسخه 1.34

این یادداشت‌های انتشار تنها تفاوت‌ها نسبت به تفکیک قبلی شاخه پایدار/توسعه (1.32.0) را پوشش می‌دهند. برای گزارش تفصیلی تغییرات، لطفاً به مخزن git یا فایل ChangeLog توزیع‌شده در بسته فشرده (tarball) مراجعه کنید.

بهینه‌سازی‌های عملکردی متعددی در libguestfs انجام شده است. زمان راه‌اندازی با «حافظه نهان گرم» (hot cache) برای اپلاینس با فرض نصب بودن نسخه اخیر qemu و هسته باید زیر ۱ ثانیه باشد. همچنین ابزارهای کمکی جدیدی برای سنجش دقیق عملکرد libguestfs وجود دارند (utils/boot-benchmark و utils/boot-analysis در درخت سورس).

ابزار virt-p2v برای تبدیل ماشین‌های فیزیکی به ماشین‌های مجازی به شکل قابل توجهی بهبود یافته است. این موارد شامل: خروجی واضح‌تر و رنگی در حین تبدیل، پشتیبانی از Gtk 3، اطلاعات دقیق‌تر درباره سخت‌افزار، قابلیت کلیک برای شناسایی رابط‌های شبکه، ابزارهای اشکال‌زدایی بیشتر در دیسک ISO، و رفع اشکالات متعدد.

سیستم‌فایل f2fs (سیستم‌فایل سازگار با فلش) اکنون پشتیبانی می‌شود (Pino Toscano).

ابزارهای جدید (New tools)

ابزار virt-p2v-make-kiwi(1) می‌تواند برای ساخت فایل ISO ابزار virt-p2v مبتنی بر SLES و openSUSE با استفاده از ابزار kiwi استفاده شود (Cédric Bosdonnat).

ویژگی‌های جدید در ابزارهای موجود (New features in existing tools)

ابزار virt-resize اکنون GUID دیسک GPT را حفظ خواهد کرد. این مورد برای Windows Server 2012 R2 لازم بود، جایی که با تغییر یافتن GUID، بارگذار بوت دچار سردرگمی می‌شد (Maxim Perevedentsev).

ابزار virt-resize از کپی‌برداری تنک (sparse copying) برای پارتیشن‌های گسترش‌یافته (به سبک قدیمی MBR) استفاده خواهد کرد. این امر تغییر اندازه سیستم‌های مهمانی را که از پارتیشن‌های گسترش‌یافته استفاده می‌کنند بسیار سریع‌تر می‌سازد (Maxim Perevedentsev).

اکنون می‌توان از گزینه‌های خط فرمان هسته virt-p2v برای تنظیم مقادیر پیش‌فرض پیکربندی رابط گرافیکی (GUI) استفاده کرد.

گزینه‌های اشکال‌زدایی virt-p2v به طور کامل حذف شده‌اند که باعث ساده‌سازی رابط کاربری و مستندات می‌شود. اطلاعات اشکال‌زدایی اکنون کاملاً به صورت خودکار ثبت می‌شوند.

ابزار virt-p2v-make-disk به شما امکان می‌دهد گزینه --arch را تعیین کنید، که اجازه ساخت یک virt-p2v نسخه ۳۲ بیتی را برای سازگاری با سیستم‌های قدیمی‌تر می‌دهد.

ابزار virt-p2v-make-disk دیگر نیازی به تعیین یک "os-version" برای دیسک virt-p2v ندارد. در صورت حذف، سعی خواهد کرد با توجه به سیستم میزبان شما یک "os-version" مناسب انتخاب کند.

هر دو ابزار virt-p2v-make-disk و virt-p2v-make-kickstart گزینه جدید --install را به دست آورده‌اند که به شما امکان می‌دهد بسته‌های دلخواه اضافی را برای سفارشی‌سازی، ابزارهای اشکال‌زدایی بیشتر و غیره به ISO ابزار virt-p2v اضافه کنید.

ابزار virt-v2v اکنون ابزارهای Parallels Tools (یا معادل آن Virtuozzo Tools) را از سیستم‌های مهمان لینوکس حذف می‌کند. همچنین از بارگذاری درایورهای ویندوز در هنگام بوت جلوگیری می‌کند. (Roman Kagan و Pavel Butsykin)

حالت --in-place در virt-v2v ارتقا یافته است تا به فراخوان‌کننده امکان انتخاب این را بدهد که آیا برخی درایورهای virtio در سیستم مهمان نصب شوند یا خیر (Roman Kagan).

تبدیل سیستم‌های مهمان ویندوزی در virt-v2v به طور اساسی بازنویسی و ساده‌سازی شد (Roman Kagan).

حالت --in-place در virt-v2v اکنون از نصب درایورهای virtio-scsi در سیستم‌های مهمان پشتیبانی می‌کند (Roman Kagan).

ابزار virt-v2v اکنون می‌تواند سیستم‌های مهمان SUSE را با و بدون UEFI تبدیل کند (Cédric Bosdonnat و Jim Fehlig).

ابزار virt-v2v اکنون می‌تواند سیستم‌های مهمانی را که دارای چندین دیسک هستند به Glance تبدیل کند. پیش از این، تبدیل در چنین سیستم‌های مهمانی با شکست مواجه می‌شد.

گزینه‌های --no-trim و --vmtype در virt-v2v اکنون بی‌اثر (no-op) هستند. آن‌ها یک پیام هشدار چاپ می‌کنند اما نادیده گرفته می‌شوند. virt-v2v اکنون می‌تواند بدون دخالت کاربر، مقدار OVF vmtype را به درستی تولید کند.

ابزار virt-v2v اکنون در برابر SUSE Xen به عنوان هایپروایزر مبدأ آزمایش شده است (Cédric Bosdonnat).

ابزار virt-v2v پشتیبانی از درایورهای SUSE VMDP را اضافه می‌کند (Cédric Bosdonnat).

ابزار virt-v2v می‌تواند فایل‌های OVA حاوی زیرپوشه‌ها را که توسط SUSE Studio تولید شده‌اند تبدیل کند (Cédric Bosdonnat).

ابزار virt-v2v عنصر "<Origin>" در OVF را به درستی تنظیم می‌کند. oVirt برای پشتیبانی از هایپروایزرهای مبدأ بیشتر گسترش یافته است (Shahar Havivi).

ابزار virt-v2v اکنون از Windows Server 2016 پشتیبانی می‌کند (Tomáš Golembiovský).

گزینه --list در virt-builder اکنون می‌تواند برای نمایش همه الگوها یا یک الگوی منفرد استفاده شود (Pino Toscano).

همه ابزارهای مبتنی بر OCaml اکنون از getopt_long(3) برای تجزیه گزینه‌ها استفاده می‌کنند و خروجی --help بهبود یافته است (Pino Toscano).

گزینه --selinux-relabel در virt-builder و virt-customize اکنون می‌تواند در زمان ساخت، برچسب‌گذاری مجدد سیستم‌فایل مهمان را به طور کامل انجام دهد، بدون اینکه به برچسب‌گذاری طولانی‌مدت خودکار در اولین بوت نیازی باشد.

گزینه --delete در virt-customize اکنون الگوهای تطبیق فایل (globs) را می‌پذیرد.

گزینه جدید --uninstall در virt-customize به شما امکان حذف بسته‌ها را می‌دهد.

ابزار virt-customize اکنون می‌تواند از "pvvxsvc" به عنوان جایگزینی برای "rhsrvany" جهت اجرای اسکریپت‌های بوت اول (firstboot) در سیستم‌های مهمان ویندوزی استفاده کند (Cédric Bosdonnat).

ابزار virt-customize اکنون از قوی‌ترین طرح هش گذرواژه در آرچ و Void Linux استفاده می‌کند (Pino Toscano).

گزینه --install در virt-customize اکنون در آرچ به درستی کار می‌کند (Pino Toscano).

ابزار virt-inspector دارای گزینه‌های جدید --no-applications و --no-icon است تا از قرار گرفتن فهرست برنامه‌ها و آیکون در خروجی XML جلوگیری کند (Pino Toscano).

گزینه جدید --network به virt-sysprep اضافه شده است که به شما امکان می‌دهد در عمل از گزینه‌هایی مانند --install و غیره که قبلاً در virt-sysprep وجود داشتند اما معمولاً کار نمی‌کردند استفاده کنید. توجه داشته باشید که شبکه همچنان به طور پیش‌فرض غیرفعال است.

عملیات "fs-uuids" در virt-sysprep دیگر روی سیستم‌های مهمان btrfs با شکست مواجه نمی‌شود (Maxim Perevedentsev).

ابزار virt-dib می‌تواند ایمیج‌های Docker را در خروجی تولید کند (Pino Toscano).

ابزار virt-dib دارای گزینه جدید --drive-format است تا به کاربر اجازه دهد قالب درایو کمکی را مشخص کند (Pino Toscano).

تمام ابزارهای virt مبتنی بر OCaml اکنون دارای گزینه --colors/--colours هستند که خروجی رنگی (با استفاده از دنباله‌های گریز ANSI) را حتی در صورتی که خروجی یک tty نباشد فعال می‌کند. حالت پیش‌فرض این است که tty بودن خروجی بررسی شده و در صورت نبودن، خروجی رنگی غیرفعال شود. این امر به خروجی رنگی اجازه می‌دهد توسط سایر ابزارها دریافت و استفاده شود.

پیوندهای زبان‌های برنامه‌نویسی (Language bindings)

پوشش آزمون PHP بهبود یافته است (Pino Toscano).

اکنون از PHP 7 پشتیبانی می‌شود (Pino Toscano).

پیوندهای پایتون اکنون با استاندارد PEP 8 سازگار هستند (Pino Toscano).

یک بسته pip پایتون در این نشانی در دسترس است: http://libguestfs.org/download/python

پیوندهای روبی اکنون در صورتی که توسط بازخوانی رویداد (event callback) استثنایی صادر شود، کل استثنا را چاپ می‌کنند. توجه داشته باشید که این رفتار همچنان نادرست است زیرا بازخوانی‌های رویداد نباید استثنا صادر کنند، اما به اشکال‌زدایی کمک می‌کند.

تمام کتابخانه‌ها و برنامه‌های OCaml اکنون در صورت پشتیبانی توسط کامپایلر OCaml، با -safe-string کامپایل می‌شوند.

بازرسی (Inspection)

اکنون Alpine Linux که از busybox استفاده می‌کند قابل بازرسی است. همچنین مدیر بسته APK در virt-customize پشتیبانی می‌شود (Pino Toscano).

ما اکنون بازرسی Mageia 4 را مدیریت می‌کنیم (Pino Toscano).

سیستم‌عامل Void Linux و مدیر بسته xbps در Void Linux به طور کامل پشتیبانی می‌شوند (Pino Toscano).

تجزیه اطلاعات نسخه CoreOS بهبود یافته است (Pino Toscano).

اکنون دریافت آیکون از ALT Linux امکان‌پذیر است (Pino Toscano).

نسخه‌های PLD Linux کمتر از ۳ اکنون شناسایی می‌شوند (Pino Toscano).

حروف درایو ویندوز اکنون برای سیستم‌های مهمانی که از پارتیشن‌های GPT استفاده می‌کنند بازگردانده می‌شوند (Dawid Zamirski).

اکنون می‌توانیم سیستم‌های مهمان یونیکس را که فاقد فایل /etc/fstab هستند به درستی بازرسی کنیم (Pino Toscano).

منبع دیگری برای آیکون اوبونتو اضافه شد که به نصب بودن GNOME در سیستم مهمان وابسته نیست.

اکنون می‌توانیم برای سیستم‌های مهمان ۶۴ بیتی ویندوز ۷ آیکون دریافت کنیم.

یکپارچه‌سازی با Libosinfo جهت سازگاری با قالب جدید پایگاه داده مورد استفاده توسط osinfo بازنویسی شد (Pino Toscano).

مستندات (Documentation)

صفحه راهنمای جدید guestfs-building(1) نحوه ساخت libguestfs از سورس‌کد را شرح می‌دهد.

صفحات راهنما، ابزارها و خروجی --help ابزارها اکنون به طور خودکار بررسی می‌شوند تا اطمینان حاصل شود که تمام گزینه‌های ابزارها به درستی مستند شده‌اند، بخش‌های هشدار در صورت لزوم گنجانده شده‌اند، و هر صفحه دارای یک بخش توضیحات است.

صفحه راهنمای guestfs-testing(1) نوسازی شده و بر پایه نسخه جدیدتر libguestfs قرار گرفته است.

معماری‌ها و بسترهای اجرایی (Architectures and platforms)

ابزار virt-customize اکنون روی بسترهای POWER7 و POWER8، چه big-endian و چه little-endian کار می‌کند (Xianghua Chen و Hu Zhang).

همچنین به guestfs-security(1) مراجعه کنید.

CVE-2015-8869

https://bugzilla.redhat.com/CVE-2015-8869

این آسیب‌پذیری در OCaml ممکن است بر ابزارهای virt که با زبان برنامه‌نویسی OCaml نوشته شده‌اند تأثیر بگذارد. این آسیب‌پذیری تنها پلتفرم‌های ۶۴ بیتی را تحت تأثیر قرار می‌دهد. از آنجا که این اشکال بر تولید کد تأثیر می‌گذارد، پیش‌بینی اینکه دقیقاً چه نرم‌افزاری ممکن است تحت تأثیر قرار گیرد دشوار است، و بنابراین توصیه ما این است که libguestfs را با استفاده از نسخه‌ای از کامپایلر OCaml که در آن این اشکال برطرف شده است مجدداً کامپایل کنید (یا از توزیع لینوکس خود بخواهید که همین کار را انجام دهد).

مالکیت virt-customize بر روی .ssh و .ssh/authorized_keys

https://bugzilla.redhat.com/1337561

پیش از این هنگامی که virt-customize یک کلید SSH را به سیستم مهمان تزریق می‌کرد، در زمان ایجاد دایرکتوری ~/.ssh و فایل ~/.ssh/authorized_keys (در صورت عدم وجود)، آن‌ها را با مالک و گروه "root.root" ایجاد می‌کرد. این مورد برطرف شده است تا کاربر صحیح استفاده شود. گمان نمی‌رود که این مورد قابل سوءاستفاده بوده باشد.

ویندوز "%systemroot%"

کد بازرسی در برابر سیستم‌های مهمانی که ممکن است از "%systemroot%" بسیار طولانی استفاده کنند (که از رجیستری ویندوز تحت کنترل مهمان مشتق می‌شود) مقاوم‌تر شده است. گمان نمی‌رود که این مورد قابل سوءاستفاده بوده باشد.

دستگاه Virtio-rng اکنون در اپلاینس در دسترس است

دستگاه virtio-rng (دستگاه مجازی مولد اعداد تصادفی) اکنون به اپلاینس پاس داده می‌شود، که این کار کیفیت تولید اعداد تصادفی را برای GUIDها و تولید کلیدهای رمزنگاری بهبود می‌بخشد.

رابط‌های برنامه‌نویسی جدید (New APIs)

"btrfs_filesystem_show"
فهرست کردن تمام دستگاه‌هایی که یک سیستم‌فایل btrfs روی آن‌ها گسترده شده است (Pino Toscano).
"download_blocks"
"download_inode"
"filesystem_walk"
دانلود بلوک‌های داده سیستم‌فایل از یک پارتیشن مشخص. دانلود فایل‌های دلخواه بر اساس شماره inode. بازیابی تمام فایل‌ها از یک سیستم‌فایل از جمله فایل‌های حذف‌شده.

توجه داشته باشید که این موارد به وابستگی اختیاری The Sleuth Kit نیاز دارند. (Matteo Cafasso)

"get_sockdir"
خواندن مسیری که سوکت‌های موقت در آن ذخیره می‌شوند (Pino Toscano).
"mountable_device"
"mountable_subvolume"
تفکیک یک Mountable به نام دستگاه و زیرحجم (subvolume) (Cédric Bosdonnat).
"ntfscat_i"
دانلود فایل NTFS بر اساس شماره inode (Matteo Cafasso).
"part_expand_gpt"
امکان گسترش درجا (in-place) پارتیشن‌های GPT با انتقال جدول پارتیشن دوم (پشتیبان) به انتهای دیسک (Maxim Perevedentsev).
"part_get_disk_guid"
"part_set_disk_guid"
"part_set_disk_guid_random"
دریافت و تنظیم GUID دیسک GPT، یا تنظیم آن به یک مقدار تصادفی جدید (Maxim Perevedentsev).
"selinux_relabel"
برچسب‌گذاری مجدد SELinux روی بخشی از سیستم‌فایل مهمان یا تمام آن.

سایر تغییرات API (Other API changes)

توابع "guestfs_set_selinux"، "guestfs_get_selinux"، "guestfs_setcon"، "guestfs_getcon" و "guestfs_llz" منسوخ شده‌اند. برای برچسب‌گذاری مجدد سیستم‌های فایل از API جدید "guestfs_selinux_relabel" استفاده کنید. برای فهرست کردن ویژگی‌های گسترده "security.selinux" فایل‌های موجود از "guestfs_lgetxattrs" استفاده کنید.

تابع "guestfs_vfs_minimum_size" اکنون می‌تواند روی سیستم‌های فایل تغییریافته یا ناسازگار (dirty) استفاده شود (Maxim Perevedentsev).

تابع "guestfs_ll" اکنون روی مسیرهایی که حاوی پیوندهای نمادین مطلق هستند کار می‌کند (Pino Toscano).

تابع "guestfs_glob_expand" اکنون دارای یک پارامتر بولی اختیاری "directoryslash" است که بازگردانده شدن اسلش پایانی برای نام دایرکتوری‌ها را کنترل می‌کند (Pino Toscano).

تابع "guestfs_lvs" دیگر حجم‌های منطقی (LV) را که پرچم "activationskip" برای آن‌ها تنظیم شده است بازنمی‌گرداند. دلیل آن این است که چنین LVهایی فاقد گره دستگاه "/dev/VG/LV" هستند و بنابراین کدی که فهرست LVها را می‌خواند و سپس خود دستگاه‌ها را بررسی می‌کرد فوراً با شکست روبرو می‌شد. اگر می‌خواهید تمام LVها را بخوانید می‌توانید از "guestfs_lvs_full" استفاده کنید (Pino Toscano).

تابع "guestfs_list_disk_labels" اکنون در صورت اضافه نشدن هیچ دیسک برچسب‌داری با شکست مواجه نمی‌شود؛ در عوض اکنون یک فهرست خالی برمی‌گرداند (Pino Toscano).

تابع "guestfs_is_lv" در صورت دریافت یک زیرحجم btrfs دیگر با شکست روبرو نمی‌شود، بلکه مقدار false برمی‌گرداند (Maxim Perevedentsev).

نسخه qemu ≥ 1.3.0 مورد نیاز است.

کتابخانه yajl (یک کتابخانه تجزیه JSON) برای ساخت libguestfs الزامی است.

اکنون می‌توانید با GCC 6 فرآیند ساخت را انجام دهید.

دستور "make check-valgrind" اکنون دارای پوشش آزمایشی به مراتب بهتری است.

دستور "make check-slow" اکنون مجدداً کار می‌کند.

از دستور "make -C appliance clean-supermin-appliance" برای پاکسازی اپلاینس supermin استفاده کنید (در اجرای بعدی دستور "make" مجدداً ساخته خواهد شد).

مجموعه‌ای از قوانین جدید برای اجرای virt-p2v از داخل دایرکتوری سورس وجود دارد: "make -C p2v run-virt-p2v-directly" | "run-virt-p2v-in-a-vm" | "run-virt-p2v-non-gui-conversion". این موارد در guestfs-hacking(1) بیشتر مستند شده‌اند.

ابزار virt-p2v ممکن است با استفاده از Gtk 2 یا Gtk 3 ساخته شود. برای اجبار به استفاده از یک نسخه خاص Gtk، از دستور "./configure --with-gtk=2|3" استفاده کنید.

گزینه‌های "./configure" اکنون عمدتاً در guestfs-building(1) مستند شده‌اند.

در git، اکنون نسخه‌ها با برچسب "v1.XX.YY" ثبت می‌شوند (پیش از این با "1.XX.YY" برچسب‌گذاری می‌شدند). استفاده از پیشوند "v-" در مخازن git رایج‌تر است.

هنگام استفاده از بک‌اند libvirt، اکنون منتظر خروج مسالمت‌آمیز qemu می‌مانیم به جای اینکه پس از ۱۵ ثانیه آن را متوقف کنیم (kill). این امر هنگام نوشتن روی دستگاه‌های کند (به‌ویژه فلش مموری‌های ارزان USB) کمک می‌کند.

پیام‌های خطای libvirt اکنون شامل فیلد "err->int1" هستند که معمولاً حاوی "errno" است.

در معماری ARM، تمام کدهای DTB (درخت دستگاه) حذف شده‌اند. qemu درخت دستگاه مناسب را در لحظه ایجاد می‌کند و نیازی به تعیین آن نداریم.

آزمون‌های C API اکنون از دیسک‌های آزمایشی بزرگ‌تری استفاده می‌کنند که امکان آزمایش مناسب BTRFS را فراهم می‌سازد (Pino Toscano).

آزمون‌ها اکنون باید روی یک میزبان صرفاً مجهز به Python 3 کار کنند (Pino Toscano).

در پیوندهای زبان C، توابع داخلی اکنون (عمدتاً) به طور یکدست به نام "guestfs_int_*" نام‌گذاری شده‌اند، در حالی که پیش از این الگوی یکدستی وجود نداشت.

توابع قدیمی مانند "safe_malloc" و غیره اکنون دیگر توسط کتابخانه صادر نمی‌شوند و در پیوندهای زبان‌ها نیز استفاده نمی‌گردند.

تنظیم متغیر TMPDIR به مسیری طولانی‌تر از حدود ۱۰۰ نویسه دیگر باعث شکست تصادفی و خاموش libguestfs در هنگام ایجاد سوکت‌های دامنه یونیکس نمی‌شود (Pino Toscano).

ماکروی "COMPILE_REGEXP" اکنون می‌تواند در دیمن استفاده شود.

هنگام ردیابی (tracing)، نتایج حاوی ساختارها (structs) اکنون به طور کامل چاپ می‌شوند (Pino Toscano).

ماژول پرل "Sys::Guestfs" دیگر «شماره نسخه» API افزایشی را در بر نمی‌گیرد. این ماژول اکنون همیشه دارای نسخه ساختگی "1.0" است. برای یافتن نسخه واقعی libguestfs از درون پرل باید "$g->version" را فراخوانی کنید.

تمام کدها با گزینه "-Wstack-usage=10000" کامپایل می‌شوند و تغییرات متعددی برای حذف تخصیص پشته‌ای رشته‌ها و بافرهای بزرگ صورت گرفته است.

اکنون تابع error(3) در همه‌جا استفاده می‌شود و جایگزین اکثر استفاده‌های قبلی از perror(3) + exit(3)، و fprintf(3) + exit شده است.

در کد C، کامنت‌های "/**" به مستنداتی تبدیل می‌شوند که به طور خودکار به صفحه راهنمای guestfs-hacking(1) اضافه می‌گردند.

یک تابع امن "getumask" اضافه شده است. برای هسته‌های لینوکس جدید، این تابع از فیلد تازه اضافه شده "Umask" در /proc/self/status استفاده می‌کند. برای لینوکس‌های قدیمی‌تر و سایر سیستم‌های یونیکس، این تابع از روشی امن در برابر چندریسمانی (thread-safe) که شامل fork(2) است استفاده می‌کند (با تشکر از: Josh Stone، Jiri Jaburek، Eric Blake).

پوشش‌های امن برای posix_fadvise(2) اضافه شده‌اند و نکات بیشتری به کد افزوده شده است که ممکن است تفاوت اندکی در عملکرد ایجاد کنند.

یک پوشش امن در اطراف waitpid(2) اضافه شده است که سیگنال "INTR" را به درستی مدیریت می‌کند.

اسکریپت "podwrapper.pl" (که برای تولید صفحات راهنما استفاده می‌شود) اکنون در صورت یافتن هرگونه خطای POD متوقف می‌شود. اسکریپت جدیدی به نام "podcheck.pl" بررسی متقابل خروجی --help، گزینه‌های ابزارها و صفحات راهنما را انجام می‌دهد.

تمام شماره نسخه‌ها در کتابخانه (مانند نسخه‌های qemu، نسخه‌های libvirt، نسخه‌های سیستم‌عامل‌های مهمان) در یک فایل واحد src/version.c یکپارچه شده‌اند (Pino Toscano).

در مهمان‌های ویندوزی، ابزار virt-customize از مسیر مستقل از ارائه‌دهنده "C:\Program Files\Guestfs\Firstboot" برای ذخیره اسکریپت‌های بوت اول (firstboot) استفاده خواهد کرد. پیش از این از مسیر "C:\Program Files\Red Hat\Firstboot" استفاده می‌کرد. این تغییر باید برای خود اسکریپت‌ها نامحسوس باشد. (Cédric Bosdonnat)

در مهمان‌های لینوکسی، سرویس‌های firstboot ایجاد شده توسط virt-builder --firstboot و غیره به "guestfs-firstboot" تغییر نام یافته‌اند (Pino Toscano).

اکنون یک تابع مشترک "debug" وجود دارد که توسط همه ابزارهای OCaml استفاده می‌شود و جایگزین کد قبلی شده است که دستور "if verbose () then printf ..." را اجرا می‌کرد.

ابزار virt-p2v فایل‌های مورد نیاز خود را به جای تلاش برای ارسال از طریق نشست شل، با استفاده از scp(1) بر روی سرور تبدیل virt-v2v کپی می‌کند. این کار قابلیت اطمینان را بهبود بخشیده و باید برای کاربران نهایی کاملاً نامحسوس باشد.

تمام کدهای موجود در mllib اکنون در یک کتابخانه واحد "mllib.cma" یا "mllib.cmxa" ساخته می‌شوند. تمام کدهای موجود در customize اکنون در یک کتابخانه واحد "customize.cma" یا "customize.cmxa" ساخته می‌شوند. این کار ساخت ابزارهای OCaml را ساده‌تر می‌کند.

اکنون ابزار lvmetad(8) در صورت وجود در اپلاینس استفاده می‌شود (Pino Toscano).

«قوانین بی‌صدا» (Silent rules) برای OCaml، Java، Erlang و POD استفاده می‌شوند. از "make V=1" برای مشاهده مجدد دستورات کامل استفاده کنید (Pino Toscano).

شکست virt-sparsify --in-place در سیستم‌های UEFI
تابع run_command در صورت شکست execve (مثلاً به دلیل نبود فایل اجرایی)، گرداننده‌های خروج را اجرا می‌کند
شکست virt-dib در ایجاد ایمیج با استفاده از DIB_YUM_REPO_CONF
شکست در بازرسی فایل ISO ویندوز
نمایش برخی اطلاعات هنگام تبدیل مهمان به libvirt توسط virt-v2v با پارامتر --quiet
لایه هم‌پوشانی ایمیج‌های دیسک قالب فایل پشتیبان (backing file) را مشخص نمی‌کند
برنامه Virt-manager نمی‌تواند آیکون‌های سیستم‌عامل مهمان win7/win8/ubuntu را نمایش دهد.
بهبود پیام خطای "remote server timeout unexpectedly waiting for password prompt" هنگام اتصال به یک سرور نامعتبر در کلاینت p2v
ابزار virt-p2v هنگام «آزمایش اتصال» با یک کاربر ناموجود در سرور تبدیل باید پیام خطا را به‌روزرسانی کند
گزینه virt-sysprep --install همیشه در نصب بسته‌های مشخص‌شده با شکست مواجه می‌شد
گزینه virt-customize --truncate-recursive در صورت تعیین یک مسیر ناموجود باید پیام خطا بدهد
[درخواست قابلیت] ارائه توضیحات بهتر درباره «curl error 22» هنگام شکست در استفاده از URL هویت ssh تحت پروتکل http در کلاینت p2v
شکست اتصال SSH به سرور تبدیل از طریق URL هویت ssh تحت پروتکل http در کلاینت p2v
[درخواست قابلیت] حذف بسته‌ها در داخل ماشین مجازی
دستور ifconfig در کلاینت p2v پشتیبانی نمی‌شود
تبدیل یک مهمان از RHEL توسط virt-v2v اما نمایش RHEV در بخش اطلاعات مبدأ در rhevm
لزوم نمایش یک هشدار مبنی بر پارتیشن‌دار بودن ایمیج دیسک هنگام استفاده از virt-p2v-make-disk
ابزار virt-get-kernel هنگام استفاده از --format auto خطای «invalid value» را صادر می‌کند
نشانگر چرخشی (spinner) در virt-p2v هنگام توقف چرخش باید پنهان شود
اتمام مهلت زمانی (timeout) آزمایش اتصال هنگام وارد کردن کاربر عادی سرور تبدیل با زدن تیک گزینه "use sudo......"
[درخواست قابلیت] پیشنهاد نمایش یک یادآوری به کاربر برای دکمه "Cancel conversion"
تراز نبودن چند پورت شبکه در کلاینت p2v
به‌روزرسانی فهرست سفید UEFI برای بسته‌های رسمی فدورا
عدم اعمال مجوزهای صحیح فایل توسط virt-customize --ssh-inject
گیومه‌های اضافی در اطراف UUID دستور findfs را در RHEL (اما نه در فدورا) دچار سردرگمی می‌کند
بخش بازرسی فایل /etc/redhat-release حاوی "Derived from Red Hat Enterprise Linux 7.1 (Source)" را تجزیه نمی‌کند
درخواست قابلیت: امکان تنظیم مقادیر پیش‌فرض با گزینه‌های هسته p2v بدون نیاز به p2v.server
ابزار virt-v2v باید از درج همزمان چندین گزینه «-b» و «-n» در خط فرمان جلوگیری کند
خطای libguestfs: امکان تجزیه عدد صحیح در شماره نسخه وجود ندارد: "7
[1.33.16] خطای کامپایل: مقدار تعریف‌نشده List.sort_uniq در فایل v2v.ml خط ۹۸۸، نویسه‌های ۱۰-۲۴:
شکست دستور `virt-builder --update` با این پیام: "dnf -y --best upgrade: command exited with an error"
دستور v2v نمی‌تواند خارج شود و هنگام تعیین "-v -x" پیام "block I/O error in device 'appliance': No space left on device (28)" چاپ می‌شود
شکست virt-rescue، اما پیام خطا مفقود است
درخواست قابلیت: پنجره گزارش virt-p2v باید کدهای گریز رنگی و نویسه‌های backspace را پردازش کند
دستور virt-v2v -o libvirt برچسب صحیح <graphics type="vnc|spice"> را حفظ یا استفاده نمی‌کند
خطا: خطای داخلی: نام نامعتبر دستگاه فلاپی: hdb
نمایش هشدار نادرست "use standard VGA" هنگام تبدیل ویندوز بزرگتر از ۷ توسط virt-v2v
نمایش نادرست نام سیستم‌عامل مهمان win8.1 x64 در بخش اطلاعات عمومی rhevm3.6
ابزار virt-v2v دیسک‌های اضافی را در Glance کپی نمی‌کند
شکست هنگامی که دیسک حاوی یک LV با activationskip=y باشد
ابزار virt-v2v به دلیل نقل‌قول‌های نامناسب نام فایل‌ها افزونه‌های VirtualBox را به درستی حذف نمی‌کند
باید یادآوری برای خودداری کاربر از ویرایش هم‌زمان یک ایمیج مهمان توسط چندین ابزار در صفحه راهنمای guestfish وجود داشته باشد
ابزار guestfish نمی‌تواند یک دایرکتوری پیوند نمادین را با ll لیست کند یا فایلی را در آن ویرایش کند
ابزار guestfish باید بتواند چیدمان‌های LVM thin را مدیریت کند
معماری ppc64le: گزینه virt-customize --install در شناسایی معماری مهمان با شکست مواجه می‌شود
آزمایش اینکه آزادسازی فضا (trimming) در virt-v2v دچار پس‌رفت نشده باشد
ابزار Virt-v2v روی دیسک خالی خطا می‌دهد: part_get_parttype: unknown signature, of the output: BYT;
ابزار virt-p2v در حالت غیرگرافیکی هیچ وضعیت یا پیشرفتی از تبدیل را نمایش نمی‌دهد
رمز عبور نامعتبر در P2V پیام unexpected end of file waiting for command prompt را چاپ می‌کند.
در اوبونتو گزینه‌های --install و --update در virt-builder نمی‌توانند از شبکه استفاده کنند
هشدار virt-v2v: سیستم‌عامل مهمان ناشناخته: windows windows 6.3 هنگام تبدیل win8، win8.1، win2012، win2012R2، win10 به rhev
پشتیبانی از بازرسی ایمیج‌های داکر بدون وجود /etc/fstab
ابزار libguestfs نمی‌تواند فدورا یا RHEL >= 7 اخیر را در حالتی که /usr یک پارتیشن مجزا است بازرسی کند
سرور تبدیل نامعتبر در P2V پیام unexpected end of file waiting for password prompt را چاپ می‌کند.
ابزار virt-rescue --selinux به درستی کار نمی‌کند؛ هنگام فعال‌سازی selinux در خط فرمان، مقدار «getenforce» در اپلاینس virt-rescue همچنان Disabled است
معماری ARM ۳۲ بیتی در اوبونتو: هشدار: تبدیل به اشاره‌گر از عدد صحیح با اندازه متفاوت [-Wint-to-pointer-cast]
خطای NetworkManager avc unlink denied برای resolv.conf پس از استفاده از --selinux-relabel
درخواست قابلیت: ابزار virt-sysprep باید از SELinux آگاه باشد
درخواست قابلیت: virt-p2v: نمایش اطلاعات بیشتر درباره دستگاه‌های ذخیره‌سازی
مدیریت SELinux می‌توانست به شکل بهتری انجام شود.

guestfs-examples(1), guestfs-faq(1), guestfs-performance(1), guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1), http://libguestfs.org

Richard W.M. Jones

Copyright (C) 2009-2025 Red Hat Inc.

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌گونه که توسط بنیاد نرم‌افزار آزاد منتشر شده است؛ چه نسخه ۲ مجوز یا (به انتخاب خودتان) هر نسخه پس از آن، بازتوزیع کرده و/یا تغییر دهید.

این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر «مجوز عمومی همگانی گنو» را ببینید.

شما باید به همراه این برنامه یک نسخه از «مجوز عمومی همگانی گنو» را دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر مکاتبه کنید: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

برای دریافت فهرستی از اشکالات موجود در libguestfs، از این پیوند استفاده کنید: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

برای گزارش یک اشکال جدید در libguestfs، از این پیوند استفاده کنید: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

هنگام گزارش اشکال، لطفاً موارد زیر را ارائه دهید:

  • نسخه libguestfs.
  • مکانی که libguestfs را از آنجا دریافت کرده‌اید (مثلاً کدام توزیع لینوکس، کامپایل‌شده از سورس و غیره)
  • اشکال را با دقت شرح دهید و راهی برای بازتولید آن ارائه کنید.
  • دستور libguestfs-test-tool(1) را اجرا کرده و خروجی کامل و ویرایش‌نشده آن را در گزارش اشکال قرار دهید.
2026-07-14 libguestfs-1.60.1