.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH Dust 1  "Dust 1.2.5" 
.SH "نام (NAME)"
dust \- ابزاری مشابه du اما شهودی‌تر برای نمایش مصرف دیسک
.SH "خلاصه دستور (SYNOPSIS)"
\fBdust\fR [\fB\-d\fR|\fB\-\-depth\fR] [\fB\-T\fR|\fB\-\-threads\fR] [\fB\-\-config\fR] [\fB\-n\fR|\fB\-\-number\-of\-lines\fR] [\fB\-p\fR|\fB\-\-full\-paths\fR] [\fB\-X\fR|\fB\-\-ignore\-directory\fR] [\fB\-I\fR|\fB\-\-ignore\-all\-in\-file\fR] [\fB\-L\fR|\fB\-\-dereference\-links\fR] [\fB\-x\fR|\fB\-\-limit\-filesystem\fR] [\fB\-s\fR|\fB\-\-apparent\-size\fR] [\fB\-r\fR|\fB\-\-reverse\fR] [\fB\-c\fR|\fB\-\-no\-colors\fR] [\fB\-C\fR|\fB\-\-force\-colors\fR] [\fB\-\-dim\fR] [\fB\-b\fR|\fB\-\-no\-percent\-bars\fR] [\fB\-B\fR|\fB\-\-bars\-on\-right\fR] [\fB\-z\fR|\fB\-\-min\-size\fR] [\fB\-R\fR|\fB\-\-screen\-reader\fR] [\fB\-\-skip\-total\fR] [\fB\-f\fR|\fB\-\-filecount\fR] [\fB\-i\fR|\fB\-\-ignore\-hidden\fR] [\fB\-v\fR|\fB\-\-invert\-filter\fR] [\fB\-e\fR|\fB\-\-filter\fR] [\fB\-t\fR|\fB\-\-file\-types\fR] [\fB\-w\fR|\fB\-\-terminal\-width\fR] [\fB\-P\fR|\fB\-\-no\-progress\fR] [\fB\-\-print\-errors\fR] [\fB\-D\fR|\fB\-\-only\-dir\fR] [\fB\-F\fR|\fB\-\-only\-file\fR] [\fB\-o\fR|\fB\-\-output\-format\fR] [\fB\-S\fR|\fB\-\-stack\-size\fR] [\fB\-j\fR|\fB\-\-output\-json\fR] [\fB\-M\fR|\fB\-\-mtime\fR] [\fB\-A\fR|\fB\-\-atime\fR] [\fB\-y\fR|\fB\-\-ctime\fR] [\fB\-\-files0\-from\fR] [\fB\-\-files\-from\fR] [\fB\-\-collapse\fR] [\fB\-m\fR|\fB\-\-filetime\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fIPATH\fR] 
.SH "توضیحات (DESCRIPTION)"
مشابه دستور du، اما با نمایش گرافیکی بصری‌تر و فهم‌پذیرتر میزان فضای مصرفی دیسک.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-d\fR, \fB\-\-depth\fR \fI<DEPTH>\fR
عمق نمایش درخت دایرکتوری
.TP
\fB\-T\fR, \fB\-\-threads\fR \fI<THREADS>\fR
تعداد نخ‌های پردازشی (threads) مورد استفاده
.TP
\fB\-\-config\fR \fI<FILE>\fR
مشخص کردن یک فایل پیکربندی برای استفاده
.TP
\fB\-n\fR, \fB\-\-number\-of\-lines\fR \fI<NUMBER>\fR
نمایش \*(Aqn\*(Aq ورودی بزرگ‌تر (پیش‌فرض برابر با ارتفاع ترمینال یا terminal_height است)
.TP
\fB\-p\fR, \fB\-\-full\-paths\fR
مسیر زیردایرکتوری‌ها کوتاه نشود (نمایش مسیر کامل)
.TP
\fB\-X\fR, \fB\-\-ignore\-directory\fR \fI<PATH>\fR
مستثنی کردن هر فایل یا دایرکتوری با این مسیر
.TP
\fB\-I\fR, \fB\-\-ignore\-all\-in\-file\fR \fI<FILE>\fR
مستثنی کردن هر فایل یا دایرکتوری با عبارت منظمی (regex) که با موارد درون این فایل مطابقت داشته باشد؛ ورودی‌های این فایل به الگوهای نادیده‌گیری ارائه‌شده توسط \-\-invert\-filter اضافه خواهند شد
.TP
\fB\-L\fR, \fB\-\-dereference\-links\fR
ارجاع‌گشایی و پیمایش پیوندهای نمادین \- پیوندهای نمادین مانند دایرکتوری در نظر گرفته شده و وارد آن‌ها می‌شود
.TP
\fB\-x\fR, \fB\-\-limit\-filesystem\fR
فقط شمارش فایل‌ها و دایرکتوری‌هایی که روی همان سیستم‌فایل دایرکتوری ارائه‌شده قرار دارند
.TP
\fB\-s\fR, \fB\-\-apparent\-size\fR
استفاده از اندازه ظاهری فایل به جای تعداد بلوک‌ها
.TP
\fB\-r\fR, \fB\-\-reverse\fR
چاپ درخت به صورت معکوس (بزرگ‌ترین‌ها در بالا)
.TP
\fB\-c\fR, \fB\-\-no\-colors\fR
هیچ رنگی چاپ نشود (مناسب برای دستوراتی مانند watch)
.TP
\fB\-C\fR, \fB\-\-force\-colors\fR
اجبار به چاپ رنگی خروجی
.TP
\fB\-\-dim\fR
کم‌نور کردن میله‌های درصدی (رنگ خاکستری) برای کاهش روشنایی در ترمینال‌های تاریک
.TP
\fB\-b\fR, \fB\-\-no\-percent\-bars\fR
هیچ میله درصدی یا مقدار درصدی نمایش داده نشود
.TP
\fB\-B\fR, \fB\-\-bars\-on\-right\fR
انتقال میله‌های درصدی به سمت راست صفحه
.TP
\fB\-z\fR, \fB\-\-min\-size\fR \fI<MIN_SIZE>\fR
حداقل اندازه فایل برای گنجانده شدن در خروجی
.TP
\fB\-R\fR, \fB\-\-screen\-reader\fR
ویژه صفحه‌خوان‌ها. میله‌ها را حذف کرده و ستون جدیدی برای سطح عمق اضافه می‌کند (می‌توانید برای مسیر کامل از \-p نیز استفاده کنید)
.TP
\fB\-\-skip\-total\fR
ردیف مجموع کل نمایش داده نشود
.TP
\fB\-f\fR, \fB\-\-filecount\fR
محاسبه «اندازه» دایرکتوری بر اساس تعداد فایل‌های فرزند به جای اندازه دیسک
.TP
\fB\-i\fR, \fB\-\-ignore\-hidden\fR
عدم نمایش فایل‌های پنهان
.TP
\fB\-v\fR, \fB\-\-invert\-filter\fR \fI<REGEX>\fR
مستثنی کردن مسیر فایل‌های مطابق با این عبارت منظم. برای نادیده گرفتن فایل‌های png وارد کنید: \-v "\\.png$"
.TP
\fB\-e\fR, \fB\-\-filter\fR \fI<REGEX>\fR
تنها شامل کردن مسیر فایل‌های مطابق با این عبارت منظم. برای فایل‌های png وارد کنید: \-e "\\.png$"
.TP
\fB\-t\fR, \fB\-\-file\-types\fR
نمایش تنها این نوع فایل‌ها
.TP
\fB\-w\fR, \fB\-\-terminal\-width\fR \fI<WIDTH>\fR
تعیین عرض خروجی با نادیده گرفتن تشخیص خودکار عرض ترمینال
.TP
\fB\-P\fR, \fB\-\-no\-progress\fR
غیرفعال کردن نمایش پیشرفت کار
.TP
\fB\-\-print\-errors\fR
چاپ خطاها در خروجی استاندارد خطا (stderr)
.TP
\fB\-D\fR, \fB\-\-only\-dir\fR
فقط دایرکتوری‌ها نمایش داده شوند
.TP
\fB\-F\fR, \fB\-\-only\-file\fR
فقط فایل‌ها نمایش داده شوند (یافتن بزرگ‌ترین فایل‌های شما)
.TP
\fB\-o\fR, \fB\-\-output\-format\fR \fI<FORMAT>\fR
تغییر قالب خروجی. مقدار si اندازه‌ها را بر مبنای توان‌های ۱۰۰۰ چاپ می‌کند. مقادیر b k m g t kb mb gb tb کل درخت را بر حسب آن واحد چاپ می‌کنند
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
si: پیشوند SI (توان‌های ۱۰۰۰)
.IP \(bu 2
b: بایت (B)
.IP \(bu 2
k: کیبی‌بایت (KiB)
.IP \(bu 2
m: مبی‌بایت (MiB)
.IP \(bu 2
g: گیبی‌بایت (GiB)
.IP \(bu 2
t: تبی‌بایت (TiB)
.IP \(bu 2
kb: کیلوبایت (kB)
.IP \(bu 2
mb: مگابایت (MB)
.IP \(bu 2
gb: گیگابایت (GB)
.IP \(bu 2
tb: ترابایت (TB)
.RE
.TP
\fB\-S\fR, \fB\-\-stack\-size\fR \fI<STACK_SIZE>\fR
مشخص کردن میزان حافظه برای استفاده به عنوان اندازه پشته (stack) \- در صورت مشاهده خطای: \*(Aqfatal runtime error: stack overflow\*(Aq استفاده شود (پیش‌فرض حافظه کم=1048576، حافظه زیاد=1073741824)
.TP
\fB\-j\fR, \fB\-\-output\-json\fR
خروجی دادن درخت دایرکتوری در قالب JSON در دایرکتوری جاری
.TP
\fB\-M\fR, \fB\-\-mtime\fR \fI<MTIME>\fR
مقدار +/\-n با فایل‌هایی که بیشتر/کمتر از n روز پیش تغییر یافته‌اند و n با فایل‌هایی که دقیقاً n روز پیش تغییر یافته‌اند تطابق دارد؛ روزها به پایین گرد می‌شوند. به این صورت که +n => (−∞, curr−(n+1)) و n => [curr−(n+1), curr−n) و \-n => (curr−n, +∞)
.TP
\fB\-A\fR, \fB\-\-atime\fR \fI<ATIME>\fR
مشابه \-\-mtime، اما بر اساس زمان دسترسی به فایل
.TP
\fB\-y\fR, \fB\-\-ctime\fR \fI<CTIME>\fR
مشابه \-\-mtime، اما بر اساس زمان تغییر وضعیت فایل
.TP
\fB\-\-files0\-from\fR \fI<FILES0_FROM>\fR
خواندن مسیرهای پایان‌یافته با نویسه NUL از FILE (از \*(Aq\-\*(Aq برای ورودی استاندارد استفاده کنید)
.TP
\fB\-\-files\-from\fR \fI<FILES_FROM>\fR
خواندن مسیرهای پایان‌یافته با خط جدید از FILE (از \*(Aq\-\*(Aq برای ورودی استاندارد استفاده کنید)
.TP
\fB\-\-collapse\fR \fI<COLLAPSE>\fR
بسته نگه داشتن این دایرکتوری‌ها (جمع شدن شاخه‌ها)
.TP
\fB\-m\fR, \fB\-\-filetime\fR \fI<FILETIME>\fR
محاسبه «اندازه» دایرکتوری بر اساس بیشترین زمان فایل در میان فایل‌های فرزند به جای اندازه دیسک؛ استفاده از گزینه‌های a/c/m برای زمان آخرین دسترسی/تغییر وضعیت/تغییر محتوا
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
a: زمان آخرین دسترسی
.IP \(bu 2
c: زمان آخرین تغییر وضعیت
.IP \(bu 2
m: زمان آخرین تغییر محتوا
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq)
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ نسخه
.TP
[\fIPATH\fR]
فایل‌ها یا دایرکتوری‌های ورودی
.SH "نسخه (VERSION)"
v1.2.5