.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH VDIR 1 "2026-09-01"
.SH "نام (NAME)"
vdir \- فهرست کردن محتویات دایرکتوری
نادیده گرفتن فایل‌ها و دایرکتوری‌هایی که به‌طور پیش‌فرض با \*(Aq.\*(Aq شروع می‌شوند

آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.SH "خلاصه دستور (SYNOPSIS)"
\fBvdir\fR [OPTION]... [FILE]...
.SH "توضیحات (DESCRIPTION)"
فهرست کردن محتویات دایرکتوری.
نادیده گرفتن فایل‌ها و دایرکتوری‌هایی که به‌طور پیش‌فرض با \*(Aq.\*(Aq شروع می‌شوند
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.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 در صورتی که escape نشده باشند.
.TP
\fB\-\-show\-control\-chars\fR
نمایش نویسه‌های کنترلی \*(Aqهمان‌گونه که هستند\*(Aq در صورتی که escape نشده باشند.
.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 برای درها (doors) و هیچ‌چیز برای فایل‌های عادی. مقدار 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