.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 1.56.0 (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 "virt-get-kernel 1"
.TH virt-get-kernel 1 2026-07-11 guestfs-tools-1.56.0 "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)"
virt\-get\-kernel \- استخراج کرنل و initramfs از ایمیج دیسک
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& virt\-get\-kernel [\-\-options] \-d domname
\&
\& virt\-get\-kernel [\-\-options] \-a disk.img
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این برنامه کرنل و initramfs را از یک ماشین مهمان استخراج می‌کند.
.PP
فرمت ایمیج دیسک به صورت خودکار تشخیص داده می‌شود مگر اینکه آن را با استفاده از گزینه
\fI\-\-format\fR
مشخص کنید.
.PP
در صورتی که ماشین مهمان شامل چندین کرنل باشد، کرنلی با بالاترین شماره نسخه انتخاب می‌شود. برای استخراج کرنل‌های دلخواه از ایمیج دیسک،
\fBguestfish\fR\|(1)
را ببینید. برای استخراج کل دایرکتوری
\&\f(CW\*(C`/boot\*(C'\fR
یک ماشین مهمان،
\fBvirt\-copy\-out\fR\|(1)
را ببینید.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش راهنما.
.IP "\fB\-a\fR file" 4
.IX Item "-a file"
.PD 0
.IP "\fB\-\-add\fR file" 4
.IX Item "--add file"
.PD
افزودن
\fIfile\fR
که باید یک ایمیج دیسک از یک ماشین مجازی باشد.
.Sp
فرمت ایمیج دیسک به صورت خودکار تشخیص داده می‌شود. برای لغو این رفتار و تحمیل یک فرمت خاص، از گزینه
\fI\-\-format\fR
استفاده کنید.
.IP "\fB\-a\fR URI" 4
.IX Item "-a URI"
.PD 0
.IP "\fB\-\-add\fR URI" 4
.IX Item "--add URI"
.PD
افزودن یک دیسک از راه دور. فرمت URI با guestfish سازگار است. بخش "ADDING REMOTE STORAGE" در
\fBguestfish\fR\|(1)
را ببینید.
.IP "\fB\-\-blocksize\fR \fB512\fR" 4
.IX Item "--blocksize 512"
.PD 0
.IP "\fB\-\-blocksize\fR \fB4096\fR" 4
.IX Item "--blocksize 4096"
.PD
این پارامتر اندازه سکتور ایمیج دیسک اضافه شده با گزینه
\fI\-a\fR
را تعیین می‌کند و برای مهمان libvirt اضافه شده با گزینه
\fI\-d\fR
نادیده گرفته می‌شود. همچنین بخش "guestfs_add_drive_opts" در
\fBguestfs\fR\|(3)
را ببینید.
.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
استفاده از توالی‌های رنگی ANSI برای رنگ‌آمیزی پیام‌ها. این حالت پیش‌فرض هنگام ارسال خروجی به tty است. اگر خروجی برنامه به یک فایل هدایت شود، توالی‌های رنگی ANSI غیرفعال می‌شوند مگر اینکه از این گزینه استفاده کنید.
.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
در صورت استفاده از libvirt، به
\fIURI\fR
داده‌شده متصل می‌شود. در صورت عدم ذکر، به هایپروایزر پیش‌فرض libvirt متصل می‌شویم.
.Sp
اگر دستگاه‌های بلوکی مهمان را مستقیماً مشخص کنید (\fI\-a\fR)، libvirt اصلاً استفاده نمی‌شود.
.IP "\fB\-d\fR guest" 4
.IX Item "-d guest"
.PD 0
.IP "\fB\-\-domain\fR guest" 4
.IX Item "--domain guest"
.PD
افزودن تمام دیسک‌ها از مهمان libvirt نام‌برده‌شده. می‌توان از UUID دامنه نیز به جای نام استفاده کرد.
.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
هنگام درخواست کلیدها و گذرواژه‌ها، virt\-get\-kernel معمولاً پژواک ورودی را خاموش می‌کند تا آنچه را تایپ می‌کنید نبینید. اگر نگران حملات Tempest نیستید و فرد دیگری در اتاق حضور ندارد، می‌توانید این پرچم را مشخص کنید تا ورودی تایپ‌شده را مشاهده کنید.
.IP "\fB\-\-format\fR raw|qcow2|.." 4
.IX Item "--format raw|qcow2|.."
.PD 0
.IP "\fB\-\-format\fR auto" 4
.IX Item "--format auto"
.PD
حالت پیش‌فرض برای گزینه
\fI\-a\fR
تشخیص خودکار فرمت ایمیج دیسک است. استفاده از این گزینه، فرمت دیسک را برای گزینه
\fI\-a\fR
در خط فرمان اجباری می‌کند.
.Sp
اگر ایمیج‌های دیسک مهمان نامطمئن با فرمت خام (raw) دارید، باید از این گزینه برای مشخص کردن فرمت دیسک استفاده کنید. این کار از یک مشکل امنیتی احتمالی با مهمان‌های مخرب جلوگیری می‌کند (CVE\-2010\-3851).
.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
مشخص کردن کلید برای LUKS، جهت باز کردن خودکار یک دستگاه LUKS هنگام بازرسی.
.RS 4
.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
.IX Item "--key NAME:key:KEY_STRING"
.PD 0
.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
.IX Item "--key UUID:key:KEY_STRING"
.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
.IX Item "--key all:key:KEY_STRING"
.PD
\&\f(CW\*(C`NAME\*(C'\fR
نام دستگاه در libguestfs است (مانند
\f(CW\*(C`/dev/sda1\*(C'\fR).
\&\f(CW\*(C`UUID\*(C'\fR
شناسه یکتای (UUID) دستگاه است.
\&\f(CW\*(C`all\*(C'\fR
به معنی آزمودن کلید روی هر دستگاه رمزنگاری‌شده است.
.Sp
استفاده از
\f(CW\*(C`KEY_STRING\*(C'\fR
مشخص‌شده به عنوان گذرواژه.
.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
.IX Item "--key NAME:file:FILENAME"
.PD 0
.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
.IX Item "--key UUID:file:FILENAME"
.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
.IX Item "--key all:file:FILENAME"
.PD
خواندن گذرواژه از
\fIFILENAME\fR.
.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
.IX Item "--key NAME:clevis"
.PD 0
.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
.IX Item "--key UUID:clevis"
.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
.IX Item "--key all:clevis"
.PD
تلاش برای بازگشایی قفل دستگاه بدون گذرواژه از طریق Clevis روی شبکه. لطفاً برای اطلاعات بیشتر درباره رمزنگاری دیسک وابسته به شبکه (NBDE)، بخش "ENCRYPTED DISKS" در
\fBguestfs\fR\|(3)
را ببینید.
.Sp
توجه داشته باشید که در صورت وجود چنین گزینه‌ای در خط فرمان، شبکه کاربری QEMU به طور خودکار برای ماشین مجاز libguestfs فعال خواهد شد.
.RE
.RS 4
.RE
.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
خواندن پارامترهای کلید یا گذرواژه از ورودی استاندارد (stdin). حالت پیش‌فرض تلاش برای خواندن گذرواژه‌ها از کاربر با باز کردن
\fI/dev/tty\fR
است.
.Sp
اگر چندین دستگاه رمزنگاری‌شده وجود داشته باشد، ممکن است لازم باشد چندین کلید در stdin ارائه دهید، هر کدام در یک خط.
.IP \fB\-\-machine\-readable\fR 4
.IX Item "--machine-readable"
.PD 0
.IP \fB\-\-machine\-readable\fR=format 4
.IX Item "--machine-readable=format"
.PD
این گزینه برای ایجاد خروجی مناسب‌تر جهت پردازش ماشین هنگام فراخوانی توسط سایر برنامه‌ها استفاده می‌شود. بخش
"خروجی ماشین‌خوان (MACHINE READABLE OUTPUT)"
در زیر را ببینید.
.IP "\fB\-o\fR directory" 4
.IX Item "-o directory"
.PD 0
.IP "\fB\-\-output\fR directory" 4
.IX Item "--output directory"
.PD
این گزینه دایرکتوری خروجی را که کرنل و initramfs مهمان در آن نوشته می‌شوند مشخص می‌کند.
.Sp
اگر مشخص نشود، خروجی پیش‌فرض دایرکتوری جاری است.
.IP "\fB\-\-prefix\fR prefix" 4
.IX Item "--prefix prefix"
این گزینه یک پیشوند برای فایل‌های استخراج‌شده مشخص می‌کند.
.Sp
اگر پیشوند مشخص شده باشد، یک خط تیره (\f(CW\*(C`\-\*(C'\fR) پس از پیشوند و قبل از ادامه نام فایل قرار خواهد گرفت؛ به عنوان مثال، کرنلی در مهمان مانند
\f(CW\*(C`vmlinuz\-3.19.0\-20\-generic\*(C'\fR
هنگامی که پیشوند
\f(CW\*(C`mydistro\*(C'\fR
باشد، به صورت
\f(CW\*(C`mydistro\-vmlinuz\-3.19.0\-20\-generic\*(C'\fR
ذخیره می‌شود.
.Sp
همچنین
\fI\-\-unversioned\-names\fR
را ببینید.
.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
پیام‌های پیشرفت معمول چاپ نشود.
.IP \fB\-\-unversioned\-names\fR 4
.IX Item "--unversioned-names"
این گزینه بر نام فایل مقصد برای فایل‌های استخراج‌شده تأثیر می‌گذارد.
.Sp
در صورت فعال بودن، فایل‌ها در محیط محلی صرفاً با نام پایه ذخیره می‌شوند؛ برای نمونه، کرنل و ramdisk در مهمان مانند
\f(CW\*(C`vmlinuz\-3.19.0\-20\-generic\*(C'\fR
و
\f(CW\*(C`initrd.img\-3.19.0\-20\-generic\*(C'\fR
به ترتیب به عنوان
\f(CW\*(C`vmlinuz\*(C'\fR
و
\f(CW\*(C`initrd.img\*(C'\fR
ذخیره می‌شوند.
.Sp
همچنین
\fI\-\-prefix\fR
را ببینید.
.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
فعال کردن پیام‌های پرجزئیات برای اشکال‌زدایی.
.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
نمایش شماره نسخه و خروج.
.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
شکستن خطوط پیام‌های خطا، هشدار و اطلاعاتی. این رفتار پیش‌فرض هنگام ارسال خروجی به tty است. اگر خروجی برنامه به یک فایل هدایت شود، شکستن خطوط غیرفعال می‌شود مگر اینکه از این گزینه استفاده کنید.
.IP \fB\-x\fR 4
.IX Item "-x"
فعال کردن ردگیری فراخوانی‌های API در libguestfs.
.SH "خروجی ماشین‌خوان (MACHINE READABLE OUTPUT)"
.IX Header "MACHINE READABLE OUTPUT"
گزینه
\fI\-\-machine\-readable\fR
می‌تواند برای مناسب‌تر کردن خروجی برای ماشین استفاده شود، که هنگام فراخوانی virt\-get\-kernel از دیگر برنامه‌ها، رابط‌های گرافیکی (GUI) و غیره کاربرد دارد.
.PP
از این گزینه به تنهایی برای استعلام قابلیت‌های باینری virt\-get\-kernel استفاده کنید. خروجی معمولی به این صورت است:
.PP
.Vb 2
\& $ virt\-get\-kernel \-\-machine\-readable
\& virt\-get\-kernel
.Ve
.PP
فهرستی از ویژگی‌ها چاپ می‌شود (هر خط یک ویژگی) و برنامه با وضعیت ۰ خارج می‌شود.
.PP
امکان تعیین یک رشته قالب برای کنترل خروجی وجود دارد؛ بخش "ADVANCED MACHINE READABLE OUTPUT" در
\fBguestfs\fR\|(3)
را ببینید.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.IX Header "ENVIRONMENT VARIABLES"
برای سایر متغیرهای محیطی که بر تمام برنامه‌های libguestfs تأثیر می‌گذارند، بخش "ENVIRONMENT VARIABLES" در
\fBguestfs\fR\|(3)
را ببینید.
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "EXIT STATUS"
این برنامه در صورت موفقیت ۰ و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBguestfs\fR\|(3),
\&\fBguestfish\fR\|(1),
\&\fBguestmount\fR\|(1),
\&\fBvirt\-copy\-out\fR\|(1),
\&\fBvirt\-drivers\fR\|(1),
http://libguestfs.org.
.SH "نویسنده (AUTHOR)"
.IX Header "AUTHOR"
Richard W.M. Jones http://people.redhat.com/~rjones
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright (C) 2013\-2025 Red Hat Inc.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزار آزاد منتشر شده است بازتوزیع کرده یا تغییر دهید؛ یا نسخه ۲ مجوز، یا (به انتخاب خودتان) هر نسخه بعدی.
.PP
این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر مجوز عمومی همگانی گنو را ببینید.
.PP
شما باید یک نسخه از مجوز عمومی همگانی گنو را همراه با این برنامه دریافت کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزار آزاد به آدرس زیر بنویسید:
.PP
.nf
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA
.fi
.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
را در گزارش اشکال قرار دهید.