انتخاب حالت (Mode Selection)

-h, --help

چاپ پیام راهنمای کوتاه و خروج.

-v, -V, --version

چاپ نسخه و خروج.

-f file

بارگذاری فایل مشخص‌شده که پیش‌تر با نشان -o یا -O ایجاد شده است. اگر file برابر با '-' باشد، فایل از ورودی استاندارد خوانده می‌شود. خواندن از ورودی استاندارد تنها برای قالب JSON پشتیبانی می‌شود.

به منظور جلوگیری از اشتباه و خرابی‌های ناخواسته، نسخهٔ فعلی ncdu فرض می‌کند اطلاعات دایرکتوری درون فایل واردشده، نمایانگر فایل‌سیستمی که فایل در آن وارد می‌شود نیست. بدین معنی که گزینه‌های نوسازی (refresh)، حذف فایل و اجرای پوسته در مرورگر غیرفعال خواهند شد.

dir

پویش دایرکتوری داده‌شده.

-o file

برون‌بری درخت دایرکتوری در قالب JSON به file به‌جای باز کردن رابط کاربری مرورگر. اگر file برابر با '-' باشد، داده‌ها در خروجی استاندارد نوشته می‌شوند. برای دیدن چند مورد کاربردی، بخش مثال‌ها در ادامه را ببینید.

توجه داشته باشید که هنگام برون‌بری دایرکتوری با تعداد فایل‌های زیاد، داده‌های برون‌بری‌شده ممکن است بسیار حجیم شوند. ۱۰٫۰۰۰ فایل خروجی‌ای در حدود ۶۰۰ تا ۷۰۰ کیبی‌بایت (KiB) فشرده‌نشده، یا کمی بیش از ۱۰۰ کیبی‌بایت در صورت فشرده‌سازی با gzip ایجاد می‌کند. این مقدار به‌صورت خطی افزایش می‌یابد، بنابراین هنگام کار با میلیون‌ها فایل آمادهٔ مدیریت چند ده مگابایت باشید.

برای تولید خروجی JSON فشرده‌شده با Zstandard، فعال‌سازی -c را مد نظر داشته باشید، چرا که می‌تواند حجم داده‌های برون‌بری‌شده را به‌میزان چشمگیری کاهش دهد.

هنگام اجرای یک پویش چندنخی (multi-threaded) یا پویش درخت دایرکتوری‌ای که ممکن است در حافظه جا نشود، استفاده از -O را به‌جای آن مد نظر قرار دهید.

-O file

برون‌بری درخت دایرکتوری در قالب باینری به file به‌جای باز کردن رابط کاربری مرورگر. اگر file برابر با '-' باشد، داده‌ها در خروجی استاندارد نوشته می‌شوند. قالب باینری دارای فشرده‌سازی درونی است، از برون‌بری چندنخی با مصرف حافظهٔ کم (در ترکیب با -t) پشتیبانی می‌کند و بدون نیاز به وارد کردن تمام درخت دایرکتوری در حافظه، قابل مرور است.

-e, --extended, --no-extended

فعال/غیرفعال کردن حالت اطلاعات گسترش‌یافته. این گزینه افزون بر اطلاعات معمول فایل، مالکیت، دسترسی‌ها و زمان آخرین تغییر را نیز برای هر فایل می‌خواند. این کار منجر به مصرف بیشتر حافظه (تقریباً حدود ۳۰٪) و فایلی بزرگ‌تر هنگام برون‌بری می‌شود.

هنگام استفاده از قابلیت برون‌بری/درون‌بری فایل، این نشان باید هم هنگام برون‌بری (جهت اطمینان از افزوده‌شدن اطلاعات به خروجی) و هم هنگام درون‌بری (جهت خواندن این اطلاعات اضافی در حافظه) داده شود. این نشان هنگام درون‌بری فایلی که بدون اطلاعات گسترش‌یافته برون‌بری شده، هیچ اثری ندارد.

این گزینه امکان مشاهده و مرتب‌سازی بر اساس تازه‌ترین زمان تغییر (mtime) فرزندان را با استفاده از 'm' و 'M' فراهم می‌کند.

--ignore-config

هیچ تلاشی برای بارگذاری فایل‌های پیکربندی صورت نگیرد.

گزینه‌های پویش (Scan Options)

این گزینه‌ها روند پویش را تحت تأثیر قرار می‌دهند؛ هنگام درون‌بری اطلاعات دایرکتوری از یک فایل، اثری ندارند.

-x, --one-file-system

از مرزهای فایل‌سیستم عبور نکن؛ یعنی فقط فایل‌ها و دایرکتوری‌های موجود روی همان فایل‌سیستمی که دایرکتوری در حال پویش روی آن قرار دارد را بشمار.

--cross-file-system

از مرزهای فایل‌سیستم عبور کن. این حالت پیش‌فرض است، اما می‌تواند برای باطل کردن -x تنظیم‌شدهٔ قبلی مشخص شود.

--exclude pattern

فایل‌هایی را که با pattern همخوانی دارند مستثنی کن. این فایل‌ها همچنان به‌طور پیش‌فرض نمایش داده می‌شوند، اما در آمار مصرف دیسک شمرده نمی‌شوند. این آرگومان می‌تواند چند بار برای افزودن الگوهای بیشتر تکرار شود.

-X, --exclude-from file

فایل‌هایی را که با هر الگویی در file همخوانی دارند مستثنی کن. الگوها باید با خط جدید (newline) از یکدیگر جدا شوند.

--include-caches, --exclude-caches

شامل کردن (پیش‌فرض) یا مستثنی کردن دایرکتوری‌های حاوی CACHEDIR.TAG. دایرکتوری‌های حافظهٔ موقت مستثنی‌شده همچنان نمایش داده می‌شوند، اما محتوای آن‌ها پویش نشده و در آمار مصرف دیسک شمرده نخواهد شد. https://bford.info/cachedir

-L, --follow-symlinks, --no-follow-symlinks

پیوندهای نمادین (symlinks) را دنبال کن (یا نکن) و اندازهٔ فایلی را که به آن اشاره می‌کنند حساب کن. این گزینه پیوندهای نمادین به دایرکتوری‌ها را دنبال نمی‌کند و باعث می‌شود هر فایل پیوندشده به‌عنوان یک فایل یکتا شمرده شود. این رفتار با نحوهٔ رفتار با پیوندهای سخت (hard links) متفاوت است. رفتار دقیق شمارش این نشان در آینده ممکن است تغییر کند.

--include-kernfs, --exclude-kernfs

(فقط لینوکس) شامل کردن (پیش‌فرض) یا مستثنی کردن شبه‌فایل‌سیستم‌های لینوکس نظیر /proc (procfs) و /sys (sysfs).

فهرست کامل شبه‌فایل‌سیستم‌های شناخته‌شدهٔ فعلی عبارت است از: binfmt, bpf, cgroup, cgroup2, debug, devpts, proc, pstore, security, selinux, sys, trace.

-t, --threads num

تعداد نخ‌های مورد استفاده هنگام پویش فایل‌سیستم؛ پیش‌فرض ۱ است.

در حالت تک‌نخی، برون‌بری JSON (ببینید -o) می‌تواند با حافظهٔ بسیار کمی کار کند، اما در حالت چندنخی ابتدا کل درخت دایرکتوری در حافظه ساخته شده و پس از پایان پویش فایل‌سیستم ذخیره می‌شود. این امر موجب ایجاد تاخیر در خروجی شده و برای درخت‌های دایرکتوری بزرگ به حافظهٔ بسیار بیشتری نیاز دارد. قالب باینری (ببینید -O) این مشکل را ندارد و از برون‌بری کارآمد با هر تعداد نخی پشتیبانی می‌کند.

