.TH DU 1 "September 2022" "GNU coreutils 9.1" "دستورات کاربر"
.SH "نام (NAME)"
du \- تخمین میزان فضای مصرفی فایل‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.B du
[\fI\,گزینه‌ها\/\fR]... [\fI\,فایل\/\fR]...
.br
.B du
[\fI\,گزینه‌ها\/\fR]... \fB\-\-files0\-from\fR=\fI\,F\/\fR
.SH "توضیحات (DESCRIPTION)"
خلاصه‌سازی میزان مصرف دیسک توسط مجموعه‌ای از \fIفایل‌ها\fR، به‌صورت بازگشتی برای دایرکتوری‌ها.
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.TP
\fB\-0\fR, \fB\-\-null\fR
پایان دادن به هر خط خروجی با نویسه NUL به جای خط جدید
.TP
\fB\-a\fR, \fB\-\-all\fR
نوشتن شمارش‌ها برای تمام فایل‌ها، نه فقط دایرکتوری‌ها
.TP
\fB\-\-apparent\-size\fR
چاپ اندازه‌های ظاهری به جای میزان مصرف دیسک؛ اگرچه اندازه ظاهری معمولاً کوچک‌تر است، اما ممکن است به دلیل وجود حفره‌ها در فایل‌های پراکنده (sparse)، تکه‌تکه شدن درونی (internal fragmentation)، بلوک‌های غیرمستقیم و موارد مشابه، بزرگ‌تر باشد
.TP
\fB\-B\fR, \fB\-\-block\-size\fR=\fI\,اندازه\/\fR
مقیاس‌بندی اندازه‌ها با \fIاندازه\fR پیش از چاپ آن‌ها؛ برای نمونه،
\fB\-BM\fR اندازه‌ها را در واحدهای ۱٬۰۴۸٬۵۷۶ بایتی چاپ می‌کند؛
قالب \fIاندازه\fR را در زیر ببینید
.TP
\fB\-b\fR, \fB\-\-bytes\fR
معادل با \(aq\-\-apparent\-size \fB\-\-block\-size\fR=\fI\,1\/\fR\(aq
.TP
\fB\-c\fR, \fB\-\-total\fR
ایجاد مجموع کل (جمع نهایی)
.TP
\fB\-D\fR, \fB\-\-dereference\-args\fR
پیمایش و ارجاع‌گشایی فقط برای پیوندهای نمادینی که در خط فرمان مشخص شده‌اند
.TP
\fB\-d\fR, \fB\-\-max\-depth\fR=\fI\,N\/\fR
چاپ مجموع برای یک دایرکتوری (یا فایل، با \fB\-\-all\fR) تنها در صورتی که در سطح N یا سطوح کمتری زیر آرگومان خط فرمان باشد؛
\fB\-\-max\-depth\fR=\fI\,0\/\fR مشابه \fB\-\-summarize\fR است
.TP
\fB\-\-files0\-from\fR=\fI\,F\/\fR
خلاصه‌سازی میزان مصرف دیسک برای نام‌های فایل خاتمه‌یافته با NUL که در فایل F مشخص شده‌اند؛
اگر F برابر با \- باشد، نام‌ها از ورودی استاندارد خوانده می‌شوند
.TP
\fB\-H\fR
معادل با \fB\-\-dereference\-args\fR (\fB\-D\fR)
.TP
\fB\-h\fR, \fB\-\-human\-readable\fR
چاپ اندازه‌ها در قالبی خوانا برای انسان (برای نمونه: 1K 234M 2G)
.TP
\fB\-\-inodes\fR
فهرست کردن اطلاعات مصرف اینود (inode) به جای مصرف بلوک
.TP
\fB\-k\fR
مشابه \fB\-\-block\-size\fR=\fI\,1K\/\fR
.TP
\fB\-L\fR, \fB\-\-dereference\fR
پیمایش و ارجاع‌گشایی تمام پیوندهای نمادین
.TP
\fB\-l\fR, \fB\-\-count\-links\fR
شمارش چندباره اندازه‌ها در صورت وجود پیوند سخت (hard link)
.TP
\fB\-m\fR
مشابه \fB\-\-block\-size\fR=\fI\,1M\/\fR
.TP
\fB\-P\fR, \fB\-\-no\-dereference\fR
عدم دنبال کردن هیچ‌یک از پیوندهای نمادین (این حالت پیش‌فرض است)
.TP
\fB\-S\fR, \fB\-\-separate\-dirs\fR
برای دایرکتوری‌ها، اندازه زیردایرکتوری‌ها را شامل نشود
.TP
\fB\-\-si\fR
مشابه \fB\-h\fR، اما استفاده از توان‌های ۱۰۰۰ به جای ۱۰۲۴
.TP
\fB\-s\fR, \fB\-\-summarize\fR
نمایش تنها یک مجموع کل برای هر آرگومان
.TP
\fB\-t\fR, \fB\-\-threshold\fR=\fI\,اندازه\/\fR
نادیده گرفتن مواردی که کوچک‌تر از \fIاندازه\fR هستند (در صورت مثبت بودن)، یا مواردی که بزرگ‌تر از \fIاندازه\fR هستند (در صورت منفی بودن)
.TP
\fB\-\-time\fR
نمایش زمان آخرین تغییر هر فایل در دایرکتوری یا هر یک از زیردایرکتوری‌های آن
.TP
\fB\-\-time\fR=\fI\,واژه\/\fR
نمایش زمان به عنوان \fIواژه\fR به جای زمان آخرین تغییر:
atime ،access ،use ،ctime یا status
.TP
\fB\-\-time\-style\fR=\fI\,سبک\/\fR
نمایش زمان‌ها با استفاده از \fIسبک\fR، که می‌تواند یکی از موارد زیر باشد:
full\-iso ،long\-iso ،iso یا +FORMAT؛
مقدار FORMAT همانند دستور \(aqdate\(aq تفسیر می‌شود
.TP
\fB\-X\fR, \fB\-\-exclude\-from\fR=\fI\,فایل\/\fR
مستثنی کردن فایل‌هایی که با هر الگویی درون \fIفایل\fR همخوانی دارند
.TP
\fB\-\-exclude\fR=\fI\,الگو\/\fR
مستثنی کردن فایل‌هایی که با \fIالگو\fR همخوانی دارند
.TP
\fB\-x\fR, \fB\-\-one\-file\-system\fR
نادیده گرفتن دایرکتوری‌ها در سیستم‌های فایل متفاوت
.TP
\fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.PP
مقادیر نمایشی در واحدهایی از نخستین \fIاندازه\fR در دسترس از \fB\-\-block\-size\fR و متغیرهای محیطی DU_BLOCK_SIZE ،BLOCK_SIZE و BLOCKSIZE هستند. در غیر این صورت، واحدها به‌طور پیش‌فرض ۱۰۲۴ بایت می‌باشند (یا ۵۱۲ در صورتی که POSIXLY_CORRECT تنظیم شده باشد).
.PP
آرگومان \fIاندازه\fR یک عدد صحیح و یک واحد اختیاری است (برای نمونه: 10K معادل 10*1024 است). واحدها عبارتند از K, M, G, T, P, E, Z, Y (توان‌های ۱۰۲۴) یا KB, MB,... (توان‌های ۱۰۰۰). پیشوندهای دودویی نیز می‌توانند استفاده شوند: KiB=K ،MiB=M و غیره.
.SH "الگوها (PATTERNS)"
مقدار PATTERN یک الگوی شل است (نه یک عبارت منظم / regular expression). الگوی
.B ?\&
با هر تک‌نویسه مطابقت دارد، در حالی که
.B *
با هر رشته‌ای (شامل صفر، یک یا چند نویسه) مطابقت پیدا می‌کند. برای نمونه،
.B *.o
با تمامی فایل‌هایی که نام آن‌ها به
.B .o
ختم می‌شود مطابقت خواهد داشت. بنابراین، دستور
.IP
.B du \-\-exclude=\(aq*.o\(aq
.PP
تمامی فایل‌ها و زیردایرکتوری‌هایی را که نامشان به
.B .o
ختم می‌شود (از جمله خود فایل
.BR .o )
نادیده می‌گیرد.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Torbjorn Granlund ،David MacKenzie ،Paul Eggert و Jim Meyering.
.SH "گزارش اشکالات (REPORTING BUGS)"
راهنمای برخط GNU coreutils: <https://www.gnu.org/software/coreutils/>
.br
گزارش هرگونه اشکال در ترجمه به: <https://translationproject.org/team/>
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2022 Free Software Foundation, Inc.
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>.
.br
این نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل در <https://www.gnu.org/software/coreutils/du>
.br
یا در دسترس به‌صورت محلی از طریق: \fBinfo \(aq(coreutils) du invocation\(aq\fR