نام (NAME)

pmstore - تغییر مقادیر معیارهای کارایی

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

pmstore [-fFLV?] [-D debug] [-h host] [-i instances] [-K spec] [-n pmnsfile] metricname value

توضیحات (DESCRIPTION)

در شرایط خاصی، تغییر دادن مقادیر معیارهای کارایی سودمند است؛ برای نمونه جهت مقداردهی اولیهٔ مجدد شمارنده‌ها یا اختصاص مقادیر جدید به معیارهایی که به عنوان متغیرهای کنترلی عمل می‌کنند.

دستور pmstore مقادیر جاری نمونه‌های مشخص‌شده از یک معیار کارایی منفرد را تغییر می‌دهد، همان‌گونه که توسط metricname و فهرست شناسه‌های نمونه در پی آرگومان -i تعیین شده است. instances باید یک آرگومان منفرد باشد که اعضای فهرست آن با کاما و/یا نویسهٔ فاصلهٔ خالی (whitespace) از یکدیگر جدا شده‌اند. به‌طور پیش‌فرض، تمام نمونه‌های metricname به‌روزرسانی خواهند شد.

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

مگر اینکه با گزینهٔ -h به یک میزبان دیگر هدایت شود، pmstore با دیمن جمع‌آوری معیارهای کارایی (PMCD) در میزبان محلی ارتباط برقرار می‌کند.

گزینهٔ -L موجب می‌شود pmstore از یک بافتار محلی برای ذخیره‌سازی در معیارهای مربوط به PMDAها در میزبان محلی بدون نیاز به PMCD استفاده کند. تنها برخی از معیارها در این حالت در دسترس هستند. گزینه‌های -h و -L مانعةالجمع هستند.

گزینهٔ -f ذخیره‌سازی مقدار ارائه‌شده را اجبار می‌کند، حتی اگر هیچ مقدار جاری‌ای تنظیم نشده باشد.

تفسیر value بسته به نحو به کار رفته در مشخص‌سازی آن و نوع دادهٔ زیربناییِ metricname، به شرح زیر است:

1.: اگر معیار دارای نوع integer (عدد صحیح) باشد، آن‌گاه value باید شامل یک علامت منفی اختیاری در ابتدا، و به دنبال آن ارقام ده‌دهی یا “0x” و چند رقم شانزده‌شانزدهی (هگزادسیمال) باشد. استفاده از “0X” نیز به جای “0x” قابل قبول است. ببینید strtol(3) و توابع مرتبط را.
2.: اگر معیار دارای نوع floating point (ممیز شناور) باشد، آن‌گاه value باید به شکل یک عدد صحیح شرح‌داده‌شده در بالا، یک عدد ممیز ثابت، یا یک عدد با نماد علمی باشد. ببینید strtod(3).
3.: اگر معیار دارای نوع string (رشته) باشد، آن‌گاه value به عنوان یک رشتهٔ لفظی از نویسه‌های ASCII تفسیر می‌شود.
4.: اگر معیار دارای هر نوع دیگری باشد (مانند PM_TYPE_EVENT یا PM_TYPE_AGGREGATE)، هیچ روش کدگذاری برای value از طریق خط فرمان معنادار نخواهد بود و مقادیر این معیارها را نمی‌توان با pmstore تغییر داد.

خروجی، مقدار پیشین و مقدار جدید را به ازای هر نمونهٔ به‌روزرسانی‌شده از معیار درخواست‌شده گزارش می‌دهد.

هنگام استفاده از گزینهٔ -L برای واکشی معیارها از یک بافتار محلی، گزینهٔ -K می‌تواند برای واپایش PMDAهای DSO که باید در دسترس قرار گیرند به کار رود. آرگومان spec از نحو شرح داده شده در pmSpecLocalPMDA(3) پیروی می‌کند. می‌توان بیش از یک گزینهٔ -K استفاده کرد.

در حالت معمول pmstore مقدار قدیمی (که در ابتدا با استفاده از pmFetch(3) بازیابی شده) و مقدار جدید ارائه‌شده در خط فرمان را گزارش می‌کند. گزینهٔ -F اجرای یک pmFetch(3) دیگر را پس از pmStore(3) اجبار می‌کند و مقدار بازگردانده‌شده به عنوان مقدار جدید گزارش می‌شود. این ویژگی در مواردی مفید است که metricname معیاری باشد که معناشناسی متفاوتی را برای عملیات ذخیره‌سازی فراهم می‌کند؛ برای نمونه افزایش مقدار جاری یا بازنشانی یک شمارنده (مستقل از value ارائه‌شده در خط فرمان).

گزینه‌ها (OPTIONS)

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

-f, --force: ذخیره مقدار حتی اگر هیچ مقدار جاری‌ای تنظیم نشده باشد.
-F, --fetch: گزارش مقدار معیار پس از تنظیم آن.
-i insts, --insts=insts: محدود کردن ذخیره‌سازی به فهرست جداشده با کاما از نمونه‌ها.
-h host, --host=host: اتصال به pmcd(1) روی host، به جای localhost پیش‌فرض.
-K spec, --spec-local=spec: هنگام واکشی معیارها از یک بافتار محلی (ببینید -L)، گزینهٔ -K می‌تواند برای واپایش PMDAهای DSO که باید در دسترس قرار گیرند استفاده شود. آرگومان spec با نحو توضیح‌داده‌شده در pmSpecLocalPMDA(3) مطابقت دارد. می‌توان بیش از یک گزینهٔ -K به کار برد.
-L, --local-PMDA: استفاده از یک بافتار محلی برای جمع‌آوری معیارها از PMDAهای DSO روی میزبان محلی بدون نیاز به PMCD. همچنین ببینید -K.
-n pmnsfile, --namespace=pmnsfile: در حالت معمول pmcd فضای نام پیش‌فرض معیارهای کارایی (PMNS) را از $PCP_VAR_DIR/pmns/root بارگذاری می‌کند، اما اگر گزینهٔ -n مشخص شده باشد، فضای نام جایگزین از فایل pmnsfile بارگذاری خواهد شد.
-V, --version: نمایش شماره نسخه و خروج.
-?, --help: نمایش پیام راهنما و خروج.

خطاها (DIAGNOSTICS)

دو پیام نشان‌دهندهٔ عدم تطابق میان نوع دادهٔ داخلی metricname و value ارائه‌شده هستند.

The value "???" is out of range for the data type (PM_TYPE_...)

The value "???" is incompatible with the data type (PM_TYPE_...)

محیط PCP (PCP ENVIRONMENT)

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

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

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

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

pmcd(1), pminfo(1), pmval(1), PMAPI(3), pmFetch(3), pmSpecLocalPMDA(3), pmStore(3), strtod(3), strtol(3) و PMNS(5).