نام (NAME)

runaspcp - اجرای یک دستور شل در قالب کاربر «pcp»

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

$PCP_BINADM_DIR/runaspcp [-D debug] [-s shell] command

توضیحات (DESCRIPTION)

برنامهٔ runaspcp تک‌آرگومان command را در قالب کاربر $PCP_USER و گروه $PCP_GROUP (که هر دو از /etc/pcp.conf خوانده می‌شوند) اجرا می‌کند.

دستور command به‌طور پیش‌فرض توسط sh(1) اجرا می‌شود، در غیر این صورت توسط shell مشخص‌شده در آرگومان خط فرمان -s (یا --shell) اجرا خواهد شد.

به‌طور معمول، runaspcp از اسکریپت‌های «init» در PCP فراخوانی می‌شود؛ اسکریپت‌هایی که با دسترسی مدیر سیستم («root») آغاز می‌شوند اما هنگام اجرای برخی دیمن‌های PCP نیاز دارند تا سطح اختیارات خود را به کاربر «pcp» تقلیل دهند.

گزینهٔ -? و --help پیام راهنمای استفاده از دستور را نمایش می‌دهد.

خطاها (DIAGNOSTICS)

اگر runaspcp نتواند کاربر یا گروه را تغییر دهد، یا نتواند شل را اجرا کند، وضعیت خروج برابر با ۱ خواهد بود؛ در غیر این صورت، وضعیت خروج برابر با وضعیت خروج command خواهد بود.

محیط PCP (PCP ENVIRONMENT)

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

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

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

گزینه‌های اشکال‌زدایی مختص به runaspcp به شرح زیر هستند: