نام (NAME)

virt-drivers - راهنما و درایورهای پشتیبانی‌شده در ماشین مجازی

خلاصه دستور (SYNOPSIS)

virt-drivers [--options] -d domname
virt-drivers [--options] -a disk.img

توضیحات (DESCRIPTION)

این ابزار می‌تواند بوت‌لودر، هسته و درایورهای درون برخی سیستم‌های مهمان را تنها از روی ایمیج دیسک تشخیص دهد. به عنوان مثال، می‌تواند تشخیص دهد که آیا یک ایمیج دیسک برای بوت به BIOS یا UEFI نیاز دارد، و آیا از virtio پشتیبانی می‌کند یا به دستگاه‌های شبیه‌سازی‌شده کُندتر نیاز دارد.

قالب XML (XML FORMAT)

خروجی یک سند XML است. در بالاترین سطح، سیستم‌عامل‌های یافت‌شده را فهرست می‌کند (مشابه virt-inspector(1)):

<operatingsystems>
  <operatingsystem>
    <root>/dev/sda2</root>
    <name>linux</name>
    <arch>x86_64</arch>
    <distro>fedora</distro>
    ...
  </operatingsystem>
  <operatingsystem>
    <root>/dev/sdb1</root>
    ...
  </operatingsystem>
</operatingsystems>

<operatingsystems>
  <firmware type='uefi'>/dev/sda1</firmware>
  <operatingsystem>
    ...

<operatingsystems>
  <firmware type='bios'/>
  <operatingsystem>
    <root>/dev/sda2</root>
    <name>linux</name>
    ...
    <bootloader type='grub2' config='/boot/grub2/grub.cfg'>
      <kernel>
        <name>kernel</name>
        <version>6.1.0-0.rc6.46.fc38.x86_64</version>
        <vmlinuz>/boot/vmlinuz-6.1.0-0.rc6.46.fc38.x86_64</vmlinuz>
        <modules>
          ...
        </modules>
        <supports_virtio_blk/>
        <supports_virtio_net/>
        ...
      </kernel>
    </bootloader>
</operatingsystems>

<operatingsystems>
  <firmware type='bios'/>
  <operatingsystem>
    <root>/dev/sda2</root>
    <name>windows</name>
    ...
    <drivers>
      <driver>
        <name>scsidev</name>
        <pci vendor='1077' device='1216' subsystem='8471101E'/>
        <pci vendor='1077' device='1216' subsystem='8493101E'/>
      </driver>
      ...
    </drivers>
</operatingsystems>

گزینه‌ها (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-drivers معمولاً نمایش کاراکترها را خاموش می‌کند تا نتوانید آنچه تایپ می‌کنید را ببینید. اگر نگران حملات تمپست (Tempest) نیستید و شخص دیگری در اتاق حضور ندارد، می‌توانید این فلگ را مشخص کنید تا ورودی تایپ‌شده را مشاهده کنید.

--format raw|qcow2|..

--format auto

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

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

--key SELECTOR

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

--keys-from-stdin

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

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

-q

--quiet

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

-v

--verbose

فعال‌سازی پیام‌های پرجزئیات برای اشکال‌زدایی.

-V

--version

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

--wrap

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

-x

فعال‌سازی ردیابی فراخوانی‌های API در libguestfs.

متغیرهای محیطی (ENVIRONMENT VARIABLES)

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

وضعیت خروج (EXIT STATUS)

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

همچنین ببینید (SEE ALSO)

guestfs(3), guestfish(1), guestmount(1), virt-get-kernel(1), virt-inspector(1), virt-v2v(1), http://libguestfs.org

نویسنده (AUTHOR)

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

حق نشر (COPYRIGHT)

Copyright (C) 2009-2025 Red Hat Inc.

مجوز (LICENSE)

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه 2 پروانه و چه (به انتخاب خودتان) هر نسخه بالاتر دیگری، بازتوزیع کرده یا تغییر دهید.

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

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

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