'\"macro stdmacro
.\"
.\" Copyright (c) 2000-2004 Silicon Graphics, Inc.  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 PMNSDEL 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmnsdel\f1 \- حذف یک زیردرخت از نام‌ها از PMNS در Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
.B $PCP_BINADM_DIR/pmnsdel
[\f3\-?\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-n\f1 \f2namespace\f1]
.I metricpath
[...]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmnsdel
زیردرخت‌هایی از نام‌ها را از یک «فضای نام معیارهای کارایی» (PMNS) که توسط مؤلفه‌های
Performance Co-Pilot (PCP)
استفاده می‌شود، حذف می‌کند.
.P
در حالت عادی،
.B pmnsdel
بر روی فضای نام پیش‌فرض معیارهای کارایی (PMNS) عمل می‌کند؛ با این حال اگر گزینهٔ
.B \-n
مشخص شده باشد، یک فضای نام جایگزین از فایل
.I namespace
استفاده می‌شود.
.PP
فضای نام پیش‌فرض PMNS در فایل
.I $PCP_VAR_DIR/pmns/root
قرار دارد، مگر اینکه متغیر محیطی
.B PMNS_DEFAULT
تنظیم شده باشد؛ در این حالت، مقدار آن به عنوان مسیر فایلی در نظر گرفته می‌شود که حاوی PMNS پیش‌فرض است.
.PP
نام‌های معیاری که قرار است حذف شوند، تمام مواردی هستند که یکی از آرگومان‌های
.IR metricpath
یک پیشوند برای آن‌ها در PMNS باشد؛ به
.BR PMNS (5)
مراجعه کنید.
.PP
تمام فایل‌های تعریف‌کنندهٔ PMNS باید درون دایرکتوری حاوی ریشهٔ PMNS قرار داشته باشند، که برای PMNS پیش‌فرض معمولاً
.B $PCP_VAR_DIR/pmns
است؛ این موضوع معمولاً مستلزم اجرای
.B pmnsdel
با دسترسی ریشه (root) است.
.PP
به شرط برآورده شدن برخی بررسی‌های اولیهٔ صحت و یکپارچگی،
.B pmnsdel
فایل‌های ضروری PMNS را به‌روزرسانی می‌کند.
در صورت بروز هرگونه خطا، فضای نام اولیه بازیابی خواهد شد.
توجه داشته باشید هر فایل PMNS که دیگر توسط فضای نام تغییریافته ارجاع داده نشود، حذف نخواهد شد، حتی اگر محتویات آن بخشی از فضای نام جدید نباشد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-n\fR \fIpmnsfile\fR, \fB\-\-namespace\fR=\fIpmnsfile\fR
بارگذاری یک فضای نام معیارهای کارایی جایگزین
.RB ( PMNS (5))
از فایل
.IR pmnsfile .
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنمای نحوهٔ استفاده و خروج.
.SH "هشدارها (CAVEATS)"
پس از آغاز نوشتن فایل جدید
.IR namespace ،
سیگنال‌های SIGINT ،SIGHUP و SIGTERM به منظور حفظ یکپارچگی فایل‌های جدید نادیده گرفته خواهند شد.
.SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_VAR_DIR/pmns/root
فضای نام پیش‌فرض PMNS، در صورتی که متغیر محیطی
.B PMNS_DEFAULT
تنظیم نشده باشد.
.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
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و مفاهیم آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR pmnsadd (1)،
.BR pmnsmerge (1)،
.BR pcp.conf (5)،
.BR pcp.env (5)
و
.BR PMNS (5).