eza(1) General Commands Manual eza(1)

eza - جایگزینی مدرن برای ls

eza [options] [files...]

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

همچنین دارای امکانات بیشتری است که در ls اصلی وجود ندارد؛ از جمله مشاهده وضعیت Git برای یک دایرکتوری، یا پیمایش بازگشتی در دایرکتوری‌ها با نمای درختی.

محتویات دایرکتوری جاری را به صورت شبکه‌ای فهرست می‌کند.
فهرستی از فایل‌ها را نمایش می‌دهد که بزرگ‌ترین آن‌ها در بالا قرار دارد.
جدولی از فایل‌ها را همراه با سربرگ نمایش می‌دهد که متاداده، inode و وضعیت Git هر فایل را نشان می‌دهد.
یک ساختار درختی از فایل‌ها را تا عمق ۳ سطح، همراه با متاداده‌های هر فایل نمایش می‌دهد.

نمایش فهرست گزینه‌های خط فرمان.
نمایش نسخه eza.

-1, --oneline
نمایش هر ورودی در یک خط جداگانه.
نمایش ورودی‌ها همراه با مسیر مطلق آن‌ها.

تنظیمات معتبر عبارت‌اند از `on`، `follow` و `off`. در صورت استفاده بدون مقدار، به‌طور پیش‌فرض `on` در نظر گرفته می‌شود.

`on`: نمایش مسیرهای مطلق برای همه ورودی‌ها. `follow`: نمایش مسیرهای مطلق و بازگشایی پیوندهای نمادین به مقصدهایشان. `off`: نمایش مسیرهای نسبی (رفتار پیش‌فرض).

نمایش نشانگر نوع فایل در کنار نام فایل‌ها.

تنظیمات معتبر عبارت‌اند از `always`، `automatic` (یا به اختصار `auto`) و `never`. در صورت استفاده بدون مقدار، به‌طور پیش‌فرض `automatic` اعمال می‌شود.

مقدار automatic یا auto تنها زمانی نشانگرهای نوع فایل را نمایش می‌دهد که خروجی استاندارد به یک ترمینال واقعی متصل باشد. اگر eza در یک tty اجرا شود، یا خروجی eza به یک فایل هدایت شده یا به برنامه دیگری پایپ شود، از نشانگرهای نوع فایل استفاده نخواهد شد. تنظیم این گزینه روی `always` باعث می‌شود eza همیشه نشانگرهای نوع فایل را نمایش دهد، در حالی که `never` استفاده از آن‌ها را غیرفعال می‌کند.

نمایش ورودی‌ها به صورت شبکه‌ای (پیش‌فرض).
نمایش متاداده‌های توسعه‌یافته فایل به صورت یک جدول.
پیمایش بازگشتی در دایرکتوری‌ها.
پیمایش بازگشتی در دایرکتوری‌ها به صورت ساختار درختی.
چاپ خلاصه‌ای از تعداد خطوط کد بر حسب زبان به‌جای فهرست کردن فایل‌ها، هم‌راستا با ابزارهایی مانند tokei و cloc. مسیرهای مشخص‌شده (یا دایرکتوری جاری) به‌طور بازگشتی پیمایش می‌شوند و در صورت وجود، فایل .gitignore مخزن git رعایت می‌گردد؛ هر زبان شناخته‌شده همراه با تعداد فایل‌ها، خطوط، کد، توضیحات و خطوط خالی، به همراه یک نوار که سهم آن از کد را به تصویر می‌کشد گزارش می‌شود. حالت‌های معتبر عبارت‌اند از `lines`، `percent` و `both` (پیش‌فرض).
پیمایش به درون پیوندهای نمادینی که به دایرکتوری‌ها اشاره دارند.
دنبال کردن و بازگشایی پیوندهای نمادین هنگام نمایش اطلاعات.
مرتب‌سازی شبکه به‌صورت افقی (سطری)، به‌جای عمودی (ستونی).
تعیین زمان استفاده از رنگ‌های ترمینال (با استفاده از کدهای گریز ANSI برای رنگ‌آمیزی خروجی).

تنظیمات معتبر عبارت‌اند از `always`، `automatic` (یا به اختصار `auto`) و `never`. در صورت استفاده بدون مقدار، به‌طور پیش‌فرض `automatic` اعمال می‌شود.

رفتار پیش‌فرض (`automatic` یا `auto`) خروجی را تنها زمانی رنگ‌آمیزی می‌کند که خروجی استاندارد به یک ترمینال واقعی متصل باشد. اگر خروجی eza به یک فایل هدایت شود یا به برنامه دیگری پایپ گردد، از رنگ‌های ترمینال استفاده نخواهد شد. تنظیم این گزینه روی `always` موجب می‌شود eza همیشه خروجی را با رنگ‌های ترمینال تولید کند، در حالی که `never` استفاده از رنگ‌های ترمینال را غیرفعال می‌سازد.

تنظیم دستی این گزینه، متغیر محیطی NO_COLOR را نادیده می‌گیرد.

برجسته‌سازی سطوح مختلفِ field به‌صورت متمایز. از فهرستی جداشده با کاما (,) شامل all، age و size استفاده کنید.
استفاده از رنگ‌های گرادیان یا ثابت در --color-scale.

گزینه‌های معتبر عبارت‌اند از fixed یا gradient. در صورت استفاده بدون مقدار، به‌طور پیش‌فرض gradient انتخاب می‌شود.

نمایش آیکون‌ها در کنار نام فایل‌ها.

تنظیمات معتبر عبارت‌اند از `always`، `automatic` (به اختصار `auto`) و `never`. در صورت استفاده بدون مقدار، به‌طور پیش‌فرض `automatic` در نظر گرفته می‌شود.

مقدار automatic یا auto آیکون‌ها را تنها زمانی نمایش می‌دهد که خروجی استاندارد به یک ترمینال واقعی متصل باشد. اگر eza در یک tty اجرا شود، یا خروجی eza به یک فایل هدایت شده یا به برنامه دیگری پایپ شود، از آیکون‌ها استفاده نخواهد شد. تنظیم این گزینه به `always` باعث می‌شود eza همواره آیکون‌ها را نمایش دهد، در حالی که `never` استفاده از آیکون‌ها را غیرفعال می‌نماید.

قرار ندادن نام‌های فایلی که دارای فاصله هستند در داخل نقل‌قول.
کوتاه‌سازی هش‌های Nix store در نام‌ها و مسیرهای فایل. بخشی از یک مسیر که با یک هش Nix store آغاز می‌شود — دقیقاً ۳۲ نویسه از الفبای base32 در Nix که به دنبال آن یک خط‌تیره می‌آید، مانند vlkia5wk0svsikwv50554mh06iayg2m2-source.drv — به‌گونه‌ای نمایش داده می‌شود که هش به ۸ نویسه اول و یک نشان سه‌نقطه خلاصه شده و با رنگ کم‌رنگ رسم می‌گردد تا نام اصلی فایل برجسته شود: vlkia5wk...-source.drv. این ویژگی بر نام‌های فهرست‌شده، مقصدهای پیوندهای نمادین و مسیرهای مطلق اعمال می‌گردد.
نمایش ورودی‌ها به صورت ابرپیوند (hyperlink).

تنظیمات معتبر عبارت‌اند از `always`، `automatic` (به اختصار `auto`) و `never`. در صورت استفاده بدون مقدار، به‌طور پیش‌فرض `automatic` اعمال می‌شود.

حالت automatic یا auto تنها زمانی ابرپیوندها را نمایش می‌دهد که خروجی استاندارد به یک ترمینال واقعی متصل باشد. اگر eza در یک tty اجرا شود، یا خروجی eza به یک فایل هدایت شده یا به برنامه دیگری پایپ گردد، از ابرپیوندها استفاده نخواهد شد. تنظیم این گزینه روی `always` باعث می‌شود eza همواره ابرپیوندها را نمایش دهد، در حالی که `never` استفاده از آن‌ها را غیرفعال می‌کند.

