.\" Automatically generated by Pandoc 3.5
.\"
.TH "gdu" "1" "2026\-03\-31" ""
.SH "نام (NAME)"
gdu \- تحلیل‌گر بسیار سریع مصرف دیسک نوشته‌شده به زبان Go
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]gdu [flags] [directory_to_scan]\f[R]
.SH "توضیحات (DESCRIPTION)"
تحلیل‌گر بسیار سریع مصرف دیسک نوشته‌شده به زبان Go.
.PP
ابزار gdu اصولاً برای دیسک‌های SSD در نظر گرفته شده است، جایی که می‌تواند به‌طور کامل از پردازش موازی بهره‌برداری کند.
با این حال با دیسک‌های HDD نیز کار می‌کند، اما افزایش کارایی چندان چشمگیر نخواهد بود.
.SH "گزینه‌ها (OPTIONS)"
\f[B]\-h\f[R], \f[B]\-\-help\f[R][=false] راهنمای gdu
.PP
\f[B]\-i\f[R], \f[B]\-\-ignore\-dirs\f[R]=[/proc,/dev,/sys,/run] مسیرهایی که باید نادیده گرفته شوند (با کاما جدا می‌شوند).
از هر دو مسیر مطلق و نسبی پشتیبانی می‌کند.
.PP
\f[B]\-I\f[R], \f[B]\-\-ignore\-dirs\-pattern\f[R] الگوهای مسیری که باید نادیده گرفته شوند (با کاما جدا می‌شوند).
از هر دو الگوی مسیر مطلق و نسبی پشتیبانی می‌کند.
.PP
\f[B]\-X\f[R], \f[B]\-\-ignore\-from\f[R] خواندن الگوهای مسیری که باید نادیده گرفته شوند از فایل.
از هر دو الگوی مسیر مطلق و نسبی پشتیبانی می‌کند.
.PP
\f[B]\-T\f[R], \f[B]\-\-type\f[R] انواع فایل‌هایی که باید لحاظ شوند (مانند \[en]type yaml,json)
.PP
\f[B]\-E\f[R], \f[B]\-\-exclude\-type\f[R] انواع فایل‌هایی که باید مستثنی شوند (مانند \[en]exclude\-type yaml,json)
.PP
\f[B]\-\-max\-age\f[R] لحاظ کردن فایل‌هایی با mtime نه قدیمی‌تر از DURATION (مانند 7d، 2h30m، 1y2mo)
.PP
\f[B]\-\-min\-age\f[R] لحاظ کردن فایل‌هایی با mtime حداقل به قدمت DURATION (مانند 30d، 1w)
.PP
\f[B]\-\-since\f[R] لحاظ کردن فایل‌هایی با mtime >= WHEN.
مقدار WHEN برچسب زمانی RFC3339 (مانند 2025\-08\-11T01:00:00\-07:00) یا فقط تاریخ YYYY\-MM\-DD (مقایسه روز تقویمی؛ شامل کل روز) را می‌پذیرد.
.PP
\f[B]\-\-until\f[R] لحاظ کردن فایل‌هایی با mtime <= WHEN.
مقدار WHEN برچسب زمانی RFC3339 یا فقط تاریخ YYYY\-MM\-DD را می‌پذیرد.
.PP
\f[B]\-l\f[R], \f[B]\-\-log\-file\f[R]=\[dq]/dev/null\[dq] مسیر فایل لاگ
.PP
\f[B]\-m\f[R], \f[B]\-\-max\-cores\f[R] تعیین حداکثر هسته‌های پردازشی که gdu استفاده خواهد کرد.
.PP
\f[B]\-c\f[R], \f[B]\-\-no\-color\f[R][=false] عدم استفاده از خروجی رنگی
.PP
\f[B]\-x\f[R], \f[B]\-\-no\-cross\f[R][=false] عدم عبور از مرزهای سیستم‌فایل
.PP
\f[B]\-H\f[R], \f[B]\-\-no\-hidden\f[R][=false] نادیده گرفتن پوشه‌های مخفی (که با نقطه آغاز می‌شوند)
.PP
\f[B]\-L\f[R], \f[B]\-\-follow\-symlinks\f[R][=false] دنبال کردن پیوندهای نمادین برای فایل‌ها؛ یعنی نمایش اندازه فایلی که پیوند نمادین به آن اشاره دارد (پیوندهای نمادین به پوشه‌ها دنبال نمی‌شوند)
.PP
\f[B]\-n\f[R], \f[B]\-\-non\-interactive\f[R][=false] عدم اجرا در حالت تعاملی
.PP
\f[B]\-\-interactive\f[R][=false] اجبار به استفاده از حالت تعاملی حتی اگر خروجی یک TTY نباشد
.PP
\f[B]\-p\f[R], \f[B]\-\-no\-progress\f[R][=false] عدم نمایش میزان پیشرفت در حالت غیرتعاملی
.PP
\f[B]\-u\f[R], \f[B]\-\-no\-unicode\f[R][=false] عدم استفاده از نمادهای یونیکد (برای نوار اندازه)
.PP
\f[B]\-s\f[R], \f[B]\-\-summarize\f[R][=false] تنها نمایش مجموع کل در حالت غیرتعاملی
.PP
\f[B]\-t\f[R], \f[B]\-\-top\f[R][=0] تنها نمایش X فایل بزرگ برتر در حالت غیرتعاملی
.PP
\f[B]\-d\f[R], \f[B]\-\-show\-disks\f[R][=false] نمایش همه دیسک‌های سوارشده
.PP
\f[B]\-a\f[R], \f[B]\-\-show\-apparent\-size\f[R][=false] نمایش اندازه ظاهری
.PP
\f[B]\-C\f[R], \f[B]\-\-show\-item\-count\f[R][=false] نمایش تعداد اقلام موجود در پوشه
.PP
\f[B]\-k\f[R], \f[B]\-\-show\-in\-kib\f[R][=false] نمایش اندازه‌ها بر حسب KiB (یا kB به همراه \[en]si) در حالت غیرتعاملی
.PP
\f[B]\-M\f[R], \f[B]\-\-show\-mtime\f[R][=false] نمایش جدیدترین mtime اقلام موجود در پوشه
.PP
\f[B]\-\-show\-symlink\-target\f[R][=false] نمایش مقصد پیوند نمادین (name -> target) در فهرست فایل‌ها
.PP
\f[B]\-\-archive\-browsing\f[R][=false] فعال‌سازی مرور بایگانی‌های zip/jar/tar (شامل فرمت‌های tar، tar.gz، tar.bz2، tar.xz)
.PP
\f[B]\-\-depth\f[R][=0] نمایش ساختار پوشه تا عمق مشخص‌شده در حالت غیرتعاملی (مقدار 0 به معنی نادیده گرفتن این گزینه است)
.PP
\f[B]\-\-collapse\-path\f[R][=false] فشرده‌سازی زنجیره‌های پوشه‌ای تک‌فرزندی
.PP
\f[B]\-\-mouse\f[R][=false] استفاده از ماوس
.PP
\f[B]\-\-si\f[R][=false] نمایش اندازه‌ها با پیشوندهای دهدهی SI (مانند kB، MB، GB) به‌جای پیشوندهای دودویی (KiB، MiB، GiB)
.PP
\f[B]\-\-no\-prefix\f[R][=false] نمایش اندازه‌ها به‌صورت اعداد خام بدون هیچ پیشوندی (SI یا دودویی) در حالت غیرتعاملی
.PP
\f[B]\-\-no\-spawn\-shell\f[R][=false] عدم اجازه برای باز کردن شل
.PP
\f[B]\-\-no\-delete\f[R][=false] عدم اجازه برای حذف کردن
.PP
\f[B]\-\-no\-view\-file\f[R][=false] عدم اجازه برای مشاهده محتوای فایل
.PP
\f[B]\-f\f[R], \f[B]\-\-input\-file\f[R] درون‌ریزی تحلیل از یک فایل JSON. اگر نام فایل \[dq]\-\[dq] باشد، از ورودی استاندارد خوانده می‌شود.
.PP
\f[B]\-o\f[R], \f[B]\-\-output\-file\f[R] برون‌ریزی تمام اطلاعات به یک فایل به‌صورت JSON. اگر نام فایل \[dq]\-\[dq] باشد، در خروجی استاندارد نوشته می‌شود.
.PP
\f[B]\-\-config\-file\f[R]=\[dq]$HOME/.gdu.yaml\[dq] خواندن پیکربندی از فایل
.PP
\f[B]\-\-write\-config\f[R][=false] نوشتن پیکربندی فعلی در فایل (پیش‌فرض $HOME/.gdu.yaml است)
.PP
\f[B]\-\-enable\-profiling\f[R][=false] فعال‌سازی جمع‌آوری داده‌های تحلیل کارایی (profiling) و ارائه آن روی http://localhost:6060/debug/pprof
.PP
\f[B]\-D\f[R], \f[B]\-\-db\f[R] ذخیره تحلیل در پایگاه‌داده (\f[I].sqlite\f[R] برای SQLite و \f[I].badger\f[R] برای BadgerDB)
.PP
\f[B]\-r\f[R], \f[B]\-\-read\-from\-storage\f[R][=false] استفاده از پایگاه‌داده موجود به‌جای پویش مجدد
.PP
\f[B]\-v\f[R], \f[B]\-\-version\f[R][=false] چاپ نسخه
.SH "پرچم‌های فایل (FILE FLAGS)"
فایل‌ها و پوشه‌ها ممکن است دارای یک پیشوند تک‌نویسه‌ای با معانی زیر باشند:
.TP
\f[B]!\f[R]
هنگام خواندن این پوشه خطایی رخ داده است.
.TP
\f[B].\f[R]
هنگام خواندن یکی از زیرپوشه‌ها خطایی رخ داده است، اندازه ممکن است درست نباشد.
.TP
\f[B]\[at]\f[R]
فایل یک پیوند نمادین یا سوکت است.
پیوندهای نمادین را می‌توان به‌صورت \f[I]name -> target\f[R] نشان داد (مقصد پیوند در کنار نام نمایش داده می‌شود، مانند خروجی \f[I]ls -l\f[R]).
.TP
\f[B]H\f[R]
همین فایل قبلاً شمارش شده است (پیوند سخت).
.TP
\f[B]e\f[R]
پوشه خالی است.