virt-get-kernel(1) Virtualization Support virt-get-kernel(1)

virt-get-kernel - استخراج کرنل و initramfs از ایمیج دیسک

virt-get-kernel [--options] -d domname
virt-get-kernel [--options] -a disk.img

این برنامه کرنل و initramfs را از یک ماشین مهمان استخراج می‌کند.

فرمت ایمیج دیسک به صورت خودکار تشخیص داده می‌شود مگر اینکه آن را با استفاده از گزینه --format مشخص کنید.

در صورتی که ماشین مهمان شامل چندین کرنل باشد، کرنلی با بالاترین شماره نسخه انتخاب می‌شود. برای استخراج کرنل‌های دلخواه از ایمیج دیسک، guestfish(1) را ببینید. برای استخراج کل دایرکتوری "/boot" یک ماشین مهمان، virt-copy-out(1) را ببینید.

نمایش راهنما.
افزودن file که باید یک ایمیج دیسک از یک ماشین مجازی باشد.

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

افزودن یک دیسک از راه دور. فرمت URI با guestfish سازگار است. بخش "ADDING REMOTE STORAGE" در guestfish(1) را ببینید.
این پارامتر اندازه سکتور ایمیج دیسک اضافه شده با گزینه -a را تعیین می‌کند و برای مهمان libvirt اضافه شده با گزینه -d نادیده گرفته می‌شود. همچنین بخش "guestfs_add_drive_opts" در guestfs(3) را ببینید.
استفاده از توالی‌های رنگی ANSI برای رنگ‌آمیزی پیام‌ها. این حالت پیش‌فرض هنگام ارسال خروجی به tty است. اگر خروجی برنامه به یک فایل هدایت شود، توالی‌های رنگی ANSI غیرفعال می‌شوند مگر اینکه از این گزینه استفاده کنید.
در صورت استفاده از libvirt، به URI داده‌شده متصل می‌شود. در صورت عدم ذکر، به هایپروایزر پیش‌فرض libvirt متصل می‌شویم.

اگر دستگاه‌های بلوکی مهمان را مستقیماً مشخص کنید (-a)، libvirt اصلاً استفاده نمی‌شود.

افزودن تمام دیسک‌ها از مهمان libvirt نام‌برده‌شده. می‌توان از UUID دامنه نیز به جای نام استفاده کرد.
هنگام درخواست کلیدها و گذرواژه‌ها، virt-get-kernel معمولاً پژواک ورودی را خاموش می‌کند تا آنچه را تایپ می‌کنید نبینید. اگر نگران حملات Tempest نیستید و فرد دیگری در اتاق حضور ندارد، می‌توانید این پرچم را مشخص کنید تا ورودی تایپ‌شده را مشاهده کنید.
حالت پیش‌فرض برای گزینه -a تشخیص خودکار فرمت ایمیج دیسک است. استفاده از این گزینه، فرمت دیسک را برای گزینه -a در خط فرمان اجباری می‌کند.

اگر ایمیج‌های دیسک مهمان نامطمئن با فرمت خام (raw) دارید، باید از این گزینه برای مشخص کردن فرمت دیسک استفاده کنید. این کار از یک مشکل امنیتی احتمالی با مهمان‌های مخرب جلوگیری می‌کند (CVE-2010-3851).

مشخص کردن کلید برای LUKS، جهت باز کردن خودکار یک دستگاه LUKS هنگام بازرسی.
"NAME" نام دستگاه در libguestfs است (مانند "/dev/sda1"). "UUID" شناسه یکتای (UUID) دستگاه است. "all" به معنی آزمودن کلید روی هر دستگاه رمزنگاری‌شده است.

استفاده از "KEY_STRING" مشخص‌شده به عنوان گذرواژه.

خواندن گذرواژه از FILENAME.
تلاش برای بازگشایی قفل دستگاه بدون گذرواژه از طریق Clevis روی شبکه. لطفاً برای اطلاعات بیشتر درباره رمزنگاری دیسک وابسته به شبکه (NBDE)، بخش "ENCRYPTED DISKS" در guestfs(3) را ببینید.

