نام (NAME)

dfc - گزارش شکیل و با سبک از میزان استفاده از فضای دیسک سیستم‌فایل‌ها

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

dfc [گزینه(ها)] [-c WHEN] [-e FORMAT] [-p FSNAME] [-q SORTBY] [-t FSTYPE] [-u UNIT]

توضیحات (DESCRIPTION)

دستور dfc(1) ابزاری مشابه df(1) است، با این تفاوت که می‌تواند علاوه بر داده‌ها یک نمودار بصری نیز نمایش دهد و از رنگ‌ها استفاده کند (حالت رنگ پیش‌فرض "auto" است اما می‌تواند با گزینه "-c" تغییر یابد).

اندازه در دسترس، فضای موجود از دیدگاه کاربر عادی است و نه از دیدگاه کاربر ارشد (ریشه) (یعنی dfc(1) از f_bavail به‌جای f_bfree استفاده می‌کند).

بدون مشخص کردن گزینه‌ها، اندازه در قالبی خوانا برای انسان نمایش داده می‌شود. توجه داشته باشید که در صورت استفاده از این قالب، ممکن است خطاهای جزئی گرد کردن در هنگام محاسبه اندازه رخ دهد. اگر خواهان حداکثر دقت هستید، از گزینه "-u" استفاده کرده و واحد مورد نظر خود را انتخاب کنید.

دستور dfc(1) همچنین دارای قابلیتی است که به خروجی اجازه می‌دهد خود را به‌صورت خودکار با اندازه ترمینال تطبیق دهد. اگر می‌خواهید این رفتار را لغو کنید، از گزینه "-f" استفاده نمایید.

گزینه‌ها (OPTIONS)

-a

نمایش همه موارد (هیچ سیستم‌فایلی را نادیده نمی‌گیرد).

-b

غیرفعال کردن نمایش نمودار.

-c [WHEN]

امکان انتخاب رنگ، که در آن WHEN یکی از زیرگزینه‌های زیر است:

"always": همیشه از رنگ‌ها استفاده می‌شود، صرف‌نظر از این که stdout چه باشد.

"auto": این گزینه پیش‌فرض در صورت استفاده نکردن از "-c" است. رنگ‌ها تنها زمانی استفاده می‌شوند که خروجی استاندارد (stdout) یک ترمینال باشد. برای نمونه، اگر خروجی dfc(1) را به دستور دیگری هدایت (ریدایرکت) کنید، رنگ‌ها غیرفعال می‌شوند.

"never": رنگ‌ها هرگز استفاده نخواهند شد.

-d

نمایش فضای مصرف‌شده.

-e [FORMAT]

امکان صدور خروجی dfc(1) در قالب مشخص‌شده FORMAT. مقدار FORMAT یکی از موارد زیر است:

"csv": صدور به قالب CSV. نمونه استفاده:

dfc -e csv > foo.csv

"html": صدور به قالب HTML. نمونه استفاده:

dfc -e html -Tadiso -c always > index.html

"json": صدور به قالب JSON. نمونه استفاده:

dfc -e json -Tisod > report.json

"tex": صدور به قالب TeX. نمونه استفاده:

dfc -e tex -c always > report.tex

"text": خروجی متنی ساده (پیش‌فرض).

-f

لغو رفتار تطبیق خودکار با اجبار به نمایش کامل اطلاعات. این گزینه هنگام هدایت خروجی dfc(1) می‌تواند مفید باشد.

-h

نمایش یک راهنمای مختصر.

-i

نمایش اطلاعات مربوط به inodeها.

-l

نمایش اطلاعات تنها درباره سیستم‌فایل‌های سوارشده به‌صورت محلی.

-M

غیرفعال کردن نمایش ستون "سوارشده روی" (mounted on).

-m

استفاده از واحدهای SI (یعنی اندازه با استفاده از توان‌های 10 به‌جای توان‌های 2 محاسبه می‌شود).

-n

غیرفعال کردن نمایش سربرگ (header).

-o

نمایش گزینه‌های سوار کردن (mount options).

-p [FSNAME]

امکان فیلتر کردن بر اساس نام سیستم‌فایل. مقدار FSNAME می‌تواند هر مقداری باشد. برای نمونه، اگر می‌خواهید تنها سیستم‌فایل‌هایی را نمایش دهید که نام آن‌ها با "/dev" شروع می‌شود، از دستور زیر استفاده می‌کنید:

dfc -p /dev

این کار تنها سیستم‌فایل‌هایی را نمایش می‌دهد که نام آن‌ها برای مثال "/dev/sda1"، "/dev/root"، "/dev" و غیره باشد.