گزینه‌های برون‌بری (Export Options)

این گزینه‌ها بر رفتار برنامه هنگام برون‌بری در فایل با گزینه‌های -o یا -O تأثیر می‌گذارند.

-c, --compress, --no-compress

فعال یا غیرفعال کردن فشرده‌سازی Zstandard هنگام برون‌بری به JSON (ببینید -o).

--compress-level num

تنظیم سطح فشرده‌سازی Zstandard هنگام استفاده از -O یا -c. مقادیر معتبر از ۱ (سریع‌ترین) تا ۱۹ (کندترین) هستند. پیش‌فرض ۴ است.

--export-block-size num

تنظیم اندازهٔ بلوک، بر حسب کیبی‌بایت، برای قالب برون‌بری باینری (ببینید -O). بلوک‌های بزرگ‌تر به حافظهٔ بیشتری نیاز دارند اما منجر به بهره‌وری فشرده‌سازی بهتری می‌شوند. این گزینه می‌تواند با مقدار بالاتری از --compress-level برای دستیابی به فشرده‌سازی حتی بهتر ترکیب شود.

مقادیر قابل‌قبول بین ۴ و ۱۶۰۰۰ هستند. پیش‌فرض این است که با ۶۴ کیبی‌بایت شروع شود و سپس برای خروجی‌های بزرگ اندازهٔ بلوک به‌تدریج افزایش یابد.

گزینه‌های رابط کاربری (Interface Options)

-0

هنگام پویش یک دایرکتوری یا درون‌بری یک فایل، هیچ بازخوردی ارائه نده، مگر زمانی که خطایی مرگبار رخ دهد. رابط ncurses تا زمان اتمام پویش مقداردهی اولیه نخواهد شد. هنگام برون‌بری داده‌ها با -o -، رابط ncurses اصلاً مقداردهی اولیه نمی‌شود. این گزینه هنگام برون‌بری به خروجی استاندارد، پیش‌فرض است.

-1

اطلاعات پیشرفت را در ترمینال بنویس، اما یک رابط تمام‌صفحهٔ ncurses باز نکن. این گزینه هنگام برون‌بری در یک فایل، پیش‌فرض است.

در برخی موارد، ممکن است رابط کاربری مرورگر ncurses که پس از پایان پویش/درون‌بری مشاهده می‌کنید، هنگام استفاده از این گزینه به‌هم‌ریخته به نظر برسد. اگر در حال برون‌بری به فایل نیستید، -2 معمولاً انتخاب بهتری است.

-2

هنگام پویش یک دایرکتوری یا درون‌بری یک فایل، یک رابط تمام‌صفحهٔ ncurses نمایش بده. این تنها رابطی است که هنگام پویش دربارهٔ خطاهای غیرمرگبار بازخورد ارائه می‌دهد.

-q, --slow-ui-updates, --fast-ui-updates

تغییر بازهٔ زمانی به‌روزرسانی رابط کاربری حین پویش یا درون‌بری. برنامهٔ ncdu به‌طور پیش‌فرض صفحه را ۱۰ بار در ثانیه به‌روزرسانی می‌کند (با --fast-ui-updates )؛ این مقدار می‌تواند با -q یا --slow-ui-updates به یک بار در هر ۲ ثانیه کاهش یابد. این گزینه می‌تواند برای صرفه‌جویی در پهنای باند روی اتصالات دوردست به کار رود. این گزینه در ترکیب با -0 اثری ندارد.

--enable-shell, --disable-shell

فعال یا غیرفعال کردن اجرای پوسته از مرورگر فایل. این ویژگی به‌طور پیش‌فرض هنگام پویش یک دایرکتوری زنده فعال و هنگام درون‌بری از فایل غیرفعال است.

--enable-delete, --disable-delete

