نام (NAME)

pmcd_wait - انتظار برای پذیرش اتصالات کلاینت توسط PMCD

خلاصه دستور (SYNOPSIS)

$PCP_BINADM_DIR/pmcd_wait [-v?] [-D debug] [-h host] [-t timeout]

توضیحات (DESCRIPTION)

دستور pmcd_wait منتظر می‌ماند تا دیمن جمع‌آوری معیارهای کارایی (PMCD) اجرا شده و اتصالات کلاینت را بپذیرد.

مگر اینکه با گزینهٔ -h به میزبان دیگری هدایت شود، pmcd_wait تلاش خواهد کرد تا با pmcd(1) روی میزبان محلی ارتباط برقرار کند.

دستور pmcd_wait پس از ۶۰ ثانیه با اتمام مهلت زمانی (timeout) مواجه شده و تلاش برای اتصال به pmcd را متوقف می‌کند. این فاصلهٔ زمانی پیش‌فرض با استفاده از گزینهٔ -t قابل تغییر است، که در آن آرگومان interval از ساختار نحو شرح داده شده در PCPIntro(1) پیروی می‌کند و در ساده‌ترین شکل می‌تواند یک عدد صحیح بدون علامت باشد (واحد ضمنی در این حالت ثانیه است).

در صورت برقراری موفقیت‌آمیز اتصال با pmcd کد وضعیت خروج صفر برگردانده می‌شود.

اگر خطایی رخ دهد یا مهلت زمانی تمام شود، یک کد وضعیت خروج غیرصفر مطابق با آنچه در ادامه شرح داده شده است، برگردانده خواهد شد.

گزینه‌ها (OPTIONS)

گزینه‌های خط فرمان موجود عبارتند از:

-h host, --host=host

اتصال به pmcd(1) روی host، به‌جای مقدار پیش‌فرض localhost.

-t timeout, --interval=timeout

در صورت عدم برقراری اتصال، پس از timeout ثانیه مهلت زمانی به پایان می‌رسد. مقدار پیش‌فرض مهلت زمانی ۶۰ ثانیه است.

-v, --verbose

این گزینه حالت پرگو (verbose) را فعال می‌کند. با غیرفعال بودن این حالت (که حالت پیش‌فرض است)، هیچ خروجی تولید نخواهد شد. با فعال بودن حالت پرگو، پیام‌های خطا در stderr نوشته می‌شوند.

-?, --help

نمایش پیام راهنما و خروج.

خطاها (DIAGNOSTICS)

پیام‌های خطا تنها در صورت فعال بودن حالت پرگو (verbose) در stderr چاپ خواهند شد.

کدهای وضعیت خروج زیر برگردانده می‌شوند:

0

دستور pmcd_wait توانست در محدودهٔ مهلت زمانی با موفقیت به pmcd متصل شود.

1

خطایی در نحوهٔ استفاده رخ داده است؛ برای جزئیات بیشتر از -v استفاده کنید.

2

هیچ اتصالی در بازهٔ مهلت زمانی برقرار نشد. این اتفاق در صورتی رخ می‌دهد که pmcd در حال اجرا باشد اما برقراری اتصال کلاینت بیش از حد طول بکشد، یا اگر pmcd در حال اجرا نباشد و تمام تلاش‌های اتصال در این بازه با خطای ECONNREFUSED ناموفق شوند.

3

یک خطای UNIX رخ داده است؛ برای جزئیات بیشتر از -v استفاده کنید.

4

یک خطای PCP رخ داده است؛ برای جزئیات بیشتر از -v استفاده کنید.

محیط PCP (PCP ENVIRONMENT)

متغیرهای محیطی با پیشوند PCP_ برای مقداردهی و مشخص کردن نام فایل‌ها و دایرکتوری‌های مورد استفادهٔ PCP به کار می‌روند. در هر بار نصب، فایل /etc/pcp.conf شامل مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF ممکن است برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است.

گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)

گزینهٔ -D یا --debug خروجی عیب‌یابی‌های اضافی را در stderr برای کمک به دسته‌بندی و رفع مشکلات فعال می‌کند، اگرچه این اطلاعات گاهی مبهم بوده و در درجهٔ اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی. debug فهرستی از گزینه‌های اشکال‌زدایی جدا شده با کاما است؛ از pmdbg(1) همراه با گزینهٔ -l برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.

همچنین ببینید (SEE ALSO)

PCPIntro(1)، pmcd(1)، pcp.conf(5) و pcp.env(5).