تنظیم عرض صفحه نمایش بر اساس تعداد ستون‌ها..SH "گزینه‌های فیلتر و مرتب‌سازی (FILTERING AND SORTING OPTIONS)"
نمایش فایل‌های پنهان و «نقطه‌دار» (dot files). از این گزینه دوبار استفاده کنید تا دایرکتوری‌های `.' و `..' نیز نمایش داده شوند.
معادل --all؛ برای سازگاری با ls -A گنجانده شده است.
این پرچم که از ls به ارث رسیده است، نحوهٔ رفتار eza با آرگومان‌های دایرکتوری را تغییر می‌دهد. به جای ورود بازگشتی به دایرکتوری‌ها و فهرست کردن محتوای آن‌ها (رفتار پیش‌فرض)، با دایرکتوری‌ها مانند فایل‌های معمولی رفتار کرده و اطلاعات مربوط به خود مدخل دایرکتوری را فهرست می‌کند. این قابلیت زمانی مفید است که می‌خواهید فراداده‌های مربوط به خود دایرکتوری (مانند مجوزها، اندازه، زمان ویرایش) را به جای محتوای آن مشاهده کنید. برای صرفاً فهرست کردن دایرکتوری‌ها و نه فایل‌ها، استفاده از گزینهٔ --only-dirs (-D) را به عنوان جایگزین در نظر بگیرید.
محدود کردن عمق بازگشت (تکرار بازگشتی).
معکوس کردن ترتیب مرتب‌سازی.
فیلدی که مرتب‌سازی بر اساس آن انجام می‌شود.

فیلدهای معتبر مرتب‌سازی عبارتند از `name'، `Name'، `extension'، `Extension'، `size'، `modified'، `changed'، `accessed'، `created'، `inode'، `type' و `none'.

فیلد مرتب‌سازی modified دارای نام‌های مستعار `date'، `time' و `newest' است و ترتیب معکوس آن دارای نام‌های مستعار `age' و `oldest' می‌باشد.

فیلدهای مرتب‌سازی که با یک حرف بزرگ آغاز می‌شوند، حروف بزرگ را قبل از حروف کوچک مرتب می‌کنند: ابتدا `A'، سپس `B'، سپس `a' و سپس `b'. فیلدهایی که با حروف کوچک شروع می‌شوند، آن‌ها را ترکیب می‌کنند: ابتدا `A'، سپس `a'، سپس `B' و سپس `b'.

الگوهای تطابق (glob) جداشده با خط عمودی (pipe)، برای نادیده گرفتن فایل‌ها.
عدم فهرست کردن فایل‌هایی که توسط Git نادیده گرفته شده‌اند (ignore شده‌اند).
فهرست کردن دایرکتوری‌ها پیش از سایر فایل‌ها.
فهرست کردن دایرکتوری‌ها پس از سایر فایل‌ها.
فقط دایرکتوری‌ها فهرست شوند، نه فایل‌ها.
فقط فایل‌ها فهرست شوند، نه دایرکتوری‌ها.
نمایش صریح پیوندهای نمادین (هنگام استفاده همراه با --only-files | --only-dirs)
عدم نمایش پیوندهای نمادین.

این گزینه‌ها هنگام اجرا با --long (-l) در دسترس هستند:

