'\"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 PMDATRIVIAL 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdatrivial\f1 \- عامل دامنه معیارهای کارایی ساده (PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/trivial/pmdatrivial\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-U\f1 \f2username\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmdatrivial
ساده‌ترین عامل دامنه معیارهای کارایی (PMDA) ممکن است که تنها یک معیار کارایی را صادر می‌کند: زمان سپری‌شده بر حسب ثانیه از ۱ ژانویه ۱۹۷۰.
.PP
این PMDA ساده به صورت کد منبع عرضه می‌شود و با هدف کمک به توسعه‌دهندگان PMDA طراحی شده است.
.PP
شرح کوتاهی از گزینه‌های خط فرمان
.B pmdatrivial
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره
.I domain
(دامنه) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد.
به این صورت که
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA روی تمام میزبان‌ها استفاده شود.
.TP
.B \-l
مکان فایل گزارش (لاگ). به صورت پیش‌فرض، هنگامی که
.B pmdatrivial
آغاز می‌شود، یک فایل گزارش با نام
.I trivial.log
در دایرکتوری جاریِ
.BR pmcd (1)
نوشته می‌شود، یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به جای آن در خطای استاندارد نوشته می‌شود.
.TP 5
.B \-U
حساب کاربری که عامل تحت آن اجرا می‌شود.
پیش‌فرض در نسخه‌های کنونی PCP حساب کاربری غیرممتاز «pcp» است، اما در نسخه‌های قدیمی‌تر، حساب مدیر سیستم («root») به طور پیش‌فرض استفاده می‌شد.
.SH "نصب (INSTALLATION)"
اگر خواهان دسترسی به نام‌ها، متن راهنما و مقادیر معیارهای کارایی ساده هستید، دستورات زیر را با دسترسی root انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/trivial
# ./Install
.in
.fi
.ft 1
.PP
اگر می‌خواهید نصب را لغو کنید، دستورات زیر را با دسترسی root انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/trivial
# ./Remove
.in
.fi
.ft 1
.PP
.B pmdatrivial
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به طور مستقیم اجرا شود.
اسکریپت‌های Install و Remove هنگامی که عامل نصب یا حذف می‌شود، به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان استفاده‌شده برای راه‌اندازی
.B pmdatrivial
.TP 10
.B $PCP_PMDAS_DIR/trivial/help
فایل متن راهنمای پیش‌فرض برای معیارهای ساده
.TP 10
.B $PCP_PMDAS_DIR/trivial/Install
اسکریپت نصب برای عامل
.B pmdatrivial
.TP 10
.B $PCP_PMDAS_DIR/trivial/Remove
اسکریپت لغو نصب برای عامل
.B pmdatrivial
.TP 10
.B $PCP_LOG_DIR/pmcd/trivial.log
فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdatrivial
.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 pmdasimple (1),
.BR pmdatxmon (1)
و
.BR PMDA (3).