.\" -*- 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-format 1"
.TH virt-format 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\-format \- پاکسازی و فرمت‌بندی دیسک‌های ماشین مجازی
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& virt\-format [\-\-options] \-a disk.img [\-a disk.img ...]
.Ve
.SH "هشدار (WARNING)"
.IX Header "WARNING"
استفاده از
\f(CW\*(C`virt\-format\*(C'\fR
روی ماشین‌های مجازی در حال اجرا، یا به صورت همزمان با دیگر ابزارهای ویرایش دیسک، می‌تواند خطرناک باشد و به خراب شدن دیسک بینجامد. پیش از استفاده از این دستور، ماشین مجازی باید خاموش شود و تصاویر دیسک نباید به طور همزمان ویرایش شوند.
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
.B virt\-format
یک فایل دیسک موجود (یا پارتیشن میزبان، LV و غیره) را می‌گیرد،
\fBتمام داده‌های موجود روی آن را پاک می‌کند\fR
و آن را به عنوان یک دیسک خام فرمت‌بندی می‌نماید. این ابزار به صورت اختیاری می‌تواند جدول‌های پارتیشن، سیستم‌فایل‌های خالی، حجم‌های منطقی و موارد دیگر بسازد.
.PP
برای ساخت دیسکی که حاوی داده باشد، بهتر است از
\&\fBvirt\-make\-fs\fR\|(1)
استفاده کنید. اگر در حال ساخت دیسک خامی برای استفاده در
\&\fBguestfish\fR\|(1)
هستید، باید به جای این ابزار از گزینه
\fI\-N\fR
در guestfish استفاده نمایید.
.PP
نحوه استفاده معمول به شکل زیر است:
.PP
.Vb 1
\& virt\-format \-a disk.qcow
.Ve
.PP
یا به این صورت:
.PP
.Vb 1
\& virt\-format \-a /dev/VG/LV
.Ve
.PP
فایل‌های
\&\fIdisk.qcow\fR
یا
\fI/dev/VG/LV\fR
باید از قبل وجود داشته باشند.
\fBهرگونه داده روی این دیسک‌ها با این دستورات پاک خواهد شد\fR.
این دستورات یک پارتیشن خالی منفرد سرتاسر دیسک بدون هیچ سیستم‌فایلی درون آن ایجاد می‌کنند.
.PP
می‌توان از پارامترهای اضافی برای کنترل ساخت پارتیشن‌ها، سیستم‌فایل‌ها و غیره استفاده کرد. پرکاربردترین گزینه‌ها عبارتند از:
.IP \fB\-\-filesystem=[ext3|ntfs|vfat|...]\fR 4
.IX Item "--filesystem=[ext3|ntfs|vfat|...]"
ساخت یک سیستم‌فایل خالی (\f(CW\*(C`ext3\*(C'\fR، \f(CW\*(C`ntfs\*(C'\fR و غیره) درون پارتیشن.
.IP \fB\-\-lvm[=/dev/VG/LV]\fR 4
.IX Item "--lvm[=/dev/VG/LV]"
ساخت یک حجم منطقی Linux LVM2 روی دیسک. هنگام استفاده همزمان با
\&\fI\-\-filesystem\fR،
سیستم‌فایل درون LV ساخته می‌شود.
.PP
برای کسب اطلاعات بیشتر درباره این گزینه‌ها و گزینه‌های دیگر، بخش «گزینه‌ها (OPTIONS)» در ادامه را ببینید.
.PP
فرمت دیسک معمولاً به صورت خودکار تشخیص داده می‌شود، اما می‌توانید با استفاده از گزینه
\fI\-\-format\fR
(به زیر مراجعه کنید) آن را اجباری نمایید. در شرایطی که به محتوای موجود دیسک اعتماد ندارید، توصیه می‌شود از این گزینه برای جلوگیری از سوءاستفاده‌های امنیتی احتمالی استفاده کنید.
.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،
که می‌تواند تصویر دیسک، پارتیشن میزبان، LV، دیسک USB خارجی و غیره باشد.
.Sp
فرمت تصویر دیسک به صورت خودکار تشخیص داده می‌شود. برای لغو این حالت و اجبار یک فرمت خاص، از گزینه
\fI\-\-format=..\fR
استفاده کنید.
.Sp
\&\fBهرگونه داده موجود روی دیسک پاک می‌شود.\fR
.IP "\fB\-a\fR URI" 4
.IX Item "-a URI"
.PD 0
.IP "\fB\-\-add\fR URI" 4
.IX Item "--add URI"
.PD
افزودن دیسک راه دور. بخش "ADDING REMOTE STORAGE" را در
\&\fBguestfish\fR\|(1)
ببینید.
.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
این پارامتر اندازه سکتور تصویر دیسک را تنظیم می‌کند. این مقدار روی تمام دیسک‌های بعدی که به صورت صریح پس از این پارامتر اضافه شوند اثر می‌گذارد. استفاده از
\&\fI\-\-blocksize\fR
بدون آرگومان، اندازه سکتور دیسک را به مقدار پیش‌فرض که معمولاً ۵۱۲ بایت است بازمی‌گرداند. همچنین
"guestfs_add_drive_opts"
را در
\&\fBguestfs\fR\|(3)
ببینید.
.IP \fB\-\-filesystem=ext3|ntfs|vfat|...\fR 4
.IX Item "--filesystem=ext3|ntfs|vfat|..."
ساخت یک سیستم‌فایل خالی از نوع مشخص‌شده. انواع بسیاری از سیستم‌فایل‌ها توسط libguestfs پشتیبانی می‌شوند.
.IP \fB\-\-filesystem=none\fR 4
.IX Item "--filesystem=none"
هیچ سیستم‌فایلی ساخته نشود. این حالت پیش‌فرض است.
.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
حالت پیش‌فرض برای گزینه
\fI\-a\fR
تشخیص خودکار فرمت تصویر دیسک است. استفاده از این گزینه فرمت دیسک را برای گزینه‌های
\fI\-a\fR
بعدی در خط فرمان اجباری می‌کند. استفاده از
\fI\-\-format\fR
بدون آرگومان، حالت را برای گزینه‌های
\fI\-a\fR
بعدی دوباره به تشخیص خودکار بازمی‌گرداند.
.Sp
به عنوان مثال:
.Sp
.Vb 1
\& virt\-format \-\-format=raw \-a disk.img
.Ve
.Sp
فرمت raw (بدون تشخیص خودکار) را برای
\fIdisk.img\fR
اجباری می‌کند.
.Sp
.Vb 1
\& virt\-format \-\-format=raw \-a disk.img \-\-format \-a another.img
.Ve
.Sp
فرمت raw (بدون تشخیص خودکار) را برای
\fIdisk.img\fR
اجباری کرده و برای
\fIanother.img\fR
به تشخیص خودکار بازمی‌گردد.
.Sp
اگر تصاویر دیسک مهمان با فرمت raw غیرقابل‌اعتماد دارید، باید از این گزینه برای تعیین فرمت دیسک استفاده کنید. این کار از یک مشکل امنیتی احتمالی با مهمان‌های مخرب جلوگیری می‌کند (CVE\-2010\-3851).
.IP \fB\-\-label=\fRLABEL 4
.IX Item "--label=LABEL"
تنظیم برچسب (Label) سیستم‌فایل.
.IP \fB\-\-lvm=/dev/\fR\f(BIVG\fR\fB/\fR\f(BILV\fR 4
.IX Item "--lvm=/dev/VG/LV"
ساخت یک حجم منطقی Linux LVM2 به نام
\fI/dev/VG/LV\fR.
می‌توانید نام گروه حجم (Volume Group) و حجم منطقی را تغییر دهید.
.IP \fB\-\-lvm\fR 4
.IX Item "--lvm"
ساخت یک حجم منطقی Linux LVM2 با نام پیش‌فرض
(\fI/dev/VG/LV\fR).
.IP \fB\-\-lvm=none\fR 4
.IX Item "--lvm=none"
هیچ حجم منطقی ساخته نشود. این حالت پیش‌فرض است.
.IP \fB\-\-partition\fR 4
.IX Item "--partition"
ساخت یک پارتیشن MBR یا GPT در سرتاسر دیسک. اگر اندازه دیسک کمتر از ۲ ترابایت باشد MBR و اگر بزرگتر یا مساوی ۲ ترابایت باشد GPT انتخاب می‌شود.
.Sp
این حالت پیش‌فرض است.
.IP \fB\-\-partition=gpt\fR 4
.IX Item "--partition=gpt"
ساخت پارتیشن GPT.
.IP \fB\-\-partition=mbr\fR 4
.IX Item "--partition=mbr"
ساخت پارتیشن MBR.
.IP \fB\-\-partition=none\fR 4
.IX Item "--partition=none"
هیچ جدول پارتیشنی ساخته نشود. توجه داشته باشید که ویندوز ممکن است نتواند این دیسک‌ها را شناسایی کند.
.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\-\-wipe\fR 4
.IX Item "--wipe"
در حالت عادی virt\-format داده‌ها را از روی دیسک به طور کامل پاکسازی (Wipe) نمی‌کند (چون زمان زیادی می‌برد). بنابراین اگر داده‌ای روی دیسک باشد، فقط مخفی شده و بخشی از آن توسط virt\-format بازنویسی می‌شود، و ممکن است توسط ابزارهای ویرایش دیسک قابل بازیابی باشد.
.Sp
اگر از این گزینه استفاده کنید، virt\-format سراسر دیسک را با صفر پر می‌کند تا داده‌های قبلی غیرقابل‌بازیابی شوند.
.IP \fB\-x\fR 4
.IX Item "-x"
فعال‌سازی ردگیری فراخوانی‌های API در libguestfs.
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "EXIT STATUS"
این برنامه در صورت موفقیت مقدار
\f(CW0\fR
و در صورت بروز خطا مقدار
\f(CW1\fR
را برمی‌گرداند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBguestfs\fR\|(3),
\&\fBguestfish\fR\|(1),
\&\fBvirt\-filesystems\fR\|(1),
\&\fBvirt\-make\-fs\fR\|(1),
\&\fBvirt\-rescue\fR\|(1),
\&\fBvirt\-resize\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) 2012 Red Hat Inc.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ مجوز و چه (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده یا تغییر دهید.
.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
آن را در گزارش اشکال قرار دهید.