'\"macro stdmacro
.\"
.\" Copyright (c) 2016 Red Hat.
.\" Copyright (c) 2009 Aconex.  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 PMSIGNAL 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmsignal\f1 \- ارسال سیگنال به یک یا چند فرآیند
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_BINADM_DIR/pmsignal\f1
[\f3\-alnp\f1]
[\f3\-s\f1 \fIsignal\fR]
[\f2PID\f1 ...|\f2name\f1 ...]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmsignal
یک سازوکار سیگنال‌دهی چندسکویی رویدادها را برای استفاده به همراه ابزارهای جعبه‌ابزار Performance Co-Pilot فراهم می‌کند.
می‌توان از آن برای ارسال یک
.I signal
نام‌گذاری‌شده (تنها سیگنال‌های HUP، USR1، TERM و KILL پذیرفته می‌شوند)
به یک یا چند فرآیند استفاده کرد.
.PP
فرآیندها به‌طور مستقیم با استفاده از PIDها یا به عنوان نام برنامه‌ها (با استفاده از هر یک از گزینه‌های
.B \-a
یا
.BR \-p )
مشخص می‌شوند.
در حالت
.BR all ،
مجموعه تمام فرآیندهای در حال اجرا برای تطابق
.BR basename (1)
با
.IR name
جستجو می‌شود.
در حالت
.BR program ،
شناسه‌های فرآیند از فایل‌های موجود در دایرکتوری $PCP_RUN_DIR که نام فایل‌های آن‌ها با \f2name\f1.pid مطابقت دارد، استخراج می‌شوند.
.PP
گزینهٔ
.B \-n
فهرست شناسه‌های فرآیندی را که قرار بوده به آن‌ها سیگنال داده شود گزارش می‌کند، اما در عمل هیچ سیگنالی ارسال نمی‌شود.
.PP
اگر هیچ
.IR signal ی
مشخص نشود، سیگنال TERM ارسال خواهد شد.
فهرست سیگنال‌های پشتیبانی‌شده هنگام استفاده از گزینهٔ
.B \-l
گزارش می‌شود.
.PP
در پلتفرم‌های لینوکس و یونیکس،
.I pmsignal
یک پوشش ساده پیرامون دستور
.IR kill (1)
است.
در ویندوز، هیچ معادل مستقیمی برای این سازوکار وجود ندارد و از این رو یک سازوکار جایگزین پیاده‌سازی شده است \- هرچند این سازوکار تنها توسط ابزارهای PCP به رسمیت شناخته می‌شود، نه تمامی ابزارهای ویندوز.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان در دسترس عبارتند از:
.TP 5
\fB\-a\fR, \fB\-\-all\fR
ارسال سیگنال به تمام فرآیندهای نام‌برده‌شده.
.TP
\fB\-l\fR, \fB\-\-list\fR
فهرست کردن سیگنال‌های پشتیبانی‌شده.
.TP
\fB\-n\fR, \fB\-\-dry\-run\fR
فهرست کردن فرآیندهایی که تحت تأثیر قرار خواهند گرفت.
.TP
\fB\-p\fR, \fB\-\-program\fR
استخراج برنامه‌ها از فایل‌های PID زمان اجرای PCP.
.TP
\fB\-s\fR \fIsignal\fR, \fB\-\-signal\fR=\fIsignal\fR
مشخص کردن سیگنال ارسالی، یکی از: HUP، USR1، TERM، KILL.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفادهٔ PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP ممکن است برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR basename (1),
.BR kill (1),
.BR killall (1),
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ HUP USR