'\"macro stdmacro
.\"
.\" 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 PMCD_WAIT 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmcd_wait\f1 \- انتظار برای پذیرش اتصالات کلاینت توسط PMCD
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_BINADM_DIR/pmcd_wait\f1
[\f3\-v?\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-h\f1 \f2host\f1]
[\f3\-t\f1 \f2timeout\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmcd_wait
منتظر می‌ماند تا دیمن جمع‌آوری معیارهای کارایی (PMCD) اجرا شده و اتصالات کلاینت را بپذیرد.
.P
مگر اینکه با گزینهٔ
.B \-h
به میزبان دیگری هدایت شود،
.B pmcd_wait
تلاش خواهد کرد تا با
.BR pmcd (1)
روی میزبان محلی ارتباط برقرار کند.
.P
دستور
.B pmcd_wait
پس از ۶۰ ثانیه با اتمام مهلت زمانی (timeout) مواجه شده و تلاش برای اتصال به
.B pmcd
را متوقف می‌کند. این فاصلهٔ زمانی پیش‌فرض با استفاده از گزینهٔ
.B \-t
قابل تغییر است، که در آن آرگومان
.I interval
از ساختار نحو شرح داده شده در
.BR PCPIntro (1)
پیروی می‌کند و در ساده‌ترین شکل می‌تواند یک عدد صحیح بدون علامت باشد (واحد ضمنی در این حالت ثانیه است).
.P
در صورت برقراری موفقیت‌آمیز اتصال با
.B pmcd
کد وضعیت خروج صفر برگردانده می‌شود.
.PP
اگر خطایی رخ دهد یا مهلت زمانی تمام شود، یک کد وضعیت خروج غیرصفر مطابق با آنچه در ادامه شرح داده شده است، برگردانده خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-h\fR \fIhost\fR, \fB\-\-host\fR=\fIhost\fR
اتصال به
.BR pmcd (1)
روی
.IR host ،
به‌جای مقدار پیش‌فرض localhost.
.TP
\fB\-t\fR timeout\fI\fR, \fB\-\-interval\fR=\fItimeout\fR
در صورت عدم برقراری اتصال، پس از \fItimeout\fR ثانیه مهلت زمانی به پایان می‌رسد.
مقدار پیش‌فرض مهلت زمانی ۶۰ ثانیه است.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
این گزینه حالت پرگو (verbose) را فعال می‌کند.
با غیرفعال بودن این حالت
(که حالت پیش‌فرض است)، هیچ خروجی تولید نخواهد شد.
با فعال بودن حالت پرگو، پیام‌های خطا در
.IR stderr
نوشته می‌شوند.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "خطاها (DIAGNOSTICS)"
پیام‌های خطا تنها در صورت فعال بودن حالت پرگو (verbose) در
.I stderr
چاپ خواهند شد.
.P
کدهای وضعیت خروج زیر برگردانده می‌شوند:
.TP
.B 0
دستور
.B pmcd_wait
توانست در محدودهٔ مهلت زمانی با موفقیت به
.B pmcd
متصل شود.
.TP
.B 1
خطایی در نحوهٔ استفاده رخ داده است؛ برای جزئیات بیشتر از
.B \-v
استفاده کنید.
.TP
.B 2
هیچ اتصالی در بازهٔ مهلت زمانی برقرار نشد.
این اتفاق در صورتی رخ می‌دهد که
.B pmcd
در حال اجرا باشد اما برقراری اتصال کلاینت بیش از حد طول بکشد، یا اگر
.B pmcd
در حال اجرا نباشد و تمام تلاش‌های اتصال در این بازه با خطای ECONNREFUSED ناموفق شوند.
.TP
.B 3
یک خطای U\s-2NIX\s+2 رخ داده است؛ برای جزئیات بیشتر از
.B \-v
استفاده کنید.
.TP
.B 4
یک خطای PCP رخ داده است؛ برای جزئیات بیشتر از
.B \-v
استفاده کنید.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای مقداردهی و مشخص کردن نام فایل‌ها و دایرکتوری‌های مورد استفادهٔ PCP به کار می‌روند.
در هر بار نصب، فایل \fI/etc/pcp.conf\fP شامل مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP ممکن است برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(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 pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell