| LS(1) | General Commands Manual | LS(1) |
نام (NAME)
ls - فهرست کردن محتویات دایرکتوری. به‌طور پیش‌فرض فایل‌ها و دایرکتوری‌هایی که با '.' شروع می‌شوند نادیده گرفته می‌شوند
خلاصه دستور (SYNOPSIS)
ls [OPTION]... [FILE]...
توضیحات (DESCRIPTION)
فهرست کردن محتویات دایرکتوری. به‌طور پیش‌فرض فایل‌ها و دایرکتوری‌هایی که با '.' شروع می‌شوند نادیده گرفته می‌شوند.
گزینه‌ها (OPTIONS)
- --help
- چاپ اطلاعات راهنما.
- --format
- تنظیم قالب نمایش.
- -C
- نمایش فایل‌ها در ستون‌ها.
- -l, --long
- نمایش اطلاعات با جزئیات کامل.
- -x
- فهرست کردن مدخل‌ها به‌صورت سطری به جای ستونی.
- -T, --tabsize <COLS>
- در نظر گرفتن توقف‌های تب در هر COLS به جای ۸
- -m
- فهرست کردن مدخل‌ها با جداکننده کاما.
- --zero
- فهرست کردن مدخل‌ها با جداکننده نویسه ASCII NUL.
- -D, --dired
- تولید خروجی طراحی‌شده برای حالت dired (ویرایشگر دایرکتوری) در Emacs
- --hyperlink[=<WHEN>] [پیش‌فرض: never]
- ایجاد
پیوند (hyperlink)
برای نام
فایل‌ها در
زمان WHEN
مقادیر ممکن:
- always
- auto
- never
- -1
- فهرست کردن یک فایل در هر خط.
- -o
- قالب بلند بدون اطلاعات گروه. همانند --format=long به همراه --no-group.
- -g
- قالب بلند بدون اطلاعات مالک.
- -n, --numeric-uid-gid
- مشابه -l همراه با UIDها و GIDهای عددی.
- --quoting-style
- تنظیم شیوه
نقل‌قول (quoting style).
مقادیر ممکن:
- literal
- locale
- shell
- shell-escape
- shell-always
- shell-escape-always
- clocale
- c
- escape
- -N, --literal
- استفاده از شیوه نقل‌قول لفظی (literal). معادل `--quoting-style=literal`
- -b, --escape
- استفاده از شیوه نقل‌قول گریز (escape). معادل `--quoting-style=escape`
- -Q, --quote-name
- استفاده از شیوه نقل‌قول زبان C. معادل `--quoting-style=c`
- -q, --hide-control-chars
- جایگزین کردن نویسه‌های کنترلی با '?' در صورتی که گریز داده نشده (escape) باشند.
- --show-control-chars
- نمایش نویسه‌های کنترلی 'به همان صورت موجود' اگر گریز داده نشده باشند.
- --time <field>
- نمایش زمان در `<field>`: زمان دسترسی (-u): atime، access، use؛ زمان تغییر وضعیت (-t): ctime، status. زمان اصلاح: mtime، modification. زمان ایجاد: birth، creation؛
- -c
- اگر از قالب فهرست طولانی (مانند -l یا -o) استفاده شود، زمان تغییر وضعیت ('ctime' در inode) به جای زمان اصلاح چاپ می‌شود. هنگام مرتب‌سازی صریح بر اساس زمان (--sort=time یا -t) یا هنگامی که از قالب فهرست طولانی استفاده نمی‌شود، مرتب‌سازی بر اساس زمان تغییر وضعیت انجام می‌گیرد.
- -u
- اگر از قالب فهرست طولانی (مانند -l یا -o) استفاده شود، زمان دسترسی به جای زمان اصلاح چاپ می‌شود. هنگام مرتب‌سازی صریح بر اساس زمان (--sort=time یا -t) یا هنگامی که از قالب فهرست طولانی استفاده نمی‌شود، مرتب‌سازی بر اساس زمان دسترسی انجام می‌گیرد.
- --hide <PATTERN>
- مدخل‌های ضمنی منطبق بر الگوی شل PATTERN در فهرست قرار نگیرند (با -a یا -A لغو می‌شود)
- -I, --ignore <PATTERN>
- مدخل‌های ضمنی منطبق بر الگوی شل PATTERN در فهرست قرار نگیرند
- -B, --ignore-backups
- نادیده گرفتن مدخل‌هایی که با ~ پایان می‌یابند.
- --sort <field>
- مرتب‌سازی
بر اساس `<field>`:
نام (name)،
هیچ‌کدام (none
یا -U)، زمان (time
یا -t)،
اندازه (size یا
-S)، پسوند (extension
یا -X) یا عرض (width)
مقادیر ممکن:
- name
- none
- time
- size
- version
- extension
- width
- -S
- مرتب‌سازی بر اساس اندازه فایل، بزرگ‌ترین ابتدا.
- -t
- مرتب‌سازی بر اساس زمان اصلاح ('mtime' در inode)، جدیدترین ابتدا.
- -v
- مرتب‌سازی طبیعی شماره‌های (نسخه) در نام فایل‌ها.
- -X
- مرتب‌سازی الفبایی بر اساس پسوند مدخل.
- -U
- عدم مرتب‌سازی؛ فهرست کردن فایل‌ها با همان ترتیبی که در دایرکتوری ذخیره شده‌اند. این گزینه به‌ویژه هنگام فهرست کردن دایرکتوری‌های بسیار بزرگ سودمند است، چرا که انجام ندادن هیچ‌گونه مرتب‌سازی می‌تواند به‌طور محسوسی سریع‌تر باشد.
- -L, --dereference
- هنگام نمایش اطلاعات فایل برای یک پیوند نمادین، اطلاعات فایلی که پیوند به آن اشاره دارد به جای خود پیوند نمایش داده شود.
- --dereference-command-line-symlink-to-dir
- پیوندهای نمادین دنبال نشوند، مگر زمانی که به دایرکتوری‌ها اشاره داشته باشند و به‌عنوان آرگومان‌های خط فرمان داده شده باشند.
- -H, --dereference-command-line
- پیوندهای نمادین دنبال نشوند، مگر زمانی که به‌عنوان آرگومان‌های خط فرمان داده شده باشند..TP -G, --no-group در قالب بلند، گروه را نشان نده.
- نمایش پدیدآورنده در قالب بلند. در پلتفرم‌های پشتیبانی‌شده، پدیدآورنده همواره با مالک فایل یکسان است.
- -a, --all
- فایل‌های پنهان (فایل‌هایی که نام آن‌ها با '.' آغاز می‌شود) نادیده گرفته نشوند.
- -A, --almost-all
- در یک دایرکتوری، تمام نام‌های فایلی که با '.' آغاز می‌شوند را نادیده نگیر، تنها '.' و '..' نادیده گرفته شوند.
- -f
- فهرست کردن تمام فایل‌ها به ترتیب دایرکتوری، بدون مرتب‌سازی. معادل -aU. گزینه --color را غیرفعال می‌کند مگر اینکه صراحتاً مشخص شده باشد.
- -d, --directory
- تنها نام دایرکتوری‌ها فهرست شوند، نه محتویات دایرکتوری. این گزینه پیوندهای نمادین را دنبال نمی‌کند مگر اینکه یکی از گزینه‌های `--dereference-command-line (-H)`، `--dereference (-L)`، یا `--dereference-command-line-symlink-to-dir` مشخص شده باشد.
- -h, --human-readable
- چاپ اندازه فایل‌ها با فرمت خوانا برای انسان (مانند 1K 234M 56G).
- -k, --kibibytes
- پیش‌فرض قرار دادن بلوک‌های ۱۰۲۴ بایتی برای میزان مصرف سیستم فایل؛ تنها با -s و برای مجموع کل دایرکتوری‌ها استفاده می‌شود
- --si
- چاپ اندازه فایل‌ها با فرمت خوانا برای انسان با استفاده از توان‌های ۱۰۰۰ به جای ۱۰۲۴.
- --block-size <BLOCK_SIZE>
- مقیاس‌بندی اندازه‌ها بر اساس BLOCK_SIZE هنگام چاپ آن‌ها
- -i, --inode
- چاپ شماره نمایه (inode) هر فایل
- -r, --reverse
- معکوس کردن هر روش مرتب‌سازی مورد استفاده، برای مثال فهرست کردن فایل‌ها به ترتیب الفبایی معکوس، جدیدترین‌ها اول، کوچک‌ترین‌ها اول، یا هر حالت دیگر.
- -R, --recursive
- فهرست کردن محتویات تمام دایرکتوری‌ها به صورت بازگشتی.
- -w, --width <COLS>
- عرض ترمینال COLS ستون در نظر گرفته شود.
- -s, --size
- چاپ اندازه تخصیص‌یافته به هر فایل، بر حسب بلوک
- --color
- رنگی کردن
خروجی بر
اساس نوع
فایل.
مقادیر ممکن:
- always
- auto
- never
- --indicator-style
- الحاق
نشانگر با
سبک WORD به نام
ورودی‌ها: none
(پیش‌فرض)، slash
(-p)، file-type (--file-type)، classify (-F)
مقادیر ممکن:
- none
- slash
- file-type
- classify
- -F, --classify[=<when>]
- الحاق یک
نویسه به هر
نام فایل که
نشان‌دهنده
نوع فایل
است.
همچنین،
برای
فایل‌های
عادی که
قابل اجرا
هستند، '*'
الحاق
می‌شود.
نشانگرهای
نوع فایل
عبارتند از:
'/' برای
دایرکتوری‌ها،
'@' برای
پیوندهای
نمادین، '|'
برای FIFOها، '='
برای
سوکت‌ها، '>'
برای doorها، و
هیچ برای
فایل‌های
عادی. when
می‌تواند
حذف شود، یا
یکی از
مقادیر زیر
باشد:
none - دسته‌بندی نکن. این مقدار پیش‌فرض است.
auto - تنها در صورتی که خروجی استاندارد یک ترمینال باشد دسته‌بندی کن.
always - همواره دسته‌بندی کن. مشخص کردن --classify بدون when معادل --classify=always است. این گزینه پیوندهای نمادین درج‌شده در خط فرمان را دنبال نخواهد کرد مگر اینکه گزینه‌های --dereference-command-line (-H)، --dereference (-L)، یا --dereference-command-line-symlink-to-dir مشخص شده باشند.مقادیر ممکن:
- always
- auto
- never
- --file-type
- مشابه --classify، اما نویسه '*' را الحاق نمی‌کند
- -p
- الحاق نشانگر / به دایرکتوری‌ها.
- --time-style <TIME_STYLE>
- قالب زمان/تاریخ همراه با -l؛ بخش TIME_STYLE را در زیر ببینید
- --full-time
- مشابه -l --time-style=full-iso
- -Z, --context
- چاپ هرگونه بافت امنیتی (security context) هر فایل
- --group-directories-first
- قرار دادن دایرکتوری‌ها پیش از فایل‌ها؛ می‌تواند با یک گزینه --sort تکمیل شود، اما هرگونه استفاده از --sort=none (-U) گروه‌بندی را غیرفعال می‌کند
- -V, --version
- چاپ نسخه.SH "اطلاعات اضافی (EXTRA)" آرگومان TIME_STYLE می‌تواند full-iso، long-iso، iso، locale یا +FORMAT باشد. FORMAT همانند date تفسیر می‌شود. همچنین متغیر محیطی TIME_STYLE سبک پیش‌فرض مورد استفاده را تعیین می‌کند.
نسخه (VERSION)
v(uutils coreutils) 0.11.0
| 2026-09-01 |