.\" -*- 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-df 1" .TH virt-df 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\-df \- نمایش فضای آزاد دیسک در سیستم‌های فایل ماشین‌های مجازی .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" همه ماشین‌های میهمان: .PP .Vb 1 \& virt\-df [\-\-options] .Ve .PP یک ماشین میهمان منفرد: .PP .Vb 1 \& virt\-df [\-\-options] \-d domname \& \& virt\-df [\-\-options] \-a disk.img [\-a disk.img ...] .Ve .PP سبک قدیمی: .PP .Vb 1 \& virt\-df [\-\-options] domname \& \& virt\-df [\-\-options] disk.img [disk.img ...] .Ve .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \&\f(CW\*(C`virt\-df\*(C'\fR ابزاری خط فرمانی برای نمایش فضای آزاد در سیستم‌های فایل ماشین مجازی است. برخلاف سایر ابزارها، این دستور صرفاً اندازه دیسک اختصاص‌یافته به یک ماشین مجازی را نشان نمی‌دهد، بلکه می‌تواند به درون ایمیج‌های دیسک نگاه کند تا ببیند چه مقدار فضا واقعاً در حال استفاده است. .PP اگر بدون هیچ آرگومان \fI\-a\fR یا \fI\-d\fR استفاده شود، \f(CW\*(C`virt\-df\*(C'\fR با libvirt ارتباط برقرار کرده تا فهرستی از تمام ماشین‌های میهمان فعال و غیرفعال دریافت کند، و به نوبت عملیاتی از نوع \f(CW\*(C`df\*(C'\fR را روی هر یک انجام داده و نتایج را چاپ می‌کند. .PP اگر هر یک از آرگومان‌های \fI\-a\fR یا \fI\-d\fR مشخص شوند، \f(CW\*(C`virt\-df\*(C'\fR عملیاتی از نوع \f(CW\*(C`df\*(C'\fR را یا روی دامنه نام‌برده منفرد libvirt یا روی ایمیج(های) دیسک فهرست‌شده در خط فرمان (که همگی باید متعلق به یک ماشین مجازی واحد باشند) انجام می‌دهد. \fBدر این حالت (با آرگومان‌ها)، \fR\f(CB\*(C`virt\-df\*(C'\fR\fB فقط برای یک ماشین میهمان منفرد کار خواهد کرد\fR. اگر می‌خواهید آن را روی چندین ماشین میهمان اجرا کنید، باید \f(CW\*(C`virt\-df\*(C'\fR را چندین بار فراخوانی کنید. .PP از گزینه \fI\-\-csv\fR برای دریافت قالبی استفاده کنید که بتواند به راحتی توسط برنامه‌های دیگر پردازش و تجزیه شود. سایر گزینه‌ها مشابه دستور استاندارد \fBdf\fR\|(1) هستند. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" نمایش مصرف دیسک برای یک ماشین میهمان libvirt به نام \f(CW\*(C`F14x64\*(C'\fR. خوانا کردن خروجی برای انسان (human\-readable): .PP .Vb 4 \& # virt\-df \-d F14x64 \-h \& Filesystem Size Used Available Use% \& F14x64:/dev/sda1 484M 66M 393M 14% \& F14x64:/dev/vg_f13x64/lv_root 7.4G 3.4G 4.0G 46% .Ve .PP نمایش مصرف دیسک برای یک فایل ایمیج دیسک به نام \fItest.img\fR: .PP .Vb 3 \& $ virt\-df \-a test1.img \& Filesystem 1K\-blocks Used Available Use% \& test1.img:/dev/sda1 99099 1551 92432 2% .Ve .PP اگر یک ماشین میهمان چندین دیسک دارد، از گزینه \fI\-a\fR به صورت مکرر استفاده کنید. یک علامت مثبت (\f(CW\*(C`+\*(C'\fR) برای هر دیسک اضافی نمایش داده می‌شود. \fBنکته: این کار را با دیسک‌های نامرتبط ماشین‌های میهمان انجام ندهید.\fR .PP .Vb 5 \& $ virt\-df \-a Win7x32TwoDisks\-a \-a Win7x32TwoDisks\-b \& Filesystem 1K\-blocks Used Available Use% \& Win7x32TwoDisks\-a+:/dev/sda1 102396 24712 77684 25% \& Win7x32TwoDisks\-a+:/dev/sda2 12478460 7403416 5075044 60% \& Win7x32TwoDisks\-a+:/dev/sdb1 521212 55728 465484 11% .Ve .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 افزودن \f(CW\*(C`FILE\*(C'\fR که باید یک ایمیج دیسک از ماشین مجازی باشد. اگر ماشین مجازی چندین دستگاه بلوکی دارد، باید همه آن‌ها را با گزینه‌های جداگانه \fI\-a\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 افزودن دیسک راه دور. به "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 این پارامتر اندازه بخش (sector size) ایمیج دیسک را تنظیم می‌کند. این گزینه بر تمام دیسک‌های بعدی که به صراحت پس از این پارامتر اضافه می‌شوند تأثیر می‌گذارد. استفاده از \fI\-\-blocksize\fR بدون آرگومان، اندازه سکتور دیسک را به مقدار پیش‌فرض تغییر می‌دهد که معمولاً ۵۱۲ بایت است. همچنین به "guestfs_add_drive_opts" در \fBguestfs\fR\|(3) مراجعه کنید. .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\-\-csv\fR 4 .IX Item "--csv" نوشتن نتایج در قالب CSV (مقادیر جداشده با کاما). این قالب می‌تواند به راحتی به پایگاه‌های داده و صفحات گسترده وارد شود، اما بخش "نکته‌ای درباره قالب CSV" را در زیر بخوانید. .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\-\-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\-df \-\-format=raw \-a disk.img .Ve .Sp قالب raw (بدون تشخیص خودکار) را برای \fIdisk.img\fR تحمیل می‌کند. .Sp .Vb 1 \& virt\-df \-\-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\-h\fR 4 .IX Item "-h" .PD 0 .IP \fB\-\-human\-readable\fR 4 .IX Item "--human-readable" .PD چاپ اندازه‌ها در قالب خوانا برای انسان (human\-readable). .Sp مجاز به استفاده همزمان از \fI\-h\fR و \fI\-\-csv\fR نیستید. .IP \fB\-i\fR 4 .IX Item "-i" .PD 0 .IP \fB\-\-inodes\fR 4 .IX Item "--inodes" .PD چاپ اینودها (inodes) به جای بلوک‌ها. .IP \fB\-\-one\-per\-guest\fR 4 .IX Item "--one-per-guest" از زمان libguestfs 1.22، این حالت پیش‌فرض است. این گزینه هیچ کاری انجام نمی‌دهد و برای سازگاری با نسخه‌های قدیمی‌تر اسکریپت‌ها در اینجا باقی مانده است. .IP "\fB\-P\fR nr_threads" 4 .IX Item "-P nr_threads" از زمان libguestfs 1.22، دستور virt\-df چندنخی (multithreaded) است و ماشین‌های میهمان را به صورت موازی بررسی می‌کند. به طور پیش‌فرض، تعداد نخ‌ها بر اساس میزان حافظه آزاد در دسترس در زمان شروع virt\-df انتخاب می‌شود. با استفاده از گزینه \fI\-P\fR می‌توانید virt\-df را مجبور کنید حداکثر از \f(CW\*(C`nr_threads\*(C'\fR نخ استفاده کند. .Sp توجه داشته باشید که \fI\-P 0\fR به معنی تشخیص خودکار و \fI\-P 1\fR به معنی استفاده از یک نخ منفرد است. .IP \fB\-\-uuid\fR 4 .IX Item "--uuid" چاپ UUIDها به جای نام‌ها. این گزینه برای دنبال کردن یک ماشین میهمان حتی زمانی که ماشین مهاجرت داده شده یا تغییر نام یافته، یا زمانی که دو ماشین میهمان اتفاقاً نام یکسانی دارند مفید است. .Sp توجه داشته باشید که فقط دامنه‌هایی که از libvirt واکشی می‌کنیم دارای UUID هستند. برای ایمیج‌های دیسک، حتی با مشخص کردن این گزینه، همچنان نام ایمیج دیسک را چاپ می‌کنیم. .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\-x\fR 4 .IX Item "-x" فعال‌سازی ردیابی فراخوانی‌های API در libguestfs. .SH "اعداد STATVFS (STATVFS NUMBERS)" .IX Header "STATVFS NUMBERS" دستور \&\f(CW\*(C`virt\-df\*(C'\fR (و \fBdf\fR\|(1)) اطلاعات را با صدور یک فراخوانی سیستمی \fBstatvfs\fR\|(3) به دست می‌آورند. شما می‌توانید همان اطلاعات را مستقیماً چه از سیستم میزبان (با استفاده از libguestfs) یا از داخل ماشین میهمان به دست آورید: .IP "از سیستم میزبان" 4 .IX Item "From the host" اجرای این دستور: .Sp .Vb 1 \& guestfish \-\-ro \-d GuestName \-i statvfs / .Ve .Sp (برای مشاهده آمار سایر سیستم‌های فایل، \fI/\fR را تغییر دهید). .IP "از داخل ماشین میهمان" 4 .IX Item "From inside the guest" اجرای این دستور: .Sp .Vb 1 \& python \-c \*(Aqimport os; s = os.statvfs ("/"); print s\*(Aq .Ve .Sp (برای مشاهده آمار سایر سیستم‌های فایل، \fI/\fR را تغییر دهید). .SH "نکته‌ای درباره قالب CSV (NOTE ABOUT CSV FORMAT)" .IX Header "NOTE ABOUT CSV FORMAT" قالب مقادیر جداشده با کاما (CSV) قالبی فریبنده است. \fIبه نظر می‌رسد\fR که تجزیه آن باید آسان باشد، اما قطعاً تجزیه آن ساده نیست. .PP باور غلط: کافیست فیلدها را بر اساس کاما جدا کنید. واقعیت: این روش به صورت قابل اعتماد کار \fIنمی‌کند\fR. این مثال دو ستون دارد: .PP .Vb 1 \& "foo,bar",baz .Ve .PP باور غلط: فایل را خط به خط بخوانید. واقعیت: این روش به صورت قابل اعتماد کار \fIنمی‌کند\fR. این مثال یک سطر دارد: .PP .Vb 2 \& "foo \& bar",baz .Ve .PP برای اسکریپت‌های پوسته، از \f(CW\*(C`csvtool\*(C'\fR ( که در توزیع‌های عمده لینوکس نیز بسته‌بندی شده است) استفاده کنید. .PP برای زبان‌های دیگر، از یک کتابخانه پردازش CSV استفاده کنید (مانند \f(CW\*(C`Text::CSV\*(C'\fR برای Perl یا کتابخانه توکار csv در Python). .PP بیشتر صفحات گسترده و پایگاه‌های داده می‌توانند CSV را مستقیماً وارد کنند. .SH "وضعیت خروج (EXIT STATUS)" .IX Header "EXIT STATUS" این برنامه در صورت موفقیت مقدار ۰ و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBdf\fR\|(1), \&\fBguestfs\fR\|(3), \&\fBguestfish\fR\|(1), \&\fBvirt\-drivers\fR\|(1), \&\fBvirt\-filesystems\fR\|(1), . .SH "نویسنده (AUTHOR)" .IX Header "AUTHOR" Richard W.M. Jones .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" Copyright (C) 2009\-2025 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، از این پیوند استفاده کنید: .PP برای گزارش یک اشکال جدید در libguestfs، از این پیوند استفاده کنید: .PP هنگام گزارش اشکال، لطفاً موارد زیر را ارائه دهید: .IP \(bu 4 نسخه libguestfs. .IP \(bu 4 محل دریافت libguestfs (مثلاً کدام توزیع لینوکس، کامپایل از منبع و غیره). .IP \(bu 4 توصیف دقیق اشکال و روش بازتولید آن. .IP \(bu 4 دستور \fBlibguestfs\-test\-tool\fR\|(1) را اجرا کرده و خروجی \fBکامل و بدون ویرایش\fR آن را در گزارش اشکال قرار دهید.