'\"macro stdmacro
.\"
.\" Copyright (c) 2001 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 CHKHELP 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
chkhelp \- بررسی فایل‌های متنی راهنمای معیارهای کارایی
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_BINADM_DIR/chkhelp\f1
[\f3\-eHiOp?\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-n\f1 \f2pmnsfile\f1]
\f2helpfile\f1
[\f2metricname\f1 ...]
.SH "توضیحات (DESCRIPTION)"
دستور
.B chkhelp
سازگاری فایل‌های متن راهنمای
Performance Co-Pilot
را که توسط
.BR newhelp (1)
تولید شده و توسط عامل‌های دامنه معیار کارایی (PMDAها) استفاده می‌شوند، بررسی می‌کند.
این بررسی شامل پیمایش فایل‌ها و در صورت تمایل، نمایش مدخل‌های انتخاب‌شده است.
.PP
فایل‌های
\f2helpfile\f3.dir\f1
و
\f2helpfile\f3.pag\f1
توسط
.BR newhelp (1)
ایجاد می‌شوند و فرض بر این است که از قبل وجود دارند.
.PP
بدون هیچ گزینه یا آرگومان‌های
.IR metricname ،
دستور
.B chkhelp
یکپارچگی ساختاری فایل‌های راهنما را بدون تولید خروجی اعتبارسنجی می‌کند.
.PP
اگر هرگونه آرگومان
.I metricname
مشخص شده باشد، تنها مدخل‌های راهنمای مربوط به همان معیارها پردازش خواهند شد.
.PP
اگر هیچ آرگومان
.IR metricname ی
تعیین نشده باشد، باید حداقل یکی از گزینه‌های
.B \-i
یا
.B \-p
داده شود.
گزینهٔ
.B \-i
باعث پردازش مدخل‌های تمام دامنه‌های نمونه (instance domains) می‌شود (با نادیده گرفتن مدخل‌های معیارهای کارایی).
گزینهٔ
.B \-p
باعث نمایش مدخل‌های تمام معیارها می‌شود (با نادیده گرفتن مدخل‌های دامنه‌های نمونه).
.PP
هنگامی که مدخل‌های معیارها باید پردازش شوند (از طریق آرگومان‌های
.I metricname
یا گزینهٔ
.B \-p
یا گزینهٔ
.BR \-i )،
گزینه‌های
.B \-O
و
.B \-H
به ترتیب درخواست نمایش متن راهنمای تک‌خطی و مفصل را می‌دهند.
حالت پیش‌فرض
.BR \-O
است.
.PP
به‌طور معمول
.B chkhelp
بر روی فضای نام پیش‌فرض معیارهای کارایی (PMNS) عمل می‌کند؛ با این حال اگر گزینهٔ
.B \-n
مشخص شده باشد، یک فضای نام جایگزین از فایل
.I pmnsfile
بارگذاری می‌شود.
.PP
گزینهٔ
.B \-e
یک بررسی وجود را انجام می‌دهد که در آن تمام معیارهای تعیین‌شده از PMNS (توجه کنید، نه از
.IR helpfile )
پیمایش شده، و فقط نام معیارهایی که
.B هیچ
متن راهنمایی برای آن‌ها وجود ندارد گزارش می‌شود.
گزینهٔ
.B \-e
با گزینه‌های
.B \-i
و/یا
.B \-p
مانعة‌الجمع است.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-e\fR
گزارش معیارهایی که فاقد متن راهنما هستند.
.TP
\fB\-H\fR
نمایش متن راهنمای مفصل و خروج.
.TP
\fB\-i\fR
پردازش تمام دامنه‌های نمونه (instance domains).
.TP
\fB\-n\fR \fIpmnsfile\fR
بارگذاری یک فضای نام جایگزین معیارهای کارایی
.RB ( PMNS (5))
از فایل
.IR pmnsfile .
.TP
\fB\-O\fR
نمایش خلاصه راهنمای تک‌خطی.
.TP
\fB\-p\fR
پردازش تمام معیارها (PMIDها).
.TP
\fB\-?\fR
نمایش پیام نحوهٔ استفاده و خروج.
.SH "خطاها (DIAGNOSTICS)"
دلایل گوناگونی وجود دارد که ممکن است یک پایگاه دادهٔ راهنما ناسازگار باشد؛ محتمل‌ترین دلیل این است که یک معیار کارایی در پایگاه داده، در PMNS بارگذاری‌شده تعریف نشده است.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای تعیین پارامترهای نام فایل‌ها و دایرکتوری‌های استفاده‌شده توسط PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP ممکن است برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.PP
برای متغیرهای محیطی مؤثر بر ابزارهای PCP، به \fBpmGetOptions\fP(3) مراجعه کنید.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینهٔ
.B \-D
یا
.B \-\-debug
خروجی پیام‌های تشخیصی بیشتر را در
.I stderr
فعال می‌کند تا به ریشه‌یابی و بررسی مشکلات کمک کند، اگرچه این اطلاعات گاهی پیچیده بوده و اساساً به منظور راهنمایی برای توسعه‌دهندگان طراحی شده است تا کاربران نهایی.
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینهٔ
.B \-l
برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR newhelp (1),
.BR PMAPI (3),
.BR pmLookupInDomText (3),
.BR pmLookupText (3),
.BR pcp.conf (5),
.BR pcp.env (5)
و
.BR PMNS (5).

.\" control lines for scripts/man-spell
.\" +ok+ dir pag