فعال یا غیرفعال کردن ویژگی داخلی حذف فایل. این ویژگی به‌طور پیش‌فرض هنگام پویش یک دایرکتوری زنده فعال و هنگام درون‌بری از فایل غیرفعال است. غیرفعال کردن صریح ویژگی حذف می‌تواند به‌عنوان یک اقدام احتیاطی برای جلوگیری از حذف تصادفی داده‌ها عمل کند.

--enable-refresh, --disable-refresh

فعال یا غیرفعال کردن نوسازی (refresh) دایرکتوری از مرورگر فایل. این ویژگی به‌طور پیش‌فرض هنگام پویش یک دایرکتوری زنده فعال و هنگام درون‌بری از فایل غیرفعال است.

-r

حالت فقط‌خواندنی. وقتی یک‌بار داده شود، نام مستعاری برای --disable-delete است؛ اگر دوبار داده شود، --disable-shell را نیز می‌افزاید و به این ترتیب اطمینان حاصل می‌شود که هیچ راهی برای تغییر فایل‌سیستم از درون ncdu وجود ندارد.

--si, --no-si

فهرست کردن اندازه‌ها با استفاده از پیشوندهای پایهٔ ۱۰، یعنی توان‌های ۱۰۰۰ (kB، MB و غیره) طبق تعریف دستگاه بین‌المللی یکاها (SI)، به‌جای پیشوندهای معمول پایهٔ ۲ (KiB، MiB و غیره).

--disk-usage, --apparent-size

انتخاب نمایش فضای مصرفی دیسک (پیش‌فرض) یا اندازه‌های ظاهری. همچنین می‌تواند در مرورگر فایل با کلید 'a' تغییر وضعیت داده شود.

--show-hidden, --hide-hidden

نمایش (پیش‌فرض) یا پنهان کردن فایل‌های «پنهان» و مستثنی‌شده. همچنین می‌تواند در مرورگر فایل با کلید 'e' تغییر وضعیت داده شود.

--show-itemcount, --hide-itemcount

نمایش یا پنهان کردن (پیش‌فرض) ستون تعداد اقلام. همچنین می‌تواند در مرورگر فایل با کلید 'c' تغییر وضعیت داده شود.

--show-mtime, --hide-mtime

نمایش یا پنهان کردن (پیش‌فرض) ستون زمان آخرین تغییر. همچنین می‌تواند در مرورگر فایل با کلید 'm' تغییر وضعیت داده شود. این گزینه زمانی که در حالت گسترش‌یافته نیستید نادیده گرفته می‌شود؛ ببینید -e.

--show-graph, --hide-graph

نمایش (پیش‌فرض) یا پنهان کردن ستون نوار اندازهٔ نسبی. همچنین می‌تواند در مرورگر فایل با کلید 'g' تغییر وضعیت داده شود.

--show-percent, --hide-percent

نمایش (پیش‌فرض) یا پنهان کردن ستون درصد اندازهٔ نسبی. همچنین می‌تواند در مرورگر فایل با کلید 'g' تغییر وضعیت داده شود.

--graph-style hash | half-block | eighth-block

تغییر شیوهٔ رسم ستون نوار اندازهٔ نسبی. مقادیر شناخته‌شده عبارتند از hash برای رسم نویسه‌های '#' در اسکی (پیش‌فرض و بیشترین سازگاری)، half-block برای استفاده از نویسه‌های رسم نیم‌بلوک، یا eighth-block برای استفاده از نویسه‌های رسم یک‌هشتم‌بلوک. نویسه‌های یک‌هشتم‌بلوک دقیق‌ترین هستند اما ممکن است در تمام ترمینال‌ها به‌درستی نمایش داده نشوند.

--shared-column off | shared | unique

