.\" -*- 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-drivers 1"
.TH virt-drivers 1 2026-07-11 guestfs-tools-1.56.0 "پشتیبانی از مجازی‌سازی"
.\" 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\-drivers \- راهنما و درایورهای پشتیبانی‌شده در ماشین مجازی
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& virt\-drivers [\-\-options] \-d domname
\&
\& virt\-drivers [\-\-options] \-a disk.img
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این ابزار می‌تواند بوت‌لودر، هسته و درایورهای درون برخی سیستم‌های مهمان را تنها از روی ایمیج دیسک تشخیص دهد. به عنوان مثال، می‌تواند تشخیص دهد که آیا یک ایمیج دیسک برای بوت به BIOS یا UEFI نیاز دارد، و آیا از virtio پشتیبانی می‌کند یا به دستگاه‌های شبیه‌سازی‌شده کُندتر نیاز دارد.
.SS "نکات (Notes)"
.IX Subsection "Notes"
به‌طور معمول باید متادیتای هایپروایزر (مانند libvirt XML یا OVF) را در کنار ایمیج‌های دیسک توزیع کنید تا نحوه بوت آن‌ها را به هایپروایزر مشخص کند. این ابزار زمانی استفاده می‌شود که این متادیتا ارائه نشده باشد. با ارائه‌دهنده ایمیج دیسک همکاری کنید تا متادیتای مناسب را در اختیارتان قرار دهد.
.SH "قالب XML (XML FORMAT)"
.IX Header "XML FORMAT"
خروجی یک سند XML است. در بالاترین سطح، سیستم‌عامل‌های یافت‌شده را فهرست می‌کند (مشابه \fBvirt\-inspector\fR\|(1)):
.PP
.Vb 10
\&
\&
\& /dev/sda2
\& linux
\& x86_64
\& fedora
\& ...
\&
\&
\& /dev/sdb1
\& ...
\&
\&
.Ve
.SS
.IX Subsection ""
عنصر سفت‌افزاری (فریم‌ور) را که برای بوت سیستم مهمان لازم است فهرست می‌کند. برای UEFI، علاوه بر این پارتیشن سیستمی EFI (یا «ESP») را نیز نمایش می‌دهد. سیستم‌های مهمان ممکن است از چندین فریم‌ور بوت پشتیبانی کنند. برای مثال، این مهمان شناسایی شده که از بوت UEFI استفاده می‌کند و ESP مربوط به UEFI اولین پارتیشن از دیسک اول است:
.PP
.Vb 4
\&
\& /dev/sda1
\&
\& ...
.Ve
.SS " و "
.IX Subsection " and "
عنصر بوت‌لودر یافت‌شده در مهمان لینوکس را نشان می‌دهد. در صورت مشخص بودن، ممکن است حاوی اطلاعاتی درباره هسته‌های لینوکس ارائه‌شده باشد. برای مثال:
.PP
.Vb 10
\&
\&
\&
\& /dev/sda2
\& linux
\& ...
\&
\&
\& kernel
\& 6.1.0\-0.rc6.46.fc38.x86_64
\& /boot/vmlinuz\-6.1.0\-0.rc6.46.fc38.x86_64
\&
\& ...
\&
\&
\&
\& ...
\&
\&
\&
.Ve
.PP
معمولاً فیلدهای بسیار بیشتری برای سیستم‌های مهمان لینوکس در دسترس است، از جمله فهرست کاملی از ماژول‌های هسته و اطلاعات مربوط به پشتیبانی از virtio. برای یک مثال کامل ببینید:
https://github.com/libguestfs/guestfs\-tools/tree/master/drivers
.SS
.IX Subsection ""
عنصر اطلاعات مربوط به درایورهای یافت‌شده در مهمان‌های ویندوز را فهرست می‌کند:
.PP
.Vb 10
\&
\&
\&
\& /dev/sda2
\& windows
\& ...
\&
\&
\& scsidev
\&
\&
\&
\& ...
\&
\&
.Ve
.PP
نام درایور (مانند \f(CW\*(C`scsidev\*(C'\fR) با فایل \fI.INF\fR درایور ویندوز (مانند \fIscsidev.inf\fR) مطابقت دارد. فهرست دستگاه‌های PCI، USB و غیره، دستگاه‌های منطبقی هستند که باعث بارگذاری این درایور هنگام بوت می‌شوند.
.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\-drivers معمولاً نمایش کاراکترها را خاموش می‌کند تا نتوانید آنچه تایپ می‌کنید را ببینید. اگر نگران حملات تمپست (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 شناسه یکتای دستگاه است. \&\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\-q\fR 4
.IX Item "-q"
.PD 0
.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
عدم چاپ پیام‌های معمول پیشرفت.
.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 "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.IX Header "ENVIRONMENT VARIABLES"
برای مشاهده سایر متغیرهای محیطی که بر تمام برنامه‌های libguestfs تأثیر می‌گذارند، به بخش "ENVIRONMENT VARIABLES" در \fBguestfs\fR\|(3) مراجعه کنید.
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "EXIT STATUS"
این برنامه در صورت موفقیت مقدار 0 و در صورت بروز خطا مقداری غیر از صفر را برمی‌گرداند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBguestfs\fR\|(3),
\&\fBguestfish\fR\|(1),
\&\fBguestmount\fR\|(1),
\&\fBvirt\-get\-kernel\fR\|(1),
\&\fBvirt\-inspector\fR\|(1),
\&\fBvirt\-v2v\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) 2009\-2025 Red Hat Inc.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه 2 پروانه و چه (به انتخاب خودتان) هر نسخه بالاتر دیگری، بازتوزیع کرده یا تغییر دهید.
.PP
این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «پروانه عمومی همگانی گنو» مراجعه کنید.
.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 آن را در گزارش اشکال الصاق نمایید.