PMLOGSIZE(1) General Commands Manual PMLOGSIZE(1)

pmlogsize - گزارش اندازه بخش‌های مختلف بایگانی(های) PCP

pmlogsize [-drv?] [-D debug] [-x threshold] archive [...]

دستور pmlogsize اطلاعات مربوط به اندازه بخش‌های نمایه (index)، فراداده (metadata) و داده (data) یک بایگانی Performance Co-Pilot (PCP) را چاپ می‌کند. خروجی این ابزار با هدف راهنمایی جهت بهبود قالب کدگذاری بایگانی برای توسعه‌دهندگان PCP، و کمک به بهینه‌سازی فایل‌های پیکربندی pmlogger(1) به‌منظور حذف معیارهایی که با داده‌های کم‌ارزش در محیط‌های عملیاتی حجم بایگانی‌های PCP را بیهوده افزایش می‌دهند، طراحی شده است.

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

توجه داشته باشید که معناشناسی این ابزار کمی با دیگر ابزارهای PCP متفاوت است؛ بدین صورت که foo.meta صرفاً به معنی فایل foo.meta است، نه foo.index، foo.meta، foo.0 و غیره.

گزینه‌های خط فرمان موجود عبارتند از:

فعال‌سازی گزارش‌دهی با جزئیات. این به معنای محاسبه فضای اختصاص‌یافته به ازای هر دامنه نمونه (instance domain) در فایل فراداده و فضا به ازای هر معیار (برای مقادیر) در فایل داده است.
نمایش اطلاعات تکمیلی درباره مقادیر تکراری احتمالی در فایل داده و نمونه‌های تکراری در فایل فراداده. این گزینه به‌طور ضمنی شامل -d می‌شود.
همراه با -d (یا -r)، گزارش را پس از گزارش شدن حداقل threshold درصد از فضای مرتبط (مقادیر معیارها یا دامنه‌های نمونه) متوقف می‌کند. رفتار پیش‌فرض معادل تنظیم threshold روی 100 است.
فعال‌سازی حالت پرحرف (verbose). این گزینه می‌تواند بیش از یک بار برای افزایش سطح جزئیات ارائه شود.
-?, --help
نمایش پیام راهنما و خروج.

گزینه -D یا --debug خروجی پیام‌های عیب‌یابی اضافی را روی stderr جهت کمک به تفکیک و ریشه‌یابی مشکلات فعال می‌کند؛ اگرچه این اطلاعات گاهی مبهم بوده و در درجه اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی. debug فهرستی از گزینه‌های عیب‌یابی است که با کاما از هم جدا شده‌اند؛ از pmdbg(1) همراه با گزینه -l برای به‌دست آوردن فهرستی از گزینه‌های عیب‌یابی موجود و معانی آن‌ها استفاده کنید.

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

PCPIntro(1), pmlogcheck(1), pmlogdump(1) و pmlogger(1).

PCP Performance Co-Pilot