نام (NAME)

pmnsdel - حذف یک زیردرخت از نام‌ها از PMNS در Performance Co-Pilot

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

$PCP_BINADM_DIR/pmnsdel [-?] [-D debug] [-n namespace] metricpath [...]

توضیحات (DESCRIPTION)

دستور pmnsdel زیردرخت‌هایی از نام‌ها را از یک «فضای نام معیارهای کارایی» (PMNS) که توسط مؤلفه‌های Performance Co-Pilot (PCP) استفاده می‌شود، حذف می‌کند.

در حالت عادی، pmnsdel بر روی فضای نام پیش‌فرض معیارهای کارایی (PMNS) عمل می‌کند؛ با این حال اگر گزینهٔ -n مشخص شده باشد، یک فضای نام جایگزین از فایل namespace استفاده می‌شود.

فضای نام پیش‌فرض PMNS در فایل $PCP_VAR_DIR/pmns/root قرار دارد، مگر اینکه متغیر محیطی PMNS_DEFAULT تنظیم شده باشد؛ در این حالت، مقدار آن به عنوان مسیر فایلی در نظر گرفته می‌شود که حاوی PMNS پیش‌فرض است.

نام‌های معیاری که قرار است حذف شوند، تمام مواردی هستند که یکی از آرگومان‌های metricpath یک پیشوند برای آن‌ها در PMNS باشد؛ به PMNS(5) مراجعه کنید.

تمام فایل‌های تعریف‌کنندهٔ PMNS باید درون دایرکتوری حاوی ریشهٔ PMNS قرار داشته باشند، که برای PMNS پیش‌فرض معمولاً $PCP_VAR_DIR/pmns است؛ این موضوع معمولاً مستلزم اجرای pmnsdel با دسترسی ریشه (root) است.

به شرط برآورده شدن برخی بررسی‌های اولیهٔ صحت و یکپارچگی، pmnsdel فایل‌های ضروری PMNS را به‌روزرسانی می‌کند. در صورت بروز هرگونه خطا، فضای نام اولیه بازیابی خواهد شد. توجه داشته باشید هر فایل PMNS که دیگر توسط فضای نام تغییریافته ارجاع داده نشود، حذف نخواهد شد، حتی اگر محتویات آن بخشی از فضای نام جدید نباشد.

گزینه‌ها (OPTIONS)

گزینه‌های خط فرمان موجود عبارتند از:

-n pmnsfile, --namespace=pmnsfile

بارگذاری یک فضای نام معیارهای کارایی جایگزین (PMNS(5)) از فایل pmnsfile.

-?, --help

نمایش پیام راهنمای نحوهٔ استفاده و خروج.

هشدارها (CAVEATS)

پس از آغاز نوشتن فایل جدید namespace، سیگنال‌های SIGINT ،SIGHUP و SIGTERM به منظور حفظ یکپارچگی فایل‌های جدید نادیده گرفته خواهند شد.

فایل‌ها (FILES)

$PCP_VAR_DIR/pmns/root

فضای نام پیش‌فرض PMNS، در صورتی که متغیر محیطی PMNS_DEFAULT تنظیم نشده باشد.

محیط PCP (PCP ENVIRONMENT)

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

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

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

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

pmnsadd(1)، pmnsmerge(1)، pcp.conf(5)، pcp.env(5) و PMNS(5).