.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH DIR 1 "2026-09-01"
.SH "نام (NAME)"
dir \- فهرست کردن محتویات دایرکتوری. به طور پیش‌فرض فایل‌ها و دایرکتوری‌هایی را که با \*(Aq.\*(Aq شروع می‌شوند نادیده می‌گیرد
.SH "خلاصه دستور (SYNOPSIS)"
\fBdir\fR [OPTION]... [FILE]...
.SH "توضیحات (DESCRIPTION)"
محتویات دایرکتوری را فهرست می‌کند.
به طور پیش‌فرض فایل‌ها و دایرکتوری‌هایی را که با \*(Aq.\*(Aq شروع می‌شوند نادیده می‌گیرد.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-help\fR
نمایش اطلاعات راهنما.
.TP
\fB\-\-format\fR
تنظیم قالب نمایش.
.TP
\fB\-C\fR
نمایش فایل‌ها به صورت ستونی.
.TP
\fB\-l\fR, \fB\-\-long\fR
نمایش اطلاعات با جزئیات کامل (قالب بلند).
.TP
\fB\-x\fR
فهرست کردن موارد در سطرها به جای ستون‌ها.
.TP
\fB\-T\fR, \fB\-\-tabsize\fR \fI<COLS>\fR
در نظر گرفتن توقف‌های تب در هر COLS به جای ۸
.TP
\fB\-m\fR
فهرست کردن موارد جداشده با کاما.
.TP
\fB\-\-zero\fR
فهرست کردن موارد جداشده با نویسه ASCII NUL.
.TP
\fB\-D\fR, \fB\-\-dired\fR
تولید خروجی طراحی‌شده برای حالت dired (ویرایشگر دایرکتوری) در Emacs
.TP
\fB\-\-hyperlink\fR[=\fI<WHEN>\fR] [پیش‌فرض: never]
ایجاد پیوند برای نام فایل‌ها در زمان WHEN

\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
always
.IP \(bu 2
auto
.IP \(bu 2
never
.RE
.TP
\fB\-1\fR
فهرست کردن یک فایل در هر سطر.
.TP
\fB\-o\fR
قالب بلند بدون اطلاعات گروه.
مشابه \-\-format=long همراه با \-\-no\-group.
.TP
\fB\-g\fR
قالب بلند بدون اطلاعات مالک.
.TP
\fB\-n\fR, \fB\-\-numeric\-uid\-gid\fR
مشابه \-l با UID و GID عددی.
.TP
\fB\-\-quoting\-style\fR
تنظیم شیوه نقل‌قول.

\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
literal
.IP \(bu 2
locale
.IP \(bu 2
shell
.IP \(bu 2
shell\-escape
.IP \(bu 2
shell\-always
.IP \(bu 2
shell\-escape\-always
.IP \(bu 2
clocale
.IP \(bu 2
c
.IP \(bu 2
escape
.RE
.TP
\fB\-N\fR, \fB\-\-literal\fR
استفاده از شیوه نقل‌قول لفظی (literal). معادل `\-\-quoting\-style=literal`
.TP
\fB\-b\fR, \fB\-\-escape\fR
استفاده از شیوه نقل‌قول گریز (escape). معادل `\-\-quoting\-style=escape`
.TP
\fB\-Q\fR, \fB\-\-quote\-name\fR
استفاده از شیوه نقل‌قول C. معادل `\-\-quoting\-style=c`
.TP
\fB\-q\fR, \fB\-\-hide\-control\-chars\fR
جایگزینی نویسه‌های کنترلی با \*(Aq?\*(Aq در صورتی که گریز داده نشده باشند.
.TP
\fB\-\-show\-control\-chars\fR
نمایش نویسه‌های کنترلی به همان صورت اصلی در صورتی که گریز داده نشده باشند.
.TP
\fB\-\-time\fR \fI<field>\fR
نمایش زمان موجود در `<field>`:
زمان دسترسی (\-u): atime, access, use؛
زمان تغییر وضعیت (\-t): ctime, status.
زمان تغییر محتوا: mtime, modification.
زمان ایجاد: birth, creation؛
.TP
\fB\-c\fR
در صورت استفاده از قالب فهرست بلند (مانند \-l یا \-o)، زمان تغییر وضعیت (\*(Aqctime\*(Aq در inode) را به جای زمان تغییر محتوا چاپ می‌کند. هنگام مرتب‌سازی صریح بر اساس زمان (\-\-sort=time یا \-t) یا هنگام عدم استفاده از قالب بلند، مرتب‌سازی بر اساس زمان تغییر وضعیت انجام می‌شود.
.TP
\fB\-u\fR
در صورت استفاده از قالب فهرست بلند (مانند \-l یا \-o)، زمان دسترسی را به جای زمان تغییر محتوا چاپ می‌کند. هنگام مرتب‌سازی صریح بر اساس زمان (\-\-sort=time یا \-t) یا هنگام عدم استفاده از قالب بلند، مرتب‌سازی بر اساس زمان دسترسی انجام می‌شود.
.TP
\fB\-\-hide\fR \fI<PATTERN>\fR
عدم فهرست کردن موارد ضمنی منطبق بر PATTERN پوسته (توسط \-a یا \-A لغو می‌شود)
.TP
\fB\-I\fR, \fB\-\-ignore\fR \fI<PATTERN>\fR
عدم فهرست کردن موارد ضمنی منطبق بر PATTERN پوسته
.TP
\fB\-B\fR, \fB\-\-ignore\-backups\fR
نادیده گرفتن مواردی که با ~ خاتمه می‌یابند.
.TP
\fB\-\-sort\fR \fI<field>\fR
مرتب‌سازی بر اساس `<field>`: name, none (\-U), time (\-t), size (\-S), extension (\-X) یا width

\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
name
.IP \(bu 2
none
.IP \(bu 2
time
.IP \(bu 2
size
.IP \(bu 2
version
.IP \(bu 2
extension
.IP \(bu 2
width
.RE
.TP
\fB\-S\fR
مرتب‌سازی بر اساس اندازه فایل، از بزرگ‌ترین به کوچک‌ترین.
.TP
\fB\-t\fR
مرتب‌سازی بر اساس زمان تغییر محتوا (\*(Aqmtime\*(Aq در inode)، از جدیدترین به قدیمی‌ترین.
.TP
\fB\-v\fR
مرتب‌سازی طبیعی شماره‌های (نسخه) درون نام فایل‌ها.
.TP
\fB\-X\fR
مرتب‌سازی الفبایی بر اساس پسوند موارد.
.TP
\fB\-U\fR
مرتب‌سازی انجام نشود؛ فایل‌ها به همان ترتیبی که در دایرکتوری ذخیره شده‌اند فهرست شوند. این گزینه به‌ویژه هنگام فهرست کردن دایرکتوری‌های بسیار بزرگ کاربرد دارد، چرا که انجام ندادن مرتب‌سازی می‌تواند به طور محسوسی سریع‌تر باشد.
.TP
\fB\-L\fR, \fB\-\-dereference\fR
هنگام نمایش اطلاعات فایل برای یک پیوند نمادین، نمایش اطلاعات مربوط به فایلی که پیوند به آن اشاره می‌کند به جای خود پیوند.
.TP
\fB\-\-dereference\-command\-line\-symlink\-to\-dir\fR
عدم دنبال کردن پیوندهای نمادین، مگر زمانی که به دایرکتوری‌ها اشاره کنند و به عنوان آرگومان‌های خط فرمان مشخص شده باشند.
.TP
\fB\-H\fR, \fB\-\-dereference\-command\-line\fR
عدم دنبال کردن پیوندهای نمادین، مگر زمانی که به عنوان آرگومان خط فرمان مشخص شده باشند..TP
\fB\-G\fR, \fB\-\-no\-group\fR
در قالب بلند، گروه را نمایش ندهد.
.TP
\fB\-\-author\fR
نمایش پدیدآورنده در قالب بلند. در پلتفرم‌های پشتیبانی‌شده،
پدیدآورنده همیشه با مالک فایل یکسان است.
.TP
\fB\-a\fR, \fB\-\-all\fR
فایل‌های پنهان (فایل‌هایی که نام آن‌ها با \*(Aq.\*(Aq شروع می‌شود) را نادیده نگیرد.
.TP
\fB\-A\fR, \fB\-\-almost\-all\fR
در یک دایرکتوری، تمام نام‌های فایلی را که با \*(Aq.\*(Aq شروع می‌شوند نادیده نگیرد،
تنها \*(Aq.\*(Aq و \*(Aq..\*(Aq را نادیده بگیرد.
.TP
\fB\-f\fR
فهرست کردن تمام فایل‌ها به ترتیب دایرکتوری، بدون مرتب‌سازی. معادل \-aU. گزینه \-\-color را غیرفعال می‌کند مگر اینکه صراحتاً مشخص شده باشد.
.TP
\fB\-d\fR, \fB\-\-directory\fR
تنها نام‌های دایرکتوری‌ها را فهرست کند، به جای فهرست کردن محتویات دایرکتوری.
این گزینه پیوندهای نمادین را دنبال نخواهد کرد مگر اینکه یکی از `\-\-dereference\-command\-line
(\-H)`، `\-\-dereference (\-L)`، یا `\-\-dereference\-command\-line\-symlink\-to\-dir`
مشخص شده باشد.
.TP
\fB\-h\fR, \fB\-\-human\-readable\fR
چاپ اندازه فایل‌ها با فرمت خوانا برای انسان (مانند 1K 234M 56G).
.TP
\fB\-k\fR, \fB\-\-kibibytes\fR
پیش‌فرض برای بلوک‌های ۱۰۲۴ بایتی برای مصرف سیستم‌فایل؛ تنها با \-s و برای
مجموع‌های هر دایرکتوری استفاده می‌شود
.TP
\fB\-\-si\fR
چاپ اندازه فایل‌ها به صورت خوانا برای انسان با استفاده از توان‌های ۱۰۰۰ به جای ۱۰۲۴.
.TP
\fB\-\-block\-size\fR \fI<BLOCK_SIZE>\fR
تغییر مقیاس اندازه‌ها با BLOCK_SIZE هنگام چاپ آن‌ها
.TP
\fB\-i\fR, \fB\-\-inode\fR
چاپ شماره اندیس (inode) هر فایل
.TP
\fB\-r\fR, \fB\-\-reverse\fR
معکوس کردن هر روش مرتب‌سازی که اعمال شده است؛ برای مثال، فهرست کردن فایل‌ها به ترتیب
الفبایی معکوس، جدیدترین‌ها اول، کوچک‌ترین‌ها اول، یا غیره.
.TP
\fB\-R\fR, \fB\-\-recursive\fR
فهرست کردن محتویات تمام دایرکتوری‌ها به صورت بازگشتی.
.TP
\fB\-w\fR, \fB\-\-width\fR \fI<COLS>\fR
فرض می‌کند که عرض ترمینال COLS ستون است.
.TP
\fB\-s\fR, \fB\-\-size\fR
چاپ اندازه تخصیص‌یافته به هر فایل، بر حسب بلوک
.TP
\fB\-\-color\fR
رنگی کردن خروجی بر اساس نوع فایل.

\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
always
.IP \(bu 2
auto
.IP \(bu 2
never
.RE
.TP
\fB\-\-indicator\-style\fR
افزودن نشانگر با سبک WORD به نام ورودی‌ها:
none (پیش‌فرض)، slash (\-p)، file\-type (\-\-file\-type)، classify (\-F)

\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
none
.IP \(bu 2
slash
.IP \(bu 2
file\-type
.IP \(bu 2
classify
.RE
.TP
\fB\-F\fR, \fB\-\-classify\fR[=\fI<when>\fR]
افزودن یک نویسه به انتهای هر نام فایل که نشان‌دهنده نوع فایل است. همچنین برای
فایل‌های عادی که قابل اجرا هستند، \*(Aq*\*(Aq اضافه می‌کند. نشانگرهای نوع فایل عبارتند از
\*(Aq/\*(Aq برای دایرکتوری‌ها، \*(Aq@\*(Aq برای پیوندهای نمادین، \*(Aq|\*(Aq برای FIFOها، \*(Aq=\*(Aq برای سوکت‌ها،
\*(Aq>\*(Aq برای doorها، و هیچ‌چیز برای فایل‌های عادی. when می‌تواند حذف شود، یا یکی از موارد زیر باشد:
    none \- دسته‌بندی نکند. این مقدار پیش‌فرض است.
    auto \- تنها در صورتی دسته‌بندی کند که خروجی استاندارد یک ترمینال باشد.
    always \- همیشه دسته‌بندی کند.
مشخص کردن \-\-classify بدون when معادل با \-\-classify=always است. این گزینه
پیوندهای نمادین ذکر شده در خط فرمان را دنبال نخواهد کرد مگر اینکه گزینه‌های
\-\-dereference\-command\-line (\-H)، \-\-dereference (\-L)، یا
\-\-dereference\-command\-line\-symlink\-to\-dir مشخص شده باشند.

\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
always
.IP \(bu 2
auto
.IP \(bu 2
never
.RE
.TP
\fB\-\-file\-type\fR
مشابه \-\-classify، اما \*(Aq*\*(Aq را اضافه نمی‌کند
.TP
\fB\-p\fR
افزودن نشانگر / به دایرکتوری‌ها.
.TP
\fB\-\-time\-style\fR \fI<TIME_STYLE>\fR
قالب زمان/تاریخ با \-l؛ بخش TIME_STYLE را در زیر ببینید
.TP
\fB\-\-full\-time\fR
مانند \-l \-\-time\-style=full\-iso
.TP
\fB\-Z\fR, \fB\-\-context\fR
چاپ بافت امنیتی هر فایل
.TP
\fB\-\-group\-directories\-first\fR
دسته‌بندی دایرکتوری‌ها پیش از فایل‌ها؛ می‌تواند با
یک گزینه \-\-sort تکمیل شود، اما هرگونه استفاده از \-\-sort=none (\-U) گروه‌بندی را غیرفعال می‌کند
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ نسخه.SH "اطلاعات تکمیلی (EXTRA)"
آرگومان TIME_STYLE می‌تواند full\-iso، long\-iso، iso، locale یا +FORMAT باشد. FORMAT همانند date تفسیر می‌شود. همچنین متغیر محیطی TIME_STYLE سبک پیش‌فرض برای استفاده را تعیین می‌کند.
.SH "نسخه (VERSION)"
v(uutils coreutils) 0.11.0