نام (NAME)

lnav - نمایشگر فایل لاگ برای ترمینال

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

lnav [گزینه‌ها] [logfile1 logfile2 ...]

توضیحات (DESCRIPTION)

برنامه Logfile Navigator یا lnav، یک نمایشگر فایل لاگ برای محیط ترمینال است. با دریافت مجموعه‌ای از فایل‌ها یا دایرکتوری‌ها، lnav کارهای زیر را انجام می‌دهد:

- در صورت نیاز، آن‌ها را از حالت فشرده خارج می‌کند؛
- فرمت (قالب) آن‌ها را تشخیص می‌دهد؛
- فایل‌ها را بر اساس زمان با یکدیگر ادغام کرده و در یک نمای واحد نمایش می‌دهد؛
- فایل‌ها را به‌صورت زنده دنبال می‌کند (tail)، تغییر نام‌ها را پیگیری کرده و فایل‌های جدید را در دایرکتوری‌ها پیدا می‌کند؛
- نمایه‌ای از خطاها و هشدارها ایجاد می‌کند؛
- خطوط JSON را به‌صورت خوانا و زیبا (pretty-print) قالب‌بندی می‌کند.

کلیدهای میان‌بر (KEY BINDINGS)

?: مشاهده یا خروج از متن راهنمای آنلاین.
q: خروج از برنامه.

گزینه‌ها (OPTIONS)

-h: چاپ راهنما و خروج.
-H: نمایش متن راهنمای داخلی.
-I path: افزودن دایرکتوری پیکربندی مشخص‌شده به مسیر جستجو.
-W: چاپ هشدارهای مربوط به پیکربندی lnav.
-u: به‌روزرسانی فرمت‌های نصب‌شده از مخازن git.
-d file: نوشتن پیام‌های اشکال‌زدایی (debug) در فایل مشخص‌شده.
-V: چاپ اطلاعات نسخه.
-r: بارگذاری بازگشتی فایل‌ها از دایرکتوری‌های مشخص‌شده.
-R: بارگذاری فایل‌های لاگ چرخش‌یافته (rotated) قدیمی‌تر.
-c cmd: اجرای یک دستور پس از بارگذاری کامل فایل‌ها.
-f path: اجرای دستورات موجود در فایل مشخص‌شده.
-e cmd: اجرای یک خط‌فرمان شل (shell).
-t: افزودن برچسب‌های زمانی به ابتدای خطوط داده‌ای که از ورودی استاندارد خوانده می‌شوند.
-n: اجرا بدون واسط کاربری curses (حالت بدون سر یا headless).
-N: در صورتی که هیچ فایلی تعیین نشود، فایل syslog پیش‌فرض باز نشود.
-q: حالت بی‌صدا. پس از اجرای تمام دستورات، پیام‌های لاگ چاپ نشوند.

آرگومان‌های اختیاری (Optional arguments):

logfile1: فایل‌های لاگ یا دایرکتوری‌ها جهت مشاهده. اگر یک دایرکتوری داده شود، تمامی فایل‌های موجود در آن دایرکتوری بارگذاری خواهند شد.

گزینه‌های حالت مدیریت (MANAGEMENT-MODE OPTIONS)

-i: نصب فایل‌های فرمت ارائه‌شده در دایرکتوری $HOME/.lnav/formats/installed و خروج.
-m: تغییر وضعیت به حالت خط‌فرمان مدیریتی. این حالت برای کار با پیکربندی lnav استفاده می‌شود.
-C: بررسی پیکربندی و خروج. فایل‌های فرمت لاگ بارگذاری و بررسی خواهند شد. هر فایلی که در خط‌فرمان مشخص شده باشد نیز بارگذاری و بررسی می‌شود تا از تطابق آن با یک فرمت لاگ اطمینان حاصل گردد.

مثال‌ها (EXAMPLES)

برای بارگذاری و دنبال کردن فایل syslog:

lnav

برای بارگذاری تمامی فایل‌های موجود در مسیر /var/log:

lnav /var/log

برای مشاهده خروجی دستور make به همراه برچسب‌های زمانی اضافه‌شده در ابتدای سطرها:

make 2>&1 | lnav -t

نویسنده (AUTHOR)

این صفحه راهنما توسط Salvatore Bonaccorso <carnil@debian.org> برای سیستم دبیان (Debian) نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).