'\"macro stdmacro
.\"
.\" Copyright (c) 2000 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PMLOGSIZE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmlogsize\f1 \- گزارش اندازه بخش‌های مختلف بایگانی(های) PCP
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmlogsize\f1
[\f3\-drv?\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-x\f1 \f2threshold\f1]
\f2archive\f1
[...]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmlogsize
اطلاعات مربوط به اندازه بخش‌های نمایه (index)، فراداده (metadata) و داده (data) یک بایگانی Performance Co-Pilot (PCP) را چاپ می‌کند.
خروجی این ابزار با هدف راهنمایی جهت بهبود قالب کدگذاری بایگانی برای توسعه‌دهندگان PCP، و کمک به بهینه‌سازی فایل‌های پیکربندی
.BR pmlogger (1)
به‌منظور حذف معیارهایی که با داده‌های کم‌ارزش در محیط‌های عملیاتی حجم بایگانی‌های PCP را بیهوده افزایش می‌دهند، طراحی شده است.
.PP
آرگومان‌های
.I archive
می‌توانند ترکیبی دلخواه از نام فایل‌های فیزیکی یک بایگانی PCP یا نام پایه (basename) مشترک میان تمام فایل‌های فیزیکی تشکیل‌دهنده در یک بایگانی واحد باشند.
در حالت دوم،
.I archive
با فهرستی از تمامی نام‌های فایل‌های تشکیل‌دهنده منطبق جایگزین می‌شود.
.PP
توجه داشته باشید که معناشناسی این ابزار کمی با دیگر ابزارهای PCP متفاوت است؛ بدین صورت که
.B foo.meta
.B صرفاً
به معنی فایل
.BR foo.meta
است، نه
.BR foo.index ،
.BR foo.meta ،
.BR foo.0
و غیره.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-d\fR, \fB\-\-detail\fR
فعال‌سازی گزارش‌دهی با جزئیات.
این به معنای محاسبه فضای اختصاص‌یافته به ازای هر دامنه نمونه (instance domain) در فایل فراداده و فضا به ازای هر معیار (برای مقادیر) در فایل داده است.
.TP
\fB\-r\fR, \fB\-\-replication\fR
نمایش اطلاعات تکمیلی درباره مقادیر تکراری احتمالی در فایل داده و نمونه‌های تکراری در فایل فراداده.
این گزینه به‌طور ضمنی شامل
.B \-d
می‌شود.
.TP
\fB\-x\fR \fIthreshold\fR, \fB\-\-threshold\fR=\fIthreshold\fR
همراه با
.B \-d
(یا
.BR \-r )،
گزارش را پس از گزارش شدن حداقل
.I threshold
درصد از فضای مرتبط (مقادیر معیارها یا دامنه‌های نمونه) متوقف می‌کند.
رفتار پیش‌فرض معادل تنظیم
.I threshold
روی \fB100\fR است.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
فعال‌سازی حالت پرحرف (verbose).
این گزینه می‌تواند بیش از یک بار برای افزایش سطح جزئیات ارائه شود.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "گزینه‌های عیب‌یابی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی پیام‌های عیب‌یابی اضافی را روی
.I stderr
جهت کمک به تفکیک و ریشه‌یابی مشکلات فعال می‌کند؛ اگرچه این اطلاعات گاهی مبهم بوده و در درجه اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی.
.I debug
فهرستی از گزینه‌های عیب‌یابی است که با کاما از هم جدا شده‌اند؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای به‌دست آوردن فهرستی از گزینه‌های عیب‌یابی موجود و معانی آن‌ها استفاده کنید.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای مقداردهی و پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده، استفاده شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmlogcheck (1),
.BR pmlogdump (1)
و
.BR pmlogger (1).