توجه داشته باشید که در صورت وجود چنین گزینه‌ای در خط فرمان، شبکه کاربری QEMU به طور خودکار برای ماشین مجاز libguestfs فعال خواهد شد.

خواندن پارامترهای کلید یا گذرواژه از ورودی استاندارد (stdin). حالت پیش‌فرض تلاش برای خواندن گذرواژه‌ها از کاربر با باز کردن /dev/tty است.

اگر چندین دستگاه رمزنگاری‌شده وجود داشته باشد، ممکن است لازم باشد چندین کلید در stdin ارائه دهید، هر کدام در یک خط.

این گزینه برای ایجاد خروجی مناسب‌تر جهت پردازش ماشین هنگام فراخوانی توسط سایر برنامه‌ها استفاده می‌شود. بخش "خروجی ماشین‌خوان (MACHINE READABLE OUTPUT)" در زیر را ببینید.
این گزینه دایرکتوری خروجی را که کرنل و initramfs مهمان در آن نوشته می‌شوند مشخص می‌کند.

اگر مشخص نشود، خروجی پیش‌فرض دایرکتوری جاری است.

این گزینه یک پیشوند برای فایل‌های استخراج‌شده مشخص می‌کند.

اگر پیشوند مشخص شده باشد، یک خط تیره ("-") پس از پیشوند و قبل از ادامه نام فایل قرار خواهد گرفت؛ به عنوان مثال، کرنلی در مهمان مانند "vmlinuz-3.19.0-20-generic" هنگامی که پیشوند "mydistro" باشد، به صورت "mydistro-vmlinuz-3.19.0-20-generic" ذخیره می‌شود.

همچنین --unversioned-names را ببینید.

پیام‌های پیشرفت معمول چاپ نشود.
این گزینه بر نام فایل مقصد برای فایل‌های استخراج‌شده تأثیر می‌گذارد.

در صورت فعال بودن، فایل‌ها در محیط محلی صرفاً با نام پایه ذخیره می‌شوند؛ برای نمونه، کرنل و ramdisk در مهمان مانند "vmlinuz-3.19.0-20-generic" و "initrd.img-3.19.0-20-generic" به ترتیب به عنوان "vmlinuz" و "initrd.img" ذخیره می‌شوند.

همچنین --prefix را ببینید.

فعال کردن پیام‌های پرجزئیات برای اشکال‌زدایی.
نمایش شماره نسخه و خروج.
شکستن خطوط پیام‌های خطا، هشدار و اطلاعاتی. این رفتار پیش‌فرض هنگام ارسال خروجی به tty است. اگر خروجی برنامه به یک فایل هدایت شود، شکستن خطوط غیرفعال می‌شود مگر اینکه از این گزینه استفاده کنید.
فعال کردن ردگیری فراخوانی‌های API در libguestfs.

گزینه --machine-readable می‌تواند برای مناسب‌تر کردن خروجی برای ماشین استفاده شود، که هنگام فراخوانی virt-get-kernel از دیگر برنامه‌ها، رابط‌های گرافیکی (GUI) و غیره کاربرد دارد.

از این گزینه به تنهایی برای استعلام قابلیت‌های باینری virt-get-kernel استفاده کنید. خروجی معمولی به این صورت است:

$ virt-get-kernel --machine-readable
virt-get-kernel

فهرستی از ویژگی‌ها چاپ می‌شود (هر خط یک ویژگی) و برنامه با وضعیت ۰ خارج می‌شود.

امکان تعیین یک رشته قالب برای کنترل خروجی وجود دارد؛ بخش "ADVANCED MACHINE READABLE OUTPUT" در guestfs(3) را ببینید.

برای سایر متغیرهای محیطی که بر تمام برنامه‌های libguestfs تأثیر می‌گذارند، بخش "ENVIRONMENT VARIABLES" در guestfs(3) را ببینید.

این برنامه در صورت موفقیت ۰ و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند.

guestfs(3), guestfish(1), guestmount(1), virt-copy-out(1), virt-drivers(1), http://libguestfs.org.

Richard W.M. Jones http://people.redhat.com/~rjones

Copyright (C) 2013-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-11 guestfs-tools-1.56.0