انتخاب چندگانه نیز امکان‌پذیر است. در این حالت، FSNAME باید به‌صورت فهرستی جداشده با کاما (بدون فاصله) باشد. برای نمونه، اگر می‌خواهید "/dev" و "tmpfs" را فیلتر کنید، دستور زیر را اجرا می‌کنید:

dfc -p /dev,tmpfs

همچنین استفاده از تطابق منفی برای فیلتر کردن خروجی ممکن است. در این حالت باید یک علامت "-" به ابتدای FSNAME اضافه شود. در مثال زیر، dfc(1) تمام سیستم‌فایل‌ها به جز موارد ذکرشده را نمایش می‌دهد:

dfc -p -proc,/dev/sdc,run

-q [SORTBY]

امکان مرتب‌سازی خروجی بر اساس معیار SORTBY.

مقدار SORTBY می‌تواند یکی از این سه مورد باشد: "name"، "type"، "mount".

با استفاده از "name"، خروجی بر اساس نام سیستم‌فایل مرتب می‌شود. با استفاده از "type"، خروجی بر اساس نوع سیستم‌فایل مرتب می‌شود. با استفاده از "mount"، خروجی بر اساس نقطه مانت مرتب می‌گردد.

-s

محاسبه و نمایش مجموع مصرف کل.

-t [FSTYPE]

امکان فیلتر کردن بر اساس نوع سیستم‌فایل. FSTYPE می‌تواند هر نوع شناخته‌شده‌ای از سیستم‌فایل باشد. برای نمونه: "ext4"، "ufs"، "tmpfs"، "reiserfs" و غیره. همچنین مانند گزینه -p می‌توان با ارائه نام جزئی فیلتر را اعمال کرد. برای مثال اگر از دستور زیر استفاده کنید:

dfc -t ext

این کار هر سیستم‌فایلی که نام نوع آن با "ext" شروع شود را فیلتر می‌کند، مانند "ext2"، "ext3" و "ext4".

انتخاب چندگانه نیز ممکن است. در این حالت، FSTYPE باید فهرستی جداشده با کاما (بدون فاصله) باشد. برای نمونه اگر می‌خواهید "ext4" و "tmpfs" را فیلتر کنید:

dfc -t ext4,tmpfs

همچنین می‌توان از تطابق منفی استفاده کرد. در این حالت باید علامت "-" در ابتدای FSTYPE قرار گیرد. در مثال زیر، dfc(1) همه سیستم‌فایل‌ها به‌جز موارد ذکرشده را نمایش می‌دهد:

dfc -t -rootfs,tmpfs

-T

نمایش نوع سیستم‌فایل.

-u [UNIT]

نمایش اندازه در واحد مشخص‌شده. مقدار UNIT می‌تواند هر یک از مقادیر زیر باشد:

"h": قالب خوانا برای انسان (پیش‌فرض در صورت عدم استفاده از گزینه "-u").

"b": نمایش تعداد بایت‌ها.

"k": نمایش اندازه بر حسب KiB.

"m": نمایش اندازه بر حسب MiB.

"g": نمایش اندازه بر حسب GiB.

"t": نمایش اندازه بر حسب TiB.

"p": نمایش اندازه بر حسب PiB.

"e": نمایش اندازه بر حسب EiB.

"z": نمایش اندازه بر حسب ZiB.

"y": نمایش اندازه بر حسب YiB.

نکته: هنگامی که گزینه "-u" هم‌زمان با گزینه "-m" استفاده شود، این زیرگزینه‌ها با معادل‌های استاندارد SI خود جایگزین می‌شوند.

-v

نمایش نسخه dfc(1) و خروج.

-w

استفاده از میله عریض‌تر برای نمودار.

-W

نام‌های عریض فایل‌ها (جلوگیری از بریده شدن نام فایل‌ها). ممکن است به نمایشگر عریض‌تری نیاز داشته باشد.

فایل پیکربندی (CONFIGURATION FILE)

فایل پیکربندی اختیاری است. این فایل امکان تغییر رنگ‌های پیش‌فرض، مقادیری که در آن‌ها رنگ تغییر می‌کند، نماد نمودار dfc(1) در حالت متنی و همچنین اصلاح رنگ‌های مورداستفاده هنگام صدور به HTML را فراهم می‌سازد.

اگر مایل به استفاده از آن هستید، باید در این مسیر قرار گیرد:

$XDG_CONFIG_HOME/dfc/dfcrc

اگر سیستم‌عامل شما از مشخصات پوشه‌های XDG پشتیبانی نمی‌کند، باید در این مسیر قرار گیرد:

$HOME/.config/dfc/dfcrc

یا به‌عنوان آخرین انتخاب:

$HOME/.dfcrc

نکته: دو مورد آخر تنها زمانی قابل انتخاب هستند که سیستم‌عامل شما از مشخصات XDG پشتیبانی نکند.