.TH DUF 1 "2025-09-08" "duf" "Disk Usage/Free Utility"
.SH "نام (NAME)"
duf \- ابزار بررسی فضای مصرفی و آزاد دیسک
.SH "خلاصه دستور (SYNOPSIS)"
\fBduf\fP [\fIoptions\&.\&.\&.\fP] [\fIargument\&.\&.\&.\fP]
.SH "توضیحات (DESCRIPTION)"
ابزار ساده برای بررسی فضای مصرفی و آزاد دیسک\&.
.PP
ویژگی‌ها:
.PP
.RS
.IP \(bu 3
خروجی رنگی و کاربرپسند\&.
.IP \(bu 3
تنظیم خودکار با تم و پهنای ترمینال شما\&.
.IP \(bu 3
مرتب‌سازی نتایج بر اساس نیازهای شما\&.
.IP \(bu 3
گروه‌بندی و پالایش دستگاه‌ها\&.
.IP \(bu 3
امکان تولید خروجی با ساختار JSON\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-all\fP
شامل سامانه‌های فایل کاذب، تکراری و غیرقابل‌دسترس
.TP
\fB-avail-threshold\fP
آستانه رنگ‌بندی (زرد، قرمز) ستون فضای در دسترس را مشخص می‌کند؛ باید یک عدد صحیح با پیشوندهای اختیاری SI باشد
.TP
\fB-hide\fP
پنهان‌سازی دستگاه‌های خاص، با کاما جدا شوند: local, network, fuse, special, loops, binds
.TP
\fB-hide-fs\fP
پنهان‌سازی سامانه‌های فایل خاص، با کاما جدا شوند
.TP
\fB-hide-mp\fP
پنهان‌سازی نقاط اتصال خاص، با کاما جدا شوند (از نویسه‌های عام پشتیبانی می‌کند)
.TP
\fB-inodes\fP
فهرست کردن اطلاعات گره‌های آی‌نود (inode) به‌جای میزان مصرف بلوک‌ها
.TP
\fB-json\fP
نمایش خروجی تمام دستگاه‌ها در قالب JSON
.TP
\fB-only\fP
نمایش تنها دستگاه‌های خاص، با کاما جدا شوند: local, network, fuse, special, loops, binds
.TP
\fB-only-fs\fP
تنها سامانه‌های فایل خاص، با کاما جدا شوند
.TP
\fB-only-mp\fP
تنها نقاط اتصال خاص، با کاما جدا شوند (از نویسه‌های عام پشتیبانی می‌کند)
.TP
\fB-output\fP
فیلدهای خروجی: mountpoint, size, used, avail, usage, inodes, inodes_used, inodes_avail, inodes_usage, type, filesystem
.TP
\fB-sort\fP
مرتب‌سازی خروجی بر اساس: mountpoint, size, used, avail, usage, inodes, inodes_used, inodes_avail, inodes_usage, type, filesystem
.TP
\fB-style\fP
سبک: unicode, ascii
.TP
\fB-theme\fP
تم‌های رنگی: dark, light, ansi
.TP
\fB-usage-threshold\fP
آستانه رنگ‌بندی (زرد، قرمز) نوارهای مصرف را به عنوان یک عدد اعشاری بین 0 تا 1 تعیین می‌کند
.TP
\fB-version\fP
نمایش نسخه
.TP
\fB-warnings\fP
ارسال تمام هشدارها به خروجی خطای استاندارد (STDERR)
.TP
\fB-width\fP
حداکثر پهنای خروجی
.SH "نحوه استفاده (USAGE)"
می‌توانید duf را به‌سادگی و بدون هیچ آرگومان خط فرمانی اجرا کنید:
.PP
.PP
  $ duf
.PP
.PP
اگر آرگومان‌هایی ارائه دهید، duf تنها دستگاه‌ها و نقاط اتصال خاص را فهرست می‌کند:
.PP
.PP
  $ duf /home /some/file
.PP
.PP
اگر می‌خواهید همه چیز را فهرست کنید (شامل سامانه‌های فایل کاذب، تکراری و غیرقابل دسترس):
.PP
.PP
  $ duf --all
.PP
.PP
می‌توانید جدول‌های خاصی را نمایش داده یا پنهان کنید:
.PP
.PP
  $ duf --only local,network,fuse,special,loops,binds
.PP
  $ duf --hide local,network,fuse,special,loops,binds
.PP
.PP
همچنین می‌توانید سامانه‌های فایل خاصی را نمایش داده یا پنهان کنید:
.PP
.PP
  $ duf --only-fs tmpfs,vfat
.PP
  $ duf --hide-fs tmpfs,vfat
.PP
.PP
\&.\&.\&.یا نقاط اتصال مشخص:
.PP
.PP
  $ duf --only-mp /,/home,/dev
.PP
  $ duf --hide-mp /,/home,/dev
.PP
.PP
نویسه‌های عام (wildcards) داخل علامت‌های نقل‌قول کار می‌کنند:
.PP
.PP
  $ duf --only-mp '/sys/*,/dev/*'
.PP
.PP
مرتب‌سازی خروجی:
.PP
.PP
  $ duf --sort size
.PP
.PP
کلیدهای معتبر عبارتند از: mountpoint, size, used, avail, usage, inodes, inodes_used, inodes_avail, inodes_usage, type, filesystem\&.
.PP
.PP
نمایش یا پنهان‌سازی ستون‌های مشخص:
.PP
.PP
  $ duf --output mountpoint,size,usage
.PP
.PP
کلیدهای معتبر عبارتند از: mountpoint, size, used, avail, usage, inodes, inodes_used, inodes_avail, inodes_usage, type, filesystem\&.
.PP
.PP
فهرست کردن اطلاعات گره‌های آی‌نود به‌جای میزان مصرف بلوک‌ها:
.PP
.PP
  $ duf --inodes
.PP
.PP
اگر duf رنگ‌های ترمینال شما را به‌درستی تشخیص نمی‌دهد، می‌توانید یک تم تنظیم کنید:
.PP
.PP
  $ duf --theme light
.PP
.PP
ابزار duf ستون‌های در دسترس بودن و میزان مصرف را بسته به میزان فضای باقیمانده، به رنگ قرمز، سبز یا زرد برجسته می‌کند\&. شما می‌توانید آستانه‌های اختصاصی خود را تعیین کنید:
.PP
.PP
  $ duf --avail-threshold="10G,1G"
.PP
  $ duf --usage-threshold="0\&.5,0\&.9"
.PP
.PP
اگر ترجیح می‌دهید خروجی در قالب JSON باشد:
.PP
.PP
  $ duf --json
.PP
.SH "نکات (NOTES)"
بخش‌هایی از کد duf از https://github.com/shirou/gopsutil کپی و اصلاح شده است\&.
.PP
پروژهٔ gopsutil توسط WAKAYAMA Shirou نوشته شده و تحت پروانه BSD-3-Clause منتشر شده است\&.
.SH "نویسندگان (AUTHORS)"
برنامهٔ duf توسط Christian Muehlhaeuser <https://github.com/muesli/duf> نوشته شده است\&.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر (C) ۲۰۲۰-۲۰۲۲ Christian Muehlhaeuser <https://github.com/muesli>
.PP
تحت پروانه MIT منتشر شده است\&.