gdu(1) General Commands Manual gdu(1)

gdu - تحلیل‌گر بسیار سریع مصرف دیسک نوشته‌شده به زبان Go

gdu [flags] [directory_to_scan]

تحلیل‌گر بسیار سریع مصرف دیسک نوشته‌شده به زبان Go.

ابزار gdu اصولاً برای دیسک‌های SSD در نظر گرفته شده است، جایی که می‌تواند به‌طور کامل از پردازش موازی بهره‌برداری کند. با این حال با دیسک‌های HDD نیز کار می‌کند، اما افزایش کارایی چندان چشمگیر نخواهد بود.

-h, --help[=false] راهنمای gdu

-i, --ignore-dirs=[/proc,/dev,/sys,/run] مسیرهایی که باید نادیده گرفته شوند (با کاما جدا می‌شوند). از هر دو مسیر مطلق و نسبی پشتیبانی می‌کند.

-I, --ignore-dirs-pattern الگوهای مسیری که باید نادیده گرفته شوند (با کاما جدا می‌شوند). از هر دو الگوی مسیر مطلق و نسبی پشتیبانی می‌کند.

-X, --ignore-from خواندن الگوهای مسیری که باید نادیده گرفته شوند از فایل. از هر دو الگوی مسیر مطلق و نسبی پشتیبانی می‌کند.

-T, --type انواع فایل‌هایی که باید لحاظ شوند (مانند –type yaml,json)

-E, --exclude-type انواع فایل‌هایی که باید مستثنی شوند (مانند –exclude-type yaml,json)

--max-age لحاظ کردن فایل‌هایی با mtime نه قدیمی‌تر از DURATION (مانند 7d، 2h30m، 1y2mo)

--min-age لحاظ کردن فایل‌هایی با mtime حداقل به قدمت DURATION (مانند 30d، 1w)

--since لحاظ کردن فایل‌هایی با mtime >= WHEN. مقدار WHEN برچسب زمانی RFC3339 (مانند 2025-08-11T01:00:00-07:00) یا فقط تاریخ YYYY-MM-DD (مقایسه روز تقویمی؛ شامل کل روز) را می‌پذیرد.

--until لحاظ کردن فایل‌هایی با mtime <= WHEN. مقدار WHEN برچسب زمانی RFC3339 یا فقط تاریخ YYYY-MM-DD را می‌پذیرد.

-l, --log-file="/dev/null" مسیر فایل لاگ

-m, --max-cores تعیین حداکثر هسته‌های پردازشی که gdu استفاده خواهد کرد.

-c, --no-color[=false] عدم استفاده از خروجی رنگی

-x, --no-cross[=false] عدم عبور از مرزهای سیستم‌فایل

-H, --no-hidden[=false] نادیده گرفتن پوشه‌های مخفی (که با نقطه آغاز می‌شوند)

-L, --follow-symlinks[=false] دنبال کردن پیوندهای نمادین برای فایل‌ها؛ یعنی نمایش اندازه فایلی که پیوند نمادین به آن اشاره دارد (پیوندهای نمادین به پوشه‌ها دنبال نمی‌شوند)

-n, --non-interactive[=false] عدم اجرا در حالت تعاملی

--interactive[=false] اجبار به استفاده از حالت تعاملی حتی اگر خروجی یک TTY نباشد

-p, --no-progress[=false] عدم نمایش میزان پیشرفت در حالت غیرتعاملی

-u, --no-unicode[=false] عدم استفاده از نمادهای یونیکد (برای نوار اندازه)

-s, --summarize[=false] تنها نمایش مجموع کل در حالت غیرتعاملی

-t, --top[=0] تنها نمایش X فایل بزرگ برتر در حالت غیرتعاملی

-d, --show-disks[=false] نمایش همه دیسک‌های سوارشده

-a, --show-apparent-size[=false] نمایش اندازه ظاهری

-C, --show-item-count[=false] نمایش تعداد اقلام موجود در پوشه

-k, --show-in-kib[=false] نمایش اندازه‌ها بر حسب KiB (یا kB به همراه –si) در حالت غیرتعاملی

-M, --show-mtime[=false] نمایش جدیدترین mtime اقلام موجود در پوشه

--show-symlink-target[=false] نمایش مقصد پیوند نمادین (name -> target) در فهرست فایل‌ها

--archive-browsing[=false] فعال‌سازی مرور بایگانی‌های zip/jar/tar (شامل فرمت‌های tar، tar.gz، tar.bz2، tar.xz)

--depth[=0] نمایش ساختار پوشه تا عمق مشخص‌شده در حالت غیرتعاملی (مقدار 0 به معنی نادیده گرفتن این گزینه است)

--collapse-path[=false] فشرده‌سازی زنجیره‌های پوشه‌ای تک‌فرزندی

--mouse[=false] استفاده از ماوس

--si[=false] نمایش اندازه‌ها با پیشوندهای دهدهی SI (مانند kB، MB، GB) به‌جای پیشوندهای دودویی (KiB، MiB، GiB)

--no-prefix[=false] نمایش اندازه‌ها به‌صورت اعداد خام بدون هیچ پیشوندی (SI یا دودویی) در حالت غیرتعاملی

--no-spawn-shell[=false] عدم اجازه برای باز کردن شل

--no-delete[=false] عدم اجازه برای حذف کردن

--no-view-file[=false] عدم اجازه برای مشاهده محتوای فایل

-f, --input-file درون‌ریزی تحلیل از یک فایل JSON. اگر نام فایل "-" باشد، از ورودی استاندارد خوانده می‌شود.

-o, --output-file برون‌ریزی تمام اطلاعات به یک فایل به‌صورت JSON. اگر نام فایل "-" باشد، در خروجی استاندارد نوشته می‌شود.

--config-file="$HOME/.gdu.yaml" خواندن پیکربندی از فایل

--write-config[=false] نوشتن پیکربندی فعلی در فایل (پیش‌فرض $HOME/.gdu.yaml است)

--enable-profiling[=false] فعال‌سازی جمع‌آوری داده‌های تحلیل کارایی (profiling) و ارائه آن روی http://localhost:6060/debug/pprof

-D, --db ذخیره تحلیل در پایگاه‌داده (.sqlite برای SQLite و .badger برای BadgerDB)

-r, --read-from-storage[=false] استفاده از پایگاه‌داده موجود به‌جای پویش مجدد

-v, --version[=false] چاپ نسخه

فایل‌ها و پوشه‌ها ممکن است دارای یک پیشوند تک‌نویسه‌ای با معانی زیر باشند:

!
هنگام خواندن این پوشه خطایی رخ داده است.
.
هنگام خواندن یکی از زیرپوشه‌ها خطایی رخ داده است، اندازه ممکن است درست نباشد.
@
فایل یک پیوند نمادین یا سوکت است. پیوندهای نمادین را می‌توان به‌صورت name -> target نشان داد (مقصد پیوند در کنار نام نمایش داده می‌شود، مانند خروجی ls -l).
همین فایل قبلاً شمارش شده است (پیوند سخت).
پوشه خالی است.
2026-03-31