'\" t
.\"
.\" Copyright (c) 2012 Red Hat.
.\" 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 PMDASAMPLE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdasample\f1 \- عامل نمونه دامنه معیارهای کارایی (PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/pmdasample\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-i\f1 \f2port\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-p\f1]
[\f3\-u\f1 \f2socket\f1]
[\f3\-U\f1 \f2username\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmdasample
یک عامل دامنه معیارهای کارایی (PMDA) نمونه است که مجموعه‌ای متنوع از معیارهای کارایی ساختگی را صادر می‌کند.
.PP
این PMDA به عنوان بخشی از آزمون‌های تضمین کیفیت برای محصول PCP توسعه یافته است، اما کاربردهای دیگری نیز دارد، به ویژه در توسعه کلاینت‌های جدید PCP.
.PP
معیارهای صادرشده توسط PMDA نمونه، طیف کاملی از انواع داده، معناشناسی داده‌ها، چندگانگی مقادیر، پایداری دامنه نمونه و شرایط خطای موجود در PMDAهای واقعی را پوشش می‌دهند.
.PP
شرح مختصری از گزینه‌های خط فرمان
.B pmdasample
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره
.I domain
معیارهای کارایی که در اینجا مشخص می‌شود یکتا و سازگار باشد.
بدین معنا که
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای یک PMDA مشابه روی تمام میزبان‌ها استفاده شود.
.TP
.B \-i
انتظار می‌رود PMCD به
.B pmdasample
روی درگاه TCP/IP مشخص‌شده متصل شود.
.I port
می‌تواند یک شماره درگاه یا نام درگاه باشد.
.TP
.B \-l
محل فایل لاگ. به طور پیش‌فرض، هنگامی که
.B pmdasample
راه‌اندازی می‌شود، یک فایل لاگ به نام
.I sample.log
در دایرکتوری جاری
.BR pmcd (1)
نوشته می‌شود، یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر فایل لاگ نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به جای آن در خطای استاندارد نوشته می‌شود.
.TP
.B \-p
انتظار می‌رود PMCD یک لوله (pipe) ایجاد کند و اتصال به
.B pmdasample
از طریق ورودی استاندارد و خروجی استاندارد باشد. این حالت اتصال پیش‌فرض است.
.TP
.B \-u
انتظار می‌رود PMCD به
.B pmdasample
روی سوکت دامنه یونیکس به نام
.IR socket
متصل شود.
.TP 5
.B \-U
حساب کاربری که عامل تحت آن اجرا می‌شود.
پیش‌فرض در نسخه‌های کنونی PCP حساب کاربری بدون امتیاز \(lqpcp\(rq است، اما در نسخه‌های قدیمی‌تر از حساب کاربری مدیر سیستم (\(lqroot\(rq) به طور پیش‌فرض استفاده می‌شد.
.PP
حداکثر یکی از گزینه‌های
.BR \-i ،
.B \-p
و
.B \-u
می‌تواند مشخص شود.
.SH "نصب (INSTALLATION)"
اگر به نام‌ها، متن راهنما و مقادیر معیارهای کارایی نمونه نیاز دارید، دستورات زیر را با دسترسی ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/sample
# ./Install
.in
.fi
.ft 1
.PP
توجه داشته باشید که اسکریپت نصب نسخه DSO از PMDA نمونه را نیز نصب می‌کند، بنابراین در عمل دو PMDA و دو مجموعه از معیارهای کارایی نصب می‌شوند، یعنی
.B sample.*
و
.BR sampledso.* .
.PP
اگر می‌خواهید نصب را لغو کنید (و هر دو PMDA را حذف نمایید)، دستورات زیر را با دسترسی ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/sample
# ./Remove
.in
.fi
.ft 1
.PP
.B pmdasample
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا شود.
اسکریپت‌های Install و Remove هنگامی که عامل نصب یا حذف می‌شود به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdasample
.TP 10
.B $PCP_PMDAS_DIR/sample/help
فایل متن راهنمای پیش‌فرض برای معیارهای نمونه
.TP 10
.B $PCP_PMDAS_DIR/sample/Install
اسکریپت نصب برای عامل
.B pmdasample
.TP 10
.B $PCP_PMDAS_DIR/sample/Remove
اسکریپت لغو نصب برای عامل
.B pmdasample
.TP 10
.B $PCP_LOG_DIR/pmcd/sample.log
فایل لاگ پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdasample
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتریک کردن نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل
.B /etc/pcp.conf
حاوی مقادیر محلی برای این متغیرها است.
متغیر
.B $PCP_CONF
می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
.BR pcp.conf (5)
شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی‌های اضافی را روی
.I stderr
فعال می‌کند تا به بررسی مشکلات کمک کند، اگرچه اطلاعات گاهی مبهم بوده و عمدتاً برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی.
.I debug
فهرستی از گزینه‌های اشکال‌زدایی جداشده با کاما است؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی ویژه
.B pmdasample
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl0	T{
پیام‌های تشخیصی با جزئیات کامل برای دامنه‌های نمونه پویا و نگاشت معیارها
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pmdasimple (1)،
.BR pmdatrivial (1)،
.BR pmdatxmon (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

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