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


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

خلاصه دستور (SYNOPSIS)
        virt-get-kernel [--options] -d domname

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

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

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

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

گزینه‌ها (OPTIONS)
       --help
           نمایش راهنما.

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

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

       -a URI
       --add URI
           افزودن یک دیسک از راه دور. فرمت URI با guestfish سازگار است. بخش
           "ADDING REMOTE STORAGE" در guestfish(1) را ببینید.

       --blocksize 512
       --blocksize 4096
           این پارامتر اندازه سکتور ایمیج دیسک اضافه شده با گزینه -a را تعیین
           می‌کند و برای مهمان libvirt اضافه شده با گزینه -d نادیده گرفته
           می‌شود. همچنین بخش "guestfs_add_drive_opts" در guestfs(3) را ببینید.

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

       -c URI
       --connect URI
           در صورت استفاده از libvirt، به URI داده‌شده متصل می‌شود. در صورت عدم
           ذکر، به هایپروایزر پیش‌فرض libvirt متصل می‌شویم.

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

       -d guest
       --domain guest
           افزودن تمام دیسک‌ها از مهمان libvirt نام‌برده‌شده. می‌توان از UUID
           دامنه نیز به جای نام استفاده کرد.

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

       --format raw|qcow2|..
       --format auto
           حالت پیش‌فرض برای گزینه -a تشخیص خودکار فرمت ایمیج دیسک است. استفاده
           از این گزینه، فرمت دیسک را برای گزینه -a در خط فرمان اجباری می‌کند.

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

       --key SELECTOR
           مشخص کردن کلید برای LUKS، جهت باز کردن خودکار یک دستگاه LUKS هنگام
           بازرسی.

           --key NAME:key:KEY_STRING
           --key UUID:key:KEY_STRING
           --key all:key:KEY_STRING
               "NAME" نام دستگاه در libguestfs است (مانند "/dev/sda1").
               "UUID" شناسه یکتای (UUID) دستگاه است.  "all" به معنی آزمودن
               کلید روی هر دستگاه رمزنگاری‌شده است.

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

           --key NAME:file:FILENAME
           --key UUID:file:FILENAME
           --key all:file:FILENAME
               خواندن گذرواژه از FILENAME.

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

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

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

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

       --machine-readable
       --machine-readable=format
           این گزینه برای ایجاد خروجی مناسب‌تر جهت پردازش ماشین هنگام فراخوانی
           توسط سایر برنامه‌ها استفاده می‌شود. بخش "خروجی ماشین‌خوان (MACHINE
           READABLE OUTPUT)" در زیر را ببینید.

       -o directory
       --output directory
           این گزینه دایرکتوری خروجی را که کرنل و initramfs مهمان در آن نوشته
           می‌شوند مشخص می‌کند.

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

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

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

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

       -q
       --quiet
           پیام‌های پیشرفت معمول چاپ نشود.

       --unversioned-names
           این گزینه بر نام فایل مقصد برای فایل‌های استخراج‌شده تأثیر می‌گذارد.

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

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

       -v
       --verbose
           فعال کردن پیام‌های پرجزئیات برای اشکال‌زدایی.

       -V
       --version
           نمایش شماره نسخه و خروج.

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

       -x  فعال کردن ردگیری فراخوانی‌های API در libguestfs.

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

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

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

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

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

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

وضعیت خروج (EXIT STATUS)
       این برنامه در صورت موفقیت ۰ و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند.

همچنین ببینید (SEE ALSO)
       guestfs(3), guestfish(1), guestmount(1), virt-copy-out(1),
       virt-drivers(1), http://libguestfs.org.

نویسنده (AUTHOR)
       Richard W.M. Jones http://people.redhat.com/~rjones

حق نشر (COPYRIGHT)
       Copyright (C) 2013-2025 Red Hat Inc.

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

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

       شما باید یک نسخه از مجوز عمومی همگانی گنو را همراه با این برنامه دریافت
       کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزار آزاد به آدرس زیر
       بنویسید:

       Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

اشکالات (BUGS)
       برای دریافت فهرستی از اشکالات مرتبط با 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) را اجرا کرده و خروجی کامل و
           ویرایش‌نشده را در گزارش اشکال قرار دهید.

guestfs-tools-1.56.0              2026-07-11                virt-get-kernel(1)