PMLOGGER_REWRITE(1) General Commands Manual PMLOGGER_REWRITE(1)

pmlogger_rewrite - اسکریپت کمکی برای بازنویسی بایگانی‌های Performance Co-Pilot

$PCP_BINADM_DIR/pmlogger_rewrite [-dNsVvw?] [-c config] archive ...

دستور pmlogger_rewrite یک اسکریپت کمکی است که توسط pmlogger_daily(1) هنگام بازنویسی بایگانی‌های Performance Co-Pilot (PCP) استفاده می‌شود. بازنویسی معمولاً برای هماهنگی با تغییرات تدریجی فراداده‌ها مورد نیاز است تا بایگانی‌های قدیمی به‌روزرسانی شده و سپس با بایگانی‌های فعلی ادغام شوند.

اسکریپت pmlogger_rewrite یک پوشش (wrapper) برای pmlogrewrite(1) است که می‌تواند تمام بایگانی‌های منطبق با آرگومان‌های archive را بازنویسی کند. هر آرگومان archive می‌تواند نام فایل یک بایگانی PCP، نام پایه (basename) فایل‌ها در یک بایگانی PCP، یا یک دایرکتوری باشد (که در این حالت تمام بایگانی‌های زیرمجموعه PCP با پیمایش بازگشتی پیدا می‌شوند).

دستور pmlogrewrite با گزینهٔ -i اجرا می‌شود تا بازنویسی به‌صورت «درجا» (in place) انجام گیرد. همچنین از گزینهٔ -q نیز استفاده می‌شود تا در صورتی که نیازی به بازنویسی نبود، هیچ تغییری در فایل‌های بایگانی ایجاد نشود.

گزینه‌های زیر عیناً به pmlogrewrite منتقل می‌شوند: -c (یا --config)، -d (یا --desperate)، -s (یا --scale)، -v (یا --verbose) و -w (یا --warnings). برای اطلاع از مفهوم این گزینه‌ها به pmlogrewrite(1) مراجعه کنید.

سایر گزینه‌ها عبارتند از:

اجرای pmlogger_rewrite در حالت «نمایشی» یا «آزمایشی» (dry run) که در آن کارهایی که قرار است انجام شوند گزارش می‌شوند، اما هیچ تغییری ایجاد نمی‌شود. این حالت معمولاً برای اشکال‌زدایی در ترکیب با یک گزینهٔ -V (حالت پرگو) یا دو گزینهٔ -V (حالت بسیار پرگو) استفاده می‌شود.
افزایش پرگویی (جزئیات تفصیلی) خروجی اسکریپت.
-?, --help
نمایش پیام راهنما و خروج.

متغیرهای محیطی با پیشوند PCP_ برای پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf حاوی مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است.

PCPIntro(1)، pmlogger(1)، pmlogger_daily(1) و pmlogrewrite(1).

PCP Performance Co-Pilot