فهرست کردن اندازهٔ فایل‌ها با پیشوندهای دودویی (باینری).
فهرست کردن اندازهٔ فایل‌ها بر حسب بایت، بدون هیچ پیشوندی.
استفاده از فیلد برچسب زمانی تغییر وضعیت (changed).
فهرست کردن گروه هر فایل.
تنها در صورتی گروه را نمایش بده که نامی متفاوت از مالک داشته باشد.
افزودن یک سطر سربرگ به هر ستون.
فهرست کردن تعداد پیوندهای سخت (hard links) هر فایل.
فهرست کردن شمارهٔ inode هر فایل.
افزودن یک ستون زبان و یک ستون تعداد خطوط کد به نمای تفصیلی. تنها فایل‌های معمولی به یک زبان برنامه‌نویسی شناخته‌شده شمرده می‌شوند؛ شمارش نسبت به کامنت‌ها آگاه است، بنابراین ستون کد خطوط توضیحات و خالی را در نظر نمی‌گیرد. حالت‌های معتبر عبارتند از `lines' (تعداد خطوط کد)، `percent' (سهم هر فایل از کد در کل ساختار درختی)، و `both' (پیش‌فرض). در حالت‌های percent و both، مخرج کسر مجموع کل کدهای موجود در سراسر درخت پیمایش‌شده، یا در صورت وجود مخزن git، کل مخزن است.
استفاده از فیلد برچسب زمانی ویرایش محتوا (modified).
نمایش جزئیات نقطهٔ اتصال (mount) (فقط در لینوکس و مک).
فهرست کردن شناسه‌های کاربری و گروه به صورت عددی.
فهرست کردن پرچم‌های فایل در سیستم‌های Mac و BSD و مشخصه‌های فایل در سیستم‌های Windows. به طور پیش‌فرض، مشخصه‌های ویندوز به صورت کامل نمایش داده می‌شوند. برای نمایش مشخصه‌ها به صورت تک‌نویسه‌ای، متغیر محیطی EZA_WINDOWS_ATTRIBUTES=short را تنظیم کنید. در سیستم‌های BSD، برای مشاهدهٔ فهرستی از پرچم‌های فایل و معانی آن‌ها، chflags(1) را ببینید.
فهرست کردن اندازهٔ بلوک‌های تخصیص‌یافته به هر فایل در فایل‌سیستم.
تعیین اینکه کدام فیلد برچسب زمانی فهرست شود. فیلدهای زمانی معتبر عبارتند از `modified'، `changed'، `accessed' و `created'.
نحوهٔ قالب‌بندی برچسب‌های زمانی. شیوه‌های معتبر برچسب زمانی عبارتند از `default'، `iso'، `long-iso'، `full-iso'، `relative'، یا یک سبک سفارشی `+<FORMAT>' (به عنوان مثال، `+%Y-%m-%d %H:%M' => `2023-09-30 13:00').

<FORMAT> باید یک رشتهٔ قالب‌بندی chrono باشد. برای جزئیات درباره نحو نگارش ساختار chrono، لطفاً بخوانید: https://docs.rs/chrono/latest/chrono/format/strftime/index.html .

به عنوان روش دیگر، <FORMAT> می‌تواند یک رشتهٔ دوخطی باشد؛ خط نخست برای فایل‌های غیرجدید و خط دوم برای فایل‌های اخیر استفاده خواهد شد. به عنوان مثال، اگر <FORMAT> برابر با “%Y-%m-%d %H<newline>--%m-%d %H:%M” باشد، فایل‌های غیرجدید => “2022-12-30 13”، و فایل‌های اخیر => “--09-30 13:34”.

