نام (NAME)

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

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

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

توضیحات (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: دنبال کردن پیوندهای نمادین مشخص‌شده در خط فرمان
--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: چاپ شماره اینود (شماره شاخص) هر فایل
-I, --ignore=PATTERN: ورودی‌های ضمنی منطبق بر الگوی شل PATTERN فهرست نشوند
-k, --kibibytes: پیش‌فرض روی بلوک‌های ۱۰۲۴ بایتی برای فضای فایل‌سیستم؛ فقط همراه با -s و مجموع هر دایرکتوری استفاده می‌شود
-l: استفاده از قالب فهرست طولانی (نمایش جزئیات کامل)
-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: قرار دادن نام ورودی‌ها داخل گیومه دوگانه
--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) استفاده کنید.

وضعیت خروج (Exit status):

0: اگر عملیات با موفقیت انجام شود (OK)،
1: در صورت بروز مشکلات جزئی (مانند عدم امکان دسترسی به زیردایرکتوری)،
2: در صورت بروز مشکلات جدی (مانند عدم امکان دسترسی به آرگومان خط فرمان).

نویسندگان (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)

dircolors(1)

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