نام (NAME)

dir - فهرست کردن محتویات دایرکتوری

خلاصه دستور (SYNOPSIS)

dir [گزینه‌ها]... [فایل]...

توضیحات (DESCRIPTION)

اطلاعات مربوط به فایلها را فهرست می‌کند (به‌طور پیش‌فرض دایرکتوری جاری). اگر هیچ‌یک از گزینه‌های -cftuvSUX یا --sort مشخص نشده باشد، ورودی‌ها بر اساس حروف الفبا مرتب می‌شوند.

آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.

-a, --all

ورودی‌هایی که با نقطه (.) شروع می‌شوند نادیده گرفته نشوند

-A, --almost-all

ورودی‌های ضمنی . و .. فهرست نشوند

--author

همراه با -l، نویسنده هر فایل چاپ شود

-b, --escape

کاراکترهای غیرگرافیکی با فرمت گریز (escape) زبان C چاپ شوند

--block-size=SIZE

همراه با -l، اندازه‌ها را با مقیاس SIZE چاپ کند؛ مانند --block-size=M؛ قالب SIZE در ادامه آمده است

-B, --ignore-backups

ورودی‌های ضمنی که به ~ ختم می‌شوند فهرست نشوند

-c

همراه با -lt: مرتب‌سازی بر اساس ctime (زمان آخرین تغییر در اطلاعات وضعیت فایل) و نمایش آن؛ همراه با -l: نمایش ctime و مرتب‌سازی بر اساس نام؛ در غیر این صورت: مرتب‌سازی بر اساس ctime، جدیدترین در ابتدا

-C

فهرست کردن ورودی‌ها به‌صورت ستونی

--color[=WHEN]

رنگی‌کردن خروجی طبق WHEN؛ توضیحات بیشتر در ادامه آمده است

-d, --directory

فهرست کردن خود دایرکتوری‌ها، نه محتویات آن‌ها

-D, --dired

تولید خروجی طراحی‌شده برای حالت dired در ایمکس (Emacs)

-f

فهرست کردن تمام ورودی‌ها بر اساس ترتیب دایرکتوری (بدون مرتب‌سازی)

-F, --classify[=WHEN]

افزودن نشانگر (یکی از */=>@|) به ورودی‌ها بر اساس شرط WHEN

--file-type

مشابه قبلی، با این تفاوت که '*' اضافه نمی‌شود

--format=WORD

سطری -x، جداشده با ویرگول -m، افقی -x، طولانی -l، تک‌ستونی -1، با جزئیات -l، عمودی -C

--full-time

مشابه -l --time-style=full-iso

-g

مشابه -l، اما مالک فایل فهرست نشود

--group-directories-first

دسته‌بندی و قرار دادن دایرکتوری‌ها قبل از فایل‌ها؛ می‌تواند با گزینه --sort ترکیب شود، اما هرگونه استفاده از --sort=none (-U) این گروه‌بندی را غیرفعال می‌کند

-G, --no-group

در حالت فهرست طولانی، نام گروه‌ها چاپ نشود

-h, --human-readable

همراه با -l و -s، چاپ اندازه‌ها به شکل خوانا برای انسان مانند 1K 234M 2G و غیره

--si

مشابه قبلی، اما استفاده از توان‌های ۱۰۰۰ به‌جای ۱۰۲۴

-H, --dereference-command-line

دنبال کردن پیوندهای نمادین (symbolic links) مشخص‌شده در خط فرمان

--dereference-command-line-symlink-to-dir

دنبال کردن پیوندهای نمادین خط فرمان که به یک دایرکتوری اشاره می‌کنند

--hide=PATTERN

ورودی‌های ضمنی منطبق بر الگوی شل PATTERN فهرست نشوند (با گزینه‌های -a یا -A لغو می‌شود)

--hyperlink[=WHEN]

ایجاد هایپرلینک برای نام فایل‌ها طبق شرط WHEN

--indicator-style=WORD

افزودن نشانگر با سبک WORD به نام ورودی‌ها: none (پیش‌فرض)، slash (-p)، file-type (--file-type)، classify (-F)

-i, --inode

چاپ شماره اینود (inode) هر فایل

-I, --ignore=PATTERN

ورودی‌های ضمنی منطبق بر الگوی شل PATTERN فهرست نشوند

-k, --kibibytes

استفاده پیش‌فرض از بلوک‌های ۱۰۲۴ بایتی برای میزان فضای فایل‌سیستم؛ فقط همراه با -s و برای مجموع اندازه دایرکتوری‌ها اعمال می‌شود

-l

استفاده از قالب فهرست طولانی (long listing format)

-L, --dereference

هنگام نمایش اطلاعات فایل برای پیوند نمادین، نمایش اطلاعات مربوط به فایلی که پیوند به آن اشاره می‌کند به‌جای خود پیوند

-m

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

-n, --numeric-uid-gid

مانند -l، اما شناسه‌های کاربری (UID) و گروهی (GID) عددی را نمایش می‌دهد

-N, --literal

چاپ نام ورودی‌ها بدون علامت‌های نقل‌قول (کوتیشن)

-o

مانند -l، اما اطلاعات گروه چاپ نشود

-p, --indicator-style=slash

افزودن نشانگر / به انتهای نام دایرکتوری‌ها

-q, --hide-control-chars

چاپ علامت ؟ به‌جای نویسه‌های غیرگرافیکی

--show-control-chars

