'\" t
.\"
.\" Copyright (c) 2000 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 PMLC 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmlc\f1 \- پیکربندی تعاملی pmloggerهای فعال Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmlc\f1
[\f3\-eiPz?\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-h\f1 \f2host\f1]
[\f3\-n\f1 \f2pmnsfile\f1]
[\f3\-p\f1 \f2port\f1]
[\f3\-Z\f1 \f2timezone\f1]
[\f2pid\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmlc
می‌تواند برای تغییر آن دسته از معیارها و نمونه‌هایی که یک
.BR pmlogger (1)
در یک بایگانی Performance Co-Pilot می‌نویسد (ببینید
.BR PCPIntro (1))،
بسامد جمع‌آوری معیارها، و همچنین اجباری، توصیه‌ای، روشن یا خاموش بودن ثبت گزارش استفاده شود.
این دستور همچنین وضعیت فعلی ثبت گزارش معیارها و نمونه‌ها را گزارش می‌دهد.
.B pmlc
می‌تواند برای کنترل نمونه‌های pmlogger در میزبان‌های دوردست و همچنین در میزبان محلی به کار رود.
.PP
در حالت عادی
.B pmlc
بر روی فضای نام توزیع‌شده معیارهای کارایی (PMNS) عمل می‌کند؛ اما اگر گزینهٔ
.B \-n
مشخص شود، یک PMNS محلی جایگزین از فایل
.IR pmnsfile
بارگذاری می‌شود.
.PP
اگر گزینهٔ
.B \-P
مشخص شود،
.B pmlc
تلاش خواهد کرد تا با اتصال به pmlogger اصلی در میزبان محلی شروع به کار کند.
اگر گزینهٔ
.B \-p
مشخص شود، آنگاه
.B pmlc
تلاش خواهد کرد تا با اتصال به pmlogger در این
.IR port
از نوع TCP/IP شروع به کار کند.
همچنین، اگر
.I pid
مشخص شود، در هنگام راه‌اندازی برای اتصال به نمونهٔ pmlogger با آن شناسهٔ فرایند تلاش خواهد شد.
گزینهٔ
.B \-h
تنها زمانی می‌تواند استفاده شود که
.BR \-P ،
.B \-p
.I port
یا یک
.I pid
نیز مشخص شده باشد.
در آن حالت،
.B pmlc
در ابتدا به جای میزبان محلی، به نمونهٔ pmlogger مشخص‌شده (از راه دور) در
.I host
متصل خواهد شد.
اگر اتصال به نمونهٔ pmlogger مشخص‌شده برقرار نشود،
.B pmlc
بدون هیچ اتصالی شروع به کار خواهد کرد.
این گزینه‌ها معمولاً به شما اجازه می‌دهند تا با تغییر آرگومان‌های خط فرمان، همان فایل حاوی دستورات
.B pmlc
را به چندین نمونهٔ pmlogger هدایت کنید.
توجه داشته باشید که
.BR -P ،
.B \-p
.IR port ،
.IR pid
و
.B \-h
تنها هنگام برقراری اتصال اولیه به یک نمونهٔ pmlogger استفاده می‌شوند.
اگر اتصالات بعدی به صورت تعاملی برقرار شوند، این گزینه‌ها به عنوان پیش‌فرض استفاده نخواهند شد (دستور
.B connect
را در ادامه ببینید).
.PP
به‌طور پیش‌فرض،
.B pmlc
زمان روز را بر اساس منطقه زمانی محلی سیستمی که
.B pmlc
روی آن اجرا می‌شود گزارش می‌کند.
گزینهٔ
.B \-Z
منطقه زمانی را به
.IR timezone
در قالب متغیر محیطی
.B TZ
طبق آنچه در
.BR environ (7)
شرح داده شده است تغییر می‌دهد.
گزینهٔ
.B \-z
منطقه زمانی را به منطقه زمانی نمونهٔ pmlogger که اطلاعات از آن دریافت می‌شود تغییر می‌دهد.
تنها یکی از گزینه‌های
.B \-z
یا
.B \-Z
می‌تواند مشخص شود.
.PP
اگر ورودی استاندارد از یک tty باشد،
.B pmlc
به همراه اعلان‌ها به صورت تعاملی خواهد بود.
پرچم
.B \-i
می‌تواند برای اجبار رفتار تعاملی استفاده شود و معمولاً در ترکیب با
.B \-e
به کار می‌رود تا تمام ورودی‌های دستور را در خروجی استاندارد بازتاب دهد (echo کند)..SH "دستورها (COMMANDS)"
دستورهای زیر را می‌توان استفاده کرد:
.TP 4
\f3show\f1 [ \f3loggers\f1 ] [ \f3@\f2host\f1 ]
شناسه‌های فرایند (PID) تمام نمونه‌های pmlogger در حال اجرا روی میزبان محلی (یا
.IR host ،
در صورت مشخص شدن) را نمایش می‌دهد.
شناسه فرایند pmlogger اصلی (primary) درون پرانتز قرار می‌گیرد، زیرا علاوه بر PID می‌توان با عنوان «primary» نیز به آن ارجاع داد.
.TP 4
\f3connect\f1 \f2pid\f1 [ \f3@\f2host\f1 ]
.br
.in -4
\f3connect\f1 \f3primary\f1 [ \f3@\f2host\f1 ]
.in
ابزار
.B pmlc
را به فرایند pmlogger مشخص‌شده متصل می‌کند.
هرگونه اتصال موجود به یک نمونه pmlogger ابتدا بسته می‌شود.
هر نمونه pmlogger در هر لحظه حداکثر یک اتصال را می‌پذیرد، بنابراین اگر اتصال با موفقیت برقرار شود،
.B pmlc
شما تنها برنامه‌ای خواهد بود که نمونه pmlogger متصل‌شده را کنترل می‌کند.
.TP 4
\f3new volume\f1
این دستور تنها زمانی کار می‌کند که اتصال به یک نمونه pmlogger برقرار باشد.
این دستور به pmlogger اعلام می‌کند که جلد (volume) فعلی بایگانی را ببندد و یک جلد جدید باز کند.
جلدهای بسته‌شده را می‌توان فشرده‌سازی کرد و/یا به یک سیستم دوردست، فضای ذخیره‌سازی از راه دور یا ذخیره‌سازی آفلاین منتقل نمود؛ مثلاً به عنوان بخشی از یک رویه منظم مدیریت بایگانی برای کنترل اندازه فایل‌های فیزیکی بایگانی روی سیستمی که
.B pmlogger
روی آن در حال اجرا است.
.TP 4
\f3status\f1
این دستور تنها زمانی کار می‌کند که اتصال به یک نمونه pmlogger برقرار باشد.
اطلاعاتی را درباره وضعیت نمونه pmlogger و بایگانی مرتبط با آن چاپ می‌کند.
.TP 4
\f3timezone\f1 \f3local\f1 | \f3logger\f1 | \f3"\f2timezone\f3"\f1
این دستور منطقه زمانی مورد استفاده هنگام چاپ زمان‌ها را تعیین می‌کند.
.B local
به معنای استفاده از منطقه زمانی سیستمی است که
.B pmlc
روی آن اجرا می‌شود.
.B logger
به معنای استفاده از منطقه زمانی سیستمی است که نمونه pmlogger روی آن در حال اجرا است.
همچنین می‌توان یک
.I timezone
صریح را درون گیومه مشخص کرد (برای جزئیات به
.B TZ
در
.BR environ (7)
مراجعه کنید).
منطقه زمانی پیش‌فرض
.B local
است مگر اینکه یکی از گزینه‌های
.B \-z
یا
.B \-Z
در خط فرمان مشخص شده باشد.
.TP 4
\f3flush\f1
این دستور تنها زمانی کار می‌کند که اتصال به یک نمونه pmlogger برقرار باشد، و از نمونه pmlogger درخواست می‌کند تا تمام بافرهای مرتبط با بایگانی فعلی را روی دیسک تخلیه کند.
برای کاربران قدیمی، \f3sync\f1 مترادفی برای \f3flush\f1 است.
در نسخه‌های فعلی
.BR pmlogger (1)
تمام عملیات نوشتن بدون بافر بوده و با رکوردهای منطقی در فایل‌های خارجی هم‌تراز هستند، بنابراین این دستور عملاً کاری انجام نمی‌دهد، اما برای سازگاری با نسخه‌های پیشین حفظ شده است.
.TP 4
\f3disconnect\f1
قطع اتصال
.B pmlc
از نمونه فعلی pmlogger (در صورت وجود).
.TP 4
\f3sleep\f1 \f2delay\f1
ایجاد وقفه در
.B pmlc
به مدت
.I delay
میلی‌ثانیه.
این دستور ممکن است در کاربردهای اسکریپتی از
.B pmlc
مفید باشد تا به نمونه فعلی pmlogger فرصت پیشبرد درخواست‌های اخیر پیش از استعلام وضعیت داده شود.
.TP 4
\f3help\f1
خلاصه‌ای از دستورهای موجود را نمایش می‌دهد.
.sp 0.5v
\f3h\f1 و \f3?\f1 مترادف‌هایی برای \f3help\f1 هستند.
.TP 4
\f3quit\f1
خروج از
.BR pmlc .
.PP
دستورهای باقی‌مانده، وضعیت ثبت گزارش (logging state) متریک‌ها و نمونه‌ها را پرس‌وجو کرده و تغییر می‌دهند.
این دستورها تنها در صورتی کار خواهند کرد که
.B pmlc
اتصالی به یک نمونه pmlogger داشته باشد.
متریک‌ها ممکن است به صورت نام‌های کامل (مانند hinv.ncpu) یا زیردرخت‌هایی از PMNS (مانند hinv) مشخص شوند که گسترش یافته تا شامل تمام متریک‌های آن زیردرخت شوند (مانند hinv.ncpu، hinv.cpuclock و غیره).
فهرست‌های متریک‌ها را می‌توان با قرار دادن آن‌ها درون آکولاد به همراه فاصله یا کاما میان متریک‌ها مشخص کرد (مانند {hinv.ncpu hinv.ndisk}).
زیردرخت‌های متریک‌ها نیز می‌توانند در چنین فهرست‌هایی گنجانده شوند.
.PP
هر مشخصه متریک فردی می‌تواند با فهرستی از نمونه‌ها در کروشه که با فاصله یا کاما جدا شده‌اند، دقیق‌تر مشخص شود (مانند kernel.all.load["1 minute", "5 minute"]).
نام‌های خارجی نمونه‌ها یا شناسه‌های عددی داخلی نمونه‌ها یا هر دو ممکن است در یک فهرست به کار روند (مانند sample.colour.[red,1,"blue"]).
اگر تعیین یک نمونه روی زیردرختی از PMNS اعمال شود، تمام متریک‌های آن زیردرخت باید دارای دامنه نمونه (instance domain) یکسانی باشند.
تعیین نمونه نمی‌تواند روی کل فهرست‌های متریک اعمال شود اما می‌تواند درون این فهرست‌ها بیاید.
.PP
اگر هیچ نمونه‌ای برای یک متریک مشخص نشود، همه نمونه‌ها استفاده می‌شوند.
«همه نمونه‌ها» یعنی تمام نمونه‌های موجود در زمانی که نمونه pmlogger مربوطه متریک‌ها را برای ثبت واکشی می‌کند. اگر یک دامنه نمونه با گذشت زمان تغییر کند، این وضعیت همواره با مجموعه نمونه‌های نمایش‌یافته توسط
.BR pmlc
یکسان نخواهد بود، چرا که تنها نمونه‌های در دسترس فعلی را نمایش می‌دهد.
برای جلوگیری از خطاهای ناخواسته، تنها نمونه‌هایی که در حال حاضر برای
.B pmlc
در دسترس هستند می‌توانند در مشخصات نمونه قید شوند.
.TP 4
\f3query\f2 metriclist\f1
وضعیت ثبت فعلی هر متریک (و نمونه‌ها، در صورت کاربرد) در
.I metriclist
نمایش داده می‌شود.
این شامل وضعیت ثبت (مانند on، maybe، off) و بازه زمانی ثبت گزارش برای هر متریک (و نمونه) درخواست‌شده است.
اختصارات زیر مربوط به متریک‌ها (و نمونه‌ها) ممکن است در خروجی ظاهر شوند:
.BR adv ،
توصیه‌ای (advisory)؛
.BR mand ،
اجباری (mandatory)؛
.BR nl ،
ثبت‌نشده (در بایگانی موجود نیست)؛
.BR na ،
در بایگانی موجود است اما در حال حاضر از Performance Metrics Domain Agent (PMDA) مربوط به آن در دسترس نیست.
در صورت لزوم، نام یک نمونه در انتهای سطر قرار گرفته و شناسه عددی داخلی نمونه پیش از آن می‌آید.
.TP 4
[ \f3log\f1 ] \f3mandatory on\f2 interval\f1 \f2metriclist\f1
این شکل از دستور
.B log
ثبت گزارش را برای متریک‌ها (و هر نمونه‌ای) در
.IR metriclist
فعال می‌کند.
.I interval
مشخص می‌کند که متریک‌ها/نمونه‌های مشخص‌شده هر چند وقت یک‌بار باید ثبت شوند.
.B once
نشان می‌دهد که متریک‌ها/نمونه‌ها باید حداکثر یک بار در بایگانی ظاهر شوند.
اغلب از کلمه کلیدی اختیاری
.B every
به همراه یک عدد مثبت و یکی از واحدهای
.B millisecond
(یا
.BR msec )،
.B second
(یا
.BR sec )،
.B minute
(یا
.BR min )،
.B hour
یا صورت جمع آن‌ها استفاده می‌شود.
.sp 0.5v
توجه داشته باشید کلمه کلیدی
.B default
که ممکن است برای
.I interval
پیش‌فرض در یک فایل پیکربندی
.BR pmlogger (1)
استفاده شود، در
.B pmlc
قابل استفاده نیست.
.sp 0.5v
محدودیت‌های داخلی مستلزم آن است که
.I interval
کمتر از (تقریباً) ۷۴ ساعت باشد.
مقدار صفر برای
.I interval
مترادفی برای
.B once
است..TP 4
[ \f3log\f1 ] \f3mandatory off\f1 \f2metriclist\f1
این دستور به نمونه‌ی pmlogger اعلام می‌کند که هیچ‌یک از معیارها/نمونه‌های موجود در
.I metriclist
را بایگانی نکند.
.TP 4
[ \f3log\f1 ] \f3mandatory maybe\f1 \f2metriclist\f1
این دستور به نمونه‌ی pmlogger اعلام می‌کند که به هرگونه درخواست‌های بعدی ثبت وقایع توصیه‌ای (advisory logging) برای معیارها/نمونه‌های موجود در
.I metriclist
ترتیب اثر دهد.
اگر وضعیت کنونی ثبت وقایع معیارها/نمونه‌ها اجباری (mandatory، چه on یا off) باشد، وضعیت جدید روی maybe تنظیم می‌شود (که عملاً معادل advisory off است).
اگر وضعیت کنونی معیارها/نمونه‌ها از قبل توصیه‌ای (advisory، چه on یا off) باشد، وضعیت(های) معیارها/نمونه‌ها همان‌گونه که هستند باقی خواهند ماند.
.TP 4
[ \f3log\f1 ] \f3advisory on\f2 interval\f1 \f2metriclist\f1
.br
.in -4
[ \f3log\f1 ] \f3advisory off\f1 \f2metriclist\f1
.in
ثبت وقایع توصیه‌ای تنها زمانی قابل‌اعمال است که آخرین وضعیت ثبت تعیین‌شده برای یک معیار/نمونه \(lqmandatory maybe\(rq بوده باشد (که کنترل ثبت توصیه‌ای بعدی را مجاز می‌کند) یا اینکه وضعیت ثبت از قبل توصیه‌ای باشد.
این دو عبارت به‌ترتیب ثبت وقایع توصیه‌ای را برای معیارها/نمونه‌های مشخص‌شده روشن (on) یا خاموش (off) می‌کنند.
.sp 0.5v
تفسیر
.I interval
همانند حالت
.B mandatory
در بالا است.
.PP
برای دستوراتی که در چند خط امتداد می‌یابند، نیازی به نویسه ادامه‌دهنده نیست.
.PP
کلمه
.B at
می‌تواند به‌صورت جایگزین با
.B @
به‌کار رود.
.PP
درخواست بایگانی تمام نمونه‌های یک معیار، بر هرگونه درخواست قبلی برای ثبت تمام یا نمونه‌های خاصی از یک معیار اولویت داشته و جایگزین آن می‌شود (در صورتی که درخواست، یک گذار مجاز را در وضعیت ثبت مشخص کند).
درخواست برای بایگانی نمونه‌های خاصی از یک معیار زمانی که تمام نمونه‌های آن معیار از قبل در حال ثبت باشند، توسط
.BR pmlogger
رد می‌شود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-e\fR, \fB\-\-echo\fR
بازتاب تمام ورودی‌های دستور در خروجی استاندارد.
.TP
\fB\-h\fR \fIhost\fR, \fB\-\-host\fR=\fIhost\fR
اتصال به pmlogger روی
.IR host ،
به‌جای localhost پیش‌فرض.
.TP
\fB\-i\fR, \fB\-\-interactive\fR
اجبار به رفتار تعاملی.
.TP
\fB\-n\fR \fIpmnsfile\fR, \fB\-\-namespace\fR=\fIpmnsfile\fR
بارگذاری یک فضای نام معیارهای کارایی جایگزین
.RB ( PMNS (5))
از فایل
.IR pmnsfile .
.TP
\fB\-p\fR \fIport\fR, \fB\-\-port\fR=\fIport\fR
اتصال به pmlogger اصلی روی درگاه TCP/IP به شماره \fIport\fP.
.TP
\fB\-P\fR, \fB\-\-primary\fR
اتصال به pmlogger اصلی.
.TP
\fB\-z\fR, \fB\-\-logzone\fR
استفاده از زمان محلی pmlogger به‌عنوان منطقه زمانی گزارش‌دهی.
.TP
\fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR
استفاده از
.I timezone
برای تاریخ و زمان.
.I Timezone
در قالب متغیر محیطی
.B TZ
است همان‌طور که در
.BR environ (7)
شرح داده شده است.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنمای استفاده و خروج.
.SH "کنترل دسترسی (ACCESS CONTROL)"
.B pmlc
ممکن است دسترسی و کنترل محدودی بر فرایندهای
.BR pmlogger (1)
داشته باشد.
.PP
اگر یک
.BR pmlogger (1)
نتواند اطلاعات کنترلی خود را به
.BR pmcd (1)
محلی صادر کند، آنگاه امکان اتصال به آن
.BR pmlogger (1)
یا کنترل آن توسط
.B pmlc
وجود نخواهد داشت.
در عمل، این بدان معناست که مالکیت فرایند
.BR pmlogger (1)
باید متعلق به کاربر \(lqpcp\(rq و/یا گروه \(lqpcp\(rq باشد.
اگر
.BR pmlogger (1)
روی میزبان \(lqfoo\(rq در حال اجرا است، از دستور \(lqpminfo \-f \-h foo pmcd.pmlogger\(rq برای بررسی این‌که آیا
.BR pmlogger (1)
مورد نظر برای
.BR pmcd (1)
شناخته شده است یا خیر استفاده کنید؛ از سوی دیگر، نمونه‌های
.BR pmlogger (1)
که توسط دستور
.B "show loggers @foo"
در
.B pmlc
گزارش نمی‌شوند، برای
.BR pmcd (1)
روی میزبان \(lqfoo\(rq شناخته‌شده نیستند.
.PP
اگر
.BR pmlogger (1)
با یک فایل پیکربندی راه‌اندازی شود که شامل یک بخش
.B [access]
باشد، آنگاه
.B pmlc
قادر به اتصال به آن
.BR pmlogger (1)
نخواهد بود مگر اینکه کنترل‌های دسترسی،
.B مقداری
دسترسی را از میزبانی که
.B pmlc
روی آن اجرا می‌شود مجاز دانسته باشند.
در کمترین حالت، این امر مستلزم آن است که دسترسی
.B enquire
در بخش کنترل دسترسی
.BR pmlogger (1)
مجاز شده باشد.
.PP
اگر
.B pmlc
بتواند به
.BR pmlogger (1)
مورد نظر متصل شود، جدول زیر مجوزهای مورد نیاز برای اجرای دستورهای مختلف
.B pmlc
را خلاصه می‌کند:
.TS
box,center;
c | c
lf(B) | l.
دستور \fBpmlc\fP	دسترسی مورد نیاز \fBpmlogger\fP
=
show loggers	هرکدام
connect	هریک از \fBenquire\fP، \fBadvisory\fP یا \fBmandatory\fP
status	هریک از \fBenquire\fP، \fBadvisory\fP یا \fBmandatory\fP
query \fR...\fP	هریک از \fBenquire\fP، \fBadvisory\fP یا \fBmandatory\fP
disconnect	هرکدام
log advisory \fR...\fP	\fBadvisory\fP
log mandatory \fR...\fP	\fBmandatory\fP
new volume	\fBmandatory\fP
.TE.SH "هشدارها (CAVEATS)"
اگر تمام نمونه‌های یک متریک در حال ثبت گزارش باشند و درخواستی برای ثبت نمونه‌های خاصی از آن متریک با همان وضعیت و بسامد ارسال شود، ممکن است چنین به نظر برسد که درخواست موفقیت‌آمیز بوده است، حتی اگر
.B pmlogger
درخواست را رد کرده باشد.
این حالت معمولاً مشکلی ایجاد نمی‌کند، زیرا اطلاعات مورد نیاز همچنان توسط
.B pmlogger
در بایگانی قرار خواهد گرفت.
.PP
اما در شرایطی که متریک تنها باید یک‌بار ثبت شود، نتیجه آن چیزی نخواهد بود که ممکن است انتظار رود.
هنگامی که
.B pmlogger
درخواستی برای یک‌بار بایگانی کردن یک متریک دریافت می‌کند، صرف‌نظر از اینکه متریک از قبل در بایگانی موجود است یا خیر، مقادیر فعلی متریک را در سریع‌ترین زمان ممکن در بایگانی قرار می‌دهد.
این رفتار ممکن است برای درج اجباری مقادیر در بایگانی استفاده شود.
هنگامی که درخواستی برای بایگانی نمونه‌های خاصی از یک متریک ارسال شود و به این دلیل که همه نمونه‌های آن متریک از قبل در حال ثبت هستند رد گردد،
.B pmlogger
مقادیر مربوط به نمونه‌های درخواست‌شده را در بایگانی قرار نمی‌دهد.
این ابزار وضعیت فعلی ثبت گزارش هر نمونه درخواست‌شده را به
.B pmlc
بازمی‌گرداند.
وضعیت‌های درخواستی و بازگردانده‌شده یکسان هستند، بنابراین
.B pmlc
آن‌طور که باید خطایی صادر نمی‌کند.
.PP
برای اطمینان از اینکه تنها نمونه‌های خاصی از یک متریک ثبت می‌شوند، همواره باید پیش از فعال کردن ثبت گزارش برای نمونه‌های خاص مورد نیاز، ثبت را برای تمام نمونه‌های آن متریک غیرفعال کرد.
.SH "خطاها (DIAGNOSTICS)"
بیشتر پیام‌های خطا یا هشدار خودتوضیح هستند.
پیامی به شکل
.br
.in +05.v
Warning: unable to change logging state for...
.in
که پس از آن فهرستی از متریک‌ها (و احتمالاً نمونه‌ها) می‌آید، نشان می‌دهد که
.B pmlogger
درخواست مربوط به متریک‌ها (و نمونه‌های) نشان داده‌شده را رد کرده است.
هر متریک (و نمونه‌ای) که مشخص شده بود اما در پیام ظاهر نشده، وضعیت ثبت آن با موفقیت به‌روزرسانی شده است
(بی‌خبری نشانه موفقیت است).
معمولاً این هشدار ناشی از درخواست ثبت اختیاری (advisory) در زمانی است که یک کنترل اجباری (mandatory) از پیش اعمال شده است، یا درخواست ثبت برای نمونه‌های خاص در حالی که همه نمونه‌ها از قبل در حال ثبت هستند.
.SH "محیط (ENVIRONMENT)"
اگر متغیر محیطی
.B PMLOGGER_REQUEST_TIMEOUT
تنظیم نشده باشد یا روی 0 (صفر) تنظیم شده باشد،
.B pmlc
تا زمان برقراری ارتباط با
.BR pmlogger (1)
روی \f2port\fP درخواست‌شده مسدود (block) خواهد شد.
اگر
.B PMLOGGER_REQUEST_TIMEOUT
روی مقداری بزرگ‌تر از صفر تنظیم شده باشد، در صورت برقرار نشدن اتصال پس از آن تعداد ثانیه،
.B pmlc
با یک خطا شکست می‌خورد.
این سازوکار می‌تواند توسط اسکریپت‌های مدیریتی مانند
.BR pmlogger_daily (1)
استفاده شود تا وضعیت
.B pmlogger
را در زمان راه‌اندازی تا آماده‌شدن و گوش‌به‌زنگ شدن روی \f2port\fP کنترلی خود بررسی دوره‌ای (poll) کنند.
.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 pmlc
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl0	T{
.ad l
تخلیه متریک‌ها و نمونه‌های دریافت‌شده
T}
_
appl1	T{
.ad l
تخلیه وضعیت پس از تجزیه هر دستور
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pmlogdump (1)،
.BR pmlogger (1)،
.BR pcp.conf (5)،
.BR pcp.env (5)،
.BR PMNS (5)
و
.BR environ (7).

.\" control lines for scripts/man-spell
.\" +ok+ adv mand na nl {from query status}
.\" +ok+ ncpu cpuclock hinv metriclist ndisk