virt-format(1) Virtualization Support virt-format(1)

virt-format - پاکسازی و فرمت‌بندی دیسک‌های ماشین مجازی

virt-format [--options] -a disk.img [-a disk.img ...]

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

دستور virt-format یک فایل دیسک موجود (یا پارتیشن میزبان، LV و غیره) را می‌گیرد، تمام داده‌های موجود روی آن را پاک می‌کند و آن را به عنوان یک دیسک خام فرمت‌بندی می‌نماید. این ابزار به صورت اختیاری می‌تواند جدول‌های پارتیشن، سیستم‌فایل‌های خالی، حجم‌های منطقی و موارد دیگر بسازد.

برای ساخت دیسکی که حاوی داده باشد، بهتر است از virt-make-fs(1) استفاده کنید. اگر در حال ساخت دیسک خامی برای استفاده در guestfish(1) هستید، باید به جای این ابزار از گزینه -N در guestfish استفاده نمایید.

نحوه استفاده معمول به شکل زیر است:

virt-format -a disk.qcow

یا به این صورت:

virt-format -a /dev/VG/LV

فایل‌های disk.qcow یا /dev/VG/LV باید از قبل وجود داشته باشند. هرگونه داده روی این دیسک‌ها با این دستورات پاک خواهد شد. این دستورات یک پارتیشن خالی منفرد سرتاسر دیسک بدون هیچ سیستم‌فایلی درون آن ایجاد می‌کنند.

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

ساخت یک سیستم‌فایل خالی ("ext3"، "ntfs" و غیره) درون پارتیشن.
ساخت یک حجم منطقی Linux LVM2 روی دیسک. هنگام استفاده همزمان با --filesystem، سیستم‌فایل درون LV ساخته می‌شود.

برای کسب اطلاعات بیشتر درباره این گزینه‌ها و گزینه‌های دیگر، بخش «گزینه‌ها (OPTIONS)» در ادامه را ببینید.

فرمت دیسک معمولاً به صورت خودکار تشخیص داده می‌شود، اما می‌توانید با استفاده از گزینه --format (به زیر مراجعه کنید) آن را اجباری نمایید. در شرایطی که به محتوای موجود دیسک اعتماد ندارید، توصیه می‌شود از این گزینه برای جلوگیری از سوءاستفاده‌های امنیتی احتمالی استفاده کنید.

نمایش راهنمای مختصر.
افزودن file، که می‌تواند تصویر دیسک، پارتیشن میزبان، LV، دیسک USB خارجی و غیره باشد.

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

هرگونه داده موجود روی دیسک پاک می‌شود.

افزودن دیسک راه دور. بخش "ADDING REMOTE STORAGE" را در guestfish(1) ببینید.
این پارامتر اندازه سکتور تصویر دیسک را تنظیم می‌کند. این مقدار روی تمام دیسک‌های بعدی که به صورت صریح پس از این پارامتر اضافه شوند اثر می‌گذارد. استفاده از --blocksize بدون آرگومان، اندازه سکتور دیسک را به مقدار پیش‌فرض که معمولاً ۵۱۲ بایت است بازمی‌گرداند. همچنین "guestfs_add_drive_opts" را در guestfs(3) ببینید.
ساخت یک سیستم‌فایل خالی از نوع مشخص‌شده. انواع بسیاری از سیستم‌فایل‌ها توسط libguestfs پشتیبانی می‌شوند.
هیچ سیستم‌فایلی ساخته نشود. این حالت پیش‌فرض است.
حالت پیش‌فرض برای گزینه -a تشخیص خودکار فرمت تصویر دیسک است. استفاده از این گزینه فرمت دیسک را برای گزینه‌های -a بعدی در خط فرمان اجباری می‌کند. استفاده از --format بدون آرگومان، حالت را برای گزینه‌های -a بعدی دوباره به تشخیص خودکار بازمی‌گرداند.

به عنوان مثال:

virt-format --format=raw -a disk.img

فرمت raw (بدون تشخیص خودکار) را برای disk.img اجباری می‌کند.

virt-format --format=raw -a disk.img --format -a another.img

فرمت raw (بدون تشخیص خودکار) را برای disk.img اجباری کرده و برای another.img به تشخیص خودکار بازمی‌گردد.

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

تنظیم برچسب (Label) سیستم‌فایل.
ساخت یک حجم منطقی Linux LVM2 به نام /dev/VG/LV. می‌توانید نام گروه حجم (Volume Group) و حجم منطقی را تغییر دهید.
ساخت یک حجم منطقی Linux LVM2 با نام پیش‌فرض (/dev/VG/LV).
هیچ حجم منطقی ساخته نشود. این حالت پیش‌فرض است.
ساخت یک پارتیشن MBR یا GPT در سرتاسر دیسک. اگر اندازه دیسک کمتر از ۲ ترابایت باشد MBR و اگر بزرگتر یا مساوی ۲ ترابایت باشد GPT انتخاب می‌شود.

این حالت پیش‌فرض است.

ساخت پارتیشن GPT.
ساخت پارتیشن MBR.
هیچ جدول پارتیشنی ساخته نشود. توجه داشته باشید که ویندوز ممکن است نتواند این دیسک‌ها را شناسایی کند.
فعال‌سازی پیام‌های پرجزئیات برای اشکال‌زدایی.
نمایش شماره نسخه و خروج.
در حالت عادی virt-format داده‌ها را از روی دیسک به طور کامل پاکسازی (Wipe) نمی‌کند (چون زمان زیادی می‌برد). بنابراین اگر داده‌ای روی دیسک باشد، فقط مخفی شده و بخشی از آن توسط virt-format بازنویسی می‌شود، و ممکن است توسط ابزارهای ویرایش دیسک قابل بازیابی باشد.

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

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

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

guestfs(3), guestfish(1), virt-filesystems(1), virt-make-fs(1), virt-rescue(1), virt-resize(1), http://libguestfs.org.

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

Copyright (C) 2012 Red Hat Inc.

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

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

شما باید همراه با این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزارهای آزاد به آدرس زیر بنویسید: 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