نمایش نویسه‌های غیرگرافیکی همان‌طور که هستند (پیش‌فرض، مگر اینکه برنامه 'ls' بوده و خروجی ترمینال باشد)

-Q, --quote-name

قرار دادن نام ورودی‌ها درون علامت نقل‌قول جفتی (double quotes)

--quoting-style=WORD

استفاده از سبک نقل‌قول WORD برای نام ورودی‌ها: literal ،locale ،shell ،shell-always ،shell-escape ،shell-escape-always ،c ،escape (متغیر محیطی QUOTING_STYLE را نادیده می‌گیرد)

-r, --reverse

معکوس کردن ترتیب هنگام مرتب‌سازی

-R, --recursive

فهرست کردن بازگشتی زیردایرکتوری‌ها

-s, --size

چاپ اندازه تخصیص‌یافته به هر فایل بر حسب بلوک

-S

مرتب‌سازی بر اساس اندازه فایل، بزرگترین در ابتدا

--sort=WORD

مرتب‌سازی بر اساس WORD به‌جای نام: none (-U)، size (-S)، time (-t)، version (-v)، extension (-X)، width

--time=WORD

تغییر زمان پیش‌فرضِ استفاده‌شده (زمان ویرایش)؛ زمان دسترسی (-u): atime ،access ،use؛ زمان تغییر وضعیت (-c): ctime ،status؛ زمان ایجاد فایل: birth ،creation؛

همراه با -l، آرگومان WORD مشخص می‌کند کدام زمان نمایش داده شود؛ همراه با --sort=time، مرتب‌سازی بر اساس WORD انجام می‌شود (جدیدترین در ابتدا)

--time-style=TIME_STYLE

قالب زمان و تاریخ همراه با -l؛ فرمت TIME_STYLE در ادامه توضیح داده شده است

-t

مرتب‌سازی بر اساس زمان، جدیدترین در ابتدا؛ گزینه --time را ببینید

-T, --tabsize=COLS

تنظیم توقفگاه تب در هر COLS ستون به‌جای ۸

-u

همراه با -lt: مرتب‌سازی بر اساس زمان دسترسی (atime) و نمایش آن؛ همراه با -l: نمایش زمان دسترسی و مرتب‌سازی بر اساس نام؛ در غیر این صورت: مرتب‌سازی بر اساس زمان دسترسی، جدیدترین در ابتدا

-U

بدون مرتب‌سازی؛ فهرست کردن ورودی‌ها بر اساس ترتیب ذخیره در دایرکتوری

-v

مرتب‌سازی طبیعی شماره‌های (نسخه) درون متن

-w, --width=COLS

تنظیم پهنای خروجی روی COLS ستون؛ مقدار ۰ به معنی نامحدود است

-x

فهرست کردن ورودی‌ها به‌صورت سطری به‌جای ستونی

-X

مرتب‌سازی بر اساس حروف الفبا طبق پسوند ورودی‌ها

-Z, --context

چاپ زمینه امنیتی (security context) هر فایل

--zero

پایان هر سطر خروجی با نویسه NUL، نه خط جدید

-1

فهرست کردن یک فایل در هر سطر

--help

نمایش این راهنما و خروج

--version

نمایش اطلاعات نسخه و خروج

آرگومان SIZE یک عدد صحیح همراه با واحد اختیاری است (مثال: 10K برابر است با 10*1024). واحدها شامل K,M,G,T,P,E,Z,Y (توان‌های ۱۰۲۴) یا KB,MB,... (توان‌های ۱۰۰۰) هستند. پیشوندهای باینری نیز می‌توانند استفاده شوند: KiB=K ،MiB=M و غیره.

آرگومان TIME_STYLE می‌تواند full-iso ،long-iso ،iso ،locale یا +FORMAT باشد. قالب FORMAT مانند دستور date(1) تفسیر می‌شود. اگر FORMAT به صورت FORMAT1<خط‌جدید>FORMAT2 باشد، آنگاه FORMAT1 برای فایل‌های غیرجدید و FORMAT2 برای فایل‌های جدید اعمال می‌شود. استفاده از پیشوند 'posix-' در TIME_STYLE فقط خارج از لوکال POSIX عمل می‌کند. همچنین متغیر محیطی TIME_STYLE سبک پیش‌فرض را تعیین می‌کند.

آرگومان WHEN به‌طور پیش‌فرض 'always' است و می‌تواند 'auto' یا 'never' نیز باشد.

استفاده از رنگ برای تفکیک انواع فایل هم به‌طور پیش‌فرض و هم با --color=never غیرفعال است. با گزینه --color=auto، دستور ls کدهای رنگی را تنها هنگامی که خروجی استاندارد به ترمینال متصل باشد ارسال می‌کند. متغیر محیطی LS_COLORS می‌تواند این تنظیمات را تغییر دهد. برای تنظیم آن از دستور dircolors(1) استفاده کنید.

نویسندگان (AUTHOR)

نوشته‌شده توسط Richard M. Stallman و David MacKenzie.

گزارش اشکالات (REPORTING BUGS)

راهنمای برخط GNU coreutils: https://www.gnu.org/software/coreutils
گزارش هرگونه اشکال در ترجمه به: https://translationproject.org/team

حق نشر (COPYRIGHT)

حق نشر © 2022 Free Software Foundation, Inc. مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر https://gnu.org/licenses/gpl.html.
این نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.

همچنین ببینید (SEE ALSO)

مستندات کامل در https://www.gnu.org/software/coreutils/dir
یا در دسترس به صورت محلی از طریق: info '(coreutils) dir invocation'