'\" t
.\"
.\" Copyright (c) 2024 Ken McDonell.  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 RUNASPCP 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
runaspcp \- اجرای یک دستور شل در قالب کاربر «pcp»
.SH "خلاصه دستور (SYNOPSIS)"
.B $PCP_BINADM_DIR/runaspcp
[\f3\-D\f1 \f2debug\f1]
[\f3\-s\f1 \f2shell\f1]
command
.SH "توضیحات (DESCRIPTION)"
برنامهٔ
.B runaspcp
تک‌آرگومان
.I command
را در قالب کاربر
.B $PCP_USER
و گروه
.B $PCP_GROUP
(که هر دو از
.IR /etc/pcp.conf
خوانده می‌شوند) اجرا می‌کند.
.PP
دستور
.I command
به‌طور پیش‌فرض توسط
.BR sh (1)
اجرا می‌شود، در غیر این صورت توسط
.I shell
مشخص‌شده در آرگومان خط فرمان
.B \-s
(یا
.BR \-\-shell )
اجرا خواهد شد.
.PP
به‌طور معمول،
.B runaspcp
از اسکریپت‌های «init» در PCP فراخوانی می‌شود؛ اسکریپت‌هایی که با دسترسی مدیر سیستم («root») آغاز می‌شوند اما هنگام اجرای برخی دیمن‌های PCP نیاز دارند تا سطح اختیارات خود را به کاربر «pcp» تقلیل دهند.
.PP
گزینهٔ \fB\-?\fR و \fB\-\-help\fR
پیام راهنمای استفاده از دستور را نمایش می‌دهد.
.SH "خطاها (DIAGNOSTICS)"
اگر
.B runaspcp
نتواند کاربر یا گروه را تغییر دهد، یا نتواند شل را اجرا کند، وضعیت خروج برابر با ۱ خواهد بود؛ در غیر این صورت، وضعیت خروج برابر با وضعیت خروج
.IR command
خواهد بود.
.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
استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی مختص به
.B runaspcp
به شرح زیر هستند:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
گزینه	توضیحات
_
appl0	پیام‌های تشخیصی با جزئیات کامل
.TE