نمایش اندازهٔ بازگشتی دایرکتوری (فقط در یونیکس).
استفاده از فیلد برچسب زمانی آخرین دسترسی (accessed).
استفاده از فیلد برچسب زمانی ایجاد (created).
حذف فیلد مجوزها از خروجی.
فهرست کردن مجوزهای هر فایل در قالب هشت‌هشتی (octal).
حذف فیلد اندازهٔ فایل از خروجی.
حذف فیلد کاربر از خروجی.
حذف فیلد زمان از خروجی.
زمانی که می‌خواهید دایرکتوری‌ها را به eza هدایت (pipe) کرده یا از ورودی استاندارد (stdin) بخوانید. هر مورد را در یک خط جدا کنید یا نویسهٔ جداساز سفارشی را در متغیر محیطی EZA_STDIN_SEPARATOR تعریف نمایید.
-@, --extended
فهرست کردن ویژگی‌های گسترش‌یافته (extended attributes) و اندازه‌های هر فایل.
فهرست کردن زمینهٔ امنیتی (security context) هر فایل.
فهرست کردن وضعیت Git هر فایل، در صورتی که ردیابی شده باشد. این گزینه یک ستون دو نویسه‌ای اضافه می‌کند که به ترتیب وضعیت‌های آماده‌سازی‌شده (staged) و آماده‌سازی‌نشده (unstaged) را نشان می‌دهد. نویسهٔ وضعیت می‌تواند شامل موارد زیر باشد: `-' برای تغییرنیافته، `M' برای فایل تغییریافته، `N' برای فایل جدید، `D' برای حذف‌شده، `R' برای تغییرنام‌یافته، `T' برای تغییر نوع، `I' برای نادیده‌گرفته‌شده، و `U' برای دارای تداخل (conflicted). دایرکتوری‌ها وضعیتی متناسب با محتوای خود نشان خواهند داد؛ به همین دلیل است که «حذف‌شده» برای دایرکتوری نیز ممکن است، و اگر دایرکتوری حاوی فایلی با وضعیتی خاص باشد، با همان وضعیت نمایش داده خواهد شد..TP --git-repos [اگر eza با پشتیبانی از git ساخته شده باشد] وضعیت Git هر پوشه را، در صورت ردگیری شدن، فهرست می‌کند. نمادهای نمایش‌داده‌شده عبارتند از: |= بدون تغییر (clean)، += تغییریافته (dirty) و ~= برای ناشناخته (unknown).
مخزن Git بودن پوشه را فهرست می‌کند، اما وضعیت آن را نشان نمی‌دهد. تمامی پوشه‌های مخزن Git به‌صورت نماد - (همراه با تم) و بدون مشخص شدن وضعیت نمایش داده خواهند شد.
وضعیت Git را نمایش نمی‌دهد (همواره بر --git، --git-repos و --git-repos-no-status تقدم دارد و آن‌ها را لغو می‌کند).

اگر متغیر محیطی با پیشوند EZA_ مقداردهی نشده باشد، برای حفظ سازگاری با نسخه‌های پیشین، به‌طور پیش‌فرض از متغیر همتای آن که با EXA_ شروع می‌شود استفاده خواهد شد.

دستور eza به متغیرهای محیطی زیر پاسخ می‌دهد:

عرض ترمینال را برحسب تعداد نویسه‌ها بازنویسی می‌کند، هرچند گزینهٔ -w اولویت بالاتری دارد.

برای نمونه، دستور `COLUMNS=80 eza' یک نمای شبکه‌ای (grid) را با حداکثر عرض ۸۰ نویسه نمایش می‌دهد.

این متغیر زمانی که خروجی eza سطرشکنی (wrap) نمی‌شود، مانند زمان استفاده از نمای --long، هیچ تأثیری نخواهد داشت.

«حالت سخت‌گیرانه» (strict mode) را فعال می‌کند که باعث می‌شود در صورت ناسازگاری دو گزینهٔ خط فرمان با یکدیگر، eza با خطا متوقف شود.

به‌طور معمول، گزینه‌ها در خط فرمان می‌توانند از راست به چپ جایگزین گزینه‌های قبلی شوند، به‌طوری که امکان ساخت نام‌های مستعار (alias) برای eza وجود دارد: تعریف یک نام مستعار مانند `eza=eza --sort=ext' و سپس اجرای `eza --sort=size' با آن نام مستعار، در عمل دستور `eza --sort=ext --sort=size' را اجرا خواهد کرد، و مرتب‌سازی تعیین‌شده توسط کاربر جایگزین مرتب‌سازی مشخص‌شده در نام مستعار می‌شود.

در حالت سخت‌گیرانه، این دو گزینه با یکدیگر همکاری نکرده و eza با خطا متوقف خواهد شد.

این گزینه برای استفاده در اسکریپت‌های خودکار و شرایط دیگری در نظر گرفته شده است که می‌خواهید از وارد کردن دستور درست اطمینان قطعی داشته باشید.

نمای جزئیات شبکه‌ای (`eza --grid --long') را محدود می‌کند، به‌گونه‌ای که تنها در صورتی فعال شود که دست‌کم تعداد سطرهای مشخص‌شده از خروجی تولید گردد.

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

