.\" -*- 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-sparsify 1"
.TH virt-sparsify 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\-sparsify \- تنک‌سازی دیسک ماشین مجازی و آزادسازی فضای خالی آن
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& virt\-sparsify [\-\-options] indisk outdisk
\&
\& virt\-sparsify [\-\-options] \-\-in\-place disk
.Ve
.SH "هشدار (WARNING)"
.IX Header "WARNING"
استفاده از
\f(CW\*(C`virt\-sparsify\*(C'\fR
روی ماشین‌های مجازی روشن و فعال، یا به صورت همزمان با سایر ابزارهای ویرایش دیسک می‌تواند خطرناک باشد و به طور بالقوه منجر به آسیب‌دیدگی و خرابی دیسک شود. ماشین مجازی باید پیش از استفاده از این دستور خاموش شود، و ایمیج‌های دیسک نباید به صورت همزمان ویرایش شوند.
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
ابزار
.B virt\-sparsify
ابزاری است که می‌تواند یک دیسک ماشین مجازی (یا هر ایمیج دیسک دیگری) را تنک (تخصیص‌یافته به صورت پویا یا thin-provisioned) کند. این بدان معناست که فضای خالی درون ایمیج دیسک می‌تواند مجدداً به فضای خالی در سیستم میزبان تبدیل شود.
.PP
ابزار
.B virt\-sparsify
می‌تواند فضای خالی را در بیشتر سیستم‌های پرونده (مانند ext2/3/4، btrfs، NTFS و غیره) و همچنین در حجم‌های فیزیکی LVM مکان‌یابی کرده و تنک‌سازی کند.
.PP
همچنین
.B virt\-sparsify
می‌تواند بین برخی از قالب‌های دیسک تبدیل انجام دهد؛ برای نمونه تبدیل یک ایمیج دیسک خام (raw) به یک ایمیج qcow2 با تخصیص پویا (thin-provisioned).
.PP
ابزار
.B virt\-sparsify
می‌تواند روی هر ایمیج دیسکی کار کند، نه فقط ایمیج‌های مربوط به ماشین‌های مجازی. با این حال اگر یک ماشین مجازی دارای چند دیسک باشد و از مدیریت حجم (volume management) استفاده کند، virt\-sparsify کار خواهد کرد اما چندان موثر نخواهد بود (http://bugzilla.redhat.com/887826).
.SS "نکته مهم درباره ایمیج‌های خروجی تنک (IMPORTANT NOTE ABOUT SPARSE OUTPUT IMAGES)"
.IX Subsection "IMPORTANT NOTE ABOUT SPARSE OUTPUT IMAGES"
اگر ورودی از نوع خام (raw) باشد، خروجی پیش‌فرض به صورت تنک خام (raw sparse) خواهد بود.
\fBباید اندازه خروجی را با استفاده از ابزاری بررسی کنید که مفهوم تنک بودن را درک می‌کند\fR
مانند
\f(CW\*(C`du \-sh\*(C'\fR.
این موضوع می‌تواند تفاوت چشمگیری ایجاد کند:
.PP
.Vb 4
\& $ ls \-lh test1.img
\& \-rw\-rw\-r\-\-. 1 rjones rjones 100M Aug  8 08:08 test1.img
\& $ du \-sh test1.img
\& 3.6M   test1.img
.Ve
.PP
(اندازه ظاهری
\fB100M\fR
را با اندازه واقعی
\fB3.6M\fR
مقایسه کنید)
.SS "محدودیت‌های مهم (IMPORTANT LIMITATIONS)"
.IX Subsection "IMPORTANT LIMITATIONS"
.IP \(bu 4
ماشین مجازی \fIباید پیش از استفاده از این ابزار خاموش شود\fR.
.IP \(bu 4
ابزار
.B virt\-sparsify
ممکن است تا ۲ برابر اندازه مجازی ایمیج دیسک مبدا فضا نیاز داشته باشد (۱ رونوشت موقت + ۱ ایمیج مقصد). این حالت در بدترین شرایط رخ می‌دهد و معمولاً به فضای بسیار کمتری نیاز است.
.Sp
اگر از گزینه
\fI\-\-in\-place\fR
استفاده می‌کنید، به مقادیر زیادی از فضای موقت نیاز \fBنخواهد بود\fR.
.IP \(bu 4
ابزار
.B virt\-sparsify
نمی‌تواند اندازه ایمیج‌های دیسک را تغییر دهد. برای این کار، از
\&\fBvirt\-resize\fR\|(1)
استفاده کنید.
.IP \(bu 4
ابزار
.B virt\-sparsify
نمی‌تواند دیسک‌های رمزگذاری‌شده را پردازش کند. بسته Libguestfs از دیسک‌های رمزگذاری‌شده پشتیبانی می‌کند، اما خود دیسک‌های رمزگذاری‌شده نمی‌توانند تنک‌سازی شوند.
.IP \(bu 4
ابزار
.B virt\-sparsify
هنوز نمی‌تواند فضای میان پارتیشن‌ها را تنک‌سازی کند. توجه داشته باشید که این فضا اغلب برای موارد حیاتی مانند بوت‌لودرها استفاده می‌شود، بنابراین در واقع بلااستفاده نیست.
.IP \(bu 4
در حالت رونوشت (copy mode)، اسنپ‌شات‌های داخلی qcow2 به ایمیج مقصد کپی نمی‌شوند.
.PP
همچنین ممکن است پیش از شروع، تمایل داشته باشید صفحات راهنمای ابزارهای مرتبط
\&\fBvirt\-filesystems\fR\|(1)
و
\&\fBvirt\-df\fR\|(1)
را مطالعه کنید.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
کاربرد معمول به این صورت است:
.PP
.Vb 1
\& virt\-sparsify indisk outdisk
.Ve
.PP
که دیسک
\f(CW\*(C`indisk\*(C'\fR
را در
\f(CW\*(C`outdisk\*(C'\fR
کپی کرده و خروجی را تنک می‌سازد.
پرونده
\f(CW\*(C`outdisk\*(C'\fR
ایجاد می‌شود، یا اگر از قبل وجود داشته باشد رونویسی خواهد شد. قالب دیسک ورودی تشخیص داده می‌شود (برای نمونه qcow2) و همان قالب برای دیسک خروجی استفاده می‌شود.
.PP
برای تبدیل میان قالب‌ها، از گزینه
\fI\-\-convert\fR
استفاده کنید:
.PP
.Vb 1
\& virt\-sparsify disk.raw \-\-convert qcow2 disk.qcow2
.Ve
.PP
ابزار
.B virt\-sparsify
تلاش می‌کند فضای خالی را در تمام سیستم‌های پرونده‌ای که درون ایمیج دیسک مبدا می‌یابد صفر کرده و تنک‌سازی کند. شما می‌توانید با دستور زیر آن را وادارید تا برخی سیستم‌های پرونده را نادیده بگیرد (فضای خالی آن‌ها را صفر نکند):
.PP
.Vb 1
\& virt\-sparsify \-\-ignore /dev/sda1 indisk outdisk
.Ve
.PP
برای مشاهده فهرستی از سیستم‌های پرونده درون یک ایمیج دیسک،
\&\fBvirt\-filesystems\fR\|(1)
را ببینید.
.PP
از نسخه 1.26 به بعد virt\-sparsify، می‌توانید با اجرای دستور زیر یک ایمیج دیسک را درجا تنک‌سازی کنید:
.PP
.Vb 1
\& virt\-sparsify \-\-in\-place disk.img
.Ve
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش راهنما.
.IP "\fB\-\-check\-tmpdir\fR \fBignore\fR" 4
.IX Item "--check-tmpdir ignore"
.PD 0
.IP "\fB\-\-check\-tmpdir\fR \fBcontinue\fR" 4
.IX Item "--check-tmpdir continue"
.IP "\fB\-\-check\-tmpdir\fR \fBwarn\fR" 4
.IX Item "--check-tmpdir warn"
.IP "\fB\-\-check\-tmpdir\fR \fBfail\fR" 4
.IX Item "--check-tmpdir fail"
.PD
بررسی می‌کند که آیا متغیر محیطی "TMPDIR" یا دایرکتوری مشخص‌شده با
\fI\-\-tmp\fR
فضای کافی برای تکمیل عملیات دارد یا خیر. این مقدار فقط یک تخمین است.
.Sp
اگر بررسی نشان‌دهنده یک مشکل باشد، می‌توانید یکی از این کارها را انجام دهید:
.RS 4
.IP \(bu 4
آن را نادیده بگیرید (\fBignore\fR)،
.IP \(bu 4
یک هشدار چاپ کرده و ادامه دهید (\fBcontinue\fR)،
.IP \(bu 4
هشدار داده (\fBwarn\fR) و منتظر بمانید تا کاربر کلید Return را فشار دهد
(این حالت پیش‌فرض است)، یا:
.IP \(bu 4
با خطا متوقف شده و خارج شوید (\fBfail\fR).
.RE
.RS 4
.Sp
نمی‌توانید از این گزینه و
\fI\-\-in\-place\fR
به طور همزمان استفاده کنید.
.RE
.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
استفاده از توالی‌های رنگی ANSI برای رنگی کردن پیام‌ها. این حالت در زمانی که خروجی یک tty باشد پیش‌فرض است. اگر خروجی برنامه به یک پرونده هدایت شود، توالی‌های رنگی ANSI غیرفعال می‌شوند مگر اینکه از این گزینه استفاده کنید.
.IP \fB\-\-compress\fR 4
.IX Item "--compress"
فشرده‌سازی پرونده خروجی. این گزینه \fIتنها\fR در صورتی کار می‌کند که قالب خروجی
\f(CW\*(C`qcow2\*(C'\fR
باشد.
.Sp
نمی‌توانید از این گزینه و
\fI\-\-in\-place\fR
به طور همزمان استفاده کنید.
.IP "\fB\-\-convert\fR raw" 4
.IX Item "--convert raw"
.PD 0
.IP "\fB\-\-convert\fR qcow2" 4
.IX Item "--convert qcow2"
.IP "\fB\-\-convert\fR [other formats]" 4
.IX Item "--convert [other formats]"
.PD
استفاده از
\f(CW\*(C`output\-format\*(C'\fR
به عنوان قالب ایمیج مقصد. اگر این گزینه مشخص نشود، از قالب ورودی استفاده می‌شود.
.Sp
قالب‌های خروجی پشتیبانی‌شده و شناخته‌شده عبارتند از:
\f(CW\*(C`raw\*(C'\fR، \f(CW\*(C`qcow2\*(C'\fR، \f(CW\*(C`vdi\*(C'\fR.
.Sp
همچنین می‌توانید از هر قالبی که توسط برنامه
\&\fBqemu\-img\fR\|(1)
پشتیبانی می‌شود استفاده کنید، مانند
\f(CW\*(C`vmdk\*(C'\fR،
اما پشتیبانی از سایر قالب‌ها به qemu وابسته است.
.Sp
مشخص کردن گزینه
\fI\-\-convert\fR
معمولاً ایده خوبی است، زیرا در این صورت virt\-sparsify نیازی به حدس زدن قالب ورودی نخواهد داشت.
.Sp
برای تنظیم دقیق قالب خروجی، ببینید:
\fI\-\-compress\fR، \fI\-o\fR.
.Sp
نمی‌توانید از این گزینه و
\fI\-\-in\-place\fR
به طور همزمان استفاده کنید.
.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
هنگام درخواست کلیدها و عبارت‌های عبور، virt\-sparsify معمولاً انعکاس (echo) ورودی را خاموش می‌کند تا نتوانید آنچه تایپ می‌کنید را ببینید. اگر نگران حملات تمپست (Tempest) نیستید و شخص دیگری در اتاق حضور ندارد، می‌توانید این گزینه را برای مشاهده آنچه تایپ می‌کنید مشخص کنید.
.IP "\fB\-\-format\fR raw" 4
.IX Item "--format raw"
.PD 0
.IP "\fB\-\-format\fR qcow2" 4
.IX Item "--format qcow2"
.PD
قالب ایمیج دیسک ورودی را مشخص می‌کند. اگر این پرچم داده نشود، قالب به طور خودکار از خود ایمیج تشخیص داده می‌شود.
.Sp
اگر با ایمیج‌های دیسک مهمانِ غیرقابل اعتماد با قالب خام (raw) کار می‌کنید، باید مطمئن شوید که قالب همیشه به صراحت مشخص شده باشد.
.IP "\fB\-\-ignore\fR filesystem" 4
.IX Item "--ignore filesystem"
.PD 0
.IP "\fB\-\-ignore\fR volgroup" 4
.IX Item "--ignore volgroup"
.PD
سیستم پرونده مشخص‌شده را نادیده می‌گیرد.
.Sp
هنگامی که از
\fI\-\-in\-place\fR
استفاده نمی‌شود: فضای خالی روی سیستم پرونده صفر نخواهد شد، اما بلوک‌های موجودِ حاوی صفر همچنان تنک‌سازی می‌شوند.
.Sp
هنگام استفاده از
\fI\-\-in\-place\fR،
سیستم پرونده به طور کامل نادیده گرفته می‌شود.
.Sp
در شکل دوم، این گزینه گروه حجم (volume group) نام‌برده‌شده را نادیده می‌گیرد. از نام گروه حجم بدون پیشوند
\fI/dev/\fR
استفاده کنید، مانند
\fI\-\-ignore vg_foo\fR
.Sp
می‌توانید این گزینه را چندین بار مشخص کنید.
.IP \fB\-\-in\-place\fR 4
.IX Item "--in-place"
به جای تنک‌سازی از طریق کپی، تنک‌سازی را به صورت درجا (in-place) انجام می‌دهد.
بخش "تنک‌سازی درجا (IN\-PLACE SPARSIFICATION)" را در زیر ببینید.
.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
یک کلید برای LUKS مشخص می‌کند تا هنگام استفاده از بازرسی (inspection)، دستگاه 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
اگر چند دستگاه رمزگذاری‌شده وجود داشته باشد، ممکن است لازم باشد چند کلید را در ورودی استاندارد، هر کدام در یک خط، وارد کنید.
.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
این گزینه برای ماشین‌خوان‌تر کردن خروجی هنگام پردازش توسط سایر برنامه‌ها، رابط‌های کاربری گرافیکی (GUI) و غیره استفاده می‌شود. بخش
"خروجی ماشین‌خوان (MACHINE READABLE OUTPUT)"
را در زیر ببینید.
.IP "\fB\-o\fR option[,option,...]" 4
.IX Item "-o option[,option,...]"
گزینه(های)
\fI\-o\fR
را به دستور
\&\fBqemu\-img\fR\|(1)
ارسال می‌کند تا قالب خروجی را به طور دقیق تنظیم نماید. گزینه‌های موجود به قالب خروجی (به
\&\fI\-\-convert\fR
مراجعه کنید) و نسخه نصب‌شده برنامه qemu-img بستگی دارند.
.Sp
شما باید از
\fI\-o\fR
حداکثر یک بار استفاده کنید. برای ارسال چندین گزینه، آن‌ها را با کاما جدا کنید، مانند:
.Sp
.Vb 2
\& virt\-sparsify \-\-convert qcow2 \e
\&   \-o cluster_size=512,preallocation=metadata ...
.Ve
.Sp
نمی‌توانید از این گزینه و
\fI\-\-in\-place\fR
به طور همزمان استفاده کنید.
.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
این گزینه نوارهای پیشرفت و سایر خروجی‌های غیرضروری را غیرفعال می‌کند.
.IP "\fB\-\-tmp\fR block_device" 4
.IX Item "--tmp block_device"
.PD 0
.IP "\fB\-\-tmp\fR dir" 4
.IX Item "--tmp dir"
.PD
فقط در حالت کپی، از دستگاه یا دایرکتوری نام‌برده‌شده به عنوان مکان لایه همپوشانی موقت (temporary overlay) استفاده می‌کند (همچنین متغیر محیطی "TMPDIR" را در زیر ببینید).
.Sp
اگر پارامتر داده‌شده یک دستگاه بلوکی (block device) باشد، عملیات نوشتن مستقیماً روی دستگاه بلوکی انجام می‌شود.
\&\fBتوجه داشته باشید که این کار محتویات موجود در دستگاه بلوکی را پاک می‌کند\fR.
.Sp
اگر پارامتر یک دایرکتوری باشد، این کار معادل تنظیم متغیر محیطی "TMPDIR" است.
.Sp
نمی‌توانید از این گزینه و
\fI\-\-in\-place\fR
به طور همزمان استفاده کنید.
.IP "\fB\-\-tmp\fR prebuilt:file" 4
.IX Item "--tmp prebuilt:file"
فقط در حالت کپی، گزینه اختصاصی
\fI\-\-tmp prebuilt:file\fR
(که در آن
\f(CW\*(C`prebuilt:\*(C'\fR
یک رشته متنی ثابت است) باعث می‌شود که virt\-sparsify از پرونده
\f(CW\*(C`file\*(C'\fR
با قالب qcow2 به عنوان فضای موقت استفاده کند.
.RS 4
.IP \(bu 4
پرونده \fBباید\fR به تازگی با قالب qcow2 قالب‌بندی شده باشد و indisk به عنوان پرونده پشتیبان (backing file) آن تعیین شده باشد.
.IP \(bu 4
اگر virt\-sparsify را مجدداً اجرا می‌کنید، \fBباید\fR پرونده را قبل از هر بار اجرا دوباره بسازید.
.IP \(bu 4
ابزار virt\-sparsify پرونده را حذف نمی‌کند.
.RE
.RS 4
.Sp
این گزینه توسط oVirt استفاده می‌شود که به یک پرونده موقت با قالب‌بندی ویژه نیاز دارد.
.RE
.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"
فعال کردن ردیابی (tracing) فراخوانی‌های رابط برنامه‌نویسی (API) در libguestfs.
.IP "\fB\-\-zero\fR partition" 4
.IX Item "--zero partition"
.PD 0
.IP "\fB\-\-zero\fR logvol" 4
.IX Item "--zero logvol"
.PD
صفر کردن محتویات پارتیشن یا حجم منطقی (logical volume) نام‌برده‌شده در مهمان. تمام داده‌های روی دستگاه از بین می‌رود، اما تنک‌سازی فوق‌العاده خواهد بود! می‌توانید این گزینه را چندین بار مشخص کنید.
.SH "تنک‌سازی درجا (IN\-PLACE SPARSIFICATION)"
.IX Header "IN-PLACE SPARSIFICATION"
از نسخه 1.26 به بعد virt\-sparsify، این ابزار قادر است تنک‌سازی را به صورت درجا (به جای کپی کردن از یک دیسک ورودی به یک دیسک خروجی) انجام دهد. این روش کارآمدتر است، اما نمی‌تواند به اندازه روش تنک‌سازی با کپی فضا آزاد کند.
.PP
برای استفاده از این حالت، یک ایمیج دیسک را مشخص کنید که در همان محل ویرایش شود:
.PP
.Vb 1
\& virt\-sparsify \-\-in\-place disk.img
.Ve
.PP
برخی از گزینه‌ها با این حالت سازگار نیستند:
\fI\-\-convert\fR،
\&\fI\-\-compress\fR
و
\fI\-o\fR
زیرا به تغییرات اساسی در قالب دیسک نیاز دارند؛ و
\fI\-\-check\-tmpdir\fR
زیرا به مقادیر زیادی فضای موقت نیازی نیست.
.PP
تنک‌سازی درجا با استفاده از پشتیبانی از discard (معروف به trim یا unmap) عمل می‌کند.
.SH "خروجی ماشین‌خوان (MACHINE READABLE OUTPUT)"
.IX Header "MACHINE READABLE OUTPUT"
گزینه
\fI\-\-machine\-readable\fR
می‌تواند برای ماشین‌خوان‌تر کردن خروجی استفاده شود، که هنگام فراخوانی virt\-sparsify از سایر برنامه‌ها، رابط‌های کاربری گرافیکی (GUI) و غیره کاربرد دارد.
.PP
دو راه برای استفاده از این گزینه وجود دارد.
.PP
روش اول استفاده از این گزینه به تنهایی برای پرس‌وجوی قابلیت‌های باینری virt\-sparsify است. خروجی معمول شبیه به این است:
.PP
.Vb 4
\& $ virt\-sparsify \-\-machine\-readable
\& virt\-sparsify
\& ntfs
\& btrfs
.Ve
.PP
فهرستی از قابلیت‌ها چاپ می‌شود، هر کدام در یک خط، و برنامه با وضعیت 0 خارج می‌شود.
.PP
روش دوم استفاده از این گزینه در ترکیب با سایر گزینه‌ها است تا خروجی معمولی برنامه ماشین‌خوان‌تر شود.
.PP
در حال حاضر این به این معناست:
.IP 1. 4
پیام‌های نوار پیشرفت را می‌توان با جستجوی این عبارت منظم (regex) از طریق خروجی استاندارد (stdout) استخراج و تجزیه کرد:
.Sp
.Vb 1
\& ^[0\-9]+/[0\-9]+$
.Ve
.IP 2. 4
برنامه فراخواننده باید پیام‌های ارسال‌شده به stdout (به جز پیام‌های نوار پیشرفت) را به عنوان پیام‌های وضعیت در نظر بگیرد. آن‌ها را می‌توان لاگ کرد و/یا به کاربر نمایش داد.
.IP 3. 4
برنامه فراخواننده باید پیام‌های ارسال‌شده به stderr را به عنوان پیام‌های خطا در نظر بگیرد. علاوه بر این، در صورت بروز یک خطای مهلک، virt\-sparsify با یک کد وضعیت غیرصفر خارج می‌شود.
.PP
تمامی نسخه‌های virt\-sparsify از گزینه
\fI\-\-machine\-readable\fR
پشتیبانی کرده‌اند.
.PP
امکان تعیین یک رشته قالب برای کنترل خروجی وجود دارد؛ به "ADVANCED MACHINE READABLE OUTPUT" در
\&\fBguestfs\fR\|(3)
مراجعه کنید.
.SH "ویندوز ۸ (WINDOWS 8)"
.IX Header "WINDOWS 8"
قابلیت «راه‌اندازی سریع» (fast startup) در ویندوز ۸ می‌تواند مانع از کارکرد درست virt\-sparsify شود.
به "WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP" در
\&\fBguestfs\fR\|(3)
مراجعه کنید.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.IX Header "ENVIRONMENT VARIABLES"
.IP TMPDIR 4
.IX Item "TMPDIR"
مکان دایرکتوری موقت مورد استفاده برای پرونده همپوشانی موقت (temporary overlay) که می‌تواند بسیار بزرگ باشد.
.Sp
در نسخه 1.28 به بعد virt\-sparsify، می‌توانید این متغیر محیطی را با استفاده از گزینه
\fI\-\-tmp\fR
بازنویسی کنید.
.Sp
شما باید اطمینان حاصل کنید که در بدترین حالت، فضای آزاد کافی برای یک نسخه کامل از دیسک مبدا (اندازه \fIمجازی\fR) وجود دارد، یا متغیر
\f(CW$TMPDIR\fR
را طوری تنظیم کنید که به دایرکتوری دیگری با فضای کافی اشاره کند.
.Sp
مقدار پیش‌فرض این متغیر
\fI/tmp\fR
است.
.Sp
توجه داشته باشید که اگر
\f(CW$TMPDIR\fR
یک tmpfs باشد (مثلاً اگر
\fI/tmp\fR
روی tmpfs قرار داشته باشد، یا اگر از
\f(CW\*(C`TMPDIR=/dev/shm\*(C'\fR
استفاده کنید)، اندازه tmpfs به طور پیش‌فرض حداکثر به \fIنصف\fR حافظه رم فیزیکی محدود می‌شود. اگر virt\-sparsify از این مقدار فراتر رود، سیستم متوقف (hang) خواهد شد. راه حل این است که یا از یک دیسک واقعی استفاده کنید، یا حداکثر اندازه نقطه اتصال tmpfs را افزایش دهید، مانند:
.Sp
.Vb 1
\& mount \-o remount,size=10G /tmp
.Ve
.Sp
اگر از گزینه
\fI\-\-in\-place\fR
استفاده می‌کنید، به مقادیر زیادی از فضای موقت نیاز \fBنخواهد بود\fR.
.PP
برای سایر متغیرهای محیطی، به بخش "ENVIRONMENT VARIABLES" در
\&\fBguestfs\fR\|(3)
مراجعه کنید.
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "EXIT STATUS"
این برنامه در صورت تکمیل عملیات بدون خطا، مقدار 0 را برمی‌گرداند.
(این لزوماً به این معنی نیست که فضایی آزاد شده است.)
.PP
کد خروج غیرصفر نشان‌دهنده بروز خطا است.
.PP
اگر کد خروج برابر با
\f(CW3\fR
باشد و از گزینه
\fI\-\-in\-place\fR
استفاده شده باشد، نشان می‌دهد که پشتیبانی از discard در libguestfs در دسترس نیست، بنابراین باید از حالت کپی به جای آن استفاده شود.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBvirt\-df\fR\|(1),
\&\fBvirt\-filesystems\fR\|(1),
\&\fBvirt\-resize\fR\|(1),
\&\fBvirt\-rescue\fR\|(1),
\&\fBguestfs\fR\|(3),
\&\fBguestfish\fR\|(1),
\&\fBtruncate\fR\|(1),
\&\fBfallocate\fR\|(1),
\&\fBqemu\-img\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) 2011\-2025 Red Hat Inc.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، بازتوزیع کرده و/یا تغییر دهید؛ چه نسخه ۲ مجوز، یا (به انتخاب خودتان) هر نسخه بعدی.
.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 آن را در گزارش اشکال قرار دهید.