'\"macro stdmacro
.\"
.\" Copyright (c) 2014,2018-2020 Red Hat.
.\"
.\" 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 PMFIND 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmfind\f1 \- یافتن سرویس‌های PCP در شبکه
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmfind\f1
[\f3\-CqrSV?\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-m\f1 \f2mechanism\f1]
[\f3\-s\f1 \f2service\f1]
[\f3\-t\f1 \f2timeout\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmfind
به دنبال نمونه‌هایی از سرویس‌های مشخص‌شدهٔ PCP که در شبکه اعلان (advertise) شده‌اند می‌گردد و فهرستی از نشانی‌های وب (URL) متناظر با سرویس‌های کشف‌شده را چاپ می‌کند.
این ابزار می‌تواند در ترکیب با
.BR pmfind_check (1)
برای خودکارسازی پایش سامانه‌های گردآورندهٔ (collector) راه دور PCP به کار رود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\f3\-C\f1, \f3\-\-containers\f1
برای هر سرویس
.BR pmcd (1)
کشف‌شده، فرایند کشف کانتینرها را نیز انجام می‌دهد.
.TP
\f3\-m\f1 \f2mechanism\f1, \f3\-\-mechanism\f1=\f2mechanism\f1
این گزینه
.I mechanism
(سازوکار) مورد استفادهٔ
.B pmfind
را هنگام اجرای فرایند کشف سرویس تعیین می‌کند.
به‌طور پیش‌فرض، یا در صورتی که کلیدواژهٔ
.I all
مشخص شود، تمام سازوکارهای موجود (به‌صورت تکرارشونده) استفاده خواهند شد.
برای مشاهدهٔ توضیحات مربوط به هر یک از سازوکارهای کشف موجود، به بخش «سازوکارها (MECHANISMS)» مراجعه کنید.
.TP
\f3\-q\f1, \f3\-\-quiet\f1
این گزینه از نمایش تمام خروجی‌ها در جریان خروجی استاندارد جلوگیری می‌کند.
.TP
\f3\-r\f1, \f3\-\-resolve\f1
درخواست می‌کند که تفکیک نام DNS برای نشانی‌های هر یک از سرویس‌های کشف‌شده انجام شود.
حالت پیش‌فرض، نمایش نشانی‌های شبکه برای سرویس‌های کشف‌شده است.
.TP
\f3\-s\f1 \f2service\f1, \f3\-\-service\f1=\f2service\f1
به‌طور پیش‌فرض
.B pmfind
تمام سرویس‌های پشتیبانی‌شدهٔ PCP را جستجو می‌کند، اما می‌توان با استفاده از گزینهٔ
.B \-s
یک
.I service
خاص PCP را برای کشف مشخص کرد.
سرویس‌های پشتیبانی‌شده عبارتند از
.BR pmcd (1)
و
.BR pmproxy (1).
.TP
\f3\-S\f1, \f3\-\-sources\f1
شناسه‌های منبع (source identifiers) را برای هر سرویس
.BR pmcd (1)
کشف‌شده گزارش می‌دهد.
این شناسه‌ها برای هر میزبان یکتا هستند و با استفاده از برچسب‌های زمینه (اجباری) موجود برای هر گردآورندهٔ PCP ساخته می‌شوند.
از آنجا که فرایند کشف اغلب چندین مسیر را به یک میزبان گردآورنده شناسایی می‌کند، این گزینه بخش مهمی از فرایند استفاده از
.B pmfind
در ترکیب با
.BR pmfind_check (1)
است تا اطمینان حاصل شود که به ازای هر میزبان گردآورندهٔ کشف‌شده تنها یک فرایند
.BR pmie (1)
و/یا
.BR pmlogger (1)
راه‌اندازی می‌شود.
شناسه‌های منبع گزارش‌شده توسط
.B pmfind
همان شناسه‌های منبع گزارش‌شده توسط دستورهای
.BR pminfo (1)
و
.BR pmseries (1)
هستند.
.TP
\f3\-t\f1 \f2seconds\f1, \f3\-\-timeout\f1=\f2seconds\f1
حداکثر مدت زمان بر حسب ثانیه (
.IR seconds )
را تعیین می‌کند که
.B pmfind
پیش از متوقف کردن فرایند کشف سرویس صرف خواهد کرد.
آرگومان
.I time
یک عدد ممیز شناور است که نشان‌دهندهٔ تعداد ثانیه‌ها پیش از اتمام مهلت زمانی (timeout) است.
حالت پیش‌فرض، صرف هر مقدار زمانی است که برای تکمیل فرایند نیاز باشد.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "سازوکارها (MECHANISMS)"
سازوکارهای پشتیبانی‌شده برای کشف سرویس عبارتند از:
.TP
.B probe=<net-address>/<mask-bits>
زیرشبکهٔ (subnet) داده‌شده را به‌طور فعال برای سرویس(های) درخواستی PCP کاوش (probe) می‌کند.
.B <net-address>
یک نشانی شبکه از نوع Inet یا IPv6 است و
.B <mask-bits>
تعداد بیت‌های استفاده‌شده برای تعریف زیرشبکه است.
به‌عنوان مثال، 192.168.1.0/24 یک زیرشبکهٔ ۸ بیتی شامل نشانی‌های 192.168.1.0 تا 192.168.1.255 را تعریف می‌کند.
یک پسوند اختیاری \fB",maxThreads=N"\fP می‌تواند برای محدود کردن تعداد نخ‌های (threads) استفاده‌شده هنگام کاوش اضافه شود.
مقدار پیش‌فرض، مقدار FD_SETSIZE (که معمولاً 1024 است) یا تعداد نشانی‌های موجود در زیرشبکه است، هر کدام که کمتر باشد.
یک پسوند اختیاری \fB",timeout=N"\fP می‌تواند برای محدود کردن مدت زمان انتظار برای هر تلاش اتصال اضافه شود.
N یک عدد ممیز شناور است که تعداد ثانیه‌ها برای انتظار را مشخص می‌کند.
مقدار پیش‌فرض 0.02 ثانیه (20 میلی‌ثانیه) است.
.TP
.B shell
فهرست نشانی‌های ارائه‌شده توسط اسکریپت‌ها را برای سرویس(های) درخواستی PCP کاوش می‌کند.
همچنین چندین پارامتر اختیاری که با کاما از هم جدا می‌شوند را می‌توان مشخص کرد.
گزینهٔ \fB"path=DIR"\fP دایرکتوری‌ای را که دستورهایی مانند
.BR pcp-kube-pods (1)
در آن قرار دارند مشخص می‌کند (پیش‌فرض به
.IR "$PCP_BINADM_DIR/discover/"
است).
این تنظیم را می‌توان با استفاده از گزینهٔ \fBcommand=CMD\fP به یک دستور مشخص نیز محدود کرد، اما حالت پیش‌فرض استفاده از تمام دستورهای موجود در
\fBpath\fP
است.
گزینهٔ \fB"maxThreads=N"\fP تعداد نخ‌های استفاده‌شده هنگام کاوش را محدود می‌کند.
مقدار پیش‌فرض، مقدار FD_SETSIZE (که معمولاً 1024 است) یا تعداد نشانی‌های بازگردانده‌شده توسط اسکریپت‌ها است، هر کدام که کمتر باشد.
گزینهٔ \fB"timeout=N"\fP می‌تواند برای محدود کردن مدت زمان انتظار برای هر تلاش اتصال اضافه شود.
N یک عدد ممیز شناور است که تعداد ثانیه‌ها برای انتظار را مشخص می‌کند.
مقدار پیش‌فرض 0.02 ثانیه (20 میلی‌ثانیه) است.
.SH "سیگنال‌ها (SIGNALS)"
دستور
.B pmfind
هنگام دریافت یکی از سیگنال‌های زیر، فرایند کشف سرویس را متوقف خواهد کرد:
SIGHUP، SIGPIPE، SIGINT، SIGTERM، SIGXFSZ، SIGXCPU.
ابزار
.B pmfind
هرگونه نتیجه‌ای را که تا زمان توقف کشف شده باشد گزارش خواهد کرد.
.SH "خطاها (DIAGNOSTICS)"
مقدار وضعیت خروج این دستور در صورتی که سرویس‌ها با موفقیت پیدا شوند صفر، اگر هیچ سرویسی یافت نشود یک، و در صورت بروز خطا دو است.
.PP
در صورت بروز خطا، پیامی در خروجی خطای استاندارد (standard error) تولید می‌شود که خودتوضیح خواهد بود.
.SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_BINADM_DIR/discover
مسیر پیش‌فرض برای اسکریپت‌های کشف نشانی
.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 pmfind_check (1)،
.BR pmie (1)،
.BR pminfo (1)،
.BR pmlogger (1)،
.BR pmproxy (1)،
.BR pmseries (1)،
.BR pcp-kube-pods (1)،
.BR PMAPI (3)،
.BR PMWEBAPI (3)،
.BR pmDiscoverServices (3)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ CMD DIR FD_SETSIZE Inet maxThreads