'\" t
.\"
.\" Copyright (c) 2012 Red Hat.
.\" Copyright (c) 2000-2004 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 PMDASHPING 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdashping \- عامل دامنه معیارهای کارایی «shell-ping»
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/shping/pmdashping\f1
[\f3\-C\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-I\f1 \f2interval\f1]
[\f3\-t\f1 \f2timeout\f1]
[\f3\-U\f1 \f2username\f1]
\f2configfile\f1
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmdashping
یک «عامل دامنه معیارهای کارایی» (PMDA) است که اندازه‌گیری‌های مربوط به کیفیت سرویس و زمان پاسخ‌دهی را برای دستورهای دلخواهی که ممکن است از طریق پوسته‌ای مانند
.BR sh (1)
اجرا شوند، صادر می‌کند.
.PP
این اندازه‌گیری‌ها به منظور تعیین کمّی کیفیت و در دسترس بودن سرویس‌هایی طراحی شده‌اند که یا دارای اهمیت حیاتی هستند و یا به عنوان شاخص‌های زودهنگام افت کارایی سیستم عمل می‌کنند.
.PP
پیکربندی نمونه، این موارد را نظارت می‌کند:
دستورهای ساده پوسته (\c
.B exit
و
.BR date (1))،
یک وظیفه محاسباتی سنگین و کوتاه با استفاده از
.BR sum (1)،
یک کامپایل کوتاه C،
پرس‌وجوی DNS از طریق
.BR nslookup (1)،
پرس‌وجوی YP از طریق
.BR ypcat (1)،
سرویس bind/portmapper با استفاده از
.BR rpcbind (1)،
سرویس SMTP از طریق اتصال به پورت 25 تلنت و ارسال درخواست «expn root»،
و
سرویس NNTP از طریق اتصال به پورت 119 تلنت و اجرای دستور «listgroup».
.PP
انتظار می‌رود سایر دستورها از نمونه‌های موجود در فایل پیکربندی نمونه الگوبرداری کنند و بیشتر پیاده‌سازی‌های PMDA برنامه
.B pmdashping
از یک فایل پیکربندی سفارشی استفاده نمایند.
.PP
در ادامه شرح مختصری از گزینه‌های خط فرمان
.B pmdashping
آمده است:
.TP 5
.B \-C
تجزیه و اعتبارسنجی
.IR configfile ،
گزارش هرگونه خطا و خروج با وضعیتی غیرصفر در صورت وجود خطاهای نحوی در فایل.
.TP 5
.B \-d
بسیار حیاتی است که شماره
.I domain
(دامنه) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد.
به این معنی که
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA روی تمام میزبان‌ها به کار رود.
.TP 5
.B \-l
محل فایل لاگ. به طور پیش‌فرض، زمانی که
.B pmdashping
آغاز به کار می‌کند، فایلی به نام
.I shping.log
در دایرکتوری جاری
.BR pmcd (1)
(یعنی
.BR $PCP_LOG_DIR/pmcd )
نوشته می‌شود. اگر فایل لاگ قابل ایجاد نباشد یا امکان نوشتن در آن وجود نداشته باشد، خروجی به جای آن در خطای استاندارد نوشته می‌شود.
.TP 5
.B \-I
میزان زمان (به ثانیه) بین اجراهای متوالی فهرست دستورهای ارائه‌شده از طریق فایل پیکربندی
.IR configfile .
مقدار پیش‌فرض ۲ دقیقه است.
.TP 5
.B \-t
میزان زمان (به ثانیه) برای انتظار پیش از سرآمدن زمان (timeout) هنگام دریافت پاسخ برای یک دستور از
.IR configfile .
مقدار پیش‌فرض ۲۰ ثانیه است.
.TP 5
.B \-U
حساب کاربری که عامل و تمامی دستورها تحت آن اجرا می‌شوند.
پیش‌فرض در نسخه‌های فعلی PCP حساب غیرممتاز "pcp" است، اما در نسخه‌های قدیمی‌تر حساب کاربری ریشه ("root") به طور پیش‌فرض استفاده می‌شد.
.PP
فایل الزامی
.IR configfile
جفت‌های «tag» (برچسب) و «command» (دستور) را مشخص می‌کند که هر کدام در یک خط جداگانه قرار دارند.
تمام دستورها یکی پس از دیگری اجرا می‌شوند و کل مجموعه مجدداً برنامه‌ریزی می‌شود تا یک بار در هر
.IR interval
اجرا گردد.
به ازای هر دستوری که اجرا می‌شود،
.B pmdashping
اطلاعات مربوط به موفقیت (یا timeout)، وضعیت خروج، زمان سپری‌شده و زمان CPU (سیستمی و کاربری) را ثبت می‌کند و این اطلاعات توسط PMDA صادر می‌شود.
برچسب‌ها برای شناسایی دستورهای منفرد در میان مقادیر صادرشده توسط PMDA استفاده می‌شوند و شناسه‌های دامنه نمونه خارجی را برای معیارهای
.B pmdashping
که به هر دستور مربوط می‌شوند، تشکیل می‌دهند.
.SH "نصب (INSTALLATION)"
برای اینکه یک میزبان بتواند نام‌ها، متن راهنما و مقادیر معیارهای کارایی shping را صادر کند، دستورهای زیر را با دسترسی root انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/shping
# ./Install
.in
.fi
.ft 1
.PP
مجموعه جفت‌های «tag» و «command» را می‌توان از یک فایل پیکربندی پیش‌فرض (نمونه)، یک فایل سفارشی مشخص کرد یا به‌صورت تعاملی به عنوان بخشی از اسکریپت
.B Install
وارد نمود.
.PP
اگر می‌خواهید نصب را لغو کنید، دستورهای زیر را با دسترسی root انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/shping
# ./Remove
.in
.fi
.ft 1
.PP
دستور
.B pmdashping
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به طور مستقیم اجرا شود.
اسکریپت‌های Install و Remove هنگام نصب یا حذف عامل، به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان استفاده‌شده برای راه‌اندازی
.B pmdashping
.TP 10
.B $PCP_PMDAS_DIR/shping/help
فایل متن راهنمای پیش‌فرض برای معیارهای shping
.TP 10
.B $PCP_PMDAS_DIR/shping/sample.conf
فایل پیکربندی نمونه شامل تعدادی از دستورهای رایج
.TP 10
.B $PCP_PMDAS_DIR/shping/Install
اسکریپت نصب برای عامل
.B pmdashping
.TP 10
.B $PCP_PMDAS_DIR/shping/Remove
اسکریپت لغو نصب برای
.B pmdashping
.TP 10
.B $PCP_LOG_DIR/pmcd/shping.log
فایل لاگ پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdashping
.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 pmdashping
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl0	مدیریت خروج
_
appl1	تجزیه \fIconfigfile\fP، مهلت‌های زمانی، چرخه تازه‌سازی
_
appl2	T{
الحاق دستورها و آرگومان‌ها به \fIshping.out\fP هم‌زمان با اجرای آن‌ها
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)
و
.BR pcp-shping (1).

.\" control lines for scripts/man-spell
.\" +ok+ NNTP YP expn listgroup portmapper rpcbind ypcat