تعداد فاصله‌هایی (spaces) را تعیین می‌کند که باید بین یک آیکون (گزینهٔ `--icons' را ببینید) و نام فایل آن چاپ شود.

شبیه‌سازهای ترمینال مختلف آیکون‌ها را متفاوت نمایش می‌دهند، چرا که آن‌ها معمولاً بیش از یک نویسه از عرض صفحه را اشغال می‌کنند؛ بنابراین هیچ تعداد فاصلهٔ “استانداردی” وجود ندارد که eza بتواند برای تفکیک آیکون از متن از آن استفاده کند. یک فاصله ممکن است آیکون را بیش از حد به متن نزدیک کند و دو فاصله ممکن است آن را بیش از حد دور سازد. بنابراین انتخاب و تنظیم این مورد بسته به شبیه‌ساز ترمینال، به عهدهٔ خود کاربر گذاشته شده است.

رنگ‌ها را در خروجی غیرفعال می‌کند (صرف‌نظر از مقداری که دارد). می‌توان با گزینهٔ --color آن را لغو و بازنویسی کرد.

برای جزئیات بیشتر به https://no-color.org مراجعه کنید.

طرح رنگی مورد استفاده برای برجسته‌سازی فایل‌ها بر اساس نام و نوع آن‌ها، و همچنین برجسته‌سازی فراداده‌ها و بخش‌هایی از رابط کاربری را تعیین می‌کند.

برای دریافت اطلاعات بیشتر دربارهٔ ساختار این متغیرهای محیطی، به صفحهٔ راهنمای eza_colors.5.md مراجعه کنید.

هرگونه آرگومان --git یا --git-repos را لغو و بازنویسی می‌کند.

حداقل روشنایی (luminance) را برای زمان فعال بودن مقیاس رنگ (color-scale) تعیین می‌کند. مقدار آن می‌تواند عددی بین -100 تا 100 باشد.

در صورت تنظیم، رفتاری معادل با استفاده از --icons یا --icons=auto را به‌طور خودکار اعمال می‌کند. زمانی کاربرد دارد که بخواهید آیکون‌ها همواره فعال باشند.

هرگونه استفادهٔ صریح از پرچم --icons=WHEN این رفتار را لغو خواهد کرد.

جداکننده‌ای را که هنگام هدایت (pipe) نام فایل‌ها از ورودی استاندارد (stdin) استفاده می‌شود مشخص می‌کند. پیش‌فرض آن نویسهٔ خط جدید (newline) است.

پوشه‌ای را تعیین می‌کند که eza در آن به‌دنبال فایل‌های پیکربندی و تم‌های خود می‌گردد. در صورتی که XDG_CONFIG_HOME مقداردهی نشده باشد، مقدار پیش‌فرض آن $XDG_CONFIG_HOME/eza یا $HOME/.config/eza خواهد بود.

0
اگر همه‌چیز بدون خطا و به‌درستی انجام شود.
1
اگر در حین عملیات یک خطای ورودی/خروجی (I/O) رخ دهد.
3
اگر مشکلی در آرگومان‌های خط فرمان وجود داشته باشد.
13
اگر دسترسی لازم برای دسترسی به یک مسیر مجاز نباشد (Permission denied).

نگه‌داری و توسعهٔ eza توسط Christina Sørensen و بسیاری از مشارکت‌کنندگان دیگر انجام می‌شود.

کد منبع: https://github.com/eza-community/eza

مشارکت‌کنندگان: https://github.com/eza-community/eza/graphs/contributors

با سپاس بی‌پایان از Benjamin `ogham' Sago و تمامی دیگر مشارکت‌کنندگان پروژهٔ exa، که eza از آن منشعب (fork) شده است..SH "همچنین ببینید (SEE ALSO)"

•
eza_colors(5)
•
eza_colors-explanation(5)
$version