.TH DIR 1 "September 2022" "GNU coreutils 9.1" "دستورات کاربر"
.SH "نام (NAME)"
dir \- فهرست کردن محتویات دایرکتوری
.SH "خلاصه دستور (SYNOPSIS)"
.B dir
[\fI\,گزینه‌ها\/\fR]... [\fI\,فایل\/\fR]...
.SH "توضیحات (DESCRIPTION)"
اطلاعات مربوط به \fIفایل\fRها را فهرست می‌کند (به‌طور پیش‌فرض دایرکتوری جاری).
اگر هیچ‌یک از گزینه‌های \fB\-cftuvSUX\fR یا \fB\-\-sort\fR مشخص نشده باشد، ورودی‌ها بر اساس حروف الفبا مرتب می‌شوند.
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.TP
\fB\-a\fR, \fB\-\-all\fR
ورودی‌هایی که با نقطه (.) شروع می‌شوند نادیده گرفته نشوند
.TP
\fB\-A\fR, \fB\-\-almost\-all\fR
ورودی‌های ضمنی . و .. فهرست نشوند
.TP
\fB\-\-author\fR
همراه با \fB\-l\fR، نویسنده هر فایل چاپ شود
.TP
\fB\-b\fR, \fB\-\-escape\fR
کاراکترهای غیرگرافیکی با فرمت گریز (escape) زبان C چاپ شوند
.TP
\fB\-\-block\-size\fR=\fI\,SIZE\/\fR
همراه با \fB\-l\fR، اندازه‌ها را با مقیاس \fISIZE\fR چاپ کند؛ مانند \fB\-\-block\-size\fR=M؛ قالب \fISIZE\fR در ادامه آمده است
.TP
\fB\-B\fR, \fB\-\-ignore\-backups\fR
ورودی‌های ضمنی که به ~ ختم می‌شوند فهرست نشوند
.TP
\fB\-c\fR
همراه با \fB\-lt\fR: مرتب‌سازی بر اساس \fBctime\fR (زمان آخرین تغییر در اطلاعات وضعیت فایل) و نمایش آن؛ همراه با \fB\-l\fR: نمایش \fBctime\fR و مرتب‌سازی بر اساس نام؛ در غیر این صورت: مرتب‌سازی بر اساس \fBctime\fR، جدیدترین در ابتدا
.TP
\fB\-C\fR
فهرست کردن ورودی‌ها به‌صورت ستونی
.TP
\fB\-\-color\fR[=\fI\,WHEN\/\fR]
رنگی‌کردن خروجی طبق \fIWHEN\fR؛ توضیحات بیشتر در ادامه آمده است
.TP
\fB\-d\fR, \fB\-\-directory\fR
فهرست کردن خود دایرکتوری‌ها، نه محتویات آن‌ها
.TP
\fB\-D\fR, \fB\-\-dired\fR
تولید خروجی طراحی‌شده برای حالت dired در ایمکس (Emacs)
.TP
\fB\-f\fR
فهرست کردن تمام ورودی‌ها بر اساس ترتیب دایرکتوری (بدون مرتب‌سازی)
.TP
\fB\-F\fR, \fB\-\-classify\fR[=\fI\,WHEN\/\fR]
افزودن نشانگر (یکی از */=>@|) به ورودی‌ها بر اساس شرط \fIWHEN\fR
.TP
\fB\-\-file\-type\fR
مشابه قبلی، با این تفاوت که '*' اضافه نمی‌شود
.TP
\fB\-\-format\fR=\fI\,WORD\/\fR
سطری \fB\-x\fR، جداشده با ویرگول \fB\-m\fR، افقی \fB\-x\fR، طولانی \fB\-l\fR، تک‌ستونی \fB\-1\fR، با جزئیات \fB\-l\fR، عمودی \fB\-C\fR
.TP
\fB\-\-full\-time\fR
مشابه \fB\-l\fR \fB\-\-time\-style\fR=\fI\,full\-iso\/\fR
.TP
\fB\-g\fR
مشابه \fB\-l\fR، اما مالک فایل فهرست نشود
.TP
\fB\-\-group\-directories\-first\fR
دسته‌بندی و قرار دادن دایرکتوری‌ها قبل از فایل‌ها؛ می‌تواند با گزینه \fB\-\-sort\fR ترکیب شود، اما هرگونه استفاده از \fB\-\-sort\fR=none (\fB\-U\fR) این گروه‌بندی را غیرفعال می‌کند
.TP
\fB\-G\fR, \fB\-\-no\-group\fR
در حالت فهرست طولانی، نام گروه‌ها چاپ نشود
.TP
\fB\-h\fR, \fB\-\-human\-readable\fR
همراه با \fB\-l\fR و \fB\-s\fR، چاپ اندازه‌ها به شکل خوانا برای انسان مانند 1K 234M 2G و غیره
.TP
\fB\-\-si\fR
مشابه قبلی، اما استفاده از توان‌های ۱۰۰۰ به‌جای ۱۰۲۴
.TP
\fB\-H\fR, \fB\-\-dereference\-command\-line\fR
دنبال کردن پیوندهای نمادین (symbolic links) مشخص‌شده در خط فرمان
.TP
\fB\-\-dereference\-command\-line\-symlink\-to\-dir\fR
دنبال کردن پیوندهای نمادین خط فرمان که به یک دایرکتوری اشاره می‌کنند
.TP
\fB\-\-hide\fR=\fI\,PATTERN\/\fR
ورودی‌های ضمنی منطبق بر الگوی شل \fIPATTERN\fR فهرست نشوند (با گزینه‌های \fB\-a\fR یا \fB\-A\fR لغو می‌شود)
.TP
\fB\-\-hyperlink\fR[=\fI\,WHEN\/\fR]
ایجاد هایپرلینک برای نام فایل‌ها طبق شرط \fIWHEN\fR
.TP
\fB\-\-indicator\-style\fR=\fI\,WORD\/\fR
افزودن نشانگر با سبک \fIWORD\fR به نام ورودی‌ها: none (پیش‌فرض)، slash (\fB\-p\fR)، file\-type (\fB\-\-file\-type\fR)، classify (\fB\-F\fR)
.TP
\fB\-i\fR, \fB\-\-inode\fR
چاپ شماره اینود (inode) هر فایل
.TP
\fB\-I\fR, \fB\-\-ignore\fR=\fI\,PATTERN\/\fR
ورودی‌های ضمنی منطبق بر الگوی شل \fIPATTERN\fR فهرست نشوند
.TP
\fB\-k\fR, \fB\-\-kibibytes\fR
استفاده پیش‌فرض از بلوک‌های ۱۰۲۴ بایتی برای میزان فضای فایل‌سیستم؛ فقط همراه با \fB\-s\fR و برای مجموع اندازه دایرکتوری‌ها اعمال می‌شود
.TP
\fB\-l\fR
استفاده از قالب فهرست طولانی (long listing format)
.TP
\fB\-L\fR, \fB\-\-dereference\fR
هنگام نمایش اطلاعات فایل برای پیوند نمادین، نمایش اطلاعات مربوط به فایلی که پیوند به آن اشاره می‌کند به‌جای خود پیوند
.TP
\fB\-m\fR
پر کردن عرض خط با فهرستی از ورودی‌ها که با ویرگول از هم جدا شده‌اند
.TP
\fB\-n\fR, \fB\-\-numeric\-uid\-gid\fR
مانند \fB\-l\fR، اما شناسه‌های کاربری (UID) و گروهی (GID) عددی را نمایش می‌دهد
.TP
\fB\-N\fR, \fB\-\-literal\fR
چاپ نام ورودی‌ها بدون علامت‌های نقل‌قول (کوتیشن)
.TP
\fB\-o\fR
مانند \fB\-l\fR، اما اطلاعات گروه چاپ نشود
.TP
\fB\-p\fR, \fB\-\-indicator\-style\fR=\fI\,slash\/\fR
افزودن نشانگر / به انتهای نام دایرکتوری‌ها
.TP
\fB\-q\fR, \fB\-\-hide\-control\-chars\fR
چاپ علامت ؟ به‌جای نویسه‌های غیرگرافیکی
.TP
\fB\-\-show\-control\-chars\fR
نمایش نویسه‌های غیرگرافیکی همان‌طور که هستند (پیش‌فرض، مگر اینکه برنامه 'ls' بوده و خروجی ترمینال باشد)
.TP
\fB\-Q\fR, \fB\-\-quote\-name\fR
قرار دادن نام ورودی‌ها درون علامت نقل‌قول جفتی (double quotes)
.TP
\fB\-\-quoting\-style\fR=\fI\,WORD\/\fR
استفاده از سبک نقل‌قول \fIWORD\fR برای نام ورودی‌ها: literal ،locale ،shell ،shell\-always ،shell\-escape ،shell\-escape\-always ،c ،escape (متغیر محیطی QUOTING_STYLE را نادیده می‌گیرد)
.TP
\fB\-r\fR, \fB\-\-reverse\fR
معکوس کردن ترتیب هنگام مرتب‌سازی
.TP
\fB\-R\fR, \fB\-\-recursive\fR
فهرست کردن بازگشتی زیردایرکتوری‌ها
.TP
\fB\-s\fR, \fB\-\-size\fR
چاپ اندازه تخصیص‌یافته به هر فایل بر حسب بلوک
.TP
\fB\-S\fR
مرتب‌سازی بر اساس اندازه فایل، بزرگترین در ابتدا
.TP
\fB\-\-sort\fR=\fI\,WORD\/\fR
مرتب‌سازی بر اساس \fIWORD\fR به‌جای نام: none (\fB\-U\fR)، size (\fB\-S\fR)، time (\fB\-t\fR)، version (\fB\-v\fR)، extension (\fB\-X\fR)، width
.TP
\fB\-\-time\fR=\fI\,WORD\/\fR
تغییر زمان پیش‌فرضِ استفاده‌شده (زمان ویرایش)؛ زمان دسترسی (\fB\-u\fR): atime ،access ،use؛ زمان تغییر وضعیت (\fB\-c\fR): ctime ،status؛ زمان ایجاد فایل: birth ،creation؛
.IP
همراه با \fB\-l\fR، آرگومان \fIWORD\fR مشخص می‌کند کدام زمان نمایش داده شود؛ همراه با \fB\-\-sort\fR=time، مرتب‌سازی بر اساس \fIWORD\fR انجام می‌شود (جدیدترین در ابتدا)
.TP
\fB\-\-time\-style\fR=\fI\,TIME_STYLE\/\fR
قالب زمان و تاریخ همراه با \fB\-l\fR؛ فرمت \fITIME_STYLE\fR در ادامه توضیح داده شده است
.TP
\fB\-t\fR
مرتب‌سازی بر اساس زمان، جدیدترین در ابتدا؛ گزینه \fB\-\-time\fR را ببینید
.TP
\fB\-T\fR, \fB\-\-tabsize\fR=\fI\,COLS\/\fR
تنظیم توقفگاه تب در هر \fICOLS\fR ستون به‌جای ۸
.TP
\fB\-u\fR
همراه با \fB\-lt\fR: مرتب‌سازی بر اساس زمان دسترسی (atime) و نمایش آن؛ همراه با \fB\-l\fR: نمایش زمان دسترسی و مرتب‌سازی بر اساس نام؛ در غیر این صورت: مرتب‌سازی بر اساس زمان دسترسی، جدیدترین در ابتدا
.TP
\fB\-U\fR
بدون مرتب‌سازی؛ فهرست کردن ورودی‌ها بر اساس ترتیب ذخیره در دایرکتوری
.TP
\fB\-v\fR
مرتب‌سازی طبیعی شماره‌های (نسخه) درون متن
.TP
\fB\-w\fR, \fB\-\-width\fR=\fI\,COLS\/\fR
تنظیم پهنای خروجی روی \fICOLS\fR ستون؛ مقدار ۰ به معنی نامحدود است
.TP
\fB\-x\fR
فهرست کردن ورودی‌ها به‌صورت سطری به‌جای ستونی
.TP
\fB\-X\fR
مرتب‌سازی بر اساس حروف الفبا طبق پسوند ورودی‌ها
.TP
\fB\-Z\fR, \fB\-\-context\fR
چاپ زمینه امنیتی (security context) هر فایل
.TP
\fB\-\-zero\fR
پایان هر سطر خروجی با نویسه NUL، نه خط جدید
.TP
\fB\-1\fR
فهرست کردن یک فایل در هر سطر
.TP
\fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.PP
آرگومان \fISIZE\fR یک عدد صحیح همراه با واحد اختیاری است (مثال: 10K برابر است با 10*1024). واحدها شامل K,M,G,T,P,E,Z,Y (توان‌های ۱۰۲۴) یا KB,MB,... (توان‌های ۱۰۰۰) هستند. پیشوندهای باینری نیز می‌توانند استفاده شوند: KiB=K ،MiB=M و غیره.
.PP
آرگومان \fITIME_STYLE\fR می‌تواند full\-iso ،long\-iso ،iso ،locale یا +FORMAT باشد. قالب FORMAT مانند دستور \fBdate\fP(1) تفسیر می‌شود. اگر FORMAT به صورت FORMAT1<خط‌جدید>FORMAT2 باشد، آنگاه FORMAT1 برای فایل‌های غیرجدید و FORMAT2 برای فایل‌های جدید اعمال می‌شود. استفاده از پیشوند 'posix\-' در TIME_STYLE فقط خارج از لوکال POSIX عمل می‌کند. همچنین متغیر محیطی TIME_STYLE سبک پیش‌فرض را تعیین می‌کند.
.PP
آرگومان \fIWHEN\fR به‌طور پیش‌فرض 'always' است و می‌تواند 'auto' یا 'never' نیز باشد.
.PP
استفاده از رنگ برای تفکیک انواع فایل هم به‌طور پیش‌فرض و هم با \fB\-\-color\fR=never غیرفعال است. با گزینه \fB\-\-color\fR=auto، دستور \fBls\fR کدهای رنگی را تنها هنگامی که خروجی استاندارد به ترمینال متصل باشد ارسال می‌کند. متغیر محیطی LS_COLORS می‌تواند این تنظیمات را تغییر دهد. برای تنظیم آن از دستور \fBdircolors\fR(1) استفاده کنید.
.SS "وضعیت خروج (Exit status):"
.TP
0
اگر عملیات با موفقیت انجام شود (OK)،
.TP
1
در صورت بروز مشکلات جزئی (مانند عدم امکان دسترسی به زیردایرکتوری)،
.TP
2
در صورت بروز مشکلات جدی (مانند عدم امکان دسترسی به آرگومان خط فرمان).
.SH "نویسندگان (AUTHOR)"
نوشته‌شده توسط Richard M. Stallman و David MacKenzie.
.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/dir>
.br
یا در دسترس به صورت محلی از طریق: \fBinfo \(aq(coreutils) dir invocation\(aq\fR