نام (NAME)

pcp.conf - پرونده پیکربندی و متغیرهای محیطی Performance Co-Pilot

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

/etc/pcp.conf

توضیحات (DESCRIPTION)

هنگام استفاده از ابزارها و برنامه‌های کمکی Performance Co-Pilot (PCP) و هنگام فراخوانی توابع کتابخانه‌ای PCP، مجموعه‌ای استاندارد از متغیرهای محیطی در /etc/pcp.conf تعریف می‌شوند. این متغیرها عموماً برای تعیین مکان اجزای مختلف PCP در سیستم‌فایل به کار می‌روند و می‌توان آن‌ها را با سورس کردن (source) اسکریپت شل /etc/pcp.env(5) در اسکریپت‌های شل بارگذاری کرد و در برنامه‌های C/C++ با استفاده از تابع کتابخانه‌ای pmGetConfig(3) مورد پرس‌وجو قرار داد. اگر متغیری از قبل در محیط تعریف شده باشد، مقادیر موجود در pcp.conf بر آن مقادیر بازنویسی (override) نمی‌شوند، به این معنی که مقادیر pcp.conf تنها به عنوان مقادیر پیش‌فرض هنگام نصب عمل می‌کنند.

به‌طور پیش‌فرض، انتظار می‌رود هر دو پرونده pcp.env و pcp.conf در مسیر /etc یافت شوند. در صورت نیاز، پرونده pcp.conf را می‌توان جابه‌جا کرد و متغیر PCP_CONF را در محیط تنظیم نمود تا مسیر کامل مکان جدید را مشخص کند. پرونده pcp.env را نمی‌توان جابه‌جا کرد (این تنها مسیر هاردکدشده‌ای است که PCP به آن نیاز دارد).

قواعد نحوی pcp.conf به شرح زیر است:

1.

نحو کلی عبارت است از:

PCP_VARIABLE_NAME=variable value to end of line

2.

خطوطی که با # شروع می‌شوند و تمامی خطوط خالی نادیده گرفته می‌شوند.

3.

نام تمامی متغیرها باید با پیشوند PCP_ شروع شود. این یک مسئله امنیتی است - متغیرهایی که این پیشوند را نداشته باشند، بدون هیچ پیامی نادیده گرفته خواهند شد.

4.

نباید هیچ فاصله‌ای بین نام متغیر و نویسه = و همچنین هیچ فاصله‌ای بین = و مقدار متغیر وجود داشته باشد (مگر اینکه مقدار واقعاً با یک فاصله شروع شود). این امر ضروری است زیرا پرونده pcp.conf ممکن است مستقیماً توسط Makefileها سورس شود و همچنین توسط اسکریپت pcp.env و تابع pmGetConfig تفسیر گردد.

5.

مقادیر متغیرها می‌توانند حاوی فاصله باشند و نباید درون نقل‌قول قرار گیرند. اسکریپت pcp.env به‌طور خودکار تمامی مقادیر متغیرها را از نویسه بلافاصله پس از = تا انتهای خط درون نقل‌قول قرار می‌دهد.

برای جزئیات بیشتر و توضیحات مربوط به کاربرد هر متغیر، به یادداشت‌های (کامنت‌های) درون خود پرونده /etc/pcp.conf مراجعه کنید.

محیط (ENVIRONMENT)

متغیر محیطی PCP_CONF یک مسیر جایگزین برای پرونده pcp.conf مشخص می‌کند.

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

PCPIntro(1), pmconfig(1), PCPIntro(3), PMAPI(3), pmGetConfig(3) و pcp.env(5).