نام (NAME)

paclog - فیلتر کردن مدخل‌های لاگ pacman

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

paclog [options] [filters]...
paclog [options] --pkglist
paclog (--help|--version)

توضیحات (DESCRIPTION)

اگر ورودی روی stdin ارائه شود، به جای --logfile تجزیه خواهد شد. مدخل‌های لاگ در صورتی که با هرکدام از فیلترهای ارائه‌شده مطابقت داشته باشند نمایش داده می‌شوند. برای نمایش اشتراک چندین فیلتر، می‌توان آن‌ها را با یک لوله (pipe) به هم متصل کرد:

paclog --after=2015-01-01 | paclog --warnings

گزینه‌ها (OPTIONS)

--config=path: تنظیم یک مسیر فایل پیکربندی جایگزین.
--logfile=path: تنظیم یک مسیر فایل لاگ جایگزین.
--root=path: تنظیم یک ریشهٔ نصب جایگزین.
--sysroot=path: تنظیم یک ریشهٔ سیستم جایگزین. pacutils-sysroot(7) را ببینید.
--[no-]color: رنگی کردن خروجی. به طور پیش‌فرض اگر stdout یک ترمینال باشد خروجی رنگی خواهد بود.
--pkglist: چاپ فهرست بسته‌های نصب‌شده بر اساس لاگ.
--help: نمایش اطلاعات نحوهٔ استفاده و خروج.
--version: نمایش اطلاعات نسخه و خروج.

فیلترها (Filters)

--action=action

نمایش عملیات بسته‌ها. action باید یکی از مقادیر "install"، "reinstall"، "upgrade"، "downgrade"، "remove" یا "all" باشد.

--after=date, --before=date

نمایش مدخل‌های بعد از/قبل از date. اگر ثانیه‌ها یا اطلاعات منطقهٔ زمانی درج شده باشند، در سکوت نادیده گرفته می‌شوند، که اجازه می‌دهد از خروجی "date -I" استفاده شود:

paclog --after "$(date -Iminutes --date '3 days ago')"

--caller=name

نمایش مدخل‌های لاگ از سوی name. می‌تواند چندین بار مشخص شود. حساس به بزرگ و کوچکی حروف (Case-sensitive).

--commandline

نمایش مدخل‌های خط فرمانی ثبت‌شده به سبک pacman.

--grep=regex

نمایش مدخل‌های لاگی که پیام آن‌ها با regex مطابقت دارد.

--package=pkgname

نمایش اقدامات ثبت‌شده‌ای که بر pkgname اثر می‌گذارند. می‌تواند چندین بار مشخص شود.

--warnings

نمایش خطاها، هشدارها و یادداشت‌ها.

هشدارها (CAVEATS)

paclog بر اساس یک بررسی ساده با استفاده از isatty(3) تعیین می‌کند که آیا فایل لاگ را از stdin بخواند یا خیر. اگر paclog در محیطی فراخوانی شود (مانند یک تابع یا اسکریپت شل که در یک خط لوله استفاده می‌شود) که در آن stdin به ترمینال متصل نیست اما حاوی فایل لاگی برای تجزیه کردن هم نیست، paclog باید با stdin بسته فراخوانی شود. برای شل‌های سازگار با POSIX، این کار می‌تواند با "<&-" انجام شود.