'\"macro stdmacro
.\"
.\" 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 PMDASIMPLE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdasimple \- کارگزار سادهٔ دامنه معیارهای کارایی (PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/simple/pmdasimple\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 \f2username\f1]
[\f3\-u\f1 \f2socket\f1]
.SH "توضیحات (DESCRIPTION)"
برنامهٔ
.B pmdasimple
یک کارگزار دامنه معیارهای کارایی (PMDA) ساده است که تعداد اندکی از معیارهای کارایی ساختگی را صادر می‌کند.
.PP
کارگزار PMDA ساده به‌صورت کد منبع عرضه می‌شود و برای کمک به توسعه‌دهندگان PMDA طراحی شده است. از نظر حجم کد و قابلیت‌ها، از trivial PMDA پیچیده‌تر، تقریباً هم‌اندازهٔ txmon PMDA و ساده‌تر از sample PMDA است. کد منبع PMDA ساده یک الگوی مناسب است که می‌توان از روی آن PMDAهای سفارشی و آماده برای محیط عملیاتی را توسعه داد.
.PP
شرح مختصری از گزینه‌های خط فرمان
.B pmdasimple
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شمارهٔ
.I domain
معیارهای کارایی که در اینجا مشخص می‌شود، یکتا و سازگار باشد. بدین معنا که
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و از شمارهٔ
.I domain
یکسانی برای همان PMDA در تمامی میزبان‌ها استفاده شود.
.TP
.B \-i
انتظار دارد که PMCD به
.B pmdasimple
روی درگاه TCP/IP مشخص‌شده متصل شود.
.I port
می‌تواند یک شماره درگاه یا نام درگاه باشد.
.TP
.B \-l
مکان فایل گزارش (log). به‌طور پیش‌فرض، هنگامی که
.B pmdasimple
آغاز به کار می‌کند، فایل گزارشی به نام
.I simple.log
در دایرکتوری جاری
.BR pmcd (1)
نوشته می‌شود؛ یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به‌جای آن در خروجی خطای استاندارد نوشته می‌شود.
.TP
.B \-p
انتظار دارد PMCD یک لوله (pipe) ایجاد کند و اتصال به
.B pmdasimple
از طریق ورودی استاندارد و خروجی استاندارد برقرار شود. این حالت، حالت اتصال پیش‌فرض است.
.TP
.B \-u
انتظار دارد PMCD به
.B pmdasimple
روی سوکت دامنه یونیکس به نام
.IR socket
متصل شود.
.TP 5
.B \-U
حساب کاربری‌ای که کارگزار تحت آن اجرا می‌شود. در نسخه‌های کنونی PCP، پیش‌فرض حساب کاربری بی‌استفاده از امتیازات \(lqpcp\(rq است، اما در نسخه‌های قدیمی‌تر به‌طور پیش‌فرض از حساب کاربری مدیر سیستم (\(lqroot\(rq) استفاده می‌شد.
.PP
حداکثر یکی از گزینه‌های
.BR \-i ،
.B \-p
و
.B \-u
می‌تواند مشخص شود.
.SH "نصب (INSTALLATION)"
اگر می‌خواهید به نام‌ها، متن راهنما و مقادیر معیارهای کارایی simple دسترسی داشته باشید، مراحل زیر را با دسترسی مدیر سیستم (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/simple
# ./Install
.in
.fi
.ft 1
.PP
اگر می‌خواهید نصب را لغو کنید، مراحل زیر را با دسترسی مدیر سیستم انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/simple
# ./Remove
.in
.fi
.ft 1
.PP
برنامهٔ
.B pmdasimple
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا شود. اسکریپت‌های Install و Remove هنگامی که کارگزار نصب یا حذف می‌شود، به
.BR pmcd (1)
اطلاع می‌دهند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdasimple
.TP
.B $PCP_PMDAS_DIR/simple/help
فایل متن راهنمای پیش‌فرض برای معیارهای simple
.TP
.B $PCP_PMDAS_DIR/simple/Install
اسکریپت نصب برای کارگزار
.B pmdasimple
.TP
.B $PCP_PMDAS_DIR/simple/Remove
اسکریپت لغو نصب برای کارگزار
.B pmdasimple
.TP
.B $PCP_PMDAS_DIR/simple/simple.conf
فایل پیکربندی برای دامنه نمونهٔ پویایی که زیربنای معیار کارایی
.B simple.now
است. برای توضیحات، به فایل متن راهنما مراجعه کنید، یا دستور زیر را اجرا نمایید:
.sp 0.5v
.ft CR
$ pminfo \-T simple.now
.ft P
.sp 0.5v
.TP
.B $PCP_PMDAS_DIR/simple/*.pmda_simple.so
نسخهٔ DSO کارگزار PMDA. از همان کد منبع برای ساخت هر دو نسخهٔ DSO و دیمن (daemon) از simple PMDA استفاده می‌شود، و یکی از این دو می‌تواند در جریان گفتگوی تعاملی در اسکریپت
.B Install
نصب شود.
.TP
.B $PCP_LOG_DIR/pmcd/simple.log
فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdasimple
.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
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی در دسترس و معنی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pmdasample (1)،
.BR pmdatrivial (1)،
.BR pmdatxmon (1)،
.BR PMDA (3)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ pmda_simple txmon {from txmon PMDA x-ref}