'\" t
.\"
.\" 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 PMLOGCHECK 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmlogcheck\f1 \- بررسی داده‌های نامعتبر در آرشیو PCP
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmlogcheck\f1
[\f3\-flmRrvwz?\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-n\f1 \f2pmnsfile\f1]
[\f3\-S\f1 \f2start\f1]
[\f3\-T\f1 \f2finish\f1]
[\f3\-Z\f1 \f2timezone\f1]
\f2archive\f1 ...
.de EX
.in +0.5i
.ie t .ft CB
.el .ft B
.ie t .sp .5v
.el .sp
.ta \\w' 'u*8
.nf
..
.de EE
.fi
.ie t .sp .5v
.el .sp
.ft R
.in
..
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmlogcheck
اطلاعاتی را درباره ماهیت هرگونه داده نامعتبر که در فایل‌های آرشیو PCP شناسایی کند، چاپ می‌نماید.
برای برخی موارد محدود، این ابزار امکان «تعمیر» را نیز فراهم می‌آورد.
.PP
هر آرشیو دارای نام پایه
.I archive
است و باید پیش‌تر با استفاده از
.BR pmlogger (1)
ایجاد شده باشد.
همچنین،
.I archive
می‌تواند نام یک فایل فیزیکی باشد که بخشی از یک آرشیو PCP را تشکیل می‌دهد.
.PP
هنگامی که چندین آرگومان
.I archive
ارائه شوند، تمامی آرشیوهای PCP متناظر بررسی خواهند شد؛ با این حال اگر شناسه‌های
.I archive
نام فایل باشند، هر آرشیو PCP مرتبط حداکثر یک بار بررسی می‌شود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود خط فرمان عبارتند از:
.TP 5
\fB\-f\fR, \fB\-\-full\fR
در عملکرد عادی، بیشتر خطاهای رخ‌داده در
.B "گام ۰"
(پایین را ببینید) به اندازه کافی جدی هستند که
.B pmlogcheck
با بروز آن‌ها خارج شود.
گزینه
.I \-f
دستور
.B pmlogcheck
را وادار می‌کند که حتی در صورت یافتن خطاهای جدی، به کار خود ادامه دهد.
.TP 5
\fB\-l\fR, \fB\-\-label\fR
چاپ برچسب آرشیو، که نسخه قالب آرشیو، زمان و تاریخ شروع و پایان (فعلی) آرشیو، و میزبانی را که مقادیر معیارهای کارایی از آن جمع‌آوری شده‌اند، نمایش می‌دهد.
.TP
\fB\-m\fR, \fB\-\-metadataonly\fR
صرف‌نظر کردن از
.B "گام ۳"
(پایین را ببینید) و تنها بررسی متادیتای آرشیو.
این کار می‌تواند در مواردی که نیازی به بررسی داده‌های حجم نیست، به‌ویژه در آرشیوهایی با حجم‌های داده فشرده، بسیار سریع‌تر اجرا شود.
.TP
\fB\-n\fR \fIpmnsfile\fR, \fB\-\-namespace\fR=\fIpmnsfile\fR
بارگذاری یک فضای نام معیارهای کارایی (\c
.BR PMNS (5))
جایگزین از فایل
.IR pmnsfile .
.TP 5
\fB\-R\fR, \fB\-\-auto-repair\fR
تلاش برای تعمیر هرگونه آسیب ساختاری، به‌ویژه هنگامی که فایل‌ها ناقص هستند (معمولاً در اثر کرش سیستم یا کمبود فضای فایل‌سیستم)؛ در این صورت آن‌ها کوتاه (truncate) می‌شوند تا بیشترین میزان اطلاعات کامل ممکن حفظ شود.
کوتاه‌سازی تنها روی فایل‌های غیرفشرده کار می‌کند، بنابراین هر
.I archive
با اجزای فشرده‌شده ابتدا باید با
.BR pmlogdecompress (1)
از حالت فشرده خارج شود.
.RS
.PP
هر گزینه تعمیری مستلزم
.IR \-f
است.
.PP
برخی از مشکلات شناسایی‌شده توسط
.B pmlogcheck
بهترین راهکارشان کوتاه‌سازی فایل نیست (به‌عنوان مثال، استفاده از \c
.BR pmlogrewrite (1)
ممکن است گزینه بهتری باشد)، بنابراین توصیه می‌شود که
.B pmlogcheck
ابتدا بدون
.I \-R
اجرا شود تا دامنه مشکلات مشخص گردد، یا تعمیر به‌صورت تعاملی با
.IR \-r
انجام پذیرد.
.RE
.TP 5
\fB\-r\fR, \fB\-\-repair\fR
عملکرد تعمیری مشابه با
.IR \-R ،
اما گزینه
.I \-r
مستلزم اجرای تعاملی
.B pmlogcheck
است و پیش از کوتاه‌سازی هر فایل، از کاربر اعلان دریافت کرده و پاسخ مثبت می‌خواهد.
.TP
\fB\-S\fR \fIstarttime\fR, \fB\-\-start\fR=\fIstarttime\fR
تعیین
.I starttime
(زمان شروع) پنجره زمانی که معیارها باید در
.B "گام ۳"
(پایین را ببینید) بررسی شوند.
برای شرح کامل نحو
.IR starttime ،
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-T\fR \fIendtime\fR, \fB\-\-finish\fR=\fIendtime\fR
تعیین
.I endtime
(زمان پایان) پنجره زمانی که معیارها باید در
.B "گام ۳"
(پایین را ببینید) بررسی شوند.
برای شرح کامل نحو
.IR endtime ،
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
فعال‌سازی حالت پرگویی (نمایش با جزئیات).
.TP
\fB\-w\fR, \fB\-\-nowrap\fR
جلوگیری از گزارش گردش یا سرریز شمارنده‌ها (counter wraps).
.TP
\fB\-z\fR, \fB\-\-hostzone\fR
استفاده از منطقه زمانی محلی میزبانی که منبع آرشیو معیارهای کارایی است.
حالت پیش‌فرض استفاده از منطقه زمانی میزبان محلی است.
.TP
\fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR
استفاده از
.I timezone
برای تاریخ و زمان.
مقدار
.I timezone
در قالب متغیر محیطی
.B TZ
است که در
.BR environ (7)
شرح داده شده است.
حالت پیش‌فرض استفاده از منطقه زمانی میزبان محلی است.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "نحوه عملکرد (OPERATION)"
بررسی در چندین گام متوالی انجام می‌شود که هر یک برای اعتبارسنجی روابط معنایی پیچیده‌تر بین اطلاعات موجود در یک آرشیو PCP طراحی شده‌اند.
.SS "گام ۰ (Pass 0)"
هر فایل فیزیکی از آرشیو PCP پردازش می‌شود تا اطمینان حاصل شود که رکوردهای برچسب معتبر و سازگار هستند، و هر فایل شامل تعداد صحیحی از رکوردهای فیزیکی با فیلدهای سرایند (header) و پسایند (trailer) درست است.
.PP
هرگونه خطا در این مرحله معمولاً مهلک است.
آرشیو PCP احتمالاً فراتر از امکان تعمیر آسیب دیده است، و هیچ گام دیگری از
.B pmlogcheck
اجرا نخواهد شد.
.SS "گام ۱ (Pass 1)"
یکپارچگی نمایه زمانی را اعتبارسنجی می‌کند، که معمولاً فایل
.IB archive .index\c
\& است.
.PP
از آنجا که نمایه زمانی (از نظر فنی) اختیاری است، خطاهای این مرحله با علامت‌گذاری نمایه به‌عنوان معیوب و نادیده گرفتن آن در ادامه گام‌های
.B pmlogcheck
مدیریت می‌شوند.
.PP
تعمیر دائمی می‌تواند با حذف فایل نمایه زمانی و سپس تهیه یک رونوشت از آرشیو PCP با استفاده از
.BR pmlogrewrite (1)
یا
.BR pmlogextract (1)
حاصل شود.
این کار به‌عنوان یک اثر جانبی، نمایه زمانی جدیدی برای آرشیو رونوشت ایجاد می‌کند.
.SS "گام ۲ (Pass 2)"
یکپارچگی فایل متادیتا را اعتبارسنجی می‌کند، که معمولاً فایل
.IB archive .meta\c
\& است.
.SS "گام ۳ (Pass 3)"
یکپارچگی هر یک از حجم‌های آرشیو PCP را اعتبارسنجی می‌کند، که معمولاً فایل‌های
.IB archive .0\c
،
.IB archive .1\c
و غیره هستند.
.PP
بررسی‌های یکپارچگی اولیه‌ای وجود دارد تا اطمینان حاصل شود که کدگذاری مقادیر برای هر معیار ثابت باقی می‌ماند و مقادیر در تمام مشاهدات موجود در آرشیو خوش‌فرم و معتبر هستند.
.PP
همچنین انتظار می‌رود که برچسب‌های زمانی برای مشاهدات با پیمایش آرشیو، به‌صورت یکنواخت صعودی باشند.
.PP
توجه ویژه‌ای به معیارهای شمارنده معطوف می‌شود (\c
.I type
از
.BR pmLookupDesc (3)
برابر با
.BR PM_SEM_COUNTER )
است که انتظار می‌رود مقادیر یکنواخت صعودی داشته باشند.
اگر مقادیر یکنواخت صعودی نباشند، این امر ممکن است نشان‌دهنده وقوع سرریز یا گردش شمارنده (counter wrap) باشد، یا این‌که وقفه یا بازنشانی در منبع اصلی داده‌های کارایی رخ داده که در آرشیو ثبت نشده است.
.PP
برای هر معیار شمارنده‌ای که تشخیص داده شده در نقطه‌ای از آرشیو دچار سرریز یا گردش شده است،
.B pmlogcheck
خروجی تولید می‌کند که نام معیار (همراه با شناسه‌های نمونه در صورت لزوم)، نوع ذخیره‌سازی داخلی برای معیار، مقدار معیار پیش از گردش شمارنده (همراه با برچسب زمانی متناظر آن)، و مقدار معیار پس از گردش (همچنین همراه با برچسب زمانی) را شرح می‌دهد.
.PP
گزینه
.B \-w
می‌تواند برای جلوگیری از گزارش سرریز یا گردش شمارنده‌ها استفاده شود.
.PP
دستور
.B pmlogcheck
بسته به بازه زمانی که روی آن اجرا می‌شود، دو قالب برچسب زمانی مختلف تولید می‌کند.
برای بازه بزرگ‌تر از ۲۴ ساعت، علاوه بر زمان وقوع گردش شمارنده، تاریخ نیز نمایش داده می‌شود.
اگر محدوده داده‌های تحت بررسی کمتر از ۲۴ ساعت باشد، قالب دقیق‌تری استفاده می‌شود (زمان با دقت میلی‌ثانیه اما بدون تاریخ نمایش داده می‌شود).
.SH "مثال‌ها (EXAMPLES)"
دستورات زیر همگی معادل هستند:
.EX
$ pmlogcheck myarchive
.br
$ pmlogcheck myarchive.0
.br
$ pmlogcheck myarchive.meta
.br
$ pmlogcheck myarchive.0 myarchive.meta
.EE
.PP
اگر دایرکتوری جاری شامل چندین آرشیو PCP باشد، آن‌گاه دستور
.EX
$ pmlogcheck *.meta*
.EE
تمامی آن‌ها را بررسی خواهد کرد، زیرا برای هر آرشیو PCP یک فایل
.B .meta
وجود دارد، اما این فایل ممکن است فشرده شده باشد (از این رو علامت \fB*\fP در انتها قرار دارد).
.SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_VAR_DIR/pmns/*
فایل‌های پیش‌فرض مشخصات PMNS
.TP
.I $PCP_LOG_DIR/pmlogger/<hostname>
دایرکتوری پیش‌فرض برای آرشیوهای PCP حاوی داده‌های کارایی جمع‌آوری‌شده از میزبان
.IR hostname .
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتریک کردن نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی اطلاعات عیب‌یابی تکمیلی را روی
.I stderr
فعال می‌کند تا به تفکیک و دسته‌بندی مشکلات کمک کند، اگرچه اطلاعات گاهی مبهم است و در اصل برای راهنمایی توسعه‌دهندگان به‌جای کاربران نهایی در نظر گرفته شده است.
.I debug
فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از
.BR pmdbg (1)
با گزینه
.B \-l
استفاده کنید تا فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها را به دست آورید.
.PP
گزینه‌های اشکال‌زدایی مخصوص
.B pmlogcheck
عبارتند از:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl0	تخلیه (dump) هر \fBpmResult\fP پردازش‌شده
_
appl1	گزارش در هر بار مشاهده یک جفت معیار-نمونه جدید
_
appl2	گزارش مقادیر شمارنده به‌عنوان بخشی از فرآیند تشخیص گردش/سرریز
_
appl3	گزارش زمان سپری‌شده و زمان پردازنده (CPU) برای هر گام
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmlogdecompress (1),
.BR pmlogdump (1),
.BR pmlogextract (1),
.BR pmlogger (1),
.BR pmlogrewrite (1),
.BR pmlogsummary (1),
.BR PMAPI (3),
.BR pmLookupDesc (3),
.BR PMNS (5),
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ endtime starttime myarchive {from example}
.\" +ok+ sp {from troff .sp}