تنظیم روی off برای غیرفعال کردن ستون اندازهٔ مشترک برای دایرکتوری‌ها، shared (پیش‌فرض) برای نمایش اندازه‌های اشتراکی دایرکتوری در یک ستون مجزا، یا unique برای نمایش اندازه‌های یکتای دایرکتوری در یک ستون مجزا. بین این گزینه‌ها می‌توان در مرورگر فایل با کلید 'u' نیز به‌صورت چرخشی جابه‌جا شد.

--sort column

تغییر ستون پیش‌فرض برای مرتب‌سازی. مقادیر پذیرفته‌شده عبارتند از disk-usage (پیش‌فرض)، name ، apparent-size ، itemcount یا mtime. مورد آخر تنها در حالت گسترش‌یافته کاربرد دارد؛ ببینید -e.

نام ستون می‌تواند با پسوند -asc یا -desc همراه شود تا ترتیب را به‌ترتیب به صعودی یا نزولی تغییر دهد. برای نمونه، --sort=name-desc برای مرتب‌سازی بر اساس نام به‌صورت نزولی.

--enable-natsort, --disable-natsort

فعال کردن (پیش‌فرض) یا غیرفعال کردن مرتب‌سازی طبیعی (natural sort) هنگام مرتب‌سازی بر اساس نام فایل.

--group-directories-first, --no-group-directories-first

مرتب کردن (یا نکردن) دایرکتوری‌ها پیش از فایل‌ها.

--confirm-quit, --no-confirm-quit

الزام به تأیید پیش از خروج از ncdu. می‌تواند هنگامی مفید باشد که در حین یا پس از یک پویش بسیار طولانی، به‌طور تصادفی کلید 'q' را فشار می‌دهید.

--confirm-delete, --no-confirm-delete

الزام به تأیید پیش از حذف یک فایل یا دایرکتوری. به‌طور پیش‌فرض فعال است، اما اگر کاملاً مطمئن هستید که هرگز تصادفاً کلید 'd' را فشار نمی‌دهید، می‌تواند غیرفعال شود.

--delete-command command

هنگامی که روی یک رشتهٔ غیرخالی تنظیم شود، ویژگی داخلی حذف فایل با یک دستور سفارشی پوسته جایگزین می‌شود.

مسیر مطلق موردی که باید حذف شود به انتهای دستور داده‌شده ضمیمه شده و نتیجه در یک پوسته ارزیابی می‌شود. دستور از همان دایرکتوری‌ای اجرا می‌شود که ncdu از آن اجرا شده است. متغیر محیطی NCDU_DELETE_PATH روی مسیر مطلق موردی که باید حذف شود تنظیم می‌گردد و NCDU_LEVEL به همان شیوه‌ای که هنگام باز کردن یک پوسته از درون ncdu رفتار می‌شود، مقداردهی می‌گردد.

پس از اتمام دستور، نمای درون‌حافظه‌ای مورد انتخاب‌شده نوسازی شده و اندازهٔ دایرکتوری‌ها در صورت لزوم تعدیل می‌شود. این عمل نوسازی کامل کل درخت دایرکتوری نیست؛ بنابراین اگر مورد تغییر نام یافته باشد یا به دایرکتوری دیگری منتقل شده باشد، مکان جدید آن به‌طور خودکار شناسایی نخواهد شد.

برای نمونه، جهت استفاده از حالت تعاملی rm(1) برای پرسش پیش از هر حذف:

ncdu --no-confirm-delete --delete-command 'rm -ri --'

یا برای انتقال فایل‌ها به سطل زباله:

ncdu --delete-command 'gio trash --'

--color off | dark | dark-bg

تنظیم طرح رنگی. طرح‌های زیر شناخته شده‌اند: off برای غیرفعال کردن رنگ‌ها، dark برای طرح رنگی در نظر گرفته‌شده برای پس‌زمینه‌های تیره، و dark-bg برای گونه‌ای از طرح رنگی dark که در ترمینال‌های با پس‌زمینهٔ روشن نیز کار می‌کند.

حالت پیش‌فرض off است.